DeepSeek Harness (DSH) 採用插件化架構。默認配置可能無法滿足所有場景需求。dsh-malko-prefs 是一個個人偏好配置，作爲官方壓縮引擎的可調伴侶，爲模型頁面豐富 llama.cpp 元數據，並提供標籤頁狀態指示器。
插件介紹¶
這是一個爲 DeepSeek Harness (DSH) 提供個人偏好的插件，由 malko 維護。它主要解決三個具體問題：提供比官方引擎更靈活的壓縮控制、補充 llama.cpp 模型元數據以完善 Models 頁面、以及通過標籤頁顏色和瀏覽器通知提供會話狀態反饋。
核心功能¶
壓縮引擎增強¶
官方的 @deepseek-ai/dsh-compaction-basic 引擎是參考行爲。此插件將其包裝在一個設置頁面中，允許你調整以下參數：
* 閾值：支持絕對 Token 數（如 130k）或相對於上下文窗口的比例（如 0.8）。
* 保留策略：配置保留最近上下文的絕對 Token 數或比例。
* 摘要配置：選擇摘要模型（默認使用 Session 模型或自定義模型），並設置推理級別。
* 行爲控制：開啓“回合結束壓縮”，並在摘要輸出上限、額外壓縮嘗試等高級選項中進行微調。
* 命令：新增 /force-compact 命令用於手動觸發壓縮。
llama.cpp 模型豐富¶
插件讀取 llama.cpp 服務器暴露的豐富模型元數據（如 meta.n_ctx、architecture.input_modalities、aliases），並將其填充到 llm-pi-ai 的模型條目中，自動填充上下文窗口和文本/圖像輸入模態性信息。
通知與標籤頁指示器¶
- 標籤頁狀態燈：瀏覽器標籤頁圖標顏色會根據會話狀態變化：
- 琥珀色：會話等待你處理（提問/審批）。
- 藍色：會話正在運行。
- 綠色：主會話在你離開時已完成。
- 系統通知：瀏覽器通知功能，支持不同類型（會話完成、等待中）獨立開關、屏幕停留時間設置及音效。
安裝與啓用¶
通過 DSH 官方註冊表安裝：
dsh plugin --profile web add dsh-malko-prefs
安裝後，重啓 dsh web 即可生效。
典型用法¶
- 手動壓縮：在聊天界面直接輸入
/force-compact強制執行壓縮。 - 導入模型：進入插件設置中的“llama.cpp models”標籤頁，點擊“Fetch from server”讀取服務器模型列表，勾選需要導入的模型並點擊“Import”。
注意事項¶
- 版本要求：需要 DSH 版本
>= 0.1.7-rc.1。 - 依賴：需要可用的
llm-pi-ai提供者（例如你的 llama.cpp 服務器）以支持模型豐富功能。 - 預設覆蓋：插件會重述所有內置的代理預設（
preset-cordis,preset-ptc,preset-standard），將其壓縮後端指向dsh-malko-prefs/compaction。 - 生成文件：補丁文件（
cordis.patch.yml）由腳本自動生成，非手寫，因此代碼邏輯可能較爲緊湊。 - 風險提示：插件以當前 DSH 進程權限運行，使用前請檢查源碼，注意潛在的安全風險。
總結¶
dsh-malko-prefs 旨在爲 DSH 用戶提供一個更精細的控制面板，特別是針對上下文壓縮和模型元數據管理。它通過 MIT 許可證開源，適合希望深入定製代理行爲和監控會話狀態的進階用戶。
