前言¶

在 DeepSeek Harness（DSH）里使用 OpenAI Codex 订阅时，常见做法是单独维护一套 LLM 适配器或额外的凭据存储，再在 Models 里手工对接 provider。DSH 0.2.x 已随 @deepseek-ai/dsh-llm-pi-ai 适配器提供官方的 ChatGPT 登录与 OAuth 流程，但登录、登出、以及把 openai-codex 写进模型配置仍需要一处统一入口。

dsh-codex-account（维护者 yoggu，社区分类：模型推理）在 Plugins → Codex Account 提供账户卡片：登录、取消进行中的授权、登出，并在必要时把 openai-codex provider 补进 Models，无需再装一套 LLM 适配器或自建凭据库。

这是什么¶

插件全名 dsh-codex-account，当前发布版本 v0.2.0（MIT 许可证）。它不负责替 DSH 实现 OAuth，而是调用 Harness 自带的 authorization、credentials 等服务，配合已启用的 llm-pi-ai 适配器，管理适配器名下的单一 ChatGPT 登录；凭据键固定为 llm-pi-ai/openai-codex。

账户卡片与 Codex 图标仅出现在 Plugins 页面，不会出现在 Settings 弹窗里。界面文案支持英文与德文。

核心功能¶

下面能力均来自插件 README 与实现说明，可按需对照使用。

登录与 provider 配置¶

1. 在 Plugins → Codex Account 点击 Sign in with ChatGPT，按 OpenAI 授权页及适配器提示完成流程；授权进行中卡片会更新状态，Cancel sign-in 可中止尚未完成的尝试。
2. 授权成功后，若配置里尚无该项，插件会追加 llm-pi-ai.providers.openai-codex: {}，不改动已有 provider 配置。
3. 若本地已保存登录但 Models 里缺少 openai-codex，卡片会显示 Add to Models；若登录成功但写配置失败，会保留登录并允许修复，无需重新 OAuth。
4. 在 DSH 的 Models 中选择 openai-codex 模型即可使用；插件不会改当前会话已选模型，也不会代发模型请求。

登出¶

Sign out 仅删除本机保存的 llm-pi-ai/openai-codex grant；Models 配置与其他凭据保留，且不是全局 ChatGPT 登出。授权或 provider 配置操作进行中时，账户相关变更会被阻塞。

安全与凭据归属¶

OAuth 与凭据记录由随 DSH 发布的 llm-pi-ai 适配器持有。本插件只通过 authorization 服务发起流程，并仅检查凭据是否存在，不读取、复制、导入或返回 grant 内容；登出时对固定键调用 credential 服务的 deleteRecord。

前端经 DSH 已认证的 /api/dsh-codex-account 通道通信；外链限制为 HTTPS 的 OpenAI/ChatGPT 域名。应把 DSH 与 Plugins 页面的访问视为敏感账户管理，勿分享授权码、token、登录 URL 或凭据文件。

环境与安装¶

要求¶

• Node.js 22.19.0 或更新。
• DSH 0.2.x，且已启用随 DSH 发布的 @deepseek-ai/dsh-llm-pi-ai 适配器，并具备 authorization、credentials、配置编辑器、authenticated connection 等服务。
• 可访问你要授权的 ChatGPT 账户；具体可用模型取决于该账户与适配器目录。

插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 LICENSE，确认符合你的安全策略。

安装¶

从 GitHub 指定 tag 安装（若实际使用的 profile 不是 web，将命令中的 profile 换成你的）：

dsh plugin --profile web add 'https://github.com/yoggu/dsh-codex-account.git#v0.2.0'

也可克隆后 link 本地目录（需保持 checkout 存在；README 含 git clone 示例，此处不重复 clone 步骤）。包内已带 client bundle，无需 build 或额外安装私有 pi-ai 依赖。

替换已安装版本后重启 DSH，并刷新浏览器。

卸载账户 UI（不会自动登出或删除 provider / 旧账户数据；若需清除本机 ChatGPT 登录，请先 Sign out）：

dsh plugin --profile web remove dsh-codex-account

典型用法¶

经过上面的安装与重启，按下面顺序操作即可复现 README 中的流程：

1. 打开 Plugins → Codex Account，点击 Sign in with ChatGPT 并完成授权。
2. 确认 Models 中出现 openai-codex（必要时点 Add to Models）。
3. 在会话里选择 openai-codex 模型进行推理。

仅启用插件不会自动开始授权，也不会修改 provider 配置。

从旧插件迁移¶

自 dsh-codex-sign-in¶

本插件为该包的更名后继，登录/登出、provider 修复、卡片与图标行为一致，凭据键不变，无需重新登录。安装 dsh-codex-account 并确认卡片正常后：

dsh plugin --profile web remove dsh-codex-sign-in

刷新浏览器。模块名现为 dsh-codex-account，bundle 入口 ID 为 codex-account，API 为 /api/dsh-codex-account。

自 dsh-codex-account 0.1.x¶

v0.2.0 不再提供 0.1.x 的自定义多账户 LLM 适配器；改为管理随 DSH 发布的单一 ChatGPT 登录。旧的 accounts 配置、自定义 codex-personal / codex-business 路由、/codex 命令、本地登录 CLI、Codex CLI 导入及账户/token 详情展示均已移除。

• 删除旧版 id: codex-account 里含 accounts、models、transport 等的覆盖项；新版 bundle 不需要账户配置。
• 新请求应走随 DSH 发布的 openai-codex；仍绑定旧自定义路由的会话可能需要改选模型。
• 0.1.x 登录不会自动导入随 DSH 发布的适配器；若无对应凭据，需在新卡片上重新登录。
• 遗留的 $DSH_HOME/codex-accounts.json 与 ~/.codex/auth.json 不会被读取或删除；若仍保留请自行保密。

适用场景与注意¶

适合：已在 DSH 0.2.x 使用随 DSH 发布的 pi-ai 适配器，希望用 ChatGPT 订阅驱动 Codex 模型，并希望在 Plugins 里集中完成登录/登出与 provider 补全的开发者。

注意：

• 卸载本插件不会登出 ChatGPT 或移除 Models 里的 provider 配置。
• 社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装与凭据管理责任在用户侧。

链接¶

• 社区目录：https://www.skillhub.cn/plugins/yoggu/dsh-codex-account
• 源码与 README：https://github.com/yoggu/dsh-codex-account