A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
Explain how to recover when the profile disables the bot row
Fei241137ac59b4a259
diff --git a/docs/known-issues.md b/docs/known-issues.mdindex 31e69111..5499d77b 100644--- a/docs/known-issues.md+++ b/docs/known-issues.md@@ -19,3 +19,26 @@ English | [中文](known-issues.zh.md)**Tip:** put a space after the name (`@Anvil 你看下`). Then a name without a space shows as the Bot while it waits, too.**Why:** DeepSeek Harness draws these waiting rows itself and reads "@" up to the next space. A plugin cannot change how they are drawn yet.++## DS Bot does not load: "disabling profile plugin row "bot""++**Where:** DSH Web (or Desktop) starts, but DS Bot is not there. The log has this line:++```text+dsh: disabling profile plugin row "bot": its declared peer dependencies cannot be validated: Cannot read properties of undefined (reading 'startsWith')+```++Installing another version of DS Bot does not help.++**Why:** before it loads a plugin, DeepSeek Harness checks each plugin row of the profile. This message means a row has the id `bot` but no package name. DS Bot adds its own row with the name `ds-bot`, so the row without a name most likely comes from a file in the profile folder, such as an override `- id: bot` in `cordis.patch.yml` that no longer matches DS Bot's row. We could not reproduce this, so we do not know yet how such a row is left behind.++**What to do:** the profile folder is `~/.dsh/profiles/web/` (Windows: `C:\Users\<user>\.dsh\profiles\web\`), or `profiles/web/` in `DSH_HOME` when it is set. For Desktop, use `profiles/desktop/` instead.++1. Quit DSH.+2. Open `cordis.patch.yml` in the profile folder. Look for a row with `id: bot` that has no `name: ds-bot` line, and remove that row. Keep a copy of the file first.+3. Check that `package.json` in the same folder lists `ds-bot` under `dependencies`. If it does not, add DS Bot again: `npx @deepseek-ai/[email protected] plugin --profile web add ds-bot`.+4. Start DSH again.++To see where the row comes from, run `npx @deepseek-ai/[email protected] --profile web --dump-config`. It prints every plugin row with the file that supplied it. If you report the problem, copy only the rows with `id: bot` and the file names; leave out keys and paths you do not want to share.++Deleting the whole profile folder also fixes it, but it removes the profile's other plugins and its settings, such as models. The Bot team is in `~/.dsh/bot/` and is not affected either way.diff --git a/docs/known-issues.zh.md b/docs/known-issues.zh.mdindex 9d778d3b..421f969e 100644--- a/docs/known-issues.zh.md+++ b/docs/known-issues.zh.md@@ -19,3 +19,26 @@**小技巧:** 名字后面加一个空格(`@Anvil 你看下`)。这样只要名字里没有空格,等待时也会显示成 Bot。**原因:** 这些等待中的行由 DeepSeek Harness 自己画,它读「@」时一直读到下一个空格。插件目前改不了它们的显示。++## DS Bot 没有加载:「disabling profile plugin row "bot"」++**在哪里:** DSH Web(或 Desktop)能启动,但没有 DS Bot。日志里有这一行:++```text+dsh: disabling profile plugin row "bot": its declared peer dependencies cannot be validated: Cannot read properties of undefined (reading 'startsWith')+```++换装别的 DS Bot 版本也没用。++**原因:** DeepSeek Harness 加载插件前,会检查 profile 里的每一行插件配置。这条信息表示有一行的 id 是 `bot`,却没有包名。DS Bot 自己加的那一行带有包名 `ds-bot`,所以没有包名的那一行多半来自 profile 文件夹里的文件,比如 `cordis.patch.yml` 里一条已经对不上 DS Bot 那一行的 `- id: bot` 覆盖配置。我们没能复现这个问题,所以还不知道这样的一行是怎么留下来的。++**怎么处理:** profile 文件夹是 `~/.dsh/profiles/web/`(Windows:`C:\Users\<用户名>\.dsh\profiles\web\`);设置了 `DSH_HOME` 时,是其中的 `profiles/web/`。Desktop 用 `profiles/desktop/`。++1. 退出 DSH。+2. 打开 profile 文件夹里的 `cordis.patch.yml`,找 `id: bot` 但没有 `name: ds-bot` 的一行,删掉这一行。改之前先备份这个文件。+3. 确认同一文件夹的 `package.json` 在 `dependencies` 里有 `ds-bot`。没有的话,重新添加 DS Bot:`npx @deepseek-ai/[email protected] plugin --profile web add ds-bot`。+4. 重新启动 DSH。++想知道这一行来自哪里,可以运行 `npx @deepseek-ai/[email protected] --profile web --dump-config`。它会列出每一行插件配置,以及提供它的文件。如果要报告这个问题,只复制 `id: bot` 的那几行和文件名,不要带上 key 或你不想公开的路径。++删掉整个 profile 文件夹也能解决,但会一并删掉这个 profile 的其他插件和设置(比如模型)。Bot 团队数据在 `~/.dsh/bot/`,两种做法都不会影响它。