@guandata/guanmetric 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## @guandata/guanmetric 0.1.5 - 2026-07-28
+
+- 新增指标树创建、查看、改名、移动和配置更新能力，支持维度拆解、指标公式拆解及复合指标展开。
+- 指标树写入支持预览计划和原地更新，减少配置错误及删除重建造成的引用失效。
+
+## @guandata/guanmetric 0.1.4 - 2026-07-25
+
+- 适配受控 Agent 运行环境，指标创建、编辑和模板处理可在嵌入式执行场景复用，现有 CLI 用法保持不变。
+
 ## @guandata/guanmetric 0.1.3 - 2026-07-23
 
 - 完善已有指标资源的原地编辑指引，避免更新时误建新资源并影响既有引用。

package/README.md

@@ -21,10 +21,21 @@ 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 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
 ```
 
 ## 版本更新
 
+### @guandata/guanmetric 0.1.5
+
+- 新增指标树创建、查看、改名、移动和配置更新能力，支持维度拆解、指标公式拆解及复合指标展开。
+- 指标树写入支持预览计划和原地更新，减少配置错误及删除重建造成的引用失效。
+
+### @guandata/guanmetric 0.1.4
+
+- 适配受控 Agent 运行环境，指标创建、编辑和模板处理可在嵌入式执行场景复用，现有 CLI 用法保持不变。
+
 ### @guandata/guanmetric 0.1.3
 
 - 完善已有指标资源的原地编辑指引，避免更新时误建新资源并影响既有引用。

package/package.json

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

package/skills/guanmetric/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: guanmetric
-description: 当用户要创建、编辑、删除观远 BI 指标，创建指标主题/指标目录，批量标准化 Excel 指标模板，或管理指标公共维度时使用本 skill。查询指标详情、搜索指标、指标数据查询仍使用 guancli。
+description: 当用户要创建、编辑、删除观远 BI 指标，创建指标主题/指标目录，创建或配置指标树（含维度拆解、指标拆解公式、复合指标公式展开），批量标准化 Excel 指标模板，或管理指标公共维度时使用本 skill。查询指标详情、搜索指标、指标数据查询仍使用 guancli。
 compatibility: "Requires Node.js 14+. Install via npm link (local) or npm install -g @guandata/guanmetric (from internal Nexus registry). CLI command: guanmetric."
 ---
 
@@ -18,12 +18,14 @@ 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 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
 ```
 
 ## 编辑红线：编辑 ≠ 删除重建
 
