前言¶

在 DeepSeek Harness（DSH）里跑长任务时，上下文会随对话、工具输出和摘要不断变长。窗口有限时，若不清楚当前上下文里有什么、已经消耗多少 Token、压缩是否真正省下了空间，就很难在「继续堆原文」和「提前压历史」之间做判断。宿主自带的 Basic 压缩与社区插件可以并存，但各自账本和阈值并不自动合并。

下面介绍维护者 Missher12 发布的客户端插件 Missher DSH Context Manager（npm 包名 @missher/dsh-context-manager）。它以 Cordis Bundle 形式插入 Context Manager 与只读 Inspector，不改 DSH 桌面 Host 源码，也不依赖额外兼容插件；在模型请求前按策略压缩历史，并在界面中展示上下文组成、用量与压缩记录。

这是什么¶

• 仓库与目录：GitHub — Missher12/Missher-DSH-Context-Manager；社区目录页 SkillHub — Missher-DSH-Context-Manager（独立站点，与 DeepSeek / 幻方无官方从属关系）。
• 分类：客户端（dsh.client.platform 为 web，通过 Cordis patch 注入设置、会话、模型选择等 UI 模块）。
• 交付形态：kind: package-bundle，补丁文件为 cordis.patch.yml；许可证为 MIT（见仓库 package.json）。
• 当前文档版本：README 标明候选 0.10.2；SkillHub 目录页显示可安装 v0.10.2。同一 README 同时说明 0.10.2 尚未发布，不能从 Release 下载或按已发布资产安装——安装前请以 Releases 与 PUBLICATION.md 为准。已发布的 0.10.0 含设置页精简与会话 K/M Token 读数等；0.10.1 仅修复数字输入布局。

插件解决的核心问题：在 DSH 会话中查看上下文组成、摘要来源与用量归因，并在请求发出前按阈值压缩历史；任务正常结束后还可做闲置整理（需 README 列出的宿主接口）。它不是 Codex 或 Claude Code 的压缩实现，也不是桌面应用本身；桌面入口见 Missher-DeepseekHarness-Desktop。

核心功能¶

本会话用量与费用预览¶

点击对话输入框旁的「高峰期 / 低谷期」，可看到本会话已记录 Token、高峰与低谷费用、估算合计，无需手填 Token。每次结算使用各自记录的模型、路由和时段；费用汇总覆盖全部可读结算，不受「最近 200 条明细」展示上限影响。估算采用 2026-10-20 核验的官方参考价，不是历史实际账单；缺少用量、模型价格或时段时会明确提示部分或未计入。

继承的上下文管理能力¶

README 将引擎侧能力归纳为 A–E（local.8 及以后的行为以当前页说明为准）：

1. A 格式归一化与结构修复：严格检查 checkpoint 结构；仅当能确定为「数组字段误写成单个字符串」时按原值本地包装，不增加模型调用。其他结构错误仍拒绝并保留原文；formatRepairEnabled 控制是否启用这条本地修复。
2. B 工作集增长与续跑余量：动态保留工作集与 continuation headroom，在发起与提交前检查完整占用和可行性。
3. C 状态与用量记账：已派发与未派发状态分开；not_dispatched 不计入未知用量，已派发但未取得完整回报仍保留未知。
4. D 版本化 checkpoint：sections 格式为 context-manager/3，需显式选择；JSON 仍为默认。结构合法不代表语义保真。
5. E 工具结果减载：仅处理满足限制的完整成功前台 Bash 纯文本；默认 observe（只测算记录，不改宿主结果）。显式选择「安全精简」（toolResultsMode=reduce）才会改写：原文先写入只读档案，其他工具、失败或不完整结果均原样保留；不承诺实际 Token 或费用节省。

紧凑上下文视图与运行详情¶

上下文标题旁显示实际模型；会话主数字以 K/M Token 显示，百分比补充占比、缓存命中和节省。运行详情默认收起，只列六项常用事实；完整诊断需点击复制。面板默认展示两条压缩记录和三条有效内容，正文与来源按需展开。

工具结果精简与原文档案（0.10）¶

启用 reduce 时，插件先把原文写入 profile 下的只读档案目录 .context-manager-archive，再发布短文；仅当宿主最终结果仍保留短文时，才把引用计为已确认。未确认、已撤回与已确认分开显示。默认原文 blob 配额 512 MiB（统计已存原文记录字节合计；配额用尽只停用新的精简，不删除已有原文）。已压缩或已精简的原文可通过同会话工具 context_history_search、context_history_read 分页回读（单次扫描与输出上限可在设置中调整，并受工具自身输出上限约束）。

容量与超时（新安装默认）¶

新安装默认按模型窗口百分比分配容量（local.5 口径）：近期原文 10%、摘要输出 4%、格式修复 1%，并受协议与模型安全上限约束（如近期原文 128000、摘要 32768、修复 8192 Token 等上限）；小窗口向下取整，摘要或修复输出不足 256 Token 时不发起对应调用。旧 Token 绝对预算不会自动迁移，需在设置页明确「改用百分比并解除旧绝对上限」后保存。

