@guandata/guancli 1.0.26 → 1.0.28

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## @guandata/guancli 1.0.28 - 2026-05-26
+
+- 卡片预览支持动态参数默认值，可在预览时自动带入可验证的动态字段选择。
+- 增强动态字段配置校验，对缺少来源卡片、字段映射不完整或无法确认的配置提前报错。
+- 卡片信息输出补充动态参数相关摘要，便于排查筛选器和图表联动配置。
+
+## @guandata/guancli 1.0.27 - 2026-05-26
+
+- 新增 `metric project` 命令，支持查看当前用户可访问的指标主题，并可按主题名称关键词过滤。
+- 指标主题列表会展示主题 ID、名称、备注和累计指标数量，便于后续限定指标搜索范围。
+- 补充指标主题查询相关测试和命令参考文档，提升指标 CLI 使用说明的完整性。
+
 ## @guandata/guancli 1.0.26 - 2026-05-25
 
 - 新增 `ds execute-sql` 命令，支持对一个或多个数据集执行 SQL 查询，并提供 JSON/CSV/表格等输出。

package/README.md

@@ -27,13 +27,28 @@ guancli ds execute-sql -inputs <ds_id> -sql "SELECT * FROM input1 LIMIT 20"  #
 guancli ds execute-sql -inputs <ds_id> -sql "SELECT * FROM input1 LIMIT 20" -f json
 guancli ds execute-sql -inputs <ds_id> -sql "SELECT * FROM input1 LIMIT 20" --raw
 # 旧版 public-api fallback 不支持 disable-cache；--limit 在非 raw 输出渲染前本地截断，--raw 保持后端原始响应
+guancli metric project
+guancli metric project 经营 -f json
 guancli page get <page_id>
 guancli card preview <card_id>
+guancli card preview <card_id> --dynamic-param "结束时间={{{today}}}"
 guancli chatbi query --theme-name "经营主题" --message "最近30天营业收入是多少？"
 ```
 
 ## 版本更新
 
+### 1.0.28
+
+- 卡片预览支持动态参数默认值，可在预览时自动带入可验证的动态字段选择。
+- 增强动态字段配置校验，对缺少来源卡片、字段映射不完整或无法确认的配置提前报错。
+- 卡片信息输出补充动态参数相关摘要，便于排查筛选器和图表联动配置。
+
+### 1.0.27
+
+- 新增 `metric project` 命令，支持查看当前用户可访问的指标主题，并可按主题名称关键词过滤。
+- 指标主题列表会展示主题 ID、名称、备注和累计指标数量，便于后续限定指标搜索范围。
+- 补充指标主题查询相关测试和命令参考文档，提升指标 CLI 使用说明的完整性。
+
 ### 1.0.26
 
 - 新增 `ds execute-sql` 命令，支持对一个或多个数据集执行 SQL 查询，并提供 JSON/CSV/表格等输出。

package/package.json

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

package/skills/guancli/SKILL.md

@@ -249,6 +249,20 @@ guancli card preview <cd_id> --filter "利润中心 EQ 华南" --filter "季度(
 
 字段类型会自动从卡片关联的数据集 schema 推断。日期粒度筛选需配合 `card get` 查看字段配置中的筛选器字段名和粒度。
 
+#### 带动态参数预览图表卡片
+
+图表卡片 preview 支持通过 `--dynamic-param` 覆盖 BI 全局动态参数，格式为 `参数名=值` 或 `dpId=值`，可多次指定。
+CLI 会查询 `/api/dynamic-parameter/query` 补全参数元数据，并把完整 `dynamicParams` 传给 `/api/card/{cdId}/data`。
+该能力仅支持 CHART 图表卡片；数据集 preview 当前后端接口不消费动态参数，暂不支持。
+多选参数值沿用 BI 前端约定，使用英文逗号拼接成一个字符串传入。
+
+```bash
+guancli card preview <cd_id> --dynamic-param "结束时间={{{today}}}"
+guancli card preview <cd_id> --dynamic-param "11=999" --raw
+guancli card preview <cd_id> --dynamic-param "品类=鞋,服,包"
+guancli card preview <cd_id> --dynamic-param "DATE_RANGE_PARAM_LEFT=2026-05-01" --dynamic-param "DATE_RANGE_PARAM_RIGHT={{{today}}}"
+```
+
 ### 6. 表单填报操作 (Form CRUD)
 
 类似 Airtable 风格的表单数据 CRUD，用户始终用**字段名**操作，CLI 内部自动映射到 fdId。

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

@@ -29,11 +29,31 @@ guancli metric [command]
 
 | 子命令 | 功能 |
 | --- | --- |
+| `project` | 获取指标主题列表 |
 | `search` | 搜索指标 |
 | `get` | 获取指标详情 |
 | `query` | 查询指标数据 |
 | `tree` | 获取指标目录树 |
 
+### metric project
+
+获取指标主题列表；传关键词时按主题名称做模糊过滤。
+
+```bash
+guancli metric project [keyword] [flags]
+```
+
+输出中的 `全部指标数` 为主题根目录及其所有子目录累计指标数量。
+
+示例：
+
+```bash
+guancli metric project --profile default
+guancli metric project 经营 --profile default
+guancli metric project 经营 --profile default -f json
+guancli metric project 经营 --profile default --raw
+```
+
 ### metric search
 
 搜索指标；传关键词时后台用 `%keyword%` 模糊匹配，不传关键词返回所有指标。