@guandata/guancli 1.0.19 → 1.0.21

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+## @guandata/guancli 1.0.21 - 2026-05-14
+
+- 修复 CLI 运行时错误输出会附带 usage 帮助的问题，使实际错误信息更清晰。
+- 补充相关命令测试，提升错误输出行为的稳定性。
+## @guandata/guancli 1.0.20 - 2026-05-14
+
+- 指标 API 与 `guancli metric` 增加泛化查询能力，支持更灵活的指标查询场景。
+- 卡片预览能力增强，提高预览数据量上限，并新增 Excel 导出支持。
+
+## @guandata/guancli 1.0.19 - 2026-05-12
+
+- 支持显式指定配置目录，便于在脚本、多环境或隔离运行场景中加载指定配置。
+- 补充配置目录相关测试，提升配置加载行为的稳定性。
+
+## @guandata/guancli 1.0.18 - 2026-05-07
+
+- 改进页面相关 API 命令的解析与输出，提升对 BI 页面、目录树和搜索结果响应结构的兼容性。
+- 优化页面筛选条件转换与 `guancli-kit filter` 行为，减少复杂筛选场景下的解析偏差。
+- 调整登录认证和 API 客户端处理细节，提升接口调用稳定性。
+- 更新 README，并补充页面、搜索、筛选和 API 操作相关测试覆盖。
+
+## @guandata/guancli 1.0.17 - 2026-05-06
+
+- 新增指标 CLI 相关能力，包含指标与归因命令、API 客户端支持和结构化渲染输出。
+- 新增 `app publish` 命令，支持通过 guancli 发布应用。
+- 支持通过 `GUANCLI_PROFILE` 环境变量切换配置环境，便于跨环境脚本化操作。
+- 改进字段别名 `displayName` 支持，并修复 ChatBI token 重新登录共享问题。
+- 内部稳定性改进：补充指标、ChatBI、app 发布等相关测试，调整卡片/页面描述命令归属。
+
+## @guandata/guancli 1.0.15 - 2026-04-24
+
+- 新增 `guancli-kit` 数据处理引擎，并拆分 guancli / guancli-lite 的核心处理逻辑。
+- 提取渲染、解析、过滤等共享能力到 pkg，统一 guancli 与 guancli-lite 的输出格式。
+- 合并数据集查询命令，使用 `search --id` 和 `get --assoc` 覆盖原有 ds find/status/assoc 场景。
+- 优化全局 flag、配置路径与项目结构，提升多入口 CLI 的一致性。
+- 修复 SVC 查询不应发送 `X-AUTH-TOKEN` header 的问题。
+- 统一 ChatBI 命令与认证流程，并优化 skill 描述同步文本。

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@guandata/guancli",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "观远 BI 命令行工具 - 通过 API 操作 ETL、数据集、页面、表单等资源，并提供 ChatBI 问数/洞察能力",
   "bin": {
     "guancli": "bin/run.js"
   },
   "scripts": {
     "build": "node scripts/build.js && node scripts/sync-skill.js",
-    "prepublishOnly": "npm run build && node scripts/preflight.js"
+    "changelog": "node ../../scripts/generate-release-changelog.js .",
+    "check-changelog": "node ../../scripts/check-release-changelog.js .",
+    "prepublishOnly": "npm run check-changelog && npm run build && node scripts/preflight.js"
   },
   "files": [
     "bin/",
     "binaries/",
     "skills/",
+    "CHANGELOG.md",
     "README.md"
   ],
   "keywords": [

package/skills/guancli/SKILL.md

@@ -191,15 +191,17 @@ guancli ds preview <ds_id> --columns "id,name,status"         # 只显示指定
 guancli ds preview <ds_id> --filter "status EQ FAILED" --sort-desc id --columns "id,task_name"
 ```
 
-- `--sort-asc` / `--sort-desc`: 互斥，只能指定一个列。ds preview 的排序通过 API 在数据库层面执行；card preview 的排序在 Go 端对返回数据执行。
+- `--sort-asc` / `--sort-desc`: 互斥，只能指定一个列。ds preview 的排序通过 API 在数据库层面执行；card preview 的排序在 Go 端对返回数据执行，排序取数下限为 10000 行，服务端结果仍被截断时会拒绝排序。
 - `--columns`: 逗号分隔的列名列表，只显示指定列（Go 端执行）。
 
 ### 5. 获取卡片数据
 
 ```bash
 guancli card get <cd_id>                # 获取卡片元信息
-guancli card preview <cd_id>            # 预览卡片数据 (表格格式)
+guancli card preview <cd_id>            # 预览卡片数据 (图表默认最多 10000 行；选择器未排序时保留服务端默认)
 guancli card preview <cd_id> --limit 20 # 限制预览行数
+guancli card preview <cd_id> -f csv     # 导出 CSV 到 stdout
+guancli card preview <cd_id> -f excel > card.xls # 导出 Excel 可打开文件
 ```
 
 卡片 ID (cdId) 可通过 `page get` 命令查看页面详情获取。
@@ -339,15 +341,7 @@ guancli form update <fmId> <rowId> --set "值=99"
 guancli form delete <fmId> <rowId>
 ```
 
-### 7. 通用 API 调用（原始 JSON）
-
-```bash
-guancli fetch GET /api/health
-guancli fetch GET /api/etl/<id>
-guancli fetch POST /api/resource-atlas/<id> '{"resourceTypeName":"DATA_PROCESS_ETL"}'
-```
-
-### 8. ChatBI 主题问数 / 洞察
+### 7. ChatBI 主题问数 / 洞察
 
 先列主题，再执行问数或洞察；如果用户没有指定主题，不要猜。
 
@@ -369,13 +363,14 @@ guancli chatbi insight --theme-id "<theme_id>" --message "分析最近30天营
 - ChatBI 命令复用当前 profile 的 `uIdToken`
 - 默认超时 300 秒、轮询间隔 2 秒；必要时可传 `--timeout-ms` / `--poll-interval-ms`
 
-### 9. 输出格式控制
+### 8. 输出格式控制
 
 `--format` / `-f` 控制 preview 命令的输出格式：
 
 ```bash
 guancli ds preview <ds_id>                 # auto: 对齐表格，列>10 或行>20 时自动截断
 guancli ds preview <ds_id> -f csv           # CSV 格式
+guancli ds preview <ds_id> -f excel         # Excel 2003 XML 格式
 guancli ds preview <ds_id> -f expanded      # PG 风格竖排
 guancli ds preview <ds_id> -f table         # 对齐表格
 guancli ds preview <ds_id> -f json          # JSON 行记录数组