dsh-plugin-llm-codex

4. 配置模型路由

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

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

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

使用方式

Web 设置面板

“Codex 订阅”页面提供：

• 登录、重新登录、登出和刷新状态；
• 一次性设备码及验证链接；
• ChatGPT 账号和订阅计划；
• 主、次限流窗口用量；
• access token 到期时间；
• openai-codex 路由状态和可用模型。

对话内工具

工具	作用
codex_auth_login	发起设备码登录；force: true 可重新登录或切换账号。
codex_auth_status	查询登录、路由、模型及订阅用量状态。
codex_auth_logout	清除已保存的 OAuth 凭据并取消待处理的登录。

例如，可直接让 Agent“登录 Codex”或“检查 Codex 登录状态”。

HTTP API

方法	路径	说明
GET	/llm-codex/status.json	获取状态；传入 ?usage=0 可跳过订阅用量查询。
POST	/llm-codex/login	发起登录；JSON body 为 {"force": false}。
POST	/llm-codex/logout	清除凭据并登出。

所有响应均设置 Cache-Control: no-store，状态响应不会返回原始令牌。