@guandata/guancli 1.0.48 → 1.0.49

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## @guandata/guancli 1.0.49 - 2026-08-07
+
+- 支持指标查询加速，提升指标查询场景的执行效率与使用体验。
+- 指标查询结果超过 1000 行时默认输出为文件，避免终端展示过长内容。
+- 支持按 Domain 或 URL 查找 Profile，简化认证配置与环境切换。
+
 ## @guandata/guancli 1.0.48 - 2026-08-04
 
 - 支持直接基于已有仪表板或智能洞察卡片生成洞察结果，可应用筛选条件并选择分析思路。

package/README.md

@@ -41,6 +41,12 @@ guancli chatbi query --theme-name "经营主题" --message "最近30天营业收
 
 ## 版本更新
 
+### @guandata/guancli 1.0.49
+
+- 支持按 Domain 或 URL 查找 Profile，切换和定位目标环境更方便。
+- 新增指标查询加速能力，提升指标查询效率。
+- 指标查询结果超过 1000 行时默认转为文件输出，更适合处理大结果集。
+
 ### @guandata/guancli 1.0.48
 
 - 支持直接基于已有仪表板或智能洞察卡片生成洞察结果，可应用筛选条件并选择分析思路。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guancli",
-  "version": "1.0.48",
+  "version": "1.0.49",
   "description": "观远 BI 命令行工具 - 通过 API 操作 ETL、数据集、页面、表单等资源，并提供 ChatBI 问数/洞察能力",
   "bin": {
     "guancli": "bin/run.js"

package/skills/guancli/SKILL.md

@@ -89,7 +89,7 @@ guancli insight card <cd_id> --page-id <page_id>
 
 ## 指标关键规则
 
-- 普通指标数据查询用 `guancli metric query <metric_id>`，可加 `--dim`、`--filter`、排序、列筛选、输出格式等。
+- 普通指标数据查询用 `guancli metric query <metric_id>`，可加 `--dim`、`--filter`、排序、列筛选、输出格式等；未指定 `-o/--output` 且结果超过 1000 行时会自动写入 `metric_<metricId>_<timestamp>.<ext>`。
 - 搜索指标支持两种方式：`guancli metric search <keyword>` 按指标名称模糊搜索；`guancli metric search --fuzzy <keyword>` 同时按指标名称、业务口径、自定义业务属性值做 OR 模糊搜索，可多次传参，命中优先级为 name=1、desc=2、bizAttr=3。`[keyword]` 和 `--fuzzy` 互斥。
 - 回答指标搜索结果时，必须逐条说明“命中的指标”和“命中方式”：至少包含指标 ID、指标名称、命中条件/字段、命中优先级、命中关键词；不要把用户输入默认解释为指标名称精确匹配。如果结果中有“命中条件”“命中优先级”“命中关键词”列，必须原样纳入结论。
 - 按数据集反查指标用 `guancli metric by-dataset <ds_id>`；如果已知指标主题，可加 `-d <metric_topic_id>` 缩小范围；需要结构化结果时用 `-f json`。

package/skills/guancli/references/auth-and-config.md

@@ -26,6 +26,12 @@ guancli auth login
 
 选择登录方式 `2`，直接粘贴已有的 uIdToken。适用于已从 Web 界面或其他途径获取 uIdToken 的场景。
 
+如需按登录 Domain 筛选这个 profile，可在非交互式登录时同时保存：
+
+```bash
+guancli auth login --url https://bi.example.com --domain demo --token <uid-token>
+```
+
 ### 方式三：Personal Access Token
 
 ```bash
@@ -42,11 +48,17 @@ guancli auth login --url https://bi.example.com --pat <pat>
 guancli auth login --profile staging            # 添加 staging 环境
 guancli auth login --profile prod --default     # 添加 prod 并设为默认
 guancli auth list                                # 列出所有环境
+guancli auth list --domain demo                  # 按登录 Domain 筛选
+guancli auth list --url https://bi.example.com/page/123  # 按页面 URL 筛选
 guancli auth status                              # 查看当前认证状态
 guancli auth use staging                         # 切换默认环境为 staging
+guancli auth use --domain demo                   # 按登录 Domain 切换
+guancli auth use --url https://bi.example.com/page/123  # 按页面 URL 切换
 guancli auth remove staging                      # 删除 staging 环境
 ```
 
+`auth list` 可用 `--domain` 或 `--url` 只读筛选 profile；`auth use` 使用相同筛选条件切换默认 profile。`--domain` 只匹配 profile 保存的登录 Domain，忽略大小写；`--url` 必须为不含 userinfo 的 HTTP(S) URL，且编码路径不得把 `/`、`.` 或 `..` 作为 path segment；它按相同协议、主机和最长的 `base_url` 路径前缀匹配，因此可直接传页面深链。`auth use` 遇到多个候选会拒绝切换，需改用 profile 名称明确选择。
+
 使用特定环境（不切换默认）：
 
 ```bash

package/skills/guancli/references/metric-commands.md

@@ -32,6 +32,7 @@ guancli metric [command]
 | `project` | 获取指标主题列表 |
 | `search` | 搜索指标 |
 | `get` | 获取指标详情 |
+| `accelerate` | 查询指标查询加速配置 |
 | `by-dataset` | 按数据集 ID 获取直接和下游关联指标 |
 | `query` | 查询指标数据 |
 | `tree` | 获取指标目录树 |
@@ -76,6 +77,7 @@ guancli metric search [keyword] [flags]
 - 对每个指标按优先级返回最高优先级命中：`matched by name` = 1，`matched by desc` = 2，`matched by bizAttr` = 3。
 - 自定义业务属性值统一模糊匹配；后端只匹配启用且可搜索的业务属性。
 - 结果会在原有指标字段基础上增加命中条件、命中优先级和命中关键词。
+- 非 `--raw` 输出会额外查询并返回每个指标关联的查询加速摘要，包括查询加速数量和加速指标 ID/优先级/字段摘要。
 - `[keyword]` 走旧指标名称搜索接口；`--fuzzy` 走新的统一模糊搜索接口，二者不能同时使用。
 
 回答要求：
@@ -99,7 +101,9 @@ guancli metric search --fuzzy 订购 --profile default --raw
 
 ### metric get
 
-获取指标详情，包括元数据、数据口径、数据集、权限、统计信息、自定义属性和血缘关系。
+获取指标详情，包括元数据、数据口径、数据集、权限、统计信息、自定义属性、查询加速和血缘关系。
+
+非 `--raw` 输出会额外查询并返回该指标关联的查询加速列表；`--raw` 保持服务端指标详情接口原始响应。
 
 ```bash
 guancli metric get <metric_id> [flags]
@@ -114,6 +118,24 @@ guancli metric get <metric_id> --profile default -f json
 guancli metric get <metric_id> --profile default --raw
 ```
 
+### metric accelerate
+
+查询指标的查询加速配置。后端取数时会按 `acceleratePriority` 从高到低尝试加速指标；只有当查询维度和筛选维度都能被加速指标适用维度覆盖时才会命中。
+
+```bash
+guancli metric accelerate list <metric_id> [flags]
+```
+
+示例：
+
+```bash
+guancli metric accelerate list <metric_id> --profile default
+guancli metric accelerate list <metric_id> --profile default -f json
+guancli metric accelerate list <metric_id> --profile default --raw
+```
+
+> 查询加速创建、编辑、删除和优先级调整使用 `guanmetric accelerate`。
+
 ### metric by-dataset
 
 按数据集 ID 获取关联指标。命令会跨指标主题扫描指标，并结合指标详情和指标血缘判断该数据集关联的指标；结果包含直接使用该数据集的原子指标，也包含继续引用这些指标的复合指标和衍生指标。
@@ -157,6 +179,9 @@ guancli metric query <metric_id> [flags]
 | `--sort-desc string` | 无 | 按列降序排序，与 `--sort-asc` 互斥 |
 | `--columns strings` | 无 | 只显示指定列，逗号分隔，在 CLI 端执行 |
 | `--precision int` | `6` | 数值最大小数位数；传 `-1` 保留原始精度 |
+| `-o, --output string` | 无 | 将查询结果写入文件；未指定且结果超过 1000 行时自动写入文件 |
+
+未指定 `-o/--output` 且查询结果超过 1000 行时，默认写入 `metric_<metricId>_<timestamp>.<ext>` 文件，避免把大结果直接塞入上下文。默认 `-f auto` 在写文件时会切换为 CSV；显式指定 `-f json/csv/table/expanded/excel` 时按指定格式写入。
 
 筛选操作符：
 
@@ -179,6 +204,7 @@ guancli metric query <metric_id> --profile default --dim 省份 --filter "省份
 guancli metric query <metric_id> --profile default --dim 省份 --sort-desc 订购数量
 guancli metric query <metric_id> --profile default --dim 省份 --columns "省份,订购数量"
 guancli metric query <metric_id> --profile default --dim 省份 -f csv
+guancli metric query <metric_id> --profile default --dim 省份 --limit 10000 -f csv -o metric.csv
 guancli metric query <metric_id> --profile default --dim 省份 --raw
 ```
 

package/skills/guancli/references/metric-generic-query.md

@@ -45,11 +45,14 @@ guancli server-version --profile <profile>
 | `--limit int` | 返回行数限制 |
 | `--precision int` | 数值最大小数位数，`-1` 表示原始精度 |
 | `-f, --format string` | 输出格式：`auto`、`table`、`csv`、`expanded`、`json` |
+| `-o, --output string` | 将查询结果写入文件；未指定且结果超过 1000 行时自动写入文件 |
 | `--raw` | 输出服务端原始 JSON |
 | `-v, --verbose` | 显示详细日志 |
 
 筛选操作符：`EQ`、`NE`、`LT`、`LE`、`GT`、`GE`、`BT`、`IN`、`IS_NULL`、`NOT_NULL`、`CONTAINS`、`NOT_CONTAINS`、`STARTSWITH`、`NOT_STARTSWITH`、`ENDSWITH`、`NOT_ENDSWITH`。
 
+未指定 `-o/--output` 且查询结果超过 1000 行时，默认写入 `metric_<metricId>_<timestamp>.<ext>` 文件；默认 `-f auto` 写文件时使用 CSV。
+
 ## 参数值
 
 ### `--compare`
@@ -183,6 +186,7 @@ guancli metric query <metric_id> \
 ```bash
 guancli metric query <metric_id> --profile default --dim 日期 --compare yoy -f json
 guancli metric query <metric_id> --profile default --dim 日期 --xtd ytd -f csv
+guancli metric query <metric_id> --profile default --dim 日期 --recent 7d -f csv -o recent.csv
 guancli metric query <metric_id> --profile default --dim 日期 --recent 7d --raw
 ```