前言¶

在 DeepSeek Harness（DSH）這類「一切皆插件」的智能體環境中，會話文本、工具調用和工具結果會快速累積，佔滿上下文窗口。常見處理方式是讓模型再執行一輪摘要；這會帶來額外模型調用、延遲、改寫風險，以及壓縮後細節難以精確恢復的問題。

dsh-compaction-instant 提供另一條路線：用確定性文本處理替代 LLM 摘要，壓縮 shadowed history spans，並把被省略內容指向持久日誌中的 seq 值。它作爲 @deepseek-ai/dsh-compaction-basic 的 drop-in 替代，保留同樣的 seam、events、provenance 和 failure vocabulary。

這是什麼¶

• 插件名：dsh-compaction-instant
• 維護者：TsFreddie
• 許可證：MIT
• 運行要求：Node.js >= 18
• 倉庫地址：https://github.com/TsFreddie/dsh-compaction-instant

一句話定位：這是 DeepSeek Harness 的即時、近乎無損上下文壓縮引擎。它的核心目標不是“讓模型總結得更短”，而是把歷史片段壓縮成仍可恢復的確定性條目。

核心功能¶

不經過模型的即時壓縮¶

壓縮過程不調用模型，也不走網絡請求。資料中描述爲使用確定性文本處理，適用於 shadowed history spans 的即時壓縮。

這意味着壓縮路徑不依賴 summarizer prompt、不產生額外推理調用，也不涉及 KV-cache 相關處理。

輸出保留原始 token¶

壓縮輸出只保留原始 token，不做改寫式摘要。被省略的內容會留下 seq 指向，供後續恢復。

這與“壓縮後只能靠重新生成”的方式不同：這裏的關鍵是壓縮結果仍然指向持久會話日誌中的原始事件。

與 @deepseek-ai/dsh-compaction-basic 對齊¶

該插件定位爲 @deepseek-ai/dsh-compaction-basic 的 drop-in 替代，並保留相同的 seam、events、provenance 和 failure vocabulary。

對使用現有 basic 壓縮後端的 DSH 場景來說，這一點意味着它不是另一套需要重建事件流和失敗語義的獨立系統。

提供 recall 與 search 恢復能力¶

插件提供兩類模型側工具：

• recall：用於恢復被壓縮省略的持久日誌內容。
• search：用於在持久日誌中按關鍵詞或 regex 搜索，包括被壓縮省略的內容。

另外提供人類側命令 /recall，用於追加 durable recall user message，讓下一輪模型能看到匹配事件和 seq 指針。

典型用法¶

壓縮後的形態¶

資料示例中，一段包含 user request、assistant text、tool call 和 result 的歷史片段，可以被壓縮成類似下面的單行條目：

[user]
please fix the bug
[assistant]
on it
* read "a.js" (seq 2 -> result 3)
[user]
next question

這裏的 (seq 2 -> result 3) 是持久日誌指針。被壓縮的內容不是直接消失，而是通過指針繼續可訪問。

用 recall 恢復原文¶

recall 工具用於把原文恢復到當前工具結果中。資料中給出的恢復類型包括：

type: "seq"
type: "result"
type: "checkpoint"

• seq：用於基於 seq 指針恢復對應內容。
• result：用於基於 result 指針恢復工具結果。
• checkpoint：用於基於 checkpoint 標識恢復對應內容。

用 search 查找持久日誌¶

search 工具用於對持久日誌做關鍵詞或 regex 搜索。搜索範圍包括已經被壓縮省略的內容，並返回匹配事件及其 seq 指針。

這個工具適合在模型不確定原文位置時使用：先搜索，再根據返回的 seq 指針做恢復。

人類側使用 /recall¶

人類側可以使用如下命令：

/recall <keyword|regex>

該命令會追加一條 durable recall user message，其中包含匹配事件和 seq 指針，供下一輪模型查看。

配置與兼容注意¶

以下配置項名稱保留原文，作爲可選配置出現：

thresholdRatio
retainTurns
retainTokens
auto
checkpointCap
textTokens
userTextTokens
toolCallTokens
maxRecallTokens
maxSearchHits

這些配置項用於控制壓縮預算、保留範圍、自動行爲，以及 recall/search 的讀取上限。

需要注意的兼容點：

• 預算同時按 token 數執行，並受 budget × 4 字符上限約束。
• maxTokens 和 checkpointScale 被接受，但已廢棄，不參與預算。
• summarizationProvider 和 summarizationModel 被接受以保持兼容，但不起作用。
• toolResultExcerptTokens 被接受以保持兼容，但不起作用。
• 缺失數組配置項會被視爲未設置，並回退到默認值；空數組不會禁用內置項。

適用場景與注意¶

適合使用：

• 希望在壓縮上下文時不額外調用模型的 DSH 插件開發者。
• 希望降低壓縮路徑中的網絡調用、模型調用和 KV-cache 相關負擔的會話。
• 希望被省略內容仍可通過 seq、result 或 checkpoint 指針恢復的場景。
• 已有 @deepseek-ai/dsh-compaction-basic 接入方式，希望用確定性壓縮替代 LLM 摘要的宿主環境。

使用前注意：

• 插件通常以當前 dsh 進程權限運行。安裝前應先檢查源碼、依賴和許可證。
• 當前資料未提供官方安裝命令，本文不憑名稱拼接 dsh plugin add ... 形式。
• DeepSeek Harness 社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不應表述爲官方應用商店。

結尾¶

dsh-compaction-instant 的價值在於把上下文壓縮從“再讓模型概括一次”改成“確定性裁剪 + 可恢復指針”。當前資料未提供社區目錄頁地址；倉庫地址爲 https://github.com/TsFreddie/dsh-compaction-instant 。