跳到主要内容

workflow-code structure

workflow-code structure 不执行项目。命令会先校验完整的 package.json.workflowCode.projectInfo 合同；Workflow/Conversation 再读取脚本并报告节点、执行顺序、参数、conversation 配置和 debug registry，Kanban 则读取 package.json 中的产物配置、对应 HTML 入口和可选 kanban.json。

命令格式​

workflow-code structure [workflow-dir]

参数​

参数说明
workflow-dirworkflow 项目目录。不传时使用当前目录。

输出结构​

字段说明
projectType项目类型：workflow、conversation 或 kanban。前两者来自 executor；Kanban 来自 package.json.workflowCode.projectType。
artifactDirKanban 静态产物目录，默认 .。
entry相对 artifactDir 的 Kanban HTML 入口，默认 index.html。
manifestKanban 的可选 v1 参数清单。
schedulePresetsWorkflow 在 package.json.workflowCode.schedulePresets 中声明并通过校验的建议计划；Conversation 和 Kanban 不接受该字段。
workflowworkflow 名称和基础信息。
definitions.nodes静态识别到的节点定义。
definitions.variables静态识别到的关键变量。
execution推导出的执行结构，包含 runNode、runStreamNode、runIf、runFor、runWhile、runWorkflow 和 question-classifier 分支；return workflow.runNode(...)、return workflow.runIf(...)、return workflow.runFor(...) 等返回表达式同样会纳入所属 branch/loop。
diagnosticswarnings、violations 和结构分析错误。
paramsexecutor params 声明。
conversationexecutor conversation 配置。
registryexecutor registry 声明。

失败行为​

情况行为
结构分析成功输出结构 JSON，退出码为 0。
projectInfo 含不支持字段或无效关联声明输出包含具体 package 校验错误的结构 JSON，退出码为 1。
发现脚本规则 violations输出包含 diagnostics.error 的结构 JSON，退出码为 1。
workflow 文件无法加载输出错误结构 JSON，退出码为 1。

Workflow/Conversation 结构分析要求源码中存在可静态读取的 workflow.defineExecutor({ ... })。完全缺少 executor、把动态变量传给 defineExecutor(config)、缺少或声明未知 projectType、Workflow 携带 Conversation 配置，以及遗留 conversation.enabled 都会产生带迁移示例的 violation。Kanban 不需要 executor，但必须在 package 中声明类型并提供配置后的普通 HTML 入口；绝对路径、目录逃逸、符号链接、保留目录和无效 kanban.json 会直接报错。

示例​

workflow-code structure .
workflow-code structure workspace/workflow/hello
workflow-code structure workspace/workflow/runtime-timer
workflow-code structure ./roadmap-kanban

适合场景​

场景说明
调试 Desktop 表单参数检查 params 是否被静态识别。
调试单节点运行检查 registry 中是否存在目标节点。
检查节点顺序查看 execution 和 definitions.nodes。
检查条件分支查看 execution 中 source: "run-if" 的 if / else-if / else 路径。
检查循环结构查看 execution 中 source: "run-for" / source: "run-while" 的循环体 children、条件、items 和 maxIterations。
检查 workflow 复用查看 execution 中 standardName: "run-workflow" 的子 workflow 调用节点。
检查定时预设确认 schedulePresets 引用现有 entrypoint，且时区、时间窗口或五字段 Cron 与参数 JSON 有效。CLI 只报告预设，不在后台创建或执行计划。
检查 Kanban确认 projectType、artifactDir、entry 和可选 manifest.params。旧 workflowCode.kanban.dataSources 会直接校验失败；关联项目改由 workflowCode.projectInfo.relatedProjects 声明，不再作为 Kanban 结构字段返回。