骡子快跑支持三种批量改名方式：一、csv模板导入覆盖重命名；二、agent脚本调用rename_batch api实现条件化改名；三、浏览器插件辅助可视化批量重命名。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在骡子快跑中管理大量文件或任务节点，需对多个条目统一更新名称以匹配业务命名规范，则可通过平台提供的结构化操作能力实现高效批量改名。以下是实现此目标的步骤：
一、通过CSV模板导入覆盖式重命名
该方法适用于已将目标文件/节点ID与新名称整理为表格的用户，系统支持按唯一标识字段（如task_id、node_hash）精准匹配并批量更新名称字段，不触发新增或删除操作。
1、登录骡子快跑控制台，在左侧导航栏点击【文件管理】→【批量操作】子页签。
2、点击「下载重命名模板」，获取标准CSV模板文件，其中包含必填列：id（原始唯一标识）、new_name（目标新名称）。
3、在Excel中填写待改名条目的id值（可在单个文件详情页URL末尾或「属性」面板中复制）及对应new_name，保存为UTF-8编码CSV格式。
4、回到页面点击「上传重命名清单」，拖入已编辑CSV文件，系统自动校验id有效性与重复项。
5、确认无误后点击「执行覆盖重命名」，状态栏显示“成功更新X项”，失败项将生成错误报告供下载排查。
二、使用Agent脚本调用rename_batch API接口
该方法适用于具备Python基础的用户，可编写轻量脚本实现条件化批量改名，例如按标签筛选、按创建时间范围匹配、或嵌入正则替换逻辑，全部操作在用户专属虚拟机内隔离执行。
1、进入【开发者中心】→【API凭证管理】，点击「生成新密钥」，复制Token并记录有效期。
2、在Python Agent中编写脚本：导入requests模块，构造POST请求至/v1/files/rename_batch端点。
3、请求体JSON中传入filter参数（如{"tags": ["invoice", "2026Q1"], "created_after": "2026-03-01"}）与rename_rule（如{"prefix": "ARCHIVE_", "suffix": "_v2"}）。
4、在请求头中添加Authorization: Bearer 您的API Token 与 X-MuleRun-VM-ID: 您的虚拟机ID。
5、运行脚本，响应返回status: "queued"及task_id，可通过/v1/tasks/status/{task_id}轮询执行结果。
三、启用浏览器插件辅助可视化批量重命名
该方法专为习惯Web界面操作、且需实时预览改名效果的用户设计，插件直接注入DOM，提供勾选列表+批量输入框交互，所有操作经前端加密签名后提交，不经过中间代理节点。
1、在Chrome浏览器中访问骡子快跑官网扩展中心，安装MuleRun Batch Renamer插件（版本号≥2.3.1）。
2、打开【文件管理】列表页，点击右上角插件图标，插件自动扫描当前页可见文件行并加载复选框。
3、勾选需改名的条目，点击插件面板中的「批量编辑名称」按钮，弹出浮动输入框。
4、在输入框中输入基础名称，勾选「自动追加序号」或「保留原后缀」选项，点击「应用到所选项」。
5、插件即时高亮显示每行即将变更的名称（灰色删除线+绿色新名），确认后触发原子化提交，任一失败则整批回滚。
