前言¶
在 DSH 裏推進項目時，門禁結論、里程碑、任務交接和人員分工往往分散在 project.json 和對話記錄裏。想一眼看清「當前過到哪道門、誰派給誰、證據在哪」，通常要在文件樹和聊天裏來回翻。下面介紹社區插件 dsh-workflow-panel（維護者 tucaogege，分類爲客戶端）：在 DSH 界面右下角提供一塊只讀面板，把項目組織、任務流、工序與驗收結果集中展示，不寫賬本、不改狀態。
這是什麼¶
dsh-workflow-panel 是 DeepSeek Harness 的客戶端 bundle 插件（當前 package 版本 0.1.1，MIT 許可）。官方簡介：DSH workflow panel — read-only project board for DeepSeek Harness（gates, milestones, task flow, roster）。
它解決的是「可視化讀項目快照」：數據全部來自你的 project.json，面板只做 GET 與展示，不派單、不審議、不寫 state.json 或項目文件。
核心功能¶
裝好後，從右下角「工作流面板」膠囊點開，可在一頁裏看到六段內容：
- 概覽——項目名、預算、數據更新時間，以及任務數、完成率、過門率、人數等六格關鍵指標。
- 門禁六卡——G0 到 G5，每道門顯示當前結論、應產出、已有證據；點證據可在面板內看原文。
- 里程碑——橫向時間線，按日期排列；缺日期會明確標出。
- 組織模板——當前編制：成員、角色、模型、任務狀態、職責。
- 任務流——派單與交接關係；連線按發送方上色，懸停可見任務對應關係。
- 人員卡——評分、模型、職責，以及逐條任務與完成依據。
交互上：面板默認收起爲右下角膠囊；標題欄可拖動，右下角可拉伸；Esc 或「收起」關閉；膠囊可拖到屏幕任意位置。
v0.1.x 已知限制（資料原文）：派生層固定顯示「派生 0（v1 無數據源）」；面板與膠囊位置重啓後不持久化；跨行連線爲行級錨點；任務與門禁結論需自行維護在 project.json，面板不負責錄入。
安裝與啓用¶
前提：DSH 桌面版（帶 profile / bundles），Node.js ≥ 20。
裝之前建議備份 profile 的 package.json 與 cordis.patch.yml：DSH 異常退出後可能收窄 bundles 列表。
- 打開 DSH profile 目錄下的
package.json，在dependencies與dsh.profile.bundles中加入插件（保留原有 bundles）：
{
"dependencies": {
"dsh-workflow-panel": "github:tucaogege/dsh-workflow-panel"
},
"dsh": {
"profile": {
"bundles": [
"<原有的 bundles 保持不動>",
"dsh-workflow-panel"
]
}
}
}
-
重啓 DSH。宿主會按
dependencies安裝（首次需聯網拉取倉庫）。若未自動安裝，在 profile 目錄執行pnpm install後再重啓。 -
右下角出現「工作流面板」膠囊即表示安裝成功。
卸載時：從 dependencies 與 bundles 中移除 dsh-workflow-panel，清理 node_modules 中對應鏈接，重啓 DSH。插件不寫文件，無殘留數據需清理。
配置（可選）¶
默認自動發現項目文件：在 $DSH_HOME/bot/workspace/*/project.json 中取最近更新的一份。只跟蹤一個項目時通常無需配置。
項目文件不在上述路徑，或需固定某一項目時，在 profile 配置中指定：
{
"dsh-workflow-panel": {
"projectPath": "<你的項目目錄>/project.json"
}
}
環境變量 DWP_PROJECT_PATH 可覆蓋配置，優先級爲：環境變量 > 配置 > 自動發現。
0.1.1 之前的版本沒有自動發現，默認讀插件同級的 project.json；若顯示「項目文件不存在」，顯式配置 projectPath 即可。
典型用法與只讀邊界¶
日常用法：在 DSH 中正常維護 project.json 與對話派活；需要覈對門禁、里程碑或任務流時，打開工作流面板只讀查看。證據文檔通過面板內鏈接以 GET 拉取原文，不涉及寫操作。
面板僅發 GET（數據快照與證據文檔兩條接口），不寫任何文件。結論若顯示「未評級 / 未提供」，表示 project.json 中未記賬，而非渲染錯誤。
適用場景與注意¶
適合：已在 DSH 桌面版用 profile/bundles 管理項目、希望在一屏內只讀瀏覽門禁、里程碑、組織與任務流的用戶。
注意：
- 插件以當前 DSH 進程權限運行；安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證。
- 已在當前 DSH 桌面版驗證；更早版本與非桌面形態未驗證（README 說明）。
- 面板數據格式與
project.jsonschema 綁定，格式變更見倉庫 CHANGELOG。
DSH 生態理念是「一切皆插件」；社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-workflow-panel 把項目快照做成右下角可拖動的只讀看板：六段視圖對應概覽、門禁、里程碑、組織、任務流與人員，安裝依賴 profile 的 package.json 與 bundle 聲明即可。要進一步瞭解安裝細節與限制，見 GitHub README 與 SkillHub 目錄頁。
