前言¶
在 DeepSeek Harness（DSH）里给某个提供商配置模型时，常见路径是「设置 → 模型 → 获取可用模型」：从静态配置和内置目录里勾选、搜索，再保存进当前 profile。厂商侧模型 ID 和推理相关能力会更新，若列表长期停留在本地静态数据，容易出现「配置里写的模型名和线上目录不一致」，或保存时缺少 reasoningEfforts 等字段。
dsh-model-probe（npm 包名 dsh-live-model-probe）由维护者 lyufeng000 发布，分类为联网工具。它不单独做一套「模型探测」设置页或手填表，而是在上述原生流程上做透明增强：普通打开仍只读静态配置与内置目录；只有用户在弹窗里显式点「刷新 / 重试」时，才用已配置的路由和凭据请求厂商实时模型列表，勾选与写回仍走 DSH 官方 ConfigEditor。
这是什么¶
一句话：增强 DSH 原生「获取可用模型」——静态即时展示、显式在线刷新、按真实协议把思考能力持久化到 cordis.patch.yml。
- 仓库：lyufeng000/dsh-model-probe
- 社区目录页：skillhub.cn 插件条目
- 当前版本（资料记载）：0.1.0，MIT 许可证
- DSH 引擎要求：
>=0.2.1-rc.2 <0.3.0（见package.json的engines.dsh）
README 明确：没有独立「模型探测」设置页、卡片、手填表或额外的采用/写入流程；模型搜索、勾选、添加和保存仍由 DSH 原生界面负责。
核心行为¶
静态获取与显式刷新¶
- 普通获取、挂载和重新打开编辑器：只读最新静态配置与内置目录，不解析凭据、不访问网络、不等旧请求。
- 用户点击「刷新 / 重试」：使用已有路由配置和凭据请求实时目录；不以静态目录或旧缓存冒充刷新成功。
- 刷新复用该提供商原有的获取动作；保留已有勾选、搜索文本及请求期间的新操作，不自动添加、删除或保存模型。
- 刷新按钮沿用原生样式，请求期间显示忙碌状态并避免重复触发；失败由原生流程和刷新按钮提示，保留当前列表与选择，但不声称旧目录是本次刷新结果。
每个原生编辑器只有一个刷新按钮；打开选择弹窗后，按钮移入弹窗（与 DSH 0.2.1-rc.2 已核对的原生 DOM 结构相关；结构不匹配时保持原生界面，不接管输入或保存）。
保存与 reasoningEfforts¶
勾选、添加并保存后，由官方 ConfigEditor 写入当前 profile 的 cordis.patch.yml，不是仅把结果放进在线列表或缓存。
原生添加逻辑丢弃的 reasoningEfforts 会在官方保存锁内补齐：只补用户已选模型的缺失字段，保留现有顺序、容量、兼容配置、手工推理设置及其他路由。普通保存无需先刷新即可补齐已确认的内置能力；手工映射、显式删除及自定义 serializer 配置保持优先。
思考能力按具体模型和实际协议映射，覆盖 Codex/OpenAI、Moonshot、xAI、Anthropic、Google、Mistral 和 OpenRouter。区分真实 effort、预算档位、开关、强制思考、明确不支持与未知；未知不写成 false，ultra 不冒充受支持档位。
Gemini 4 Argon 与本地兼容服务¶
Gemini 4 Argon 的官方 LOW/MEDIUM/HIGH 需配套可逆请求修正，避免旧适配器把三档都发成自动预算；只作用于官方 Google 路由及精确型号。禁用插件也会卸载此修正；静态配置不会自行删除。Argon 依据 Google 官方模型说明 与 思考参数文档；用户既有容量不会被覆盖。
本地 Qwen 等自定义兼容服务，在未确认后端和聊天模板前不虚构多档能力；仅凭模型名称或 reasoning: true 不足以证明支持特定参数。
协议与安全¶
支持的模型列表接口包括：Google Generative AI、OpenAI completions/responses、OpenAI Codex OAuth、Anthropic Messages 和 OpenRouter。Codex 读取已有有效登录记录，请求官方 backend-api/codex/models；不刷新或改写 OAuth 登录记录。
凭据只在 Host 内解析并发往当前路由配置的服务地址，前端不接收 key、token 或 account ID。保留凭据隔离、响应大小限制、超时、取消、禁止凭据重定向等检查。未授权的草稿地址/协议变更不能继承已存凭据。请求只获取目录（只取一页），不发起模型推理；列出某个模型不等于已验证账号的实际推理权限。
缓存与 Azure¶
.model-probe-cache/catalogs.json 现为 v3，带 DSH/pi-ai 兼容纪元与 pi-ai 目录代次；旧 v2/旧纪元缓存只读忽略，不会进入原生保存。
pi-ai 1.1.0 将 Azure 路由从 azure-openai-responses 更名为 azure。azure-openai-responses 协议没有可安全读取的在线列表接口，刷新会以 AZURE_DISCOVERY_UNSUPPORTED 明确拒绝（改用 openai-completions 的路由不受影响）。
备份文件：新备份写入 compat 标记；升级前无标记的旧备份恢复会被 LEGACY_BACKUP_UNSAFE 明确拒绝，避免静默丢失 reasoningEfforts 或写入过期容量。
安装与启用¶
资料中的要点如下，请勿安装 npm 上其他作者的 dsh-model-probe 包：
- npm 包名：
dsh-live-model-probe（仓库名dsh-model-probe） - 安装或改变插件启用状态须获得用户明确授权；插件不会自行启用自己
- 本地开发可将本仓库以
link:形式登记为依赖
在 DSH 中完成插件安装并启用后，若配置里显式设置 model-probe.disabled: true，则不会执行在线增强逻辑。
社区目录 skillhub.cn 标注为可安装联网工具；具体安装入口以你当前 DSH 版本与目录页说明为准。已抓取资料未给出单独的 dsh plugin add … 命令行原文，本文不拼接安装命令。
典型用法¶
按 README「使用与启用」：
- 在 DSH 原生模型页配置该提供商的凭据或完成登录。
- 确认本插件已启用（且未设置
model-probe.disabled: true）。 - 在原生模型卡片点击「获取可用模型」，在原有弹窗里搜索、勾选，或点击「刷新 / 重试」拉取厂商实时目录。
- 是否添加和保存始终由用户通过原生界面决定。
适用场景与注意¶
适合谁： 已在 DSH 里用原生模型配置流程，希望在不改 UI 习惯的前提下，按需刷新 Google、OpenAI、Anthropic、OpenRouter、Codex OAuth 等协议的在线模型列表，并把思考相关字段按协议写回 cordis.patch.yml 的开发者。
权限与安全： 插件以当前 DSH 进程权限运行，刷新时会用 Host 内已存凭据访问你配置的服务地址。安装前应阅读 GitHub 源码 与 MIT 许可证，确认路由与凭据范围符合你的环境策略。
兼容性： 弹窗增强依赖 DSH 0.2.1-rc.2 原生 DOM；新增厂商目录与真实推理权限仍需分别验证。SkillHub 与 DeepSeek / 幻方无官方从属关系，属于社区插件生态。
结尾¶
dsh-model-probe 的价值在于：不另起一套模型管理界面，而是在「获取可用模型」里区分「即时静态列表」与「显式在线刷新」，并把保存路径留在官方 ConfigEditor。需要详情、问题反馈与开发验证说明时，见 GitHub 仓库 与 SkillHub 目录页。
