Fei2411/DeepSeek-Bot · 上手攻略

  • 仓库：Fei2411/DeepSeek-Bot
  • 链接：https://github.com/Fei2411/DeepSeek-Bot
  • 分类：agent / 多 Bot 协作 / DeepSeek Harness 插件
  • 作者：spark
  • 更新：2026-10-14

§0 三证 checklist

  • ✅ GitHub URL 已 fetch（web_fetch 200 OK）
  • ⚠️ 顶会 venue：N/A（应用型仓库，无论文锚点）
  • ✅ 至少 1 个 README 子模块 anchor：DSH Desktop / DSH Web / 봇 설정 / group chat，全部已读

§1 这是什么 / 解决什么问题

DeepSeek Bot（包名 ds-bot）是给 DeepSeek Harness（DSH）的多 Bot 协作插件。DSH 是一个全插件化 AI Agent Harness（v0.2.0-rc.2 阶段），提供了模型、会话、沙箱、技能等可插拔结构；DS Bot 在它的基础上加了三件事：

  1. 长寿 Bot（long-lived bots）：每个 Bot 是一个常驻 DSH session，自带记忆、模型配额、详情页；
  2. Bot ↔ Bot 消息：任意 Bot 可以通过 @ 把工作交给另一个 Bot，被委托方独立完成后再回到群组回报；
  3. 群组聊天（group chats）：多个 Bot 协作的场所，配"管理员 Bot"节流，避免全员响应。

⚠️ 免责声明：仓库 README 明确写了——DS Bot 是独立的社区项目，不是 DeepSeek 官方产品，也不受 DeepSeek 背书。Bot 会消耗你自己的模型配额，并代表你读 / 写文件、跑命令，重要动作必须人工复核。

§2 快速安装

2.1 前置条件

  • 安装并启动 DeepSeek Harness（DSH），且其中至少配置好一个模型（DS Bot 直接复用 DSH 的模型）
  • Node.js ≥ 22.19，pnpm（Web 版需要）
  • 数据全部在本地（~/.dsh/bot/ 与 ~/.dsh/sessions/），卸载插件不会删除

2.2 DSH Desktop（Windows / macOS）

桌面端用法：侧栏 → Plugins → Add plugin，在 Package name 一栏填：

ds-bot

大陆用户在 Registry 一栏切换到 Mainland China mirror，避免 npm 拉不到。再点 Install → Enable now；若 DSH 提示"下次启动生效"，就完全退出再重新打开。

npm 不可达时，可以从 Releases 下载 ds-bot-0.1.5.tgz 本地安装，或直接走 git 协议 github:Fei2411/DeepSeek-Bot#v0.1.5&path:/ds-bot（需 Git）。

2.3 DSH Web（Windows / macOS / Linux）

npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add ds-bot
npx @deepseek-ai/dsh@0.2.0-rc.2 web

⚠️ 版本号核对：上述 @0.2.0-rc.2 截自 README 当时最新；DSH 主仓库已进入 dsh-v0.2.0-rc.1 时代（2026-09 释出）。生产前请用 npm view @deepseek-ai/dsh version 重新核一次，DSH 作者明确强调 v0.x 仍会有兼容性变更。

2.4 推荐起步姿势

插件装好后会自动建好一个叫 Chief 的主 Bot，第一次打开就跟它对话，让它带你走一遍配置。不要一上来就堆 Bot——README 直说了"长寿命、一个 Bot 长时间绑一个模型"是最稳的姿势，模型切换只在真必要时做。

§3 核心用法（可直接复制）

3.1 与单个 Bot 长期协作

（与 Chief 的对话窗口）
"建一个写技术文章的 Bot，叫 Doc，绑 deepseek-v4-pro。"
"再建一个做翻译的 Bot，叫 Translator，绑 deepseek-v4-flash。"
"让 Doc 给我写一份 kordoc 上手指南。"
Bot 会调用工具、读 README、甚至 patch 文件。

Bot 的详情页（Details）可改：模型 / 记忆 / 共享能力（Capabilities）等；记忆内容既可手工编辑，也可直接"告诉 Bot 让它自己记住"。

3.2 群组聊天 + @转发

（群组窗口）
"@Doc 起草一篇 RAG 报告"
"@Translator 把引言译成英文"
"@Code-reviewer 检查一下第三节的代码"
  • 群里没 @ 的消息默认由群组的 管理员 Bot 回复，并在需要时调入其他 Bot；
  • @ 指定 Bot 则跳过 admin，直接让那位 Bot 答；
  • Bot 互相之间也能用 @，委托方不会阻塞，被叫到的 Bot 独立干活，结束后在群组回报结果；
  • 想把别的 chat 当上下文，用消息框左侧 + → Reference a chat；
  • 强行中断：进群组详情页（Group details）找终止按钮。

