AI 队友军团 tyxt-zvid/deepseek-bot-army

面向 DeepSeek Harness 的 Deepseek Bot Army

DeepSeek Harness Web UI 里常驻一支 AI 队友团队。每个 Bot 都有名字、职责和自己的电脑；你像给同事发消息一样给 Bot 发消息，把活交给它们，需要你审批时再回来。

产品怎么运作：

- 一支常驻的 AI 队友名册，每个队友都有名字、职责和描述；
- 每个 Bot 都有自己的电脑，能端到端完成真实工作；
- 你像给同事发消息一样给 Bot 发消息——没有工作流搭建器；
- Bot 会记住东西，通过示范学会例行流程，并且运行在共享电脑上；
- 多个 Bot 可以在群聊里协作，互相交接工作，需要你审批时再回来。

面板上的每条回复都是一次真实的 Harness 会话：一次智能体运行，用 Harness 工具、真实文件，并留下可追溯的会话日志。

0.9.0 — 首个公开测试版

Deepseek Bot Army for DeepSeek Harness 的首个公开测试构建。它包含下文描述的、截至 v0.8.0 的功能集——审批优先的执行、记忆与例行流程、@ 提及、按聊天划分的团队名册和心跳唤醒——外加 Workspace Hub 集成。

- 版本：0.9.0
- 许可证：MIT
- 仓库：<https://github.com/tyxt-zvid/deepseek-bot-army>

这是测试版：难免有粗糙之处，注意事项 里列出的 GUI 和手动 QA 路径仍需人工过一遍。

你会得到什么

全局侧边栏里的 Bots 入口会打开面板：

- Teammates 栏：头像、实时活动（「Digging around」「Looking through files」）、未读圆点和「needs attention」徽标。
- 1:1 聊天：给 Bot 发消息，看它流式输出，然后审阅完成的任务（Approve / Request changes / Dismiss）。
- 群聊，2–6 个 Bot；@Bot 把消息路由给某位队友，@everyone 唤醒全队，Bot 可以用 HANDOFF: @Name — … 把工作交给另一个 Bot。
- 每个输入框都支持 @ 提及：输入 @（或按 @ 按钮）打开 Bot 选择器，按名字过滤，用 ↑/↓ + ↵（或 Tab）标记队友，按 Esc 关闭。被标记的 Bot 会变成输入框上方可移除的标签，在对话记录里显示为高亮的提及标签；群聊里还会提供 @everyone。
- 心跳唤醒（v0.8）——空闲 Bot 有未完成的工作时（比如重启之后），先跑一次开销很小的确定性检查；只有通过后，才发一次轻量的 JSON「脉冲」调用，决定是等待、向你提问，还是继续。继续就是在 Bot 自己的会话里跑一次正常的全量运行（同样的工具和审批关卡），并受每日预算、免打扰时段、重试上限和每个 Bot 的开关约束。
- Tasks 页面，汇总所有聊天，采用审阅优先的工作流。
- Marketplace，内置角色目录（Sales Outbound、Chief of Staff、Bug Reproduction、Paid Media、Expense Manager、Talent Scout、Account Health……）。添加卡片会创建一份可编辑的副本。
- Bot 设置：名字、标签、描述、头像和强调色。
- 每个 Bot 的上下文面板：
- 任务 — 本会话的任务，带审批操作。
- 记忆 — Bot 发出 MEMORY: 行时，会「更新 Bot 的记忆」；可编辑或删除条目。
- 例程 — 「教一个任务」会保存一份例程草稿，可立即运行、暂停、查看运行次数。
- 电脑 — 共享工作区目录，带实时文件列表和文本预览。
- 技能 — 一个共享指令库，每个 Bot 都会收到。

工作区中枢集成（v0.2）

本插件包与 Workspace Hub 插件（@local/dsh-workspace-hub）配合工作，后者负责跨会话的任务看板：

- 工作区绑定（MVP-1）： 每个 Bot 都可以绑定到一个项目工作区。它的会话就在该目录中创建，因此 Bot 的 workspace_task 工具看到的看板，与用户其他会话看到的是同一个。交付物仍然放进共享电脑文件夹；看板是共享账本。在 Bot 设置 → 工作区 中绑定（留空则 Bot 保持隔离）。
- 单向看板镜像（MVP-2）： 安装 Workspace Hub 后，每个 Deepseek Bot Army 任务都会镜像到该工作区的看板（[Bot 名称] 标题），状态映射为 queued→todo、working→doing、review→blocked（"Deepseek Bot Army: ready for your review"）、done→done（"Approved in Deepseek Bot Army"）、failed→blocked。看板是跨会话账本；Deepseek Bot Army 仍是执行与审批界面。镜像失败绝不会阻塞运行。
- 外部派发（MVP-3）： 发给某个 Bot 会话的 Workspace Hub dispatch，会在 Bots 面板中显示为 「Dispatched via Workspace Hub」 任务，并带有自己的审批关卡，即使这一轮并非本插件发起。

