dsh-provider-hub
只填 Key 的服务商预设：为 DSH 一键写入官方 llm-pi-ai 路由与凭据（插件），并可写入腾讯 WorkBuddy 的本地 models.json 与 OpenCode 配置（CLI，Key 走 OpenCode 自己的 auth.json）；核心为纯 JS，可被更多应用的外壳复用。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-provider-hub@0.3.1Provider Hub 以 dsh-provider-hub 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
为 DSH 扩大可用的服务商：选一个服务商，粘贴 API Key，点启用——插件把官方 llm-pi-ai 路由与凭据一次性写好，立即生效、无需重启、无需手改 settings.yaml。
内置 40 家服务商预设（OpenAI 兼容 / Anthropic Messages / OpenAI Responses 三种协议），覆盖国际与国内的普通 API 与 订阅渠道（百炼 Token Plan、智谱 Coding、Kimi Coding、MiniMax Coding Plan、小米 MiMo、OpenCode Zen、火山方舟 Agent Plan 等），另有「自定义服务商」入口可接入任意兼容端点；DSH 已内置的服务商默认折叠、不重复展示。
# 通过插件管理器（推荐）
dsh plugin --profile web add dsh-provider-hub
# 或本地开发挂载
dsh plugin --profile web add link:/path/to/dsh-provider-hub
重启 dsh web，打开 设置 → Models，页面底部出现「服务商预设」卡片。
运行中（宿主已注册该路由）/ 已写入 / 缺 Key移除：点行内「移除」。已保存的 Key 会保留在凭据服务里，重新启用时不需要再粘贴；如需彻底清除，在官方 Models 页删除该路由后用凭据接口清除对应引用。
「自定义服务商」支持任何 OpenAI 兼容端点（openai-completions）或 Anthropic Messages 端点（anthropic-messages）：填路由 ID、Base URL（到 /v1 为止）、协议、模型 ID（逗号/换行分隔）与 Key 即可。
写入全部走 DSH 官方服务，插件不直接碰配置文件：
credentials.set(apiKeyEnv, key) —— Key 存进凭据服务（与手写 profile 用的是同一个引用）settings.mutate('llm-pi-ai', [set providers.<route>], revision) —— 写入官方 pi-ai 命名空间的用户层，官方 schema 校验、适配器热注册core/ 目录是纯 JS（无 Node 内建、无 DSH 依赖、无 I/O）：服务商目录、profile 构建与校验。宿主半、浏览器半（本插件）、以及后续的桌面端外壳共用同一份核心代码。
OpenAI、OpenRouter、Anthropic、Google Gemini、xAI Grok、Mistral、Groq、Together、Fireworks、DeepInfra、Novita、Cerebras、NVIDIA NIM、Baseten、HuggingFace Router、Vercel AI Gateway、OpenCode Zen / Zen Go、硅基流动、月之暗面 Kimi（国内/国际）、Kimi Coding Plan、智谱 GLM（国内）、智谱 Coding Plan、Z.ai GLM、MiniMax Coding Plan（国际/国内）、MiniMax（国内）、阿里云百炼 Token Plan（国内/国际）、阿里云百炼 Qwen、百度千帆、腾讯混元、火山方舟（豆包）、小米 MiMo、Ant Ling、LongCat（美团）、StepFun Step Plan（国内/国际）、火山方舟 Agent Plan。
火山方舟 Agent Plan 预设写入 https://ark.cn-beijing.volces.com/api/plan/v3（不是 /api/v3——后者按量计费），协议走 Responses API（对应 OpenCode 的 @ai-sdk/openai；要更旧的 Chat API 就把协议改成 OpenAI 兼容）。收录 ark-code-latest 与 deepseek-v4.1-flash / glm-5.3 / kimi-k3 / deepseek-v4-pro / deepseek-v4-flash / kimi-k2.8-preview，后六者均标注 1M 上下文窗口。
关于内置：DSH 自带 DeepSeek 官方适配器（llm-deepseek），其目录里的 stepfun 指向普通付费端点 api.stepfun.com/v1——Step Plan 订阅端点（step_plan/v1）没有内置条目，因此本插件提供该预设；其余与本插件重合的服务商由 DSH 原生目录覆盖的那些默认折叠在「显示 DSH 已内置」开关后。已配置过的 Key（包括来自环境变量的）会被识别，留空输入框即可直接启用。
同一份预设目录也能写入 WorkBuddy 的本地自定义模型文件（~/.workbuddy/models.json，明文 JSON，应用启动时读取）。
默认流程与应用官方面板对齐：工具只写「定义」（接口地址 / 模型清单 / 上下文与输出限额 / 图片、推理、工具调用开关 / 思考档位），不写 Key——WorkBuddy 官方的「设置 → 模型 → 模型管理」面板本来就能编辑这同一些字段（含 API Key），Key 由你在应用里填：
node tools/workbuddy.mjs list # 查看预设与 WorkBuddy 里的已装状态
node tools/workbuddy.mjs add-all # 目录内全部预设：只写定义
node tools/workbuddy.mjs add volcengine-agent-plan # 只写定义，Key 在应用里填
node tools/workbuddy.mjs add stepfun-step-plan --key-from-dsh STEPFUN_API_KEY # 想一次到位也行
node tools/workbuddy.mjs unset-key volcengine-agent-plan # 清掉某渠道 Key，改为应用内填（--all 清全部）
node tools/workbuddy.mjs remove stepfun-step-plan
node tools/workbuddy.mjs add-custom --model gpt-5.1 --url https://api.openai.com/v1 --name "GPT-5.1"
isValidLocalCustomModel）生成，写入前本地校验、临时文件+rename 原子替换custom-local: 前缀 + custom tag，实际请求前还原原始模型 IDuseCustomProtocol: false（默认）＝应用自动在 URL 后追加 /chat/completions；需要完整 URL 时加 --full-url--key、--key-env NAME、--key-from-dsh REF（复用 DSH 凭据服务里的 Key）remove <另一家> 再 add <目标家>同一份预设目录也能写入 OpenCode 的配置（~/.config/opencode/opencode.json 或 .jsonc，自动备份）。只写“提供商定义”，绝不写 Key——Key 由 OpenCode 自己的「连接提供商」流程存进 ~/.local/share/opencode/auth.json，和官方原生服务商的待遇完全一致：
provider-hub-opencode list # 预设、已装状态、Key 连接状态
provider-hub-opencode add volcengine-agent-plan # 只写定义（npm/baseURL/模型/限额/视觉）
provider-hub-opencode add longcat --key sk-... # 想命令补 Key 也行（写入 auth.json）
provider-hub-opencode add-all [--prune]
provider-hub-opencode migrate-key # 把配置里残留的 Key 搬进 auth.json
provider-hub-opencode remove volcengine-agent-plan [--purge-key]
provider-hub-opencode add-custom --model gpt-5.1 --url https://api.openai.com/v1 [--key sk-...] [--name "GPT-5.1"]
用户侧填 Key（应用内完成，零命令）：OpenCode → 管理模型 → + 连接提供商 → 自定义 OpenAI 兼容提供商 → Provider ID 输入预设 ID（如 volcengine-agent-plan）→ 粘贴 Key。存进 auth.json 后，该渠道就能在「连接提供商」里查看/断开，与 OpenCode Zen、DeepSeek 等官方渠道体验一致。
name / limit（上下文/输出，含 1M 窗口）/ reasoning / tool_call / attachment + modalities（方舟文档要求的图片理解字段）~/.cache/opencode/models.json 判定协议）--key、--key-env NAME、--key-from-dsh REF（复用 DSH 凭据服务里的 Key），全部写入 auth.json；配置文件永远零明文 Key--key-in-config 是旧模式（Key 写回 options.apiKey），仅供想要单文件自包含配置的用户node tools/refresh-catalog.mjs --catalog <catalog.json>（先 --dry 审阅）；路由级只保留全部模型一致的开关，不一致的由模型自己携带 compatnode tools/workbuddy.mjs add-all --prune 同步：装入全部预设并清掉目录里已不存在的旧条目reasoningEfforts 的模型才会有思考档位选择器；未声明的模型按无档位处理Expand the providers DSH can use: pick a provider, paste the API key, press Enable. The plugin writes the official llm-pi-ai route and its credential in one step - effective immediately, no restart, no hand-editing settings.yaml.
40 built-in presets (OpenAI-compatible, Anthropic Messages and OpenAI Responses protocols) plus a custom-endpoint form for any compatible gateway. Presets your target app already ships natively are collapsed by default, never deleted.
dsh plugin --profile web add dsh-provider-hub
Restart dsh web, open Settings → Models; the "Provider presets" card is at the bottom.
Paste the key (each row links to the console and the model list), press Enable, then pick the provider's models in the composer's model selector. Remove takes the route offline but keeps the stored key, so re-enabling never needs the key again.
All writes go through official services - the plugin never touches config files directly: credentials.set(apiKeyEnv, key) stores the key, and settings.mutate('llm-pi-ai', [set providers.<route>], revision) writes the user layer of the official pi-ai namespace (schema-validated, hot-registered).
core/ is pure JS (no Node built-ins, no DSH imports, no I/O): the provider catalog plus profile building and validation, shared by the host half, this plugin's browser half, and any future desktop shell.
The same catalog ships two CLIs: provider-hub-workbuddy writes WorkBuddy's local models.json, provider-hub-opencode writes OpenCode's config. The OpenCode CLI writes provider definitions only - keys land in OpenCode's own auth.json (the file its in-app 连接提供商 flow uses), so custom providers behave like natively supported ones and stay manageable from the app. Both accept --key-from-dsh <REF> to reuse a key already stored in DSH.
Preset model specs are editable starting defaults; model ids and limits follow each vendor's docs. Only models declaring reasoningEfforts get the thinking-level selector. Removing a route keeps its credential.