前言¶
在 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。
典型用法¶
- 按上一节命令为
webprofile 安装插件并重启 DSH。 - 在 DSH 设置中打开「上下文智能压缩」配置卡，按需设置智能/强制压缩线、阈值余量、保留比例；文案模板可留空以使用内置说明。
- 正常与 Agent 多轮对话。插件会在每轮注入用量与决策说明；接近智能压缩线时，由模型通过工具决定是否压缩；达到强制线时由插件在 pre-step 执行压缩。
- 若启用智能思考，模型可在任务变难或变易时通过工具调整思考强度档位。
仓库 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。
