@guandata/guanwf 0.1.825 → 0.1.826

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## @guandata/guanwf 0.1.826 - 2026-08-07
+
+- 完善工作流输出落位闭环，支持目录预检与目标资源存在性判定，提升保存和执行流程的可靠性。
+- 修复工作流输出绑定中的字段错位问题，确保数据集同步与输出配置正确关联。
+- 更新工作流节点使用说明，补充输出落位相关行为和操作指引。
 ## @guandata/guanwf 0.1.825 - 2026-08-05
 
 - Python 节点输出支持绑定已有数据集，可直接覆盖或追加到指定数据集，避免重复创建输出并保持下游引用稳定。

package/README.md

@@ -47,6 +47,11 @@ guanwf install-skill
 
 ## 版本更新
 
+### @guandata/guanwf 0.1.826
+
+- 完善工作流输出落位校验，保存和执行时能更准确地确认目标数据集。
+- 修复输出绑定中的字段错位问题，提升数据集同步准确性。
+
 ### @guandata/guanwf 0.1.825
 
 - Python 节点输出支持绑定已有数据集，可直接覆盖或追加到指定数据集，避免重复创建输出并保持下游引用稳定。

package/package.json

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

package/skills/guanwf/SKILL.md

@@ -348,8 +348,15 @@ NEED_FAULT_TOLERANCE。适用于长链路编排中
    本地快照里有、导出里删了的节点 → 删除；服务端有、本地快照不知道的节点（他人并发新增）→
    保留并打印提示
 5. dataflowJson 按 dataflow id 经 etlmerge 做 actions 字段级合并（成员判断同上）
-6. 调用 `/process/save-draft` 或 `/process/save`，成功后刷新本地快照并把服务端回写的
-   Python 参数同步进 `python.json`
+6. 调用 `/process/save-draft` 或 `/process/save`，成功后把**本次提交的定义**刷新为本地快照
+   并同步进 `python.json`（不是服务端回写值——服务端在保存/运行后对输出 dataSource/dsId
+   等字段的回写需要重新 `guanwf edit` 才能拿到），随后回读服务端做输出落位诊断：
+   目录被纠正时提示 `save.output_dir_rectified`，输出尚未物化时提示
+   `save.output_pending_materialization`（此时 dsId 是临时值，首次成功运行前每次保存都会
+   重新生成，勿用于下游引用）。`run` 等待成功后会校验所有输出的数据集实体线上存在
+   （`created=true` 直接通过；`created=false` 会查询数据集本身——绑定其他流程创建的
+   已有数据集时 DSL 要求保持 `Created=false`，该状态合法），数据集不存在的输出会直接
+   报错（后端存在"脚本未产出输出时静默跳过注册但任务 SUCCESS"的路径）。
 
 因此用户和 AI 都不需要手写服务端保存 payload。多人/多端并发修改同一工作流时，以服务端
 最新版本为基底合并，不会把别人新加的节点冲掉；但同一节点的并发修改仍是后保存者覆盖。

package/skills/guanwf/references/WORKFLOW_NODES.md

@@ -67,10 +67,13 @@ node_1006 := LoadNodeFromFile("node_1006.json", node_1005)
 ```
 
 配置说明：
-- `OutputDsId`: 输出数据集 ID
+- `OutputDsId`: 输出数据集 ID（序列化为服务端的 `dsId` 键；绑定已有数据集时填写）
+- `ParentDirID`: 输出数据集目录（DATA_SET 目录树 id，新建输出必填，缺失会导致运行期报错）
 - `UpdateMode`: `APPEND`（追加）或 `UPSERT`（更新插入）
 - `PrimaryKeys`: UPSERT 模式的主键列
 
+推荐优先使用透传模式（LoadNodeFromFile），可保留服务端节点的全部配置。
+
 ## 原生 DSL 节点
 
 以下节点有结构化的 Go DSL 函数，import 后会生成可直接编辑的代码。