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 倉庫。