# Changelog

## @guandata/guanwf 0.1.836 - 2026-09-19

- 安装包按平台拆分：主包只保留启动器、Skill 与文档，原生程序由同版本的 `@guandata/guanwf-<平台>-<架构>` 可选依赖提供，安装时只下载当前系统的一份，安装命令与 CLI 行为不变。
- 平台包缺失或主包与平台包版本不一致时给出可操作提示；新增 `pack:all`、`verify:platforms` 与自动选包/注册表门禁，发布前校验五个平台包。

## @guandata/guanwf 0.1.835 - 2026-09-18

- 修复 Python 镜像版本解析：优先通过 `/api/python-images/list` 读取 `pythonVersion`，旧接口不可用时降级到 `/api/system-images/list?type=PYTHON` 并解析 `runtimeEnv`；两类结构化版本字段都缺失或无法识别时才回退产品兼容契约 Python 3.8，仍然禁止从镜像描述、名称或 URL 推断版本。

## @guandata/guanwf 0.1.834 - 2026-09-17

- `schedule set --failure-strategy` 改为已废弃的兼容参数，仅接受 `CONTINUE`；显式传 `END` 会在本地校验阶段失败且不发送写请求，节点失败后的后继调度由 `FAILURE` / `ALL` 连线决定。
- 同步共享鉴权与环境识别更新，支持内部 OAuth2 应用认证环境的服务域识别。

## @guandata/guanwf 0.1.833 - 2026-09-09

- DSL 新增节点类型、依赖类型和更新模式等类型化常量，同时保留已有字符串写法的兼容性。
- 改进工作流定义的序列化、导入与导出稳定性，减少往返编辑时的语义漂移。
- 统一错误分类和提示，自动化流程可更准确地区分输入、状态与后端失败。

## @guandata/guanwf 0.1.832 - 2026-09-03

- 同步底层 CLI 执行器解析更新，改善 Windows npm 全局安装和多种程序路径下的运行兼容性。

## @guandata/guanwf 0.1.831 - 2026-09-01

- 首次 `CREATE_NEW` 输出成功后，在完成输出绑定并发布保存前阻断后续运行，避免运行时数据集 ID 被误判为已进入发布版本。
- 强化已有工作流编辑、导出、保存与输出绑定的状态保真、并发检查和敏感文件保护。

## @guandata/guanwf 0.1.830 - 2026-08-28

- `run --validate` 会清空临时定义中的真实输出注册配置，只验证 Python 序列化，不再误触发输出数据集注册。
- 校验仅允许在已有草稿上执行，并在写入前和最终并发检查时确认版本状态，避免发布态工作流留下无法废弃的临时草稿。
- 强化校验失败后的恢复标记与草稿回滚，生命周期变化时保持线上零写入并提供明确诊断。

## @guandata/guanwf 0.1.829 - 2026-08-27

- 新增 Python Runtime 查询与结构化上下文，生成脚本前可确认目标 Python 版本、运行模式和镜像来源；信息不足时按兼容规则保守处理。
- 新增 Python 输入规模与内存预检，普通运行会在提交前给出 `PASS`、`NO_GO` 或 `UNKNOWN`，高风险场景默认阻断。
- 新增输出绑定、改绑、解绑、已注册输出回填及能力查询命令，以 task 和 output slot 精确定位，支持 dry-run 与并发变更检查。
- 强化工作流保存和执行闭环：提供版本差异、冲突与 no-op 诊断，保存后 fresh readback；运行后逐项验证输出计算、注册、更新和可读性。
- 实例日志会明确完整性、缺失尝试和根因证据；实例状态与任务 ID 的处理更一致。
- 导出时保护含凭据的工作区文件，并保留未知扩展字段、孤立 sidecar 和 Python 节点往返信息，减少编辑已有工作流时的数据损失。
- 统一结构化错误与拼错子命令的非零退出行为。

## @guandata/guanwf 0.1.828 - 2026-08-25

- 支持企业 OIDC 认证上下文，并同步升级底层请求兼容能力，改善受控运行环境中的工作流操作稳定性。

## @guandata/guanwf 0.1.827 - 2026-08-20

- 改进 npm 安装后的 Skill 自动安装反馈，安装结果与后续处理提示更清晰。
- 修复安装/删除 Skill 时的确认交互与 Windows CLI 兼容问题，提升跨平台可用性。
- 同步更新安装命令与使用说明。

## @guandata/guanwf 0.1.826 - 2026-08-07

- 完善工作流输出落位闭环，支持目录预检与目标资源存在性判定，提升保存和执行流程的可靠性。
- 修复工作流输出绑定中的字段错位问题，确保数据集同步与输出配置正确关联。
- 更新工作流节点使用说明，补充输出落位相关行为和操作指引。
## @guandata/guanwf 0.1.825 - 2026-08-05

- Python 节点输出支持绑定已有数据集，可直接覆盖或追加到指定数据集，避免重复创建输出并保持下游引用稳定。
- 编辑已有工作流时会回读并保留输出数据集绑定状态，同时在保存前校验无效配置。

## @guandata/guanwf 0.1.824 - 2026-07-29

- 工作流目录树支持按关键词和最大深度缩小范围，文本与 JSON 输出都能清楚标记被省略的层级。
- 更新底层依赖，提升安全性和运行稳定性。

## @guandata/guanwf 0.1.823 - 2026-07-25

