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 提供了一種在保持原始證據無損的前提下進行上下文壓縮的方案。它通過批處理、錨點提取和溢出標記，緩解了狀態預算飽和的問題，適合在開發調試或實驗性場景中使用。