3.3 共享能力（MCP / Skills / Packs）

Settings → Capabilities 是全 Bot 共享的能力库。在某个 Bot 的 settings 里 Add 一次后，该 Bot 在自己的 chat 与群组中都能用。本地 MCP 命令首次运行需要你手动批准；改 / 删能力只允许你本人或主 Bot 操作。

3.4 用量 & 计费

Settings → Usage 可按时间 / Bot / 模型 看 token 用量。群组里多人协作时这部分消耗会显著放大，README 明确建议"用 admin Bot 节流 + 不要每条都 @ 全员"。

§4 典型适用场景

  1. 多角色长期助手团队：Chief（总管）+ Doc（写作）+ Translator（翻译）+ Coder（编程）+ Reviewer（评审），通过记忆长期化各自偏好；
  2. 复杂任务编排：让一个 Bot 调另一个 Bot 干活，原始窗口继续与人类对话（OpenMausBot / Hermes Bot Mode 的核心思路被借过来）；
  3. RAG / 研究流水线：第一个 Bot 出搜索 + 引用，第二个 Bot 翻译 / 摘要，第三个 Bot 综述 / 整合；
  4. 本地私有化：所有会话 / 文件 / 记忆都在 ~/.dsh/ 下，配合 KORDOC_ROOT 这类环境变量限定 MCP 文件访问，适合不想把数据上云的小团队；
  5. DSH 插件练手：插件源码在 ds-bot/，沿用 DSH 的扩展 API（ds-bot/README.md）即可做 fork 自定义。

§5 坑与注意

  1. DSH 仍处 0.x，DS Bot 跟着抖：DSH 在 v0.2.0-rc.1，README 自己说"会持续引入破坏性变更"。DS Bot v0.1.5 测过的 DSH 版本号固定在 0.2.0-rc.2；DSH 升级到 dsh-v0.2.0-rc.1 或更新的 stable 后，插件要同步验证。
  2. 群聊成本放大：每条消息都会触发若干 Bot 的"听",即使它们不答。建议给群组配 admin，少用全员 @，并经常到 Usage 看时序曲线。
  3. Bot 长期绑一个模型：项目方反复强调切换模型会让 Bot 的"记忆与脾气"漂移；只在模型明显退化 / 业务重大转变时再切。
  4. 本地 MCP 是双刃剑：共享能力库里的本地命令，Bot 首次调用要走你手动审批；审批过的命令，Bot 之间共用，攻击面要心知肚明。
  5. 数据与卸载：卸载插件不会清掉 bot/、sessions/ 目录；要做"干净环境"测试要手工删 ~/.dsh/bot、~/.dsh/sessions。
  6. 首席 Bot（Chief）权限很大：能管理其他 Bot 与群组；要养成"Chief 接待外部需求，内部 Bot 仅听命 Chief"的工作流，否则权限会被滥用。
  7. 完整理论边界：Bot 读 / 写文件 + 跑命令，意味着任何提示词注入面（不可信网页、不可信文档、群聊里的陌生人）都可能演化为不可控动作。重要命令请在 Capability 里只暴露严格白名单。
  8. 代码贡献注意事项：仓库 CONTRIBUTING.md 写明开发与测试流程；插件最终是用 esbuild 打包到 DSH 进程里的，对 plugin SDK 的 API 变更要盯紧。

§6 与同类对比

工具 强项 弱项 / 差距
DS Bot (本项目) 一键多 Bot 团队、bot-to-bot 委托、群聊 admin 节流、共享 MCP / Skill、完全本地 强依赖 DSH（v0.x 风险）；生态刚起步，第三方能力包还很薄
OpenAI Codex CLI / app 官方支持、Codex checkpoints 设计被本项目借鉴 单一 Agent，没有原生"团队"、群组、长寿记忆
goose / pi / Gemini CLI / OpenCode 各自 CLI / 编辑器交互做得好 没有 first-class 多 Bot 协作 + 共享 MCP 库模型
Hermes Agent / Hermes Bot Mode 一会话一成员的群聊思路正是本项目的引用源之一 多为研究 demo，没有 DSH 这种全栈可插拔 host
AutoGen / CrewAI 角色协作 + 工作流成熟 Python 为主；非本地优先；与 DeepSeek Harness 生态不互通

主要定位差异：DS Bot 是"在 DSH 上跑多 Bot 团队 + 本地优先"的轻量插件，而其他项目要么是单 Bot（Codex / goose）、要么是 Python 工作流（AutoGen），要么是研究 demo（Hermes）。

§7 一句话推荐

如果你是 DeepSeek Harness 用户（或者愿意把它当底座用），想要一个多 Bot 长寿协作 + 共享能力 + 本地数据可控的最小可用团队形态，ds-bot 是当下最对路的开箱即用选择——装一次插件，先和 Chief 聊一遍，再慢慢堆 Bot。