在FastGPT的技能脚本运行流程中，多次对话重复执行环境初始化脚本会带来严重的延迟问题。例如重复执行依赖包安装操作，会显著拉长每次对话的启动耗时。为解决该问题，系统为技能脚本设计了智能去重机制，该机制可自动识别已执行过的初始化脚本，避免重复运行，有效提升对话的启动速度与整体响应效率。
智能去重核心运行规则
智能去重机制基于技能版本ID实现核心逻辑，具体包含三项明确规则：
- 版本ID去重：同一个技能版本的
versionId对应的代码和脚本内容在发布后不可变更，系统会自动记录当前虚拟机中已成功运行过的技能versionId。 - 跳过执行逻辑：当同一虚拟机实例在后续对话中被复用时，只要对应的
versionId已经成功执行过，系统将直接跳过该脚本的运行，实现秒级热启动，大幅缩短对话启动的耗时，提升交互效率。 - 新版本触发机制：只要技能发布了新版本，无论是在旧的对话窗口还是新的对话窗口，在下一次对话触发时，系统都将在重新部署该技能后自动运行该版本的初始化脚本，确保新版本的配置与脚本内容能够及时生效。
去重状态存储与查看
智能去重机制的运行状态记录在虚拟机内的指定文件中，文件路径为~/.fastgpt/agent-skill-entrypoints/state.json。该文件会自动保存当前虚拟机中已成功运行的技能versionId记录，无需手动配置或干预默认的去重逻辑。当需要验证某技能版本是否已在当前虚拟机中完成初始化执行时，可直接访问该文件查看对应记录，无需额外操作即可获取所需的状态信息。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 教程 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。