前言¶
在 DSH 里長時間對話後，上下文會不斷變長：早期輪次仍佔模型窗口，又未必每次都需要逐字保留。整段清空或只靠記憶類插件，有時要麼丟細節，要麼不好精確到「這一段」。compact-region（局部壓縮）面向的是另一類需求：選定對話裏連續的一段顯輪次，用當前會話模型生成可編輯摘要，再以檢查點卡片替換該區間；原文仍留在會話日誌，但不再進入後續普通對話與模型上下文。
下面介紹該插件的定位、能力與在 DSH 中的安裝與使用方式。事實以 GitHub 倉庫 README 爲準；維護者爲 Asdika-36086，社區目錄分類爲「記憶」，插件版本爲 0.2.0，許可證 MIT。
這是什麼¶
compact-region 是 DSH 的 Web Client 插件，以組合包（bundle）方式分發：package.json 中 dsh.bundle.patch 指向 cordis.patch.yml，dsh.client 聲明客戶端入口。一句話：把用戶選中的連續顯輪次總結成一張檢查點卡片，應用後卡片留在上下文中，被替換的原文仍可在存檔中查看。
開發與測試環境爲 DSH 0.2.x；其他版本未在資料中驗證。插件在 DSH 進程內運行，安裝前建議瀏覽源碼與 LICENSE，並按自身環境評估模型調用時的數據與隱私策略。
核心功能¶
資料中可覈實的能力如下：
- 區間選擇：在普通輪次旁進入選擇模式，用連續顯輪次（含普通輪次與已有檢查點卡片）劃定範圍；不能只單獨選一個檢查點卡片，再次壓縮需與相鄰輪次一併選中。
- 模型摘要：用當前會話所選模型，基於截至所選範圍結束位置的可見上下文生成摘要，並展示可編輯預覽。
- 應用或放棄：預覽後可「應用」（用檢查點卡片替換區間）、「重新生成」或「取消」；應用前可人工修改摘要。
- 存檔與查看：被替換內容不刪會話日誌事件；可通過卡片展開摘要，或通過「查看對話記錄」在右側面板瀏覽原文。
- 多語言：隨插件提供中文與 English；可在「插件 → 局部壓縮」卡片上切換；自定義語言 JSON 可放在
<DSH 主目錄>/compact-region/langs/。
已知限制（README 明確寫出）：以完整顯輪次爲選擇單位，不支持任意消息級切割；摘要由模型生成，不能保證完整準確；正在運行的輪次不能壓縮；隱藏展示依賴客戶端 DOM，可能影響滾動與定位。
安裝與啓用¶
本插件需通過 DSH 插件管理器安裝，不要手動複製文件。要求：DSH 自帶插件頁且支持 Web Client 插件。
方式一：Web 界面（推薦）¶
- 打開 DSH，進入左側 插件 頁。
- 在安裝輸入框填入倉庫地址或本地插件目錄絕對路徑，例如：
https://github.com/Asdika-36086/compact-region
- 確認安裝並等待依賴完成，在列表中啓用
compact-region。 - 若界面未出現壓縮按鈕，重啓一次 DSH。
方式二：命令行¶
先確認當前 DSH CLI 是否支持 install：
dsh plugin --help
若幫助信息中包含 install，再執行：
dsh plugin install https://github.com/Asdika-36086/compact-region
否則使用 Web 界面方式。
驗證¶
打開任意對話，鼠標移到普通輪次上，旁側應出現 ⤵ 壓縮。若無，檢查插件頁中是否已啓用。
典型用法¶
按 README 中的可復現流程操作：
- 打開要整理的對話，並確保會話已選擇可用模型。
- 在某個普通輪次旁點擊 ⤵ 壓縮，從該輪次進入選擇模式。
- 點擊輪次或壓縮卡片選擇連續範圍；點擊範圍外輪次會擴展中間選中項；再次點擊可取消單項。
- 在選擇面板上點擊 壓縮，等待當前模型生成摘要並查看預覽。
- 覈對或編輯摘要後選擇 應用、重新生成 或 取消。
選擇模式中按 Esc 或點 取消 可退出。壓縮完成後可展開卡片查看摘要；重要事實、路徑、命令和待辦請在應用前人工覈對。
適用場景與注意¶
適合誰：需要在長會話中保留結論、又想把中間過程從模型上下文中「收起來」的 DSH 用戶；希望用檢查點串聯、並可隨時回看原文存檔的開發者。
使用注意：
- 應用檢查點會追加替換事件，被選區間不再進入後續模型上下文；生成摘要時會向當前模型服務發送截至範圍結束處的可見上下文，請按服務商隱私政策評估內容。
- 未激活的舊會話可讀輪次與存檔；生成摘要與應用檢查點要求會話處於激活狀態。
- 插件以 DSH 當前進程權限運行；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
開發側可在插件目錄用 Node.js（engines.node >= 22.19.0）運行 npm test，測試不啓動 DSH、不調用真實模型。
結尾¶
compact-region 把「局部總結 + 檢查點替換」做成對話內的顯式操作：連續輪次可選、摘要可編、原文可存檔。適合在 DSH 0.2.x 環境中做上下文治理時按需壓縮中間段落，而不是整會話一刀切。
- 社區目錄：https://www.skillhub.cn/plugins/Asdika-36086/compact-region
- 源碼與文檔：https://github.com/Asdika-36086/compact-region
