planbridge

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# 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 各自独立登录）

## 安装方式

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

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

### 第一次安装的坑

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

```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）
```

## 开发

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

# 测试
pnpm test
```

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