前言¶
在观远 BI 上做日常运维，要么点页面，要么调开放 API 自己拼请求。点页面慢且难留痕，拼 API 要记每个端点、参数和鉴权方式。如果这些操作（查 ETL、改数据集、构建仪表板、编排工作流）能统一从一个命令行入口发出，脚本化和重复执行都会省事。
观远 CLI 官方套件就是这个入口。它由观远数据发布，在 SkillHub 上的坐标是 @org-v7o6v577/guandata-cli-suite，当前版本 1.0.3，来源标记为 enterprise，分类是 data-analysis。它是一系列 CLI 组件的统一入口，按操作对象拆成不同组件，而不是一个什么都做的命令。
这是什么¶
一句话定位：观远 BI 平台的命令行工具套件入口，把 ETL、数据集、页面、卡片、指标、血缘、表单填报、SuperApp 模板、数据源管理、工作流编排这些操作统一到 CLI 上。
出品方是观远数据，这一点在 SkillHub 页面上明确标注。套件面向的是需要在 BI 平台上批量或重复操作的开发者和运维人员，尤其是希望把操作写进脚本、定时任务或 CI 流程的场景。
核心功能¶
下面这些能力来自套件的官方简介，是它声称覆盖的操作范围：
1、查询与分析：ETL、数据集、页面、卡片、指标，以及血缘关系。
2、表单填报：读写表单填报数据，不只是查，还包括写回。
3、SuperApp 模板：创建模板。
4、数据源与数据集管理：增删改查数据源和数据集。
5、ETL 开发：创建和修改 ETL。
6、可视化构建：构建图表或仪表板。
7、指标管理：创建和编辑指标。
8、工作流与数据流：查询和编排工作流、数据流。
一句话归纳：从取数到建 ETL、建图表、建指标、编排流程，这一整条链路上的主要写操作它都覆盖。
组件划分¶
这个套件不是一个单一命令，而是按操作类型拆成六个组件。做任务时按对象选组件：
guancli：通用命令入口guands：数据源与数据集相关操作guanetl：ETL 相关操作guanvis：图表、页面、卡片相关操作guanmetric：指标相关操作guanwf：工作流、数据流相关操作
选错组件的表现通常是命令不存在或参数不匹配。实际操作前先确认任务落在哪个组件上。
安装与启用¶
套件标签里有一条关键信息：requires_api_key=false，即使用这套 Skill 本身不需要额外配置 API Key。实际连接观远 BI 平台时的鉴权方式，资料里没有说明，需要以各组件自身文档为准。
安装方式：套件简介明确写的是，如果组件尚未安装，引导通过 @guandata/guanskill 安装正式套件。也就是说安装入口不是直接从当前套件的地址拉取，而是走 @guandata/guanskill 这个包。
具体的安装命令、依赖的 CLI 运行时版本、配置文件路径，在已获取的资料中没有给出。这一点要如实说明：不要凭经验补一条 npm 或 pip 命令，装之前以官方页面为准。
在支持通用 SKILL.md 格式的 Agent 环境（Cursor、Codex CLI、Claude Code 等）中启用时，把套件路径加入 Skill 搜索目录即可被识别。不同环境对目录位置和加载时机的处理不一样，需要按各自文档配置。
典型用法¶
已获取的资料只给出能力范围，没有提供可复制的命令行示例。下面按简介中的能力列表描述典型调用方向，具体命令需要安装后用 --help 或组件文档确认：
- 需要查某个数据集的结构和字段时，走
guands，而不是翻页面。 - 需要改一条 ETL 的逻辑时，走
guanetl。 - 需要在脚本里批量生成仪表板或图表时，走
guanvis。 - 需要建指标或改指标口径时，走
guanmetric。 - 需要编排工作流、数据流，或查询当前编排状态时，走
guanwf。 - 不确定某项操作该用哪个组件时，先走
guancli看可用命令。
这里的判断标准是：先确定操作对象（数据集、ETL、图表、指标、工作流），再选组件，不要一律用通用入口。
适用场景与注意¶
适合的场景：
1、需要在观远 BI 上批量创建或修改数据集、ETL、仪表板，人工点页面效率低。
2、需要把 BI 平台操作写进脚本或定时任务，要求操作可留痕、可重放。
3、需要查询血缘、指标口径、工作流状态等元信息，用于排查或审计。
4、需要读写表单填报数据，尤其是批量写入场景。
需要注意的限制：
1、当前 SkillHub 页面显示下载 1057、安装 0，说明安装量还很低，遇到问题基本要靠自己读组件文档。
2、套件本身不要求 API Key，但连接观远 BI 平台大概率需要平台侧凭证，这部分配置资料里没写。
3、组件粒度较细，跨组件的任务（比如改完 ETL 再更新依赖它的仪表板）需要自己串起来执行，套件不保证有跨组件编排能力。
4、版本更新由发布方控制，安装后建议确认版本号与平台侧兼容。
结尾¶
这个套件的价值在于把观远 BI 的操作面收敛到六个按领域划分的 CLI 组件上，让重复性的建数、建图、建指标、编排工作可以脚本化。它不替代平台功能，只是换了操作入口。官方地址：https://api.skillhub.cn/org-v7o6v577/guandata-cli-suite ，SkillHub 页面：https://www.skillhub.cn/skills/org-v7o6v577/guandata-cli-suite 。