- 提升受控 Agent 运行环境中的工作流导出和 ETL 节点处理能力，较大的工作流定义也能稳定交换。

## @guandata/guanwf 0.1.822 - 2026-07-23

- 优化工作流依赖与血缘读取效率，复杂编排的分析和校验等待更少。
- 完善已有工作流的原地编辑指引，避免更新时破坏原有调度、权限和下游引用。

## @guandata/guanwf 0.1.821 - 2026-07-20

- 保持 8.2.0 专用兼容能力不变；全局安装或升级后自动刷新 AI Skill。
- 随包提供完整的工作流使用说明和参考资料。

## @guandata/guanwf 0.1.820 - 2026-07-14

- 新增工作流参数 DSL、运行时 `--param` 覆盖和参数三方合并。
- 定时调度与事件调度新增可重复的 `--param key=value`，更新单个参数时保留其他显式值和工作流默认值。
- 新增 Dataset、Shell、HTTP、SQL、参数赋值、Switch、Loop 的结构化 TaskNode DSL 与无损 passthrough。
- 修复 8.2.0 DATASET 节点错误接受空 `datasetId` 的问题；该节点只刷新已有数据集，创建/写入目标数据集需使用 DATAFLOW/DB_DATAFLOW。
- 新增 `instance list/tasks/logs/latest`、完整日志分页和失败子工作流递归日志。
- 扩展 SHELL/HTTP/SQL 初始工作流及 `node add` 节点脚手架。
- 所有 `run` 操作新增 mutation 安全门：先用 `--dry-run` 查看计划，实际执行必须追加 `--confirm`（兼容 `--yes`）；既有自动化脚本需要同步更新。
- 修复工作流三方合并、敏感凭据落盘、实例状态与日志、JSON 输出和跨平台原子写入问题。
- 精确合并快照会自动加入工作区 `.gitignore`；所有 `task.json` 统一使用当前用户受限权限，HTTP URL 查询凭据不会进入普通权限源码，日志中的常见键值凭据统一脱敏。
- 按 8.2.0 后端能力收口：SHELL/LOOP 在创建、导出和保存前明确拒绝；离线开发输出 DatasetNode、直连数据集参数赋值在提交前给出可执行替代方案。
- 修复参数赋值在 DATABASE/DATASET 来源切换后残留另一来源账号或数据集字段的问题。
- 修复 8.2.0 DB Dataflow 预览误用普通数据流 v1 接口、任务长期停留在 PROCESSING 的问题；改用 Core v2 提交和通用任务轮询/取消接口。

## @guandata/guanwf 0.1.7 - 2026-07-08

- 工作流离线开发能力增强，支持文件夹、实例、权限、告警和调度相关命令。
- 新增工作流依赖分析、执行计划和依赖校验能力，便于把一批作业编排为统一调度主工作流。
- 数据流保存和合并能力增强，补充子工作流、事件调度和恢复场景支持。

## @guandata/guanwf 0.1.6 - 2026-06-24

- `install-skill` 适配 WorkBuddy 配置目录，提升本机编码助手安装兼容性。

## @guandata/guanwf 0.1.5 - 2026-06-15

- 工作流数据流支持 `workflow.go` DSL 模式，统一数据流创建、编辑、导出、预览、保存和运行流程。
- 新增 Python 节点 DSL 支持和本地校验，保存时采用三方合并以减少覆盖线上已有数据流配置的风险。
- 补充工作流 DSL 参考文档和测试覆盖，提升复杂数据流生成与发布链路稳定性。

## @guandata/guanwf 0.1.4 - 2026-06-03

- `install-skill` 增加 WorkBuddy skill 安装路径支持。

## @guandata/guanwf 0.1.3 - 2026-05-28

- 优化试用账号场景下的运行上下文识别，提升命令执行记录与问题排查的一致性。
- 重新构建发布产物，纳入共享运行上下文处理更新。

## @guandata/guanwf 0.1.2 - 2026-05-26

- 构建流程会将 npm 包版本注入到 `guanwf` 二进制，确保运行时版本信息与发布包一致。
- 改进工作流数据流命令的 profile 与版本上下文传递，提升多环境排查时的一致性。
- 补充相关测试覆盖，提升数据流命令辅助逻辑稳定性。

## @guandata/guanwf 0.1.1 - 2026-05-21

- 强化工作流数据流编辑的源文件驱动流程，明确修改应落在 `etl/etl.go`、`etl/*.sql` 或被引用的 `etl/node_*.json`。
- 明确 `_exported.json`、`_parent_snapshot.json`、`_input.json` 等根目录 JSON 为系统状态或派生产物，不应手工修改。
- 优化新建、编辑、导出、预览、保存的固定工作顺序说明，降低保存时覆盖父工作流其他数据流的风险。
- 调整 create/export 相关行为说明，使新建数据流默认通过 `etl/` 事实源生成。

## @guandata/guanwf 0.1.0 - 2026-05-20

- 新增 `@guandata/guanwf` npm 发布包，提供构建、预检、安装同步与跨平台二进制分发流程。
- 支持 workflow platform 的导入/导出闭环，完善工作流数据流编辑与发布链路。
- 扩展工作流数据流节点预览能力，并补充节点与 ETL AI 开发参考文档。
- 调整用户侧命令与文档命名，移除 `-skill` 后缀并清理旧引用。
- 改进跨平台运行体验，包括 Linux 构建目标与 Windows 控制台 UTF-8 输出兼容。