@zhizai/cli 0.0.3 → 0.0.4

package/README.md

@@ -4,7 +4,7 @@
 
 查笔记、写总结、管知识库——一条命令搞定，支持脚本和 AI Agent 调用。
 
-> **当前版本：v0.0.3**  
+> **当前版本：v0.0.4**  
 > 已可用：`auth` / `doctor` / `capabilities` / `version` / `notes` / `note get` / `setup`。  
 > 其余业务命令（`note create` / `ask` / `team` 等）子命令已挂载，能力逐步完善中。
 
@@ -38,9 +38,7 @@ zz version
 
 ## 使用要求
 
-- 需要有效的智在记录 **API Key**
-- 获取入口：[智在记录开发者](https://www.zzjilu.com/pc/developer)
-- 请求头：`Authorization: <api-key>`（**不要**加 `Bearer`）
+- 通过 `zhizai auth login` 完成**网页授权登录**
 - 限流：最高约 **2 次/秒**
 
 ---
@@ -50,19 +48,15 @@ zz version
 ### 1. 登录
 
 ```bash
-# 直接传入 API Key（推荐脚本 / CI）
-zhizai auth login --api-key <your-api-key>
-
-# 或交互粘贴
 zhizai auth login
 ```
 
-登录成功后会写入 `~/.zhizai/config.json`，并做一次接口探活。
+按提示在浏览器确认授权即可。登录成功后写入 `~/.zhizai/config.json`。
 
-也可用环境变量（优先级高于配置文件）：
+刷新 OAuth access_token（业务请求也会在过期时自动刷新）：
 
 ```bash
-export ZHIZAI_REC_API_KEY=<your-api-key>
+zhizai auth refresh
 ```
 
 ### 2. 检查状态
@@ -106,8 +100,9 @@ zhizai setup
 
 | 命令 | 说明 |
 |------|------|
-| `zhizai auth login [--api-key <key>]` | 保存 API Key 并验证连接 |
-| `zhizai auth status` | 查看认证状态（Key 掩码显示） |
+| `zhizai auth login` | 网页设备授权登录 |
+| `zhizai auth refresh` | 刷新 OAuth access_token |
+| `zhizai auth status` | 查看认证状态（凭证掩码） |
 | `zhizai auth logout` | 清除本机凭证 |
 | `zhizai doctor` | 检查安装、登录与 API 连通性 |
 | `zhizai capabilities` | 查看当前版本的稳定能力契约 |
@@ -135,7 +130,6 @@ zhizai setup
 
 | 参数 | 说明 |
 |------|------|
-| `--api-key <key>` | 临时覆盖 API Key |
 | `-o, --output table\|json` | 输出格式（默认 `table`） |
 
 机器 / AI Agent 调用时请加 `-o json`，统一读取：
@@ -154,36 +148,15 @@ zhizai setup
 
 ## 配置
 
-凭证保存在 `~/.zhizai/config.json`：
-
-```json
-{
-  "api_key": "xxxx",
-  "expires_at": "2027-12-31 23:59:59",
-  "team_id": ""
-}
-```
-
-凭证优先级：
-
-```text
---api-key  >  环境变量 ZHIZAI_REC_API_KEY  >  ~/.zhizai/config.json
-```
-
-| 环境变量 | 说明 |
-|----------|------|
-| `ZHIZAI_REC_API_KEY` | API Key |
-| `ZHIZAI_API_URL` | 覆盖 API 基址（默认 `https://openapi.zzjilu.com/api/v1`） |
+凭证保存在 `~/.zhizai/config.json`（含 OAuth `access_token` / `refresh_token` 等字段）。
 
 ### 鉴权说明
 
-当前仅支持 **API Key**：
+默认使用 **OAuth 设备授权**：`zhizai auth login` → 浏览器确认 → 业务请求头 `X-OAuth2-Access-Token: Bearer …`。
 
-1. 在[开发者中心](https://www.zzjilu.com/pc/developer)获取 Key，或由管理员下发
-2. `zhizai auth login --api-key ...` 保存并探活
-3. 后续请求自动带 `Authorization: <api-key>`
+OAuth 过期时 CLI 会自动用 `refresh_token` 刷新；也可手动 `zhizai auth refresh`。
 
-OAuth 浏览器授权计划在后续版本补齐，不影响当前 API Key 流程。
+仅当网页授权失败时，CLI 会提示可改用 API Key 备用登录。
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhizai/cli",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "CLI tool for 智在记录 — manage notes and knowledge from the terminal and AI agents",
   "keywords": [
     "zhizai",

package/skills/zhizai-auth/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: zhizai-auth
-description: 安装和连接智在记录，完成 API Key 配置、环境诊断与 CLI 升级。用户说安装、连接、登录、检查为什么不能用时使用。
+description: 安装和连接智在记录，完成网页授权登录、环境诊断与 CLI 升级。用户说安装、连接、登录、检查为什么不能用时使用。
 ---
 
 # 智在记录连接与诊断
@@ -11,9 +11,11 @@ description: 安装和连接智在记录，完成 API Key 配置、环境诊断
 
 | 意图 | 命令 |
 |---|---|
-| 登录 | `zhizai auth login --api-key <key>` |
+| 登录 | `zhizai auth login` |
 | 查看状态 | `zhizai auth status` |
 | 退出 | `zhizai auth logout` |
 | 诊断 | `zhizai doctor -o json` |
 | 能力契约 | `zhizai capabilities -o json` |
 | 安装 Skill | `zhizai setup` |
+
+默认使用网页设备授权。仅当网页授权失败时，再提示用户使用 `zhizai auth login --api-key <key>`。