MIT 授權的 DeepSeek Harness 內容脈絡壓縮外掛程式,是 dsh-context-compression-selector 的改良分支,新增預設關閉的程式碼骨架閘、可選壓縮策略與可稽核的省 token 統計,透過 `dsh plugin add` 安裝進 dsh profile。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-15
授權條款
MIT
01它能幫你完成什麼?
讓長時間執行的 DeepSeek Harness 工作階段不超出內容脈絡預算——把持續累積的工具結果壓縮掉
依所選、可稽核的策略(Fresh / Aggregate / History micro-compact / TailTrim / Native)產出的更短工具結果內容脈絡,並為每次裁減記錄階段、reducer、觸發條件、略過原因與精確 token 數
需要跑長程多輪編碼工作的 DSH 使用者:工具輸出越滾越大,最後先把內容脈絡視窗撐爆
把首次出現的超大原始碼工具結果壓成「匯入 + 宣告」骨架,而不是直接砍掉開頭
保留 import 與型別 / 函式 / 類別宣告、函式本體以標記省略、被省略本體裡的錯誤行仍然保留的骨架結果
常用 `read_file` 這類工具讀取大型原始碼檔案、單一結果就吃滿內容脈絡視窗的團隊
02如何將外掛接入 DeepSeek Harness?
先決條件
- Node `^22.19.0 || >=24` 與 pnpm `11.7.0`(README 明列的要求)
- 一個出現在產生式支援清單中的 DeepSeek Harness rc 版本——涵蓋 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 / 0.2.1 七條線、共 21 個 rc 發行版
- 僅支援 DeepSeek 模型:無損量測與有損壓縮都依賴隨套件內建的官方 DeepSeek tokenizer
安裝步驟
- 01
在目標 Harness profile 裡從 npm 安裝:`dsh plugin --profile web add dsh-context-compression-improved@latest`(README 的建議路徑,一個版本涵蓋全部支援的 Harness 版本線)
$ dsh plugin --profile web add dsh-context-compression-improved@latest
- 02
用 `dsh --profile web --dump-config` 印出該 profile 的設定
$ dsh --profile web --dump-config
- 03
原始碼建置替代方案:`git clone https://github.com/drscrewdriver/dsh-context-compression-improved.git`,再執行 `pnpm install --frozen-lockfile` 與 `pnpm build`,然後打包 selector 套件並加入 Harness profile
$ git clone https://github.com/drscrewdriver/dsh-context-compression-improved.git
- 04
在外掛程式的設定區選擇壓縮策略、設定 Auto Compact 觸發等級,並視需要開啟程式碼骨架壓縮開關(出廠預設 `codeSkeleton: { enabled: false }`)
驗證整合成功
- 安裝後執行 `dsh --profile web --dump-config`(README 緊接安裝指令給出的指令),檢查印出的 profile 設定中是否列出 `dsh-context-compression-improved`
- 設定中的開關隨改隨存,重新載入後仍顯示已儲存的狀態
- 依儲存庫安裝指南 `docs/installation.md` 的驗證步驟逐項確認(README 指向其中的 verification 與 uninstall 步驟)
復原
- 解除安裝步驟寫在儲存庫安裝指南 `docs/installation.md` 中
- 刪除 `~/.dsh/storages/dsh-context-compression/stats.sqlite` 即可把持久化統計完全重設
03DSH 整合程度與能力邊界
以 `dsh plugin --profile web add …` 安裝進 dsh profile 的 DeepSeek Harness 外掛程式;只呼叫公開的 plugin / profile API,不修改 Harness 核心程式碼
程式碼骨架壓縮閘(code skeleton gate)
過大的全新原始碼工具結果(例如一次大的 `read_file`)→由 import 與型別 / 函式 / 類別宣告組成的骨架,函式本體以標記省略,被省略本體裡的錯誤行保留
預設關閉——`codeSkeleton: { enabled: false }`,需要手動開啟骨架產生或驗證失敗時退回原本的開頭裁減壓縮策略(profiles)
全新與累積的工具結果內容脈絡→預先壓縮的全新片段、二次壓縮的彙總內容、被取代的舊歷史結果,以及選用的 TailTrim 與 Harness 風格的 Native 裁減
可稽核的決策記錄
外掛程式做出的每一個壓縮決策→階段、reducer、觸發條件、略過原因,以及可取得時的精確 token 數
壓縮監控面板與 `/ccip` 指令
正在執行壓縮的工作階段→淨 / 毛節省量、位移、內容脈絡用量、快取命中率與成本估計,緊鄰工作階段的內容脈絡趨勢圖
`/ccip` 可依工作階段回復或關閉壓縮(`session <id|latest|off>`)SQLite 統計持久化
壓縮決策與請求邊界→跨主機重新啟動保留的存量、累計與節省金額三項統計,歷史工作階段從磁碟行為記錄回填
寫入 `~/.dsh/storages/dsh-context-compression/stats.sqlite`;驅動程式缺少或寫入失敗會退化為記憶體備援記錄中只有計數、序號、工作階段識別與列舉元件名稱,原始文字與自由文字不會進入資料庫
04適合誰?何時不該用?
適合
- 需要跑長程多輪編碼工作的 DSH 使用者:工具輸出越滾越大,最後先把內容脈絡視窗撐爆
- 常用 `read_file` 這類工具讀取大型原始碼檔案、單一結果就吃滿內容脈絡視窗的團隊
不適合
- 僅支援 DeepSeek 模型:無損量測與有損壓縮依賴隨套件內建的官方 DeepSeek tokenizer(`deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp`),其他情況一律 fail-open,保留原始工具結果。
- 程式碼骨架閘受量測條件限制:必須取得精確的 DeepSeek tokenizer,取不到就 fail-open,不做壓縮。
- 設定是工作階段凍結的:與所有 selector 設定一樣,變更只影響之後新觀測到的工作階段,執行中的工作階段沿用舊設定。
- `codeSkeleton` 必須嚴格是 `{ enabled: boolean }`;格式不對時執行環境會拋錯,瀏覽器介面中顯示為無法讀取。
- README 建議使用自建 OpenAI 相容的 `/v1/responses` 端點,而不是官方帳號的 Messages API 路由——後者的續接重播 400 無法從外掛程式端修復。
05相容性、維護與安全提醒
- 僅支援 DeepSeek 模型:無損量測與有損壓縮依賴隨套件內建的官方 DeepSeek tokenizer(`deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp`),其他情況一律 fail-open,保留原始工具結果。
- 程式碼骨架閘受量測條件限制:必須取得精確的 DeepSeek tokenizer,取不到就 fail-open,不做壓縮。
- 設定是工作階段凍結的:與所有 selector 設定一樣,變更只影響之後新觀測到的工作階段,執行中的工作階段沿用舊設定。
- `codeSkeleton` 必須嚴格是 `{ enabled: boolean }`;格式不對時執行環境會拋錯,瀏覽器介面中顯示為無法讀取。
- README 建議使用自建 OpenAI 相容的 `/v1/responses` 端點,而不是官方帳號的 Messages API 路由——後者的續接重播 400 無法從外掛程式端修復。
- 原始碼建置與開發流程要求 Node `^22.19.0 || >=24` 與 pnpm `11.7.0`。
- 這是 WilliamShi666/dsh-context-compression-selector 的非官方社群分支,與 DeepSeek 無隸屬關係、也未獲其背書;MIT 下保留上游著作權聲明。
MIT · latest release v0.11.2 (2026-11-14T17:14:44Z)
06常見問題
開啟程式碼骨架閘會不會改變我已經選好的壓縮策略?
不會。它和策略是正交的:`balanced`、`savings`、`cache-strict`、`adaptive`、`custom`、`off`、`native` 全都能用這道閘,而且預設關閉,把 `codeSkeleton.enabled` 設成 true 之前不會有任何變化。
換成非 DeepSeek 模型還能用嗎?
不能。本專案僅支援 DeepSeek 模型:無損量測與有損壓縮依賴隨套件內建的官方 DeepSeek tokenizer,其他情況一律 fail-open,保留原始工具結果。
骨架化會不會反而讓內容脈絡更糟?
README 明確說不會:骨架產生或驗證失敗就退回原本的開頭裁減,這道閘永遠不會讓內容脈絡變差。
改了設定,目前執行中的工作階段會立刻生效嗎?
不會。與所有 selector 設定一樣是工作階段凍結的,變更只影響之後新觀測到的工作階段。
省下的 token 統計存在哪裡、記了哪些東西?
存在 SQLite:`~/.dsh/storages/dsh-context-compression/stats.sqlite`,跨主機重新啟動保留,刪除檔案即完全重設。記錄中只有計數、序號、工作階段識別與列舉元件名稱,原始文字與自由文字從不進入資料庫。
07相關的 DSH 工作流程
dsh-univer-office
作者 dream-num
在 DSH 內預覽、建立與編輯表格、文件和幻燈片,由 Univer 驅動
clearai-dsh
作者 clearailhc
ClearAI:以本體為綱的原生 DSH 外掛 —— 經證據核驗的研究長成可瀏覽的領域本體。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 魚的記憶:給會話一份會淡忘的長期記憶,每條都帶時間。名字裡的「魚」來自 DeepSeek 的鯨魚。
dsh-trading
作者 zhu1090093659
基於 DeepSeek Harness 的智慧體原生交易終端,三欄介面聚合幣圈、美股、A股與港股,內建 19+ 可熱插拔聯結器,預設模擬交易並需人工確認。
08資料與來源
The plugin uses only public Harness extension APIs and does not modify Harness core code.
- Built and tested against the official DeepSeek Harness releases; peers declare the full supported-hosts enum
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
