@guandata/guanmetric 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## @guandata/guanmetric 0.1.3 - 2026-07-23
+
+- 完善已有指标资源的原地编辑指引，避免更新时误建新资源并影响既有引用。
+- 优化多资源读取效率，Agent 批量准备和校验指标配置时等待更少。
+
 ## @guandata/guanmetric 0.1.2 - 2026-07-20
 
 - 全局安装或升级后自动刷新 AI Skill，减少 CLI 与 Agent 使用说明版本不一致的情况。

package/README.md

@@ -25,6 +25,11 @@ guanmetric public-dim create --file public_dim.json --dry-run
 
 ## 版本更新
 
+### @guandata/guanmetric 0.1.3
+
+- 完善已有指标资源的原地编辑指引，避免更新时误建新资源并影响既有引用。
+- 优化多资源读取效率，Agent 批量准备和校验指标配置时等待更少。
+
 ### @guandata/guanmetric 0.1.2
 
 - 全局安装或升级后自动刷新 AI Skill，减少 CLI 与 Agent 使用说明版本不一致的情况。

package/package.json

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

package/skills/guanmetric/SKILL.md

@@ -21,6 +21,10 @@ guanmetric public-dim create --file public_dim.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 暂不支持，不要新建一个新主题/目录来替代。无论通过哪个命令或接口，都不得把"编辑"拆成"删除 + 重建"的组合来绕过这条红线。只有用户明确指示"先新建替代、再删除旧的"时才允许该流程，且执行前必须列出会断链和丢失的内容并获得确认。
+
 批量创建指标时，必须先生成固定结构的标准 Excel 返回给用户确认；确认前不生成最终 payload，不提交真实创建。
 
 如果用户提供的是客户原始 Excel/CSV，而不是已经接近标准模板的文件，agent 必须先自行读取并理解表格语义，产出一个语义映射中间表（建议命名为 `*.ai_mapped.xlsx`），再执行 `guanmetric template normalize` 生成最终标准模板。不要直接把客户原始 Excel 丢给 CLI 后交付结果；CLI 不负责穷举客户列名或业务表述。CLI 继续负责固定模板结构、必填项标记、业务属性配置读取、自动填充说明、行状态、问题说明、高亮样式、列宽自适应、基础校验和 report 输出。