jasper-zsh/dsh-plugin-llm-codex0

dsh-plugin-llm-codex

ChatGPT/Codex subscription auth for DSH: OAuth device-code login, automatic token refresh, and a settings panel; feeds the openai-codex model route via the CODEX_OAUTH_ACCESS_TOKEN credential ref.

AI 分析

核心用途是简化 DSH 对 ChatGPT/Codex 服务的接入与授权管理。适合拥有 Codex 订阅并希望在 DSH 中直接调用该模型的用户,支持对话内工具查询状态。

パッケージ
dsh-plugin-llm-codex
バージョン
0.1.0
最終更新
2026/08/14

インストール

検証済み bundle がないか、互換性チェックに失敗しています。先にリポジトリの説明を読んでください。 README 全文を読む ↗

ドキュメント

README 全文を読む ↗

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,状态响应不会返回原始令牌。