前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。当开发者需要同时管理多家厂商的订阅计划（如 ChatGPT Codex、Claude Code、ZCode (GLM) 或 Qwen）时，在 dsh 中逐一配置 provider 既繁琐又容易出错。dsh-plan-bridge 插件提供了一个本地桥接方案，通过一个进程将上述多种订阅计划映射到 dsh 的模型组中。
是什么¶
dsh-plan-bridge 是一个运行在本地（127.0.0.1:8417）的回环代理进程。它不修改 dsh 的核心文件，仅作为中间层转发请求。插件提供设置页面的状态卡片，支持一键接入和检测，将多个 vendor subscription plans 整合进 dsh 的模型路由系统。
安装¶
使用官方插件命令安装。安装后需要重启 host 进程。
dsh plugin --profile <name> add -w @taylorswitiger/dsh-plan-bridge
核心功能¶
- 多计划桥接：支持 ChatGPT Codex、Claude Code、ZCode (GLM) 和 Qwen 的订阅计划接入 dsh。
- 本地进程：通过 127.0.0.1:8417 监听请求，路径前缀分流。
- 可视化管理：提供设置页状态卡片，显示接入状态、凭据可用性及错误信息。
- 零侵入：不修改 dsh 核心文件，不依赖运行时 npm 包。
- 双认证模式：支持 OAuth 和 API Key 两种认证方式。
认证方式¶
插件处理不同类型的凭据存储：
- OAuth 计划：读取厂商 CLI 的凭据文件（如 ~/.codex/auth.json 或 ~/.claude/.credentials.json）。插件负责 token 续期并写回原文件。接入前需先运行厂商 CLI 登录。
- API Key 计划：使用 dsh 设置中的凭据库。插件仅透传 Authorization 头，不存储 key。
使用示例¶
安装后，桥接默认监听 127.0.0.1:8417。可通过 HTTP 直测或调用 RPC 方法管理计划。
- 健康检查：
GET http://127.0.0.1:8417/health
- RPC 方法调用（假设 host 运行在 3080）：
curl -s http://127.0.0.1:3080/dsh-plan-bridge/plans.list \
-H 'content-type: application/json' \
-d '{"type":"client-request","rpcId":"1","method":"plans.list","payload":{}}'
- 环境变量配置（如需上游代理）：
NODE_USE_ENV_PROXY=1
HTTPS_PROXY
注意事项¶
- 环境要求：需要 Node.js 版本 >= 22.19。
- 许可证：MIT License。
- 权限限制：插件进程以当前 host 进程权限运行，安装前建议检查源码。
- 不可变性：插件不会修改
agent-default-model，凭据写入全部通过 dsh 的 credentials 服务进行。
适用场景¶
适合需要整合现有 ChatGPT Codex Plus/Pro、Claude Pro/Max、ZCode 及 Qwen 订阅额度，并希望统一在 DSH 中进行路由和管理的开发者。
生态背景¶
DSH 理念是“一切皆插件”。该插件收录在社区目录，与 DeepSeek 或幻方无官方从属关系。
