前言¶
DeepSeek Harness (DSH) 開發中,上下文幻覺通常源於“歷史污染”:過期的結論、無關片段或被誤當作事實的舊對話混入當前推理。attention-scheduler 插件提供一套可複用的注意力、上下文與記憶使用規範,作爲 DSH 技能分發。它通過顯式規則管理“該不該檢索、召回多少、保留什麼、丟棄什麼、寫回什麼”,讓模型在記憶管理上有一致、可審計的行爲依據。本插件適用於會話較長、歷史擠佔上下文或團隊希望統一檢索/記憶使用紀律的場景。
核心功能¶
插件包含以下主要模塊:
- 檢索四級觸發:定義強制/禁止/強/弱/抑制的觸發規則,包含衝突優先級。
- 跨會話檢索約束:通過會話標籤、隱私會話限制查詢範圍及項目命名空間。
- 注意力預算:設定保留輪次、保留優先級、壓縮摘要六要素、固定開銷公式及壓縮觸發閾值。
- L0/L1 成本歸屬:區分骨架常駐(計入固定開銷)與動態召回(計入注入預算),明確成本歸屬。
- 記憶注入:管理召回條數與注入條數,設定注入預算(工作記憶 20%–25%)及超限淘汰規則。
- 衝突與寫回:定義衝突優先級、寫回白名單/黑名單,以及寫回格式與版本鏈。
- 實測腳本:提供
scripts/measure-overhead.cjs用於從會話日誌中分離固定開銷、L0 骨架與 L1 動態召回三類成本。 - 配置落點表:
references/config-map.md明確哪些條款需配置強制,以及“注入形態對照表”。
安裝與啓用¶
本插件同時提供標準 DSH 插件與文件技能兩種形態。
作爲插件安裝(推薦)¶
使用 DSH 的插件管理命令安裝,裝完後需重啓 profile 才能生效。
dsh plugin --profile web add github:Kfytm/attention-scheduler
本地開發時,可使用 link 方式修改後立即生效:
dsh plugin --profile web add link:D:\path\to\attention-scheduler
插件 rank 設爲 250,低於本地文件技能(400)與官方內置技能(600),因此用戶本地同名技能會覆蓋此插件。
卸載命令:
dsh plugin --profile web remove dsh-attention-scheduler
作爲文件技能安裝¶
克隆倉庫後運行安裝腳本。
Windows:
powershell -ExecutionPolicy Bypass -File scripts\install.ps1
macOS / Linux:
bash scripts/install.sh
安裝位置默認爲 ~/.dsh/skills/attention-scheduler/。技能名須匹配正則 ^[a-z0-9]+(?:-[a-z0-9]+)*$(kebab-case)。安裝後無需重啓,DSH 會熱發現。
使用方法¶
- 按需加載:在 DSH 中直接說“套用注意力調度規則”,或調用 skill 工具加載
attention-scheduler。 - 全局生效:將技能中的精簡版規則寫入
~/.dsh/AGENTS.md,每輪自動作爲工作區指令注入。 - 複測開銷:運行實測腳本,對比不同配置下的成本結構。
node scripts/measure-overhead.cjs --session "~/.dsh/sessions/<ws>/<session-id>/session.v4.jsonl.zstd"
依賴與限制¶
- 記憶插件依賴:需要搭配記憶插件(如 MemOS 或 dsh-plugin-memory)才能使 L1 動態召回、檢索觸發等功能完全生效。如果沒有記憶插件,僅注意力預算、保留優先級、壓縮六要素、寫回白名單會實際生效;檢索觸發、召回/注入條數等條款將處於空轉狀態。
- 權限與重啓:通過插件方式安裝後,必須重啓 profile 才能生效。
總結¶
attention-scheduler 通過規則化手段控制上下文與記憶的流向,適合希望降低幻覺、優化成本的開發者。其核心價值在於將模糊的“記憶管理”轉化爲可配置、可審計的流程。
插件目錄:https://www.skillhub.cn/plugins/Kfytm/attention-scheduler
GitHub 倉庫:https://github.com/Kfytm/attention-scheduler