前言¶
在 DSH 的插件机制里，Provider 可以以插件形式扩展。如果你有 ChatGPT 订阅，并希望在 DSH 会话中使用 Gpt 系列模型，@eddyskywalker/dsh-chatgpt-subscription 提供了一条接入路径。下面介绍它的定位、核心能力、安装启用方式，以及需要关注的凭据存储边界。
这是什么¶
@eddyskywalker/dsh-chatgpt-subscription 是一个 DSH 插件，用于注册 codex-chatgpt Provider，显示名为 Codex（ChatGPT 订阅）。它让 DSH 以当前 Host 用户的 ChatGPT OAuth 登录态访问 Gpt 系列模型，并围绕登录、额度、搜索、图像生成、设置页和子代理配置提供配套能力。
npm 包 author 为 eddyskywalker，GitHub 仓库为：
https://github.com/Aa728848/dsh-chatgpt-subscription
资料未提供许可证信息。安装前建议先检查源码与仓库许可证。
核心能力¶
登录与凭据¶
插件使用 Authorization Code + PKCE（S256）登录，并通过一次性 localhost 回调完成。它支持 token 刷新、登录取消与账号注销。
凭据处理上：
- Windows 使用 CurrentUser DPAPI 加密存储 token；
- Linux 使用当前用户独占的
0600文件存储； - token 不会进入浏览器、
settings.yaml或日志； - OAuth token 只发送到
https://auth.openai.com/oauth/token； - 模型、图片、搜索与额度地址固定，且没有 endpoint override。
模型接入¶
插件固定 Codex Responses 地址，支持流式文本、reasoning summary、图片输入与工具调用/结果。它原样转发 DSH 工具 schema，并兼容 pwsh、powershell、bash、sh、shell。
错误处理方面，429/5xx 由 DSH retry policy 接管；401 只强制刷新并重试一次，并支持 AbortSignal。
模型目录包括：
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.5
gpt-5.4
gpt-5.4-mini
gpt-5.3-codex-spark
其中 5.6 Sol、Terra、Luna 默认使用 272K 有效上下文，可在设置中选择最高 1M。账号实际可用模型仍由 ChatGPT 套餐、workspace 策略与上游兼容状态决定。
设置、搜索与图像¶
设置页会展示脱敏 email、套餐、账号 ID 后四位、连接状态、额度与订阅增强功能开关。
插件还提供以下能力：
- ChatGPT 订阅侧 Codex 搜索 provider，可在设置页切换 DSH 默认搜索或 Codex 订阅搜索；
codex_image_generate工具，生成图片后通过 DSH 附件系统保存并在会话中渲染；- 可选 composer 快捷用量徽标，按当前
codex-chatgpt模型显示最紧张窗口的剩余额度。
子代理¶
插件提供独立子代理设置页。该页面可全局选择任意 Provider/模型，并配置思考深度、子代理上下文、最大嵌套深度和子代理数量上限。
环境要求¶
环境要求为：
- Windows 或 Linux；
- 已安装 DSH；
- Node.js 与 npm；
- Windows 需要提供 Windows PowerShell，以使用 CurrentUser DPAPI；
- Linux 需要 Host 用户拥有可写的
~/.dsh或$DSH_HOME，凭据文件使用0600，目录使用0700。
Linux 的凭据文件没有应用层加密，依赖文件与目录权限隔离；不要复制、打印或提交该文件。Windows 凭据文件只能由创建它的用户通过 DPAPI 解密。
安装¶
通过 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
通过 DSH 插件市场安装¶
- 打开 DSH 界面中的插件市场。
- 搜索
@eddyskywalker/dsh-chatgpt-subscription或dsh-chatgpt-subscription。 - 点击安装。
本地源码调试¶
如果要从源码调试，可以克隆仓库并构建：
git clone https://github.com/Aa728848/dsh-chatgpt-subscription.git
cd dsh-chatgpt-subscription
npm install
npm run build
构建完成后，再通过 npx 将本地 link 路径添加到 DSH。
启用¶
安装后按以下步骤启用：
- 重启
dsh web。 - 打开
设置 → Codex 订阅。 - 完成 ChatGPT 登录。
- 执行
测试连接。 - 在模型选择器中选择
Codex（ChatGPT 订阅）。 - 如需调整子代理，打开独立子代理设置页，配置子代理模型、思考深度、子代理上下文、最大嵌套深度和数量上限。
路由接口¶
插件路由以 /api/dsh-chatgpt-subscription 为前缀，提供状态、登录、注销、刷新、测试连接与偏好更新接口。
卸载与凭据清理¶
卸载前建议先在设置页点击 注销。该操作会删除当前平台的凭据和 Host 内存中的额度缓存。
适用场景与注意¶
这个插件适合已有 ChatGPT 订阅、希望把 Gpt 系列模型接入 DSH 的开发者。需要注意：
- 插件以当前 dsh 进程的权限运行，并以当前 Host 用户的 ChatGPT OAuth 登录态访问模型；安装前建议检查源码与仓库许可证。
- Linux 凭据文件没有应用层加密，依赖
0600文件与0700目录权限隔离；不要复制、打印或提交该文件。 - Windows 凭据文件只能由创建它的用户通过 DPAPI 解密。
- 账号实际可用模型由 ChatGPT 套餐、workspace 策略与上游兼容状态决定。
结尾¶
这个插件把 ChatGPT 订阅接入 DSH 的流程收敛为安装、登录、测试连接、选择 Provider，并在设置页维护搜索、额度与子代理配置。仓库地址为：
https://github.com/Aa728848/dsh-chatgpt-subscription
