前言¶
在 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。
