A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
Describe the desktop app in the agent and contributor rules
Fei2411b24d30ebaffa
diff --git a/AGENTS.md b/AGENTS.mdindex 9647175a..bc9fd28f 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -4,7 +4,12 @@ Instructions for AI coding agents that work on this repository. Human contributo## What this project is-DS Bot (`ds-bot/`) is a plugin for DeepSeek Harness (DSH). It turns DSH Desktop and DSH Web into a team of long-lived Bots:+DS Bot is a team of long-lived Bots, built on DeepSeek Harness (DSH). It has two parts:++- `ds-bot/`: the Bot features, written as a DSH plugin. The plugin runs in DSH Desktop, in DSH Web and in the desktop app.+- `app/`: the desktop app for Windows and macOS. It runs a pinned DSH with the `ds-bot` plugin, in its own profile and its own `DSH_HOME`, and imports an existing team from the user's DSH.++The Bot team:- Every Bot is a DSH Session and runs through the normal DSH agent loop, tools and model routes.- The team works together: Bots message each other, share group chats and can see what the other Bots are doing. Each Bot still runs on its own and does not disturb the others.@@ -14,11 +19,11 @@ DS Bot (`ds-bot/`) is a plugin for DeepSeek Harness (DSH). It turns DSH Desktop## Hard rules-1. **Plugin only.** Never patch DeepSeek Harness or depend on files inside a DSH install. Use the documented plugin APIs. If something is missing in DSH, stop and say so; do not work around it with a patch.+1. **Build on DSH; never patch it.** Bot features use the documented plugin APIs. The desktop app starts DSH only through its documented entry points (`@deepseek-ai/dsh/profile-boot`, the `dsh` CLI). Never patch DeepSeek Harness or depend on files inside a DSH install. If something is missing in DSH, stop and say so; do not work around it with a patch.2. **No secrets.** Never write, print or commit API keys, tokens, cookies or `DSH_HOME` contents. Use the mock model (`ds-bot/dev/mock-llm.mjs`) for tests; it needs no key.3. **Only original material.** Do not copy code, text, icons, logos or graphics from other products or websites.4. **`client.js` is generated.** Change `ds-bot/src/client/`, then run `npm run build` and commit both files. Never edit `client.js` by hand.-5. **Do not touch the user's own DSH data.** The test bench keeps its data in `.dsh-test-<name>/`. Never point a test at `~/.dsh` or at a DSH that the user runs.+5. **Do not touch the user's own DSH data.** The desktop app keeps its data in its own `DSH_HOME`; its import only reads `~/.dsh` and never writes there. The test bench keeps its data in `.dsh-test-<name>/`. Never point a test at `~/.dsh`, at the desktop app's data or at a DSH that the user runs.## Commands@@ -43,6 +48,7 @@ A change is done when `npm test`, the `--check` and `npm run lint` pass; CI runs- `ds-bot/src/client/`: the browser side (sidebar, chat, panels, themes, characters, the Bot browser panel).- `ds-bot/web-search.js`: the `auto` web-search provider, independent of the Bot team code.- `ds-bot/test/`: unit tests and fixtures. `ds-bot/dev/`: the DSH packages for the tests (`harness/`), mock model, test bench, smoke test, character generator, Desktop scripts for Linux.+- `app/`: the desktop app (Electron main process and window, first-run setup and import, installer and updates).## Stylediff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 72059d61..8fe5af5c 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -8,7 +8,7 @@ Thank you for your interest in improving DS Bot. The project is still changing q## The rules that matter most-1. **DS Bot is a DSH plugin, and only a plugin.** Do not patch DeepSeek Harness, and do not depend on files inside a DSH install. Use the plugin APIs that DSH documents (Cordis services, the plugin client entry, profile patches). When a feature needs something that DSH does not offer, open an issue here first; the fix can belong in DSH.+1. **Build on DSH; never patch it.** The Bot features are a DSH plugin: use the plugin APIs that DSH documents (Cordis services, the plugin client entry, profile patches). The desktop app starts DSH only through the entry points that DSH documents (`@deepseek-ai/dsh/profile-boot`, the `dsh` command). Do not patch DeepSeek Harness, and do not depend on files inside a DSH install. When a feature needs something that DSH does not offer, open an issue here first; the fix can belong in DSH.2. **Every Bot is a DSH Session.** Bot work runs through the normal DSH agent loop, tools and model routes. Do not add a second agent runtime.3. **No real secrets anywhere.** Do not commit API keys, tokens, cookies, `DSH_HOME` folders, logs or screenshots with personal data. The tests and the test bench use a scripted mock model and need no key.4. **Only original material.** Do not copy code, text, icons, logos or other graphics from other products or websites. Code under a license compatible with Apache 2.0 is the only exception: say where it comes from and add its notice to a `NOTICE` file.