前言¶
在 DSH 里切换模型时，下拉列表往往会列出所有已配置的提供商与模型。若你只想在界面里暴露部分提供商、或希望把某个来源模型固定重定向到另一套提供商与模型，通常需要改配置或依赖会话侧行为，缺少一块集中在 profile 里、可保存且可同步的设置界面。下面介绍社区插件 dsh-provider-visibility：它在 DSH Web profile 中提供「模型列表」设置页，用于控制提供商可见性，并管理可移除的模型重定向规则。
这是什么¶
dsh-provider-visibility（仓库 vb2250158/dsh-provider-visibility）由维护者 vb2250158 发布，在 SkillHub 目录中归类为 admin-security。插件自述为 Provider visibility policy and Model list settings page；界面语言为英文时列表显示 Model visibility，为中文时显示 模型列表。
当前资料中的版本为 0.1.0-rc.8.17，许可证 MIT。本 release 要求 DSH 0.2.1-alpha.1 或与 0.2 兼容的版本（详见仓库内 docs/dsh-0.2-compatibility.md）。
核心功能¶
提供商与模型列表¶
插件提供设置页，用于控制模型下拉中显示哪些提供方，并将设置写入 DSH profile。设置页读取全局模型目录；资料说明本地集成使用当前 client-store 并声明 remote.session 注入，因此 pending 或尚未建立 session 时也不会因此隐藏可用提供商。
模型重定向规则¶
「模型列表」支持可移除的模型重定向规则，行为要点如下（均来自 README 说明）：
- 优先级：指定模型的规则优先于「提供商全部模型」类规则。
- 匹配：每条请求只匹配一次，不递归套用后续规则；目标固定为选定的提供商与模型。
- 会话选择：原有会话中的模型选择会保留；删除规则后，下一次请求恢复原先路由。
- 生效时机：正在装配的请求使用已捕获的规则；之后对规则的修改从下一步请求生效。
- 推理档位：重定向保留推理档位；目标不可用或拒绝该档位时请求失败，不自动回退。
来源与目标选择复用 dsh-codex-model-selector 的搜索下拉；启用该插件后即可编辑规则。选择下拉仅修改规则草稿，不调用会话的模型切换接口。
重定向通过公开扩展点 system-prompt/assemble 与 agent/request 生效：原选择仍记录为 model/selection，重定向说明以插件来源的 user/message 通知进入模型上下文；实际调用仍由标准 request/header 与模型回复来源记录。modelRedirects 投影按回复 id 关联；配合 dsh-chat-enhancement 可显示实际模型与「已重定向」标记，悬停可见「来源 → 实际使用」。没有通知的旧回复不会推测重定向来源。运行态组件 runningModelRedirect 从相同投影读取当前轮次与步骤的重定向信息，下一步骤开始时清除旧通知。
配置读写与界面（0.2 配置接口）¶
在现行 DSH 配置接口下，浏览器从共享配置镜像解析插件字段；保存仍走宿主的校验、版本检查与写入队列，原有隐藏列表及规则保持不变。加载、保存成功与失败均有反馈；界面将规则与提供商分区展示，窄屏为单列布局。近期版本修复了模型重定向、提供商开关及列表勾选框、重定向选择器在客户端被错误禁用的问题。
安装与启用¶
安装前请锁定公开仓库的提交 hash，并通过 DSH 官方入口安装（命令来自 README，将 <commit> 换为实际提交）：
pnpm dsh plugin --profile web add github:vb2250158/dsh-provider-visibility#<commit>
插件包声明 dsh.bundle，安装后会把自己的配置层（cordis.patch.yml）加入 profile。多电脑同步仓库时，资料说明仅保存仓库地址、固定提交、启停状态与配置，不保存本仓库源码。
典型用法¶
- 按上文命令把插件加入 web profile 并启用。
- 在 DSH 插件列表中点击本插件进入详情页，使用其中的配置与操作界面（设置菜单不再重复显示该插件入口）。
- 在「模型列表」中勾选或关闭各提供商在下拉中的可见性，保存后由 profile 持久化。
- 若需重定向：在规则区添加来源与目标（建议已启用
dsh-codex-model-selector），保存规则；发新请求时按上述优先级与单次匹配规则路由。 - 开发或二次打包时，可在插件仓库内执行 README 中的验证命令：
npm test
npm run build
npm pack --dry-run
从 DSH 源码联调时，需设置 DSH_SOURCE_ROOT 指向 DSH 工作区；Host 测试使用该工作区的真实 Session 与 AgentLoop，模拟适配器不访问外部模型。
适用场景与注意¶
适合谁：需要在 Web 端统一管理「哪些提供商出现在模型列表里」、且要用可编辑、可删除的重定向规则做固定路由的 DSH 0.2 用户；关心 admin-security 类能力、希望设置落在 profile 可同步配置中的维护者。
权限与安全：插件以当前 DSH 进程权限运行，安装前应阅读 GitHub 源码 与 MIT 许可证，确认行为符合你的环境策略。社区目录 SkillHub 插件页 为独立生态站点，与 DeepSeek / 幻方无官方从属关系。
依赖：除 DSH 0.2 系 peer 依赖外，完整使用重定向规则编辑体验时依赖 dsh-codex-model-selector；与 dsh-chat-enhancement 配合可更好展示重定向后的实际模型信息。
结尾¶
dsh-provider-visibility 把提供商可见性策略和模型重定向收进 DSH profile 内的「模型列表」设置页，读写走宿主校验与共享写入队列，适合在 0.2 Web profile 里做可见面与路由层面的管理。目录页：https://www.skillhub.cn/plugins/vb2250158/dsh-provider-visibility；源码与版本说明：https://github.com/vb2250158/dsh-provider-visibility。
