上下文管理器 SkanderBog/dsh-context-manager

DSH Context Manager

一个独立插件，适用于 DeepSeek Harness 0.2.0-rc.2 或更高版本。在会话标题旁加一个 Context 按钮，命令菜单里也加一项 /context-manager。不用改桌面端源码，不用额外起后台服务，也不需要模型工具。

用法

1. 在已有会话里打开 Context。
2. 查看估算的上下文用量及其构成：指令、用户消息、回答、已存储的推理、工具/文件输出、工具定义、附件引用。
3. 为较早的历史分组选择 Keep、Summarize 或 Omit。最近一轮往来、system/developer 指令、Harness 的指令/目录/运行时快照，以及未完成的工具往来都受保护。
4. 选择摘要的处理方式：概括、保留原文，还是省略已记录的工具/文件输出。
5. 可选：在选中的分组上打开 Add notes to preserve，记下决策、被否决的方案及原因、风险或下一步。
6. 生成预览。核对确切的替换文本、备注、生成用量和估算的本地 token 变化，勾选复核框，然后应用。

本地上下文、上报用量与 ACP

面板把 local context 和 the last reported model request 分开标注。前者用 Harness 的上下文计量，是对保留会话面的估算。后者报告最近一次带可用用量数据的 assistant 事件里，服务商给出的输入和输出计数。输入包含 Harness 三个互不重叠的桶：未缓存、缓存读取、缓存写入。推理 token 已计入输出，不再重复相加。上一次请求不能衡量下一次请求，换路由或换上下文之后尤其如此。用量缺失时显示为不可用，绝不显示为零。

如果当前智能体能看见 acp_status 工具，Read ACP status 会用当前 agent/session，走 Harness 常规的工具执行与权限流程，向该工具索取报告。它不发模型请求，只在点击时运行。报告按文本原样显示，不解析成凭空捏造的 token 数。刷新面板会清掉它；继续干活之后要重新刷新状态。出错、工具模式受限、取消、引擎不可用，都会明确提示。不会去发现代理地址、凭据或其他会话。请求有 10 秒协作式超时。

这支持 ranxianglei/billion-context 和各类 ACP 实现所用的工具边界，但不强制依赖其中任何一个。在 billion-context 的原生 DSH 模式下，本地历史可能远大于代理实际送入模型的输入。所以本地估算和 ACP 报告始终分开。适配器已用 Harness 真实工具运行时和一个受控 ACP 工具测过；真实第三方引擎和服务商尚未经这些测试认证。
预览生成会报告摘要调用次数，以及服务商报告的输入/输出总量，这些数字与上下文节省量相互独立。报告不完整时会标注出来。仅省略的预览报告零次模型调用。这些是 token 计数，不是货币估算，也不是完整的账单明细；被丢弃或失败的预览，以及其他插件的调用，都不会被重建进会话总计。

压缩历史与原文

加载压缩历史读取标准 Harness compaction/summary 记录。每条记录显示记录的摘要路由、可用的命令/引擎归属、用量、检查点文本，以及替换是处于活动状态、已被取代，还是未应用。日志无法确定归属时，归属留为未知。

查看原文从同一会话日志中读取记录对应的精确源事件 ID，包括不连续的范围和更早的检查点。这是只读的、面向人的视图；它既不恢复消息，也不把消息发给模型。推理内容和摘要器的原始输出会被排除。不显示图像像素。截断和不可用的源事件会明确标注。重新加载已保存的会话后，该视图仍可正常使用。

历史页面最多在 1,000 条日志事件中搜索，最多返回十条记录；命令归属对每条记录使用有界回溯。原文每页显示五条消息，每条最多 8,000 个可见字符。最近请求核算最多搜索 10,000 条近期事件。这些上限让长会话中的检查保持响应。更早的压缩记录即使某页没有检查点也会继续翻页；更新的压缩记录会沿已访问的页面返回。刷新会从最新记录重新开始。仅代理压缩和 IoT 单独的原文归档不在这个日志视图内。

