dsh-provider-hub
Verified@ceasarxuu/dsh-provider-hub · v0.1.3 · MIT · Web UI
DSH native provider onboarding: Codex subscription sign-in and diagnostics
Install
dsh plugin add @ceasarxuu/dsh-provider-hub Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Readme
DSH Provider Hub
在 dsh 的原生 Models 页接入 Codex 订阅,继续使用 dsh 的会话、工具和插件。
v0.1.3 兼容 @deepseek-ai/[email protected] 和 0.2.1-rc.3。插件复用原生 llm-pi-ai/openai-codex 授权流程、适配器和凭据刷新。授权保存在当前 DSH_HOME,由 DSH 管理;Codex CLI 的登录状态独立。
安装
从 npm 安装:
npx @deepseek-ai/[email protected] plugin --profile web add @ceasarxuu/[email protected]
npx @deepseek-ai/[email protected] web
安装命令会将此 bundle 加入 Web profile。已有 Web 进程时重启一次。自定义 DSH_HOME 的用户在上述两个命令中使用相同的 DSH_HOME;使用 rc.2 的用户将命令中的 DSH 版本改为 0.2.1-rc.2。
如果之前安装过本项目未加 scope 的本地构建包,先运行 npx @deepseek-ai/[email protected] plugin --profile web remove dsh-provider-hub,再安装上述 npm 包。移除插件不会删除 DSH 管理的 provider 和凭据。
登录与使用
- 打开 设置 → 模型 → 添加模型提供商 → 扩展提供商,在 OpenAI · ChatGPT 订阅 中选择登录。
- 本机选择 Browser login (default) 并继续,再打开登录页面完成授权。如果要求粘贴回调地址,在当前登录卡片的输入框提交。
- 登录后通过 dsh 原生模型选择器选择 Codex 模型,开始会话。卡片自动显示可读取的套餐和剩余额度。
- 需要单独诊断时,在 ⋯ 菜单中选择 检查连接。确认框会显示模型及额度消耗提示;确认后才发送真实模型请求。
授权状态和请求验证分开:保存授权不等于模型请求已通过;最近验证通过也只证明指定模型在那个时间可用。安装、打开设置、读取状态和启用提供商不发送模型请求。
套餐及剩余数字在每次打开卡片时自动读取。默认展示周剩余;Plus 还会显示 5 小时剩余。重新登录和退出登录收在右侧 ⋯ 菜单。
扩展提供商选项卡只在兼容的 DSH Web 添加面板中出现;原有第三方提供商和自定义 API 表单保持原生行为。
宿主 Codex 目录尚无 GPT-6.1 Terra 时,插件会临时补充该模型;不改写保存的模型配置。宿主正式目录包含该模型后,临时补充自动停用。如果用户自行配置了模型白名单,正式接手后仍需在白名单中包含该模型;插件停用时临时模型也随之移除。非 OpenAI 的自定义端点不启用此补充。
临时模型显示在会话的模型选择器中,原生模型设置里的“获取模型”仍展示宿主目录。停用或卸载插件后,如果会话仍选中 Terra 而宿主目录尚不支持它,请先在会话中切换到其他可用模型。
首次添加订阅会更新 DSH 的提供商配置版本;同一时间打开的其他提供商草稿可能在保存时遇到版本冲突。先保存其他草稿可避免该情况,插件不会覆盖其他配置。
登录成功页上的彩色 PI 图标来自 DSH 内置的 pi-ai OAuth 组件;页面由本机回调服务生成,账号登录到 OpenAI。可以关闭该页,回到 DSH 查看授权和请求状态。
账号与恢复
同一 DSH_HOME 的所有 profile 共用 llm-pi-ai/openai-codex 授权记录。退出登录会影响这些 profile,界面会说明范围;禁用或卸载插件保留 DSH 管理的 provider 和凭据。
移除原生 Codex provider 后,若需要从本插件退出已保留的授权,先重新启用 Codex,再点击退出登录。
- 授权过期:点击 重新登录。取消或失败的登录保留此前的授权记录。
- 其他页面正在登录:回到发起登录的页面完成或取消,或等待该次操作超时。
- 提示凭据覆盖:在原生 provider 设置中检查
apiKeyEnv,移除不需要的显式覆盖后重试。插件不会替用户覆盖现有值。 - 模型请求失败:依据卡片显示的稳定错误类别检查账号权益、模型、额度和网络;通过原生模型设置调整模型列表。
第一版提供 Web 入口和单账号授权;Desktop、TUI、多账号池及自动 provider 切换不在本版范围。
开发
需要 Node.js 24.9+。使用 npm ci 安装锁定的依赖;与 DSH 相关的包需要版本一致,不能单独安装这些包的 latest 标签。
npm run build
npm run typecheck
npm test
npm pack
测试使用真实 DSH authorization 和 credentials 服务配合隔离的凭据文件;OAuth issuer 以 fixture 替代。打包测试验证浏览器 factory、严格双向 Remote codec 和安装包内容。真实账号验收由用户完成浏览器登录后单独执行,不把 fixture 结果计作已接通。