planbridge

dsh-planbridge

这是什么

DeepSeek Harness 官方暂只支持 API key 方式接入 LLM。如果是已经有 codex、claude、grok 等 Coding Plan 订阅，通过这个插件，oauth订阅也可以成为 dsh 的 provider。

特性

• OAuth 登录 — 在 dsh 设置页完成登录，token 会保存在本地 .oauth-credentials.json（0600 权限 + 原子写入 + 文件锁）
• 墙内可用 — 支持 http_proxy / https_proxy 环境变量（含 wss 代理）
• 原生设置页 — Settings → Plugins → Subscriptions 标签页，支持浏览器 / 设备码 / 手动码三种登录方式（Codex、Claude 与 Grok 各自独立登录）

安装方式

dsh plugin --profile web add "github:harp-reed/planbridge"

<commit> 换成你要固定的 commit SHA（生产建议 pin）。重启 dsh web。

第一次安装的坑

如果安装报 ERR_PNPM_IGNORED_BUILDS（pnpm 11 默认拦截依赖构建脚本），在 profile 的 pnpm-workspace.yaml 加：

allowBuilds:
  '@google/genai': true
  protobufjs: true

然后重跑安装命令（或 pnpm install）。原因：@earendil-works/pi-ai 的传递依赖带构建脚本，pnpm 11 默认不放行。

使用

1. 重启后打开 Settings → Plugins → Subscriptions
2. 在 Codex (ChatGPT)、Claude 或 Grok (X Premium) 卡片下点 Sign in，浏览器弹出对应 OAuth 页面（Grok 为设备码流程）
3. 授权完成后，显示已连接账号
4. 去 Settings → Models，provider 里出现 openai-codex / anthropic / xai，选择即用

状态

项	状态
dsh 版本	0.1.1-rc.2 已验证
Codex (ChatGPT 订阅)	✅ 实测通过
Claude (Claude Pro/Max 订阅)	✅ 已实现（由于账户被A处干碎，未实测；复用 pi-ai 内置 anthropic provider + Claude OAuth 流程）
Grok (X Premium 订阅)	✅ 已实现（未实测；复用 pi-ai 内置 xai provider + xAI 设备码 OAuth 流程）

许可

MIT，版权 © 2026 Planbridge (harp-reed)。

第三方组件：

组件	许可	来源
src/llm/vendor/pi-codex/（Codex 适配器核心）	MIT	@earendil-works/pi-ai@0.82.1（Earendil Works），见 src/llm/vendor/pi-codex/LICENSE
@deepseek-ai/*（dsh 官方包）	MIT	DeepSeek Harness 生态，仅作 peer 依赖
@earendil-works/pi-ai（运行时依赖）	MIT	Earendil Works

本插件不修改任何上游源码；vendor 代码仅按原许可搬运并标注来源。

结构

单包四模块，通过 cordis 子路径挂载：

dsh-planbridge
├── ./credentials   OAuth 凭据存储 + ctx.oauth 服务
├── ./llm           Codex + Claude + Grok LLM 适配器（ctx.llm.registerAdapter）
├── ./gateway       /api/oauth.* 路由（ctx.webServer）
└── ./client        设置页订阅控件（浏览器 bundle）

开发

# 在 deepseek-harness workspace 内构建
tsc -b && tsdown

# 测试
pnpm test

vendor 部分（src/llm/vendor/pi-codex/）拷贝自 @earendil-works/pi-ai@0.82.1，保留 MIT 许可。