端到端跑通后，两个方向都能工作：看板任务 → 派发到 Bot 会话 → Bot 读取/更新同一个看板任务，写出交付物，再回到 Bots 面板等你审批；同时 Bot Army 面板里的任务也会出现在看板上，供其他会话查看。

共存研究、运行时证据和集成路线图见 docs/workspace-hub-integration.md。

如何映射到 Harness

| Deepseek Bot Army 概念 | Harness 实现 |
| Bot | 通过 Session 控制器创建的持久 Harness 会话，带人设提示词 |
| Bot 的电脑 | 一个共享目录，$DSH_HOME/deepseek-bot-army/computer |
| 消息线程 | 插件存储（$DSH_HOME/deepseek-bot-army/state.json），以 Bot 的会话作为长期运行的上下文 |
| 任务 / 审批 | 插件任务记录，状态流转 queued → working → review → done；不会自动审批任何任务 |
| 记忆 | 从回复中解析出 MEMORY: 控制行，存到 Bot 上，注入它的下一条提示词 |
| 交接 | 从回复中解析出 HANDOFF: @Name — …，创建并启动队友的任务 |
| @mention | Composer 选择器随消息发送 mentions: [botId…]；宿主会拿它对照聊天成员解析，解析不到时回退到手动输入的 @Name 文本 |
| Routine | 由「Teach a task」保存的按 Bot 步骤，注入每条提示词，可按需运行 |
| Skill | 共享库，注入每个 Bot 的提示词 |
| Activity line | session/event tool/call 映射为动词标签 |
| Streaming | agent/assistant-stream 文本增量，最终文本以持久化的 assistant/message 为准 |

宿主与客户端通信走同源 JSON API，位于 /deepseek-bot-army/api 下（由 Harness Connection 服务守护）。这样整个 bundle 保持纯 JavaScript，无需构建步骤，也不导入任何 Client 包。

安装

Deepseek Bot Army 通过 ZVID Plugins 市场索引分发：

- 市场索引：<https://raw.githubusercontent.com/tyxt-zvid/zvid-plugins/main/index.json>
- 仓库：<https://github.com/tyxt-zvid/deepseek-bot-army>

用 DSH 插件命令行从仓库安装：

dsh plugin --profile desktop add https://github.com/tyxt-zvid/deepseek-bot-army

或安装发布 tarball（例如 deepseek-bot-army-0.9.0.tgz）：

dsh plugin --profile desktop add ./deepseek-bot-army-0.9.0.tgz

bundle 名为 @local/deepseek-bot-army。它通过 cordis.patch.yml 插入 deepseek-bot-army Host 行，并从 client.js 注册侧边栏入口和主面板。更新后如果面板看起来还是旧的，重载一次 Harness 窗口，让浏览器加载最新的 client 模块（Client HMR 接收器通常会自动重载）。

本地开发

要改插件本身，克隆仓库，然后在 Harness 配置档里把该检出目录链接为 bundle @local/deepseek-bot-army（对检出目录安装，而不是对已发布版本安装）。插件保持纯 JavaScript，无需构建步骤；npm test 运行宿主侧测试套件。

范围与设计取舍

插件构建在 Harness 原语之上，因此有些行为是刻意替换的：

- 云电脑（共享 VM + 浏览器 + 应用登录）换成 Harness 的本地工具和一个共享工作区目录。面板把它标为 Computer，显示真实文件。
- 登录第三方应用不做尝试；Bot 写草稿和文件，由人来发送。
- Routine 的定时/触发在此版本中是手动运行；限制（每个 Bot 50 条 routine，间隔 ≥5 分钟）写在 UI 文案里。之后可由 Harness 调度器接管。
- 演示式教学录屏是引导式步骤记录器：你写下的步骤会保存为草稿 routine 和共享技能。
- 托管市场 / 团队 bot / 计费不在范围内；目录在本地打包。
- 工具级审批卡由动作审批模型覆盖：敏感工具调用会暂停并执行前先询问，而配置档的权限预设仍然决定 Bot 工具能做什么（见 docs/approval-model.md）。

设计基线

Bots 面板现在实现 Open Design 生成的 Apple HIG 版本。源码与规格：docs/design-apple/。

- bots-workbench.html —— 156 KB 单文件原型，含 Light / Dark 两种外观、完整窗口外壳、四个视图和两个 sheet。
- DESIGN.md —— 双外观 token、SF 字体排印、8pt 节奏、组件与 HIG 规则。
- README.md —— OpenDesign 项目 id、技能 / 设计系统绑定、实现说明与组件映射。

