@guandata/guancli 1.0.43 → 1.0.44

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## @guandata/guancli 1.0.44 - 2026-07-25
+
+- 指标搜索支持多个关键词，并可同时匹配指标名称、业务口径和业务属性，结果会说明命中位置和优先级。
+- 表单业务字段与系统展示列同名时可正确读取和写入，系统只读列会提前给出明确提示。
+- 优化 Agent 的资源查询策略，优先使用轻量字段查询，减少大型环境中的等待和超时。
+
 ## @guandata/guancli 1.0.43 - 2026-07-23
 
 - Token 登录引导和状态校验更准确，减少配置错误或失效凭证造成的反复排查。

package/README.md

@@ -41,6 +41,12 @@ guancli chatbi query --theme-name "经营主题" --message "最近30天营业收
 
 ## 版本更新
 
+### @guandata/guancli 1.0.44
+
+- 指标搜索支持多个关键词，并可同时匹配指标名称、业务口径和业务属性，结果会说明命中位置和优先级。
+- 表单业务字段与系统展示列同名时可正确读取和写入，系统只读列会提前给出明确提示。
+- 优化 Agent 的资源查询策略，优先使用轻量字段查询，减少大型环境中的等待和超时。
+
 ### @guandata/guancli 1.0.43
 
 - Token 登录引导和状态校验更准确，减少配置错误或失效凭证造成的反复排查。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guancli",
-  "version": "1.0.43",
+  "version": "1.0.44",
   "description": "观远 BI 命令行工具 - 通过 API 操作 ETL、数据集、页面、表单等资源，并提供 ChatBI 问数/洞察能力",
   "bin": {
     "guancli": "bin/run.js"
@@ -38,7 +38,7 @@
     "node": ">=14"
   },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://app.mayidata.com/nexus/repository/guandata-web/"
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
   }
 }

package/skills/guancli/SKILL.md

@@ -75,11 +75,18 @@ guancli card get <cd_id>
 guancli card preview <cd_id> --value-format raw -f csv
 ```
 
+> `ds get` / `page get` / `etl get` 拉取完整资源详情（默认还会附血缘），在大环境上
+> 可能明显偏慢甚至超时。只想了解数据集字段结构（做卡片/仪表板前的探查）时，
+> 优先用 `guands dataset fields <ds_id>`（轻量、秒回）；详情确需查看时先加
+> `--brief` 跳过血缘。命令超时时不要原样重试——换轻量命令或转后台执行。
+
 详细筛选、输出、动态参数和复杂报表 Pro 行为见 `references/preview-and-output.md`。
 
 ## 指标关键规则
 
 - 普通指标数据查询用 `guancli metric query <metric_id>`，可加 `--dim`、`--filter`、排序、列筛选、输出格式等。
+- 搜索指标支持两种方式：`guancli metric search <keyword>` 按指标名称模糊搜索；`guancli metric search --fuzzy <keyword>` 同时按指标名称、业务口径、自定义业务属性值做 OR 模糊搜索，可多次传参，命中优先级为 name=1、desc=2、bizAttr=3。`[keyword]` 和 `--fuzzy` 互斥。
+- 回答指标搜索结果时，必须逐条说明“命中的指标”和“命中方式”：至少包含指标 ID、指标名称、命中条件/字段、命中优先级、命中关键词；不要把用户输入默认解释为指标名称精确匹配。如果结果中有“命中条件”“命中优先级”“命中关键词”列，必须原样纳入结论。
 - 按数据集反查指标用 `guancli metric by-dataset <ds_id>`；如果已知指标主题，可加 `-d <metric_topic_id>` 缩小范围；需要结构化结果时用 `-f json`。
 - 只要传入 `--compare`、`--compare-value`、`--xtd`、`--last`、`--recent`、`--recent-base`、`--percentage`、`--percentage-dim`、`--rank-top`、`--rank-order`、`--rank-dim`、`--adv-calc-json` 任一参数，就进入指标泛化查询模式。泛化查询要求 BI 版本 `>= 8.2.1`；如需确认环境版本，先执行 `guancli server-version --profile <profile>`。
 - 当用户要创建、编辑、删除指标，创建指标主题/目录，批量标准化指标 Excel，或管理公共维度时，切换到 `guanmetric`。

package/skills/guancli/references/metric-commands.md

@@ -57,7 +57,7 @@ guancli metric project 经营 --profile default --raw
 
 ### metric search
 
-搜索指标；传关键词时后台用 `%keyword%` 模糊匹配，不传关键词返回所有指标。
+搜索指标；传 `[keyword]` 时按指标名称模糊搜索，不传关键词返回所有指标。使用 `--fuzzy` 时，后台会同时按指标名称、业务口径和自定义业务属性值做 OR 模糊搜索。
 
 ```bash
 guancli metric search [keyword] [flags]
@@ -68,13 +68,33 @@ guancli metric search [keyword] [flags]
 | 参数 | 说明 |
 | --- | --- |
 | `-d, --dir-id string` | 限定搜索主题 ID |
+| `--fuzzy strings` | 名称、业务口径、自定义业务属性统一模糊搜索关键词，可多次指定，也支持逗号、中文逗号、顿号分隔；和 `[keyword]` 互斥 |
+
+`--fuzzy` 语义：
+
+- 多个关键词之间是 OR，命中任意关键词即返回。
+- 对每个指标按优先级返回最高优先级命中：`matched by name` = 1，`matched by desc` = 2，`matched by bizAttr` = 3。
+- 自定义业务属性值统一模糊匹配；后端只匹配启用且可搜索的业务属性。
+- 结果会在原有指标字段基础上增加命中条件、命中优先级和命中关键词。
+- `[keyword]` 走旧指标名称搜索接口；`--fuzzy` 走新的统一模糊搜索接口，二者不能同时使用。
+
+回答要求：
+
+- 必须逐条返回命中的指标，至少包含指标 ID、指标名称、状态、类型。
+- 必须明确说明每条结果是通过什么方式命中的：命中条件/字段、命中优先级、命中关键词。
+- 不要把用户输入默认解释为“指标名称精确匹配”。例如用户说“查询 api_test 主题下的啦啦啦指标”，应表述为“用 `--fuzzy 啦啦啦` 在 api_test 主题内搜索，以下指标命中”，再说明是命中名称、业务口径还是业务属性。
+- 如果同一关键词命中多个指标，必须列出所有命中指标，不要只挑一个继续做详情或数据查询，除非用户明确要求。
 
 示例：
 
 ```bash
+guancli metric search --fuzzy 订购 --profile default -d <metric_topic_id>
+guancli metric search --fuzzy 订购 --profile default -f json
 guancli metric search 订购 --profile default -d <metric_topic_id>
 guancli metric search 订购 --profile default -f json
-guancli metric search 订购 --profile default --raw
+guancli metric search --fuzzy "收入,GMV" --profile default -d <metric_topic_id>
+guancli metric search --fuzzy 收入 --fuzzy GMV --profile default -f json
+guancli metric search --fuzzy 订购 --profile default --raw
 ```
 
 ### metric get