前言¶
DeepSeek Harness（DSH）在上下文過長時會走 ctx.compaction：用一次 LLM 調用把早期對話壓成摘要，再保留近期消息。對智能體開發者來說，這條路徑在工程上常帶來三類問題——關鍵配置、路徑、數字被轉述或漏掉；舊事實以全新 token 形態出現，模型難以繼續「對準」原文；同一歷史兩次壓縮結果不一致，難以審計。社區插件 dsh-compaction-ctxfold 把摘要步驟換成 ctxfold 規則管線，在不動觸發閾值、尾部保留、durable 提交等機制的前提下，只替換 summarize()，實現零 LLM、毫秒級、字節級可復現的壓縮輸出。
這是什麼¶
dsh-compaction-ctxfold 是 DSH 的確定性壓縮後端插件，維護者爲 HZDF-2026，分類爲「記憶」。它繼承官方 BasicCompactionEngine 的契約，僅覆蓋 summarize()：被遮蔽區不再交給模型轉述，而經 ctxfold 三層結構生成 <compacted-summary>。宿主導入經 peer 攔截解析到 DSH 安裝內置的 @deepseek-ai/dsh-compaction-basic（同一模塊實例），其餘 compaction 行爲與內置引擎一致。
目錄頁：skillhub.cn/plugins/HZDF-2026/dsh-compaction-ctxfold
源碼與說明：github.com/HZDF-2026/dsh-compaction-ctxfold
內置 LLM 壓縮的結構性缺陷（插件針對的問題）¶
資料中對 DSH 內置 compaction 的歸納如下，本插件不改變觸發與提交邏輯，只改摘要生成方式：
- 事實漂移——例如
handoff.enabled、25000、/bin/jq.exe等關鍵事實在模型摘要中被改寫或丟失。 - token 序列整體改變——舊事實以新表述的 token 存在，注意力定位失效（切分方式改變導致模型忽略內容）。
- 不可復現——同一歷史兩次壓縮產出不同摘要，無法做確定性審計。
核心功能：Checkpoint 三層結構¶
摘要輸出由三層確定性結構組成（名稱與含義以倉庫 README 爲準）：
- Verbatim Anchors——逐字事實清單：路徑、數字、URL、哈希、命令、反引號代碼片段、點分配置鍵；子串去重，不做轉述。
- Prior Checkpoint——被遮蔽區內舊的
<compacted-summary>整段前向攜帶；過長時對中段以 sha256 指紋摺疊。 - Chronological Fold——按時間序的確定性 gist，新消息權重高於舊消息。
設計約束：輸出恆小於被遮蔽區（收斂兜底）；同一輸入永遠產生同一輸出。完整設計對照見 ctxfold 倉庫文檔 DSH_COMPACTION_ANALYSIS。
安裝與啓用¶
一個 ctx 只允許一個 compaction 後端。安裝本插件後需停用內置 compaction-basic。
1、使用 web profile 安裝插件（命令來自官方 README）：
dsh plugin --profile web add github:HZDF-2026/dsh-compaction-ctxfold
2、在 profile 的 cordis.patch.yml 中禁用內置後端：
- id: compaction-basic
name: "@deepseek-ai/dsh-compaction-basic"
disabled: true
插件通過 cordis.patch.yml 注入 bundle patch；package.json 聲明對 @deepseek-ai/dsh-compaction-basic 的 peer 依賴（>=0.0.1-rc.3）。當前包版本爲 1.0.0，許可證 MIT。
驗證¶
倉庫提供離線測試入口，覆蓋 peer 攔截、宿主類加載、引擎契約、錨點保真與字節確定性（README 說明已用 app.asar 內真實 profile-resolution bootstrap 驗證）：
node test.mjs
也可通過 npm script：
npm test
（等價於 node test.mjs。）
適用場景與注意¶
適合誰： 需要在長會話中保留路徑、數字、命令、配置鍵等「硬事實」、且希望壓縮結果可復現、可 diff 的 DSH 用戶；希望 compaction 階段不消耗 LLM token 的場景。
注意：
- 插件以當前 dsh 進程權限 運行；安裝前請自行閱讀 源碼 與 MIT 許可證，確認行爲符合你的安全與合規要求。
- 社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文介紹的是社區維護的 compaction 後端，非內置默認路徑。
- 本插件只替換
summarize()；觸發閾值、保留尾部、tool-pairing 平衡校驗、durable 提交等仍走BasicCompactionEngine原實現。
結尾¶
dsh-compaction-ctxfold 把 DSH 上下文壓縮的摘要器從「模型轉述」換成 ctxfold 規則管線：零 LLM 調用、毫秒級、字節級可復現，並用 Verbatim Anchors 保留逐字事實。若你在用 DSH 做長鏈路智能體開發，且受困於摘要丟事實或結果不穩定，可按上文安裝命令啓用，並用 node test.mjs 在本地核對行爲。
