dsh-plugin-llm-codex

让 DeepSeek Harness（DSH） 通过 ChatGPT/Codex 订阅调用 openai-codex 模型，无需配置 OpenAI API Key。

插件提供 OAuth 设备码登录、令牌持久化与自动刷新、Web 设置面板，以及可在对话中调用的认证工具。

[!IMPORTANT] 本插件负责 Codex OAuth 认证，不负责创建模型路由。首次使用时仍需在 DSH 设置中声明 openai-codex provider，详见快速开始。

功能特性

• 免 API Key：使用 ChatGPT 账号完成 OAuth 设备码授权。
• 自动维护令牌：通过 DSH credentials 服务保存 access/refresh token，并在 access token 到期前自动刷新。
• 独立凭据存储：不读写 ~/.codex/auth.json，避免影响 Codex CLI 的登录状态。
• Web 设置面板：查看登录状态、账号、订阅计划、限流窗口用量、令牌到期时间及可用模型。
• 对话内认证工具：支持登录、状态查询和登出，无需离开当前会话。
• 同源 HTTP API：为设置面板和外部状态检查提供 no-store JSON 端点。

快速开始

1. 获取并构建插件

需要已安装 DSH、Node.js 和 pnpm。

git clone https://github.com/jasper-zsh/dsh-plugin-llm-codex.git
cd dsh-plugin-llm-codex
pnpm install

pnpm install 会通过 prepare 脚本自动构建 lib/。也可以随时手动执行 pnpm build。

2. 安装到 Web profile

在插件仓库目录中运行：

dsh plugin --profile web add "$PWD"

如果 dsh 不在 PATH 中，可以直接调用 DSH 构建产物：

node /lib/bin.js plugin --profile web add "$PWD"

该包不是 profile bundle；安装时若出现 declares no dsh.bundle 提示属于正常现象，下一步会显式挂载插件。

3. 挂载插件

编辑 $DSH_HOME/profiles/web/cordis.patch.yml（默认路径为 ~/.dsh/profiles/web/cordis.patch.yml），将下面的 patch 项合并到现有顶层数组中：

- insert:
    - id: llm-codex
      name: dsh-plugin-llm-codex

如果文件当前内容为 []，直接用上面的内容替换即可；如果已有其他 patch，请保留它们并追加该项。

4. 配置模型路由

编辑 $DSH_HOME/settings.yaml（默认路径为 ~/.dsh/settings.yaml），加入：

llm-pi-ai:
  providers:
    openai-codex:
      apiKeyEnv: CODEX_OAUTH_ACCESS_TOKEN

apiKeyEnv 在这里是 DSH 凭据引用，而不是需要手动填写的环境变量。插件登录成功后会写入同名凭据， 会在每次请求时解析最新值。