前言¶

在 DSH（DeepSeek Harness）裏跑 Agent，會話一長，上下文窗口會逐漸頂滿：模型要麼被動截斷，要麼靠宿主側硬編碼閾值在某一時刻強行壓縮，開發者往往看不清「當前用了多少、離上限還有多遠」。若壓縮時機與當前任務不同步，還可能打斷一輪推理或注入額外話術，干擾對話語義。

dsh-context-pilot 面向這類問題：把用量信息按輪注入 prompt，由模型通過工具調用決定是否壓縮；壓縮在下一步開始前落地，本輪不中斷、不注入消息、不僞造用戶發言。另提供可選的智能思考，把當前模型的思考強度檔位告知 Agent，由它按任務難度自主換檔（同樣走工具）。下面介紹插件定位、能力與安裝用法。

這是什麼¶

• 倉庫： Shuffle-1992/dsh-context-pilot
• 維護者： Shuffle-1992
• DSH 面板名： 「上下文智能壓縮」（曾用名「上下文領航」）
• 社區分類： 模型推理（SkillHub 目錄頁：dsh-context-pilot）
• 當前版本： v0.1.61（根目錄 package.json）
• 許可證： MIT

插件是 DSH 宿主側 bundle，通過 package.json 中的 dsh.bundle.patch 掛載 plugin/cordis.patch.yml；安裝後需重啓 DSH 生效。項目不分發 npm 包（2026-10-10 起安裝一律走 GitHub 倉庫規格）。

核心功能¶

上下文用量與壓縮決策¶

每輪向 Agent 注入當前上下文用量（上限、已用、佔比等，具體文案可在面板配置模板，留空則用內置文案）。當佔用達到智能壓縮線時，模型可自行調用壓縮相關工具決定是否壓縮，並在需要時自動續跑；當佔用達到強制壓縮線時，插件在 pre-step 無條件發起壓縮（執行路徑與智能路徑一致：先自算保留範圍，官方 overflow 兜底/收口）。

壓縮由工具觸發，在下一個步驟開始前完成，本輪對話不中斷，且不會在本輪注入額外消息或僞造用戶發言。

面板與可配項（節選）¶

配置卡（Web profile）中可調整與觀測的內容包括（以 README / meta.description 爲準）：

• 閾值餘量、智能/強制壓縮線及其上限關係（生效強制線 = min(用戶設定, 上限)；上限與引擎閾值、餘量聯動，改餘量會實時重算上限）。
• 三檔保留比例（活讀，改完下一輪即生效，無需重啓）。
• 文案模板：如 tplBrief、tplCard、tplEffBrief 等；留空使用內置文案；模板缺必要佔位符時會回退內置並留痕。
• 本輪注入相關只讀信息、強制壓縮冷卻等（詳見倉庫 docs/）。

智能思考（可選）¶

開啓後，向 Agent 暴露當前模型的思考強度檔位，並允許其通過工具按任務難度自主換檔；換檔在下一步生效，任務不中斷。

安裝與啓用¶

宿主 DSH 版本需滿足 package.json 中聲明：

"engines": {
  "dsh": ">=0.2.0-rc.2 <0.3.0-0"
}

從 GitHub 安裝（推薦且唯一官方分發路徑）：

dsh plugin --profile web add github:Shuffle-1992/dsh-context-pilot

說明：

• dsh plugin --profile web add dsh-context-pilot 這類 npm 形式在本項目不可用（無 npm 包）。
• 安裝後重啓 DSH；bundle 資格由本包 dsh.bundle.patch 聲明。

本地開發可將 plugin/ 目錄 link: 進 profile 的 dependencies，並在 profile 的 dsh.profile.bundles 中加入 dsh-context-pilot；插件 package.json 必須包含 dsh.bundle 段，否則可能被靜默跳過。細節見倉庫 docs/setup.md。

典型用法¶

1. 按上一節命令爲 web profile 安裝插件並重啓 DSH。
2. 在 DSH 設置中打開「上下文智能壓縮」配置卡，按需設置智能/強制壓縮線、閾值餘量、保留比例；文案模板可留空以使用內置說明。
3. 正常與 Agent 多輪對話。插件會在每輪注入用量與決策說明；接近智能壓縮線時，由模型通過工具決定是否壓縮；達到強制線時由插件在 pre-step 執行壓縮。
4. 若啓用智能思考，模型可在任務變難或變易時通過工具調整思考強度檔位。

倉庫 test/ 含 contract / static / report / boot 等斷言套件；改 host 側邏輯後，文檔 PANEL-HOWTO.md 建議對插件 toggle（關→開）或重啓 以加載新版 host 行爲。

適用場景與注意¶

適合：長時間編碼、排查、多文件 Agent 會話，希望用量透明、壓縮時機與任務節奏對齊，並可選讓模型自行調節思考強度的 DSH 用戶。

注意：

• 插件以當前 DSH 進程權限運行；安裝前請閱讀 GitHub 源碼 與 MIT 許可證，自行評估是否納入你的 profile。
• SkillHub（skillhub.cn）是社區插件目錄，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本插件是其中一條上下文管理路徑，並非唯一方案。
• 配置與行爲以倉庫 README、docs/ 及當前版本爲準；勿依賴未在文檔中出現的 npm 包名安裝。

結尾¶

dsh-context-pilot 把長會話的上下文壓力做成可觀測、可配置的面板能力，並把「何時壓縮、是否換思考檔位」交給模型工具鏈，壓縮落地在下一步前且不污染本輪對話。需要進一步瞭解設計與版本歷史，可看倉庫 docs/ 與 docs/milestones.md。

• 目錄頁：https://www.skillhub.cn/plugins/Shuffle-1992/dsh-context-pilot
• GitHub：https://github.com/Shuffle-1992/dsh-context-pilot