dsh-code-team
DeepSeek Harness 的「项目开发模式」+「开发进度看板」插件。
模式：主对话（Lead）只做 理解需求 → 记录修改点 → 按工种派活 → 验收汇报，完全不动手；具体工作全部交给 agent-team。
插件：聊天内一张悬浮开发看板，把用户提出的每个修改点按「派单（含各环节成员）→ 执行 → 测试 → 验收」追踪；同一问题多次返工归并进同一条目；并持续维护对参考方案的对标。
- 插件包名：
dsh-project-dev（同一个 bundle 同时携带 preset、Host 服务/路由、7 个看板工具、Lead 硬拦截与 Client 悬浮卡）
- 运行要求：DeepSeek Harness
>= 0.2.1-rc.2（实验版 Agent Teams）、Node >= 22
- 许可：MIT
悬浮看板
它解决什么问题
长时间的项目开发里，主对话容易犯四类错：自己动手干活、漏掉用户后来提的修改点、同一问题反复返工却没有归并记录、没有持续对标的参考实现。这个项目把它们变成机制：
- Lead 完全不动手：
guard.js 在 profile 级按 SessionHeader.agentPreset 识别项目开发模式 Lead，用 agent.ctx.tools.guard() 拒绝一切不在允许清单内的工具调用（读文件、跑命令、查网页、写文件全部拦截）；Lead 自己只用 agent-team + 看板 + ask/todo/goal/plan/present。
- 修改点台账：用户每个修改点在当轮写入看板（逐字保留
userQuote），状态机 pending → dispatched → running → testing → tested → accepting → accepted，失败回退并记录 attempts。
- 按工种派活：团队常设调研/规划/设计/工程进度对照/测试/验收六席，按需增设前端/后端/探索/审核；一人最多两职；成员 name 用「英文职位-英文昵称」（如
researcher-ada、frontend-cyrus，团队面板直接可辨工种），显示「中文职位 · 昵称」；闲置成员即时**改定义（redefine）**复用，不扩编不辞退。
- 持续对标：固定一份参考方案（本地源码/仓库/截图/竞品），每次大改前调研员读参考实现产出「对标差距表」，写回看板
reference，14 天未对标会在审计里提醒。
- 只用 agent-team：项目开发模式成员看不到 subagent / subagent_fork / subagent_codex / workflow / ralph。
安装
方式 A：用 Agent / 插件管理工具（推荐）
把本仓库克隆到本地任意目录，然后在 DSH 里让 Agent 执行：
plugin_manager install_bundle target = <本仓库绝对路径>
或直接调用 plugin_manager 的工具动作（Web 端 Plugins 页的安装能力同源）。
方式 B：命令行
# 直接用 GitHub 仓库安装（推荐）
dsh plugin --profile desktop add github:kkomia/dsh-code-team
# 或先 clone 再装本地目录
git clone https://github.com/kkomia/dsh-code-team.git
dsh plugin --profile desktop add link:<本仓库绝对路径>
# 然后重启一次 DeepSeek Harness（Host 插件改动需要重启生效）
--profile desktop 换成你实际使用的 Web profile 名称即可。若本包发布到 npm，也可以 dsh plugin --profile desktop add dsh-project-dev。
安装完成后：
- 重启 DSH 一次（Host 插件与 preset 声明需要重新加载）。
- 打开 设置（Ctrl+,）→ Agent 预设 → 自定义 → 项目开发模式，点卡片「设为新任务默认」；或在新建会话页底部模式 chip 里选择「项目开发模式」。
之后如果只改 client.js：刷新页面即可；改 Host 文件（index/store/board-tools/mode-guard/guard/patch）需要重新安装并重启。
使用
- 在「项目开发模式」会话里直接提需求/修改点。Lead 会先复述理解，有歧义用
ask_user_question 追问。
- Lead 把每个修改点写进看板，然后按工种
send_message 派活并登记 dispatch（记录环节 + 成员）。
- 项目开发模式会话里，对话区左上角（「智能体团队」条下方）出现收起态胶囊「开发看板 · 共 N 项 · 进行中 x · 待验收 y」；胶囊可拖动、位置记忆，点一下展开成悬浮卡（展开后也可拖标题栏、Esc 收起）：
- 参考方案条（名称 + 固定版本 + 对标时间 / 差距数）
- 统计与验收进度、7 个筛选
- 条目列表与详情（用户原话、理解与验收标准、分派环节、执行、测试证据、验收证据、attempts 返工时间线、合并来源、审计摘要）
- 看板尚未建立/加载中时，同一位置显示「开发看板 · 等待 Lead 入板」胶囊，同样可拖动；其他模式会话不占空间
- 进度对照员定期用
project_board_audit 抓「未派单 / 未测试 / 未验收 / 返工≥2 / 待确认 / 对标过期」，Lead 汇报前也会看审计。
模式会话
看板数据与工具
数据按工作区路径持久化：$DSH_HOME/project-dev/boards/<boardId>.json（boardId = pb- + sha1(工作区路径)[:8]；原子写 + 进程内串行队列）。UI 只读，写入只经 agent 工具。
| 工具 | 作用 |
|---|
project_board_open | 打开/创建当前工作区看板，自动同步团队名册（team[]） |
project_board_add | 新增一个用户修改点；带 mergeInto 时作为该条目的新一轮返工记录 |
project_board_update | 推进状态：dispatch / start / test / accept / reject / fail / attempt / block / obsolete / reopen / redefine / unmerge；另含 prune 批量清理（按 ids / statuses / categories，或 scope:"all" 清空整板；dryRun 预览、confirm 保护） |
project_board_merge | 把重复/关联条目并入目标条目（保留来源 id 于 mergedFrom，禁链式合并） |
project_board_reference | 设置/更新参考方案与对标差距表 |
project_board_list | 精简查询（状态/类别/关键词） |
project_board_audit | 完整性审计（未派单/未测试/未验收/返工≥2/待确认/对标过期/stale running） |
写权限：Lead 与「工程进度对照员」负责写看板；其他成员用 list/audit 只读自查。
条目（item）字段
id, number, title, userQuote, detail, category, priority, status, dispatch{stages[]}, execution, test{status,member,evidence}, acceptance{status,member,evidence}, attempts[], mergedFrom[], mergedInto, tags, note, createdAt, updatedAt
同一问题多次未修复：用 fail / attempt / mergeInto 记进同一 attempts[]，禁止新开条目掩盖。
团队分工
| 职位 | 必要性 | 职责 |
|---|
| 调研员 | 常设 | 读参考实现源码/文档/截图，出对标差距表；可行性调研 |
| 规划员 | 常设 | 把修改点拆成工作流与依赖，排批次与里程碑 |
| 设计师 | 常设 | UI/UX/动效/文案方案，先方案后实施 |
| 工程进度对照员 | 常设 | 看板第二写手：核对用户消息与看板、抓遗漏、推进状态、出审计报告 |
| 测试员 | 常设 | 写/跑测试，给命令输出/截图/复现步骤等证据 |
| 验收员 | 常设 | 逐条对照用户原话验收，拒绝无证据的「已完成」；兼审核 |
| 前端 / 后端 / 探索 / 审核 | 机动 | 按需增设；一人最多两职 |
成员 name 受 spawn_teammate 限制只能是小写英文 kebab，因此强制采用「英文职位-英文昵称」（如 researcher-ada、frontend-cyrus、tester-dora；固定前缀：researcher/planner/designer/progress/tester/acceptance/frontend/backend/explorer/reviewer），这样团队面板（只显示 name）一眼能看出工种；中文职位写在 description 首段、看板 team[] 与成员 chip 中。send_message 的 target 必须用英文 name/target（list_agents 返回值），显示名只用于汇报。改职（redefine）不改 name，当前职位以 description/看板为准。
开发与测试
# 33 条单元测试（store 状态机/返工归并/持久化 + guard 硬拦截），只依赖 Node 内置模块
node --test test/
# 或
node --test test/store.test.mjs
node --test test/guard.test.mjs
本机验证用 node >= 22.19（node --test test/ 走 test/index.js 聚合入口）。
已完成的真实验证
- 33 条单测全绿：本机与 GitHub Actions CI 均通过。
- 真实 GUI：项目开发模式会话可正常创建（SessionHeader
agentPreset=project-dev）；7 个 project_board_* 工具全链路实测（open → add → dispatch → start → test/audit）；悬浮卡在真实会话中渲染、展开、条目详情与审计均正常。
- Lead 硬拦截（重启后复测）：新 project-dev 会话里
read/write 的工具定义被替换为「⛔ 本模式禁用」占位描述，Lead 即使用户明确要求"允许违反一次"也拒绝调用；ralph/subagent_codex 完全不可见。详见 docs/VERIFICATION.md。
重启后硬拦截复测
目录：
index.js Host 入口：projectBoard 服务 + 只读快照路由 /api/project-board/snapshot
guard.js profile 级 Lead 硬拦截（agent.ctx.tools.guard）
store.js 纯函数看板存储/状态机/审计（可直接 node --test）
board-tools.js preset 内 7 个 project_board_* 工具
mode-guard.js preset 内提示词 sections + 子智能体工具 restrict + best-effort 影子工具
client.js Client 悬浮看板（conversation.input.dock）
cordis.patch.yml profile 补丁：project-board / project-dev-guard / preset-project-dev
docs/ DESIGN.md（设计规格）、PROTOCOL.md（字段契约）、MODE-TEXT.md（提示词正文）、VERIFICATION.md（重启后复测记录）
已知限制
- 运行时没有「删除 agent-team 成员」的 API：成员 name/名额记录永久保留，所以采用即时修改成员定义（redefine 改职复用），不扩编、不辞退。
spawn_teammate 的 name 只接受小写英文 kebab-case，因此强制用「英文职位-英文昵称」（如 researcher-ada）让团队面板可辨工种；中文职位放在 description 首段/看板中显示。改职（redefine）不改 name，当前职位以 description/看板为准。- teammate 会继承 Lead 的 preset，因此工作类工具保留在 preset 里给同事用；Lead 的限制由 profile 级
guard.js 的 per-Agent guard 实现。
- 看板工具只挂在项目开发模式；其他模式看不到工具，但已存在看板的会话仍会显示悬浮卡（只读）。
- Client UI 只读；看板写入只经 agent 工具。
- Host 插件改动需要重启 DSH 一次；Client 改动刷新页面即可。
- 看板按「工作区路径」归并：同一目录视为同一项目（多项目请分目录）。
- 本模式使用默认 native 工具呈现；若改成 PTC 呈现，所有工具调用会走
run_code 并被 Lead 守护拒绝（设计上不兼容 PTC）。
- 部分环境的宿主 pointer 事件可能影响卡片拖动；默认位置已固定在对话区左上角，不需要拖动。
致谢
- 美术与交互参考：dsh-claude-style（字体、主题色、动效节奏按本插件主题 token 适配）。
- 运行底座：DeepSeek Harness 的 Agent Teams（
@deepseek-ai/dsh-experimental-agent-team 等）。
License
MIT © 2026 kkomia
