@guandata/guanmetric 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## @guandata/guanmetric 0.1.7 - 2026-08-07
+
+- 新增指标查询加速能力，支持通过 CLI 对指标查询加速进行管理。
+- 统一写操作的请求体失败判定，并增强指标、目录、公共维度和指标树变更后的结果校验。
+- 新增目录操作预检与结果回读，降低无效变更和状态不一致风险。
+- 补充相关使用文档与测试，提升命令使用体验和内部稳定性。
+## @guandata/guanmetric 0.1.6 - 2026-07-29
+
+- 更新底层依赖，提升指标管理和模板处理的安全性与运行稳定性。
+
 ## @guandata/guanmetric 0.1.5 - 2026-07-28
 
 - 新增指标树创建、查看、改名、移动和配置更新能力，支持维度拆解、指标公式拆解及复合指标展开。

package/README.md

@@ -27,6 +27,16 @@ guanmetric metric-tree update-config <metric_tree_id> --file metric_tree_config.
 
 ## 版本更新
 
+### @guandata/guanmetric 0.1.7
+
+- 新增指标查询加速管理能力。
+- 增强指标、目录、公共维度和指标树变更后的校验与回读。
+- 写操作会提前检查目标目录和配置，减少无效变更。
+
+### @guandata/guanmetric 0.1.6
+
+- 更新底层依赖，提升指标管理和模板处理的安全性与运行稳定性。
+
 ### @guandata/guanmetric 0.1.5
 
 - 新增指标树创建、查看、改名、移动和配置更新能力，支持维度拆解、指标公式拆解及复合指标展开。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guanmetric",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "观远 BI 指标写操作工具 - 指标创建编辑删除、指标目录、公共维度、Excel 标准化",
   "bin": {
     "guanmetric": "bin/run.js"

package/skills/guanmetric/SKILL.md

@@ -18,6 +18,10 @@ guanmetric create --file atomic_metric.json --dry-run
 guanmetric edit <metric_id> --file patch.json --dry-run
 guanmetric delete <metric_id>
 guanmetric public-dim create --file public_dim.json --dry-run
+guanmetric accelerate create <metric_id> --ds-id <dsId> --fd-id <fdId> --aggr-type SUM --dim 省份 --dry-run
+guanmetric accelerate edit <accelerate_metric_id> --file accelerate_query.json --dry-run
+guanmetric accelerate priority <metric_id> --priority <accelerate_metric_id>=2 --dry-run
+guanmetric accelerate delete <accelerate_metric_id> --confirm
 guanmetric metric-tree create 销售额指标树 --metric-id <metric_id> --parent-dir-id <metric_tree_dir_id> --dry-run
 guanmetric metric-tree update-config <metric_tree_id> --file metric_tree_config.json --dry-run
 guanmetric fetch POST /api/metric-platform/metrics/composite-metrics --file composite_metric.json
@@ -25,7 +29,7 @@ guanmetric fetch POST /api/metric-platform/metrics/composite-metrics --file comp
 
 ## 编辑红线：编辑 ≠ 删除重建
 
-用户要求**编辑/重命名/修改**已有指标时，必须用 `guanmetric edit <metric_id>` 原地更新（默认按线上详情合并 patch，改名用 `--set name=新名`）；公共维度用 `public-dim edit`；指标树用 `metric-tree rename`、`metric-tree move` 或 `metric-tree update-config` 原地更新。**严禁**用"delete 后重新 create 一个同名指标/指标树"来模拟编辑或改名：指标 ID 被复合指标、衍生指标、指标卡片和指标树引用，删除重建会让这些引用全部断链，指标上的权限和历史配置也会丢失且无法恢复。指标树删除重建还会改变指标树 ID，导致归因入口、目录引用和外部链接失效。`delete` 只用于用户明确要求删除该指标本身。指标主题/目录目前只支持创建，不支持改名或删除；用户要求时直接说明 CLI 暂不支持，不要新建一个新主题/目录来替代。无论通过哪个命令或接口，都不得把"编辑"拆成"删除 + 重建"的组合来绕过这条红线。只有用户明确指示"先新建替代、再删除旧的"时才允许该流程，且执行前必须列出会断链和丢失的内容并获得确认。
+用户要求**编辑/重命名/修改**已有指标时，必须用 `guanmetric edit <metric_id>` 原地更新（默认按线上详情合并 patch，改名用 `--set name=新名`）；公共维度用 `public-dim edit`；查询加速用 `accelerate edit <accelerate_metric_id>` 原地更新或 `accelerate priority <metric_id>` 调整顺序；指标树用 `metric-tree rename`、`metric-tree move` 或 `metric-tree update-config` 原地更新。**严禁**用"delete 后重新 create 一个同名指标/指标树/查询加速"来模拟编辑或改名：指标 ID 被复合指标、衍生指标、指标卡片和指标树引用，删除重建会让这些引用全部断链，指标上的权限和历史配置也会丢失且无法恢复。指标树删除重建还会改变指标树 ID，导致归因入口、目录引用和外部链接失效。`delete` 只用于用户明确要求删除该指标本身。指标主题/目录目前只支持创建，不支持改名或删除；用户要求时直接说明 CLI 暂不支持，不要新建一个新主题/目录来替代。无论通过哪个命令或接口，都不得把"编辑"拆成"删除 + 重建"的组合来绕过这条红线。只有用户明确指示"先新建替代、再删除旧的"时才允许该流程，且执行前必须列出会断链和丢失的内容并获得确认。
 
 批量创建指标时，必须先生成固定结构的标准 Excel 返回给用户确认；确认前不生成最终 payload，不提交真实创建。
 
@@ -44,6 +48,7 @@ guanmetric fetch POST /api/metric-platform/metrics/composite-metrics --file comp
 生成衍生指标模板时，如果 `衍生自` 指标不是已明确存在的线上指标，而是本批也要创建的指标，必须在标准模板中补充对应的原子指标或复合指标行；信息不足时先补行并在该基础指标行的 `问题说明` 中列出缺失的数据集、来源字段、聚合方式、计算公式、适用维度等。不要等到创建计划阶段才临时新增基础指标。
 
 `fetch` 只用于指标平台写入接口尚未封装为专用命令的场景，例如复合指标/衍生指标创建、编辑和影响校验；常规原子指标、主题、目录、公共维度优先使用专用命令。
+查询加速写操作已封装为 `accelerate` 专用命令；查询加速列表查询使用 `guancli metric accelerate list <metric_id>`。
 指标树创建和修改已封装为 `metric-tree` 专用命令，优先使用专用命令，不要再用裸 `fetch` 直接调用指标树写接口。指标树父目录来自 `METRIC_TREE` 目录树，可用 `guancli metric_attribution tree -f json` 查询；不要把 `guancli metric tree` 返回的 `METRIC_PLATFORM` 指标目录 ID 当作指标树目录 ID。用户给出指标拆解公式时，按 `metric-tree-mutation.md` 解析成 `metricRelationTree`；遇到复合指标时读取指标详情中的 `formula`，按规则递归展开或在计划中标注不能无损展开的原因。
 
 参考文档见本 skill 的 `references/` 目录：