前言¶
在 DSH 裏接 GitHub、飛書等來源的開發請求時，常見做法是單 Session 堆疊所有任務：上下文混在一起，Skill 和模型不好按工單隔離，長任務也容易拖垮主對話。若希望「主 Session 只做路由、每個工單在獨立目錄和 Worker 裏跑完再回貼結果」，需要把調度、授權和執行拆開。下面介紹社區插件 uuicdown/dsh-project-agent（倉庫 README 仍以 dsh-superagent 稱呼同一套實現），它在 DSH 上以 Host 運行時承載，把項目工作派發到帶 per-ticket Skill 的持久 Worker Session。
這是什麼¶
dsh-project-agent 由 uuicdown 維護，在 SkillHub 分類爲「工作流」。package.json 中的描述是：面向 DSH 的項目工作區智能體，路由主 Session 將 Ticket 分派到持久 Worker Session，併爲每個 Ticket 配置獨立 Skill。
同一倉庫的 README 說明：這是針對單個 GitHub 倉庫的主動式編碼智能體，打包爲 DeepSeek Harness 插件；可監聽 GitHub，並可選監聽飛書。經授權的人發起工作後，智能體開啓工作項，在獨立的 agent Session 與目錄中執行，並在原對話中回覆（例如提交 Pull Request）。Web 面板用於標出仍需人工處理的事項。README 明確寫明：僅供參考的研究原型，不是 DeepSeek 官方產品，工程上可能存在缺陷，使用前需自行審閱與改造。
核心功能¶
工單調度與 Worker Session¶
與「一切堆在主 Session」相比，插件強調路由層與執行層分離：主 Session 負責派發 Ticket，Worker Session 持久存在，按工單攜帶各自的 Skill（及簡介中提到的 per-ticket 模型配置）。這與 package.json 對插件能力的表述一致。
多來源監聽與閉環回覆¶
在 GitHub 上（以及可選的飛書）接收請求後，智能體在允許執行的條件下開工，在獨立工作區完成修改，並把結果回到觸發對話——README 以 Pull Request 爲例。設計上要求：僅在有人提出請求，或團隊編寫的規則允許時行動；僅在需要人處理或可提供結果時發言，以減少對整個團隊的注意力佔用。理念細節見倉庫文檔 docs/000-philosophy.md。
Web 面板與 Cordis 集成¶
package.json 中 dsh.runtime 爲 host，通過 cordis.patch.yml 做 bundle 補丁；客戶端爲 Web 平臺，並注入 locale、settings、renderer、layout、sidebar、workspace 等 DSH 客戶端模塊。面板相關行爲見 docs/005-panel.md。
文檔與領域模型¶
倉庫提供按序號閱讀的文檔：000 哲學、001 領域模型、002 授權、003 執行、004 提示詞、005 面板、006 部署與排錯、007 架構、008 Cookbook（例如新增 Source）。後文步驟會依賴 006 中的手工配置說明。
安裝與啓用¶
SkillHub 目錄頁的指引是：在 DeepSeek Harness 中安裝插件 uuicdown/dsh-project-agent（頁面表述爲「請安裝 DSH 插件 uuicdown/dsh-project-agent」）。社區目錄 SkillHub 是獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝前請打開 GitHub 倉庫 閱讀源碼與 MIT 許可證。
README 寫明初始化步驟較多，建議讓編碼智能體按 SETUP.md 協助完成。可向 DSH 中的智能體發送：
Read SETUP.md in this repository and set up dsh-superagent with me.
按 README 說明，智能體會逐項短問、展示完整計劃後安裝並配置。手工路徑見 docs/006-deployment.md。
環境與版本（來自 package.json，使用前以倉庫當前文件爲準）：
- Node：
^22.19.0 || >=24.0.0 - DSH：
^0.2.1-alpha.2 - 插件包版本：
0.1.21 - 包管理：
pnpm@11.7.0（開發側pnpm check會執行 typecheck、測試與 build）
注意： 插件在當前 DSH 進程權限下運行。安裝與啓用前請覈對倉庫聲明的研究原型性質，並評估 GitHub / 飛書等憑據與授權規則（docs/002-authorization.md）。
典型用法¶
用 SETUP 嚮導完成首次部署¶
1、在 Harness 中安裝 uuicdown/dsh-project-agent。
2、讓智能體讀取倉庫根目錄 SETUP.md 並按上文引用的提示與您協作配置。
3、配置完成後，按 docs/006-deployment.md 檢查監聽源、授權與升級方式。
按文檔理解運行行爲¶
需要調整「何時自動行動、對誰回覆」時，先讀 docs/000-philosophy.md 與 docs/002-authorization.md，再讀 docs/003-execution.md。需要改提示詞或面板時，分別參考 004 與 005。若要擴展新的消息來源，參考 008 Cookbook。
本地開發自檢¶
若在倉庫內改插件代碼，可在克隆後的開發環境中執行（README）：
pnpm check
該命令依次運行類型檢查、測試與構建。
適用場景與注意¶
適合： 已在 DSH 上維護單個 GitHub 倉庫、希望通過 Ticket + 持久 Worker 隔離任務，並可能對接飛書與 Web 面板的團隊或個體維護者；願意按編號文檔自行部署、授權與排錯。
不適合或未承諾： 需要「開箱即產線」官方支持的場景——README 反覆說明這是研究原型，與論文 Exploring Super-agent Design 中的部分設計並不完全一致，部分能力僅爲未來方向。
再次強調：插件不以獨立系統用戶運行，而是依附 DSH Host；錯誤配置可能導致在倉庫上的過度自動化或越權回覆。務必在啓用 GitHub / 飛書監聽前完成授權審閱，並保留人工在面板中介入的路徑。
結尾¶
dsh-project-agent 把 DSH 上的項目協作收成「主 Session 路由 Ticket → 持久 Worker 按工單 Skill 執行 → 回原對話交付結果」的工作流，並配合文檔化的授權與部署體系。若要查看簡介與安裝入口，見 SkillHub 目錄頁；若要閱讀完整 README、SETUP 與 docs/，見 GitHub：uuicdown/dsh-project-agent。
