前言¶
DeepSeek Harness 在處理長上下文時會對模型輸出進行壓縮。這種壓縮會靜默丟棄項目的約定、計劃、技術棧決策和當前工作狀態，導致模型在後續操作中偏離初衷。針對這個問題，一種經過驗證的方案是將這些長期記憶外化到維護文檔中，並強制模型在每次操作前讀取這些文件，以從文件中重新“脫水”記憶，而不是依賴有損的壓縮摘要。
插件介紹¶
dsh-maintainer-doc-guard 是一個 DeepSeek Harness bundle，由 huxin7735-collab 維護。它將長期項目記憶保存在上下文窗口之外，並確保長輪次的回答能夠對用戶的實際請求負責。該插件通過一套機制，在每次操作前強制模型校準上下文，防止因記憶丟失導致的執行漂移。
核心功能¶
該插件包含五個主要功能模塊，以及一個用於文檔管理的側邊欄標籤頁。
-
維護文檔提醒
插件註冊了一個系統提示詞部分 (maintainer-doc-guard)。該部分列出工作區中的維護文檔（plan.md, conventions.md, stack.md, state.md, maintainer/README.md），並指示模型在每次操作或思考輪次前閱讀相關文檔。
相比於在每一步前插入消息，使用系統提示詞部分可以避免消息在會話日誌中累積，確保指令在每次提示詞組裝時重新評估。 -
先例門
插件實現了一個tools/pre-execute防守機制。當模型嘗試編輯受保護的基礎設施區域（如插件、預設、技能）時，該機制會阻止操作，除非會話中已經讀取過至少一個具有相同基本名稱的先例文件。
這是爲了防止模型僅憑記憶編寫基礎設施代碼，從而引入 invented APIs。當操作被阻止時，模型會看到具體的候選文件列表，例如：
Blocked by maintainer-doc-guard: you are about to write "<target>", which lives
in a guarded infrastructure area, but this session has not read any working
"index.js" precedent that shows the real contract.
“相同基本名稱”在這裏作爲“該類文件的工作類比”的代理，而非證明。
-
意圖門
插件實現了第二個tools/pre-execute防守機制。先例門負責控制“如何”編寫，而意圖門負責控制“是否值得”編寫。如果一個步驟沒有說明其目的，且該步驟包含副作用（如寫入文件），意圖門會在第一次遇到此類調用時進行拒絕。這迫使模型在執行前明確陳述意圖，如果無法陳述，則應停止並詢問，而不是盲目執行。 -
目標錨點
插件在系統提示詞中添加了一個目標錨點部分。該部分會逐字引用用戶的最新指令，並附帶明確的優先級規則：- 用戶的最新指令（目標錨點內容）
- 模型在上一輪中陳述的計劃
- 模型自行發現的線索或分支任務
這確保了在長輪次中，模型不會因爲自行推導的分支任務而偏離用戶的原始請求。
-
催促階段
插件在阻斷操作前增加了一個更正階段。它會在模型執行被拒絕的第一次操作時注入一個提醒，而不是直接阻斷；在長輪次中觸發一次提醒；只有當違規行爲重複發生時纔會進行阻斷。這種設計允許模型在糾正前有機會調整其行爲。
配置項¶
插件在 Harness 設置頁面提供了若干配置項，用於調整其行爲：
docsDir：用於覆蓋默認的文檔目錄.dsh-maintainer-doc-guard/。gate.maxDeniesPerTarget：限制針對同一個目標文件的重複拒絕次數，防止死鎖。anchor.order：調整目標錨點在系統提示詞組裝中的位置。anchor.inSubagents：控制是否在委託的子代理中也啓用目標錨點。
注意事項¶
- 環境要求：插件需要 Node.js 版本 20 或更高。
- 內存讀取：插件對維護文檔的讀取是內存中的，基於會話身份進行索引，不會持久化保存。
- 子代理行爲：默認情況下，子代理不會接收目標錨點。這是爲了保持正確性，因爲子代理是由委託消息啓動的，而非由用戶直接輸入，渲染用戶最新指令會顛倒優先級規則。如需啓用，需設置
anchor.inSubagents: true。 - 許可證：當前未找到該插件的許可證信息。
結語¶
dsh-maintainer-doc-guard 通過強制模型在每次操作前校準維護文檔、引用用戶最新指令以及引入意圖和先例守衛，解決了長上下文壓縮導致的記憶丟失和意圖漂移問題。對於需要長期維護和複雜迭代的 DeepSeek Harness 工作流，該插件提供了必要的結構化約束。