已审阅的决策说明

说明是可选、由用户撰写的背景数据，包含类别、来源历史事件编号和来源会话 ID。它们会作为已审阅检查点的独立块原样追加，绕过生成式改写。之后的 Context Manager 摘要会保留有效的说明块及其来源，会话重新加载后也是如此。普通用户/助手消息即使引用了说明格式，也不会被提升为持久说明。说明是用户审阅过的陈述，不是自动核实的事实。

修改说明会使当前预览失效。每条说明限 2,000 个字符；一个摘要范围最多携带 32 条说明、16,000 个说明字符。超出部分会在模型调用前被拒绝，不会静默丢弃说明。如果某个范围的说明本身就超出其上下文预算，也会在生成摘要前被拒绝。保留会留下说明；省略会刻意把它们从活动上下文中移除。其他压缩引擎可以摘要或移除这些块，所以这不是永久固定。
IoT 的紧凑思考仍属原生推理，不计入摘要输入。含推理的分组会带标记。想保留的决策请写进显式备注字段；插件不会提取或改写原生推理，也不会提取或改写服务商签名。

预览生命周期

页脚显示所选分组在替换前的近似 token 数，并区分付费摘要请求和只做省略、不调用模型的预览。预览就绪后，焦点移到它的复核复选框。预览可用期间，生成预览保持禁用，避免重复发起摘要请求；要再准备一份，请点 Discard preview 或更改选择。过期预览会自动移除。请求已取消时，若响应迟到，也无法恢复其预览。

摘要请求以会话最近路由到的模型发起，可能产生正常的模型用量。宿主插件可以把标记为 purpose: 'compaction' 的请求改路由到专用摘要器。只改输入框里尚未发送的选择，不会设定摘要模型。只做省略的预览不调用模型。预览不会改动活动上下文。预览在十分钟后、出现新预览、插件重载或会话变更时过期。只有智能体空闲时才允许应用。初始保存尚未完成时，预览若过期或被丢弃，会在任何历史变更前被拒绝。

保留只作用于本次操作，不是对 Harness 自动压缩的永久固定。 现有自动压缩保持原样。

为什么用均衡的历史分组？

模型适配器在重放先前的助手消息时，可能要求推理签名和完整的工具调用/结果配对。只从这些原生消息里删掉推理，可能让会话失效。本插件要么完整保留所选交互，要么用普通文本检查点替换整个均衡区间。它绝不编辑保留消息的推理或服务商元数据。

摘要输入是一份全新的、不含工具的文本转录。它排除推理，把文档内容标为数据，并要求模型保留目标、决策、约束、已验证结果、路径和未完成的工作。和任何模型摘要一样，细节可能丢失或被歪曲：应用前请先复核预览。

文件、PDF、图片与原始历史

- 工具输出包括文件读取器、PDF 插件、终端命令和其他工具返回的文本。输出选项作用于所有已记录的工具输出；它不会推断哪些文本来自 PDF。
- 「保留原文」会把已记录的输出文本留在检查点里。它不会重读文件，也不会保留图片像素。
- 附加图片不做视觉摘要。要保留原始附件，请保留它所在的分组。
- 磁盘上的文件，本插件绝不更改或删除。
- 原始消息仍保留在 Harness 的只追加日志和聊天记录里。压缩只改变模型当前活跃的上下文，不改动原始记录。这个版本没有一键撤销。
- 检查点使用 Harness 标准事件，卸载插件后仍可继续工作。

上下文总量取自 Harness 的 token 计量器。各分类的估算值用 Harness 固定的文本启发式算法算出，加起来不一定等于总量。CJK 文本、工具 schema、图片计价、服务商计费口径和框架开销都可能造成差异。标题栏的百分比沿用 Harness 现有的实时上下文投影；模型上报的信息不够时，这个百分比不显示。拿不到上下文上限时，面板仍然显示估算值。

安装打包好的发行版

从 v0.2.0 下载压缩包。

dsh plugin --profile tauri add /absolute/path/dsh-context-manager-0.2.0.tgz

