@fudanda/workflow 2.20261024.1-beta.1 → 2.20261107.1-beta.1

package/LICENSE

@@ -1,21 +1,21 @@
-# MIT License
-
-Copyright (c) 2026 iwangbowen
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+# MIT License
+
+Copyright (c) 2026 iwangbowen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,114 +1,114 @@
-# @fudanda/workflow
-
-独立的 ArcBase Graph v1/v2 编辑器。FlowGram 自由布局编辑器及背景、吸附、小地图插件固定为 **1.0.15**；Coze Studio 组件固定取自 `fefb05ff27be1da939612fbf9faf5db62583b8ae`。
-
-```tsx
-import { ArcBaseWorkflowDesigner } from '@fudanda/workflow';
-import '@fudanda/workflow/styles.css';
-import '@douyinfe/semi-ui/react19-adapter';
-
-<ArcBaseWorkflowDesigner
-  value={graph}
-  catalog={catalog.nodes}
-  onChange={setGraph}
-  sources={catalog.sources.map(source => source.name)}
-  sourceSchemas={Object.fromEntries(catalog.sources.map(source => [source.name, source.schema]))}
-  credentials={credentialMetadata}
-  models={catalog.models}
-  theme="light"
-  height={740}
-  onNodeSelect={setSelectedNodeId}
-  onValidationChange={setDiagnostics}
-/>
-```
-
-`value`、`catalog` 为必需属性；其余可选。`credentials` 仅传入 `{id,name,kind?}` 元数据，禁止传入秘密。接口触发的输入结构可以通过 `sourceSchemas={{trigger:inputSchema}}` 传入；提供 `onInputSchemaChange` 后，开始节点通过原版 OutputTree 编辑嵌套输入的名称、类型、必填、默认值和描述。无法安全编辑的 schema 保留原结构并只读展示；宿主注册的事件 schema 只读。重名、空名称和无效 JSON 默认值会通过校验回调阻止保存。
-
-页面组件移植覆盖 Coze 的节点拖拽外壳、标题与操作菜单、浮动节点选择面板、
-居中分组工具栏、表单分区、变量树及输入输出结果面板；相关 LESS 展开为实例范围内的 CSS。
-“添加节点”打开分类面板；选中或添加节点后关闭分类面板，右侧打开配置。
-节点及工具栏使用固定源码中的本地 SVG，不加载 Coze 的远程资源。
-
-`toolbarExtra` 允许宿主把真实测试等操作放入底部独立操作组；组件自身不执行请求。
-`minimapVisible` 与 `onMinimapVisibleChange` 可由宿主控制小地图开关并持久化偏好；未传入时仍使用实例内状态，初始关闭。管理台按部署标识和当前账号保存开关，设计器与运行检查页面共用；刷新后恢复显示或隐藏，不写入流程图或发布版本。独立设计器本身不读取浏览器存储。
-工具条沿用 Coze 的交互方式、缩放、注释、自动整理、小地图、添加节点顺序及尺寸；缩放菜单向上打开，添加节点支持短暂悬停展开，小地图居中显示在工具条上方。`WorkflowTestRunButton` 从 `@fudanda/workflow/chrome` 导出，宿主传入 `disabled` 和 `onClick` 接通真实试运行。
-
-注释保存为 Graph v1/v2 的可选 `annotations` 展示数据，每个图最多 100 条，每条最多 5000 字符；保留文本、ID 和图内坐标。可创建、编辑、拖动标题、删除、撤销及复制粘贴，运行快照只读展示。注释不成为执行节点、变量来源或 DBOS 持久操作，不改变旧流程的执行顺序。本轮使用纯文本编辑，尚未移植 Coze 的富文本注释工具。
-`@fudanda/workflow/chrome` 提供轻量 `WorkflowHeader`（`info`、`actions` 属性）
-与 `WorkflowControlIcon`，宿主可复用标题栏而无需提前加载 FlowGram。
-
-每实例有独立的 FlowGram Provider、内存存储、历史、复制缓冲及弹层容器。样式和主题以 `.arc-workflow-designer` 为边界，不修改宿主 body。组件不导入 Client/Web/Admin，不请求 API、不读取会话或全局存储；没有 iframe。宿主负责 Cookie、CSRF、保存、发布、测试和查询。
-
-支持拖拽节点和连线、条件与 Switch 动态端口、撤销重做、框选、复制粘贴、自动整理、小地图和从参数面板在连线上插入节点。参数面板支持输入绑定、上游变量、可选分支输入、JSON 固定值、输出结构及配置诊断。宿主自定义节点按目录版本注册，提供 JSON 配置编辑；未知节点保留配置和绑定并提示不可用。
-
-`readOnly` + `nodeRuns` 展示运行快照和节点结果。流程与画布的双向适配保留节点和连线 ID、版本、配置、绑定、坐标、空值及未知节点；**FlowGram 文档不得发往 API 或入库**。
-
-宿主可传入 `diagnostics` 展示服务端安全诊断，并通过 `selectedNodeId` 与 `onNodeSelect`
-控制检查节点；点击字段诊断定位参数。非法 JSON 暂存在当前实例，在关闭参数面板后仍保留，
-通过 `onValidationChange` 返回 `json_invalid`。宿主必须在修正前阻止保存、发布和测试，避免提交旧值。
-
-旧 WorkflowBuilder 参考目录只作历史源码保留，不参与 TypeScript、运行入口和 npm 包；
-iframe 协议、构建入口及专属运行依赖已退出。构建会检查 Coze 来源哈希、版权和 FlowGram 固定版本。
-
-```sh
-npm run build -w @fudanda/workflow
-npm run test -w @fudanda/workflow
-npm run pack:packages
-npm run test:automation:external
-```
-
-最后一条命令在仓库外安装本地归档，通过真实 Go API 验证完整工作台及 `/dash/designer.html` 的双实例示例。完整责任边界见 [改造计划](../../docs/plan/arcbase-workflow-coze-flowgram.md)。本阶段不发布 npm。
-
-Coze 采用选择性源码移植；原始文件、SHA256、上游路径、修改说明和许可证见 `vendor/coze/UPSTREAM.json`、`vendor/coze/original` 及 `THIRD-PARTY-NOTICES.md`。本包构建不需要参考源码目录；`npm run vendor:coze -w @fudanda/workflow` 仅在重新核对固定源码时使用。
-
-本包包含逐步移植的 Coze 设计器界面，不包含整个 Coze Studio 或 Coze 后端。
-可选 Eino 大模型节点由宿主模型目录启用；`models` 只传安全元数据，不能传地址或密钥。
-只迁入工作流。智能体、应用、知识库和插件不在当前范围；节点与执行能力见[工作流迁移清单](../../docs/plan/arcbase-coze-product-parity.md)。
-
-节点参数面板采用 Coze 的 360–546px 可调宽布局，支持拖动左边缘和键盘方向键。
-小地图默认关闭，通过工具栏按实例切换；居中显示在工具条上方，随工具条换行调整位置，不随图坐标滚动，支持点击及拖动导航。节点面板在工具栏上方弹出。
-画布图标使用上游实际节点注册图标（JPEG），执行追踪 SVG 属于另一套资源。
-宿主可传 `sidePanel` 装配测试输入与运行结果，通过 `workflow/chrome` 的
-`WorkflowSidePanel` 复用侧栏外壳；设计器仍不调用 API。选择节点后由宿主切回参数面板。
-
-本地 Coze 实页面对照和部署说明见 [Coze 参考环境](../../docs/guide/coze-reference.md)。
-
-当前复制 206 个固定提交的组件、样式和类型文件，新增 Coze 注释 Leaf、Block、Toolbar 和格式常量。复制脚本为 `scripts/copy-coze-source.mjs`；原文件在 `vendor/coze/source`，执行副本在 `src/coze/source`，两者 SHA256 均在 manifest 校验。`compat` 和 `scripts/ports` 负责 React 19、Graph v1/v2、可用变量、InputSlot CodeMirror 桥接和实例状态适配；设计器仍无请求和会话。条件排序保留分支端口和连线，作为一次历史操作提交；拖拽管理器与 JSON 草稿按实例隔离。
-
-宿主可传 `initialViewport` / `onViewportChange` 保存缩放与位置，使用 `interactionMode` / `onInteractionModeChange` 保存鼠标或触控板方式；设计器自己不访问 localStorage。管理台按部署、账号、流程保存画布偏好和最近运行 ID，在对应修订可用时从授权接口恢复结果。
-
-注释的可选 `richText` 保存 Coze Slate JSON，`text` 保持旧宿主兼容。支持标题、引用、列表、加粗、斜体、下划线、删除线和受限链接；粘贴按纯文本处理，服务端校验结构和大小。不改变数据库结构或 DBOS 操作顺序。完整结果复制与下载在浏览器后台序列化，不裁剪持久化数据；宿主 CSP 若限制 Worker，需允许 `worker-src 'self' blob:`，失败显示可重试错误。
-
-模型参数采用原版精确/平衡/创意/自定义交互。JSON 模式提供显式输出 Schema，供 Go 运行时校验并生成下游变量结构。提示词复用原 SystemPromptEditor、CodeMirror 与 ExpandEditorContainer，通过 React 19 适配支持展开编辑、光标位置插入变量、键盘补全、有效/无效引用高亮；更改输入别名立即更新引用诊断。文本模板候选仅使用当前节点已绑定的输入名；意图描述关闭变量插值。展开修改立即同步到宿主草稿，仍需显式保存；弹层、键盘、主题与补全按实例隔离。工作流范围内的 Prompt Kit 已接通组织提示词库、版本、比较、填写块与真实 Eino 优化；技能、多模态及部分高级模型参数不在本阶段。独立示例中的“示例模型（仅编辑，不执行 AI）”仅验证组件交互，真实模型验收必须配置服务后执行。
-
-宿主可传 `onNodeTest(nodeId)` 打开真实顶层单节点测试；设计器不访问接口。批处理和循环使用同一 Provider 的原生内嵌子画布，内部编辑、连线、复制粘贴和撤销重做仍通过 `config.body` 返回 ArcBase 图；不会保存 FlowGram 文档。只读结果可按迭代查看，宿主传入嵌套运行记录 ID 时自动定位内部节点和所属迭代。子流程快照通过只读内部查看器检查。
-
-顶层 `onNodeSelect` 仍返回原节点 ID；内部选择返回不持久化的画布标识。宿主可通过 `resolveWorkflowSelection(graph, id)` 得到 `{node, graph, path}`，不要把画布标识作为业务节点 ID 调用接口。`selectedNodeId` 接受上述画布标识或实际运行记录的 `nodeId`。
-
-可选 `onNodeRunSelect(recordId)` 在选中节点/切换迭代且有真实运行记录时发出持久记录 ID，供宿主同步底部选中状态。`onSidePanelClose()` 在 Escape 关闭宿主 `sidePanel` 时回调；变量弹层先消费 Escape，输入编辑、IME、只读和弹层不会触发图形复制/删除/撤销。画布支持 Ctrl/Cmd+Z、Shift+Z 和 Ctrl/Cmd+Y。
-
-`workflow/chrome` 提供 `WorkflowExecutionPanel({header,children,onClose})`，使用固定版 Coze BottomPanel 源码。宿主传入记录内容，不提供网络和缓存。高度为每实例状态，支持指针拖动及 ArrowUp/ArrowDown/Home/End；默认 200px，范围 120–420px，并为画布保留空间。
-
-宿主更新 `value` 时，设计器会删除不再存在的节点和辅助画布，并清除旧历史；正常 `onChange` 回传保持历史。辅助容器与连接只存在于 FlowGram 文档中，API 图仍使用本地节点 ID 和 `config.body`。流程体定位与适应画布会避开当前实例的参数面板。
-
-`workflow/chrome` 新增纯展示组件 `WorkflowTestInput`，属性为 `schema`、JSON 字符串 `value`、`onChange`、`onValidityChange` 和可选 `description`。有字段定义时默认表单，支持 JSON 切换、类型及必填校验；没有安全字段定义时保留 JSON 编辑。宿主根据有效状态控制真实测试按钮。发布历史、语义对比与恢复仍由 admin/automation 装配。来源、能力和差异见 `docs/plan/arcbase-workflow-node-inventory.md`。
-
-`workflow/chrome` 同时导出 `WorkflowInputFields({schema,onChange,onValidation,readOnly})`，供宿主设置面板复用开始节点字段编辑器。每实例拥有独立弹层容器；调用方控制 Schema、错误及保存，不访问会话或 API。高级 JSON Schema 约束仍由宿主及 Go 校验。
-
-Coze 组件自行导入的 CSS 也在构建时限制于 `.arc-workflow-designer`，不会覆盖宿主 Semi 弹层。输入字段编辑器同时提供 Semi 和设计器弹层边界；SDK 构建检查实际产物，防止全局下拉背景规则重新泄漏。
-
-
-2026-10-04 后续更新：循环体展示、工作流 Prompt Kit 和持久断点已接入。提示词库由宿主回调提供；断点使用独立 DBOS V3 名称和持久继续命令，旧 Graph v1/v2 恢复入口保持不变。本次新增显式 automation 迁移版本 2，详情与架构见[循环体、Prompt Kit 与断点](../../docs/guide/workflow-debug-prompt-kit.md)。历史段落的“尚未实现”描述以本次更新为准，不代表整个 Coze 产品已 1:1 完成。
-
-`nodeRuns[].preview` 显示有界流式预览，最终结果仍在 `output`。`dataOmitted` 表示宿主尚未加载完整结果；可选 `onNodeResultRequest(recordId)` 由宿主查询后回传。大结果树有展示预算，提供完整复制与下载。纯展示组件不自行订阅或请求，详见[流式运行与性能](../../docs/guide/workflow-stream-performance.md)。
-
-选择节点和调整参数面板宽度保留用户缩放，只移动被遮挡的节点。初次适应画布最多 100%；显式“适应画布”和“编辑流程体”按可视区域定位，大型流程体可缩小到编辑器限制。原 Coze 类型摘要及模型名称使用宿主传入的真实目录，不改变图数据。8091 的真实对照和剩余差异见[工作流界面对照](../../docs/guide/workflow-ui-parity.md)。
-
-单出口动作的异常表单使用原 Coze 超时、重试和处理方式控件，通过可选 `node.execution` 回传宿主，支持中断、设定输出和 `error` 分支；Go 执行其实际语义。缺少该字段时保持旧行为。单节点播放按钮位于原标题，仍通过 `onNodeTest` 回调开启宿主的真实测试。已处理异常的运行结果保留错误和尝试次数。
-
-大模型 JSON 输出字段使用原 `OutputTree`，保留复杂 Schema；`outputLayout: 'fields'` 提供顶层字段和 `$model` 元数据，旧输出默认仍为 `structured`。文本支持 `textOutputName`。字段树未完成的编辑按实例保留，返回 `schema_invalid`，宿主必须像 `json_invalid` 一样阻止保存/发布/测试；关闭参数面板不能将旧值当作有效提交。
-
-大图画布节点仅挂载摘要，参数表单在检查面板按需挂载，避免为每张卡片初始化表单引擎。ArcBase 元数据仍通过双向适配保存，配置更新进入该实例原有的 FlowGram 事务历史；节点新增、复制、移动和参数编辑继续支持撤销重做。外部 `value` 替换清理旧历史，正常 `onChange` 回传保留历史。完整结果后台处理完成后，还会核对当前节点和组件状态，离开原结果后不复制或下载旧内容。公共属性及持久图格式保持兼容。
-## 宿主主题颜色
-
-`theme` 控制明暗模式，`themeColors` 可传入宿主的语义颜色：`primary`、`primaryHover`、`primaryActive`、`primaryLight`、`primaryLightHover`、`primaryLightActive`、`background`、`surface`、`text`、`muted`、`border`、`fill`。管理台自动从现有 Semi UI 主题同步这些颜色，节点选中、连线、按钮和参数弹层保持一致；节点类别图标仍保留各自的识别色。独立宿主通过属性提供颜色，设计器不读取全局主题、会话或存储。未传入时保留独立设计器默认配色。
+# @fudanda/workflow
+
+独立的 ArcBase Graph v1/v2 编辑器。FlowGram 自由布局编辑器及背景、吸附、小地图插件固定为 **1.0.15**；Coze Studio 组件固定取自 `fefb05ff27be1da939612fbf9faf5db62583b8ae`。
+
+```tsx
+import { ArcBaseWorkflowDesigner } from '@fudanda/workflow';
+import '@fudanda/workflow/styles.css';
+import '@douyinfe/semi-ui/react19-adapter';
+
+<ArcBaseWorkflowDesigner
+  value={graph}
+  catalog={catalog.nodes}
+  onChange={setGraph}
+  sources={catalog.sources.map(source => source.name)}
+  sourceSchemas={Object.fromEntries(catalog.sources.map(source => [source.name, source.schema]))}
+  credentials={credentialMetadata}
+  models={catalog.models}
+  theme="light"
+  height={740}
+  onNodeSelect={setSelectedNodeId}
+  onValidationChange={setDiagnostics}
+/>
+```
+
+`value`、`catalog` 为必需属性；其余可选。`credentials` 仅传入 `{id,name,kind?}` 元数据，禁止传入秘密。接口触发的输入结构可以通过 `sourceSchemas={{trigger:inputSchema}}` 传入；提供 `onInputSchemaChange` 后，开始节点通过原版 OutputTree 编辑嵌套输入的名称、类型、必填、默认值和描述。无法安全编辑的 schema 保留原结构并只读展示；宿主注册的事件 schema 只读。重名、空名称和无效 JSON 默认值会通过校验回调阻止保存。
+
+页面组件移植覆盖 Coze 的节点拖拽外壳、标题与操作菜单、浮动节点选择面板、
+居中分组工具栏、表单分区、变量树及输入输出结果面板；相关 LESS 展开为实例范围内的 CSS。
+“添加节点”打开分类面板；选中或添加节点后关闭分类面板，右侧打开配置。
+节点及工具栏使用固定源码中的本地 SVG，不加载 Coze 的远程资源。
+
+`toolbarExtra` 允许宿主把真实测试等操作放入底部独立操作组；组件自身不执行请求。
+`minimapVisible` 与 `onMinimapVisibleChange` 可由宿主控制小地图开关并持久化偏好；未传入时仍使用实例内状态，初始关闭。管理台按部署标识和当前账号保存开关，设计器与运行检查页面共用；刷新后恢复显示或隐藏，不写入流程图或发布版本。独立设计器本身不读取浏览器存储。
+工具条沿用 Coze 的交互方式、缩放、注释、自动整理、小地图、添加节点顺序及尺寸；缩放菜单向上打开，添加节点支持短暂悬停展开，小地图居中显示在工具条上方。`WorkflowTestRunButton` 从 `@fudanda/workflow/chrome` 导出，宿主传入 `disabled` 和 `onClick` 接通真实试运行。
+
+注释保存为 Graph v1/v2 的可选 `annotations` 展示数据，每个图最多 100 条，每条最多 5000 字符；保留文本、ID 和图内坐标。可创建、编辑、拖动标题、删除、撤销及复制粘贴，运行快照只读展示。注释不成为执行节点、变量来源或 DBOS 持久操作，不改变旧流程的执行顺序。本轮使用纯文本编辑，尚未移植 Coze 的富文本注释工具。
+`@fudanda/workflow/chrome` 提供轻量 `WorkflowHeader`（`info`、`actions` 属性）
+与 `WorkflowControlIcon`，宿主可复用标题栏而无需提前加载 FlowGram。
+
+每实例有独立的 FlowGram Provider、内存存储、历史、复制缓冲及弹层容器。样式和主题以 `.arc-workflow-designer` 为边界，不修改宿主 body。组件不导入 Client/Web/Admin，不请求 API、不读取会话或全局存储；没有 iframe。宿主负责 Cookie、CSRF、保存、发布、测试和查询。
+
+支持拖拽节点和连线、条件与 Switch 动态端口、撤销重做、框选、复制粘贴、自动整理、小地图和从参数面板在连线上插入节点。参数面板支持输入绑定、上游变量、可选分支输入、JSON 固定值、输出结构及配置诊断。宿主自定义节点按目录版本注册，提供 JSON 配置编辑；未知节点保留配置和绑定并提示不可用。
+
+`readOnly` + `nodeRuns` 展示运行快照和节点结果。流程与画布的双向适配保留节点和连线 ID、版本、配置、绑定、坐标、空值及未知节点；**FlowGram 文档不得发往 API 或入库**。
+
+宿主可传入 `diagnostics` 展示服务端安全诊断，并通过 `selectedNodeId` 与 `onNodeSelect`
+控制检查节点；点击字段诊断定位参数。非法 JSON 暂存在当前实例，在关闭参数面板后仍保留，
+通过 `onValidationChange` 返回 `json_invalid`。宿主必须在修正前阻止保存、发布和测试，避免提交旧值。
+
+旧 WorkflowBuilder 参考目录只作历史源码保留，不参与 TypeScript、运行入口和 npm 包；
+iframe 协议、构建入口及专属运行依赖已退出。构建会检查 Coze 来源哈希、版权和 FlowGram 固定版本。
+
+```sh
+npm run build -w @fudanda/workflow
+npm run test -w @fudanda/workflow
+npm run pack:packages
+npm run test:automation:external
+```
+
+最后一条命令在仓库外安装本地归档，通过真实 Go API 验证完整工作台及 `/dash/designer.html` 的双实例示例。完整责任边界见 [改造计划](../../docs/plan/arcbase-workflow-coze-flowgram.md)。本阶段不发布 npm。
+
+Coze 采用选择性源码移植；原始文件、SHA256、上游路径、修改说明和许可证见 `vendor/coze/UPSTREAM.json`、`vendor/coze/original` 及 `THIRD-PARTY-NOTICES.md`。本包构建不需要参考源码目录；`npm run vendor:coze -w @fudanda/workflow` 仅在重新核对固定源码时使用。
+
+本包包含逐步移植的 Coze 设计器界面，不包含整个 Coze Studio 或 Coze 后端。
+可选 Eino 大模型节点由宿主模型目录启用；`models` 只传安全元数据，不能传地址或密钥。
+只迁入工作流。智能体、应用、知识库和插件不在当前范围；节点与执行能力见[工作流迁移清单](../../docs/plan/arcbase-coze-product-parity.md)。
+
+节点参数面板采用 Coze 的 360–546px 可调宽布局，支持拖动左边缘和键盘方向键。
+小地图默认关闭，通过工具栏按实例切换；居中显示在工具条上方，随工具条换行调整位置，不随图坐标滚动，支持点击及拖动导航。节点面板在工具栏上方弹出。
+画布图标使用上游实际节点注册图标（JPEG），执行追踪 SVG 属于另一套资源。
+宿主可传 `sidePanel` 装配测试输入与运行结果，通过 `workflow/chrome` 的
+`WorkflowSidePanel` 复用侧栏外壳；设计器仍不调用 API。选择节点后由宿主切回参数面板。
+
+本地 Coze 实页面对照和部署说明见 [Coze 参考环境](../../docs/guide/coze-reference.md)。
+
+当前复制 206 个固定提交的组件、样式和类型文件，新增 Coze 注释 Leaf、Block、Toolbar 和格式常量。复制脚本为 `scripts/copy-coze-source.mjs`；原文件在 `vendor/coze/source`，执行副本在 `src/coze/source`，两者 SHA256 均在 manifest 校验。`compat` 和 `scripts/ports` 负责 React 19、Graph v1/v2、可用变量、InputSlot CodeMirror 桥接和实例状态适配；设计器仍无请求和会话。条件排序保留分支端口和连线，作为一次历史操作提交；拖拽管理器与 JSON 草稿按实例隔离。
+
+宿主可传 `initialViewport` / `onViewportChange` 保存缩放与位置，使用 `interactionMode` / `onInteractionModeChange` 保存鼠标或触控板方式；设计器自己不访问 localStorage。管理台按部署、账号、流程保存画布偏好和最近运行 ID，在对应修订可用时从授权接口恢复结果。
+
+注释的可选 `richText` 保存 Coze Slate JSON，`text` 保持旧宿主兼容。支持标题、引用、列表、加粗、斜体、下划线、删除线和受限链接；粘贴按纯文本处理，服务端校验结构和大小。不改变数据库结构或 DBOS 操作顺序。完整结果复制与下载在浏览器后台序列化，不裁剪持久化数据；宿主 CSP 若限制 Worker，需允许 `worker-src 'self' blob:`，失败显示可重试错误。
+
+模型参数采用原版精确/平衡/创意/自定义交互。JSON 模式提供显式输出 Schema，供 Go 运行时校验并生成下游变量结构。提示词复用原 SystemPromptEditor、CodeMirror 与 ExpandEditorContainer，通过 React 19 适配支持展开编辑、光标位置插入变量、键盘补全、有效/无效引用高亮；更改输入别名立即更新引用诊断。文本模板候选仅使用当前节点已绑定的输入名；意图描述关闭变量插值。展开修改立即同步到宿主草稿，仍需显式保存；弹层、键盘、主题与补全按实例隔离。工作流范围内的 Prompt Kit 已接通组织提示词库、版本、比较、填写块与真实 Eino 优化；技能、多模态及部分高级模型参数不在本阶段。独立示例中的“示例模型（仅编辑，不执行 AI）”仅验证组件交互，真实模型验收必须配置服务后执行。
+
+宿主可传 `onNodeTest(nodeId)` 打开真实顶层单节点测试；设计器不访问接口。批处理和循环使用同一 Provider 的原生内嵌子画布，内部编辑、连线、复制粘贴和撤销重做仍通过 `config.body` 返回 ArcBase 图；不会保存 FlowGram 文档。只读结果可按迭代查看，宿主传入嵌套运行记录 ID 时自动定位内部节点和所属迭代。子流程快照通过只读内部查看器检查。
+
+顶层 `onNodeSelect` 仍返回原节点 ID；内部选择返回不持久化的画布标识。宿主可通过 `resolveWorkflowSelection(graph, id)` 得到 `{node, graph, path}`，不要把画布标识作为业务节点 ID 调用接口。`selectedNodeId` 接受上述画布标识或实际运行记录的 `nodeId`。
+
+可选 `onNodeRunSelect(recordId)` 在选中节点/切换迭代且有真实运行记录时发出持久记录 ID，供宿主同步底部选中状态。`onSidePanelClose()` 在 Escape 关闭宿主 `sidePanel` 时回调；变量弹层先消费 Escape，输入编辑、IME、只读和弹层不会触发图形复制/删除/撤销。画布支持 Ctrl/Cmd+Z、Shift+Z 和 Ctrl/Cmd+Y。
+
+`workflow/chrome` 提供 `WorkflowExecutionPanel({header,children,onClose})`，使用固定版 Coze BottomPanel 源码。宿主传入记录内容，不提供网络和缓存。高度为每实例状态，支持指针拖动及 ArrowUp/ArrowDown/Home/End；默认 200px，范围 120–420px，并为画布保留空间。
+
+宿主更新 `value` 时，设计器会删除不再存在的节点和辅助画布，并清除旧历史；正常 `onChange` 回传保持历史。辅助容器与连接只存在于 FlowGram 文档中，API 图仍使用本地节点 ID 和 `config.body`。流程体定位与适应画布会避开当前实例的参数面板。
+
+`workflow/chrome` 新增纯展示组件 `WorkflowTestInput`，属性为 `schema`、JSON 字符串 `value`、`onChange`、`onValidityChange` 和可选 `description`。有字段定义时默认表单，支持 JSON 切换、类型及必填校验；没有安全字段定义时保留 JSON 编辑。宿主根据有效状态控制真实测试按钮。发布历史、语义对比与恢复仍由 admin/automation 装配。来源、能力和差异见 `docs/plan/arcbase-workflow-node-inventory.md`。
+
+`workflow/chrome` 同时导出 `WorkflowInputFields({schema,onChange,onValidation,readOnly})`，供宿主设置面板复用开始节点字段编辑器。每实例拥有独立弹层容器；调用方控制 Schema、错误及保存，不访问会话或 API。高级 JSON Schema 约束仍由宿主及 Go 校验。
+
+Coze 组件自行导入的 CSS 也在构建时限制于 `.arc-workflow-designer`，不会覆盖宿主 Semi 弹层。输入字段编辑器同时提供 Semi 和设计器弹层边界；SDK 构建检查实际产物，防止全局下拉背景规则重新泄漏。
+
+
+2026-10-04 后续更新：循环体展示、工作流 Prompt Kit 和持久断点已接入。提示词库由宿主回调提供；断点使用独立 DBOS V3 名称和持久继续命令，旧 Graph v1/v2 恢复入口保持不变。本次新增显式 automation 迁移版本 2，详情与架构见[循环体、Prompt Kit 与断点](../../docs/guide/workflow-debug-prompt-kit.md)。历史段落的“尚未实现”描述以本次更新为准，不代表整个 Coze 产品已 1:1 完成。
+
+`nodeRuns[].preview` 显示有界流式预览，最终结果仍在 `output`。`dataOmitted` 表示宿主尚未加载完整结果；可选 `onNodeResultRequest(recordId)` 由宿主查询后回传。大结果树有展示预算，提供完整复制与下载。纯展示组件不自行订阅或请求，详见[流式运行与性能](../../docs/guide/workflow-stream-performance.md)。
+
+选择节点和调整参数面板宽度保留用户缩放，只移动被遮挡的节点。初次适应画布最多 100%；显式“适应画布”和“编辑流程体”按可视区域定位，大型流程体可缩小到编辑器限制。原 Coze 类型摘要及模型名称使用宿主传入的真实目录，不改变图数据。8091 的真实对照和剩余差异见[工作流界面对照](../../docs/guide/workflow-ui-parity.md)。
+
+单出口动作的异常表单使用原 Coze 超时、重试和处理方式控件，通过可选 `node.execution` 回传宿主，支持中断、设定输出和 `error` 分支；Go 执行其实际语义。缺少该字段时保持旧行为。单节点播放按钮位于原标题，仍通过 `onNodeTest` 回调开启宿主的真实测试。已处理异常的运行结果保留错误和尝试次数。
+
+大模型 JSON 输出字段使用原 `OutputTree`，保留复杂 Schema；`outputLayout: 'fields'` 提供顶层字段和 `$model` 元数据，旧输出默认仍为 `structured`。文本支持 `textOutputName`。字段树未完成的编辑按实例保留，返回 `schema_invalid`，宿主必须像 `json_invalid` 一样阻止保存/发布/测试；关闭参数面板不能将旧值当作有效提交。
+
+大图画布节点仅挂载摘要，参数表单在检查面板按需挂载，避免为每张卡片初始化表单引擎。ArcBase 元数据仍通过双向适配保存，配置更新进入该实例原有的 FlowGram 事务历史；节点新增、复制、移动和参数编辑继续支持撤销重做。外部 `value` 替换清理旧历史，正常 `onChange` 回传保留历史。完整结果后台处理完成后，还会核对当前节点和组件状态，离开原结果后不复制或下载旧内容。公共属性及持久图格式保持兼容。
+## 宿主主题颜色
+
+`theme` 控制明暗模式，`themeColors` 可传入宿主的语义颜色：`primary`、`primaryHover`、`primaryActive`、`primaryLight`、`primaryLightHover`、`primaryLightActive`、`background`、`surface`、`text`、`muted`、`border`、`fill`。管理台自动从现有 Semi UI 主题同步这些颜色，节点选中、连线、按钮和参数弹层保持一致；节点类别图标仍保留各自的识别色。独立宿主通过属性提供颜色，设计器不读取全局主题、会话或存储。未传入时保留独立设计器默认配色。

