前言¶
在 DeepSeek Harness（DSH）里做多步、多角色协作时，常见做法是你在主会话里反复切换话题，或手动开多个对话各自干活。任务一多，谁负责什么、上一轮结论是什么、下一步该派谁，很容易散在聊天记录里，难以延续。
Project Mode 是社区维护的非官方插件，把「协调多 Agent 项目」交给主会话里一个持久存在的 Coordinator：由它选人、派活、审结果，并维护项目级笔记与共享上下文；Worker 可创建也可复用，执行仍走 DSH 原生的会话、Agent Loop、工具与权限。下面介绍它是什么、能做什么，以及如何在不污染日常 DSH 配置的前提下试跑。
这是什么¶
- 仓库：Burns1028/dsh-plugin-project-mode
- 目录页：SkillHub 插件条目
- 维护者：Burns1028
- 分类：工作流
- 定位：Unofficial Project Mode for DeepSeek Harness——持久 Coordinator、可复用 Worker、共享项目上下文；并包含针对 DSH 0.2.1-rc.3 的隔离式安装方案。
- 当前预览版本：v0.1.23（README 标注为 unofficial developer preview）
插件运行在 DSH 进程权限之内；安装或使用前请自行阅读源码与许可证，SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
README 用表格归纳了能力，此处按协作链路简述（事实均来自仓库 README）。
| 能力 | 作用 |
|---|---|
| 持久协调 | 主会话中的 Coordinator 持有项目工作记录与下一步安排。 |
| Worker 全生命周期 | 创建或复用 Worker，引导当前任务、排队后续指令，查看状态与历史，中断或删除。 |
| 共享项目知识 | Coordinator 与 Worker 维护索引，并按需渐进加载相关上下文。 |
| 结果自动回传 | Worker 每轮结束会把其完整最终 AI 消息交回 Coordinator 审阅。 |
| 人工直接介入 | 可打开某个 Worker 自行指导，再回到 Coordinator。 |
| 原生 DSH 执行 | 会话、Agent Loop、工具、权限、消息投递与 Stop 仍由 DSH 提供。 |
角色分工（User guide）：
- 你：定目标、做决策、与 Coordinator 对话；也可直接进入 Worker。
- Coordinator：选 Worker、供上下文、审结果、维护工作记录与共享知识、汇报进展；小范围澄清与自包含动作也可自行处理。
- Worker：完成被指派的调查或执行，贡献可复用发现，并返回自洽的最终 AI 消息。
项目记忆落在工作区 .dsh/project-mode/<project-id>/，其中包括 notes.md（待办、分配、进度、阻塞、下一步）、archived.md（已结束工作）以及 context/ 下的共享索引与决策等文件。Coordinator 会维护 notes.md，与对话并排可见。
兼容性与版本要求¶
README 明确：需要 DSH 0.2.1-rc.3，且须配合本仓库文档中的三项 compatibility extensions； stock 版 rc.3 无法直接启用插件。隔离式 setup 会在 ~/.dsh-project-mode/rc3 安装锁定的 rc.3 运行时并应用这三项扩展，不会复用你日常的 Desktop、~/.dsh、全局 Agent 配置与工作区。细节见仓库 Compatibility。
环境要求（Quick start）：Node 24.9+、npm 与 Git。
安装与启用¶
方式一：隔离式 Web 环境（README 推荐的首次体验）¶
在独立目录克隆指定标签并运行脚本：
git clone --branch v0.1.23 https://github.com/Burns1028/dsh-plugin-project-mode.git
cd dsh-plugin-project-mode
node scripts/project-mode.mjs setup
node scripts/project-mode.mjs start
setup 完成后可用下面命令检查环境：
node scripts/project-mode.mjs doctor
本地会打开原生 Web UI；配置模型、新建对话后，在第一条消息之前选择 Project 模式。更完整的首次运行说明见仓库 docs/quickstart.md。
方式二：已具备兼容 Desktop / 运行时¶
若你已有文档所述的兼容环境，可通过 DSH CLI 安装固定标签：
dsh plugin --profile desktop add "git+https://github.com/Burns1028/dsh-plugin-project-mode.git#v0.1.23"
Tagged 资源包见 Releases。
典型用法¶
README 给出的 usual workflow 可概括为：
- 向 Coordinator 提出目标；它会查看已有 Worker 与项目记忆（含你在子对话中的直接操作）。
- 选用已有 Worker 或新建，下发目标与上下文，并更新
notes.md。 - 进展变化时用 steer 引导当前工作，或用 queue 在当前轮次结束后再执行指令；中断与删除是独立操作。
- 每个 Worker 轮次结束自动回传完整最后 AI 消息；若无 AI 消息仍会报告身份与结果（AI 部分为空）。
- Coordinator 审阅后跟进或收尾，更新工作记录与可复用上下文；正常结束会在同一 Coordinator 轮次内等待相关工作与结果消费完毕。
仓库提供可复现演示：docs/demo-workflow.md，示例场景为 CLI 改动：Exporter 实现标题排序与测试、Docs 维护用法说明、Coordinator 审阅；人类可在 Exporter 对话中改排序，后续任务在共享上下文下复用同一批 Worker。录制说明中提及样例通过 9 项真实测试（以 README 为准，非性能承诺）。
适用场景与注意¶
更适合：需要在单个项目内长期保留协调者、多 Worker 并行或串行、并希望笔记与 context/ 索引跨任务复用的 DSH 用户。
务必注意：
- 非官方预览版，依赖 rc.3 与三项扩展；勿假设与正式版 DSH 或「未打补丁的 rc.3」即装即用。
- 隔离安装 deliberately 不动现有 Desktop 配置；若要在日常 profile 使用，须自行确认 compatibility 文档中的手动路径。
- 插件与 DSH 同源执行模型与工具权限；安装前审查代码与 License（README 目录项）。
结尾¶
Project Mode 把多 Agent 项目的协调层从「散落的多个聊天」收拢到一个持久 Coordinator，并用 Worker 复用与 .dsh/project-mode/ 下的项目记忆支撑连续交付。若你要在可控的 rc.3 隔离环境里试工作流，可从 project-mode.mjs setup 起步；若已对齐兼容运行时，用 CLI 固定标签 v0.1.23 安装即可。
- 目录页：https://www.skillhub.cn/plugins/Burns1028/dsh-plugin-project-mode
- GitHub：https://github.com/Burns1028/dsh-plugin-project-mode
