前言¶

DeepSeek Harness (DSH) 提供了模型路由、沙箱和子代理註冊表等底層能力。在實際構建複雜工作流時，狀態管理混亂、審計困難、執行不可控是常見問題。dsh-humanize 是一個 agent 預設，它將“圍繞流構建”的紀律原生移植進 DSH 的 agent 環境。

該插件由 Guard42 維護，旨在通過階段圖、鎖機制、評審門禁和事件回放，把“Lean accepts it, or it does not”的驗證原則落地。

核心機制¶

以下是 dsh-humanize 提供的核心能力：

1. 多階段目標與裁判命令
   將多階段目標轉化爲顯式的流——階段圖。每個階段掛載裁判命令，只有當裁判命令的 exit code 爲 0 時，該階段纔算數。

2. 流鎖與防篡改
   通過語義規範化 + SHA-256 生成不可變鎖，格式爲 flk_<digest>。系統在加載時重驗鎖的哈希值，防止文件被篡改。

3. HMAC 評審門禁
   綁定 HMAC 簽名，將評審流程前置。approved、rejected、bypassed 爲不可變終態。若被拒絕，理由會折回草案供代理重新提交。

4. 事件回放恢復
   events.l（append-only）是唯一權威。中斷後，使用 flow_resume 從回放繼續，已完成的階段絕不重跑。

5. 執行留痕
   每次運行留痕，支持導出 Markdown 時間線，或導出可導入 ui.perfetto.dev 的 Chrome-JSON。

6. 哈希錨定編輯
   在進行字面替換前，先校驗整文件的 SHA-256 錨點。這杜絕了“憑記憶改錯文件”的可能性。

安裝¶

使用官方命令一鍵安裝：

dsh plugin --profile web add github:Guard42/dsh-humanize

安裝完成後重啓 DSH，在預設選擇器中選中 「Humanize 模式」 即可。

注意：本倉庫聲明瞭 dsh.bundle 清單並自帶安裝器橋。直接 dsh plugin add 一個只含預設文件的倉庫並不會激活它。

典型用法¶

假設需要將測試套件從 Jest 遷移到 Vitest，流程如下：

1. 代理起草：flow_draft 生成三個階段：遷移配置 → 全量替換 → 測試全綠門禁。
2. 結構校驗：flow_check 檢查結構，確保零錯誤。
3. 生成鎖：flow_lock 生成規範化 + SHA-256 鎖，獲得 flk_xxxxxxxx。
4. 生成評審：flow_review_prepare 生成 review.md 供你過目。
5. 決策與執行：你給出 approve，代理執行 flow_run，各階段子代理幹活，裁判命令把關。
6. 恢復：若運行中斷，可直接 flow_resume 從 events.l 回放繼續。

15 個模型工具¶

插件提供了 15 個模型工具，包括：

• flow_draft：寫入完整 FlowDraft
• flow_check：結構校驗，產出診斷
• flow_lock：生成不可變鎖
• flow_list：列出工作區全部 flows
• flow_show：渲染 flow 爲可讀圖
• flow_review_prepare：生成評審綁定與 review.md
• flow_review_decide：唯一決策工具（approved/rejected/bypassed）
• flow_run：調度就緒節點
• flow_status：重放單次運行狀態
• flow_resume：中斷後恢復
• flow_stop：取消運行
• trace_export：導出 trace（md / chrome-json / jsonl）
• edit_anchored：哈希錨定編輯
• hash_file：計算文件 SHA-256
• model_catalog：列出可用 provider 路由與模型

注意事項與設計紅線¶

1. 零 npm 依賴：實現只依賴 node: 內置模塊。
2. 無官方關係：這是獨立社區開源項目，與深度求索及 humanfia 團隊均無隸屬、合作、授權或背書關係。
3. 權限問題：若安裝或同步時報 ACCESS_DENIED，目標目錄多半在殺軟/HIPS 文件防護範圍內。
4. 定製化：支持通過請求向 humanize 模式中加入新的領域變體工具，並保存爲獨立預設。

結語¶

dsh-humanize 通過流鎖、評審門禁和事件回放機制，爲 DeepSeek Harness 的 agent 提供了嚴謹的執行紀律。如果你需要構建高可靠、可審計的工作流，該插件是一個值得嘗試的工具。

• GitHub 倉庫
• 社區目錄