@guandata/guanetl 0.1.40 → 0.1.41

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## @guandata/guanetl 0.1.41 - 2026-10-14
+
+- 修复多键 JOIN 与 BI 原生条件结构的兼容问题，避免只按首个关联键得到错误结果。
+- 补齐数据库输入节点的预览配置，并在保存时保留已有配置。
+
 ## @guandata/guanetl 0.1.40 - 2026-10-12
 
 - 无法读取服务端当前 ETL 版本时停止保存，避免用过期本地基线覆盖。

package/README.md

@@ -53,6 +53,11 @@ guanetl install-skill
 
 ## 版本更新
 
+### @guandata/guanetl 0.1.41
+
+- 修复多键 JOIN 与 BI 原生条件结构的兼容问题，避免只按首个关联键得到错误结果。
+- 补齐数据库输入节点的预览配置，并在保存时保留已有配置。
+
 ### @guandata/guanetl 0.1.40
 
 - 无法读取服务端当前 ETL 版本时停止保存，避免用过期本地基线覆盖。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guanetl",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "description": "观远 ETL 本地开发工具 - 拉取、编辑、导出、预览、保存 ETL",
   "bin": {
     "guanetl": "bin/run.js"
@@ -41,11 +41,11 @@
     "node": ">=14"
   },
   "optionalDependencies": {
-    "@guandata/guanetl-darwin-arm64": "0.1.40",
-    "@guandata/guanetl-darwin-x64": "0.1.40",
-    "@guandata/guanetl-linux-x64": "0.1.40",
-    "@guandata/guanetl-linux-arm64": "0.1.40",
-    "@guandata/guanetl-win32-x64": "0.1.40"
+    "@guandata/guanetl-darwin-arm64": "0.1.41",
+    "@guandata/guanetl-darwin-x64": "0.1.41",
+    "@guandata/guanetl-linux-x64": "0.1.41",
+    "@guandata/guanetl-linux-arm64": "0.1.41",
+    "@guandata/guanetl-win32-x64": "0.1.41"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/skills/guanetl/references/ETL_AI_DEVELOP.md

@@ -162,6 +162,10 @@ BasicJoinData(id, name string, leftSource, rightSource Node, joinType JoinType,
 
 - `joinType` 用常量 `JoinTypeINNER` `JoinTypeLEFTOUTER` `JoinTypeRIGHTOUTER` `JoinTypeFULLOUTER`
 
+- 多键 JOIN 与 BI 原生配置保持一致：同一左右源的每个条件使用一条 `columnFuse`，每条只包含一个 predicate，条件之间为 AND。部分后端只读取单条 fuse 的首个谓词（GALAXY-40140）。普通 `BasicJoinData` 已按此格式生成；export 同样适配文件透传节点，preview/save 会在请求副本中适配旧导出产物，不改源文件。适配保留节点 ID、源顺序、关联类型和选出列，不做条件合并或去重。
+- 验收复合键时，必须包含“首键相同、后续键不同”的反例，检查每个关联键、结果行数和金额；任务成功不代表关联正确。
+- 已保存在 BI 的旧配置需经过 `edit -> export -> preview -> save` 才会完成适配；直接 `run` 不会静默修改服务端配置。
+
 ### 聚合
 
 ```go