@yiyi_zhang/reactflow-ui 0.5.0-beta.0 → 1.1.0

package/README.md

@@ -1,62 +1,70 @@
-# Conductor Workflow IDE (ReactFlow UI)
-
-基于 React 19、ReactFlow 和 Vite 构建的企业级 [Netflix Conductor](https://conductor-oss.org/) 工作流可视化设计器。
-
-提供两个可独立集成的核心组件：
-- **`WorkflowIDE`**（主入口）— 面向专业编排人员的完整可视化设计器
-- **`AiWorkflowIDE`**（`/ai` 子路径）— 对话优先、AI 驱动，面向非技术业务用户
-
-## ✨ 核心特性
-
-### 🎨 可视化建模
-- **从零创建**：无需预先提供 JSON，通过空状态引导面板新建空白工作流，配合中心 **[+]** 引导按钮快速开始建模
-- **完整任务类型**：支持 HTTP、SIMPLE、INLINE/LAMBDA、SWITCH、FORK_JOIN、DO_WHILE、SUB_WORKFLOW、SET_VARIABLE、TERMINATE 等全量 Conductor 任务类型
-- **极简视图**：移除冗余的 START/END 虚拟节点，工作流图更加聚焦业务逻辑
-- **智能布局**：自动 Dagre 布局（TB/LR），超大流程自动触发蛇形布局，编辑/只读模式行为一致
-
-### 🔀 复杂结构编辑
-- **SWITCH 分支管理**：在节点上直接添加、重命名、删除分支，全部通过页面内 Modal，无浏览器原生弹框
-- **DO_WHILE 循环体**：循环任务以容器方式展示，支持在循环体内任意位置插入任务（含首位）
-- **FORK_JOIN 并行分支**：支持动态分支添加和管理
-
-### ✏️ 编辑体验
-- **全屏代码编辑器**：点击任意表达式/脚本/JSON 字段右上角 **⛶** 按钮，展开全屏编辑器，支持 Ctrl+S 保存、Esc 取消，底部状态栏显示行数和字符数
-- **任务引用名实时编辑**：引用名输入框支持流畅输入，失焦/回车后提交，避免逐字符刷新
-- **撤销/重做**：完整的编辑历史，支持 Ctrl+Z / Ctrl+Shift+Z
-- **智能剪贴板**：任务复制粘贴
-
-### 👁️ 视图模式
-- **Business 模式**：仅展示核心业务节点，控制/数据节点折叠为边标签
-- **Standard 模式**：业务 + 控制流节点（默认）
-- **Developer 模式**：显示全部节点，含数据转换等辅助节点，节点上展示表达式预览
-
-### 🚀 运行态监控
-- 节点根据执行状态（Scheduled / In Progress / Completed / Failed / Timed Out / Skipped）实时变色
-- 已完成路径连线高亮，进行中路径动态动画，编辑/只读模式使用静态实线
-- 点击节点展示执行详情面板（输入/输出/耗时/重试次数）
-- **运行态操作**：暂停、继续、终止、重试、重启（支持选择定义版本）、从指定任务重跑、跳过任务
-- `allowOperations` 全局权限开关，快速控制操作按钮是否可用
-
-### 🤖 AI Copilot（智能辅助）
-- 自然语言描述生成完整工作流，支持对话式迭代修改
-- 差异卡片（Diff Card）预览变更内容，一键应用/撤销
-- **✨ AI 参数填充（v0.4.0 新增）**：节点编辑面板一键调用 AI 生成完整 `inputParameters`，基于任务类型、上游任务列表和工作流入参自动推断，diff 预览后一键应用
-
-### 🔬 执行验证闭环（v0.4.0 新增）
-- **执行验证面板**：在 edit 模式下点击"▶ 执行验证"按钮，填写工作流入参（表单/JSON 双模式），一键触发真实 Conductor 执行
-- **自动切换 run 模式**：执行触发后 IDE 自动切换到运行态，通过指数退避轮询实时更新执行状态
-- **结构化入参声明**：`WorkflowSettingsPanel` 支持可视化编辑入参名称、类型、是否必填、描述和示例值
-
-### 📊 执行结果分析（v0.4.0 新增）
-- **执行概览面板**：run 模式下点击"📊 分析"，展示总任务数/成功率/失败数/总耗时概览卡片
-- **步骤时序表**：按 `startTime` 排序显示所有任务的执行状态、耗时和重试次数，点击行可高亮对应节点
-- **智能故障诊断**：自动识别 10+ 种常见 Conductor 错误模式（JSONPath 失败、HTTP 错误码、超时、认证、脚本异常等），在诊断卡片中给出可操作的修复建议
-- **"去修复"跳转**：点击诊断卡片的"去修复"按钮，一键切换到 edit 模式并选中问题任务
-
-### 🏢 企业级能力
-- TypeScript 全量类型定义（WorkflowDef、TaskDef、WorkflowInputParam、ExecutionActions…）
-- 命令式 API（`ref`）支持程序化创建、保存、导出
-- 强类型 Ref API：`getWorkflowDef()`、`save()`、`createBlankWorkflow()`
+# Conductor Workflow IDE (`@yiyi_zhang/reactflow-ui` v1.1.0)
+
+基于 **React 19、ReactFlow 与 Zustand** 构建的下一代企业级 [Netflix Conductor](https://conductor-oss.org/) 工作流可视化设计器与 AI 原生编排 IDE。
+
+提供两个可独立按需集成的核心组件入口：
+- **`WorkflowIDE`**（主入口 `@yiyi_zhang/reactflow-ui`）— 双模全融合，支持面向业务与运维的**业务卡片流 (StepFlow)**，以及面向架构研发的**专业开发者 DAG 拓扑**同屏热切换
+- **`AiWorkflowIDE`**（子路径 `@yiyi_zhang/reactflow-ui/ai`）— 对话优先、AI 驱动，支持多轮 Agentic 编排、子工作流库复用与混合交互
+
+---
+
+## ⚡ v1.1.0 业务与技术全融合核心新特性 (New in v1.1.0)
+
+### 👔 支柱一：业务卡片流设计器 (Business StepFlow) 与双模同屏无损热切换
+- **双模毫秒级热切换**：工具栏一键切换 `👔 业务模式` ⇄ `💻 开发者模式`。业务模式下将复杂的微服务连线拓扑解构为清晰直观的业务卡片流，支持任意位置插入步骤、上下重排与内联表单配置。
+- **StepModel 双向无损编译引擎**：提供递归编译器与反编译器，保证卡片流与原生 Conductor DAG 之间 100% 状态保真转换，非标任务通过 `isProFallback` 严格兜底。
+
+### ☁️ 支柱二：内置云平台动作库与动态参数胶囊
+- **首发生态对接类阿里云云主机 (ECS) 全生命周期动作**：创建云主机、启停机、磁盘快照备份、平滑升降规格、释放实例等。
+- **动态参数胶囊与智能上游引用**：表单输入项胶囊化呈现，一键联想并安全绑定上游步骤产出的参数引用。
+
+### 🔀 支柱三：业务容器化高级控制流卡片
+- **分支路由卡片 (`DecisionBranchCard`)**：分支 Tabs 导航、条件参数配置、分支内多步骤嵌套编排。
+- **并行任务泳道卡片 (`ForkJoinCard`)**：多泳道并发设计器，动态增删泳道。
+- **循环迭代容器卡片 (`LoopDoWhileCard`)**：循环体内嵌任务序列、继续条件表达式与防死循环熔断保护。
+
+### 🪄 支柱四：生产实例一键脱敏提炼为模板工具链 (Template Extractor)
+- **生产资产一键沉淀**：将生产环境或演练场调试好的工作流一键提炼为公共模板，智能隐私脱敏引擎自动擦除内网 IP、密钥、密码与机密 ID。
+- **8 大开箱即用场景模板中心**：覆盖云主机自动化、扩容容灾、定时省电关机等高频场景，支持全流程浏览器沙箱试跑验证。
+
+### 📖 支柱五：运行故事线时间轴与生活化诊断自愈建议
+- **流水账故事线展开 (`RunStoryTimeline`)**：运行态以自然语言叙述工作流执行过程，直观呈现每一步耗时与数据快照。
+- **生活化故障诊断自愈**：告别晦涩堆栈报错，提供通俗易懂的根因诊断与可直接操作的自愈行动建议。
+
+---
+
+## 🌟 v1.0.0 四大确定性工程底座 (Foundation)
+
+### 🧬 支柱一：确定性工作流语言服务 (W-LSP) 与数据血缘图谱
+- **0ms 确定性 JSONPath 补全**：在节点配置面板输入 `${` 时，W-LSP 引擎实时遍历当前节点的所有**合法上游祖先节点**，融合五类数据源（运行态真实 Output、人工 Mock Output、`TaskSchema` 注册表、节点配置自省、类型默认字段）弹出零延迟自动补全，并附带 `⚡ 实时值预览`。
+- **Portal 视口自适应锚定**：补全浮层挂载至 `document.body` 并自动感知视口边界翻转，彻底解决侧边抽屉滚动截断问题。
+- **🔗 数据流血缘图谱 (Data Lineage Graph)**：一键开启画布级蓝色虚线动画边，直观展示跨节点 `${taskRef.output.xxx}` 的参数引用依赖与字段流向。
+- **跨节点安全重构 (Refactor Rename)**：修改任意节点的 `taskReferenceName` 时，自动扫描并重写全图所有下游节点的 `${oldRef.output...}` 表达式，杜绝断链。
+
+### ⚡ 支柱二：浏览器本地沙箱试跑 (0ms Dry-Run) 与时间旅行调试器
+- **无需后端的确定性沙箱引擎 (`localSandboxEngine`)**：支持 `SIMPLE`、`HTTP`、`INLINE`（安全沙箱求值）、`SWITCH`（真实计算 `caseValueParam` / `expression` 路由）、`FORK_JOIN`（并发波次耗时推演）、`DO_WHILE`（多轮循环迭代生成 `__1`、`__2`、`__3`）、`SET_VARIABLE`、`TERMINATE` 等全量控制流。
+- **🧪 人工模拟数据配置台 (`SandboxConfigModal`)**：
+  - **Tab 1 — 全局入参 (`workflow.input`)**：自动提取工作流声明入参与全图 `${workflow.input.xxx}` 隐式引用，一键生成可编辑 JSON 模板。
+  - **Tab 2 — 节点 Mock、故障注入与分支路由**：按节点自定义 Mock Output JSON、模拟耗时 (`durationMs`)、为 `SWITCH` 强制指定命中分支，或注入 `FAILED` / `TIMED_OUT` 异常以验证高可用容错链路。
+- **📊 并发甘特瀑布流与时间旅行回放 (`ExecutionWaterfallPanel`)**：
+  - 底部可展开并发执行甘特图，直观呈现并行分支耗时瓶颈。
+  - 拖动**时间旅行滑块 (`Time-Travel Scrubber`)** 或点击 `▶ 0.5x / 1x / 2x` 回放，画布节点与连线按毫秒级时间戳实时还原任意历史时刻的执行状态。
+- **🔄 循环迭代切片器 (`LoopIterationPill`) & 结构化 JSON 树 (`StructuredJsonViewer`)**：
+  - `DO_WHILE` 节点内嵌 `[1] [2] [3]` 迭代切换胶囊，点击即可切换对应轮次的子任务快照。
+  - 运行态详情面板支持字段搜索高亮、折叠展开与**一键复制 JSONPath (`${taskRef.output.xxx}`)**。
+
+### 🤖 支柱三：画布原生 AI Co-Pilot (`Cmd+K`) 与 Shadow Graph 视觉 Diff
+- **画布内联微调指令栏 (`InlineCanvasCopilot`)**：选中任意节点或直接在画布按下 `Cmd+K` / `Ctrl+K`，原位唤起毛玻璃 AI 指令浮层，支持局部新增下游节点、包裹重试循环、插入条件分支与自动补全参数。
+- **👻 Shadow Graph 架构级 Diff 预览**：AI 生成或修改工作流提案时，画布直接渲染虚拟变更预览图（`+新增` 翠绿高亮、`~修改` 琥珀高亮、`-移除` 绯红虚线），支持顶部胶囊栏一键采纳或按节点部分采纳 (`Partial Accept`)。
+- **零外部运行时依赖的轻量级流程图渲染**：内置基于 Dagre 的原生 SVG 流程图渲染引擎，无需体积庞大的外部 Mermaid 运行时即可在对话流中极速渲染架构图。
+
+### 🎛️ 支柱四：双向实时代码同步、语义级缩放 (Semantic LOD) 与统一工作台
+- **双向实时分屏 JSON 编辑器 (`JsonPreviewPanel`)**：底部 Dock 栏点击 **`{ } JSON`** 即可展开左画布 + 右代码的双栏分屏视图，修改 JSON 经过 300ms 防抖与结构校验后实时驱动画布重绘，画布拖拽/增删节点亦实时同步至代码。
+- **三级语义缩放 (Semantic Zoom LOD)**：
+  - **宏观鸟瞰 (`zoom < 0.55`)**：自动收起次要技术文本，渲染高对比度色块胶囊，百节点大图依然丝滑。
+  - **标准编排 (`0.55 <= zoom <= 1.15`)**：展示节点标题、类型徽章、引用名与运行耗时。
+  - **微距透视 (`zoom > 1.15`)**：节点卡片内直接透视展示核心入参摘要（如 `GET/POST URL`、`SWITCH` 路由表达式等），免去频繁开关抽屉。
+- **统一毛玻璃胶囊工具栏 (`ActionBar`)**：将视图层级分段滑块（**📋 业务 / 🔧 标准 / 💻 全开发**）、**🔗 数据血缘**、**⌘K AI微调**、**↺/↻ 历史栈**、**🩺 诊断**、**⚙️ 配置**、**⚡ 沙箱试运行 | 🧪** 统一收纳于右上角流式 Dock。
 
 ---
 
@@ -66,121 +74,146 @@
 npm install @yiyi_zhang/reactflow-ui reactflow react react-dom
 ```
 
+> **环境要求**：`react >= 18.0.0`（完全兼容 React 18 与 React 19），`reactflow >= 11.11.0`。
+
+---
+
 ## 🚀 快速开始
 
-### WorkflowIDE（专业编排人员）
+### 1. `WorkflowIDE`（面向专业编排与研发人员）
 
 ```tsx
 import { useRef } from 'react';
 import { WorkflowIDE, WorkflowIDERef } from '@yiyi_zhang/reactflow-ui';
 import '@yiyi_zhang/reactflow-ui/style.css';
 
-function App() {
+export default function App() {
   const ideRef = useRef<WorkflowIDERef>(null);
 
   return (
-    <div style={{ height: '100vh' }}>
-      <button onClick={() => ideRef.current?.createBlankWorkflow('my_flow')}>新建</button>
+    <div style={{ height: '100vh', width: '100%' }}>
       <WorkflowIDE
         ref={ideRef}
         theme="dark"
         themeColor="blue"
-        onSave={(workflow) => console.log('保存:', workflow)}
-        onRequestImport={() => { /* 打开文件选择器 */ }}
+        onSave={(workflow) => console.log('保存工作流:', workflow)}
+        onWorkflowChange={(workflow) => console.log('变更回调:', workflow)}
       />
     </div>
   );
 }
 ```
 
-不传 `workflowDef` 时画布显示引导面板，支持空白创建、AI 生成或导入 JSON。
-
-### AiWorkflowIDE（业务用户，AI 驱动）
+### 2. `AiWorkflowIDE`（面向业务与架构人员，AI 原生双栏编排）
 
-从独立子路径导入，避免主入口承担 AI 协议/工具执行等代码体积：
+从独立子路径 `@yiyi_zhang/reactflow-ui/ai` 导入：
 
 ```tsx
 import { AiWorkflowIDE } from '@yiyi_zhang/reactflow-ui/ai';
 import '@yiyi_zhang/reactflow-ui/style.css';
 
-function App() {
+export default function AiApp() {
   return (
-    <div style={{ height: '100vh' }}>
-      <AiWorkflowIDE aiConfig={{ apiKey: 'your-key' }} onSave={(def) => console.log('保存:', def)} />
+    <div style={{ height: '100vh', width: '100%' }}>
+      <AiWorkflowIDE
+        aiConfig={{
+          // 生产环境推荐使用后端代理模式，避免暴露模型 API Key
+          transport: { mode: 'endpoint', endpoint: '/api/ai/workflow-agent' },
+        }}
+        draftPersist={{ key: 'my-workflow-ide-draft' }}
+        onSave={(def) => console.log('保存:', def)}
+      />
     </div>
   );
 }
 ```
 
-> ⚠️ 生产环境请勿将真实模型密钥直接下发到前端，详见 [集成指南](./INTEGRATION.md) 中 AiWorkflowIDE 章节的安全提示。
+### 3. 编程式调用 W-LSP 与本地沙箱引擎 (v1.0.0 新增)
 
-详细集成步骤和 API 参考：**[集成指南 →](./INTEGRATION.md)**
+```tsx
+import {
+  executeLocalSandboxDryRun,
+  buildDataFlowGraph,
+  getCompletionItems,
+} from '@yiyi_zhang/reactflow-ui';
+
+// 1. 0ms 浏览器本地确定性沙箱试跑（支持自定义入参与故障注入）
+const { instance } = executeLocalSandboxDryRun(workflowDef, {
+  workflowInput: { orderId: 'ORD-2026', vipLevel: 3 },
+  taskOverrides: {
+    charge_card: { status: 'FAILED', errorMessage: '模拟支付网关 502 超时' },
+  },
+});
+
+// 2. 构建工作流全局数据血缘图谱
+const lineageGraph = buildDataFlowGraph(workflowDef);
+```
 
 ---
 
-## 🛠️ 开发指南
-
-### 环境要求
-- Node.js >= 18.0.0
-- npm 或 yarn
-
-### 本地开发
+## 🛠️ 本地开发与验证
 
 ```bash
-# 克隆仓库
-git clone https://github.com/yiyisf/reactflow-ui.git
-cd reactflow-ui
-
 # 安装依赖
 npm install
 
-# 启动开发服务器（含演示应用）
+# 启动本地开发调试环境（含完整演示工作台）
 npm run dev
-# 访问 http://localhost:5173
-```
 
-### 构建
+# 运行单元测试（Vitest）
+npm test
 
-```bash
+# 代码规范检查
+npm run lint
+
+# 构建 NPM 发布产物（dist/）
 npm run build
-# 产物生成在 dist/ 目录
 ```
 
-### 项目结构
+---
+
+## 📁 项目结构
 
 ```
 src/
-├── index.ts            # 主入口：WorkflowIDE + 共享类型
-├── ai.ts                # AI 入口（/ai 子路径）：AiWorkflowIDE + AI 配套类型
-├── WorkflowIDE.tsx      # 专业编排组件外壳
-├── AiWorkflowIDE.tsx    # AI 驱动组件外壳
-├── components/          # UI 核心组件（设计器、属性面板、节点…）
-│   ├── nodes/           # 各类型节点组件（TaskNode、DecisionNode、LoopNode…）
-│   ├── AICopilot/       # WorkflowIDE 内置 AI 助手面板
-│   ├── AiNative/        # AiWorkflowIDE 对话/画布/审查等组件
-│   ├── Controls/        # 工具栏、模式切换器
-│   ├── WorkflowRunPanel.tsx    # P4.2: 执行验证入参面板
-│   └── ExecutionSummaryPanel.tsx # P4.3: 执行结果分析面板
-├── services/ai/         # AI 协议适配、工具执行、system prompt 构建
-├── store/               # Zustand 状态管理（workflowStore、aiStore、libraryStore）
-├── parser/              # Conductor JSON ↔ ReactFlow 节点/边转换
-├── layout/              # Dagre 自动布局（含蛇形布局）
-├── types/               # TypeScript 类型定义
-├── styles/              # CSS 变量和执行状态样式
-├── utils/               # 校验器、executionAnalyzer（P4.3 诊断引擎）
-└── demo/                # 演示应用（开发调试用）
+├── index.ts                      # 主入口：WorkflowIDE + W-LSP + 沙箱引擎导出
+├── ai.ts                         # AI 入口（/ai 子路径）：AiWorkflowIDE + Agent 工具链导出
+├── WorkflowIDE.tsx               # 专业编排组件外壳
+├── AiWorkflowIDE.tsx             # AI 原生编排组件外壳
+├── components/
+│   ├── WorkflowDesigner.tsx      # 核心画布（集成血缘连线、Shadow Graph、时间旅行）
+│   ├── TaskDetailPanel.tsx       # 节点属性抽屉（集成 W-LSP 补全与重构提示）
+│   ├── ExecutionTaskPanel.tsx    # 运行态详情抽屉（集成 StructuredJsonViewer）
+│   ├── SandboxConfigModal.tsx    # 🧪 沙箱人工模拟数据与故障注入配置台
+│   ├── ExecutionWaterfallPanel.tsx # 📊 并发甘特瀑布流与时间旅行回放面板
+│   ├── JsonPreviewPanel.tsx      # { } 双向实时分屏 JSON 编辑器
+│   ├── StructuredJsonViewer.tsx  # 树形 JSON 检索与一键复制 JSONPath 组件
+│   ├── nodes/                    # 节点渲染层（含 Semantic LOD 三级语义缩放与 Loop 切片器）
+│   ├── Controls/                 # 统一毛玻璃胶囊工具栏 ActionBar、ModeSlider、ControlHub
+│   ├── AICopilot/                # W-LSP ParameterSuggester 补全浮层与对话面板
+│   └── AiNative/                 # AiCommandCenter、InlineCanvasCopilot (Cmd+K)、MermaidBlock
+├── services/
+│   ├── wlsp/workflowLsp.ts       # W-LSP 工作流语言服务（祖先推导、Schema 推断、血缘、重构）
+│   └── ai/                       # 多模型协议适配、Agent 循环、工具注册表、规则引擎
+├── utils/
+│   ├── localSandboxEngine.ts     # 浏览器本地确定性沙箱执行引擎
+│   ├── validator.ts              # 静态拓扑与引用校验器
+│   └── executionAnalyzer.ts      # 运行态智能故障诊断引擎
+├── store/                        # Zustand 状态管理（workflowStore、aiStore、libraryStore）
+├── parser/                       # Conductor DSL ↔ ReactFlow 节点/边双向解析器
+└── layout/                       # Dagre 自动布局与超大流程蛇形布局引擎
 ```
 
 ---
 
-## 📚 文档资源
+## 📚 文档导航
 
-- [集成指南 (Integration Guide)](./INTEGRATION.md)
-- [最佳实践 (Best Practices)](./docs/best-practices.md)
-- [路线图 (Roadmap)](./ROADMAP.md)
-- [v0.4.0 发布计划](./docs/v0.4.0-release-plan.md)
+- **[🚀 v1.0.0 产品发布宣传首页 (Product Launch Showcase)](./docs/product-launch-v1.0.0.html)** — 100% 单文件零依赖 HTML，含首屏 Before/After 耗时对比、一行命令极速体验、可拖动双滑块团队 ROI 收益计算器与交互式沙箱演练
+- **[集成指南 (INTEGRATION.md)](./INTEGRATION.md)** — Props 详解、运行态接入、AI 代理配置、W-LSP 与沙箱 API
+- **[版本更新日志 (CHANGELOG.md)](./CHANGELOG.md)** — `v1.0.0` 及历次版本完整变更记录
+- **[发展路线图 (ROADMAP.md)](./ROADMAP.md)** — 演进里程碑与未来规划
+- **[最佳实践 (docs/best-practices.md)](./docs/best-practices.md)** — 常见业务拓扑建模规范
 
 ## 📄 许可证
 
 MIT
-

package/dist/AiWorkflowIDE.d.ts

@@ -16,6 +16,8 @@ import type { CustomValidationRule } from './services/ai/ruleEngine';
 import type { TaskSchema } from './services/ai/schemaRegistry';
 import type { AiEvent } from './types/aiEvents';
 import type { IdeDraft } from './services/ai/draftPersistence';
+import './styles/tokens.css';
+import './styles/executionStyles.css';
 import './components/AiNative/AiNative.css';
 export interface AiWorkflowIDEProps {
     /** 初始工作流定义（编辑态） */

package/dist/WorkflowIDE.d.ts

@@ -1,7 +1,7 @@
-import React from 'react';
 import { ThemeMode, ThemeColor, LayoutDirection, ValidationResults, ExecutionActions, ViewMode, WorkflowExecutionInput } from './types/workflow';
 import { WorkflowDef, WorkflowInstance } from './types/conductor';
 import { AIServiceConfig } from './services/aiService';
+import { ActionDefinition } from './actions/types';
 import './styles/tokens.css';
 import './styles/executionStyles.css';
 /**
@@ -93,6 +93,18 @@ export interface WorkflowIDEProps {
      * AI 配置。通过 Props 注入优先于 localStorage 配置。
      */
     aiConfig?: Partial<AIServiceConfig>;
+    /**
+     * UI 体验模式：
+     * - `pro` (默认): 专业开发者模式，展示完整 DAG 画布、底层参数、Monaco JSON
+     * - `business`: 面向普通使用者的业务模式，提供卡片步骤流、业务动作与数据胶囊
+     * @default 'pro'
+     */
+    uiMode?: 'pro' | 'business';
+    /**
+     * 自定义扩展的业务动作定义列表。
+     * 宿主可传入自定义业务动作（如私有云/特定系统连接器）。
+     */
+    actions?: ActionDefinition[];
     /**
      * 组件容器高度。
      * @default '100%'
@@ -132,4 +144,4 @@ export interface WorkflowIDEProps {
  * />
  * ```
  */
-export declare const WorkflowIDE: React.ForwardRefExoticComponent<WorkflowIDEProps & React.RefAttributes<WorkflowIDERef>>;
+export declare const WorkflowIDE: import("react").ForwardRefExoticComponent<WorkflowIDEProps & import("react").RefAttributes<WorkflowIDERef>>;

package/dist/actions/builtin/common.d.ts

@@ -0,0 +1,8 @@
+import type { ActionDefinition } from '../types';
+export declare const notifySendMessageAction: ActionDefinition;
+export declare const humanApprovalAction: ActionDefinition;
+export declare const controlWaitAction: ActionDefinition;
+export declare const controlDecisionAction: ActionDefinition;
+export declare const controlForkAction: ActionDefinition;
+export declare const controlLoopAction: ActionDefinition;
+export declare const BUILTIN_COMMON_ACTIONS: ActionDefinition[];

package/dist/actions/builtin/ecs.d.ts

@@ -0,0 +1,12 @@
+import type { ActionDefinition } from '../types';
+export declare const ecsCreateInstanceAction: ActionDefinition;
+export declare const ecsQueryInstanceAction: ActionDefinition;
+export declare const ecsStartInstanceAction: ActionDefinition;
+export declare const ecsStopInstanceAction: ActionDefinition;
+export declare const ecsRestartInstanceAction: ActionDefinition;
+export declare const ecsModifySpecAction: ActionDefinition;
+export declare const ecsCreateSnapshotAction: ActionDefinition;
+export declare const ecsRunCommandAction: ActionDefinition;
+export declare const ecsGetMonitorMetricsAction: ActionDefinition;
+export declare const ecsReleaseInstanceAction: ActionDefinition;
+export declare const BUILTIN_ECS_ACTIONS: ActionDefinition[];

package/dist/actions/registry.d.ts

@@ -0,0 +1,23 @@
+import type { ActionDefinition, ActionCategory } from './types';
+import type { TaskDef } from '../types/conductor';
+export declare class ActionRegistry {
+    private actions;
+    constructor(initialActions?: ActionDefinition[]);
+    register(action: ActionDefinition): void;
+    registerAll(actions: ActionDefinition[]): void;
+    getAction(id: string): ActionDefinition | undefined;
+    getAllActions(): ActionDefinition[];
+    getActionsByCategory(category?: ActionCategory): ActionDefinition[];
+    /**
+     * Given a Conductor TaskDef, attempt to find a matching ActionDefinition
+     * and decompile it into friendly form values.
+     */
+    findActionForTask(task: TaskDef): {
+        action: ActionDefinition;
+        values: Record<string, any>;
+    } | null;
+}
+/**
+ * Global default ActionRegistry pre-populated with Cloud Host (ECS) and Common actions
+ */
+export declare const defaultActionRegistry: ActionRegistry;

package/dist/actions/types.d.ts

@@ -0,0 +1,45 @@
+import type { TaskDef } from '../types/conductor';
+export type ActionCategory = 'compute' | 'storage' | 'network' | 'monitor' | 'notify' | 'logic' | 'human' | 'custom';
+export type ActionFieldType = 'text' | 'textarea' | 'number' | 'select' | 'boolean' | 'account' | 'cron-friendly';
+export interface ActionFieldOption {
+    label: string;
+    value: any;
+    description?: string;
+}
+export interface ActionField {
+    key: string;
+    label: string;
+    type: ActionFieldType;
+    help?: string;
+    placeholder?: string;
+    required?: boolean;
+    defaultValue?: any;
+    options?: ActionFieldOption[];
+    acceptsPills?: boolean;
+}
+export interface ActionOutputField {
+    key: string;
+    label: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    example?: any;
+    description?: string;
+}
+export interface CompileCtx {
+    taskReferenceName: string;
+    stepIndex: number;
+    workflowName?: string;
+}
+export interface ActionDefinition {
+    id: string;
+    name: string;
+    category: ActionCategory;
+    icon: string;
+    description: string;
+    connector?: string;
+    riskLevel: 'safe' | 'sensitive';
+    fields: ActionField[];
+    outputs: ActionOutputField[];
+    compile: (values: Record<string, any>, ctx: CompileCtx) => TaskDef;
+    decompile?: (task: TaskDef) => Record<string, any> | null;
+    mockOutput?: (values: Record<string, any>) => Record<string, any>;
+}

package/dist/ai.d.ts

@@ -27,4 +27,8 @@ export { applyPartialProposal, describeDiff, computeDiff } from './services/ai/t
 export type { AiMetrics } from './store/aiStore';
 export type { WorkflowDef, TaskDef, WorkflowInputParam, WorkflowInstance } from './types/conductor';
 export { parseWorkflowInputParams } from './types/conductor';
-export type { ExecutionActions, ThemeMode, ThemeColor, LayoutDirection, ViewMode, TaskExecutionData } from './types/workflow';
+export type { ExecutionActions, ThemeMode, ThemeColor, LayoutDirection, ViewMode, TaskExecutionData, WorkflowExecutionInput } from './types/workflow';
+export { getCompletionItems, buildDataFlowGraph, refactorTaskReferenceName, getUpstreamAncestors, inferTaskOutputSchema, } from './services/wlsp/workflowLsp';
+export type { WlspCompletionItem, DataFlowGraph, DataFlowEdge, InferredField, UpstreamTaskInfo, } from './services/wlsp/workflowLsp';
+export { executeLocalSandboxDryRun, buildDefaultWorkflowMockInput, generateDefaultTaskOutputPreview, } from './utils/localSandboxEngine';
+export type { SandboxDryRunOptions, TaskMockOverride, } from './utils/localSandboxEngine';

package/dist/components/AICopilot/ParameterSuggester.d.ts

@@ -1,16 +1,25 @@
 import React from 'react';
 import './ParameterSuggester.css';
+import { WlspCompletionItem, ValueType } from '../../services/wlsp/workflowLsp';
 export interface Suggestion {
     label: string;
     value: string;
     description: string;
+    category?: 'upstream' | 'workflow_input' | 'variable' | 'system' | 'ai';
+    valueType?: ValueType;
+    sourceLabel?: string;
+    sampleValue?: string;
+    isConditional?: boolean;
 }
 interface ParameterSuggesterProps {
     isOpen: boolean;
     onClose: () => void;
     onSelect: (value: string) => void;
     suggestions: Suggestion[];
+    wlspItems?: WlspCompletionItem[];
     anchorRect?: DOMRect;
+    onRequestAiHint?: () => void;
+    aiLoading?: boolean;
 }
 declare const ParameterSuggester: React.FC<ParameterSuggesterProps>;
 export default ParameterSuggester;

package/dist/components/AiNative/AgentTimeline.d.ts

@@ -1,18 +1,23 @@
 /**
- * AgentTimeline — visible work-in-progress log for the current agent turn (M2.2)
+ * AgentTimeline — visible work-in-progress log for the current agent turn (M2.2 + PI Durable 4-Phase Stepper)
  *
- * Replaces the single toolStatus line with a growing list of completed steps
- * ("✓ 已搜索工作流库", "⚠ 发现 2 处校验问题，正在自动修正…") plus the current
- * in-flight step as a spinner row. Self-heal retries log their own entry instead
- * of silently redoing the request, so users see the AI catch and fix its own
- * mistakes rather than experiencing an unexplained pause.
+ * Replaces the single toolStatus line with:
+ * 1. A 4-Phase Synthesis Progress Bar ("① 蓝图定义 → ② 拓扑编排 → ③ 参数与数据流 → ④ 整体校验") when progressive synthesis is active
+ * 2. A growing list of completed steps ("✓ 已搜索工作流库", "✓ 阶段 2/4：已编排 5 个任务拓扑骨架")
+ * 3. The current in-flight step as a spinner row
  */
 import React from 'react';
 import type { TimelineEntry } from '../../store/aiStore';
+import type { SynthesisPhase } from '../../services/ai/workflowSynthesizer';
+import type { WorkflowDef } from '../../types/conductor';
 interface AgentTimelineProps {
     entries: TimelineEntry[];
     /** Current in-flight step label, or '' when nothing is actively running */
     activeLabel: string;
+    /** Optional current 4-phase synthesis stage */
+    synthesisPhase?: SynthesisPhase;
+    /** Optional in-progress working draft */
+    workingDraft?: WorkflowDef | null;
 }
 declare const AgentTimeline: React.FC<AgentTimelineProps>;
 export default AgentTimeline;

package/dist/components/AiNative/InlineCanvasCopilot.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { AIServiceConfig } from '../../services/aiService';
+interface InlineCanvasCopilotProps {
+    aiConfig?: Partial<AIServiceConfig>;
+}
+export declare const InlineCanvasCopilot: React.FC<InlineCanvasCopilotProps>;
+export default InlineCanvasCopilot;

package/dist/components/AiNative/ProposalPreviewCard.d.ts

@@ -1,11 +1,11 @@
 /**
- * ProposalPreviewCard — business step preview for AI proposals (UX Phase A / M2.2)
+ * ProposalPreviewCard — business step preview for AI proposals (UX Phase A / M2.2 + Semantic Verification Badge)
  *
  * Replaces the old "+N 新增 ~N 修改" number-chip summary with an actual preview of
  * what the workflow will look like: every step in business language, added steps
  * highlighted green, modified steps yellow with a one-line change description,
- * removed steps struck through in place. The goal is that a non-technical user can
- * tell what changed in ~10 seconds without opening the canvas.
+ * removed steps struck through in place, plus a holistic semantic & data-flow
+ * verification badge.
  */
 import React from 'react';
 import type { ProposedChange } from '../../store/aiStore';

package/dist/components/BrandLogo.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface BrandLogoProps {
+    size?: number;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Conductor Workflow IDE 极简几何品牌 Logo
+ *
+ * 设计语言：深空圆角矩形底座 + 贝塞尔双分支编排流向 + 三色确定性拓扑节点（靛紫起点 → 青蓝分支 / 翠绿沙箱通过节点）
+ */
+export declare const BrandLogo: React.FC<BrandLogoProps>;
+export default BrandLogo;

package/dist/components/ExecutionWaterfallPanel.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare const ExecutionWaterfallPanel: React.FC;
+export default ExecutionWaterfallPanel;

package/dist/components/SandboxConfigModal.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+interface SandboxConfigModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+}
+export declare const SandboxConfigModal: React.FC<SandboxConfigModalProps>;
+export default SandboxConfigModal;

package/dist/components/StructuredJsonViewer.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+interface StructuredJsonViewerProps {
+    data: any;
+    /** Optional taskReferenceName to generate `${taskRef.output.xxx}` expressions on hover */
+    taskReferenceName?: string;
+    /** Either 'output' or 'input' (or 'workflow.input') for expression path generation */
+    expressionScope?: 'output' | 'input' | 'workflow.input';
+    maxHeight?: string;
+}
+export declare const StructuredJsonViewer: React.FC<StructuredJsonViewerProps>;
+export default StructuredJsonViewer;

package/dist/components/business/ActionForm.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+export interface ActionFormProps {
+    step: BusinessStep;
+    upstreamSteps: BusinessStep[];
+    workflowInputParams?: any[];
+    registry?: ActionRegistry;
+    onChange: (updatedStep: BusinessStep) => void;
+    disabled?: boolean;
+}
+export declare const ActionForm: React.FC<ActionFormProps>;