长摘要默认采用自适应时限：整次压缩硬总限 600 秒、首个有效输出等待 120 秒、输出停滞上限 180 秒。缺少 summaryTimeoutMode 的配置仍按 fixed 读取；只有用户切换到「按输出进展等待」并保存后才启用 adaptive。

与宿主 Basic 压缩的关系¶

Bundle 只插入 Context Manager 与只读 Inspector，不快照或重写宿主 preset。Basic 按自己的阈值、费用和账本工作；Context 的「2 个主摘要 / 4 次调用」限制不覆盖 Basic，也不承诺所有窗口都只压一次。Host 的 provider 注册能力 v1 只影响 enhanced provider 注册；能力缺失不会自动替换或关闭 Host 的 Basic。

安装与启用¶

资料中未给出形如 dsh plugin add … 的固定一行安装命令；请勿凭仓库名自行拼接。可按下面路径核对版本与安装方式：

1. 打开 GitHub Releases 与仓库 PUBLICATION.md，确认当前可安装的发布资产（README 写明 0.10.2 候选尚未作为 Release 资产发布）。
2. 若使用 Missher 桌面分发，参见 Missher-DeepseekHarness-Desktop 与目录页上的主页链接。
3. 社区目录 SkillHub 标注为可安装客户端插件时，以其页面展示的安装说明为准（DSH 生态理念是「一切皆插件」，目录站为社区聚合，非官方应用商店）。

包对 Cordis / DSH 组件有 peer 依赖（节选，完整范围见 package.json）：

"@deepseek-ai/cordis": "^4.0.0 || 4.0.5-alpha.1",
"@deepseek-ai/dsh-agent": ">=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-alpha.2 <0.3.0-0",
"@deepseek-ai/dsh-compaction": ">=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-alpha.2 <0.3.0-0"

安装前请阅读源码与 MIT 许可证；插件以当前 DSH 进程权限运行，会读写 profile 下的会话与档案数据。

典型用法¶

查看本会话 Token 与估算费用¶

在已启用插件的会话里，点击输入框旁的「高峰期 / 低谷期」，查看本会话 Token 与高峰/低谷费用估算。布局可参考仓库文档图（合成演示数据，非个人账单）：

• 窄屏：docs/images/context-session-cost-narrow.png
• 桌面宽度：docs/images/context-session-cost-desktop.png

调整上下文管理与容量¶

进入 设置 → 上下文管理：

1. 核对容量是百分比还是旧版绝对 Token；若需 local.5 默认比例，按页面提示迁移并保存。
2. 若摘要仍卡在固定 90 秒，检查是否已切换到「按输出进展等待」并保存三个 adaptive 时限。
3. 工具结果：默认保持 observe；仅在理解档案与「已确认 / 待确认 / 已撤回」规则后，再设为 toolResultsMode=reduce 并调整输入上限、最小节省等规则。

回读被压缩或精简过的原文¶

在会话中调用宿主暴露的 context_history_search、context_history_read（插件提供逻辑与预算，不写 MSE、不访问其他会话）。分页参数与单次扫描上限在设置中可调；分叉会话只能读继承前缀内被授权的原文，超出边界时会报告不完整。

额度用尽后的人工急救（历史行为说明）¶

0.10.0-local.4 等历史版本文档描述了自动额度用尽后的「预检一次人工急救（不调用模型）」流程：预检不调用模型、不裁剪原文；确认后每批历史最多额外一次人工摘要，且跨重启保留消费记录。升级与存储域 context_manager_emergency 见 发布说明。当前候选版行为以 README 顶部 0.10.2 说明为准。

适用场景与注意¶

适合谁：需要在 DSH 里长期跑 Agent、希望看清上下文构成与用量、并在请求前主动压缩历史或可选精简 Bash 工具输出的开发者。需要与 Basic 压缩并存、且接受 Context 与 Basic 各自账本时，也适合对照 README 做集成验证。

务必注意：

• 插件不修改 Host 源码，但会通过 Bundle 注入客户端模块；安装前检查仓库与许可证，并理解 profile 内 .context-manager-archive 等持久化数据。
• 费用与 Token 多为估算或已知下界；无记录与「已报告零用量」在 UI 中区分显示。
• 100K 等多轮语义回放使用固定事实 oracle 与合成摘要做预算算术核对，不是任意真实模型的摘要质量证明。
• README 声明验证包含合成测试、类型检查、构建与跨平台存储 CI 等；不代表你在本机模型账单上的实际结果。
• GitHub 星标为 0（目录线索）；功能与版本以仓库 README / PUBLICATION 为准。

结尾¶

Missher DSH Context Manager 把「看清上下文」和「请求前压缩」收到同一个 Cordis Bundle 里：会话侧有 K/M Token、压缩记录与高峰/低谷费用预览；引擎侧保留格式本地修复、工作集可行性检查、分层用量记账，以及可选的 Bash 工具结果精简与原文档案。若你正在 SkillHub 或 GitHub 上选型 DSH 客户端插件，可从 目录页 进入，并在 Missher12/Missher-DSH-Context-Manager 核对当前可安装的 Release 与 PUBLICATION 说明。