把 tauri 换成你实际使用的 Harness 配置档名称。社区版 Linux 桌面在测试过的安装里用的是 tauri。其他 Harness 桌面发行版可能用 desktop；改动它保留的配置档之前，先退出那个桌面。更新插件后重启 Harness：只重载前端或切换组件，之前导入的宿主模块可能还留在缓存里。

有些社区桌面版在启动时会误删本地安装的 .tgz，把压缩包当成不存在的目录。遇到这类版本，把项目放在固定文件夹里，在该目录运行 npm ci 和 npm run build，再用 dsh plugin --profile tauri add /absolute/path/dsh-context-manager 安装这个文件夹。插件安装期间保留该文件夹。这个变通办法不需要改桌面源码。

这里针对的是 DeepSeek Harness 的插件运行时，不是独立的 DeepSeek 消费级聊天应用。宿主和浏览器 API 都是标准 Harness API。测试过的宿主是社区版 Linux 桌面里的 Harness 0.2.0-rc.2；其他官方桌面版必须提供同样的 API。我们没有声称在原生 macOS 或 Windows 桌面上测试过。

开发与验证

需要 Node.js 22.19+ 和对应版本的 Harness 包。除了宿主提供的 peer 包，插件没有其他生产依赖。浏览器端的 React 由 Harness 提供。宿主入口打包成一个小模块，这样插件更新时它的辅助函数会一起重新加载。

npm ci
npm run check
npm run test:package
npm pack

测试使用 Harness 真实的 Session、token 计量器、压缩不变式配套组件、AgentLoop、命令注册表和 JSONL 持久化，配上合成历史和受控模型。覆盖的场景包括：保留推理内容、工具调用配对平衡、选择性范围、只读预览、取消、过期计划、保存失败，以及卸载插件后的重放。包检查会校验压缩包里确切的公开文件列表，并用解压出的条目重跑宿主和浏览器两套测试。这些测试不衡量真实模型生成摘要的质量。
控制命令走 Harness 已有的认证命令路由。命令记录不会进入模型上下文。插件安装后，普通聊天卡片不再显示检查/预览载荷，改为显示一条简短的压缩成功记录。原始控制记录仍保留在会话日志里。

失败处理

如果 Rewind 或其他插件在摘要流式输出期间替换了活动历史，或改动了请求路由，预览会取消已过期的模型请求。它忽略无关会话和非上下文事件。发布和应用预览之前，仍会校验指纹。同一会话的多个视图各自保留独立注册，所以关掉一个视图不会让其余视图的 Context 命令失效。

Apply 在改动上下文之前先检查持久化，改动之后再刷写一次。最终磁盘出错时报告 changed in memory, saving failed。多区间追加失败时，报告已应用多少个区间。提交一开始就消耗掉预览，因此不确定的操作绝不会自动重试。出现这类错误后，请刷新并检查当前会话。

相关插件与改进方向

2026-10-02 的源码审查发现了几个有用的互补做法：

- dsh-auxiliary 把 purpose: 'compaction' 请求路由到单独的模型。本插件已经用这种方式标记摘要调用；自动化测试会检查该标记和原始路由。尚未测试与该路由器的实际互通。
- Context Compression Selector 提供自动缩减工具输出，以及按模型分别统计 token。它明确区分 tokenizer 计数、估算值和不可用计数，这是改进本面板近似拆分的一个有用方向。这里没有打包该项目的任何 tokenizer 或缩减器。
- dsh-context-management 在自动压缩之外，还提供历史召回和会话笔记。只读检索原始消息会是这里一个有用的后续补充；目前保留日志并不能给模型一个召回工具。

这三个项目都尚未测试实际互通。本插件仍是手动、经审阅的压缩界面。自动策略、精确的下一次请求计量、永久固定、面向模型的历史召回工具和撤销，都留待后续。面向人的原始消息检查和显式审阅笔记已按上文所述提供。

已安装插件兼容性检查

