前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在處理複雜任務或高權限操作時，單純依賴模型自身的自我修正往往不夠穩健。dsh-audit-mode 是 DeepSeek Harness 的第五種模式，預設 ID 爲 audit。它引入了獨立、持久化的 Codex 審計機制，並將代碼審查與人工審批的補救流程結合在一起，作爲 DSH 的安全網。
核心功能¶
該插件爲 DSH 增加了一個獨立運行的審計角色，具備以下能力：
* 獨立持久化審計：審計狀態獨立於主會話，記錄在側車文件中。
* 人工確認的補救循環：對於關鍵或警告級別的審計結果，需要用戶批准後才能執行補救。
* 多後端支持：支持配置 Codex、Claude Code 或 DSH 自身的 LLM 運行時作爲審查者。
* 安全暫停：在發生連續失敗或嚴重錯誤時，會自動暫停會話。
* 雙端控制：提供 TUI 和 Web 兩種控制界面，用於查看審計狀態和執行補救。
安裝與啓用¶
安裝過程通過 pnpm 在當前 DSH 配置文件目錄下執行。
- 進入 web 配置目錄（TUI 目錄同樣適用此模式）：
cd ~/.dsh/profiles/web
- 安裝插件包：
pnpm add dsh-audit-mode@github:yhfgyyf/dsh-audit-mode
（推薦同時安裝 `dsh-progressive-tools` 以獲得更好的工具發現支持）
- 修改
package.json，在dsh.profile.bundles中添加該插件：
{
"dsh": {
"profile": {
"bundles": [
"dsh-audit-mode"
]
}
}
}
- 重啓 DSH 配置文件以加載插件。
配置審查者¶
默認情況下，插件使用 Codex 作爲審查者。如果需要更改審查後端或模型配置，需編輯 cordis.patch.yml。
默認配置¶
- id: audit-bundle
config:
reviewer: codex
binary: codex
args: [app-server, --stdio]
models:
summarizer: { model: gpt-5.6-luna, effort: medium }
auditor: { model: gpt-5.6-sol, effort: max }
使用 Claude Code¶
- id: audit-bundle
config:
reviewer: claude-code
claudeBinary: claude
claudeArgs: []
models:
summarizer: { model: haiku, effort: medium }
auditor: { model: opus, effort: max }
使用 DSH LLM 運行時¶
- id: audit-bundle
config:
reviewer: dsh
dshProvider: deepseek-official
models:
summarizer: { model: deepseek-v4-flash, effort: off }
auditor: { model: deepseek-v4-flash, effort: high }
常用命令¶
在 audit 預設模式下，可以使用以下命令控制審計流程：
* /audit status：查看當前輪次、頻率間隔、最後一次裁決和暫停狀態。
* /audit now：強制立即執行一次審計（不受常規頻率限制）。
* /audit history：從側車文件中讀取最近的審計歷史記錄。
* /audit accept [audit-id]：批准最新的或指定 ID 的補救方案。批准後，模型將加載相應的技能並執行修復。
* /audit resume：從非關鍵審查失敗或手動暫停中恢復會話。
行爲與狀態¶
- 頻率控制：首次審計至少需要兩步且間隔 60 秒；隨後的審計每 3 步或 3 分鐘執行一次，最小間隔仍爲 60 秒。異常情況會在下一個安全邊界觸發審計。
- 警告 vs 關鍵：警告不會暫停主 Agent，用戶可以執行或編輯修復方案；關鍵警告會暫停主 Agent 和當前 Goal，批准後立即開始修復，並臨時暴露 Codis 工具。
- 失敗處理：如果審查者連續三次失敗（不可達、超時或格式錯誤），會話將因
failures原因暫停。 - 最終審計：當會話結束或通過 Remote API 發起
final: true的審計時，會進行一次全量對齊審計（包含目標、邊界規則和最近摘要）。
前端與終端控制¶
- Web 界面：插件在 Web 側註冊了 Remote API 和 Dock 組件。審計條帶顯示在
conversation.input.dock（順序 5），位於 Todo 和 Goal 之間。可通過 API/api/audit/snapshot和/api/audit/watch(SSE) 獲取快照和實時更新。 - 終端界面 (TUI)：
dsh-tui-app會渲染一個獨立的狀態塊。a：直接執行提議的補救方案。e：將補救方案載入編輯器，回車執行，Esc 取消。c：在暫停狀態下複製反饋內容。r：恢復非關鍵審查暫停。Esc/Ctrl+C：停止當前工作。
注意事項¶
- 版本要求：該插件目前支持 DSH 0.1.3-alpha.2 版本。
- 權限與安全：插件以當前 DSH 進程的權限運行。安裝前請檢查源碼。
- 數據持久化：審計狀態以 JSON 格式寫入側車文件 (
${DSH_HOME:-~/.dsh}/audit/sidecars/<sessionId>.json)。
總結¶
dsh-audit-mode 爲 DeepSeek Harness 提供了一個結構化的安全審查層。通過配置 Codex 或其他 LLM 作爲審計員，並配合人工審批流程，可以在保持 Agent 自主性的同時，顯著降低代碼生成和工具調用的風險。
- 目錄頁: yhfgyyf/dsh-guardian-mode
- GitHub: yhfgyyf/dsh-audit-mode
