dsh-subscription-auth


给 dsh 增加订阅会员 OAuth 登录支持（模型提供商按订阅账号登录，而不是 API key）。内置四个订阅渠道：

每个渠道是一个自包含模块（src/channels/<id>.ts，实现 ChannelDefinition 契约），src/index.ts 是薄的通用驱动（遍历渠道定义注册 settings / provider / adapter / 路由）。OAuth 常量与 wire 格式以 omp（@oh-my-pi/pi-ai、@oh-my-pi/pi-catalog）源码为准。对接方法见内置 skill：subscription-channel-migration。

渠道详情

登录时：授权码渠道（ChatGPT / Claude）生成 PKCE 挑战 → 用 rundll32 打开浏览器（不能用 cmd /c start：URL 里的 & 会被截断）→ 本地一次性 HTTP 服务器收 code+state（10 分钟超时）→ 换令牌 → 存进 credential 服务。设备流渠道（Grok / Kimi）请求设备码 → 打开验证页并展示授权码 → 后台轮询直到用户完成授权 → 存令牌。之后每次请求前检查 access token 快过期则静默续期。

安装

前置：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20，pnpm 可用（dsh plugin add 内部使用；没有的话先 npm install -g pnpm）。

标准安装（npm 发布，推荐）

插件以 npm 包 dsh-subscription-auth 发布，包内声明了 dsh.bundle.patch（随包的 cordis.patch.yml）：CLI 安装后会自动注册进 profile 的 dsh.profile.bundles，下次启动即挂载——一条命令完成安装与挂载，无需手改任何配置文件：

dsh plugin --profile web add dsh-subscription-auth

装完重启 dsh 并硬刷新浏览器（Cmd/Ctrl+Shift+R）。

> 若报 minimum release age（发布不足 24h 的新版本）：等 24h，或直接重跑一次上面的命令（pnpm 会自动补 minimumReleaseAgeExclude 放行）。

更新：

dsh plugin --profile web add dsh-subscription-auth

从旧版本迁移（手动挂载 → npm 通道）

0.2.1 之前（或任何通过「源码目录 junction + 手动挂载行」安装的版本）升级到 npm 通道，按顺序执行：

1. 删除 profile 里的手动挂载行：编辑 ~/.dsh/profiles/web/cordis.patch.yml（早期按全局文档安装的可能是 ~/.dsh/cordis.patch.yml），删除这一段：

``yaml - insert: - id: dsh-subscription-auth name: dsh-subscription-auth ``

2. 删除插件锚点 junction（Windows）：

``powershell cmd /c rmdir "$HOME\.dsh\profiles\node_modules\dsh-subscription-auth" ``

3. 用官方 CLI 安装 npm 版：

``powershell dsh plugin --profile web add dsh-subscription-auth ``

4. 重启 dsh + 硬刷新（Cmd/Ctrl+Shift+R）。

> ⚠️ 迁移要点： > - 令牌不受影响：登录令牌存在 credential 服务里，与安装方式无关——迁移后无需重新登录。 > - 不要跳过第 1、2 步：旧挂载不删就装 npm 版会双挂载（两个 Node 半、设置页出现两个「订阅服务」）。 > - 旧的源码克隆目录可留作开发（见下），或直接删除；本机开发用的 node_modules junction 与运行无关。

源码安装 / 开发（可选，替代 npm 方式）

调试本地改动或跟随开发分支时使用（仅在未通过 npm 通道安装时使用，否则会与 npm 版双挂载）：

1. git clone https://github.com/Khellendros97/dsh-subscription-auth.git
   cd dsh-subscription-auth && bun scripts/build-bun.mjs   # 递归转译 src → lib
2. 依赖解析：把 running dsh 的依赖指进来（Windows 示例）：
   cmd /c mklink /J "$HOME\dsh-plugins\dsh-subscription-auth\node_modules" "<dsh 安装目录>\node_modules\@deepseek-ai\dsh\node_modules"
3. 注册到插件锚点：
   cmd /c mklink /J "$HOME\.dsh\profiles\node_modules\dsh-subscription-auth" "$HOME\dsh-plugins\dsh-subscription-auth"
4. 在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
   - insert:
       - id: dsh-subscription-auth
         name: "dsh-subscription-auth"
5. 重启 dsh。

更新：git pull && bun scripts/build-bun.mjs → 重启 dsh。切回 npm 通道时：删除锚点 junction 与手动挂载行，再 dsh plugin --profile web add dsh-subscription-auth。

