用途:当需要弃用(下线、不再推荐)某个 FastGPT 工作流节点时,按标准化流程完成改动,保证既有工作流仍可加载运行,同时新工作流模板面板不再展示该节点。核心理念是“弃用≠删除”,只断新增入口,不断运行通路。
主要能力:给出需改动位置清单与操作步骤,覆盖类型枚举保留、模板定义与 Dispatcher 移入 abandoned 目录、constants 更新、节点级徽章设置、UI/Hook 引用检查与验证。
使用方式(要点):先全局搜索 FlowNodeTypeEnum.<enumKey> 等引用确认影响面;将模板(packages/global/core/workflow/template/system/<dir>/)与 Dispatcher(packages/service/core/workflow/dispatch/<dir>/)用 git mv 移入各自 abandoned/ 目录并修正相对 import;在 template/constants.ts 中从 systemNodes 移除但保留在 moduleTemplatesFlat;在 dispatch/constants.ts 中把条目移到 callbackMap 末尾并加 /** @deprecated */;模板加 status: PluginStatusEnum.SoonOffline 显示“即将下线”徽章。最后运行 pnpm lint 和按改动局部跑测试。
限制与反模式:不可删除 FlowNodeTypeEnum 枚举、moduleTemplatesFlat 条目、callbackMap 键、i18n 文案或 React nodeTypes 映射,否则旧工作流会加载失败或运行报错;共享子节点未确认独占前不要一并弃用;整节点弃用不要用字段级 deprecated: true,也不要用死字段 abandon。仓库提供 runApp 弃用案例可参考 git log --diff-filter=R 查找迁移 commit。