前言¶

DeepSeek Harness 采用“一切皆插件”的架构，允许开发者通过扩展组件丰富系统功能。在集成外部模型时，授权流程往往需要额外的编排与安全处理。dsh-codex-auth 插件旨在解决这一问题，它为 DeepSeek Harness 提供了 ChatGPT/Codex 的授权能力，允许用户通过 Harness 官方授权服务完成登录，并启用 llm-pi-ai/openai-codex 模型路线。

插件简介¶

这是一个独立的工作区插件，主要维护者为 mhdfy1988，采用 MIT 许可证。它通过 Cordis 插件 ID codex-auth 注入功能，负责处理 ChatGPT 登录的授权编排、浏览器安全远程接口以及模型路线的开关控制。

核心能力¶

该插件主要承担以下职责：

1. 登录入口扩展：在“设置 → 模型”的 openai-codex 提供方卡片中增加 ChatGPT 登录操作。
2. 官方授权集成：调用 Harness 官方授权服务完成登录流程。
3. 模型路由管理：提供模型路线开关，启用 llm-pi-ai/openai-codex 路由。
4. 安全接口：提供授权编排与浏览器安全远程接口。
5. 元数据读取：读取登录状态、凭据种类、是否可写等元数据。

安装与构建¶

本包的安装、升级和卸载应使用 packages/plugin 构建出的 dsh-codex-auth-*.tgz 安装包。根目录下的 dsh-codex-auth-cli-proof 是私有的阶段一 CLI 验证程序，不属于交付范围。

若需自行构建，请使用以下命令：

pnpm.cmd install
pnpm.cmd --filter dsh-codex-auth test
pnpm.cmd --filter dsh-codex-auth build

生成版本化安装包：

Push-Location packages/plugin
npm.cmd pack --pack-destination ..\..\artifacts
Pop-Location

使用方式¶

在获得安装包后，将其安装至 Harness。安装完成后，登录操作入口会出现在“设置 → 模型”的 openai-codex 提供方卡片中。点击该卡片中的登录操作，会调用 Harness 官方授权服务完成认证，并自动启用 llm-pi-ai/openai-codex 模型路线。

注意事项与边界¶

使用本插件时需注意以下事实与限制：

1. 权限与安全

   • 浏览器接口只能读取“是否已登录、凭据种类、是否可写”等元数据，不能读取 access token 或 refresh token。
   • OAuth 地址和设备码只在授权运行中返回，成功、取消或失败后由宿主清除。

2. 功能范围

   • 本包不修改 agent-loop，不实现第二套 OAuth，不另建 Token 文件，也不静默回退到旧链路。
   • OAuth grant 的到期刷新读改写和跨进程锁由 Harness 官方 llm-pi-ai 与 credentials-local 模块覆盖。

3. 迁移注意事项

   • 从早期的 link: 开发安装迁移到 .tgz 时，应先通过 Harness 插件命令卸载旧包。
   • 确认 Profile 下的 node_modules/dsh-codex-auth 不再是指向源码工作区的 junction（特别是 Windows 系统）。
   • Windows 上残留的 junction 会让 pnpm 沿旧链接读取开发依赖，并在导入正式包时触发 EPERM。必须清除该残留链接后再安装版本化 .tgz，不要回退到 link: 掩盖问题。

4. 其他

   • 正式凭据的“退出登录”按钮未实现点击逻辑，以免删除用户当前登录；本包的删除范围由自动化测试覆盖。