模型中心 ArthurZhou/dsh-plugin-model-hub

dsh-plugin-model-hub

一个 DeepSeek Harness 的 web 插件，在设置中新增模型中心 页面，用于：

- 编辑每个提供方在 settings.yaml 中的档案字段（displayName、api、baseURL、models）；
- 配置提供方级与模型级的上下文窗口（提供方 defaultContextWindow、每个模型 contextWindow —— Web 界面按此显示上下文预算，1M token 的模型即可显示 1M，而不是 pi-ai 默认的 256K）；
- 按提供方配置 API Key（经凭据服务存储，绝不写入 settings.yaml）；
- 按提供方调整 API 出错重试与退避参数（最大重试次数、初始/最大等待、抖动、可重试错误码），即 dsh-llm-retry 实际执行的旋钮；
- 设置 Agent 默认模型；
- 声明全新的 pi-ai 提供方路由（OpenAI 兼容网关或 dsh-llm-pi-ai 支持的其他协议）。

为什么需要这个页面

内置的 Models 设置页通过仅限 loopback 的 设置镜像 读写，当 GUI 通过不安全 HTTPS 或非 loopback 来源访问时该镜像会被刻意禁用（表现为"设置在此浏览器中不可用"）。本插件不依赖该镜像：所有读写都直接走标准的 settings、credentials、llm RPC 域，因此在 Harness 本身可达的任何来源上都能工作。

工作原理

本包是 双面 cordis 插件：

- 宿主半部（lib/index.js）——一个占位条目，仅为了让包成为 profile 中真实的 loader 条目。web 应用的 client-modules 扫描只发现"已激活的 loader 条目且声明了 dsh.client"的包的客户端包。
- 客户端半部（lib/client.js）——浏览器端页面及其数据层，注册进 settings.section 插槽，通过标准 RPC 域与 Harness 通信，无需自定义传输。

安装

插件自带一个 bundle 补丁（cordis.patch.yml），插入一条 loader 行 model-config。
两种等价方式：

1. 通过 dsh plugin（推荐）

在任意目录执行（<checkout> 为本插件检出路径）：

dsh plugin --profile web add file:/path/to/dsh-plugin-model-hub

dsh plugin 会在 profile 目录中执行 pnpm add，然后对账 dsh.profile.bundles 层列表：任何声明了 dsh.bundle 的依赖（本插件即是）会自动加入 bundle 层。

本地开发建议用软链接 spec，源码改动无需重装即可生效：

dsh plugin --profile web add link:/path/to/dsh-plugin-model-hub

2. 手动安装

- 把 dsh-plugin-model-hub 加入 profile 的 dsh.profile.bundles （~/.dsh/profiles/web/package.json），并使其可从 profile 解析（例如 pnpm --dir ~/.dsh/profiles/web add file:/path/to/dsh-plugin-model-hub）， 或
- 自行把 cordis.patch.yml 中的那一行合并进 profile 的 ~/.dsh/profiles/web/cordis.patch.yml。

随后重启 profile（dsh web）——client-modules 扫描发生在激活阶段，新增 bundle 需要重新启动才能生效。

使用页面

设置中出现 模型中心 区段（位于内置区段之后）。对每个提供方行可以：

- 查看凭据是否已配置；
- 编辑档案字段与模型；
- 输入或替换 API Key（留空则保留已存储的值）；
- 覆盖重试策略——未设置的项保持 dsh-llm 默认值（normal 模式、5 次重试、500 ms → 10 s 指数退避、10% 抖动）；
- 删除用户自定义的提供方（连同其已存储的 Key）。

开发

npm test # 数据层测试（node:test，无需浏览器）

测试装置在 VM 中加载 lib/client.js，配以伪 wire api，因此无需浏览器即可覆盖 store、写入路径与重试策略构造。

License

MIT