前言¶
在 DeepSeek Harness（DSH）里用 Agent Teams 做长周期项目开发时，主对话往往既要理解需求，又容易亲自读文件、改代码；用户中途追加的修改点也容易散落在对话里，同一问题多次返工缺少归并记录，参考实现的对标也容易断档。社区插件 dsh-code-team（npm 包名 dsh-project-dev）把「主对话只派活、不动手」和「按修改点追踪的看板」做成一套机制：Lead 只做理解、记点、派工与验收汇报，具体执行交给团队成员；聊天里有一张可拖动的悬浮开发看板，把每条修改点从派单到验收串起来。维护者为 kkomia，源码与说明见 GitHub 仓库，社区目录页为 skillhub.cn/plugins/kkomia/dsh-code-team。DSH 生态强调「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-code-team 是 DeepSeek Harness 的「项目开发模式」预设与「开发进度看板」能力的组合插件。同一个 bundle 里包含 preset、Host 服务与路由、7 个看板相关工具、Lead 侧硬拦截，以及 Web Client 上的悬浮看板卡片。
它针对四类常见问题做了约束化设计：
- Lead 不动手：在 profile 级通过
guard.js识别项目开发模式 Lead，拒绝不在允许清单内的工具调用（读文件、跑命令、查网页、写文件等）；Lead 主要使用 agent-team、看板工具以及 ask / todo / goal / plan / present 等。 - 修改点台账：用户每个修改点写入看板，保留原话（
userQuote），状态沿pending → dispatched → running → testing → tested → accepting → accepted推进，失败可回退并记入attempts。 - 按工种派活：常设调研、规划、设计、工程进度对照、测试、验收等角色，按需增设前端、后端、探索、审核；成员
name采用「英文职位-英文昵称」（如researcher-ada），团队面板可辨工种。 - 持续对标：可固定一份参考方案，大改前由调研员产出对标差距表；长时间未对标会在审计中提醒。
项目开发模式下的成员看不到 subagent、subagent_fork、subagent_codex、workflow、ralph 等路径，团队工作统一走 agent-team。
运行要求（以 README 为准）：DeepSeek Harness >= 0.2.1-rc.2（实验版 Agent Teams），Node >= 22。许可证：MIT。当前 package 版本为 0.1.4。
核心功能¶
Lead 硬拦截与模式隔离¶
guard.js 在 profile 级按 SessionHeader.agentPreset 识别项目开发模式 Lead，通过 agent.ctx.tools.guard() 拦截未授权工具。重启 DSH 后，新会话里读写类工具定义会变为禁用占位，即用户要求「违反一次」也会被拒绝；ralph / subagent_codex 等在该模式下不可见。teammate 继承 Lead 的 preset，同事仍可使用工作类工具；Lead 的限制由 per-Agent guard 实现。
聊天内悬浮开发看板¶
在「项目开发模式」会话中，对话区左上角（「智能体团队」条下方）出现胶囊「开发看板 · 共 N 项 · 进行中 x · 待验收 y」，可拖动且位置会记忆；点击展开为悬浮卡（标题栏可拖，Esc 收起）。看板未建立时显示「开发看板 · 等待 Lead 入板」。其他模式不占该 UI 空间；若工作区已有看板数据，非项目开发模式会话也可能只读展示悬浮卡。
展开后可查看：参考方案条、统计与筛选、条目列表与详情（用户原话、理解与验收标准、分派环节、执行与测试/验收证据、返工时间线、合并来源、审计摘要等）。Client UI 只读；写入仅通过 agent 工具。
看板数据与七个工具¶
数据按工作区路径持久化到 $DSH_HOME/project-dev/boards/<boardId>.json（boardId = pb- + 工作区路径 sha1 前 8 位），采用原子写与进程内串行队列。
| 工具 | 作用 |
|---|---|
project_board_open |
打开/创建当前工作区看板，同步团队名册 |
project_board_add |
新增修改点；可用 mergeInto 记同一问题的新一轮返工 |
project_board_update |
推进状态及 prune 批量清理等 |
project_board_merge |
合并重复/关联条目 |
project_board_reference |
设置/更新参考方案与对标差距表 |
project_board_list |
精简查询 |
project_board_audit |
完整性审计（未派单、未测试、未验收、返工≥2、待确认、对标过期、stale running 等） |
写权限主要由 Lead 与「工程进度对照员」承担；其他成员可通过 list / audit 只读自查。看板工具挂在项目开发模式 preset 上。
团队分工概要¶
常设角色包括调研员、规划员、设计师、工程进度对照员、测试员、验收员；机动角色含前端、后端、探索、审核。一人最多两职；运行时无删除 teammate 的 API，闲置成员通过 redefine 改定义复用，不扩编不辞退。send_message 的 target 须使用 list_agents 返回的英文 name。
Host 侧还提供只读快照路由 /api/project-board/snapshot（见 index.js）。
安装与启用¶
安装前请自行阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行。
方式 A：插件管理工具（README 推荐）¶
将仓库放到本地后，在 DSH 中让 Agent 执行：
plugin_manager install_bundle target = <本仓库绝对路径>
也可通过 Web 端 Plugins 页同源能力安装。
方式 B：命令行¶
# 直接用 GitHub 仓库安装（README 推荐）
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 名称。README 提到若包发布到 npm，也可 dsh plugin --profile desktop add dsh-project-dev。
安装完成后：
- 重启 DSH 一次（Host 插件与 preset 需重新加载）。
- 打开 设置（Ctrl+,）→ Agent 预设 → 自定义 → 项目开发模式，设为新任务默认；或在新建会话页选择「项目开发模式」模式 chip。
说明：仅改 client.js 时刷新页面即可；改 Host 侧文件（如 index.js、store.js、board-tools.js、mode-guard.js、guard.js、cordis.patch.yml）需重新安装并重启。
典型用法¶
- 在「项目开发模式」会话中直接提需求或修改点。Lead 先复述理解，有歧义时用
ask_user_question追问。 - Lead 将每个修改点写入看板，再按工种
send_message派活，并登记dispatch（环节与成员）。 - 在对话区通过悬浮看板查看进度；工程进度对照员定期用
project_board_audit抓遗漏与风险项，Lead 汇报前也会参考审计结果。 - 同一问题多次未修复时，用
fail/attempt/mergeInto记入同一条目的attempts[]，避免用新条目掩盖返工。
仓库提供 33 条 Node 内置测试（node --test test/），覆盖 store 状态机、返工归并、持久化与 guard 拦截；README 记录了 GUI 与重启后硬拦截的验证说明（见 docs/VERIFICATION.md）。
适用场景与注意¶
适合：希望主对话专职「产品经理 + 项目经理」、把实现与测试交给 Agent Team，且需要可持久、可审计的修改点台账与参考对标的长周期开发会话。
注意（摘自 README 已知限制）：
- 看板按工作区路径归并，同一目录视为同一项目；多项目请分目录。
- 本模式使用默认 native 工具呈现；若改为 PTC 呈现，工具调用会走
run_code并被 Lead 守护拒绝，设计上不兼容。 - 部分环境下宿主 pointer 事件可能影响卡片拖动；默认位置在对话区左上角。
- 社区目录星标等元数据以站点展示为准；安装与版本以仓库与 package 为准。
结尾¶
dsh-code-team 把 DSH 上的 Agent Teams 收敛成「Lead 只协调、成员干活、看板记账」的项目开发流程，并在聊天界面提供可读的进度视图。若要试用或贡献，可从社区目录页 skillhub.cn/plugins/kkomia/dsh-code-team 进入，或直接查看 github.com/kkomia/dsh-code-team。