插件保留现有数据与操作，把设计 CSS 限定在 .gpb-root 下，通过 useHostTheme() 跟随 Harness 主题，去掉假的 macOS 窗口边框（Host 已经提供），并把设计里的侧边栏、分段控件、分组列表、审批卡片、上下文面板、页面和 sheet 映射到实时团队状态。

历史版本：早先的 Linear 风格设计仍留在 docs/design/；它不再是渲染的 UI。

消息路由与审批

v0.5.0 引入操作级审批模型：

- 派发前先判断意图 —— lib/classify.js 把每条消息分类为 chat / task，判断不了时返回 needsConfirmation。不确定的消息渲染确认卡片（派成任务 / 只是聊天 / 暂不处理），而不是猜。
- 操作前先审批 —— Bot 会话里的敏感工具调用会在 tools/pre-execute 暂停，弹出操作审批卡片，含 Allow once / Always allow / Deny。只读工具直接放行；授权按 Bot 和工具持久保存。
- 自动审查 —— ask-first（默认）或 allow-all，支持按工具授予 Always-allow。无人值守工作的审批 10 分钟后过期；群聊从不显示审批卡片。
- 投递不等于审批 —— 任务成功即结束为 done；新任务没有事后任务审查。

完整模型与已知限制见 docs/approval-model.md。

学习、记忆与例程

v0.6.0 在审批模型之上加了下一层：

- 意图兜底 —— 确定性分类器拿不准时，调用一次默认模型（lib/classify.js: refineIntentWithModel）判定 chat/task。超时、缺少模型或回答格式不对，都回退到确认卡片。
- 记忆 —— 按 Bot 的记忆，精确去重 / 合并，带来源和时间戳，上限 40 条，按词法 top-k 检索注入每条提示词；团队记忆由所有 Bot 共享，bot 通过 TEAM_MEMORY: 写入，用户也可在 Memory 面板写入。
- 例程 —— 手动 / 间隔 / 每日 / 工作日调度，以及「任务完成后」触发器，持久化 nextRunAt，每个例程的运行记录（最近 20 条），失败计数，连续失败三次后自动暂停。
- 录制教学 + 自动沉淀 — 运行过程会记录工具步骤；任务完成后会提示「把这次运行保存为例程 / 技能」，记录的是真实步骤，不用你重新敲一遍。当前环境不支持录屏；捕获的工具步骤是近似替代方案。

输入框里的 @ 提及（v0.7.0）

对话框支持用 @ 提及 / 标记某个 Bot，这样一条消息就能只发给某位队友，而不是整个群组：

- 选择器 — 输入 @ 会在输入框上方弹出列表，列出当前会话的成员（群聊还会多一个 @everyone）。继续输入可按名称或标签过滤，用 ↑/↓ 移动，用 ↵ 或 Tab 插入，用 Esc 或点击关闭。输入框工具栏上的 @ 按钮会在光标处打开同一个选择器。
- 标签胶囊 — 被标记的 Bot 会以胶囊形式显示在文本框上方；点 × 会从草稿里删掉对应的 @Name token。手动输入的提及也会生成胶囊，所以发送前总能看清标记了谁。
- 消息记录 — 你的消息和 Bot 回复里的 @Name token 都会渲染成高亮的提及胶囊（包括 HANDOFF: @Name 这类行）。
- 路由 — 客户端会随文本一起发送结构化的 mentions: [botId…] 和 mentionEveryone，宿主优先信任这些信号（结构化 @everyone > 被标记的 Bot > 群主）。只有收不到结构化信号时（旧客户端、旧消息、手动输入的提及），宿主才解析文本：先按词边界匹配 @everyone，再按最长 @Name 优先、带左边界匹配，避免把 bob@Example.com 和 @Bot 2 误读。
- 持久化 — 用户消息会保留自己的 mentions 数组，待确认的意图也会保留 mentions / everyone，所以在「派成任务 / 只是聊天」确认之后才回复的 Bot 依然能收到这些标记。

消息本身仍以 @Name 文本形式撰写，因此存下来的消息记录在 UI 之外也保持可读。宿主侧的路由与持久化由 npm test（test/routing.test.mjs）覆盖。

每个 Bot 都能看到 Bot 列表（v0.7.1）

Bot 就是普通的 Harness 会话，所以 Harness 的 list_agents 工具只会列出这个 Bot 启动的子代理，永远看不到群聊里的其他成员。实际使用中，群聊里的 Bot 被问到「这里有几个 Bot？」时回答「只有我」，而明明就在旁边的队友还得自我介绍一下。

现在每次 Bot 运行都会拿到群聊名册，作为团队上下文的一部分：

