前言¶
在 DeepSeek Harness（DSH）裏連接 WorkBuddy 或 Trae 時，各模型有各自的上下文窗口上限。自動壓縮何時觸發，部分取決於 DSH 向側報告、協商的「廣告窗口」——這與上游服務實際按請求提供的窗口不一定相同。Qoder CN 連接器已在自有 Settings 中提供按模型調節；WorkBuddy 與 Trae 若缺少同等入口，只能在配置裏手工改 contextBudgets，既難對照當前模型列表，也難確認寫入是否生效。dsh-context-windows 是社區維護的客戶端插件，在 Settings → 模型上下文窗口 / Model Context Windows 集中列出已連接區域的模型，併爲每個模型提供下拉選擇與回寫驗證。
這是什麼¶
- 名稱：dsh-context-windows（倉庫 SoulZhou/dsh-context-windows）
- 維護者：SoulZhou
- 分類：模型推理（社區目錄歸類）
- 定位：DSH 客戶端插件，爲 WorkBuddy 與 Trae 連接器補齊與 Qoder CN 同類的「按模型可視化調節上下文預算」能力；Qoder CN 仍使用其內置 Settings 頁，本插件不覆蓋。
插件通過 Host 的 settings 服務讀寫連接器已有的 contextBudgets 字段，變更在 applyContextBudgets 中實際生效；每次寫入後會重新拉取模型名冊，用對外展示的 effective window 證明配置已 round-trip。
核心功能¶
統一設置頁¶
在同一 Settings 分區中列出各已連接 WorkBuddy / Trae 區域下的模型。對每個模型提供 <select>，可選多種 context-window 檔位，並含 default / follow upstream（清除覆蓋、跟隨上游默認）。
與 Host 配置聯動¶
Host 側（index.js）提供與 settings.section 無關的 loopback 路由：
GET /plugins/dsh-context-windows/state：讀取狀態POST /plugins/dsh-context-windows/set：經settings.describe()/settings.mutate()讀寫regions[panel].contextBudgets
客戶端（client.js）註冊 settings.section 頁面並渲染控件；模型列表來自各連接器既有路由：
- WorkBuddy：
/plugins/dsh-connect-workbuddy/usage?region=cn|global - Trae：
/plugins/dsh-connect-trae/usage?region=cn|enterprise|ai&detail=fast
界面與本地化¶
通過 Host locale 服務支持中英文（locale/zh.json、locale/en.json）；使用既有 theme token，併爲玻璃主題自繪不透明背景以保證可讀性。
行爲邊界（插件 UI 中會說明）¶
預算只改變 DSH 爲模型廣告的上下文窗口，從而影響 自動壓縮時機；不會改變上游服務在單次請求中實際提供的窗口。
| 連接器 | 行爲要點 |
|---|---|
| WorkBuddy | 使用 Math.min(native, budget)：不大於原生窗口的正數預算均可生效，頁面提供分級「下調」階梯。 |
| Trae | 僅接受其聲明的階梯（dev / 500K（當 Max >= 500K）/ Max）。未聲明 Max 的模型僅有一個選項，界面爲 只讀，不提供無效控件。 |
| Qoder CN | 仍使用自帶 Settings，本插件不介入。 |
安裝與啓用¶
插件以 DSH CLI 加入 desktop profile。完整退出並重新打開 DSH 桌面應用後 Host 半端纔會加載；僅 Ctrl+R 只重載渲染進程，不足以加載 Host 變更。安裝與備份細節可參考 DSH 文檔中的 dsh-client-plugin skill。
本地路徑安裝：
dsh plugin --profile desktop add D:\path\to\dsh-context-windows
從 GitHub 安裝已發佈包：
dsh plugin --profile desktop add github:SoulZhou/dsh-context-windows
當前公開版本爲 1.0.1（MIT 許可證）。package.json 聲明 engines.node 爲 ^22.19.0 || >=24.0.0。
安裝完成後，打開 Settings → 模型上下文窗口 / Model Context Windows，即可按區域、按模型調整預算。
典型用法¶
- 確認已通過對應連接器插件連接 WorkBuddy 或 Trae（本插件依賴上述
usage路由返回的模型名冊）。 - 進入 Settings 中的模型上下文窗口頁面，在列表中爲某一模型選擇目標窗口或「跟隨上游 / 默認」。
- 保存後觀察頁面是否重新拉取名冊：effective（廣告）窗口應反映剛纔的選擇。
- 若希望 WorkBuddy 在原生窗口以內「壓低」廣告窗口以更早觸發壓縮，在 WorkBuddy 模型行選擇低於 native 的檔位；Trae 僅在模型暴露合法階梯時出現可編輯下拉框。
適用場景與注意¶
適合誰：長期在 DSH 桌面端使用 WorkBuddy 或 Trae，需要按模型微調 DSH 側 context budget、又不想直接手改 profile 裏 contextBudgets 結構的開發者。
權限與安全：DSH 插件在當前 dsh 進程權限下運行；安裝前宜自行審閱倉庫源碼與 LICENSE（MIT），社區目錄 skillhub.cn 插件頁 與 GitHub 無 DeepSeek / 幻方官方從屬關係，屬社區生態分發。
依賴：客戶端側依賴 @deepseek-ai/dsh-client-ui-settings、@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-slots 等 Host 注入模塊（見 package.json 的 dsh.client.inject 與 peerDependencies）。
結尾¶
dsh-context-windows 把 WorkBuddy、Trae 的 per-model 上下文預算調節收攏到一處可視化 Settings 頁，並與 contextBudgets、applyContextBudgets 對齊，同時寫清楚「只改廣告窗口、不改上游真實窗口」的限制。進一步瞭解與安裝見社區目錄 https://www.skillhub.cn/plugins/SoulZhou/dsh-context-windows 與源碼倉庫 https://github.com/SoulZhou/dsh-context-windows。
