@rienn/guanyuan-cli 0.5.2 → 0.5.4

package/README.md

@@ -1,38 +1,39 @@
 # @rienn/guanyuan-cli
 
-观远 Agent CLI — 给 AI Agent 用的观远 BI 取数遥控器。零依赖 Go 单二进制，本包自带 **Windows + macOS (Intel / Apple Silicon)** 二进制。
+观远 Agent CLI — 给 AI Agent 用的观远 BI 取数遥控器。零依赖 Go 单二进制，本包自带 **Windows + macOS (Intel / Apple Silicon)** 二进制，按系统自动选。
 
-## 安装
+## 安装 / 更新
 
 ```bash
-npm install -g @rienn/guanyuan-cli
+npm install -g @rienn/guanyuan-cli         # 安装
+guanyuan update                            # 升级到最新(等价 npm install -g @rienn/guanyuan-cli@latest)
 ```
 
-安装后终端可用 `guanyuan` 命令。包自带 Windows + macOS(Intel/Apple Silicon) 二进制,按系统自动选。
+`status` / `doctor` 发现新版会提示 `guanyuan update`。更新后建议再跑 `guanyuan skill install` 与 `guanyuan refresh`。
+
+## 登录
 
-更新到最新(完全覆盖旧版):
 ```bash
-npm install -g @rienn/guanyuan-cli@latest
+guanyuan login --from-chrome    # 从本地 Chrome 自动抓观远 uIdToken(唯一登录方式,自动维护登录态)
+guanyuan status                 # 校验可访问 + token 剩余天数
 ```
 
-## 登录
+装过 guancli 并登录过观远的机器可跳过 login，自动复用其登录态。
 
-```bash
-# 从 Chrome 自动抓 token（推荐）
-guanyuan login --from-chrome
+## 工作流
 
-# 或手动
-guanyuan login --base-url https://guanyuan-bi.yaduo.com --token <token>
-guanyuan status
-```
-guanyuan search "儿童枕 在架率"
-guanyuan inspect --card-id <card_id>
-guanyuan values search --card-id <card_id> --field "商品名称" --search "枕"
-guanyuan query --card-id <card_id> --metric "在架率" --filter "三级渠道=京东" --dry-run
-guanyuan query --card-id <card_id> --metric "在架率" --filter "三级渠道=京东"
-guanyuan export --card-id <评论卡> --filter "商品名称=深睡床笠"
+```bash
+guanyuan refresh                                  # 建本地能力索引(默认轻目录,秒级;字段证据由 search 按需加深)
+guanyuan refresh --deep                           # 可选:一次性全量深扫预热(慢)
+guanyuan search "抖音 渠道 销售额"                  # 找卡片:候选自带 metrics/fields/matched_by/risk_hints
+guanyuan inspect --card-id <card_id>              # 看卡片指标/参数/筛选字段
+guanyuan values search --card-id <id> --field "商品名称" --search "枕"   # 搜合法枚举值
+guanyuan query --card-id <id> --metric "销售额" --filter "3rd_level_chan=天猫萨和" --dry-run
+guanyuan query --card-id <id> --metric "销售额" --filter "3rd_level_chan=天猫萨和"
+guanyuan export --card-id <评论卡> --filter "商品名称=深睡床笠"          # 评论/文本/大明细
 ```
 
-装过 guancli 并登录过观远的机器可跳过 login,自动复用其登录态。
+- 树形渠道:叶子是真实列时 `--filter` 直筛即可(CLI 自动列平筛);多级/叶子非列用 `--cascade "1st,2nd,3rd=...,...,..."` 全路径。
+- 所有命令 stdout 是 JSON envelope：`ok=true` 看 `data`，`ok=false` 读 `error.code` + `error.suggestions`。
 
 源码与文档:https://github.com/Xuleileon/guanyuan-agent-cli

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rienn/guanyuan-cli",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "观远 Agent CLI — 给 AI Agent 用的观远 BI 取数遥控器(零依赖 Go 单二进制)",
   "bin": {
     "guanyuan": "bin/guanyuan.js"