-用户要求**编辑/重命名/修改**已有指标时，必须用 `guanmetric edit <metric_id>` 原地更新（默认按线上详情合并 patch，改名用 `--set name=新名`）；公共维度用 `public-dim edit`。**严禁**用"delete 后重新 create 一个同名指标"来模拟编辑或改名：指标 ID 被复合指标、衍生指标、指标卡片和指标树引用，删除重建会让这些引用全部断链，指标上的权限和历史配置也会丢失且无法恢复。`delete` 只用于用户明确要求删除该指标本身。指标主题/目录目前只支持创建，不支持改名或删除；用户要求时直接说明 CLI 暂不支持，不要新建一个新主题/目录来替代。无论通过哪个命令或接口，都不得把"编辑"拆成"删除 + 重建"的组合来绕过这条红线。只有用户明确指示"先新建替代、再删除旧的"时才允许该流程，且执行前必须列出会断链和丢失的内容并获得确认。
+用户要求**编辑/重命名/修改**已有指标时，必须用 `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 暂不支持，不要新建一个新主题/目录来替代。无论通过哪个命令或接口，都不得把"编辑"拆成"删除 + 重建"的组合来绕过这条红线。只有用户明确指示"先新建替代、再删除旧的"时才允许该流程，且执行前必须列出会断链和丢失的内容并获得确认。
 
 批量创建指标时，必须先生成固定结构的标准 Excel 返回给用户确认；确认前不生成最终 payload，不提交真实创建。
 
@@ -42,6 +44,7 @@ guanmetric fetch POST /api/metric-platform/metrics/composite-metrics --file comp
 生成衍生指标模板时，如果 `衍生自` 指标不是已明确存在的线上指标，而是本批也要创建的指标，必须在标准模板中补充对应的原子指标或复合指标行；信息不足时先补行并在该基础指标行的 `问题说明` 中列出缺失的数据集、来源字段、聚合方式、计算公式、适用维度等。不要等到创建计划阶段才临时新增基础指标。
 
 `fetch` 只用于指标平台写入接口尚未封装为专用命令的场景，例如复合指标/衍生指标创建、编辑和影响校验；常规原子指标、主题、目录、公共维度优先使用专用命令。
+指标树创建和修改已封装为 `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/` 目录：
 
@@ -51,3 +54,4 @@ guanmetric fetch POST /api/metric-platform/metrics/composite-metrics --file comp
 - `metric-composite-mutation.md`
 - `metric-derived-mutation.md`
 - `metric-public-dimension.md`
+- `metric-tree-mutation.md`

package/skills/guanmetric/references/metric-tree-mutation.md

@@ -0,0 +1,470 @@
+# 指标树创建 / 修改指引
+
+本文用于指导 Agent 创建、配置和原地修改指标树。查询、搜索、归因分析仍优先使用 `guancli metric_attribution`；写操作使用 `guanmetric metric-tree`。
+
+## 读取顺序
+
+处理指标树需求时按需读取：
+
+1. 先读本文，判断用户是创建壳、创建并配置维度拆解、创建并配置指标拆解、修改配置、改名、移动，还是目录管理。
+2. 如果需要根指标或下级指标，读取 `metric-common-fields.md` 的环境、资源查询和通用字段规则。
+3. 如果用户需要先创建根指标或子指标，再建指标树，按 `metric-mutation.md` 完成指标创建闭环，拿到指标 ID 后再回到本文。
+4. 如果指标拆解里出现复合指标公式，读取 `metric-composite-mutation.md` 和 `metric-expression-rules.md`，理解 `formula` 中 `[metricId]` 的含义。
+5. 只在最终提交时使用 `guanmetric metric-tree`；不要用裸 `fetch` 调指标树写接口。
+
+## 能力边界
+
+`guanmetric metric-tree` 覆盖：
+
+- `create`：创建指标树。
+- `get`：回读指标树详情。
+- `rename`：原地更新指标树名称。
+- `move`：原地移动指标树目录。
+- `update-config`：原地更新指标树配置。
+
+不要用删除重建模拟指标树编辑。指标树 ID 可能被归因入口、页面链接、目录和外部系统引用，删除重建会造成断链。
+
+## 前端同款流程
+
+`guandata-web` 前端创建指标树分两步：
+
+1. 创建壳：选择根指标，提交 `{ metricId, parentDirId, name }` 到 `POST /api/metric-platform/metric-tree/add`。
+2. 编辑配置：进入 `/metrics-store/hierarchy/{metricTreeId}/edit/dimension`，保存时提交 `{ name, config }` 到 `POST /api/metric-platform/metric-tree/{metricTreeId}/update-config`。
+
+因此 Agent 推荐也按两阶段执行：先创建指标树壳，再按用户确认的配置执行 `update-config`。只有用户明确要求“创建时带完整 config”时，才在 create payload 中携带 `config`。
+
+默认名称可模拟前端格式：
+
+```text
+未命名的指标树_YYYY_MM_DD_HH_mm_ss
+```
+
+默认配置应模拟前端初始化。根指标必须有时间维度；没有时间维度时不得创建指标树，应提示用户先为指标配置时间维度。未显式指定对比方式时，CLI 会默认生成同环比 + 日环比配置，并开启对比和贡献计算：
+
+```json
+{
+  "timeComparisonSetting": {
+    "advType": "COMPARATIVE",
+    "advValue": {
+      "advType": "COMPARATIVE",
+      "dateFdId": "<root_metric_time_dim_fd_id>",
+      "dateFdName": "<root_metric_time_dim_name>",
+      "valueType": "RAWDATA",
+      "offset": 1,
+      "offsetType": "DAY",
+      "granularity": "DAY",
+      "window": {
+        "period": ["<today:YYYY-MM-DD>"],
+        "withMacro": false
+      },
+      "mode": "NORMAL"
+    }
+  },
+  "comparisonEnabled": true,
+  "contributionCalcEnabled": true,
+  "dimensionDecompositionContent": {
+    "decomposableDimensionIds": [],
+    "multipleDimensionEnabled": false,
+    "multipleDimensionList": [],
+    "nodeNum": 5,
+    "orderBy": "valueDesc",
+    "drillDownLevels": []
+  },
+  "metricDecompositionContent": {
+    "metricRelationTree": [
+      {
+        "metricId": "<root_metric_id>",
+        "parentId": null,
+        "operation": "",
+        "decomposeMode": "calculation"
+      }
+    ]
+  },
+  "reportDisplaySetting": {
+    "conclusionSetting": null
+  }
+}
+```
+
+如果根指标有时间维度，前端会初始化同环比 `timeComparisonSetting`。当前 CLI 已内置同款默认生成器：当提交的 config 未包含 `timeComparisonSetting` 或为 `null` 时，会基于根指标时间维度补齐默认配置，并把 `comparisonEnabled`、`contributionCalcEnabled` 置为 `true`。
+
+## 意图判断
+
+| 用户意图 | 判断 | 推荐流程 |
+| --- | --- | --- |
+| 给某指标建一个指标树 | 只创建壳 | 查根指标、查 `METRIC_TREE` 目录、计划确认、create |
+| 按地区/渠道拆某指标 | 维度拆解 | 查根指标适用维度、生成 config、create 后 update-config |
+| A = B + C / A 拆成 B、C | 指标拆解计算模式 | 解析公式、查指标 ID、生成 `metricRelationTree` |
+| A 关系拆解为 B、C | 指标拆解关系模式 | 生成 relation 模式，子节点 operation 为空 |
+| 根指标或子指标是复合指标 | 自动读取复合公式 | 根据 `formula` 可控展开 |
+| 打开贡献分析/贡献排序 | 时间对比 + 贡献计算 | 必须根指标时间配置合法 |
+| 改名 | 原地重命名 | `metric-tree rename` |
+| 移动目录 | 原地移动 | 查 `METRIC_TREE` 目录，`metric-tree move` |
+| 重建同名指标树替换旧的 | 高风险 | 阻断并说明断链，除非用户明确二次确认 |
+
+## 资源解析规则
+
+使用当前已登录环境，不主动询问 profile；写操作前可执行：
+
+```bash
+guancli auth status
+```
+
+根指标和下级指标：
+
+- 有 ID：用 `guancli metric get <metric_id> --brief` 或 `-f json` 回读确认。
+- 只有名称：用 `guancli metric search <keyword> -f json` 搜索；多候选必须让用户指定 ID。
+- 需要配置维度、时间对比或复合指标展开时，必须用 `guancli metric get <metric_id> -f json` 读取完整详情。
+
+指标树父目录来自 `METRIC_TREE` 目录体系：
+
+```bash
+guancli metric_attribution tree -f json
+```
+
+不要使用 `guancli metric tree` 返回的 `METRIC_PLATFORM` 指标目录 ID 创建指标树。只有目录名时，按路径唯一匹配；重复时必须让用户指定目录 ID。
+
+## 维度拆解配置规则
+
+维度拆解需要先读取根指标详情，确认 `applicableDims`、`publicDimensionMap` 和 `timeDim`。
+
+规则：
+
+- 拆解维度必须在根指标 `applicableDims` 中。
+- 不要把根指标时间维度作为拆解维度。
+- 交叉维度每组至少 2 个维度，最多 5 个维度。
+- 交叉维度中的每个维度必须已经在 `decomposableDimensionIds` 中。
+- `multipleDimensionEnabled=true` 时，至少保留一组合法交叉维度；长度小于等于 1 的组合应提前过滤并提示。
+- `drillDownLevels` 统一写 `dimensionIds`，不要写历史 `dimensionId`。
+- `nodeNum` 默认 5，合法范围 5-20。
+- `orderBy` 默认 `valueDesc`。
+- `contributionCalcEnabled=false` 时只允许 `valueAsc` 和 `valueDesc`。
+- 关闭对比时必须同时关闭贡献计算。
+- 关闭贡献计算时，贡献排序要降级：`contributionAsc -> valueAsc`，`contributionDesc -> valueDesc`。
+
+## 时间对比和贡献计算
+
+根指标没有时间维度时，不允许创建指标树；必须提示用户先为指标配置时间维度。
+
+根指标已经是同环比衍生指标时，不要再配置时间对比。
+
+如果启用贡献计算：
+
+- 必须 `comparisonEnabled=true`。
+- `timeComparisonSetting` 必须合法。
+- 排序可使用 `contributionAsc` 或 `contributionDesc`。
+
+如果用户只说“按贡献排序”，Agent 应解释该能力依赖时间对比和贡献计算，先确认时间配置。
+
+## 指标拆解公式理解
+
+用户可能直接给出自然语言公式，Agent 需要转换为 `metricDecompositionContent.metricRelationTree`。
+
+示例输入：
+
+```text
+销售额 = 订单数 * 客单价
+利润 = 销售额 - 成本
+转化率 = 下单人数 / 访问人数
+```
+
+处理流程：
+
+1. 识别公式左侧父指标和右侧子指标。
+2. 如果用户只给右侧，例如“按 B + C 拆 A”，父指标来自当前根指标或上下文。
+3. 对公式中的每个指标名解析唯一指标 ID；不能按名称猜。
+4. 构造关系树节点：
+   - 父节点必须存在。
+   - 第一个子节点 `operation` 为空。
+   - 第二个及之后子节点的 `operation` 取它前面的运算符。
+5. 输出计划时展示用户公式、ID 公式和关系表。
+
+公式：
+
+```text
+销售额 = 订单数 * 客单价
+```
+
+生成：
+
+```json
+[
+  {
+    "metricId": "metric_sales",
+    "parentId": null,
+    "operation": "",
+    "decomposeMode": "calculation"
+  },
+  {
+    "metricId": "metric_orders",
+    "parentId": "metric_sales",
+    "operation": "",
+    "decomposeMode": "calculation"
+  },
+  {
+    "metricId": "metric_aov",
+    "parentId": "metric_sales",
+    "operation": "*",
+    "decomposeMode": "calculation"
+  }
+]
+```
+
+关系拆解：
+
+```text
+销售额 关系拆解为 线上销售额、线下销售额
+```
+
+生成：
+
+```json
+[
+  {
+    "metricId": "metric_sales",
+    "parentId": null,
+    "operation": "",
+    "decomposeMode": "relation"
+  },
+  {
+    "metricId": "metric_online_sales",
+    "parentId": "metric_sales",
+    "operation": "",
+    "decomposeMode": "calculation"
+  },
+  {
+    "metricId": "metric_offline_sales",
+    "parentId": "metric_sales",
+    "operation": "",
+    "decomposeMode": "calculation"
+  }
+]
+```
+
+## 公式能力边界
+
+前端指标树关系模型是“父节点 = 直接子指标按顺序四则运算”。因此：
+
+- 支持 `A = B + C - D`、`A = B * C`、`A = B / C`。
+- 支持多层级：对子指标继续配置子节点。
+- 不要无损承诺任意括号优先级，例如 `A = (B + C) / D`。
+
+遇到括号、常量、函数、条件表达式或窗口表达式时：
+
+1. 如果括号内已有线上复合指标，例如 `X = B + C`，用 `X` 作为中间节点。
+2. 如果没有中间指标，提示用户指标树不能完整表达该公式优先级，建议先创建中间复合指标。
+3. 不要把 `A = (B + C) / D` 强行转成 `A = B + C / D`。
+
+## 复合指标自动拆解
+
+触发场景：
+
+- 根指标本身是 `subType=COMPOSITE`。
+- 用户公式中的某个子指标是复合指标。
+- 用户明确说“按复合指标公式展开”。
+
+处理规则：
+
+1. 对每个参与指标执行 `guancli metric get <metric_id> -f json`。
+2. 如果 `subType=COMPOSITE`，读取其 `formula` 字段。
+3. 从 `formula` 中提取 `[metricId]` 引用和 `+ - * /` 运算符。
+4. 把复合指标作为节点保留，再把公式引用指标作为它的子节点。
+5. 递归处理公式里的复合指标。
+6. 设置 `decomposeMode=calculation`。
+7. 检测循环引用和重复路径；同一条路径中重复出现的指标必须停止展开并提示。
+8. 默认最大递归深度为 3；超过时停止并在计划中标记“未展开，需要确认”。
+
+根指标是复合指标：
+
+```text
+客单价(metric_aov) = 销售额(metric_sales) / 订单数(metric_orders)
+```
+
+生成：
+
+```json
+[
+  {
+    "metricId": "metric_aov",
+    "parentId": null,
+    "operation": "",
+    "decomposeMode": "calculation"
+  },
+  {
+    "metricId": "metric_sales",
+    "parentId": "metric_aov",
+    "operation": "",
+    "decomposeMode": "calculation"
+  },
+  {
+    "metricId": "metric_orders",
+    "parentId": "metric_aov",
+    "operation": "/",
+    "decomposeMode": "calculation"
+  }
+]
+```
+
+注意：前端关系图用 `metricId` 作为节点 ID，同一指标 ID 多父节点可能产生展示冲突。对子复合指标展开时，如果会让同一指标出现在多个父节点下，推荐默认不展开该子复合指标，并在计划中说明。用户可选择：
+
+- 不展开子复合指标，只保留复合指标节点。
+- 展开子复合指标，但调整顶层公式，避免重复节点。
+- 先创建新的中间指标或调整拆解公式。
+
+## 指标树创建计划
+
+创建计划确认前，不生成最终 config，不执行 dry-run，不真实写入。
+
+计划至少包含：
+
+- 当前环境。
+- 指标树名称。
+- 根指标：ID、名称、主题、时间维度、指标类型。
+- 目标指标树目录：路径、ID。
+- 维度拆解配置：拆解维度、交叉维度、下钻层级、展示个数、排序。
+- 指标拆解配置：每条父子关系、模式、运算符、来源。
+- 指标拆解来源：用户公式、复合指标公式、手工关系。
+- 自动展开结果：展开了哪些复合指标，跳过了哪些复合指标，以及原因。
+- 时间对比和贡献计算开关。
+- 后续步骤：create dry-run、真实 create、update-config dry-run、真实 update-config、回读和可选归因查询。
+
+关系表示例：
+
+| 父指标 | 子指标 | 模式 | 运算符 | 来源 |
+| --- | --- | --- | --- | --- |
+| 销售额 | 订单数 | calculation | 空 | 用户公式 |
+| 销售额 | 客单价 | calculation | * | 用户公式 |
+| 客单价 | 商品单价 | calculation | 空 | 复合指标公式 |
+| 客单价 | 购买件数 | calculation | * | 复合指标公式 |
+
+## JSON 生成
+
+建议生成两个 JSON。
+
+`metric_tree_create.json`：
+
+```json
+{
+  "metricId": "<root_metric_id>",
+  "name": "<tree_name>",
+  "parentDirId": "<metric_tree_dir_id>"
+}
+```
+
+`metric_tree_config.json`：
+
+```json
+{
+  "config": {
+  "timeComparisonSetting": null,
+  "comparisonEnabled": true,
+  "contributionCalcEnabled": true,
+    "dimensionDecompositionContent": {
+      "decomposableDimensionIds": ["fd-region", "fd-channel"],
+      "multipleDimensionEnabled": true,
+      "multipleDimensionList": [["fd-region", "fd-channel"]],
+      "nodeNum": 5,
+      "orderBy": "valueDesc",
+      "drillDownLevels": [
+        {
+          "dimensionIds": ["fd-region"]
+        }
+      ]
+    },
+    "metricDecompositionContent": {
+      "metricRelationTree": [
+        {
+          "metricId": "metric-root",
+          "parentId": null,
+          "operation": "",
+          "decomposeMode": "calculation"
+        },
+        {
+          "metricId": "metric-child-1",
+          "parentId": "metric-root",
+          "operation": "",
+          "decomposeMode": "calculation"
+        },
+        {
+          "metricId": "metric-child-2",
+          "parentId": "metric-root",
+          "operation": "+",
+          "decomposeMode": "calculation"
+        }
+      ]
+    },
+    "reportDisplaySetting": {
+      "conclusionSetting": null
+    }
+  }
+}
+```
+
+如果只创建壳，不生成 config；若用户要求“Web 同款可编辑初始配置”，可生成默认 config 并执行 `update-config`。
+
+## 执行顺序
+
+创建：
+
+```bash
+guanmetric metric-tree create --file metric_tree_create.json --dry-run
+guanmetric metric-tree create --file metric_tree_create.json
+```
+
+创建成功后拿到 `metricTreeId`。如果有配置：
+
+```bash
+guanmetric metric-tree update-config <metric_tree_id> --file metric_tree_config.json --dry-run
+guanmetric metric-tree update-config <metric_tree_id> --file metric_tree_config.json
+```
+
+原地修改：
+
+```bash
+guanmetric metric-tree rename <metric_tree_id> 新名称 --dry-run
+guanmetric metric-tree move <metric_tree_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
+```
+
+## 验证和回读
+
+回读详情：
+
+```bash
+guanmetric metric-tree get <metric_tree_id>
+guancli metric_attribution get <metric_tree_id> -f json
+```
+
+验证维度拆解：
+
+```bash
+guancli metric_attribution query <metric_tree_id> --target dim --dim <维度名>
+```
+
+验证指标拆解：
+
+```bash
+guancli metric_attribution query <metric_tree_id> --target index
+```
+
+不要把 dry-run 成功描述成指标树已经创建或修改成功。只有真实写入并回读确认后，才能报告线上更新成功。
+
+## 命令和接口速查
+
+| 操作 | 命令 | 后端接口 |
+| --- | --- | --- |
+| 创建指标树 | `guanmetric metric-tree create` | `POST /api/metric-platform/metric-tree/add` |
+| 回读指标树 | `guanmetric metric-tree get` | `GET /api/metric-platform/metric-tree/{id}` |
+| 重命名 | `guanmetric metric-tree rename` | `POST /api/metric-platform/metric-tree/{id}/rename` |
+| 移动 | `guanmetric metric-tree move` | `POST /api/metric-platform/metric-tree/{id}/move` |
+| 更新配置 | `guanmetric metric-tree update-config` | `POST /api/metric-platform/metric-tree/{id}/update-config` |
+| 查询目录树 | `guancli metric_attribution tree` | `GET /api/directory/METRIC_TREE/authorized-tree` |
+
+## 后续 CLI 增强建议
+
+当前 skill 可通过 `guancli` 查询、手写 JSON 和 `guanmetric metric-tree` 完成闭环。后续可考虑新增：
+
+- `metric-tree dir-create`：封装 `METRIC_TREE` 目录创建。
+- `metric-tree init-config <root_metric_id>`：按前端初始化逻辑生成默认 config。
+- `metric-tree validate-config`：离线校验维度、交叉维度、指标关系树和时间对比开关。
+- `metric-tree plan`：从简化 DSL 或用户公式生成 create/config JSON。