DSH（DeepSeek Harness）採用插件化架構，社區開發者可以擴展 Web 界面。針對智能體開發中定義可複用工作流的需求，weibaohui/dsh-process 插件將「工藝」（Process，多階段·多環節的 agent 工作流模板）接入 dsh web。它提供瀏覽、編輯、校驗、導入導出、AI 生成以及可視化表單編輯等功能，並支持 agent 直接調用工具庫讀取工藝並按階段推進。
核心功能¶
雙庫瀏覽
支持兩種工藝庫：我的庫（默認 ~/.ntd/processes，可寫）和內置庫（默認 ~/.ntd/bundled/processes，只讀）。插件會遞歸掃描子目錄，側欄入口實時顯示「我的 | 內置」計數。根目錄配置可通過 dsh settings 服務修改。
詳情三視圖
工藝詳情頁提供三個視圖：
* 概覽：展示元信息、限額、異常觸發及診斷清單。
* 結構：以樹狀展示階段 → 環節，包含 prompt、執行器、專家、技能、門禁、流轉等全字段。
* YAML：帶行號和語法着色，支持點擊診斷信息跳行高亮。
編輯與校驗
* YAML 編輯器：支持行號、300ms 防抖校驗。錯誤阻止保存，警告僅黃標。支持 ⌘/Ctrl+S 保存。
* 樂觀鎖：若文件被外部修改，保存時會返回 409 衝突，提示「重新加載 / 仍然覆蓋」。
* 校驗規則：檢查語法錯誤、缺失 name、空 phases、環節 id 重複、無效的 on_gate_fail 或 goto: 引用等；警告未知鍵、未知專家/技能引用等。
可視化表單編輯
在「✎ 編輯」模式下，可在「表單」和「YAML」視圖間切換。表單包含基本信息、限額、階段、環節、門禁等全字段。修改表單字段會實時同步到 YAML；修改 YAML 也會實時反映到表單。支持級聯改名（環節 id 改動自動更新引用）、增刪階段/環節/門禁。
Agent 協作
插件爲 agent 提供四個工具：
* process_list：列出我的庫工藝。
* process_get：獲取工藝詳情。
* process_validate：校驗工藝。
* process_save：保存工藝。
系統 Prompt 會指導 agent 按工藝分階段推進，一環節一交付。
按工藝執行
面板頂部切換到「執行」可發起真實運行：
* 驅動：每個環節開啓一個全新的 dsh 會話執行指令。
* 門禁：獨立評審會話對照分數線打分，未通過可按配置返工或跳過。
* 看板：展示運行列表、階段分組、環節卡（嘗試次數、返工計數、Token 用量、實時輸出）。
* Token 統計：宿主按會話上報 usage，累加計算環節消耗。
* 產物收集：記錄文件寫操作（write/edit）的 diff 變更統計與文本，支持雙視圖查看。
安裝與啓用¶
使用官方插件命令安裝：
dsh plugin --profile web add @weibaohui/dsh-process
安裝完成後，重啓 dsh web 並刷新頁面。側欄「新會話」下方會出現「工藝」入口。插件默認讀寫 ~/.ntd 下的工藝目錄，無需額外配置。
典型用法¶
- 瀏覽：點擊側欄「工藝」打開全屏工藝庫，左列選擇工藝，右側在概覽、結構、YAML 三個 Tab 間切換查看。
- 編輯：點擊「✎ 編輯」，可使用 YAML 編輯器邊寫邊校驗，或切換到表單模式進行可視化編輯。內置庫條目顯示「⧉ 複製到我的庫」。
- 管理：使用「+ 新建 ▾」創建空白工藝（帶註釋骨架）或從內置庫複製；使用「⬆ 導入」拖拽多文件，或「⬇ 導出」下載單文件或全庫 ZIP。
- AI 生成：在工藝詳情頁點擊「⚡ AI 生成」，輸入需求與複雜度，AI 產出 YAML 後校驗、預覽並寫入我的庫。
- 執行：在任意會話中，讓 agent 執行任務，例如
按工藝 lightweight-task 執行這個需求或用 process_save 把這套流程存成工藝。
數據與安全¶
- 數據源：工藝文件即數據源，無獨立數據庫。所有寫操作僅限我的庫，內置庫一律 403。
- 路徑白名單：拒絕
..、絕對路徑及點目錄，確保文件操作安全。 - 樂觀鎖與衝突：外部編輯器修改文件會導致 409 錯誤，需手動選擇重新加載或覆蓋。
- 執行隔離：執行時每個環節開啓全新 dsh 會話，保證執行環境獨立。
適用場景¶
適合需要在 DSH Web 中定義、複用和運行復雜 agent 工作流的開發者。它將 YAML 配置與可視化操作結合，並通過工具接口讓 agent 自主調用工藝，降低工作流管理成本。
