前言¶
在 DeepSeek Harness（DSH）裏做複雜開發時，常見做法是單會話裏反覆改 prompt、手工拆任務，或自己記進度。任務一多，誰負責哪塊、當前處在「開發還是審計」、併發有沒有打滿，都不直觀。DevFlow（@xiaoxie-ide/dsh-devflow）是維護者 BinXie-lixiangdehua 發佈的工作流類插件，把一次 dsh 會話組織成帶可見控制面的多智能體編排：角色分工、狀態機、調度工具與右側面板一起落地，狀態落在工作區 .devflow 目錄。
這是什麼¶
DevFlow 是面向 DeepSeek Harness 的多智能體工作流編排插件，當前 README 標註版本爲 1.5.1（2026-10-11）。倉庫：BinXie-lixiangdehua/dsh-devflow；社區目錄頁：SkillHub 插件頁。許可證爲 MIT。
核心功能¶
下面介紹 README 中明確寫出的能力，不展開未在資料中出現的用法。
角色與編制¶
- 總指揮（Commander）：規劃與派發。
- 固定員工：架構（architect）、後端（backend）、前端（frontend）、代碼審計（code-auditor）等固定角色。
- 臨時子智能體：按任務創建，用完即走。
狀態機與持久化¶
流程階段爲：派發（dispatch）→ 執行（execution）→ 審計（audit）→ 返工（rework）→ 驗收（acceptance）。每一步對應持久化的業務實體，目錄在工作區 <workspace>/.devflow，並配有隻追加的 journal。
調度平面（devflow_* 工具）¶
提供 devflow_* 系列工具（task / scope / assignment / dispatch / transition / roster 等）。併發上限爲 5，超出則排隊；每次 hand-off 有調度診斷信息。
可視化面板¶
掛載在 dsh 右側邊欄：畫布上每條邊表示一次派發；編制條顯示 fixed / temporary 與實時 concurrency N/5；節點可點開 inspector 查看詳情。
環境要求¶
| 項 | 要求 |
|---|---|
| Node | ^22.19.0 或 >=24 |
| pnpm | 任意較新版本 |
| dsh | 已安裝且可編輯 profile（如 ~/.dsh/profiles/web）；目標範圍 >=0.1.7-rc.1 <0.3.0（不再支持 dsh 0.1.5） |
| OS | Windows 爲 README 寫明已測平臺；預設會在 win32 用 tool-pwsh、其它平臺用 tool-bash |
安裝與啓用¶
官方推薦 一條 PowerShell 命令（資料原文；會先 clone 再執行安裝腳本）：
git clone https://github.com/BinXie-lixiangdehua/dsh-devflow.git "$env:USERPROFILE\.dsh\local-plugins\dsh-devflow"; & "$env:USERPROFILE\.dsh\local-plugins\dsh-devflow\install.cmd"
若目錄已存在，可在插件目錄單獨運行 install.cmd（內部調用 install.ps1）。
常用參數示例：
# 僅預覽將修改的文件，不寫盤
.\install.ps1 -DryRun
# 指定 dsh 目錄與 profile，或跳過 preset 步驟
.\install.ps1 -DshHome 'C:\Users\me\.dsh' -Profile 'web'
.\install.ps1 -SkipPreset
# 安裝指定 tag/branch
.\install.ps1 -Ref 'v1.5.1'
安裝腳本會改動的五件事（README 摘要）：把插件放到 ~/.dsh/local-plugins/dsh-devflow（默認）；在插件目錄內 pnpm install（避免 profile 只 link 卻缺 @deepseek-ai/* peer）；在 profile 的 package.json 註冊 @xiaoxie-ide/dsh-devflow 的 link: 依賴與 dsh.profile.bundles；在 profile 內再 pnpm install；按檢測到的 dsh 代際部署 agent preset（0.1.5 與 0.1.7+ 路徑不同）。被覆蓋文件會備份爲帶時間戳的 .bak-devflow-*。
經過上面的步驟，重啓 dsh，新建或打開會話，在 preset 中選擇 DevFlow 即完成啓用。
典型用法（來自官方說明）¶
資料未給出「一句話對話示例」，但啓用 preset 後的工作方式可歸納爲：
- 在 DevFlow preset 下發起需求，由 Commander 規劃並派發。
- 通過
devflow_*工具推進 task、scope、assignment、dispatch、transition、roster；併發超過 5 時自動排隊。 - 在右側 DevFlow 面板查看派發邊、編制與併發佔用，必要時對節點做 inspector 查看。
- 在項目工作區查看
<workspace>/.devflow下的狀態與 journal，用於追溯審計與返工環節。
若需從源碼改 src/ 再發布，倉庫約定順序爲：pnpm typecheck → pnpm build → pnpm check → pnpm test；改完 lib/ 後需 bump preset 裏 ?rev= 或重啓 dsh 以加載新模塊（README 說明）。
卸載（簡要）¶
- 刪除
~/.dsh/.agent-presets/devflow/。 - 從 profile 的
package.json去掉依賴與 bundle 項，或恢復package.json.bak-devflow-<timestamp>。 - 在 profile 目錄再執行
pnpm install，然後刪除插件文件夾。
.devflow 在項目工作區內，需自行清理。
適用場景與注意¶
適合誰：已在 DSH 上做多步驟交付、希望固定角色 + 狀態機 + 可視化調度，而不是純聊天式拆任務的開發者。
權限與安全：插件隨當前 dsh 進程權限運行；安裝前請自行審閱 GitHub 源碼 與 MIT 許可證，勿在未檢查的情況下在生產環境盲目啓用。
生態說明：DSH 社區插件目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；本文事實以倉庫 README 與 package 元數據爲準。
結尾¶
DevFlow 把 dsh 會話變成帶 Commander、固定員工與臨時子智能體的小交付組織，並用 .devflow 持久化狀態機、用 devflow_* 工具與右側面板提供可觀測的調度面。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
