@eddyskywalker/dsh-chatgpt-subscription 0.1.0-alpha.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.0-alpha.0 - 2026-08-14
+
+- 新增 DSH Host/Client 双端插件与一级“Codex 订阅”设置入口。
+- 新增 ChatGPT OAuth PKCE、localhost callback、DPAPI TokenStore、刷新和注销。
+- 新增 `codex-chatgpt` LLM Adapter、固定 Responses SSE、vision、reasoning 与工具调用映射。
+- 新增 401 单次刷新重试、DSH 有界 retry policy、取消与安全工具参数校验。
+- 新增 Wham usage 双 bucket/双窗口解析、缓存、节流、连接测试和可访问进度条。
+- 新增 OAuth、路由、DPAPI、Responses、额度与 Client 注册测试。
+- 修复 OAuth 失败详情被状态刷新清空、旧 keep-alive 回调连接复用，以及 refresh token 失效后重复尝试的问题；token exchange 现在显示脱敏错误标识。
+- 修复工具调用 replay 缺失时仍发送孤立 `function_call_output` 导致 Codex 返回 400；现在会补全调用配对，并安全处理被压缩历史中的孤立结果。
+
+这是首个 prerelease；没有稳定版升级承诺。ChatGPT backend compatibility 可能随上游变化。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DSH ChatGPT Subscription contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# DSH ChatGPT Subscription
+
+让 DSH（DeepSeek Harness）通过 ChatGPT 订阅使用 Gpt 系列模型的插件。
+
+插件注册 `codex-chatgpt` Provider（显示名 **“Codex（ChatGPT 订阅）”**），以当前 Windows 用户的 ChatGPT OAuth 登录态访问模型，并在设置页展示账号信息、连接状态与订阅额度。
+
+## 目录
+
+- [功能特性](#功能特性)
+- [模型目录](#模型目录)
+- [环境要求](#环境要求)
+- [安装](#安装)
+- [使用](#使用)
+- [升级、降级与卸载](#升级降级与卸载)
+- [安全边界](#安全边界)
+- [插件路由](#插件路由)
+- [开发与验证](#开发与验证)
+- [故障排查](#故障排查)
+
+## 功能特性
+
+**登录与会话**
+
+- Authorization Code + PKCE（S256）登录，一次性 localhost 回调；
+- 支持 token 刷新、登录取消与账号注销；
+- token 使用 Windows CurrentUser DPAPI 加密存储，明文不发送给 Client。
+
+**模型接入**
+
+- 固定 Codex Responses 地址，支持流式文本、reasoning summary、图片输入与工具调用/结果；
+- 429/5xx 由 DSH retry policy 接管；401 只强制刷新并重试一次，支持 `AbortSignal`；
+- Codex 与 Code review 多窗口额度，60 秒缓存、15 秒上游节流并遵守 `Retry-After`。
+
+**设置页**
+
+- 展示账号（脱敏 email、套餐、账号 ID 后四位）、连接状态与额度；
+- 可访问的进度条、窄窗口/200% 缩放布局、深浅主题与 reduced-motion。
+
+## 模型目录
+
+`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-5.6-luna`、`gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini`、`gpt-5.2`
+
+> 目录只用于展示；账号实际可用的模型由 ChatGPT 套餐、workspace 策略与上游兼容状态决定。
+
+## 环境要求
+
+- Windows（DPAPI 依赖当前 Windows 用户）；
+- 已安装 DSH
+- Node.js 与 npm。
+
+## 安装
+
+### 方式 1：通过 DSH CLI 安装（推荐）
+
+直接从 npm 安装已发布的插件包：
+
+```powershell
+# 如果全局安装了 dsh
+dsh plugin --profile web add @eddyskywalker/dsh-chatgpt-subscription
+
+# 或使用 npx 直接运行
+npx @deepseek-ai/dsh plugin --profile web add @eddyskywalker/dsh-chatgpt-subscription
+```
+
+### 方式 2：通过 DSH 插件市场安装
+
+1. 打开 DSH 界面中的 **插件市场** / **Plugin Market**；
+2. 搜索 `@eddyskywalker/dsh-chatgpt-subscription` 或 `dsh-chatgpt-subscription`；
+3. 点击 **安装**。
+
+### 方式 3：本地开发调试（源码软链接）
+
+如需进行二次开发或本地源码调试：
+
+```powershell
+git clone https://github.com/Aa728848/dsh-chatgpt-subscription.git
+cd dsh-chatgpt-subscription
+npm install
+npm run build
+npx @deepseek-ai/dsh plugin --profile web add "link:C:\absolute\path\to\dsh-chatgpt-subscription"
+```
+
+## 使用
+
+1. 重启 `dsh web`；
+2. 打开 **设置 → Codex 订阅**；
+3. 完成 ChatGPT 登录；
+4. 执行 **测试连接**。
+
+DSH 模型选择器应显示 **“Codex（ChatGPT 订阅）”**。
+
+卸载前建议先在设置页点击 **“注销”**，它会删除 DPAPI 凭据和 Host 内存中的额度缓存
+
+
+若 DSH 已异常退出，可在确认路径后删除凭据文件 `oauth.dpapi`：
+
+- `%DSH_HOME%\storages\dsh-chatgpt-subscription\oauth.dpapi`
+- 未设置 `DSH_HOME` 时为 `%USERPROFILE%\.dsh\storages\dsh-chatgpt-subscription\oauth.dpapi`
+
+> 该文件只能由创建它的 Windows 用户通过 DPAPI 解密。
+
+## 安全边界
+
+- OAuth 回调固定为 `http://localhost:1455/auth/callback`，登录任务五分钟超时，同一时刻只允许一个；
+- OAuth token 只发送到 `https://auth.openai.com/oauth/token`；
+- 模型与额度地址分别固定为 `https://chatgpt.com/backend-api/codex/responses` 和 `https://chatgpt.com/backend-api/wham/usage`，没有 endpoint override；
+- token bundle 使用 Windows CurrentUser DPAPI；明文只经过 Host 内存和 PowerShell stdin/stdout，不进入命令行参数、浏览器、`settings.yaml` 或日志；
+- 工具调用只有在参数是完整 JSON 对象时才产生可执行的 `block-end`；畸形参数终止本次生成；
+- 所有修改状态的路由只接受同源 JSON POST，并校验 `Origin` 与 `Host`。
+
+## 插件路由
+
+所有路由都以 `/api/dsh-chatgpt-subscription` 为前缀：
+
+| 方法 | 路径 | 说明 |
+| --- | --- | --- |
+| GET | `/status` | 查询账号、连接状态与额度 |
+| POST | `/login/start` | 开始 OAuth 登录 |
+| GET | `/login/events?loginId=...` | SSE 订阅登录进度 |
+| POST | `/login/cancel` | 取消登录任务 |
+| POST | `/logout` | 注销并清除凭据与额度缓存 |
+| POST | `/token/refresh` | 刷新 token |
+| POST | `/quota/refresh` | 刷新额度 |
+| POST | `/connection/test` | 测试连接 |
+
+状态响应只包含脱敏 email、套餐、账号 ID 后四位、token 到期时间和额度 DTO。
+
+## 开发与验证
+
+```powershell
+npm run typecheck
+npm test
+npm run build
+npm pack --dry-run
+```
+
+测试使用 mock OAuth、Responses SSE 和 Wham usage，不需要真实 ChatGPT 凭据。真实账号的端到端登录与生成应在独立 DSH profile 中人工验收，避免影响日常 profile。
+
+## 故障排查
+
+| 现象 | 处理 |
+| --- | --- |
+| 1455 端口占用 | 结束旧登录任务或占用该端口的进程后重试；插件卸载会关闭 listener |
+| 登录后仍是 401 | 刷新 token；若刷新 token 已失效，注销并重新登录，不会循环请求 |
+| 额度显示旧数据 | 设置页会保留最后成功值；等待 15 秒节流窗口后手动刷新 |
+| 429 | 插件遵守 `Retry-After`，不会高频轮询；模型请求由 DSH retry policy 有界重试 |
+| 模型不可用 | 检查 ChatGPT 套餐、workspace 权限与当前模型可用性 |
+| DPAPI 读取失败 | 确认 DSH 以创建凭据时的同一 Windows 用户运行；必要时清理凭据后重新登录 |

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# Add exactly one dual-face plugin row to the DSH web profile. The host half
+# mounts OAuth/status routes; package.json's dsh.client declaration loads the
+# browser half from exports["./client"].
+- insert:
+    - id: dsh-chatgpt-subscription
+      name: '@eddyskywalker/dsh-chatgpt-subscription'