- 名册区块 — ## Team roster — this group chat has N Bots，每个成员一行：名称（标签，读到自己的那行会标 you）加一句简介。1:1 会话则改为列出整个团队，因为这些 Bot 才是有效的 HANDOFF: 目标。
- 回答问题 — 提示词会说明名册是权威来源，让 Bot 据此回答「谁在这里 / 有几个 Bot」，并提醒 list_agents 只列出子代理。
- 工具输出如实呈现 — Bot 会话调用 list_agents 时，宿主会把同一份名单追加到工具结果里。这样，即使 Bot 去调这个工具，拿到的也是团队名单，而不是「没有子代理」。
- 实时生效 — 每轮对话都从持久化存储重新生成名单。新增 Bot、重命名 Bot、修改群组成员，下一条消息就会体现，无需重启。

npm test（test/roster.test.mjs）覆盖了这些：群组数量与名称、子集群组、1:1 交接目标，以及两种聊天类型下名单是否出现在组装好的提示词里。

心跳唤醒（v0.8）

Bot 仍会在收到消息、交接、例行任务和外部派发时醒来。不过，有空闲但还有未完成工作的 Bot 现在会自己查岗：

- 第 0 层 · 分诊 — 宿主每 30 秒跑一次确定性规则（lib/heartbeat.js）：重启后中断的任务/消息、没有运行记录却处于 working 状态的孤儿任务，或丢失的派发。只有命中这些情况才会调用模型，所以健康的空闲 Bot 不产生任何开销。
- 第 1 层 · 脉搏 — 一次轻量 JSON 调用（不建会话、不带工具、8 秒超时）。它返回经过校验的判定 —— idle / wait / resume / ask_user —— 返回文本按不可信数据围栏处理。
- 第 2 层 · 恢复 — 在 Bot 的持久会话里跑一次正常全量执行（同样的工具、审批门禁和 20 分钟上限），带着检查点和尝试预算继续任务。心跳审批并入无人值守的 10 分钟过期策略；用户消息永远优先于唤醒。

面板在 Bot 设置（开关、间隔、免打扰时段、每日上限）、Heartbeat 上下文面板分区（模式、下次检查、上次判定、今日计数、立即检查）以及会话内的 check-in 卡片 中展示这些。完整设计、状态机和 P3/P4 路线图（后续控制行、更广的候选范围、自适应间隔）见 docs/heartbeat-model.md。

目录结构

| 文件 | 作用 |
| index.js | 宿主侧：存储引导、JSON API、动作派发 |
| lib/store.js | 持久化团队存储（bots、threads、tasks、skills、activity）、原子 JSON 写入、共享计算机文件访问 |
| lib/runtime.js | 通过 Session 控制器执行 Bot、实时活动、记忆/交接解析、心跳准入/抢占、任务结算 |
| lib/heartbeat.js | 心跳 P2：确定性分诊、摘要、脉搏调用/解析、认领、预算、调度器 |
| lib/templates.js | 市场目录和首次运行的名单 |
| lib/mirror.js | 可选的单向镜像：把 Deepseek Bot Army 任务同步到 Workspace Hub 看板 |
| client.js | Web 侧：侧边栏入口、面板、所有视图、输入框 @ 提及和弹窗 |
| test/routing.test.mjs | 宿主侧测试：提及路由、文本回退、提及持久化 |
| test/heartbeat.test.mjs | 心跳测试：分诊、摘要/解析、认领/预算/check-in、引擎和运行时恢复/抢占 |
| test/roster.test.mjs | 宿主侧测试，覆盖注入 Bot 提示词的按会话团队名单 |
| locale/*.json | 插件展示元数据 |

说明

- Bot 重名：从选择器插入的标签会精确指向你点击的那个 Bot；手动输入 @Same Name 会唤醒所有同名 Bot，因为仅凭文本无法区分。
- 面板语言跟随 Harness 的 locale（内置英文和中文词典）。
- v0.8.0 验证：npm test 覆盖提及路由和心跳切片（分诊、认领、脉冲解析、预算/签到、引擎恢复、运行时全力恢复、抢占、过期认领拒绝）；node --check 覆盖所有宿主/客户端文件；客户端模块通过桩 window.__ModuleLoader__ 加 React 桩做冒烟加载，并检查 CSS 括号和 en/zh DICT 一致性。实时 GUI/手动 QA——Harness 窗口内的重启恢复、真实审批和移动端布局——仍需人工过一遍；当前环境无法控制浏览器。
- 当前环境无法做视觉验证（无浏览器控制，截屏被阻止）；插件的客户端注册已生效，其模块已做冒烟测试，Host API 和下面所有 bot 流程都用真实运行验证过。
- 已验证流程：1:1 任务完成、在共享电脑上真实创建文件、任务审查、群聊 @ 路由、例行创建与手动运行、技能创建、市场 bot 创建；外加 Workspace Hub 集成：看板任务镜像 todo→doing→blocked→done、Bot 会话读取/更新同一看板、Workspace Hub 派发在 Bots 面板中浮现待审查。