@guandata/guancli-lite

观远 BI 轻量命令行客户端，适合固定 BI 环境和企业二次开发场景。安装包包含 guancli-lite 与 guancli-kit，支持 macOS、Linux 和 Windows。

安装

npm install -g --foreground-scripts @guandata/guancli-lite

安装或刷新 AI Skill：

guancli-lite install-skill

认证

export GUANCLI_BASE_URL=https://bi.example.com
export GUANCLI_TOKEN=your-token-here

guancli-lite auth status
guancli-lite auth whoami

guancli-lite 面向固定 BI 环境，不提供 profile 切换。需要管理多个环境时请使用完整版 @guandata/guancli。

版本更新

1.0.21

• 新增可选的结构化错误标记（GUANCLI_STRUCTURED_ERROR=1），便于下游按错误码精确分支；未启用时错误文本与既有行为不变。
• 网关调用收口为仅转发模式；文档不再指向具体宿主项目，WASI 变体只描述宿主协议。
• Skill 补充写操作确认与汇报规范，执行 form 增删改前需先确认操作对象与影响范围。

1.0.20

• 修复表单查询筛选，支持 AND/OR 多条件组合、区间筛选和多选字段筛选。
• 表单结构补充系统内置列，写入时校验未知字段与只读字段并补齐必要字段标识。
• 子表插入支持分页读取超过 10000 行的已有数据。
• 正确识别表单业务错误，避免失败操作显示为成功。
• 改善全局安装后的 AI Skill 更新结果提示。

1.0.19

• 卡片预览筛选兼容数据集原字段名和卡片展示表头。
• 增强页面默认筛选、动态参数和日期字段处理。
• 改进数据集、页面、表单及认证命令的稳定性。

常用命令

guancli-lite ds search --limit 20
guancli-lite ds preview <dsId> --limit 100
guancli-lite card preview <cardId> --limit 100
guancli-lite form schema <formId>
guancli-lite form query <formId> --filter "金额 BT 100,200"
guancli-lite form query <formId> \
  --filter "区域 EQ 华东" \
  --filter "标签 CONTAIN_ANY 重点,新增" \
  --combine-type AND

查看完整帮助：

guancli-lite --help
guancli-lite form query --help

环境要求

• Node.js 14+
• GUANCLI_BASE_URL：BI 后端地址
• GUANCLI_TOKEN：认证 Token
• 从源码运行时还需 Go 1.25+，并确保 guancli-kit 在 PATH 中或设置 GUANCLI_KIT_PATH

许可证见安装包中的 LICENSE 和 LICENSE.zh-CN。