返回目錄

dsh-context-compression-improved

精選清單收錄維護狀態: 活躍

drscrewdriver/dsh-context-compression-improved

改進版 dsh-context-compression-selector,增加正交的程式碼骨架壓縮門控,幫助 DSH 在壓縮上下文時保留更有用的程式碼結構資訊。

前往 GitHub
$ dsh plugin --profile web add dsh-context-compression-improved@latest

11

星數

1

Fork

TypeScript

語言

MIT

授權條款

2026-09-05

建立於

2026-11-20

最近推送

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

安裝步驟

  1. 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

  2. 02

    用 `dsh --profile web --dump-config` 印出該 profile 的設定

    $ dsh --profile web --dump-config

  3. 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

  4. 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 整合原生執行環境

以 `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 下保留上游著作權聲明。
2026-09-052026-11-10v0.11.2

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`,跨主機重新啟動保留,刪除檔案即完全重設。記錄中只有計數、序號、工作階段識別與列舉元件名稱,原始文字與自由文字從不進入資料庫。

08資料與來源

  • 作者聲明github.com82703d80c522…

    The plugin uses only public Harness extension APIs and does not modify Harness core code.

  • 作者聲明github.com82703d80c522…

    - Built and tested against the official DeepSeek Harness releases; peers declare the full supported-hosts enum

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。