从装好到跑通第一个群聊：DS Bot 的四步与三处易错

从装好到跑通第一个群聊：DS Bot 的四步与三处易错

DS-Bot 把 DSH 从「一个会话一个助手」改成「一队常驻 bot」，主 bot 默认叫 Chief，能管其他 bot，也能建群聊。这篇按操作顺序走一遍：装、建 bot、建群、派第一个活，再集中说三处最容易卡住的地方。四条路径里桌面版插件页最省事，作为主线，Web 与 Docker 各占一小节。插件页信息可先看 DS Bot 详情页。

第 0 步：先对一遍版本号

本文的实装记录来自 dsh 0.2.1-rc.2 + 插件 v0.2.3。此后版本往前走：站内快照停在 0.2.5，npm 上 latest 是 0.2.6（2026-11-02）。三个数对不上是站点与 registry 不同步，不是你装错了。

插件本身 Apache-2.0，GitHub 实时 5,096 星（站内快照 5,084），npm 周下载 11,765（含 CI 与镜像，不等于本站安装数），站内综合分 71.1 / 100。package.json 未声明 engines.node 与 dsh 版本约束，兼容性只能靠实装判断。Web 路径还需要 Node.js 22.19 以上：

node -v
pnpm -v

第一步：在 DSH Desktop 插件页装

左侧栏进「插件」，点「添加插件」，包名填 ds-bot。大陆网络在源选项里挑「中国大陆镜像源」。确认后若提示「下次启动生效」，说明包已下载并登记。

装完必须完全退出，不是关窗口

提示要求重启时，要把 dsh 完全退出再打开。点右上角关掉窗口，进程可能还在托盘或后台，插件并不会加载。macOS 用 ⌘Q，Windows 从托盘图标退出，再启动。

第二步：让 Chief 把 bot 建起来

主 bot 默认叫 Chief，作者的原话是「和 Chief 说一句话，它就把 bot 和群聊建好」。进去直接说你要什么角色的 bot，它会自己创建，每个 bot 有独立模型、记忆与用量页。作者还有一条提示：一个 bot 长期用一个模型，只在必要时切换。

建第一个群聊

群聊必须设一个管理员。你不 @ 任何人的时候，消息默认由管理员接，由它决定调谁——这是为了压成本，如果每条消息都触发全员，账单会很难看。建群时把 Chief 设为管理员，再拉两三个干活的进去。

第三步：派第一个活

在群里 @ 要派活的那个 bot，说清交付物和输出位置。它自己做，在群里同步进度，做完把结果发回群里。要一次派给多人，就在一条消息里 @ 多个成员：v0.2.5 起被点名的人会同时启动，发起呼叫的 bot 会等它们全部完成。

第四步：确认能力与数据落点

进「设置 → 能力」，这是团队共享的 MCP 服务、技能与能力包列表。在某个 bot 的设置里启用后，从该 bot 的下一条消息开始生效，也适用于它参与的群聊。不是立刻生效，调试时容易被误判成「没生效」。数据落在 ~/.dsh 下的 bot/ 与 sessions/：

ls ~/.dsh/bot
ls ~/.dsh/sessions

另外两条路径

Web：命令行装，版本要写死

README 里把版本写死了，照抄即可：

npx @deepseek-ai/dsh@0.2.1-rc.4 plugin –profile web add ds-bot
npx @deepseek-ai/dsh@0.2.1-rc.4 web

别用 latest，可能拿到行为不同的核心。连不上 npm 时作者给了两条替代：填 Releases 里 ds-bot-0.2.1.tgz 的完整路径，或指向 git 仓库（需要 Git）：

npx @deepseek-ai/dsh@0.2.1-rc.4 plugin –profile web add github:Fei2411/DS-Bot#v0.2.1&path:/ds-bot

Docker：容器就是沙箱

仓库里有 docker/ 目录，用它构建的镜像里容器本身就是 bot 的沙箱：bot 对挂进容器的目录有完全权限，容器外碰不到。

git clone https://github.com/Fei2411/DS-Bot.git
cd DS-Bot
ls docker/

挂载时只挂工作目录，别把家目录整个挂进去，否则沙箱等于没设。

易错一：0.2.1 及更早版本不能自更新

作者原文点名的硬坑：DS Bot 0.2.1 及更早的版本，在 DSH Desktop 0.2.1-rc.2 及以后的版本里不能自己更新。表现是插件页有新版，点了没反应，或更完版本号没变。

办法是移除再重装，不要手工改文件：在插件页移除 ds-bot，再点添加插件，包名仍是 ds-bot。Bot、聊天、记忆都会保留，它们存在 ~/.dsh 的 bot/ 与 sessions/ 里，跟插件包是两回事。

易错二：桌面版不能用命令行

桌面版敲 –profile desktop 会直接报错：

dsh plugin –profile desktop add ds-bot

desktop 档由 App 独占管理，命令行只对 web 这类配置档有效。注意：桌面版只能走界面；–profile web 装的是 Web 工作区；两档插件互不影响。

易错三：禁用 web-search-auto 会让整个 profile 搜索失效

DS Bot 会把 auto 搜索 provider 选为整个 profile 的后端，不是某个 bot 的私有设置。禁用 web-search-auto 又不给这个 profile 另选一个已注册的 provider，搜索会整体失效，而且很静默：不报错，只是查不到东西。

判断方法：换一个 bot 问同样的问题，它也查不到，就是 profile 级搜索坏了。修复是先在设置里确认 profile 的搜索 provider 不是空的，再恢复 web-search-auto，然后重开会话验证。

总结

四步走完就有了一支能派活的 bot 小队：~/.dsh/bot 下有你的目录，群里 @ 一句进度会回到群里，这两条过了就算跑通。想一次看完同类插件的中文清单与安装形态，见 完整插件清单与汉化避坑指南，里面按分类标了各自的安装路径。

适合与不适合

适合：已有 DSH Desktop 想试多 bot 协作、要把写作 / 调研 / 校对拆成不同角色、需要群内并行处理一批任务、希望数据留在本机 ~/.dsh 下。

不适合：只想用命令行管理一切、必须用桌面版却不愿走图形界面装插件、把搜索当核心能力又不能接受一次配置失误就失效、对 token 成本极敏感。

标签：DS Bot、DeepSeek Harness、多智能体协作、群聊、安装教程

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。