dsh-live-model-probe

使用

1. 先在官方「模型」页配置凭据或登录。插件没有 API key / token 输入框。
2. 打开「设置 → 模型探测」。普通 API 路由可查询，Codex 只有状态及手填区。
3. 查询不写配置。对兼容代理改地址会先提示是否向该地址发送当前路由的凭据；仅本次查询生效，不保存地址。
4. 勾选模型，或「载入勾选结果并修订」。手填区默认载入当前声明，支持 ID、名称、上下文、输出上限和 text/image 输入模态。数值必须是正整数；未知时留空。
5. 点「预览写入」，检查新增、移除、完整前后模型字段和来源。采用是整体替换该路由列表，不是自动追加；要保留的旧模型必须仍在列表内。
6. 再点「确认写入 profile」并确认弹窗。预览五分钟有效，单次使用；换选择、改手填内容或配置版本变化后需重新预览。
7. 「恢复内置目录」删除显式 models 键，绝不写成空数组；「查看模型备份」可预览并确认恢复目标路由的旧模型字段。

Codex 状态只区分缺记录、结构不支持、记录过期、读取失败或本地记录看似有效。看似有效不等于在线授权或推理权限有效。过期/缺记录请到官方「模型 → OpenAI Codex」重新登录；插件不刷新、不修改、也不发送 OAuth access/refresh token 或 account ID。

配置与安全边界

• Host 唯一写入入口为官方 configEditor.edit，锁内再次核对 revision；不自行拼接 YAML，不旁路写 profile。
• 仅改 llm-pi-ai 目标 provider 的 models / modelOverrides。采用显式列表时会先在预览中提示清除不兼容的旧 overrides，并将其备份。默认模型、其他路由、地址、凭据引用不变。
• 备份在 profile 的 .model-probe-backups 目录，只保存目标路由的白名单模型字段，不复制整份 YAML 或凭据。全局保留最近五份合法备份；成功和失败写入都尝试轮换。磁盘清理失败会明确提示，可能暂时超过五份；无关/损坏文件不擅自删除。
• 备份创建失败则不调用官方编辑器。备份含无法安全、无损保存的额外字段时拒绝写入，而不是静默截断。
• API key 仅在 Host 读取并发给用户确认的目标服务；禁用重定向，错误不回显响应正文、请求头或底层异常。已知本次 key 若被厂商回显到可展示字段则拒绝返回；这不构成任意编码/任意第三方敏感内容的 DLP 保证。
• 默认只允许 HTTPS；HTTP 仅允许 localhost、127.0.0.1、[::1]。地址禁止用户名、密码、查询参数和 fragment。用户仍须自行确认 HTTPS 自定义服务可信；不是全面的网络隔离/SSRF 沙箱。
• 默认 20 秒超时；响应及单份备份最大 4 MiB；列表最多 10000 项；支持取消和卸载释放。不自动刷新、不后台轮询。
• OpenRouter 参数补全默认关闭；开启后发独立匿名请求，不携带当前厂商 key，不上传模型列表或提示词；只在 Host 用精确 ID 对照，失败保留原厂商结果。
• Client/Host 协议版本不一致及 404/405 有完整重启提示。配置保存与热更新验证分别报告；保存成功后核对失败不会谎报“未保存”。