Hermes MiniMax OAuth Skill#

为 Hermes Agent 添加 MiniMax OAuth 登录支持。

功能#

通过 hermes auth add minimax-oauth 命令实现 MiniMax 全球版或中国区 OAuth 登录。

工作原理#

OAuth 流程（user_code + PKCE）#

MiniMax 使用非标准的 user_code OAuth 流程，区别于常见的 device_code 流程：

text

1. POST /oauth/code          → 获取 user_code + verification_uri
2. 用户在浏览器打开 verification_uri，输入 user_code
3. POST /oauth/token         → 用 user_code + PKCE verifier 兑换 access_token
4. access_token 保存到 ~/.hermes/auth.json

关键差异：

• 端点： /oauth/code 和 /oauth/token（不是 /v1/oauth/*）
• grant_type： urn:ietf:params:oauth:grant-type:user_code
• 需要 PKCE（S256 code_challenge）
• scope： group_id profile model.completion

修改的文件#

hermes_cli/auth.py#

• 新增常量： DEFAULT_MINIMAX_OAUTH_*（portal URL、端点、client_id、scope）

• 新增函数：

  • _generate_pkce_pair() — 生成 PKCE verifier/challenge
  • _minimax_device_code_login() — 完整 OAuth 流程
  • resolve_minimax_oauth_runtime_credentials() — 运行时凭证解析
  • get_minimax_oauth_auth_status() — 登录状态查询
  • _refresh_minimax_access_token() — access_token 刷新
  • _is_minimax_token_expiring() — 过期检查

• 新增 ProviderRegistry 条目： minimax-oauth、 minimax-cn-oauth

hermes_cli/runtime_provider.py#

• _resolve_explicit_runtime() 中添加 minimax-oauth / minimax-cn-oauth 处理块

agent/auxiliary_client.py#

• OAuth provider 路由中添加 MiniMax 处理路径

hermes_cli/auth_commands.py#

• auth_add_command 支持 hermes auth add minimax-oauth 和 hermes auth add minimax-cn-oauth

使用方法#

bash

# 全球版
hermes auth add minimax-oauth

# 中国版
hermes auth add minimax-cn-oauth

# 查看状态
hermes auth list

端点信息#

区域Portal BaseCode EndpointToken EndpointGlobalhttps://api.minimax.io``/oauth/code``/oauth/tokenChinahttps://api.minimaxi.com``/oauth/code``/oauth/token

• Client ID: 78257093-7e40-4613-99e0-527b14b39113
• Scope: group_id profile model.completion
• Inference URL: https://api.minimax.io/v1 (global) / https://api.minimaxi.com/v1 (CN)

注意事项#

• MiniMax 没有 标准的 device_code OAuth（ /v1/oauth/* 是错的）
• 必须使用 PKCE S256，user_code 需配合 code_verifier 使用
• 登录后 token 通过 refresh_token 刷新，无需每次重新授权