guanwf

观远工作流数据流编辑工具，支持创建、编辑、导出、预览、保存数据流。

本地安装（开发/测试阶段）

# 编译所有平台 binary（需要 Go 工具链）
npm run build

# 安装到本地 node global
npm link

安装后即可在终端使用：

guanwf create --name "我的数据流" --parent-dir <dirId>
guanwf create --name "HTTP作业" --type HTTP --parent-dir <dirId>
guanwf create --name "SQL作业" --type SQL --parent-dir <dirId>
guanwf edit <parentWorkflowId>
guanwf export --dir <workdir>
guanwf preview --dir <workdir>
guanwf save --dir <workdir> --dry-run
guanwf save --dir <workdir> --confirm
guanwf run --wait --dir <workdir> --dry-run
guanwf run --wait --dir <workdir> --confirm
guanwf run --dir <workdir> --param biz_date=2026-07-14 --confirm
guanwf schedule set --cron "0 0 2 * * ?" --param biz_date=2026-07-14 --dir <workdir> --confirm
guanwf schedule event set --rule <datasetId>:<taskName> --param biz_date=2026-07-14 --dir <workdir> --confirm
guanwf instance latest --dir <workdir> --logs -f json

8.2.0 兼容说明：SHELL/LOOP 后端未注册，CLI 会提前拒绝；离线开发输出数据集不能作为 DatasetNode 刷新目标，应使用 SubWorkflowNode 调用产出工作流。参数赋值查询 StarRocks 直连表时使用 DATABASE 来源，不要把直连数据集作为 DATASET 来源。

说明：npm 包名为 @guandata/guanwf，用户侧 CLI 命令统一为 guanwf。

也可以为 AI Coding Assistant 安装 Skill：

guanwf install-skill

版本更新

@guandata/guanwf 0.1.820

• 8.2.0 专用兼容版本；请勿与面向 master 的 CLI 版本混用。
• 新增结构化工作流节点、参数、实例诊断和安全 mutation 门，并修复 8.2.0 保存、预览、运行及恢复链路问题。
• 对 8.2.0 不支持的 SHELL、LOOP、PROCESS 事件源等能力在提交前给出明确阻断。

@guandata/guanwf 0.1.7

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

@guandata/guanwf 0.1.6

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

@guandata/guanwf 0.1.5

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

@guandata/guanwf 0.1.4

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

0.1.3

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

卸载

npm unlink -g @guandata/guanwf

支持平台

• macOS (Apple Silicon / Intel)
• Linux (x64 / arm64)
• Windows (x64)

开发

# 编译所有平台 binary（需要 Go 工具链）
npm run build

# 发布到内部 Nexus npm 仓库
npm publish