在 DeepSeek Harness (DSH) 的生态中，模型管理通常分散在多个设置项和组件中，缺乏统一的入口。yhyfhgs/dsh-model-hub 插件旨在将提供者登录、模型目录和会话路由统一到一个安全、仅本地回环的 /model-hub RPC 通道中。它接管了生命周期管理和模型选择，同时保留了对官方 DSH 设置的访问权限，从而提供集中的配置和路由体验。
核心功能¶
该插件提供以下具体能力：
- Provider Sign-in：在浏览器中直接完成 OAuth / 设备代码认证流程，支持实时尝试追踪、提示对话框和 30 分钟的主机超时。
- Provider Lifecycle：提供激活、停用、登出和使用记录等管理操作，所有操作均通过影响确认对话框进行保护。
- Provider Customization：允许编辑 API 密钥（通过
credentials.set安全存储）、Base URL、协议、显示名称以及每路由的模型映射。 - Rich Model Catalog：扩展原生
llm.models架构，保留inputModalities、contextWindow和defaultMaxTokens等字段。 - Session Selection & Routing：支持内存会话模型选择，使用
{ prepend: true }挂钩优先级。子智能体遵循 3 层路由策略。 - Thinking Effort Control：动态滑块，根据每个模型支持的推理级别自动校准。
- Fast Mode：基于元数据的切换功能，用于声明加速服务层的模型。
- Built-in Providers：内置支持
qwen-code(RFC 8628) 和codex(OpenAI Codex)。 - Bilingual Interface：原生支持简体中文和英文 UI，遵循 Harness Shell 的语言偏好。
- Loopback Security：所有
/model-hub端点严格绑定authority: 'loopback'，并使用 Zod 进行严格的负载验证。
安装与启用¶
安装前请确保 pnpm 已在 PATH 中，因为 dsh plugin 命令在底层调用 pnpm。
- 执行安装命令：
dsh plugin --profile web add @fhxgs/dsh-model-hub
- 安装完成后必须重启 profile，因为配置文件的组合更改不支持热重载。
典型用法¶
- 在运行 DSH 的同一台机器上打开 DSH Web UI（所有端点均需要本地回环访问）。
- 进入 Settings -> Model Hub -> Providers，选择提供者并完成登录流程。
- 在提供者卡片上点击 Activate 以启用路由。
- 切换到 Catalog 选项卡，选择希望在拾取器中显示的模型。
- 在任意聊天会话中，从气泡或输入
/model命令中选择模型和推理努力。
配置说明¶
插件在 model-hub 设置命名空间下管理配置。配置项包括：
- picker：控制模型可见性。
mode支持all（默认）或include（显式白名单）。include列表定义了允许的模型。 - fastMode：开启加速服务层路由的模型列表。
- preferredEffort：可选的默认推理努力级别。
- subagent：继承或特定提供者/模型/推理努力的配置。
内置提供者配置存储在单独的 model-hub-providers 命名空间中，以防止目录缓存失效。
注意事项¶
- 环境依赖：
dsh plugin命令依赖pnpm，请确保corepack enable pnpm后pnpm可用。 - 安全性：凭证直接进入安全存储，绝不会在日志或状态快照中暴露。
- Loopback 限制：所有
/model-hub端点仅限本地访问。
