前言¶
DeepSeek Harness (DSH) 通過插件擴展功能。在長會話場景下，模型可能會出現思考打轉、回答復讀，或者上下文質量明顯下降。當需要將任務切換到新會話時，除了關注 token 消耗，更需要關注內容的退化程度。dsh-attention-health 插件從本地會話日誌中檢測退化信號，並在必要時建議交接，生成不依賴模型調用的交接文檔。
這是什麼¶
這是一個運行在 DSH 上的插件，主要解決長會話中的退化檢測與任務交接問題。它不調用外部模型，完全基於本地日誌進行規則判斷。
核心功能分爲三點：
1. 實時思考守衛：在生成過程中檢測思考內容的復讀或空轉，命中時立即中止當前生成。
2. 會話健康自檢：從日誌推斷會話的退化風險，給出健康評分和上下文佔用情況。
3. 交接文檔生成：機械生成交接用的 Markdown 文檔，不使用模型總結，確保交接材料在模型不可靠時依然可靠。
安裝與啓用¶
安裝插件需要使用 DSH 的 profile 參數。請確保 Node 版本滿足要求（>= 22.19）。
dsh plugin --profile web add -w dsh-attention-health
注意事項：
* 命令中的 -w 參數不可省略，否則會報錯。
* 安裝完成後必須重啓 DSH，插件行不會熱加載。
* 如果 profile 的 pnpm 主版本與插件不一致，可能會報錯。
典型用法¶
安裝完成後，可以通過命令行工具對本地會話進行操作。
查看當前會話的健康狀態：
node handoff.mjs --health
查看指定會話的健康狀態（支持 ID 前綴）：
node handoff.mjs d346d3e8 --health
生成交接文檔到文件：
node handoff.mjs -o HANDOFF.md
列出所有會話：
node handoff.mjs --list
生成交接文檔並附帶統計信息：
node handoff.mjs --stats -o HANDOFF.md
核心功能說明¶
1. 實時思考守衛¶
這是插件唯一會主動干預的能力。它會在生成過程中逐幀檢測思考內容的復讀或空轉。一旦檢測到疑似退化信號，守衛會立即中止本輪生成，不會提示“僅警告”或“關閉守衛”。這意味着如果誤判了正常推理，用戶無法通過設置關閉守衛，只能修改配置或卸載插件。
2. 會話健康自檢¶
插件讀取本地會話日誌，計算上下文規模和有效佔用。它會輸出健康評分（例如 50 / 100），並指出思考異常（如打轉、重複）的具體次數和現象。該功能完全離線運行，不聯網也不額外調用模型。
3. 交接文檔生成¶
這是插件的核心價值所在。它不調用模型來生成文檔，而是從會話日誌中機械提取結構化信息。生成的文檔包含會話標識、當前目標、用戶請求主線、各輪進度、涉及的文件、待辦事項以及遇到的錯誤等章節。
注意事項與邊界¶
- 誤判處理：由於守衛命中即中止且無降級開關，如果發生誤判（例如正常推理被判定爲空轉），只能通過修改配置或卸載插件來修正。
- 離線運行：插件只讀本地會話日誌，不聯網，不額外發起模型請求。
- 生效時機：修改配置或安裝後，必須重啓 DSH 才能生效。
- 環境要求：僅支持 Node.js 版本 >= 22.19。
總結¶
dsh-attention-health 提供了一套本地化的解決方案，用於監控 DSH 長會話的質量退化。它通過立即中止退化生成和提供零模型的交接材料，幫助開發者在模型不可靠時安全地切換上下文。更多細節與源碼可參考 GitHub 倉庫。
