@guandata/guanwf 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## @guandata/guanwf 0.1.6 - 2026-06-24
+
+- `install-skill` 适配 WorkBuddy 配置目录，提升本机编码助手安装兼容性。
+
 ## @guandata/guanwf 0.1.5 - 2026-06-15
 
 - 工作流数据流支持 `workflow.go` DSL 模式，统一数据流创建、编辑、导出、预览、保存和运行流程。

package/README.md

@@ -33,6 +33,10 @@ guanwf install-skill
 
 ## 版本更新
 
+### @guandata/guanwf 0.1.6
+
+- `install-skill` 适配 WorkBuddy 配置目录，提升本机编码助手安装兼容性。
+
 ### @guandata/guanwf 0.1.5
 
 - 工作流数据流支持 `workflow.go` DSL 模式，统一数据流创建、编辑、导出、预览、保存和运行流程。

package/bin/run.js

@@ -51,20 +51,32 @@ function copyDirectory(src, dest) {
   }
 }
 
-function installCodeBuddySkill(pkgRoot, skill) {
-  try {
-    const srcDir = path.join(pkgRoot, "skills", skill);
-    if (!fs.existsSync(path.join(srcDir, "SKILL.md"))) {
-      console.warn(`Warning: skipping CodeBuddy/WorkBuddy install; skill not found: ${srcDir}`);
-      return;
-    }
+function installBuddySkills(pkgRoot, skill) {
+  const srcDir = path.join(pkgRoot, "skills", skill);
+  if (!fs.existsSync(path.join(srcDir, "SKILL.md"))) {
+    console.warn(`Warning: skipping buddy install; skill not found: ${srcDir}`);
+    return;
+  }
 
-    const configDir = process.env.CODEBUDDY_CONFIG_DIR || path.join(os.homedir(), ".codebuddy");
-    const destDir = path.join(configDir, "skills", skill);
-    copyDirectory(srcDir, destDir);
-    console.log(`Installed ${skill} to CodeBuddy/WorkBuddy: ${destDir}`);
-  } catch (err) {
-    console.warn(`Warning: CodeBuddy/WorkBuddy install failed for ${skill}: ${err.message}`);
+  const targets = [
+    {
+      name: "CodeBuddy",
+      configDir: process.env.CODEBUDDY_CONFIG_DIR || path.join(os.homedir(), ".codebuddy"),
+    },
+    {
+      name: "WorkBuddy",
+      configDir: process.env.WORKBUDDY_CONFIG_DIR || path.join(os.homedir(), ".workbuddy"),
+    },
+  ];
+
+  for (const target of targets) {
+    try {
+      const destDir = path.join(target.configDir, "skills", skill);
+      copyDirectory(srcDir, destDir);
+      console.log(`Installed ${skill} to ${target.name}: ${destDir}`);
+    } catch (err) {
+      console.warn(`Warning: ${target.name} install failed for ${skill}: ${err.message}`);
+    }
   }
 }
 
@@ -91,7 +103,7 @@ if (process.argv[2] === "install-skill") {
   const result = spawnSync("npx", args, { stdio: "inherit", env: process.env, shell: true });
   if (result.error) throw result.error;
   const status = result.status || 0;
-  if (status === 0) installCodeBuddySkill(pkgRoot, "guanwf");
+  if (status === 0) installBuddySkills(pkgRoot, "guanwf");
   process.exit(status);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guanwf",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "观远工作流数据流编辑工具 - 创建、编辑、导出、预览、保存数据流",
   "bin": {
     "guanwf": "bin/run.js"

package/skills/guanwf/references/ETL_AI_DEVELOP.md

@@ -62,12 +62,48 @@ orders := BasicInputDataset("id_1001", "订单", "ds_orders", []Field{
 - `meta.json` 主要保留 ETL 名称等元信息。
 - 字段相关报错时，优先检查 `[]Field`，不要先怀疑 `meta.json`。
 
+## ODS 展示格式字符串先解析再声明数值
+
+`guancli ds get` 只能告诉你字段声明类型；ODS / mock / 平台导出表可能把 UI 展示值原样存成 `STRING`，例如 `"13小时31分"`、`"27.69%"`、`"90"`。写 DWD 前先执行 `guancli ds preview <dsId>` 看样本；如果 preview 提示 STRING 样本像展示格式，不能在 `BasicInputDataset` 里直接把该字段声明成 `DOUBLE` / `LONG` 后聚合。
+
+`guanetl export` 会通过数据集详情接口校验输入字段 schema：服务端字段是 `STRING` 时，`BasicInputDataset` 不能把它声明成 `DOUBLE` / `LONG` / `DATE` 等非 STRING 类型。
+
+推荐先用 `BasicCalculator` 或 SQL 显式解析成新的数值列，再让下游聚合引用新列：
+
+```go
+calc := BasicCalculator("id_1002", "解析展示格式度量", inputA, []Formula{
+    {
+        Name: "下单转化率_数值",
+        Type: "DOUBLE",
+        Expr: "CAST(REPLACE([下单转化率], \"%\", \"\") AS DOUBLE) / 100",
+        Key:  "formula_order_rate_value",
+    },
+    {
+        Name: "营业时长_分钟",
+        Type: "DOUBLE",
+        Expr: "CAST(IF(REGEXP_EXTRACT([营业时长], \"([0-9.]+)小时\", 1) = \"\", \"0\", REGEXP_EXTRACT([营业时长], \"([0-9.]+)小时\", 1)) AS DOUBLE) * 60 + CAST(IF(REGEXP_EXTRACT([营业时长], \"([0-9.]+)分\", 1) = \"\", \"0\", REGEXP_EXTRACT([营业时长], \"([0-9.]+)分\", 1)) AS DOUBLE)",
+        Key:  "formula_open_minutes",
+    },
+    {
+        Name: "店铺分_数值",
+        Type: "DOUBLE",
+        Expr: "CAST([店铺分] AS DOUBLE)",
+        Key:  "formula_store_score_value",
+    },
+}, Position{X: 320, Y: 100})
+```
+
+- 百分比字符串先去 `%`，再确认业务语义是 `27.69` 还是 `0.2769`。
+- 中文时长要统一成明确单位，例如分钟或秒。
+- 纯数字字符串可能是编码 / ID；确认不是维度编码后再 cast。
+
 ## 字段 name / alias / showName 规则
 
 后端 ETL 的展示名语义主要来自字段 `alias`，有些接口或前端上下文会叫 `displayName` / `showName`。
 
 - 新版 ETL 默认使用输入字段别名：如果数据集字段有 `alias`，进入 ETL 算子后的列名通常是 `alias`；没有 `alias` 时才是原始 `name`。
 - 输入字段别名的事实源是数据集字段元数据；可用 `guands dataset fields <dsId>` 回读，用 `guands dataset alias <dsId> --fd-id <fdId> --alias "展示名"` 更新。`BasicInputDataset(..., []Field{...})` 中的字段 schema 主要用于导入/导出和本地 lint，不会把一个未设置过数据集 alias 的字段强制变成展示名列。
+- 本地校验按 `alias -> displayName/showName/title -> name` 解析有效字段名；同一来源下两个字段解析成相同有效名会被视为歧义，建模前应先改名或明确上游输出。
 - SQL 节点使用上游表 `input1`、`input2` 的当前列名。字段有中文展示名时，SQL 里应写展示名并用反引号，例如 ``SELECT `门店ID` FROM input1``。
 - `SELECT_COLUMNS`、`FILTER_ROWS`、`REMOVE_DUPLICATES`、`GROUP_BY` 等直接列名算子，也以当前上游列名为准。
 - 底层数据集读取和数据集元数据仍保留原始 `name`，所以 `guancli` / `guands` 输出字段时要同时关注 `name` 和 `alias`。
@@ -304,7 +340,8 @@ func DefineETL() []Node {
 
 1. `go run ./cmd/guanetl export --dir <work_dir>`
 2. 需要看结果时：`go run ./cmd/guanetl preview <node_id> --dir <work_dir>`
-3. 确认无误后：`go run ./cmd/guanetl save --dir <work_dir>`
+3. 保存前先看影响：`go run ./cmd/guanetl save --dir <work_dir> --dry-run`
+4. 确认无误后：`go run ./cmd/guanetl save --dir <work_dir>`
 
 如果 `export` 没过，不要直接 `save`。
 
@@ -319,6 +356,7 @@ func DefineETL() []Node {
 - 不要为了绕过同名错误手动删除旧输出数据集；旧输出通常仍被 ETL 依赖。
 - 如果确实要创建新输出数据集，必须同时更换 `OUTPUT_DATASET` 节点 id，并设置新的 `outputDsName` 或 `parentDirId`；只改名称会被视为已有输出绑定风险。
 - `save` 如果在 direct-save 前提示输出绑定风险，先修本地 `etl.go` / `meta.json`，再重新 `export -> preview -> save`。
+- `save --dry-run` 只生成保存影响报告，不调用 direct-save；需要机器可读结果时加 `--format json`。报告里出现阻断级输出绑定风险时，必须先修本地定义，不能继续真实 `save`。
 
 ## Appendix: Framework Surface