前言¶
在 DeepSeek Harness (DSH) 的開發中，智能體遇到錯誤後往往無法複用之前的診斷結果，導致重複推理和 Token 浪費。dsh-errkb 插件旨在解決這個問題，它將模型遇到的錯誤轉化爲編號、可編輯的知識庫，並在錯誤重複出現時，將記錄好的修復方案注入上下文，讓模型直接使用已知解。
插件定位¶
- 核心價值：Recycles errors（回收錯誤）。同一個失敗只需診斷一次，記錄下來，下次再出現時直接作爲已知修復方案返回。
- 維護者：jingchangzhao-gif
- 分類：記憶
當前狀態¶
插件目前處於 P5 階段完成狀態。
* 已完成：設計文檔完成，核心邏輯已實現（T01-T15）。包括知識庫目錄解析、錯誤指紋識別、強制脫敏、錯誤存儲、捕獲層鉤子、注入層鉤子以及五個代理工具。
* 待完成：LLM 請求失敗捕獲（T16）、自動安裝到配置文件的功能（T17）、以及發佈到 npm（T18）。
核心功能¶
- 錯誤回收與記錄：將工具失敗、非零命令退出和輪次級錯誤記錄到
ERRORS.md。 - 自動注入：檢測到重複錯誤時，在模型重新診斷前注入已記錄的修復方案。
- 強制脫敏：對敏感信息進行脫敏處理，確保隱私安全。
- 工具集：提供
err_lookup（查找）、err_record（記錄）、err_list（列表）、err_forget（遺忘）和err_stats（統計）五個工具。
使用方法¶
-
前置依賴：
- Node.js 版本需 >= 22.13
- pnpm 版本需 11.7.0
-
加載插件：
由於未提供自動安裝命令，需要手動將插件添加到 DeepSeek Harness 的配置文件中。插件加載後，會自動記錄錯誤到ERRORS.md。 -
工具交互：
- 自動流程：插件加載後，會監控工具失敗和命令退出碼。當錯誤重複出現時，系統會自動注入修復方案。
- 手動記錄：如果錯誤未被自動記錄或需要手動補充，可使用
err_record工具。 - 查詢與管理：使用
err_lookup查找特定錯誤，使用err_list查看所有錯誤，使用err_forget刪除記錄，使用err_stats查看統計信息。
知識庫格式¶
錯誤信息以 Markdown 格式存儲在 ERRORS.md 文件中。每次寫入時都會應用強制脫敏規則。
注意事項¶
- 權限：插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
- 侷限性：目前不支持自動捕獲 LLM 請求失敗，且需要手動配置文件添加。
- 隱私：支持強制脫敏，所有敏感信息在存儲前會被處理。
總結¶
dsh-errkb 爲 DSH 開發者提供了一個將錯誤轉化爲資產的基礎設施。通過建立編號化的錯誤知識庫，它減少了重複推理的成本。儘管目前還需要手動配置，但其核心的捕獲與注入機制已具備實際使用價值。