使用

1. 打开 设置 → 订阅服务：列出四个订阅提供商，显示登录状态、账号与可用模型（折叠列表）。

2. 点「登录」： - ChatGPT / Claude：浏览器自动打开授权页 → 登录并授权 → 跳回 localhost 回调 → 页面轮询到「已登录」→ 自动拉取官方模型列表。 - Grok / Kimi：页面显示验证链接 + 设备授权码 → 在浏览器打开链接并输入代码 → 页面轮询到「已登录」→ 自动拉取模型列表。

3. 在模型选择里切到对应的提供商（如「Claude (订阅)」），选一个模型即可对话。

模型选择器可为订阅模型选择思考强度（推理等级）： - ChatGPT：minimal / low / medium / high（默认 medium，作为 codex Responses 的 reasoning.effort 发送） - Claude：low / medium / high（默认 medium，映射为 extended thinking 的 budget_tokens 8192 / 16384 / 32000） - Grok：low / medium / high（不设默认，选择后作为 xAI Responses 的 reasoning.effort 发送） - Kimi：low / medium / high（不设默认，映射为 thinking.budget_tokens 4096 / 16384 / 32768）

不选择时走提供商默认行为（请求体不带思考参数）。

4. 点右上角「注销」删除已保存的令牌与模型列表。

> 注意：授权码渠道（ChatGPT / Claude）需要在本机运行 dsh，因为回调落在 127.0.0.1。

> 注意：未登录的提供商不会出现在模型选择器里（provider/adapter 按登录状态注册）：登录成功后才注册进模型列表，注销后自动移除。设置 → 订阅服务 页始终列出全部四个渠道以便登录。

> 注意：已登录的提供商在 dsh 启动时即自动注册并发现模型（启动门控会等待 credential 服务就绪，settings 就绪后还会补一次检查），无需先进入设置页。

配置

每个渠道一个 settings 命名空间（subscription-auth-<id>）。模型优先级：手动 models → 登录发现并持久化的 discoveredModels → 渠道内置默认列表。

subscription-auth-chatgpt:
  apiBaseURL: https://chatgpt.com/backend-api/codex/responses
  redirectPort: 1455
  maxTokens: 8192

subscription-auth-claude:
  apiBaseURL: https://api.anthropic.com/v1/messages
  redirectPort: 54545
  maxTokens: 64000

subscription-auth-grok:
  apiBaseURL: https://api.x.ai/v1/responses
  maxTokens: 8192

subscription-auth-kimi:
  apiBaseURL: https://api.kimi.com/coding/v1/messages
  maxTokens: 32768

models 可手动固定模型列表（可选；不配则用登录后自动发现的官方列表），例如：

subscription-auth-claude:
  models:
    - { id: claude-sonnet-5, name: Claude Sonnet 5, contextWindow: 1000000 }

检测（日志）

Get-Content "$HOME\.dsh\tmp\subscription-auth.log"          # 插件日志（登录/发现/错误）
Get-Content "$HOME\.dsh\settings.yaml" | Select-String -Pattern "subscription-auth" -Context 0,15  # 持久化模型列表
Invoke-WebRequest "http://127.0.0.1:<dsh-port>/subscription-auth/providers"  # 实时状态

测试

bun tests/smoke.mjs      # 依赖解析 / PKCE / Responses+Anthropic 序列化 / SSE 翻译 / 错误映射 / localhost 回调 / 多渠道 apply 接线 / 路由注册
bun tests/lib-check.mjs  # 验证 lib/*.js 产物与 src/*.ts 行为一致
node --check lib/client.js  # 配置中心页语法检查

已知限制

• 各渠道模型列表以登录后自动发现为准（官方 /models 接口），手动 models 配置可覆盖；
• Anthropic 订阅的 OAuth 授权约 30 天过期（refresh 不延长授权期），过期后需重新登录；
• 登录令牌存于 credential 服务，属于本机敏感信息，请勿外传；
• 并发刷新存在极小的重复续期竞争，但两者都会写入等价的新令牌，无副作用。

扩展新渠道

参考 skill subscription-channel-migration（对接订阅渠道的一般方法，含 omp 源码迁移指引）：在 src/channels/<id>.ts 实现 ChannelDefinition（OAuth 登录 + 模型发现 + 适配器），再把它加入 src/index.ts 的 CHANNELS 数组即可。

License

BSD-3-Clause