dsh-gpt-auto-proxy
⚠️ 免责声明（请务必先读）
- 本项目是非官方的个人项目，与 OpenAI、ChatGPT、Codex 以及任何上游服务提供方均无任何隶属、合作、授权或背书关系。相关名称与商标归各自所有者。
- 仅供个人学习与技术研究（协议转换、SSE 透传、本地进程托管、配置界面等工程实现）。
- 本项目做的事是：把你自己的订阅凭证在本机转换成一个 OpenAI 兼容的本地接口，供你自己机器上的工具调用。这不是官方支持的能力。
- 使用本项目的一切后果由使用者自行承担，包括但不限于账号被限流、降级、暂停或封禁，以及由此产生的订阅费用与法律责任。
- 禁止商业转售、二次分发接口、对外提供付费/免费服务、批量滥用、账号池、凭证共享，以及任何形式的规避付费与计费。
- 是否遵守上游服务条款（ToS / AUP）完全由使用者自己负责。不确定自己的用法是否合规，就请不要使用。
一句话简介
把自己的 ChatGPT 订阅凭证，在本机转成一个 OpenAI 兼容的本地接口，并交给 DSH 插件托管：自动启停、额度只读展示、以及一次极小真实调用判断「现在到底能不能用」。
适合谁用
- 有合法有效订阅、只想在自己这台机器上自用的个人开发者；
- 已经习惯本地代理（如 Clash 类工具）与 Node.js，能自己看懂配置文件的人；
- 想顺手在 DSH 设置页里看一眼 5 小时 / 7 天额度窗口的人。
不适合谁用
- 想把它做成对外 API、卖给别人、或给一群人共用的人（本项目不提供这些能力，也不允许这样用）；
- 没有自己的订阅、想找一条绕过付费的路子的人；
- 期待「一键装完永久免维护」的人（上游接口是私有的，随时可能变化）。
它做什么 / 它不做什么
它做什么
- 在
127.0.0.1:<LOCAL_PORT>起一个只监听本机回环地址的 HTTP 服务，把 OpenAI Responses 风格的请求清洗后转发到上游，SSE 原样流回； - 凭证失效（401）时用
refresh_token自动刷新，并按文件修改时间重载凭证； - 提供一个只读的额度查询接口，供设置页显示 5 小时 / 7 天用量；
- 作为 DSH 插件：DSH 启动时拉起本地服务，DSH 退出时一并回收；端口已被占用时只复用、不抢占；
- 可选地发一次极小的真实调用判断链路是否真的通（会消耗极少量额度）。
它不做什么（明确划界）
- ❌ 不做账号池：凭证模型是单文件、单账号，没有多账号轮换、没有池化调度；
- ❌ 不做批量注册：不包含任何注册、验证码、批量开号相关的逻辑；
- ❌ 不提供凭证共享：不导出凭证、不中转他人凭证、没有「分享给别人用」的通道；
- ❌ 不代理他人流量：默认只监听回环地址，设计上不面向局域网/公网提供服务，严禁改成对外监听；
- ❌ 不绕过付费：不修改计费、不伪造用量、不规避额度限制；
- ❌ 不提供凭证获取流程：不包含登录/注册脚本，凭证必须你自己通过官方途径获得。
工作原理
你的客户端（curl / SDK / 编辑器插件 / DSH 模型连接）
│ ① 发 OpenAI Responses 风格请求，Authorization: Bearer <任意占位串>
▼
本机 dsh-gpt-auto-proxy —— 只监听 127.0.0.1:<LOCAL_PORT>
│ ② 清洗请求：整理字段、把系统指令提到顶层、剔除上游不认的字段
│ ③ 读 <YOUR_TOKEN_FILE> 里的 access_token（只读，页面不显示内容）
▼
可选的本机 HTTP 代理（默认 http://127.0.0.1:<PROXY_PORT>，可关闭）
▼
上游服务（订阅所属的对话服务后端）
│ ④ 鉴权、限流、生成
▼
▲ ⑤ SSE 分片原样流回客户端
要点：
- 凭证始终留在本机，不经过任何第三方服务器；
- 服务的入站请求只接受本机回环地址；
- 日志里的凭证一律打码（只留首尾若干位），不落明文。
安装与配置
环境要求
- Node.js ≥ 22（用到内置
fetch、AbortSignal.timeout）； - DSH（可选：
bridge/bridge.mjs也能脱离 DSH 单独运行）； - 你自己的订阅账号与对应的凭证文件；
- 能访问上游的网络环境；如需代理，自备本机 HTTP 代理。
一、准备凭证文件
本项目不提供登录流程。请按官方客户端的方式自行完成一次登录，得到一个形如下面的文件：
{
"access_token": "<ACCESS_TOKEN>",
"refresh_token": "<REFRESH_TOKEN>",
"account_id": "<ACCOUNT_ID>",
"expires_at": 0
}
- 路径建议：
<YOUR_TOKEN_FILE>（例如放在你的用户目录下，不要放进任何代码仓库）； - 文件权限建议设为「仅本人可读」，因为它可以直接调用你的账号；
- 绝对不要公开、截图、贴进 issue 或聊天记录。
二、装进 DSH（插件形态）
把本目录放到你的 DSH profile 下：
<DSH_HOME>/profiles/<PROFILE>/node_modules/dsh-gpt-auto-proxy在 profile 的
package.json里登记两处："dependencies": { "dsh-gpt-auto-proxy": "file:node_modules/dsh-gpt-auto-proxy" }, "dsh": { "profile": { "bundles": ["dsh-gpt-auto-proxy"] } }dsh.profile.bundles才是真正的启用入口；组合包自带的cordis.patch.yml会在组合时被应用，因此不要再往 profile 的cordis.patch.yml里手写insert（会重复注册）。重启 DSH，设置页出现 「订阅服务 / 用量」 即为成功。
三、配置文件
复制 config.example.json 为 <DSH_HOME>/gpt-auto-proxy.json，按需修改（缺省字段自动使用默认值）：
| 字段 | 默认 | 说明 |
|---|---|---|
autoStart |
true |
DSH 启动时是否自动拉起本地服务 |
port |
<LOCAL_PORT>（默认 8787） |
本地监听端口；被占用则复用，不抢 |
proxy |
http://127.0.0.1:<PROXY_PORT> |
出网代理；空字符串 = 不走代理 |
tokensFile |
<DSH_HOME>/gpt-auto-proxy/tokens.json |
凭证文件路径（只读，界面只显示路径） |
bridgeEntry |
插件自带实现 | 想接外部实现时指过去 |
usageUrl |
上游额度接口 | 额度查询地址 |
usageCacheSeconds |
60 |
额度缓存秒数 |
canaryModel |
gpt-6-sol |
真实调用探活用的模型；账号不支持时换一个可用的 |
canaryTimeoutMs |
20000 |
探活超时 |
probeUrl / probeCacheSeconds |
上游首页 / 6 |
连通性探测，仅作辅助信息 |
外部路径也可用环境变量覆盖：GPT_PROXY_BRIDGE_ENTRY、GPT_PROXY_TOKENS_FILE（留空即不启用）。
四、独立运行（不装 DSH）
CODEX_BRIDGE_PORT=<LOCAL_PORT> \
CODEX_BRIDGE_PROXY=http://127.0.0.1:<PROXY_PORT> \
CODEX_BRIDGE_TOKENS=<YOUR_TOKEN_FILE> \
node bridge/bridge.mjs
可用端点：
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/responses |
转发到上游，SSE 流回 |
| GET | /v1/models |
可用模型列表 |
| GET | /v1/usage |
账号额度（5 小时 / 7 天窗口） |
| GET | /health |
健康检查与凭证状态（不含凭证原文） |
使用示例
以下
sk-local-dummy是假 token，仅用于占位——本地服务不校验它，真正的凭证由服务自己去读<YOUR_TOKEN_FILE>。
curl
curl http://127.0.0.1:<LOCAL_PORT>/v1/responses \
-H "Authorization: Bearer sk-local-dummy" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"input": "用一句话解释什么是 SSE。",
"stream": false
}'
流式：
curl -N http://127.0.0.1:<LOCAL_PORT>/v1/responses \
-H "Authorization: Bearer sk-local-dummy" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-sol","input":"写一个三行的 Python 循环","stream":true}'
OpenAI 兼容客户端（任意语言）
from openai import OpenAI
client = OpenAI(
base_url="http://127.0.0.1:<LOCAL_PORT>/v1",
api_key="sk-local-dummy", # 占位串，随便填
)
resp = client.responses.create(model="gpt-6-sol", input="你好")
print(resp.output_text)
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'http://127.0.0.1:<LOCAL_PORT>/v1',
apiKey: 'sk-local-dummy', // 占位串
})
const res = await client.responses.create({ model: 'gpt-6-sol', input: '你好' })
console.log(res.output_text)
在 DSH 里用
- 确保插件已启用、本地服务在跑；
- 在模型设置里添加一个自定义连接，地址填
http://127.0.0.1:<LOCAL_PORT>/v1； - 打开设置页「订阅服务 / 用量」看额度与主灯状态。
常见问题（FAQ）
为什么需要我自己准备凭证？
因为本项目不包含登录、注册或凭证获取流程——这是有意的设计。凭证代表你账号的授权，任何"自动帮你搞到凭证"的东西都意味着凭证经过第三方。本项目只做「拿到凭证之后的协议转换」，凭证从哪来、归谁所有，由你自己负责。
有没有被限流或封号的风险？
有，而且不小。 上游对这类非官方接入通常有明确条款限制，检测到异常调用模式（高频、异常 UA、多来源共用、超量并发）可能直接限流或封号。本项目无法、也不会替你规避这些检测。请自行评估风险，不要用重要账号尝试。
为什么不能公开分享 token？
tokens.json（或你的 <YOUR_TOKEN_FILE>）里的 access_token / refresh_token 等同于你账号的登录态。一旦泄露：别人可以用你的账号、消耗你的额度、看你的历史对话，且你无法分辨是谁在用。刷新令牌还可能让你自己的会话被踢下线。所以：不进仓库、不进截图、不进聊天记录、不放进同步盘。
支持哪些请求字段？
实现了 OpenAI Responses 风格的子集：
- 支持：
model、input（字符串或消息数组）、instructions、stream、reasoning.effort、tools/ 工具调用回传、图片输入（取决于账号与模型能力）； - 会被丢弃：
max_output_tokens等上游不接受的字段（不报错，直接剔除）； - 不保证支持：
temperature等采样参数、后台任务、文件上传等更冷门的字段——上游是否接受以实际返回为准。
模型清单是内置的静态列表，上游随时可能增删模型；遇到 400/404 说明该模型当前不可用，换一个即可。
端口被占用了怎么办？
设计上「不抢端口」：如果 <LOCAL_PORT> 上已经有一个同类服务，插件只复用它；如果被其它程序占用，会进入冲突状态并保持不动，不会去杀别人进程。改 port 即可。
界面上的「现在能不能用」是怎么判断的？
不是看端口通不通，而是真的发一次极小调用（约 20 多个 token），按返回结果分类成「可用 / 凭证失效 / 额度用尽 / 网络不通 / 本地服务未运行 / 上游故障 / 请求被拒」。结果缓存 60 秒，页面可见时最多每 5 分钟一次。这会消耗极少量额度，介意就别点。
许可证与致谢
本项目自有代码以 MIT 许可证发布，见 LICENSE。
第三方来源（详见 NOTICE）：
bridge/bridge.mjs里的模型目录字段取自 pi-ai（@mariozechner/pi-ai，作者 Mario Zechner）的 openai-codex provider 数据；仅复制事实性字段，未复制其实现。使用/再分发前请自行核对其许可证。- 请求头中的 OAuth 客户端标识与
originator/ User-Agent 约定，来自 OpenAI 官方开源的 Codex CLI（Apache-2.0）及公开 API 行为；这些是公开常量，不构成任何授权。 - 本项目是 DSH 的第三方插件，依赖其
webServer与客户端注入槽；本仓库不含 DSH 代码。
本仓库不包含上游服务提供方的任何源代码。
再次提醒：合规使用、封号风险、以及上游服务条款的责任，都在使用者本人。
No comments yet. Be the first to write one.