前言¶
在 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
