前言¶
在 DeepSeek Harness（DSH）里走 OpenAI Codex 路由时，常见做法是配置 OpenAI API Key 或环境变量。若你实际持有的是 ChatGPT 账号侧的 Codex OAuth 授权，而不是 API Key，就需要在 Web 模型设置里完成浏览器或设备码登录，并把 grant 交给 DSH 凭据服务管理，同时在界面上看到用量而不是把 access token 暴露给前端。
下面介绍社区插件 dsh-chatgpt-oauth（维护者 zhangnan，分类 admin-security）。它并非 OpenAI 或 DeepSeek 官方插件；可用模型与限额由你的账号和服务端决定。
这是什么¶
dsh-chatgpt-oauth 面向已安装 DSH、并使用带「模型设置」页面的 web profile 的环境。插件在「设置 → 模型 → ChatGPT（openai-codex）」详情卡片中提供登录入口，并在服务端解析 ChatGPT 用量接口，把 5 小时、每周及附加限额、重置时间和 Credits 展示在卡片上。页面只接收登录状态和解析后的用量，不接收 access/refresh token。
源码与说明见 GitHub 仓库 zhangnan/dsh-chatgpt-oauth；社区目录页：skillhub 插件页。当前 npm 包版本为 0.1.2，许可证 MIT。
核心功能¶
- OAuth 登录：在 ChatGPT（
openai-codex）卡片内进行浏览器或设备码登录，无额外设置标签。浏览器 OAuth 使用 PKCE，回调地址为本机localhost:1455/auth/callback；回调成功页使用 DSH 文案。无法使用回调时，可在卡片中粘贴授权码或完整回调地址。 - 凭据托管：OAuth grant 存入 DSH 凭据记录
llm-pi-ai/openai-codex，过期时在服务端串行刷新。 - 用量展示：参考 pi-web 的解析方式，从 ChatGPT 用量接口展示限额与重置信息；用量由插件服务端请求
https://chatgpt.com/backend-api/wham/usage，访问令牌不会返回给浏览器。 - Profile Bundle：安装时自动添加
authorization服务与本插件，无需手工修改cordis.patch.yml。
安装与启用¶
环境要求：Node.js 22.19+、已安装 DSH，并使用 web profile。README 注明在 DSH 0.1.6-alpha.2 上验证过。
从 npm 安装：
dsh plugin --profile web add -w dsh-chatgpt-oauth
从 GitHub Release 安装（示例为 v0.1.2）：
dsh plugin --profile web add -w 'github:zhangnan/dsh-chatgpt-oauth#v0.1.2'
安装后重启 dsh web，打开「设置 → 模型 → ChatGPT」。若 profile 中已有手工添加的 authorization 或 dsh-chatgpt-oauth 条目，先移除旧条目再安装，避免重复挂载；已保存的账号凭据不需要删除。
典型用法¶
- 打开 DSH Web 的「设置 → 模型」，找到 ChatGPT（
openai-codex）卡片。 - 点击「浏览器登录」，在 OpenAI 页面完成授权；本机回调端口需可用。无浏览器环境可选「设备码登录」。
- 登录完成后，卡片会读取用量；点击「刷新」可手动重新查询。退出账号只删除本插件使用的 DSH 凭据记录。
若账号授权成功但模型不可用，先检查 openai-codex 路由是否配置了 apiKeyEnv：该字段会覆盖账号 OAuth 凭据，需要移除。端口 1455 已被其他应用占用时，关闭其他登录流程后重试。
要在 DSH 模型设置里显式列出新版 pi-ai 内置目录中的 gpt-6-sol 和 gpt-6-luna，在 models 中只写 id 即可；不要在路由或模型的 compat 中重复声明 supportsOpenAIGrammarTools、supportsAdditionalTools、supportsToolSearch。若 models 已存在，保留原有条目后追加两个 ID，因为该列表会替换整个可用目录。
适用场景与注意¶
适合谁：在本机或受控环境运行 DSH Web，希望用 ChatGPT 账号 OAuth 驱动 openai-codex 路由，并在模型设置里查看 Codex 用量，而不是在前端或配置文件里长期存放 API Key 的场景。
安全与限制：插件以当前 DSH 进程权限运行；安装前应阅读源码与 MIT 许可证，并只在信任的本机 DSH 服务上使用。勿把 DSH 凭据文件或授权回调 URL 提交到公开仓库。用量接口或字段可能变化；查询失败不会影响已保存的登录凭据。插件不会替你购买订阅，也不能绕过账号权限或配额。
结尾¶
dsh-chatgpt-oauth 把 ChatGPT OAuth 登录、DSH 凭据刷新和 Codex 用量展示收拢到 Web 模型设置的一张卡片里，适合已用 DSH web profile 的开发者。更多信息见 社区目录页 与 GitHub 仓库。
