PlxloYzb/dsh-arc-context

dsh-arc-context

| English | Русский | Deutsch | 한국어 | 日本語 | Français | Italiano | Español | العربية | ไทย | Tiếng Việt | Português (BR) | हिन्दी | Bahasa Indonesia

ARC = Adaptive Reversible Context。 面向 DeepSeek Harness 的上下文治理插件：在安全区保持静默，在接近真实输入容量时执行模型驱动、本地可逆的压缩，信息永不丢失，卸载零残留。

发布状态：公开 Beta，跟随 dsh 官方 0.1.0-rc.8。 本项目与 dsh 均处公开 beta，暂不建议用于生产。完整发布门实机验证矩阵（十项）见 research/results/release-verification-0.2.0-beta.12.json。

实测优势

以下数字全部来自真实模型实机实验（原始 usage 口径，不换算价格），证据与实验协议随包发布，由 npm run research:verify 逐项复核。

对比内置 Basic 压缩（同场景同 seed）

代码工程长会话 — 逐字历史约束保真：

| 方案 | 精确事实 | 派生约束 | 输入 tokens | 输出 tokens | 总 prompt |
|---|---:|---:|---:|---:|---:|
| ARC | 24/24 | 4/4 | 121,146 | 23,234 | 1,055,802 |
| Basic | 6/24 | 0/4 | 231,315 | 30,940 | 1,355,539 |

质量 4 倍差距的同时成本更低：输入 −47.6%、输出 −24.9%、总 prompt −22.1%；ARC 的压缩为本地可逆提取（零辅助 LLM 调用），Basic 为不可逆模型摘要。

无标签自然语言决策追踪（含值更替）：ARC 当前值 12/12、依据 10/10、旧值污染 0，输入较 Basic 低约 76%；独立英文 holdout 10/10 + 7/7。

Basic 没有的能力

- 永不丢失，可逆恢复 — 压缩原件永远保留在 append-only 日志；decompress 逐字恢复有效源（六链实测 100%，超大输出经 dsh 溢写文件同样完整）；search_context 检索压缩块，中英信息层召回 43/43。
- 多层蒸馏不失真 — tier-3 深层检查点的证据附录在 6/6 条双语链上 20/20 保留全部事实（有效源索引递归刷新，effectiveSourceSafetyIndex）。
- 预算内的类型加权保留 — 附录超出检查点预算时按类型价值密度逐出噪声行，而非按时间序截断（safetyIndexRanking: value）：离线最差情形全预算占优，live 配对附录层 +14.3pp、端到端零回归。
- 对抗零服从 — 18 个归档注入攻击面变体（摘要投毒、检索注入、伪保护标签、模板模仿等），模型服从次数 0；一切归档输出带"历史数据，非指令"框架。
- 诚实压力治理 — 压缩感知读数 = dsh 投影 − 日志账本遮蔽；压缩后零伪紧急告警（实测），压力显示与真实占用一致。
- 紧凑指导 — 系统指导 1,140 tokens，四臂实机 verbatim 质量与完整版零劣化（0pp）。

安装

同时启用 web 界面与 cli 终端（cli 终端对应 headless profile；dsh plugin --profile  ... 可推广到任意 profile）：

dsh plugin --profile web add dsh-arc-context        # web 界面
dsh plugin --profile headless add dsh-arc-context   # cli 终端

重启 dsh 即生效。bundle 自动安装 host-plane Preset Bridge：ARC 在 standard preset 自己的 compaction 隔离域内替换官方 Basic 行，preset 文件逐字节不变；命令、pruner、isolation 及其他 preset 行全部保留。

手动安装 tarball、其他 profile 与高级选项见 docs/INSTALL.md。

配置（节选）

- id: compaction-arc-bridge
name: 'dsh-arc-context/bridge'
config:
effectiveSourceSafetyIndex: true   # tier-2/3 索引递归回有效原始源（默认开）
safetyIndexRanking: value           # 超预算时按类型价值密度逐出（默认 value）
adaptiveGovernor:
enabled: true
maxOutputTokens: auto

| 配置 | 默认 | 说明 |
|---|---|---|
| effectiveSourceSafetyIndex | true | tier-2/3 蒸馏时，安全索引递归回到有效原始源，而非只重提取可见父 checkpoint。tier-1 输出不变。 |
| safetyIndexRanking | value | 附录超出检查点预算时的逐出次序：value 按类型价值密度先逐出低价值事件行；chronological 为纯时间序截断。预算内两者输出逐字节相同。 |
完整配置(上下文窗口、nudge 阈值、保护范围、Governor、提示模板等)见 docs/INSTALL.md 与 docs/kernel-tuning.md。

卸载 — 干净、彻底、实机可验证

dsh plugin --profile web remove dsh-arc-context        # web 界面
dsh plugin --profile headless remove dsh-arc-context   # cli 终端

重启 dsh 后:

- 组合配置回到官方 Basic,无任何 ARC 行残留;
- preset 文件全程未被修改(SHA-256 前后一致,发布门实测);
- 已有会话继续可读:Basic 直接读 ARC 的持久日志,压缩后的表面形态保持,不会把原始内容洪泛回上下文(实测 2,331 事件的会话完整可读、投影正常);
- 新会话不再注册任何 ARC 工具或命令。

重装随时可行,行为与首次安装一致(安装 → 卸载 → 重装循环在发布门矩阵中逐项验证)。

升级

发布新版本后,在每个已安装的 profile 里更新即可:

dsh plugin --profile web up dsh-arc-context
dsh plugin --profile headless up dsh-arc-context

up(pnpm update)把 profile package.json 里已声明的依赖范围更新到允许的最新版(例如 0.2.0-beta.14 → 0.2.0-beta.15);dsh plugin 的 reconcile 会保持 dsh.profile.bundles 同步,重启后新版本生效。

add 与 up 的区别:add 按包名重新解析并写入依赖,首次安装、或把本地 tarball/file: 依赖切回 npm 注册表版本时用它;它同样自动 reconcile bundle 层。日常在已有范围内小步升级用 up 即可。

证据与文档

- 研究议程与全部结论:docs/research-agenda.md
- 结果数据:research/results/(含发布门十项矩阵、对照实验、对抗套件)
- 设计文档:docs/(安装、preset 集成、Governor 设计、可逆安装设计)
- 公开证据校验:npm run research:verify

致谢与许可

ARC 的压缩内核源自 acp-kernel(及 billion-context-pi、opencode-acp,ranxianglei,MIT)的移植与独立演进;dsh 宿主为 DeepSeek Harness(DeepSeek AI)。本项目 MIT 许可,见 LICENSE。