dsh-arc-context

中文 | English | Русский | Deutsch | 한국어 | 日本語 | [Français](./README.fr.md) | [Italiano](./README.it.md) | [Español](./README.es.md) | [العربية](./README.ar.md) | [ไทย](./README.th.md) | [Tiếng Việt](./README.vi.md) | [Português (BR)](./README.pt-BR.md) | [हिन्दी](./README.hi.md) | [Bahasa Indonesia](./README.id.md)

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](research/results/release-verification-0.2.0-beta.12.json)。

实测优势

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

对比内置 Basic 压缩(同场景同 seed)

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

质量 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 <name> ... 可推广到任意 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](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

完整配置(上下文窗口、nudge 阈值、保护范围、Governor、提示模板等)见 [docs/INSTALL.md](docs/INSTALL.md) 与 [docs/kernel-tuning.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](docs/research-agenda.md)
• 结果数据:[research/results/](research/results/)(含发布门十项矩阵、对照实验、对抗套件)
• 设计文档:[docs/](docs/)(安装、preset 集成、Governor 设计、可逆安装设计)
• 公开证据校验:npm run research:verify

致谢与许可

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