feat(cli): make hermes portal the human-readable Portal onboarding alias

`hermes portal` (no subcommand) now runs the one-shot Nous Portal onboarding
— OAuth login, switch provider to Nous, offer Tool Gateway — identical to
`hermes setup --portal` and the human-readable alias for
`hermes auth add nous --type oauth` (which still works).

The prior status default moves to `hermes portal info`; `status` is kept as a
hidden back-compat alias. `open`/`tools` subcommands are unchanged.

User-facing hints and docs (status.py, conversation_loop 401 guidance,
SystemPage, README, website docs + zh-Hans) now point at `hermes portal` /
`hermes portal info`. `--manual-paste` references keep the explicit auth
command since `hermes portal` does not expose that flag.
This commit is contained in:
kshitijk4poor
2026-06-04 01:19:28 +05:30
parent 39fee4f3bc
commit da4f407e51
21 changed files with 212 additions and 58 deletions
@@ -126,12 +126,15 @@ OAuth 需要浏览器,但回调的 loopback 运行在 Hermes 所在的机器
### 查看当前配置状态
```bash
hermes portal status # 登录状态、订阅信息、模型与 gateway 路由
hermes portal # 登录 Nous Portal 并完成配置(一键引导)
hermes portal info # 登录状态、订阅信息、模型与 gateway 路由
hermes portal tools # 详细的 Tool Gateway 目录及每个工具的路由信息
hermes portal open # 在浏览器中打开订阅管理页面
```
`hermes portal status`(或直接 `hermes portal`)给出高层概览:
`hermes portal`(不带子命令)是 `hermes auth add nous --type oauth` 的易记别名——它会登录、把 Nous 设为推理服务商,并提供 Tool Gateway 启用选项(与 `hermes setup --portal` 等价)。
`hermes portal info` 给出高层概览:
```
Nous Portal
@@ -230,12 +233,12 @@ Hermes 在每次推理调用时从存储的 Portal refresh token 生成短期 JW
## 故障排查
### `hermes portal status` 显示"not logged in"
### `hermes portal info` 显示"not logged in"
你尚未完成 OAuth 流程,或 refresh token 已被清除。运行:
```bash
hermes auth add nous --type oauth
hermes portal
```
或使用 `hermes model` 重新选择 Nous Portal。
@@ -256,7 +259,7 @@ Portal 通过 OpenRouter 代理,因此 OpenRouter 支持的所有模型通常
### 账单未出现在我的 Portal 账号中
先检查 `hermes portal status`——如果显示你正在使用其他提供商(`Model: currently openrouter` 而非 `using Nous as inference provider`),说明本地配置已偏离。运行 `hermes model`,选择 Nous Portal,下一次请求将通过你的订阅路由。
先检查 `hermes portal info`——如果显示你正在使用其他提供商(`Model: currently openrouter` 而非 `using Nous as inference provider`),说明本地配置已偏离。运行 `hermes model`,选择 Nous Portal,下一次请求将通过你的订阅路由。
## 另请参阅
@@ -58,7 +58,7 @@ sidebar_position: 1
```bash
hermes setup --portal # 全新安装——一条命令完成 OAuth + 提供商 + 网关配置
hermes model # 已有安装——从列表中选择"Nous Portal"
hermes portal status # 随时查看登录状态和路由信息
hermes portal info # 随时查看登录状态和路由信息
```
还没有订阅?前往 [portal.nousresearch.com/manage-subscription](https://portal.nousresearch.com/manage-subscription) 购买。
@@ -77,7 +77,7 @@ OpenAI Codex 提供商通过设备码(device code)认证——打开一个 U
:::
:::tip Nous Tool Gateway
付费 Nous Portal 订阅者还可访问 **[Tool Gateway](/user-guide/features/tool-gateway)**——网页搜索、图像生成、TTS 和浏览器自动化,均通过你的订阅路由。无需额外 API key。全新安装时,`hermes setup --portal` 一条命令即可完成登录、设置 Nous 为提供商并开启网关。现有用户可通过 `hermes model``hermes tools` 按工具启用。随时使用 `hermes portal status` 查看路由状态。
付费 Nous Portal 订阅者还可访问 **[Tool Gateway](/user-guide/features/tool-gateway)**——网页搜索、图像生成、TTS 和浏览器自动化,均通过你的订阅路由。无需额外 API key。全新安装时,`hermes setup --portal` 一条命令即可完成登录、设置 Nous 为提供商并开启网关。现有用户可通过 `hermes model``hermes tools` 按工具启用。随时使用 `hermes portal info` 查看路由状态。
:::
### 模型管理的两个命令