前言¶
在 DeepSeek Harness（DSH）里跑智能体或对话，通常要配置模型 API：自备 Key、走网关，或对接各家 OpenAI / Anthropic 兼容端点。若你已经在 ChatGPT Codex、Cursor、GitHub Copilot、Claude 等产品有订阅或本地登录态，再单独买一份推理 Key 往往重复且难维护。
社区插件 dsh-plugin-oauth-subs 面向这类场景：把多种「订阅 / OAuth」账号接到 DSH，经本机回环代理或直连，把请求转成 DSH 支持的 openai-responses、openai-completions、anthropic-messages 等 api 形态。下文介绍其定位、能力与安装用法；事实以仓库 README 与 package.json 为准。
这是什么¶
dsh-plugin-oauth-subs 是 DSH 的 OAuth 订阅类插件，版本 0.0.110，许可证 MIT。
当前在 GitHub 上由 lingdong0128-sys 维护的仓库 lingdong0128-sys/dsh-plugin-oauth-subs 是原项目 xxww0098/dsh-plugin-oauth-subs 的备份镜像：原仓库已下线（404），镜像于 2026-10-21 自本机已安装的 dsh-plugin-oauth-subs@0.0.110 保留，功能与原版一致；版权与致谢归属 xxww0098。SkillHub 目录页将其归类为「模型推理」。
一句话：在 Harness 内登录或导入既有凭证，用订阅额度驱动上述 api 路由上的模型调用。
核心功能¶
支持的提供方（Families）¶
README 中的提供方与 DSH api、上游大致对应关系如下（认证方式因厂商而异，含 PKCE、device-code、粘贴回调、导入本地文件等）：
| 提供方 | DSH api | 说明（摘要） |
|---|---|---|
| ChatGPT Codex | openai-responses |
本机 PKCE，上游 Codex Responses |
| xAI Grok | openai-responses |
device-code 或 PKCE |
| GLM · Z.ai / BigModel | anthropic-messages |
ZCode CLI 轮询等 |
| AWS Kiro | openai-completions |
Social PKCE / Builder ID / IdC 等 |
| Google Antigravity | openai-completions |
Google OAuth 本机回调 |
| Cursor | openai-completions |
PKCE 或导入本地 Cursor |
| Ollama Cloud | openai-completions |
API Key |
| Kimi Code Plan | openai-completions |
device-code 或导入 ~/.kimi-code/... |
| GitHub Copilot | openai-completions |
device-code 或导入 Copilot hosts |
| Devin Agent / Cline | openai-completions |
PKCE 或 device-code、导入本地配置 |
| Claude (Anthropic) | anthropic-messages |
Claude.ai / Console PKCE，可只读导入 Claude Code 登录 |
| OpenCode Go | openai-completions / openai-responses |
API Key，直连 opencode.ai |
订阅类提供方经本机回环代理转发；OpenCode Go 直连其 API。默认代理端口 8318（可在 profile 的 cordis.patch.yml 里为 id: oauth-subs 设置 config.port）。
导入既有凭证¶
插件支持从常见本地路径导入，例如 ~/.codex/auth.json（Codex）、~/.grok/auth.json（Grok）、~/.zcode/v2/config.json（GLM）、Kiro / Antigravity / Cursor / Kimi / Copilot 等对应路径或环境变量。完整表格见仓库 README「Import existing credentials」一节。
工作台界面¶
安装并启用后，在宿主侧边栏 插件 Plugins 下打开 订阅 / Subscriptions。工作台左侧为提供方轨道，右侧为可滚动面板；顶部固定 额度 Quota、模型 Models、版本 Version 三个标签。每个账号一张卡片（Ollama Cloud 无额度条）。Version 可对比运行中版本与 GitHub 最新 tag，支持检查更新、安装更新及可选的 15 分钟自动更新（桌面端由 Electron 管理生命周期，不通过 CLI 重启宿主）。
开发与补丁方式¶
除 dsh plugin add 外，README 提到可用：
pnpm dsh web --patch ./cordis.patch.yml
其中 patch 的 id 为 oauth-subs。
安装与启用¶
Web profile¶
README 给出的安装命令为（指向原仓库 URL；原仓已 404 时，需改用当前可访问的镜像仓库地址，例如本镜像的 GitHub URL，安装方式相同）：
dsh plugin --profile web add https://github.com/xxww0098/dsh-plugin-oauth-subs
dsh web
然后在界面中进入 订阅 / Subscriptions 完成各提供方登录或导入。
Desktop profile¶
桌面 profile 仅由 Electron 应用管理，不能使用 dsh plugin --profile desktop。步骤为：
- DeepSeek Harness → 插件 → 添加插件
- 粘贴仓库 URL（README 示例为
https://github.com/xxww0098/dsh-plugin-oauth-subs）→ 安装 - 打开插件开关，组件行应显示 运行中
数据目录：~/.dsh/profiles/desktop/data/dsh-plugin-oauth-subs/。与 web profile 不共享登录态；可从 ~/.dsh/profiles/web/data/dsh-plugin-oauth-subs/ 复制 auth.json（及可选 models.json），须在退出应用后复制，避免运行中内存态覆盖文件。
注意：代理端口为全局本机绑定，web 与 desktop 不能同时占用同一端口，否则会 EADDRINUSE；需结束另一侧或修改 config.port。
典型用法¶
- 按上一节安装插件并启动
dsh web或桌面应用。 - 打开 订阅 / Subscriptions，在左侧选择提供方（如 Cursor、Copilot、Claude）。
- 按卡片提示完成 OAuth、device-code，或 导入 本机已有凭证文件 / 环境变量。
- 在 模型 Models 中选择该账号暴露的模型路由；在 Harness 会话里选用对应
api类型的模型即可走订阅上游。
若需从 web 迁到 desktop，按 README 复制 data 下文件并重启应用；更新插件后 data/ 会保留。
适用场景与注意¶
适合谁：已在多款 IDE / 助手产品持有订阅或本地 OAuth 态，希望在 DSH 统一编排智能体、又不想重复配置多套 Key 的开发者。
权限与安全：插件以当前 DSH 进程的用户权限运行，会读写 profile 下 data/、监听本机端口，并可能读取 README 所列的各厂商凭证路径。安装前应自行审阅 镜像仓库 源码与 MIT 许可证；勿在未信任的环境粘贴 session token。
镜像与版本：package.json 中版本为 0.0.110；npm 公共 registry 未发布该包，上游 git 已不可用，镜像为目前公开的同款产物备份。SkillHub 页与 GitHub 星标等以目录站展示为准（当前线索为 1 star），不作为功能承诺。
桌面专属行为：插件面向 Desktop 做了生命周期裁剪（不自行 spawn dsh/npm 或重启宿主），更新依赖应用内 安装更新 或重装插件 URL。
结尾¶
dsh-plugin-oauth-subs 把 Codex、Grok、GLM、Kiro、Antigravity、Cursor、Ollama Cloud、Kimi、Copilot、Claude 等订阅与 OpenCode Go Key 接到 DSH 的统一 api 面上，并辅以订阅管理与版本更新 UI。原作者为 xxww0098；现可从镜像 lingdong0128-sys/dsh-plugin-oauth-subs 获取代码，目录介绍见 SkillHub 插件页。安装命令以 README 原文为准；原 Git URL 失效时改用镜像仓库 URL 即可。
