DeepSeek Harness (DSH) 生態允許通過插件擴展功能。上下文窗口管理是智能體開發中的常見痛點，特別是當壓縮策略導致重複操作和額外的 token 消耗時。dsh-toolong-warning 插件旨在解決這一問題，它不主動打擾，只在對話變得不經濟時發出提示。
插件簡介¶
這是一個由 Hjdd14 維護的 DSH 客戶端插件。它統計每個會話中被壓縮的次數，並在界面上實時顯示計數。只有當壓縮發生得較爲頻繁，且在此後消耗了大量額外 token 時，插件纔會發出警告。
插件使用手寫 JavaScript，無構建步驟。它提供可拖動的浮動窗口，支持中英文雙語切換，且默認傾向於保持靜默，避免“狼來了”效應。
核心功能¶
- 壓縮計數展示：在浮動窗口中持久顯示每個對話的壓縮次數。
- 智能觸發機制：僅在滿足特定條件時發出警告。只有當壓縮次數達到閾值、且在最後一次壓縮後消耗了額外大量 token 時，纔會觸發警告。
- 界面交互：支持中/英雙語切換，點擊“Got it”僅隱藏當前提醒卡片，計數器繼續更新。
- 浮動窗口：窗口可拖動，不會與其他插件爭奪屏幕空間。
安裝與啓用¶
先決條件：
* dsh 版本 >= 0.1.7-rc.1
* Node.js 版本 >= 22.19
* 需要一個支持瀏覽器客戶端的配置文件（web 或 desktop）
安裝步驟：
- 在終端中執行以下命令安裝插件：
dsh plugin --profile web add @hjdd14/dsh-toolong-warning
- 插件安裝後，配置值會寫入配置文件的 cordis 補丁中，並在加載後立即生效。
典型用法¶
- 語言切換：在 DSH 的設置頁面找到該插件對應的區域，切換界面語言（中文/英文）。
- 閾值調整：在插件設置中，可以調整
compactCountMin（最小壓縮次數）、occupancyPercentMin（最小上下文佔用率）和tokensSinceCompactionMin（最小額外 token 消耗）等參數。 - 查看提醒：當對話出現重複壓縮且消耗了高額額外 token 時，頂部會彈出警告卡片，顯示當前的上下文佔用率和自上次壓縮以來的 token 消耗量。
適用場景與注意¶
- 適用場景：適合需要精細管理上下文窗口、頻繁進行壓縮操作的開發者。它可以幫助開發者識別哪些對話正在變得不經濟。
- 靜默機制：如果缺少使用數據，或者路由未聲明上下文窗口，插件將保持靜默。如果從未壓縮過、壓縮次數不足或額外 token 消耗未達閾值，插件也不會發出警告。
- 禁用狀態：當插件被禁用或未打開任何對話時，不會顯示任何內容。
- 安全建議：安裝前建議檢查源碼與許可證（MIT）。
總結¶
dsh-toolong-warning 提供了一種非侵入式的監控方式，幫助開發者平衡上下文管理與成本。它通過計數和閾值判斷，在對話變得不值得繼續時給予提示，否則保持安靜。
