@guandata/guancli 1.0.27 → 1.0.28

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## @guandata/guancli 1.0.28 - 2026-05-26
+
+- 卡片预览支持动态参数默认值，可在预览时自动带入可验证的动态字段选择。
+- 增强动态字段配置校验，对缺少来源卡片、字段映射不完整或无法确认的配置提前报错。
+- 卡片信息输出补充动态参数相关摘要，便于排查筛选器和图表联动配置。
+
 ## @guandata/guancli 1.0.27 - 2026-05-26
 
 - 新增 `metric project` 命令，支持查看当前用户可访问的指标主题，并可按主题名称关键词过滤。

package/README.md

@@ -31,11 +31,18 @@ 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` 命令，支持查看当前用户可访问的指标主题，并可按主题名称关键词过滤。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guancli",
-  "version": "1.0.27",
+  "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。