dsh-chatgpt-subscription

DSH Multi-Subscription Hub (@eddyskywalker/dsh-chatgpt-subscription)

面向 DeepSeek Harness（DSH） 的多平台订阅接入与智能体运行时增强插件包。

插件最初为接入 ChatGPT Plus / Pro / Business 订阅的 Codex 模型而建，现已演进为统一的多订阅服务中枢（Subscription Hub）与编码 Agent 增强套件：在单一插件包内同时提供 13 条独立模型供应线路、跨平台加密多账号池、多模态生图/视频工具链、前缀缓存零漂移保护，以及随包分发的 dispatch 多子代理编排预设。

• 跨平台支持：Windows、macOS、Linux（含无桌面密钥环的远程服务器部署模式）
• 跨代际兼容：单一代码库兼容 @deepseek-ai/dsh 0.1.2-alpha.5 至 0.2.2-rc.1 全系列版本
• 全栈多语言：Web 设置中心与宿主侧提示/报错完整支持 简体中文（zh）/ English（en）/ Русский（ru）

---

目录

• 供应线路总览
• 核心特性
• 环境要求
• 安装与升级
• 快速上手
• 内置工具与界面扩展
• Agent 编排与运行时增强
• 常用配置速查
• 安全与隐私边界
• 开发与测试验证
• 进阶文档索引

供应线路总览

插件同时注册 13 条相互隔离的供应线路。每条线路拥有独立的 Provider ID、独立的账号池与轮换策略、独立的模型目录与上下文窗口覆盖，以及独立的额度卡片；任意一条线路限流或故障均不影响其它线路。

合规与风险提示：

• claude-subscription 通过订阅 OAuth 凭据模拟官方 CLI 身份转发请求，与 Anthropic 现行服务条款存在冲突，未获官方授权，存在账号被限制或封禁的风险。
• antigravity、workbuddy-subscription、qoder 等线路部分依赖非公开或逆向协议契约；step-code 额度面板使用非公开开发者中心接口（与对话请求完全隔离）。
• 各线路详细的鉴权细节、验证置信度分档与宿主 API 路由请参阅 供应线路完整指南（docs/providers.md）。

核心特性

1. 统一订阅中心与多账号池调度

• 聚合总览页：在 设置 → 订阅服务 提供单页总览卡片，集中查看 13 条线路的启停状态、可用账号数与已勾选模型数，支持在线检测 npm 更新并一键升级插件（自动保护本地 link: 开发目录）。
• 统一号池内核：所有线路共享多账号池架构，支持 顺序耗尽（sequential）/ 轮流使用（round-robin）/ 固定当前（sticky） 三种策略；遇到账号级 429 配额耗尽自动按重置窗口冷却换号，遇到全局瞬时过载则原地指数退避，防止抽干号池。
• 本机登录态零侵入收编：支持只读导入本机已登录的 Codex CLI、Claude Code、ZCode、StepCode、Qoder CLI、CodeBuddy 桌面端凭据，以及复用 MiniMax Code 桌面端登录态。导入前仅做 stat 存在性检查，绝不修改或删除第三方客户端文件，也不跨进程抢刷单次轮换令牌。
• 桌面与无头服务器双存储模式：默认使用系统加密密钥环（keyring：Windows DPAPI / macOS Keychain / Linux Secret Service）；无桌面环境的 Linux 服务器可一键切换至 DSH 标准凭据库（credentials：$DSH_HOME/.credentials.yaml，强制 0600 权限），告别安装 gnome-keyring 的繁琐配置。

2. 全共享网络代理与智能网页抓取

• 一处配置、全线生效：在 ChatGPT 设置卡配置的 网络代理（系统代理自动检测 / 自定义代理 / 直连）同时作用于全部 13 条线路的对话、OAuth 登录续期、额度查询与目录拉取，自动绕行回环地址与 NO_PROXY 主机。
• Codex 搜索与 fake-ip 友好的 web_fetch：支持将 DSH 搜索切换为 ChatGPT 订阅侧 Codex 搜索；在 Clash / Mihomo 等开启 fake-ip（198.18.0.0/15）的代理环境下，fetchProvider: auto 会自动用插件抓取器接管 web_fetch，交由远端代理解析域名，解决内置抓取器因本地 DNS 固定报错 WEB_BLOCKED_URL 的痛点。

3. 精细上下文预算、独立压缩路由与前缀缓存保护

• 逐模型能力与窗口覆盖：按上游实时目录与官方注册表精确声明图片/视频模态、思考档位梯子与上下文窗口（支持 1M、512K、272000 等自定义覆盖写法）。
• 独立压缩模型：支持在设置页指定更快或更便宜的跨线路模型专门执行上下文压缩摘要（purpose: 'compaction'），自动处理多模态降级与半截摘要回退。
• 前缀缓存零漂移架构：针对 Kimi Code、MiniMax Code、Claude 等前缀缓存敏感线路，内置计划模式指引尾部一次性投递、PTC tools:sdk 声明冻结、历史工具结果修剪自动跳过（./tool-result-pruner），以及 Kimi 大结果 ref:// 引用投影与 cache_warmup_result 分页补读。

环境要求

• 操作系统：Windows（需内置 PowerShell 以支持 CurrentUser DPAPI）、macOS 或 Linux
• 运行时：Node.js ≥ 22.19（内置 undici 8 的下限，已写入 package.json 的 engines；建议 24 LTS）与 npm
• 宿主版本：DeepSeek Harness @deepseek-ai/dsh 0.1.2-alpha.5 至 0.2.2-rc.1

安装与升级

方式 1：通过 DSH CLI 安装（推荐）

# 若已全局安装 dsh
dsh plugin --profile web add @eddyskywalker/dsh-chatgpt-subscription

# 或通过 npx 执行
npx @deepseek-ai/dsh plugin --profile web add @eddyskywalker/dsh-chatgpt-subscription

如需尝鲜预发布通道，可显式指定 @alpha 标签：

dsh plugin --profile web add @eddyskywalker/dsh-chatgpt-subscription@alpha

方式 2：通过 DSH Web 界面安装

1. 打开 DSH Web 侧边栏的 Plugins（插件） 页面；
2. 输入包名 @eddyskywalker/dsh-chatgpt-subscription 并安装；
3. 按界面提示重载或重启 dsh web（Live Profile 支持热应用更新）。

方式 3：源码软链接（本地开发调试）

git clone https://github.com/Aa728848/dsh-chatgpt-subscription.git
cd dsh-chatgpt-subscription
npm install
npm run build

# Linux / macOS
npx @deepseek-ai/dsh plugin --profile web add "link:/absolute/path/to/dsh-chatgpt-subscription"

# Windows PowerShell
npx @deepseek-ai/dsh plugin --profile web add "link:C:\absolute\path\to\dsh-chatgpt-subscription"

快速上手

GitHub で README 全文を読む →