@zhizai/cli 0.0.3 → 0.0.5

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,14 +100,18 @@ 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` | 查看当前版本的稳定能力契约 |
 | `zhizai version` | 显示版本 |
 | `zhizai notes [--limit\|--page\|--all]` | 笔记列表 |
 | `zhizai note get <id> [--field ...]` | 笔记详情 |
+| `zhizai knowledge list [--received]` | 笔记集列表（我创建的 / 收到的） |
+| `zhizai knowledge get <id>` | 笔记集详情 |
+| `zhizai knowledge notes <id>` | 笔记集内笔记 |
 | `zhizai setup [--dry-run]` | 为本机 AI 安装原子 Skill 并引导授权 |
 
 ### 规划中
@@ -121,10 +119,10 @@ zhizai setup
 | 命令 | 说明 |
 |------|------|
 | `zhizai note create\|update\|delete\|status` | 笔记写入与状态 |
+| `zhizai knowledge create` | 新建笔记集（后端接口待开放） |
 | `zhizai file upload` | 文件上传 |
 | `zhizai ask "<问题>"` | 基于笔记的动态模版问答 / 总结 |
 | `zhizai scene` | 场景与知识卡 |
-| `zhizai knowledge` | 笔记集 |
 | `zhizai team` | 团队与成员 |
 | `zhizai msg` | 消息与录音卡 |
 | `zhizai update` | 升级 CLI 并同步 Skill |
@@ -135,7 +133,6 @@ zhizai setup
 
 | 参数 | 说明 |
 |------|------|
-| `--api-key <key>` | 临时覆盖 API Key |
 | `-o, --output table\|json` | 输出格式（默认 `table`） |
 
 机器 / AI Agent 调用时请加 `-o json`，统一读取：
@@ -154,36 +151,17 @@ 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 …`。
+
+无头 / 连接器场景使用 `zhizai auth login --no-open`：不打开系统浏览器，打印 `[verify_url]` / `[device_code]` / `[expires_in]` / `[interval]`，后台继续轮询直至授权完成。
 
-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.5",
   "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,12 @@ description: 安装和连接智在记录，完成 API Key 配置、环境诊断
 
 | 意图 | 命令 |
 |---|---|
-| 登录 | `zhizai auth login --api-key <key>` |
+| 登录 | `zhizai auth login` |
+| 无头/连接器登录 | `zhizai auth login --no-open` |
 | 查看状态 | `zhizai auth status` |
 | 退出 | `zhizai auth logout` |
 | 诊断 | `zhizai doctor -o json` |
 | 能力契约 | `zhizai capabilities -o json` |
 | 安装 Skill | `zhizai setup` |
+
+默认使用网页设备授权。`--no-open` 时不打开浏览器，打印 `[verify_url]` / `[device_code]` / `[expires_in]` / `[interval]` 供宿主展示，后台继续轮询。仅当网页授权失败时，再提示用户使用 `zhizai auth login --api-key <key>`。

package/skills/zhizai-knowledge/SKILL.md

@@ -7,6 +7,10 @@ description: 查询和管理智在记录笔记集。
 
 | 意图 | 命令 |
 |---|---|
-| 笔记集操作 | `zhizai knowledge -o json` |
+| 我创建的笔记集 | `zhizai knowledge list -o json` |
+| 我收到的笔记集 | `zhizai knowledge list --received -o json` |
+| 笔记集详情 | `zhizai knowledge get <id> -o json` |
+| 集内笔记 | `zhizai knowledge notes <id> -o json` |
+| 新建笔记集 | `zhizai knowledge create --name <名称>`（后端待开放） |
 
 字段说明见 `skills/zhiji-open-platform/references/knowledge.md`。