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 流程：
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
使用方法
# 全球版
hermes auth add minimax-oauth
# 中国版
hermes auth add minimax-cn-oauth
# 查看状态
hermes auth list端点信息
| 区域 | Portal Base | Code Endpoint | Token Endpoint |
|---|---|---|---|
| Global | https://api.minimax.io | /oauth/code | /oauth/token |
| China | https://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 刷新，无需每次重新授权