dsh-compact-saviour
在原生上下文弹出窗口中使用专用模型进行压缩恢复和手动压缩
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-compact-saviour@0.2.8Compact Saviour 以 dsh-compact-saviour 发布，当前版本为 0.2.8。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness 增加独立模型自动压缩、长按压缩和一键手动压缩。当前适配的 Host：DSH 0.2.0-rc.2。
需要 DeepSeek Harness 0.2.0-rc.2（@deepseek-ai/dsh-* peer >=0.2.0-rc.1 <0.2.1，与 DSHX 写在 @deepseek-ai/dsh 上的范围相同）。这是符合官方 dsh.bundle.patch 约定的外部插件，仓库和 Release 安装包都包含编译好的 lib/。安装不需要 dshx、Creator Mode、Harness 源码或本地构建。 本次正式版本为 0.2.8，提供 npm 包和 GitHub Release 安装包。
打开 DeepSeek Harness / DSH Studio 的 插件 页面，选择 添加插件。
在 包名或地址 中填入下面这一行，按官方安装向导继续：
dsh-compact-saviour@0.2.8
安装到当前应用所用的 profile，按安装结果给出的提示完成启用或重新打开应用。
打开 设置 → Compact Saviour，选择已经配置的压缩模型并保存。
桌面应用通常使用 desktop profile。下面的 --profile web 命令只针对 Web Host，不会替桌面应用安装插件。
已安装官方 dsh CLI 时：
dsh plugin --profile web add dsh-compact-saviour@0.2.8
没有全局 dsh 命令时：
npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add dsh-compact-saviour@0.2.8
CLI 路径需要 Node.js 24+ 及 PATH 中的 pnpm；Git spec 另需 Git。它把包写入选定 profile；按官方安装器的生效结果继续，只有提示需要重启时才用原启动方式重新打开 Host。不要在同一个 DSH_HOME 上另开一个 Host。
从 v0.2.8 Release 下载 .tgz，在官方插件管理器中选择该安装包。开发时也可使用本地目录：
dsh plugin --profile web add file:/path/to/dsh-compact-saviour
这条路径同样使用官方插件安装器，不需要解压或手动创建软链接。npm 安装可使用上面的固定版本包名。
更新时在官方插件管理器安装目标版本的 npm 包、GitHub spec 或 .tgz，按结果提示生效。Web CLI 使用同一条 add 命令即可指定目标版本。卸载请使用应用插件页面；Web CLI 对应：
dsh plugin --profile web remove dsh-compact-saviour
卸载后使用官方压缩逻辑，原始会话日志保留。
Open Bot Motion #7 satellite 小机器人；排队时静止等待，结束后恢复用量圆环。2/5，计数包含合并步骤，位置不会随文案移动。合并时切换到合并文案；系统开启减少动态效果时保持静止，后台页面暂停轮换。插件不添加第二个圆环或弹层外的快捷按钮。模型首次保持未配置状态，不默认消耗当前会话模型的额度。
默认采用“官方连续失败两次后救援”：自动压缩先由官方处理，连续两次符合条件的失败后，Saviour 静默使用配置模型救援。手动按钮、长按圆环和原生 Compact 命令始终直接使用 Saviour 模型，与自动策略和自动开关无关。设置中可主动选择“直接使用 Saviour 模型”来接管全部自动压缩，或关闭自动辅助。缺少 mode 的旧设置按 rescue 处理；明确保存的模式、已有模型和推理等级保留。失败不会自动换模型；在同一个 popup 中可以重试配置模型、仅本次使用当前会话模型，或者取消。临时使用当前模型不会改写保存的设置，也不会切换会话模型。
会话正在运行时，手动请求排队到下一步开始前；若当前步骤结束后会话直接空闲，则在官方 maintenance 锁内执行。不会中断正在运行的工具。
“失败两次后救援”模式在第二次符合条件的官方压缩失败后自动调用配置模型，不弹确认、不抢焦点、不主动展开 popup。圆环显示压缩状态，手动打开后可看进度；救援成功后返回原调用继续执行。若救援也失败，错误和重试入口留在 popup 中，并停止自动重复救援。原生压缩事件仍会记入会话记录，静默不代表隐藏错误或日志。
普通安装不需要编译。需要修改源码时请看 开发说明。
CONTEXT_WINDOW_EXCEEDED 时，只缩小超限部分并继续处理；其他任务已完成的摘要保留。每条分支最多缩小四次，额度、限流、超时、空摘要和截断不会引发更多拆分调用。原始会话只在最终摘要通过事务校验后替换。服务端对已激活官方 BasicCompactionEngine 和 TokenMeter 的公开实例方法做可撤销包装，不修改原型、核心源码或预设文件。优先选取会话所在预设作用域的后端；找不到唯一匹配则禁用该会话的手动入口。卸载时只恢复仍归本插件所有的包装。历史消息、provider 用量事件和累计账本保持原样。
救援事务复用固定版本的官方实现副本（src/vendor/region.ts，MIT），继续发出官方 compaction/start、compaction/summary、compaction/end，沿用官方配对检查、锁、表面变化检查和持久化。
官方 popup 暂无 footer 或读数插槽，客户端通过 conversation.input.right 的隐藏锚点找到附近的官方上下文弹层，将按钮 portal 到它的底部。0.2.5 支持新版位于卡片下方 dock 的圆环和挂载到 body 的独立浮层；只观察当前输入栏、已确认的上下文浮层，以及 body 的直接子节点，不扫描流式消息子树。多个浮层归属不明确时不接管。异常读数修正复用原有文本节点、圆环和进度条，保留原样式及点击行为，停止修正时恢复原控件的最新值。官方 DOM 结构改变后应重新验收，找不到目标不会绘制替代圆环。
40 项后端测试通过，覆盖自动救援、分块压缩、失败保护、事务、排队、手动重试、会话模型保持不变及卸载恢复。浏览器回归覆盖新版独立浮层、旧版内联弹窗、按钮/键盘/长按、状态动画、百分比修正和切会话清理。
0.2.5 已在 DSH Studio 0.1.7-rc.2 的真实窗口确认手动入口恢复，并验证客户端热更新；本轮修复测试没有调用模型、没有压缩用户历史，不代表重新测量了摘要质量或模型时延。详细记录见 ACCEPTANCE.md。
摘要是有损压缩，可能漏掉细节；原始日志始终保留。官方上下文弹窗暂未提供扩展插槽，本插件使用有边界的 DOM 兼容层。未来 DSH 更改弹窗结构时需要重新验收，不承诺未测试版本兼容。
插件通过可选公共服务 compactionRoutes（apiVersion: 1）接收会话的真实上下文模型、压缩模型、reasoning effort、输出上限和路由修订。Fusion 会提供当前会话冻结的路由；其他会话仍使用 Saviour 自己的设置。自动辅助关闭时不接管自动压缩，手动压缩仍可用。
容量解析、分块预算和最终 llm.stream 请求使用同一路由快照。请求输出不超过已预留上限。路由变更或注册插件卸载后，旧快照失效；卸载也取消进行中的压缩。取消或失效不会提交摘要。该服务在外部插件内实现，不改动 Harness 核心。
MIT。复用的官方压缩事务和 Open Bot Motion 动画许可见 THIRD_PARTY_NOTICES.md。