tofai多文件整合可通过三种方式实现：一、用官方CLI工具自动打包合并；二、手动归并模块文件并配置加载权重；三、用Python脚本自动化合并.toft模板文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在处理tofai项目，发现多个分散的文件需要统一整合为一个可执行或可部署的整体，则可能是由于项目结构未标准化、模块未归并或构建流程缺失所致。以下是完成tofai多文件合并与项目整合的具体操作步骤：
一、使用tofai官方CLI工具执行项目打包合并
tofai官方提供的命令行工具内置了项目归并与资产聚合功能，适用于标准tofai工程结构（含config.yaml、src/、assets/等目录），能自动识别依赖关系并生成单一输出包。
1、确保系统已安装tofai-cli，运行tofai --version验证版本不低于v2.4.0。
2、进入tofai项目根目录，确认存在tofai.project.json配置文件。
3、执行命令：tofai build --merge-all --output dist/merged.tofai，该命令将递归扫描所有子模块、合并资源路径、去重同名配置项，并注入统一入口声明。
4、检查dist/merged.tofai文件完整性，使用tofai validate dist/merged.tofai校验签名与结构合法性。
二、手动归并tofai模块文件至单体包
当项目不含标准配置或需精细控制合并逻辑时，可采用手动方式将各模块的tofai格式文件（.tfi、.tfc、.tfd）按协议规范逐层整合，确保元数据一致性与加载顺序正确性。
1、新建空目录tofai-merged-root作为目标整合根路径。
2、将主模块的manifest.tfi复制至该目录，并重命名为root.manifest.tfi。
3、依次进入各待合并子模块目录，提取其logic.tfc与data.tfd文件，重命名前缀为模块标识（如auth_logic.tfc、user_data.tfd），全部放入tofai-merged-root。
4、编辑root.manifest.tfi，在dependencies字段中显式声明所有新增文件的相对路径及加载权重值，权重值必须为正整数且互不重复，决定运行时加载优先级。
5、使用tofai pack tofai-merged-root/ -o final.tofai生成最终单体包。
三、通过Python脚本自动化合并多个.toft文件
针对以.toft（tofai template）为后缀的模板类文件，可借助轻量脚本实现内容拼接、变量去重与区块标记对齐，适用于CI/CD流水线中的预处理环节。
1、创建merge_toft.py脚本，导入标准库os与re，不依赖第三方包。
2、定义函数read_toft(filepath)，读取文件并剔除注释行（以#开头）及空白行。
3、遍历指定目录下所有.toft文件，调用该函数获取纯内容列表，并过滤掉重复的%%SECTION标记块（保留首次出现者）。
4、将所有非重复内容按原始文件名ASCII顺序拼接，头部插入统一声明%%TOFAI_TEMPLATE_V1。
5、写入新文件combined.toft，确保末尾保留单个换行符，否则tofai runtime可能解析失败。
