前言¶
DeepSeek Harness (DSH) 在本地運行模型時，模型容易忽略上下文或重複犯已知錯誤。dsh-lessons 插件通過記錄這些“犯蠢”時刻，將其沉澱爲教訓清單，並在後續對話中自動注入系統提示詞，從而讓模型不再重複犯同樣的錯。
它是什麼¶
這是一個爲 DeepSeek Harness (DSH) 設計的插件。它的核心邏輯是：記錄犯過的錯 → 沉澱成清單 → 下次開口前先看一眼。插件開源，許可證爲 MIT。
核心功能¶
插件具備以下能力：
- 自動識別：對 AI 表達不滿（如“你又搞錯了”、“不對”、“答非所問”），自動識別並記錄。
- 手動補錄：通過輸入指令直接錄入教訓。
- 工具報錯留檔：可選功能，記錄工具執行失敗的場景（默認關閉以減少噪聲）。
- 動態注入：通過
systemPrompt.section()註冊實時求值的提示詞，記錄後立即生效，無需重啓 DSH。 - 會話級開關：每個對話可獨立決定是否啓用教訓注入，或在對話內使用指令開啓/關閉。
- 可視化面板：DSH 右側欄的“AI 教訓”標籤頁，用於查看、管理、補錄及預覽注入內容。
安裝¶
克隆倉庫並運行安裝腳本：
git clone https://github.com/dusktin71-lang/dsh-lessons.git
cd dsh-lessons
node install.mjs
安裝完成後，建議運行校驗命令確認狀態：
node verify-install.mjs
使用方法¶
自動識別¶
當用戶對 AI 發出短促的負面反饋（120 字以內且命中明確負面詞語）時，插件會自動入庫。誤判的記錄可在面板中刪除。
手動記錄與開關¶
- 手動補錄：輸入
記一下：<內容>、記住：<內容>或/lesson <內容>。 - 開啓/關閉注入：在對話中輸入
/lessons on或/lessons off。
面板使用¶
DSH 右側欄 →「AI 教訓」：
* 頂部開關：控制總開關、自動識別、工具報錯記錄以及當前對話是否生效。
* 教訓列表：支持補錄、逐條停用或刪除。
* 注入預覽：查看模型實際會讀到的文本內容。
* 更多設置：調整注入條數上限、單條字符上限、新對話默認設置等。
配置與數據¶
- 數據存儲：
~/.dsh/ai-lessons/state.json。 - 自檢日誌：
~/.dsh/ai-lessons/boot.log（每次啓動追加一行，用於排查加載問題）。 - 瀏覽器端依賴：要顯示右側欄面板，必須在
package.json的dsh.client.inject中聲明@deepseek-ai/dsh-client-ui-sidebar-right。若聲明缺失，插件不會報錯，但面板將不出現。
排查¶
若右側欄未出現「AI 教訓」標籤頁，請檢查以下幾點：
- 依賴檢查：確認
dsh.client.inject數組中包含@deepseek-ai/dsh-client-ui-sidebar-right。缺少此依賴會導致服務缺失，回調永不執行。 - 手動展開：註冊成功不代表面板自動展開。需在會話標題欄最右端（摺疊圖標鏡像）手動點擊展開右側欄。
- 查看日誌：檢查
~/.dsh/ai-lessons/boot.log，重點關注client-report事件中的event字段，確認client/apply和client/tab-registered是否出現。
結語¶
dsh-lessons 適合需要在本地環境中通過持續反饋來提升模型表現的開發者。它將零散的糾正轉化爲結構化的約束，是構建健壯本地智能體的實用工具。
