在 DeepSeek Harness (DSH) 的 Agent 循環中，通常依賴大模型自身的判斷，這種方式在面對高置信度的危險操作或低質量產出時，缺乏結構化的攔截與修正手段。dsh-decision-layer 插件旨在爲此提供解決方案，它通過一個結構化的決策層，將判斷標準明確的問題交給同協議的裁決後端（如 dev / laya），並在 Agent loop 上接入危險門控、產出自檢、工具收窄和防循環等自動介入機制。
dsh-decision-layer 是一個爲 DeepSeek Harness Agent 循環提供結構化決策層的插件。由 xbzbing 維護，採用 MIT 許可證。它將有明確判斷標準的問題交給裁決後端，並在 Agent loop 上接入危險門控、產出自檢、工具收窄和防循環等自動介入機制。
核心功能¶
插件提供了一套完整的決策機制，主要包括以下功能：
- 手動裁決：使用
decision_evaluate工具提交noul、score、choice問題，或使用decision_check_connection做連通測試。手動調用不計入自動裁決指標。 - 可配置後端：支持覆蓋 URL、Key、model，默認使用
https://api.typesafe.ai、jev-latest。未配置 Key 時不發送請求。 - 危險門控：破壞性工具調用執行前用脫敏摘要請後端裁決。僅當模型高置信判定「拒絕」時才攔截；低置信或後端故障一律不阻斷。
- 產出自檢：回合結束用評分量表給最終產出打分（0–2）。默認只提示，可開啓「低分補完」。
- 任務完成核對：當用戶列出多個交付條件時，逐項判定「已滿足 / 未滿足 / 證據不足」。
- 產出質量趨勢告警：連續多次高置信低分時，觸發視覺提示，建議調整 prompt 或更換模型。
- 工具收窄：回合開始時判斷可選工具與本輪任務的相關性，摘掉用不上的（相關性概率低於摘除閾值）。不擴權，僅刪除工具。
- 防循環：始終生效，攔截同一調用連續重複超過閾值的死循環。
- 會話面板：輸入框下方的 dock 觸發器彈出面板，展示自動裁決指標和決策日誌。
- 決策分析頁：基於已落盤日誌做只讀聚合，展示過程畫像，支持對每條決策標註「判對 / 判錯 / 說不準」。
- 決策點開關：詳情頁配置裏，各決策點有獨立開關，默認全開。
- 決策日誌落盤：決策記錄按會話全量落盤到
~/.config/dsh-decision-layer/logs，保留 30 天。 - 會話指標持久化：重啓後按會話 id 保存快照到
~/.config/dsh-decision-layer/state，優先從快照恢復。
安裝與啓用¶
插件已發佈到 npm 與 GitHub。安裝或更新後需重啓 dsh web 服務。
從 npm 安裝：
dsh plugin --profile web add dsh-decision-layer@latest
從 GitHub 安裝：
dsh plugin --profile web add github:xbzbing/dsh-decision-layer
典型用法¶
- 手動裁決：在工具調用中使用
decision_evaluate提交問題。 - 連通測試：使用
decision_check_connection測試後端連通性。 - 配置後端：在配置中覆蓋 URL、Key、model，支持 dev/laya。
- 本地部署：使用 ollama + tev1 配合插件，實現裁決不出本機、無數據外發。
- 源碼構建：先運行
npm ci --ignore-scripts && npm run build:client，再使用file:安裝。
安全邊界¶
自動介入只減不增。危險門控僅攔截高置信拒絕，後端失敗或低置信不介入。發送摘要只含工具名、命令/路徑並對密鑰脫敏，不含文件內容。
開發¶
源碼部署需先構建 client。0.6.4 爲體驗版，功能已可用，但介入能力與閾值仍在探索中。
該插件爲 DSH 開發者提供了一套結構化的決策機制，適合需要精細化控制 Agent 行爲的場景。更多細節請訪問 GitHub。
