@guandata/guanskill 0.1.28 → 0.1.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +14 -6
  3. package/package.json +9 -9
  4. package/skills/guandata-cli-suite/SKILL.md +9 -5
package/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Changelog
2
2
 
3
+ ## @guandata/guanskill 0.1.30 - 2026-08-27
4
+
5
+ - 同步六个组件到本次发布版本，覆盖结构化错误、写前校验、工作流 Python Runtime 与输出闭环等更新。
6
+
7
+ ## @guandata/guanskill 0.1.29 - 2026-08-25
8
+
9
+ - 同步六个组件到本次发布版本，并更新套件对 SuperApp 下载、数据集目录、页面目录及页面原地操作的能力路由。
10
+
3
11
  ## @guandata/guanskill 0.1.28 - 2026-08-20
4
12
 
5
13
  - 同步聚合包中的 GuanVis 依赖到 `0.1.40`。
package/README.md CHANGED
@@ -33,15 +33,23 @@ guanskill install-skill
33
33
 
34
34
  | 组件 | 版本 | 用途 |
35
35
  |---|---:|---|
36
- | `@guandata/guancli` | `1.0.52` | 观远 BI 基础命令行工具 |
37
- | `@guandata/guands` | `0.1.27` | 数据源和数据集管理 |
38
- | `@guandata/guanetl` | `0.1.28` | ETL 编辑、预览和执行 |
39
- | `@guandata/guanwf` | `0.1.827` | 工作流数据流管理 |
40
- | `@guandata/guanvis` | `0.1.40` | 图表、卡片和仪表板构建 |
41
- | `@guandata/guanmetric` | `0.1.9` | 指标创建、编辑和模板标准化 |
36
+ | `@guandata/guancli` | `1.0.53` | 观远 BI 基础命令行工具 |
37
+ | `@guandata/guands` | `0.1.28` | 数据源和数据集管理 |
38
+ | `@guandata/guanetl` | `0.1.29` | ETL 编辑、预览和执行 |
39
+ | `@guandata/guanwf` | `0.1.828` | 工作流数据流管理 |
40
+ | `@guandata/guanvis` | `0.1.41` | 图表、卡片和仪表板构建 |
41
+ | `@guandata/guanmetric` | `0.1.10` | 指标创建、编辑和模板标准化 |
42
42
 
43
43
  ## 版本更新
44
44
 
45
+ ### @guandata/guanskill 0.1.30
46
+
47
+ - 同步六个组件到本次发布版本，覆盖结构化错误、写前校验、工作流 Python Runtime 与输出闭环等更新。
48
+
49
+ ### @guandata/guanskill 0.1.29
50
+
51
+ - 同步六个组件到本次发布版本，并更新套件对 SuperApp 下载、数据集目录、页面目录及页面原地操作的能力路由。
52
+
45
53
  ### @guandata/guanskill 0.1.28
46
54
 
47
55
  - 同步聚合包中的 GuanVis 依赖到 `0.1.40`。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guandata/guanskill",
3
- "version": "0.1.28",
3
+ "version": "0.1.30",
4
4
  "description": "Guandata BI Skills 聚合安装包 - 一次性安装和更新 guancli、guands、guanetl、guanwf、guanvis、guanmetric",
5
5
  "bin": {
6
6
  "guanskill": "bin/run.js",
@@ -29,12 +29,12 @@
29
29
  "README.md"
30
30
  ],
31
31
  "dependencies": {
32
- "@guandata/guancli": "1.0.52",
33
- "@guandata/guands": "0.1.27",
34
- "@guandata/guanetl": "0.1.28",
35
- "@guandata/guanwf": "0.1.827",
36
- "@guandata/guanvis": "0.1.40",
37
- "@guandata/guanmetric": "0.1.9"
32
+ "@guandata/guancli": "1.0.54",
33
+ "@guandata/guands": "0.1.29",
34
+ "@guandata/guanetl": "0.1.30",
35
+ "@guandata/guanmetric": "0.1.11",
36
+ "@guandata/guanvis": "0.1.42",
37
+ "@guandata/guanwf": "0.1.829"
38
38
  },
39
39
  "keywords": [
40
40
  "guandata",
@@ -47,7 +47,7 @@
47
47
  "node": ">=14.14.0"
48
48
  },
49
49
  "publishConfig": {
50
- "registry": "https://registry.npmjs.org/",
51
- "access": "public"
50
+ "access": "public",
51
+ "registry": "https://registry.npmjs.org/"
52
52
  }
53
53
  }
package/skills/guandata-cli-suite/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: guandata-cli-suite
3
- description: 观远 CLI 套件的统一入口。用户要查询或分析 ETL、数据集、页面、卡片、指标和血缘，读写表单填报数据，创建 SuperApp 模板，管理数据源或数据集，创建修改 ETL，构建图表或仪表板，创建编辑指标，或查询和编排工作流、数据流时使用。根据任务选择 guancli、guands、guanetl、guanvis、guanmetric 或 guanwf；若组件尚未安装，则引导通过 @guandata/guanskill 安装正式套件。
3
+ description: 观远 CLI 套件的统一入口。用户要查询或分析 ETL、数据集、页面、卡片、指标和血缘，读写表单填报数据，创建 SuperApp 模板或下载 SuperApp 整包，管理数据源、数据集或目录，删除、改名、移动页面，创建修改 ETL，构建图表或仪表板，创建编辑指标，或查询和编排工作流、数据流时使用。根据任务选择 guancli、guands、guanetl、guanvis、guanmetric 或 guanwf；若组件尚未安装，则引导通过 @guandata/guanskill 安装正式套件。
4
4
  license: SEE LICENSE IN LICENSE
