DeepSeek Harness 插件：dsh-codex-compaction

前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的架构，核心逻辑保持稳定，具体能力通过插件扩展。在处理 Codex 类会话时，会话长度增加会导致上下文膨胀。dsh-codex-compaction 插件在保留官方 Basic Compaction 引擎作为主控的前提下，为 Codex 会话提供了一个可选的账户级原生摘要接口，同时修复了部分历史兼容性问题。

插件简介¶

dsh-codex-compaction 是 DeepSeek Harness 的一个模型推理类插件，由用户 shaomingbo 维护。它提供官方 Basic Compaction 引擎的补充功能，包括可选的原生摘要接口、图像重放修复以及遗留的结构化阅读器支持。该插件不修改 DSH 核心代码，也不需要重复登录账户。

核心功能¶

该插件主要包含以下能力：

标准会话保持标准
新建和现有的普通 openai-codex 会话保留官方的自动压缩机制（触发、压力、溢出恢复、保留、计量、收缩检查、提交/刷新）。默认路径不会改变，直到你主动选择启用其他功能。
按会话的原生压缩（默认关闭）
每个会话可以独立开启或关闭原生压缩。
- 在运行中的会话输入 /codex-native on 启用原生压缩。
- 输入 /codex-native off 停止创建新的原生会话（已存在的原生状态可通过对应的阅读器读取）。
- 输入 inherit 可将会话恢复为配置文件默认值（当前版本默认为关闭）。
图像重放修复
针对 0.3.3 版本修复了用户和工具结果的图像重放问题，支持通过主机的持久化附件服务和公共 Pi 转换进行渲染。
遗留兼容性
支持传统的 codex-native-lab 路径和归档的 B 预设。针对旧版会话提供特定的兼容支持。
自定义模型支持
通过账户元数据接口支持 gpt-6-astra 等自定义模型的解析。
明确的边界
- 原生检查点仅重放压缩后的摘要，而非原始对话。语义召回是有损的，已压缩的细节不一定能被记住。
- 每个所有者租约最多允许一次额外的恢复请求（原生重试或透明文本回退），不会叠加或续期。
- 原生载体历史不会回退到文本模式。

安装与启用¶

安装前请确保 PATH 中存在以下版本的 DSH CLI 之一：0.1.2-alpha.3、0.1.2-rc.1、0.1.5-rc.1 或 0.1.5-rc.2。

使用以下命令安装插件：

npx --yes --ignore-scripts github:shaomingbo/dsh-codex-compaction#v0.4.3

安装完成后，通过以下命令在会话中启用原生压缩：

/codex-native on

典型用法¶

启用/停止： 在会话中输入 /codex-native on 启用，/codex-native off 停止。
观察逻辑替换： 输入 /codex-context 查看逻辑替换的观察结果。
遗留路径设置： 对于需要兼容旧版 structured reader 的场景，使用 /codex-compact-setup。

适用场景与注意¶

版本要求： 插件依赖特定的 DSH CLI 版本，安装前请检查 dsh --version。
重启生效： 修改 Bundle 后需要重启对应配置文件，Web GUI 需要硬刷新才能生效。
召回限制： 插件不保证语义召回无损。关键状态、决策和代码引用应保留在项目文件中，需要时重新读取。
非注册依赖： 插件不依赖注册表，而是在运行时预检 codex-runtime/v1 协议和认证所有者。

结尾¶

dsh-codex-compaction 为 DeepSeek Harness 的 Codex 会话提供了一个不侵入核心、可选的原生摘要能力，适合需要在保留标准压缩机制的同时，利用原生接口处理特定长会话或图像历史的场景。更多技术细节和源码可参考其 GitHub 仓库。