Jev-LCM Compaction Plugin for DeepSeek Harness

前言¶

DeepSeek Harness（DSH）提供上下文管理的插件化架构。Jev-LCM Compaction 是一个实验性的 DSH 插件，旨在解决 Jev 独立压缩在 Hermes agent PR #116246 中被指出的问题：仅依赖 Jev 压缩会遗漏助手文本标识符，导致状态预算饱和，并在长时间运行中出现不断增长的文本地板。本插件将 Jev 排序置于无损上下文压缩之前，通过本地 SQLite 归档保存原始证据，并提供校准机制来优化保留率。

核心功能¶

该插件在 DSH 的原生压缩流程之前增加了一个 Jev 排序层，具体能力如下：

原始数据归档：在执行 Jev 评分之前，先将原始材料摄入到本地 SQLite 归档中。本地 SQLite 归档拥有原始证据，Jev 不会重写原始行。
智能评分与锚点提取：对匹配的工具-结果对以及选定的助手文本锚点进行评分。它使用滚动保留率分位数（而非默认的 0.5）进行校准，并对评分结果进行批处理。
溢出处理：在状态上限超出时，将溢出候选项标记为 jev_unscored，而非伪造分数。
多提供商支持：支持 Cloudflare Clef 作为提供者表面，支持 TYPESAFE_API_KEY 和 OPENROUTER_API_KEY。
会话工具暴露：在会话中暴露以下工具用于调试和管理：lcm_grep、lcm_expand、lcm_nodes、jev_stats、jev_providers、jev_scores、jev_anchors、jev_calibrate。

安装与构建¶

DeepSeek Harness 是开发者预览软件。在安装插件前，建议先确认 CLI 和配置文件。安装需要 Node.js >= 22.19.0。

git clone https://github.com/bojansandhaus/jev-lcm-dsh-compaction.git
cd jev-lcm-dsh-compaction
npm install
npm run build
npm test
npm pack

典型用法¶

插件提供了会话作用域的工具用于查询状态和配置提供者。

提供者回退¶

配置支持在多个提供商之间进行自动回退。例如，当遇到 429 错误时，可以切换提供者：

jev_provider_fallback from=typesafe to=openrouter reason=429

提供者验证¶

在使用真实数据前，建议验证提供者端点。例如，OpenRouter 适配器当前目标路径为 /alpha/decisions。

局限性与注意事项¶

该插件是一个实验性的 DSH 插件包，不声称具备实时提供者成功运行的能力或生产环境的对等性。

数据所有权：本地 SQLite 归档拥有原始证据，Jev 不会修改原始行。
架构差异：DSH 的归档不声称等同于 Hermes LCM 的 SQLite DAG。
生产环境：生产环境对等性、主机级召回、提示接受度和实时缓存影响均未经验证。
注册表发布：注册表发布不代表安装已更新。
开发环境：DeepSeek Harness 仍处于开发者预览阶段。

总结¶

Jev-LCM Compaction 插件通过引入 SQLite 归档和校准的 Jev 排序层，为 DSH 提供了一种在保持原始证据无损的前提下进行上下文压缩的方案。它通过批处理、锚点提取和溢出标记，缓解了状态预算饱和的问题，适合在开发调试或实验性场景中使用。