5
5
  ---
6
6
 
@@ -17,16 +17,20 @@ license: SEE LICENSE IN LICENSE
17
17
 
18
18
  ## 套件级红线：编辑 ≠ 删除重建
19
19
 
20
- 用户要求**编辑/重命名/修改**已有 BI 资源（数据账号、数据集、表单、ETL、页面、卡片、指标、工作流等）时，只能使用对应组件的**原地更新**能力；组件没有对应能力时，直接告知用户 CLI 暂不支持。**严禁**用"删除旧资源 + 新建同名资源"来模拟编辑：BI 资源的 ID 被下游广泛引用，且携带权限配置、调度、历史数据等 CLI 无法迁移的服务端状态，删除重建会静默丢失且无法恢复。只有用户**明确指示**"先新建替代、再删除旧的"时才允许，且执行前必须列出会断链和丢失的内容并获得确认。
20
+ 用户要求**编辑/重命名/修改**已有 BI 资源（数据账号、数据集、表单、ETL、页面、卡片、指标、工作流、目录等）时，只能使用对应组件的**原地更新**能力；组件没有对应能力时，直接告知用户 CLI 暂不支持。**严禁**用"删除旧资源 + 新建同名资源"来模拟编辑：BI 资源的 ID 被下游广泛引用，且携带权限配置、调度、历史数据等 CLI 无法迁移的服务端状态，删除重建会静默丢失且无法恢复。只有用户**明确指示**"先新建替代、再删除旧的"时才允许，且执行前必须列出会断链和丢失的内容并获得确认。
21
+
22
+ **页面与目录已有原地能力，不要再用删除重建绕路**：页面改名/换目录用 `guanvis page rename` / `guanvis page move`；页面目录的建/改名/移动/删除用 `guanvis dir create/rename/move/delete`；数据集目录改名用 `guands dir rename`（数据集目录的移动 CLI 暂不支持，只能在网页端操作）。
23
+
24
+ **软删与物理删的区别必须讲清楚**：页面删除（`guanvis page delete --yes`，页面上有卡片时再加 `--force`）是软删，页面连同卡片与权限进回收站，但**CLI 不提供恢复命令**，要找回只能人工登录 BI 网页端在回收站里还原；**目录删除**（`guanvis dir delete`、`guands dir delete`）是**物理删除，不进回收站、不可恢复**，且都要求目录为空、都必须显式 `--yes`。不要把页面那边"删了还能捞回来"的经验套到目录上——也不要向用户承诺 CLI 能一键恢复。
21
25
 
22
26
  ## 能力路由
23
27
 
24
28
  | 用户意图 | 使用 Skill | 边界 |
25
29
  |---|---|---|
26
- | 查询、分析 ETL、数据集、字段、页面、卡片、血缘、节点 SQL、指标数据，读写表单填报数据，或创建 SuperApp 模板 | `guancli` | 负责查询分析、表单数据 CRUD 和通用入口；不负责修改 ETL、数据集或仪表板 |
27
- | 管理连接器、账号、数据源、数据集、目录、导入数据、增量更新、刷新调度、计算字段，或创建/编辑 SurveyEngine 填报表单 | `guands` | 数据源和数据集写操作，以及表单结构创建与原地编辑 |
30
+ | 查询、分析 ETL、数据集、字段、页面、卡片、血缘、节点 SQL、指标数据，读写表单填报数据，创建 SuperApp 模板或下载 SuperApp 整包 | `guancli` | 负责查询分析、表单数据 CRUD 和通用入口；不负责修改 ETL、数据集或页面内容，页面本身的删除/改名/移动在 `guanvis page` |
31
+ | 管理连接器、账号、数据源、数据集、数据集目录、导入数据、增量更新、刷新调度、计算字段，或创建/编辑 SurveyEngine 填报表单 | `guands` | 数据源和数据集写操作，以及表单结构创建与原地编辑；数据集目录只有建/改名/删，没有移动 |
28
32
  | 新建、修改、调试、保存、运行、取消或调度 ETL | `guanetl` | 查基础元信息时可先配合 `guancli` |
29
- | 新建、修改、组装卡片、筛选器、指标卡片或仪表板，或做页面截图验证 | `guanvis` | 只查询现有页面或卡片内容时使用 `guancli` |
33
+ | 新建、修改、组装卡片、筛选器、指标卡片或仪表板，管理页面目录（`guanvis dir`），删除/改名/移动页面本身（`guanvis page`），或做页面截图验证 | `guanvis` | 只查询现有页面/卡片内容或目录树时使用 `guancli`；被删页面的恢复 CLI 不支持，只能在 BI 网页端回收站操作 |
30
34
  | 创建、编辑、删除指标，管理指标主题、目录、公共维度或标准化指标 Excel | `guanmetric` | 指标查询仍使用 `guancli` |
31
35
  | 查询、创建、编辑、保存、运行工作流或数据流，编排 Python、子工作流和多节点 DAG | `guanwf` | 工作流引擎能力；普通 ETL 使用 `guanetl` |
32
36