前言¶
DeepSeek Harness（DSH）的 Agent Teams 已经能把「建成员、派任务、等待、完成」这几件事跑通。实际做软件交付时，还会卡在另一类问题上：需求从哪进、阶段什么时候能开闸、哪份文档算事实来源、会议纪要落在哪、低峰时段要不要人手掐表派活。这些判断如果只留在对话里，团队很快会像聊天室而不是交付组。
下面介绍的 DSH Agent Team Planner（仓库 haistar/dsh-agent-team-planner）是 haistar 维护的社区工作流插件。它在官方 Agent Teams 之上增加需求、版本、阶段门禁、会议、文档、人工确认与调度，把一组 Agent 约束成可见、可审计的小型研发流水线。插件使用公开 Host 服务与官方 Agent Teams API，不 fork、不 patch、不绕过 DSH；与 DeepSeek / 幻方无隶属关系。社区目录页见 skillhub.cn，源码与文档在 GitHub（MIT 许可证，package 版本 0.8.5）。
这是什么¶
一句话定位：为 Agent Teams 增加的项目研发工作台——一个工作区对应一个项目团队，一个版本对应一条交付流水线，界面上的「下一个合法动作」由门禁与确认驱动，而不是从聊天里临时冒任务。
与「只有任务板」相比，Planner 把需求文档、架构文档、会议产出和人工确认都做成版本关联的产出物；成员先配置、首次派发或参会时才懒创建官方 teammate，并支持每成员独立的 provider / model / reasoning effort 路由。
核心功能¶
工作台入口与三个 Tab¶
左侧入口 dsh-agent-team-planner 打开主区工作台，包含：
- 版本看板：版本头、五阶段流水线、进行中任务、时间线、团队负载、产出物、人工确认事项。
- 需求：新建、编辑、附件、指定成员、绑定版本。
- 会议：按版本组织的需求澄清、架构评审、测试评审与自定义会议。
顶栏集中当前项目、工作区切换、当前版本、打开工作区目录、中英文切换、配置与返回对话。布局为主/侧 60/40、列内滚动，避免整页滚动。
需求、版本门禁与任务派发¶
版本阶段固定为：
需求 -> 架构 -> 开发 -> 评审 -> 测试 -> 完成
需求文档确认后才能进入架构；架构设计文档确认后才能开发。开发阶段生成或编辑任务规格（可本地确定性拆分，也可手工编辑 JSON），再派发为官方 Agent Teams 任务。评审/测试报告确认后推进版本。已完成或已归档版本只读，需求、产出物、采集与会议均不可再改。
成员与会议¶
新项目提供六个默认成员配置：Luna（产品）、Kael（架构）、Zoe（前端）、Owen（后端）、Mia（测试）、Jasper（运维）。member.create 仅写配置，不立刻创建官方成员；首次派发或参会时懒创建，同名官方成员会复用。
会议产出会写入版本文档：例如需求澄清会生成需求文档草稿并出现在看板；进入架构设计时会自动创建架构评审。会议期间对 Agent 注入规则（不生成/改代码、不改流程/配置/任务），非参会成员暂停新任务派发。
人工确认与高能效模式¶
「人工确认事项」支持开发完成确认、一键确认并进入评审、带原因的驳回，以及草稿评审/测试报告的 Markdown 查看与确认；文档确认本身可推进阶段，不必再依赖任务绑定状态。
配置中的 高能效模式 默认关闭。开启后，新派发与产出物采集仅在 DeepSeek 空闲时段执行；北京时间周一至周五（不含法定节假日）高峰为 09:00–12:00 与 14:00–18:00，周末、2026 年中国法定节假日表内置的假日及其余时间为空闲。看板会显示调度处于等待还是可执行。
持久化¶
Planner 状态按工作区隔离，路径为工作区下的 .dsh_teams/planner/state.json，备份同目录轮转保留最近 10 份含数据快照。DSH 重启后任务列表与时间线可回退到持久化 bindings。
环境要求¶
- DSH 0.2.1-rc.2 或兼容 0.2.x（
engines.dsh:>=0.2.1-rc.2 <0.3.0），并启用官方 Agent Teams profile。 - Node.js 20+。
- Windows、macOS 或 Linux；手动安装脚本为 PowerShell，插件本体为 Node.js。
安装与启用¶
项目仅通过 GitHub 分发，没有 npm 包。官方 README 给出的步骤如下：克隆仓库后运行 profile 链接脚本，再重启 DSH Web。
git clone https://github.com/haistar/dsh-agent-team-planner.git
cd dsh-agent-team-planner
# 将插件链接进 web profile，并注册 bundle
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-manual.ps1
# 重启 DSH Web
安装脚本会备份 profile manifest、添加 link: 依赖、注册 bundle 并复制发布文件。卸载时使用同目录下的 scripts\uninstall-manual.ps1。若侧栏入口不见，确认 bundle 列表包含 dsh-agent-team-planner 并已重启 Web。
注意： 插件以当前 DSH 进程权限运行，安装前请阅读仓库源码与 MIT 许可证；Planner 不做遥测，规划数据与附件保存在工作区 .dsh_teams/planner/ 下。
典型用法¶
README 中的快速开始可概括为以下顺序，均在 Planner 工作台与「配置 → 团队」中完成：
- 打开工作区，在「配置 → 团队」绑定 Team Session。
- 新建版本。
- 添加需求，指定成员并上传附件（支持
txt / doc / docx / xls / xlsx / png / jpg / jpeg，单文件 ≤ 10MB）。 - 开需求澄清会，生成并确认需求文档。
- 进入架构设计——架构评审会自动创建并打开。
- 生成并确认架构设计文档。
- 开始开发，任务规格派发给指定开发成员。
- 开发完成后，在「人工确认事项」选择「确认并进入评审」。
- 确认评审/测试报告，版本完成并归档产出物。
本地开发或贡献前可在仓库根目录执行：
npm run check # 语法检查
npm test # Host 冒烟 + Client 模拟 + Renderer/i18n
适用场景与限制¶
适合： 已在 DSH 0.2.x 上启用 Agent Teams、希望用版本门禁、文档产出物和会议把多 Agent 协作收成一条交付流水线，而不是在对话里即兴派活的团队或个人。
限制（README 已说明）： 构建与测试基线为 DSH 0.2.1-rc.2，后续 Host/Client 接口可能变化；高能效模式的中国法定节假日表当前覆盖 2026 年；官方任务视图不提供 Token 统计。插件为社区项目，SkillHub 等目录站点与 DeepSeek 无官方从属关系。
结尾¶
Agent Teams 解决协作原语；Agent Team Planner 补上需求、版本、门禁、会议、确认与调度，让「一次点击 = 下一个合法动作」落在界面上。需要概览与分类（工作流）时可打开 SkillHub 目录页，安装与细节以 GitHub 仓库 README.zh-CN.md 为准。
