# Changelog

## @guandata/guancli 1.0.35 - 2026-06-17

- `metric by-dataset` 增强数据集下游指标查询，并补充指标创建/编辑参考说明。
- `login status` 使用服务端 profile 校验登录状态，减少本地缓存状态误判。
- 数据集字段输出增加 raw name、alias/displayName 疑似误用提示，便于 ETL 和指标配置前排查字段引用。

## @guandata/guancli 1.0.34 - 2026-06-15

- `metric by-dataset` 支持按数据集 ID 反查直接原子指标，并沿指标血缘展开下游复合指标和衍生指标。

## @guandata/guancli 1.0.33 - 2026-06-09

- `ds search` 支持按数据集 ID 精确解析，修复按 ID 搜索时无法稳定命中资源的问题。
- 资源详情查询补充相关解析兼容处理，提升数据集排查稳定性。

## @guandata/guancli 1.0.32 - 2026-06-04

- `metric` 增加指标创建、编辑和删除能力，并补充原子指标、派生指标、复合指标等配置参考。
- `metric` 支持公共维度查询与配置辅助，便于按主题准备指标口径。
- 数据集详情输出补充字段信息，页面详情会标记 backlog 卡片，资源诊断信息更完整。
- 补充指标命令、数据集字段解析和页面渲染相关测试覆盖。

## @guandata/guancli 1.0.31 - 2026-06-03

- `card preview` 会按卡片值格式设置输出展示值，支持小数位、百分比、千分位、前后缀等常见格式。
- `card preview` 保留 raw 原始值，避免展示格式影响排序、Excel/JSON 输出或后续处理。
- `ds execute-sql` 能力要求提示更清晰；认证请求默认不再额外发送 `X-AUTH-TOKEN`，提升部分环境兼容性。
- `install-skill` 增加 WorkBuddy skill 安装路径支持。

## @guandata/guancli 1.0.30 - 2026-05-29

- `card preview --dynamic-field` 支持当前卡片自身的多选动态维度覆盖，可用逗号分隔字段或重复传参合并。
- `card preview` 动态维度参数校验与输出诊断增强，便于确认实际预览使用的动态维度选择。
- 简版资源详情减少非必要血缘明细加载，提升资源信息查询速度和稳定性。

## @guandata/guancli 1.0.29 - 2026-05-28

- `card preview` 支持复杂报表 Pro 卡片预览，适配复杂报表筛选条件和数据输出。
- `card preview --dynamic-field` 支持按动态维度名和字段名指定预览选择，同时保留 dzId/key 等精确写法。
- `card preview -o` 输出大结果文件时补充字段 schema 提示，便于后续读取和处理导出的卡片数据。
- `ds execute-sql` 文档和提示补充数据集名称作为临时表名的说明。

## @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/表格等输出。
- `ds execute-sql` 支持旧版 public-api fallback，兼容未开放新接口的 BI 环境。
- 改进卡片预览写入 `/dev/stdout` 时的输出行为，避免混入非数据日志。
- 增强卡片表格输出的稳定性，排序时可处理不完整行数据。

## @guandata/guancli 1.0.25 - 2026-05-21

- 指标查询能力增强，补充指标泛化查询、同环比、最近周期、占比、Top N 排名等参数说明和参考文档。
- 新增 `server-version` / `bi-version` 命令，可查看当前 BI 版本，并在指标泛化查询前进行版本兼容性检查。
- 登录流程补充隐私协议提示，便于首次授权时确认使用前提。
- 优化数据集字段信息解析能力，便于在筛选和指标相关场景中复用字段元数据。

## @guandata/guancli 1.0.24 - 2026-05-20

- 新增卡片预览数据分页能力，提升大数据量预览时的可用性与稳定性。
- 修复 `ds get` 对 `virtualColumns` 计算字段的统计和展示，数据集信息输出更完整。
- 当 API 返回“资源不存在”时，错误信息会追加当前 `profile` 提示，便于排查环境或账号配置问题。
- 改进 Windows npm 启动脚本，在执行 Go 二进制前切换控制台为 UTF-8，减少中文输出乱码。
- 更新文档中的命令命名，适配去除 `-skill` 后缀后的包与 CLI 使用方式。
## @guandata/guancli 1.0.23 - 2026-05-18

- 新增 workflow 相关只读分析入口，支持查看和诊断工作流资源。
- 优化登录状态校验，会向服务端确认 Token 可用性，降低本地状态与真实登录状态不一致的问题。
- 改进调用链路的来源识别与请求元数据，提升与各 AI skill 协同调用时的稳定性。

## @guandata/guancli 1.0.22 - 2026-05-15

- 增强文件下载类 API 能力，支持页面截图等二进制结果稳定写入本地文件。
- 补充能力边界与 ETL preview 0 行排查说明，便于区分只读分析、看板构建、ETL 编辑和数据集管理等使用场景。
- 优化命令执行稳定性，避免后台辅助任务影响主命令响应。

## @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 描述同步文本。