2026-10-08 的检查使用真实 Harness 0.2.0-rc.2 服务，搭配 Rewind 0.15.0、Better Sidebar 0.24.1、DSH Market 1.66.6，以及配套的 PDF Reader 检出。检查覆盖了回退后拒绝过期预览、回退时取消流式摘要、持久化压缩、PDF 文本/图片投递，以及插件独立释放。Market 的覆盖范围是它的路由注册和只读能力端点；包安装/更新操作和第三方浏览器接口不在检查范围内。桌面版本边界见 VALIDATION.md。

要针对显式指定的本地安装重复检查，需先准备好 Poppler：

npm run test:installed -- /absolute/runtime/root /absolute/profile/root /absolute/pdf-reader/checkout

配置档中必须已包含 Rewind、Better Sidebar 和 DSH Market。脚本读取它们的包，使用 Harness 自己的模块解析服务，然后创建临时会话、快照、附件和 market 存储。它不会启动实际配置档，也不会读取其中的对话。模型响应、设置界面、加载器清单和 web 运行时元数据都是受控的测试夹具；会话、命令、工具、持久化、HTTP 路由和插件代码都是真实的。临时回环服务器在完成后关闭。不会发起付费模型请求，也不会改动包管理器。

兼容性与资源检查

在首次模型请求之前，所有选定的摘要范围都会对照转录上限检查。因此，如果后面的范围过大，历史记录保持不变，也不会产生更早的摘要请求费用。仅省略的范围不需要模型或摘要转录。

CI 在 Linux、macOS 和 Windows 上测试打包后的宿主和浏览器产物。固定基线是 Harness 0.2.0-rc.2；额外的 Linux/Node 24 通道会测试 0.2.1-alpha.1、0.2.1-alpha.2 和 0.2.1-rc.2，但不改变发布依赖的固定版本。这些是插件/运行时检查，不是打包桌面 GUI 测试。

商店兼容性与权限

清单包含商店专用的 dsh.compatibility 矩阵，以及宿主的 engines.dsh 门槛。打包 API 测试在 DSH 0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2 和 0.2.1-rc.2 上通过。Linux、macOS 和 Windows 的打包插件测试验证宿主和浏览器契约，不验证打包桌面 GUI。Web/桌面配置档需要指定的对话和命令客户端模块；无头配置档只暴露命令。

| 能力 | 范围 |
| 对话数据 | 读取所选会话的活动历史，以估算用量并构建预览。记录的推理内容不进入摘要输入和客户端摘录。 |
| 持久化更改 | 用户查看并应用预览后，通过 Harness 会话持久化写入标准压缩事件。原始日志条目保留。没有撤销按钮；Keep 不是永久固定。 |
| 网络与费用 | 生成摘要时使用已配置的 Harness LLM 服务，可能把选中的对话记录文本发送给对应服务商，并产生用量费用。仅做省略预览时不发起任何模型请求。显式读取 ACP 状态时，会按 Harness 策略调用已安装的 acp_status 工具；该工具可能连接它自己的引擎。 |
| 凭据 | 使用宿主机已配置的 LLM 服务；不请求、不显示、也不直接读取服务商凭据。 |
| 文件与进程 | 随附的运行时代码中，没有直接操作文件系统、shell、原生可执行文件、安装包、修改配置档或重启 API 的能力。会话持久化是 Harness 处理的间接磁盘写入效果。 |
| 依赖 | 由宿主机提供 DSH 服务和 React；不捆绑原生工具、外部服务器，也没有生产环境的 npm 依赖。已提交的宿主机 bundle 安装时不需要 prepare 或安装钩子；prepack 是维护者打包步骤。 |

这个插件会改动活跃的对话上下文，还可能调用模型，所以即使静态扫描器识别不出这些宿主机服务带来的影响，也需要做一次带权限视角的审查。列出清单、自动源码检查、测试、独立安全审查，是四种彼此独立的状态。命令行安装、启动、卸载、回滚的操作记录，除非有一次性配置档的报告加以确认，否则仍明确视为未知；常规宿主机测试无法确认这些操作。