nolo-cli 0.1.56 → 0.1.58

package/README.md

@@ -71,6 +71,52 @@ nolo login --server https://nolo.chat --token <token>
 
 本地仓库开发应使用 `nolo login` 或显式 `AUTH_TOKEN` 来运行 agent。
 
+## 两层认证模型
+
+nolo-cli 的认证分为两个独立层面，理解它们的区别很重要：
+
+### 第一层：Nolo 平台登录（`nolo login`）
+
+```bash
+nolo login
+```
+
+- 登录 **Nolo 平台账号**
+- 通过 OAuth 设备码流程，在浏览器授权后保存 token 到 `~/.nolo/profile.json`
+- 登录后可以管理 Agent、Doc、Table、Dialog、Space 等 Nolo 资源
+- 对应命令：`nolo login`、`nolo logout`、`nolo whoami`
+
+### 第二层：第三方模型订阅授权（`nolo auth <provider>`）
+
+```bash
+nolo auth antigravity   # Google Antigravity (Gemini 3, Claude, GPT-OSS)
+nolo auth claude        # Claude Pro/Max
+nolo auth chatgpt       # ChatGPT Plus / OpenAI Codex
+nolo auth xai           # xAI Grok (SuperGrok)
+nolo auth cloudflare    # Cloudflare OAuth (email routing, etc.)
+```
+
+- 授权 **第三方 API 访问**，让 Agent 使用你的个人订阅额度调用模型
+- token 保存在 `~/.nolo/credentials/<provider>.json`
+- Agent 通过 `apiKeyRef: "<provider>"` + `apiSource: "custom"` 引用这些凭据
+- **不替代 `nolo login`**——管理 Nolo 资源仍需先登录平台
+
+### 典型工作流
+
+```bash
+# 1. 登录 Nolo 平台
+nolo login
+
+# 2. 绑定第三方模型订阅（按需）
+nolo auth antigravity
+
+# 3. 查看登录状态
+nolo whoami
+
+# 4. 管理 Agent 等资源
+nolo agent list
+```
+
 在 TUI 内部，`/update` 是全局 `nolo update` 命令的快捷方式。
 
 ```bash
@@ -184,20 +230,20 @@ nolo table add-column --table meta-0e95801d90-01KWSK4Q4TESXQ06SW39JN2TTJ --schem
 - `nolo agent email bind <agent> --email <address>` 将已有地址绑定到 agent。
 - `nolo agent email create-and-provision <slug> --name <display> [--local-part pay] [--copy-provider-from <agent>]` 一步创建 agent 并开通邮箱。
 - `nolo auth cloudflare [--client-id <id>] [--generate-token] [--zone-name <domain>] [--write-to-env [path]]` 通过 Cloudflare 自托管 OAuth 授权并可选生成 `Zone:Email Routing:Edit` 的 API Token，还可直接写入 `.env`。
+- `nolo auth claude [--no-browser] [--sync-to-server]` 通过 PKCE + `localhost:54545` 回调授权 Claude Pro/Max；`--no-browser` 时可粘贴最终回调 URL/授权码。凭据保存到 `~/.nolo/credentials/claude.json`。Agent 使用 `provider: "anthropic"`、`apiKeyRef: "claude"`。
 
-账户所有权对私有 agent 维护很重要。默认的新测试、验证 dialogs、任务板写入、机器绑定的 agent 运行和用户可见的结果应写入当前操作员账户 `0e95801d90`。原有的 `b2e06f801f` / platform-demo 账户仍然拥有较旧的公共/共享记录，但正在作为默认写入目标退出使用。使用 `nolo agent read`、`nolo agent update` 和仓库原生助手作为正常入口点；只有明确针对旧记录的所有者专属操作才应使用维护的 platform-demo token（来自 `scripts/testUtils.ts`）或重新生成的 token（来自 `scripts/generateToken.ts`）。不要将 token 字符串复制到文档、日志或提示词中。
+账户所有权对私有 agent 维护很重要。默认的新测试、验证 dialogs、任务板写入、机器绑定的 agent 运行和用户可见的结果应写入当前操作员账户 `0e95801d90`。原有的 `b2e06f801f` / platform-demo 账户已删除，仅在极少数维护旧公开/共享记录场景时保留。使用 `nolo agent read`、`nolo agent update` 和仓库原生助手作为正常入口点；只有明确针对旧记录的所有者专属操作才应使用维护的 platform-demo token（来自 `scripts/testUtils.ts`）或重新生成的 token（来自 `scripts/generateToken.ts`）。不要将 token 字符串复制到文档、日志或提示词中。
 
 在当前 TUI 中，支持的斜杠命令示例包括：
-`/agent`、`/agents`、`/switch`、`/context`（别名 `/ctx`）、`/dialog`、`/doc`、
+`/switch`、`/agents`、`/context`（别名 `/ctx`）、`/doc`、
 `/help`、`/new`、`/customize`、`/login`、`/profile`、`/version`、`/quit`
 （别名 `/exit`）和 `/update`（映射到 `nolo update`）。
 
 更广泛的 TUI 命令模型的未来产品方向示例：
 
 ```text
-/agent list
-/agent switch ops
-/dialog open latest
+/switch list
+/switch ops
 /doc list
 /table query builtin-dialog-probe-runs
 ```