package/THIRD-PARTY-NOTICES.md

@@ -1,57 +1,57 @@
-# Third-party source attribution
-
-## Coze Studio
-
-Repository: https://github.com/coze-dev/coze-studio
-
-Pinned commit: `fefb05ff27be1da939612fbf9faf5db62583b8ae`.
-
-Copyright 2025 coze-dev Authors. Licensed under Apache License 2.0; the complete original license is included at `vendor/coze/LICENSE-APACHE`.
-
-`vendor/coze/UPSTREAM.json` records each original path, SHA256, adapted source file and changes. `vendor/coze/original` retains earlier reference files; `vendor/coze/source` retains the newly copied original components and LESS. `src/coze/source` contains executable copies. Both original and executable hashes are checked. Adapted components preserve attribution in their own headers. No upstream NOTICE file exists at the pinned repository root.
-
-The copy script installs 199 pinned files as executable source or associated styles/types. They include FormCard/Section, NodeHeader and descriptions, CompositeSelect/NodeVariableTree, draggable condition branches and condition parameter rows, operator selection, ValueExpressionInput and literal inputs, HTTP setters, cURL and JSON expanded editors, start/end forms, the complete OutputTree field renderer, VariableTypeSelector, VariableTagList/OverflowTagList, NodeStatusBar, LogWrap and the recursive DataViewer. The start form retains its open-source basic-input branch and nested name/type/required/default/description editing. Private account/project/scope stores, API clients, telemetry and backend execution imports are replaced by explicit per-instance adapters in `src/coze/compat`. This is a modified source subset, not an unchanged Coze application. Host-enabled Eino LLM nodes additionally use the original model-list cards, parameter settings and user-prompt form. Private model, account and premium services are replaced by per-instance host metadata. The copied timeout/retry/error-policy controls and single-node play button call host callbacks; ArcBase implements execution and validation. Scripting and Coze backend behavior are not exposed.
-
-NodeStatusBar adds optional controlled expansion callbacks. ArcBase keeps expanded results in each designer instance so FlowGram renderer replacement during selection or dragging does not reset them; original uncontrolled behavior remains available.
-
-The UI port also includes the node dragging wrapper, node header/title operations,
-floating node card/category panel, grouped centered toolbar, vertical form sections,
-tree variable selector and workflow header. Original component hierarchy and selected
-LESS layouts are retained with scoped CSS and portable callbacks. Coze workflow and
-control SVGs are copied unchanged and checked by SHA256. The source manifest
-distinguishes adapted modules, original reference files and bundled assets.
-The manifest uses `sha256-lf-text-v1`: text hashes normalize CRLF to LF for
-Windows/Linux Git checkouts; all other text bytes and binary assets remain
-covered. The recorded upstream revision and file paths are unchanged.
-
-The right-side form/test shell also ports node-side-sheet, resizable-side-panel
-and test-form-sheet-v2 header/layout sources. Width state and pointer/keyboard
-resizing are instance-local. The canvas registry JPEG icons from
-`docker/volumes/minio/default_icon/workflow_icon` are copied without modification;
-they replace the visually different trace-span SVGs in node cards. Both original
-and bundled assets are checked against the manifest hashes.
-
-This is the ArcBase business-automation subset, not the complete Coze Studio product.
-The grab/grabbing SVG cursors are extracted unchanged from the pinned
-`workflow-document-custom-options.ts`. ArcBase adds a centered hotspot and native
-fallbacks, sharing the same white fill and dark outline between FlowGram and
-draggable cards; the source and generated adapter are checked by the manifest.
-Coze agents, RAG nodes, plugins marketplace, collaboration, conversations, scripts and
-the Coze runtime are not included. ArcBase's existing execution capabilities determine
-the available nodes and operations.
-
-## FlowGram
-
-The npm free-layout editor and background, minimap and free-snap plugins are locked to 1.0.15. Their bundled JavaScript retains upstream copyright/license comments; the npm dependencies include their own license files. Copyright (c) 2025 Bytedance Ltd. and/or its affiliates; MIT License.
-
-The previous Workflow Builder iframe sources remain historical reference files and are excluded from active builds and this package's published file list.
-
-## Coze Design and CodeMirror
-
-The public `@coze-arch/coze-design` package is fixed to `0.0.6-alpha.346d77`, the version used by the pinned source; npm declares ISC. Its original CSS is scoped to `.arc-workflow-designer`, with Tailwind utilities generated from copied source and no global preflight. Node headers, forms, menus, radios and icons use these components.
-
-CodeMirror's `@codemirror/state`, view, commands, autocomplete and JSON packages are MIT dependencies with their original licenses. A React 19 lifecycle adapter replaces the upstream React 18-only `@coze-editor/editor/react` renderer. Coze's text editor theme/options and expanded editor UI are copied; ArcBase supplies available upstream variables and never executes imported cURL commands. Lodash ES, Zustand, ahooks and BigNumber.js retain their dependency licenses.
-
-React DnD, its HTML5 backend, dnd-core and nanoid are MIT dependencies with their original licenses. Each condition editor creates a drag manager scoped to its own panel root, preserving independent designers and avoiding the upstream application's global drag provider.
-
-HTTP credentials remain encrypted ArcBase credential references, and protected headers are managed by the host. File/binary bodies and streaming text output are not shown because the current Go node does not support them. These are explicit capability differences; source provenance and engineering tests alone do not establish pixel-for-pixel parity with every Coze release.
+# Third-party source attribution
+
+## Coze Studio
+
+Repository: https://github.com/coze-dev/coze-studio
+
+Pinned commit: `fefb05ff27be1da939612fbf9faf5db62583b8ae`.
+
+Copyright 2025 coze-dev Authors. Licensed under Apache License 2.0; the complete original license is included at `vendor/coze/LICENSE-APACHE`.
+
+`vendor/coze/UPSTREAM.json` records each original path, SHA256, adapted source file and changes. `vendor/coze/original` retains earlier reference files; `vendor/coze/source` retains the newly copied original components and LESS. `src/coze/source` contains executable copies. Both original and executable hashes are checked. Adapted components preserve attribution in their own headers. No upstream NOTICE file exists at the pinned repository root.
+
+The copy script installs 199 pinned files as executable source or associated styles/types. They include FormCard/Section, NodeHeader and descriptions, CompositeSelect/NodeVariableTree, draggable condition branches and condition parameter rows, operator selection, ValueExpressionInput and literal inputs, HTTP setters, cURL and JSON expanded editors, start/end forms, the complete OutputTree field renderer, VariableTypeSelector, VariableTagList/OverflowTagList, NodeStatusBar, LogWrap and the recursive DataViewer. The start form retains its open-source basic-input branch and nested name/type/required/default/description editing. Private account/project/scope stores, API clients, telemetry and backend execution imports are replaced by explicit per-instance adapters in `src/coze/compat`. This is a modified source subset, not an unchanged Coze application. Host-enabled Eino LLM nodes additionally use the original model-list cards, parameter settings and user-prompt form. Private model, account and premium services are replaced by per-instance host metadata. The copied timeout/retry/error-policy controls and single-node play button call host callbacks; ArcBase implements execution and validation. Scripting and Coze backend behavior are not exposed.
+
+NodeStatusBar adds optional controlled expansion callbacks. ArcBase keeps expanded results in each designer instance so FlowGram renderer replacement during selection or dragging does not reset them; original uncontrolled behavior remains available.
+
+The UI port also includes the node dragging wrapper, node header/title operations,
+floating node card/category panel, grouped centered toolbar, vertical form sections,
+tree variable selector and workflow header. Original component hierarchy and selected
+LESS layouts are retained with scoped CSS and portable callbacks. Coze workflow and
+control SVGs are copied unchanged and checked by SHA256. The source manifest
+distinguishes adapted modules, original reference files and bundled assets.
+The manifest uses `sha256-lf-text-v1`: text hashes normalize CRLF to LF for
+Windows/Linux Git checkouts; all other text bytes and binary assets remain
+covered. The recorded upstream revision and file paths are unchanged.
+
+The right-side form/test shell also ports node-side-sheet, resizable-side-panel
+and test-form-sheet-v2 header/layout sources. Width state and pointer/keyboard
+resizing are instance-local. The canvas registry JPEG icons from
+`docker/volumes/minio/default_icon/workflow_icon` are copied without modification;
+they replace the visually different trace-span SVGs in node cards. Both original
+and bundled assets are checked against the manifest hashes.
+
+This is the ArcBase business-automation subset, not the complete Coze Studio product.
+The grab/grabbing SVG cursors are extracted unchanged from the pinned
+`workflow-document-custom-options.ts`. ArcBase adds a centered hotspot and native
+fallbacks, sharing the same white fill and dark outline between FlowGram and
+draggable cards; the source and generated adapter are checked by the manifest.
+Coze agents, RAG nodes, plugins marketplace, collaboration, conversations, scripts and
+the Coze runtime are not included. ArcBase's existing execution capabilities determine
+the available nodes and operations.
+
+## FlowGram
+
+The npm free-layout editor and background, minimap and free-snap plugins are locked to 1.0.15. Their bundled JavaScript retains upstream copyright/license comments; the npm dependencies include their own license files. Copyright (c) 2025 Bytedance Ltd. and/or its affiliates; MIT License.
+
+The previous Workflow Builder iframe sources remain historical reference files and are excluded from active builds and this package's published file list.
+
+## Coze Design and CodeMirror
+
+The public `@coze-arch/coze-design` package is fixed to `0.0.6-alpha.346d77`, the version used by the pinned source; npm declares ISC. Its original CSS is scoped to `.arc-workflow-designer`, with Tailwind utilities generated from copied source and no global preflight. Node headers, forms, menus, radios and icons use these components.
+
+CodeMirror's `@codemirror/state`, view, commands, autocomplete and JSON packages are MIT dependencies with their original licenses. A React 19 lifecycle adapter replaces the upstream React 18-only `@coze-editor/editor/react` renderer. Coze's text editor theme/options and expanded editor UI are copied; ArcBase supplies available upstream variables and never executes imported cURL commands. Lodash ES, Zustand, ahooks and BigNumber.js retain their dependency licenses.
+
+React DnD, its HTML5 backend, dnd-core and nanoid are MIT dependencies with their original licenses. Each condition editor creates a drag manager scoped to its own panel root, preserving independent designers and avoiding the upstream application's global drag provider.
+
+HTTP credentials remain encrypted ArcBase credential references, and protected headers are managed by the host. File/binary bodies and streaming text output are not shown because the current Go node does not support them. These are explicit capability differences; source provenance and engineering tests alone do not establish pixel-for-pixel parity with every Coze release.

package/dist/{ai-markdown-esl-I5ck.js → ai-markdown--SqEglSn.js}

@@ -1,7 +1,6 @@
 import { jsx as e } from "react/jsx-runtime";
-//#region src/coze/compat/ai-markdown.tsx
+// src/coze/compat/ai-markdown.tsx
 function t({ markDown: t }) {
 	return /* @__PURE__ */ e("span", { children: t });
 }
-//#endregion
 export { t as MdBoxLazy };