前言¶
在 DeepSeek Harness（DSH）里，一次 Session 就是一个 Agent：工具卡片、审批、排队和模型选择都走原生链路。若想在 Web 界面里长期维护多个「有角色、有记忆、能协作」的智能体，却单独再搭一套执行层，往往会和 DSH 的能力重复，也难把某次回复一键还原成真实会话。
下面介绍维护者 lisongjianustc 发布的 DSH 插件 dsh-bot（npm 包名 @lisongjianustc/dsh-bot，社区分类为工作流）。它在 DSH 之上加一层类似 MiniMax Bot 的工作台：每个 Bot 对应真实的 DSH Agent Session，支持私聊、群聊、记忆、后台任务、定时任务与用量统计，而不另造第二套执行引擎。
这是什么¶
dsh-bot 面向使用 DSH Web 扩展的开发者与团队：用命名 Bot（角色、指令、头像、模型、推理力度、权限预设、固定工作区）组织协作；每条 Bot 回复都是一次真实的 DSH Agent 回合，可随时在 DSH 中打开对应 Session。
状态与账本落在 Host 侧 $DSH_HOME/dsh-bot/；客户端通过 /dsh-bot/api/* 与 Host 通信。插件在 package.json 中声明 DSH 引擎要求为 >=0.2.2-rc.1，并依赖 Web 端 client 注入。当前仓库版本为 0.6.0，许可证 MIT；GitHub 星标数为 1（以目录页与仓库徽章为准）。
核心功能¶
资料中列出的能力可按模块理解如下。
Bot 团队与聊天¶
- 团队：可创建多个命名 Bot；首次启动会创建 Chief（团队负责人），且 Chief 是唯一可编辑成员与群组 roster 的 Bot。Chief 的私聊默认置顶。
- 私聊：每条消息对应一次真实 Agent 回合，支持流式文本、工具行、重试、取消、引用、复制与 Markdown 渲染。
- 群聊：支持
@Name与@all、每轮发言人数上限（maxSpeakers，默认 3）、群笔记与清空聊天后仍保留的群记要；主 Bot 可创建/更新/删除群并向任意群发帖。 - 置顶：任意会话可置顶。
任务、后台与定时¶
- 任务派发：模型侧工具
bot_dispatch_tasks、bot_get_tasks、bot_cancel_tasks，支持批量后台委派、request-id 幂等、回执与取消级联。 - 后台助手：隐藏子 Session 处理不阻塞聊天的作业，结果回传后由 Bot 自行核验表述。
- 定时：按日 / 每 N 次 / 单次，由 Host 调度服务投递到 Bot Session。
记忆、输入与界面¶
- 记忆：团队级与各 Bot 独立存储；下一轮在约 6000 字符预算内选入上下文，带修订保护与日志；强指令可自动写入，其余候选项进入审核队列供接受、编辑或拒绝。
- 富输入：文本、图片、文件（粘贴、拖拽、选择器），Bot 收到绝对路径并可读取。
- 头像库：40 个原创 SVG，新建 Bot 时按名称/角色关键词自动匹配。
- 用量：按 Bot 统计 7/30/90 天的回合与字符数；工作流级任务面板。
- 工具详情与文件浏览（v0.5+ 亮点）：工具调用展示一行摘要，可展开参数与结果；右侧文件浏览器可预览 Bot/群项目目录中的代码、Markdown 与图片；聊天中的本地路径可点击。
- 双语：中英文界面、提示与工具说明。
插件对外提供 21 个面向模型的 bot_* 工具，与 dsh.bundle、dsh.client、市场元数据及 CI 一并维护。更细的协议与交付说明见仓库 docs/（如 PROTOCOL.md、COVERAGE.md、DELIVERY.md）。
安装与启用¶
环境要求：DSH >= 0.2.2-rc.1，且需具备 Web 扩展 bundle。
从插件市场安装（上架后）：在 DSH Settings → Plugins → Discover 或 Workshop 卡片中安装 @lisongjianustc/dsh-bot。npm 发布亦可用：
dsh plugin add @lisongjianustc/dsh-bot
本地从仓库开发时，README 说明需在 DSH 内对目录执行 plugin_manager install_bundle，并运行客户端构建：
node scripts/build-client.mjs
安装完成后，在侧栏打开 Bot team 行，点击 Create the default Bot，发送第一条消息即可开始。
典型用法¶
README 给出的快速上手步骤可直接复现：
- 打开工作台；空状态下会自动创建 Chief（团队负责人，私聊默认置顶）。
- 让 Chief 组建团队，例如：「Create a researcher and an engineer, then open a group with both.」
- 私聊任一 Bot，或在群里讨论并用
@Alice等提及成员。 - 粘贴或附加图片、文件，Bot 将获得路径并可读取。
- 需要时置顶任意会话。
群聊中可用 [PASS] 跳过发言；任务类工作可通过 Chief 或其它 Bot 调用 bot_dispatch_tasks 系列工具在后台执行，再在会话中查看结果。
适用场景与注意¶
适合谁：已在用 DSH Web GUI、希望用多 Bot 分工（调研、工程、负责人协调）且希望每次回复都能回到原生 Session 的用户；需要群聊路由、共享/私有记忆、定时与后台任务的工作流场景。
权限与安全：插件在当前 DSH 进程权限下运行，Bot 可调用的工具与文件访问范围与 DSH 一致。安装前请阅读 GitHub 仓库 源码与 MIT 许可证，确认是否符合你的环境策略。社区目录 SkillHub 插件页 与 GitHub 无 DeepSeek / 幻方官方从属关系，仅为社区收录。
架构要点：dsh-bot 不把 Session 换成别的运行时；Host 通过 sessionController.prompt() 驱动真实 DSH Agent Session，工作台只是薄产品层，原生工具卡片、审批与搜索仍可用。
结尾¶
dsh-bot 把「命名 Bot 团队 + 私聊/群聊 + 记忆与任务」落在 DSH 真实 Session 之上，适合在 Harness 里做常在线协作而不脱离原生 Agent 能力。进一步了解功能对比与协议细节可查看仓库文档；安装与讨论见社区目录与 GitHub Issues。
