@guandata/guancli 1.0.25 → 1.0.26

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## @guandata/guancli 1.0.26 - 2026-05-25
+
+- 新增 `ds execute-sql` 命令，支持对一个或多个数据集执行 SQL 查询，并提供 JSON/CSV/表格等输出。
+- `ds execute-sql` 支持旧版 public-api fallback，兼容未开放新接口的 BI 环境。
+- 改进卡片预览写入 `/dev/stdout` 时的输出行为，避免混入非数据日志。
+- 增强卡片表格输出的稳定性，排序时可处理不完整行数据。
+
 ## @guandata/guancli 1.0.25 - 2026-05-21
 
 - 指标查询能力增强，补充指标泛化查询、同环比、最近周期、占比、Top N 排名等参数说明和参考文档。

package/README.md

@@ -23,6 +23,10 @@ guancli etl tree
 guancli etl get <resource_id>
 guancli ds search <keyword>
 guancli ds preview <ds_id>
+guancli ds execute-sql -inputs <ds_id> -sql "SELECT * FROM input1 LIMIT 20"  # 需目标 BI 支持该接口并开启高级 SQL 查询
+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 page get <page_id>
 guancli card preview <card_id>
 guancli chatbi query --theme-name "经营主题" --message "最近30天营业收入是多少？"
@@ -30,6 +34,13 @@ guancli chatbi query --theme-name "经营主题" --message "最近30天营业收
 
 ## 版本更新
 
+### 1.0.26
+
+- 新增 `ds execute-sql` 命令，支持对一个或多个数据集执行 SQL 查询，并提供 JSON/CSV/表格等输出。
+- `ds execute-sql` 支持旧版 public-api fallback，兼容未开放新接口的 BI 环境。
+- 改进卡片预览写入 `/dev/stdout` 时的输出行为，避免混入非数据日志。
+- 增强卡片表格输出的稳定性，排序时可处理不完整行数据。
+
 ### 1.0.25
 
 - 指标查询能力增强，补充指标泛化查询、同环比、最近周期、占比、Top N 排名等参数说明和参考文档。

package/package.json

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

package/skills/guancli/SKILL.md

@@ -153,6 +153,8 @@ guancli page get <resource_id>         # 页面详情（含卡片列表、血缘
 guancli ds preview <ds_id>              # 预览数据集数据 (表格格式)
 guancli ds preview <ds_id> --limit 20   # 限制预览行数
 guancli ds preview <ds_id> --raw        # 输出原始 JSON
+guancli ds execute-sql -inputs <ds_id> -sql "SELECT * FROM input1 LIMIT 20"  # 用 SQL 查询数据集（需目标 BI 支持该接口并开启高级 SQL 查询）
+`execute-sql` 的旧版 public-api fallback 不支持 disable-cache；`--limit` 在非 raw 输出渲染前本地截断，`--raw` 保持后端原始响应。
 ```
 
 数据集 ID (dsId) 可通过 `ds tree` 或 `ds search` 获取。