上下文窗口选择器 luyiheng1111/dsh-context-window-picker

上下文窗口选择器 · dsh-context-window-picker

在 DSH 的模型选择弹窗里，为当前会话临时切换上下文窗口大小（contextWindow），和「模型」「推理等级」并列成独立一行；新建会话自动恢复 Profile 默认值。

对标 WorkBuddy：模型详情面板中「思考强度」+「上下文窗口」两个配置项并列，会话级临时生效。

模型弹窗中的上下文窗口行

展开后的档位列表

安装

git clone https://github.com/luyiheng1111/dsh-context-window-picker.git

然后在 DSH 的 Plugins 页面里用本地目录安装（Install from path / 本地 bundle）指向刚 clone 的目录，或在终端：

dsh plugin --profile desktop add /path/to/dsh-context-window-picker

安装后重启 DSH 即可。插件没有构建步骤、没有运行时依赖（React 由宿主提供），默认走 bundle patch 里的 presets/completionRatio 等默认值，无需任何配置。

交互

1. 打开输入框右侧的模型选择弹窗（或 /model）。
2. 弹窗面板里「模型」「推理等级」下方多出独立的一行 —— 上下文窗口 256K ›，右侧显示的是当前生效窗口；被本会话覆盖时该数字变为品牌色高亮。
3. 点这一行展开档位列表，选一个即可即时生效：
- 默认（跟随模型）
- 128K / 256K / 512K 等（只列出不超过当前模型默认窗口的档位；选中与默认相同的档位等同于回到「默认」）
4. 选择后立即写入当前会话，再发一条消息，request/context 事件里的上下文窗口即为新值。
5. 新建会话不携带该选择，自动回到适配器目录里的默认窗口。

因为这一行是渲染在弹窗面板内部的，点击它和它的档位列表都不会把弹窗关掉，可以像原生配置项一样反复切换。

为什么不是「改 Profile 配置」

defaultContextWindow 是适配器目录（llm-pi-ai.providers.*.models[].contextWindow / llm-deepseek）的全局值，改它会影响所有会话。本插件只在宿主内存里按 sessionId 记录覆盖值，不写任何配置文件，也不写会话日志（不污染 session log）。

实现要点

- 宿主半 在 llm 服务的原型上包装两个公开方法（插件卸载时精确还原）：
- llm.prepareCall(config, signal, configure)：通过官方 configure 回调收紧 maxTokens，并在返回的冻结调用对象上把 context.contextWindow 换成会话覆盖值。
这一步保证 request/context 事件、token 计量、压缩阈值看到的是同一个窗口。
- llm.resolveModelInfo(provider, model)：compaction-basic 通过它取窗口，所以压缩压力判断同样使用会话覆盖值。
- Session#requestHeader 在覆盖生效期间夹紧 config.maxTokens，避免压缩策略拿旧的 256K 完成预留去比新的小窗口而直接抛错。
- 客户端半 不替换原生模型选择组件，而是通过 conversation.input.model.label 槽位在弹窗里追加一行：用一个隐藏锚点向上找到持有 role="menuitem" 单元格的面板容器，再用 ReactDOM.createPortal 把这一行插到最后一个单元格之后。
这样这一行天然属于弹窗内部，原来的「点击外部即关闭」判定不会在点击中途把弹窗卸掉。
该槽位同时负责输入框上的模型名，所以其余放置处（trigger / option）仍原样渲染模型名。
- 客户端与宿主之间走本机回环 JSON 接口： GET /dsh-context-window-picker/api/{state,health}、POST /dsh-context-window-picker/api/set，请求校验 Host 为回环地址、拒绝 sec-fetch-site: cross-site 与非同源 Origin。

配置（bundle patch 里可改）

| 键 | 默认 | 说明 |
| presets | [131072, 262144, 524288, 1048576] | 候选窗口（只显示不超过模型默认值的） |
| completionRatio | 0.25 | 单次输出上限 ≤ 窗口 × 该比例 |
| headroomTokens | 65536 | 与压缩策略的 headroom 对齐，保证压缩不会因预留不足报错 |
| minimumWindow | 131072 | 最小可选窗口；低于它的模型只显示「默认」 |

文件

- index.js — 宿主插件（llm 拦截、按会话覆盖、回环 API）
- client.js — 客户端 UI（模型弹窗内的上下文窗口行与档位面板）
- cordis.patch.yml — bundle patch，插入宿主插件行
- locale/{zh,en}.json — 插件管理器 / 市场展示元数据
- icon.svg — 插件图标

已验证

- 宿主：GET /dsh-context-window-picker/api/health 返回 patch 计数；把某会话设为 262144 后，下一个请求的 request/context 事件记录 contextWindow: 262144，request/header.maxTokens 从 256000 收紧到 65536（压缩压力判断不再抛 leaving no message budget）。
- 客户端：刷新页面后，模型弹窗内「推理等级」下方出现独立的「上下文窗口」行，模型名显示正常；点开可切换档位，切换后该行数字即时更新。

修改 index.js 需要重启 DSH 才会重新加载宿主半边；只改 client.js 刷新页面即可。

安全说明

宿主侧通过包装 llm 服务原型的方法（prepareCall / resolveModelInfo）和 Session#requestHeader 来施加覆盖——DSH 目前没有官方接口，无法按会话修改上下文窗口。
插件卸载时，这些包装会精确还原。所有对客户端暴露的接口都是本机回环 JSON：

| 路径 | 方法 | 用途 |
| /dsh-context-window-picker/api/state | GET | 读取当前会话的基准窗口 / 覆盖值 / 候选档位 |
| /dsh-context-window-picker/api/set | POST | 设置或（传 null）清除本会话覆盖 |
| /dsh-context-window-picker/api/health | GET | patch 计数与当前配置（诊断用） |

请求会被校验：Host 必须是回环地址或 webRuntime.trustedHosts 中的授权域，拒绝 sec-fetch-site: cross-site，且 Origin 必须缺失、为 dsh-app://app 或与 Host 同源。

已知限制

- 候选档位只显示不超过模型基准窗口的值（放大窗口属于模型/配置档层面的能力）。
- 覆盖只影响之后发出的请求；正在执行的 step 保持它启动时的窗口。
- 客户端侧影子注册了已发布的 conversation.input.model.label 槽位（replaceRisk: shadows-shipped-ui），若官方以后改动模型弹窗的面板结构，插件需要相应调整行容器的定位方式。
- 输入框上的模型按钮不再追加窗口后缀；窗口只在弹窗内展示。

许可

MIT © 2026 luyiheng1111