@rienn/guanyuan-cli

观远 Agent CLI — 给 AI Agent 用的观远 BI 取数遥控器。零依赖 Go 单二进制，本包自带 Windows + macOS (Intel / Apple Silicon) 二进制，按系统自动选。

安装 / 更新

npm install -g @rienn/guanyuan-cli         # 安装
guanyuan update                            # 升级到最新(等价 npm install -g @rienn/guanyuan-cli@latest)

status / doctor 发现新版会提示 guanyuan update。更新后建议再跑 guanyuan skill install 与 guanyuan refresh。

登录

guanyuan login --from-chrome    # 从本地 Chrome 自动抓观远 uIdToken(唯一登录方式,自动维护登录态)
guanyuan status                 # 校验可访问 + token 剩余天数

装过 guancli 并登录过观远的机器可跳过 login，自动复用其登录态。

工作流

guanyuan refresh                                  # 建本地能力索引(默认轻目录,秒级;字段证据由 search 按需加深)
# refresh --deep 已下线;用 search 自动按需加深 Top 候选
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 "商品名称=深睡床笠"          # 评论/文本/大明细

• 树形渠道:叶子是真实列时 --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