前言¶
在 DeepSeek Harness 桌面版里接 OpenAI 模型，常见做法是自备 OpenAI Platform API key，按量计费、额度与 ChatGPT 订阅分开管理。若你本机已通过官方 Codex CLI 用 ChatGPT 登录，并持有 Codex 订阅额度，更希望在同一份桌面环境里直接走订阅路由、在原生设置页查看账号与剩余额度，而不是再维护一套 API key。
下面介绍社区插件 dsh-openai-auth（维护者 solstice621，分类：客户端）：在 Harness 中识别或完成本机 Codex 的 ChatGPT 登录，复用同一账号的 Codex 订阅额度，并提供原生「OpenAI / Codex」设置页。插件为独立社区作品，与 DeepSeek、OpenAI 官方插件无关联；不增加额度，也不改变 OpenAI 的账号权限或限速规则。README 标明 MIT 许可，无需 OpenAI Platform API key。
这是什么¶
dsh-openai-auth 由原生 Harness bundle、后端 provider 与客户端设置页组成：读取本机 Codex 登录缓存（或经浏览器完成官方授权），通过官方 Codex CLI 的 app-server 做续期与额度查询，并把模型目录同步到 Harness 的模型选择器。对话能力复用 Harness adapter 的流式输出、工具调用、历史 replay 与图片处理。
目录页：skillhub.cn/plugins/solstice621/dsh-openai-auth
源码与说明：github.com/solstice621/dsh-openai-auth
核心功能¶
资料中的能力概览如下（使用方式见 README 功能表）。
| 能力 | 要点 |
|---|---|
| 复用已有登录 | 识别本机 Codex 的 ChatGPT 登录缓存（当前支持 file 存储：CODEX_HOME/auth.json 或默认 ~/.codex/auth.json） |
| 浏览器登录 | 在设置页发起官方 Codex 启动的 ChatGPT 浏览器授权；与本机 Codex 共用登录，重新登录会切换本机 Codex 账号 |
| 自动 / 手动续期 | token 临近过期由官方 Codex CLI 更新缓存；设置页「刷新授权」立即请求续期；推理请求在距过期不足五分钟时也会自动续期 |
| 订阅额度 | 展示官方返回的多额度窗口、剩余比例与重置时间；打开页先显示上次快照，后台再刷新；后端默认每 5 分钟刷新（可配置） |
| 连接开关 | 「停用此连接」仅阻止 Harness 侧新推理，不退出 Codex、不删缓存 |
| 模型自动同步 | 启动时及默认每 6 小时通过 model/list 同步目录；设置页可手动刷新；并为旧版 Harness 目录补齐 GPT-6.1 Sol（low / medium / high / xhigh / max） |
| 系统代理 | macOS 在无 Harness 显式代理时，可按当前系统 HTTP/HTTPS 代理运行（PAC / SOCKS-only 暂不支持） |
凭据方面：插件不把 access/id/refresh token 写入 Harness 设置或浏览器存储；登录与续期由官方 Codex CLI 写入 Codex 缓存。apiKey 通道传递的是 Codex OAuth access token，不接受 OpenAI Platform API key。
安装与启用¶
安装前需本机已有官方 Codex CLI，且账号为 ChatGPT 登录。README 已验证组合为 macOS + DeepSeek Harness Desktop 0.2.0-rc.2 + Codex CLI 0.154.0；插件当前绑定 Harness 0.2.0-rc.2 接口，其他版本尚未验证。Keychain-only 存储、Windows 与 Linux 桌面环境尚未验证。
1、在终端确认 Codex 已用 ChatGPT 登录（未登录可先 codex login，也可装插件后从界面登录）：
codex login status
2、在 Harness 左侧打开「插件」→「添加插件」。
3、输入 GitHub 包地址，或从 Releases 下载 .tgz 后填写其绝对路径：
github:solstice621/dsh-openai-auth#v0.3.2
4、安装并启用插件，完全退出并重新打开 Harness。
5、打开左下角「更多」→「设置」→ OpenAI / Codex，确认账号已连接。
6、在会话模型选择器中选择 OpenAI · Codex 额度 下的模型，例如 GPT-6.1 Sol。
仓库提供可直接运行的 JavaScript 与原生 client entry，不需要 prepare、postinstall 或第三方安装脚本，也无需改 App 安装包或 asar。若启动时出现 DeepSeek 欢迎页，可选「添加 API Key」→「稍后配置」再使用 Codex 模型。
桌面进程 PATH 若找不到 codex，先用 command -v codex 查路径，在桌面 profile 的 cordis.patch.yml 中配置插件（修改后除连接开关外需重启 Harness）：
- id: dsh-openai-auth
name: dsh-openai-auth
config:
codexCommand: /absolute/path/to/codex
# 可选；默认 CODEX_HOME 或 ~/.codex
# codexHome: /absolute/path/to/.codex
# useSystemProxy: true
# refreshSkewSeconds: 300
# modelRefreshMinutes: 360
# modelDiscoveryCommand: /absolute/path/to/current/official/codex
# modelCachePath: /absolute/path/to/models.json
常用配置项：codexCommand（默认 codex）、quotaRefreshMinutes（默认 5，范围 1–1440）、modelRefreshMinutes（默认 360）、refreshSkewSeconds（默认 300）。额度快照缓存默认在 ~/.dsh/cache/dsh-openai-auth/<CODEX_HOME 哈希>/quota.json，可用 quotaCachePath 调整。
典型用法¶
使用已在 Codex 登录的账号
进入 OpenAI / Codex 设置页，应能看到邮箱（可隐藏）、订阅类型、连接状态与授权有效期，无需复制 token。
切换或新登录
点击「登录 ChatGPT」或「重新登录 ChatGPT」，浏览器打开官方页面；完成后页面自动更新。等待十分钟后会取消本次尝试；取消不会主动全局退出 Codex。
查看与刷新额度
打开设置页先看上次成功读取的快照，后台通过 codex app-server 刷新；也可点「刷新额度」。DSH 运行且连接启用时，即使未打开设置页，后端也会按周期保存成功快照。
停用 Harness 侧 Codex
「停用此连接」后 provider 不再发起新推理，本机 Codex 登录与缓存保留；需要时再「启用此连接」。
换模型
在会话模型选择器切换到 OpenAI · Codex 额度 下可用模型；插件不会自动改写已有会话的模型，需手动切换。
适用场景与注意¶
适合谁
已在 macOS 上使用 DeepSeek Harness Desktop 0.2.0-rc.2、本机安装 Codex CLI 且用 ChatGPT 登录（file 存储）的用户；希望在桌面 Harness 里用订阅额度对话、在原生 UI 管理授权与额度，而不配置 OpenAI Platform API key。
安装与信任
插件以当前 DSH 进程权限运行，会启动你配置的 Codex 可执行文件并读取 Codex 登录缓存；对话内容按正常模型调用发往 OpenAI。安装前应阅读 GitHub 仓库 源码与 MIT 许可证，仅配置可信的官方 CLI 路径。
权限与平台
模型出现在选择器中不代表账号一定有调用权限；额度与限速由 OpenAI 管理。卸载时先在 Harness 选用其他 provider，再在「插件」页停用或卸载；Codex 自身登录仍由 Codex 管理。
常见问题（摘自 README）
未登录或读不到缓存：确认 ChatGPT 登录；Keychain-only 用户可自行 codex -c cli_auth_credentials_store='file' login。无法启动 Codex：配置 codexCommand 绝对路径后重启。网络或代理变更：检查可达性并重启 Harness 再刷新授权。
结尾¶
dsh-openai-auth 把本机 Codex 的 ChatGPT 订阅登录、续期与额度查询接到 Harness 桌面版的原生设置与模型选择流程中，适合不想单独维护 Platform API key、又要在 DSH 里用 Codex 额度模型的开发者。详情与截图见 GitHub README；社区目录入口：skillhub.cn/plugins/solstice621/dsh-openai-auth。
