第 4 章
实战案例
四个真实场景，需求原文可以直接复制。把路径改成你自己的，就能跑。每个案例都标了「这个需求用到了第 3 章的哪些技巧」。
怎么用这一章
准备一个干净的文件夹
新建文件夹，把要处理的文件复制进去（不是剪切）。原始数据永远留在原处。
在 Trae 里打开这个文件夹
「打开文件夹」指向它，确认左侧文件列表能看到你的文件。
切到 Builder 模式，粘贴需求
把下面的需求原文复制进对话框，先把里面的路径改成你自己的，再发送。
先空跑，确认后再执行
案例里都写了「先打印、不要真的改」。等它把对照表列出来，你确认无误再让它动手。
!
下面的路径都是示例（如 D:\工作\xx）。直接复制的话，务必先改成你电脑上真实存在的路径，否则它第一句就会告诉你「找不到文件夹」。
案例 1：批量重命名文件
把 200 个乱名文件整理成统一格式
- 场景
- 从系统里导出的附件、从群里收来的资料，文件名里混着「最终版」「副本」「(1)」，前后还有空格。手动改 200 个不现实。
- 你需要准备
- 一个文件夹，把所有待改名的文件放进去。建议先复制一份做备份。
把这段发给 Agent
我有一个文件夹 D:\工作\2026项目资料，里面大约 200 个文件，命名比较乱。 请帮我写一个 Python 脚本，做三件事： 1. 去掉文件名开头和结尾的空格； 2. 删掉文件名里的「最终版」「修改版」「副本」「(1)」这类字样； 3. 在文件名最前面加上「2026_」。 规则： - 先只打印出「原名 → 新名」的对照表，不要真的改； - 我确认之后，再执行真正的重命名； - 如果改名后出现重名，自动在后面加 _2、_3，绝对不要覆盖已有文件； - 不要改动文件夹里的子文件夹。 最后请告诉我：一共多少文件、改了多少个、跳过多少个以及原因。
- 预期结果
- 终端先输出一张对照表；你回复「可以」，它才会真正改。跑完会给一个统计。
- 这个需求用到的技巧
-
- 给了具体路径和文件数量（输入要素）
- 用编号列出规则，一条一个动作
- 空跑 + 确认，把风险降到最低
- 提前规定重名怎么办（边界情况）
- 明确了不碰子文件夹（负面约束）
- 常见坑
- 如果文件名里有中文括号
（）和英文括号()混用，第一版可能只处理了一种。发现漏了就补一句：「英文和中文括号都要处理」。
案例 2：合并多个 Excel
12 个月的分表合成一张年度总表
- 场景
- 每月一张表，列的顺序被不同同事改过，有的多一列备注。手工复制粘贴容易错位，而且三个月后就忘了自己怎么拼的。
- 你需要准备
- 一个文件夹放 12 个
.xlsx；每张表的第一行都是表头；提前看一眼列名是否基本一致。
把这段发给 Agent
D:\工作\月报 这个文件夹里有 12 个 Excel 文件，文件名是 1月.xlsx 到 12月.xlsx。 每个文件第一行是表头，第一张工作表就是数据，表头内容基本一样，但列的顺序可能不同。 请写一个 Python 脚本，合并成一个「全年汇总.xlsx」，放在同一个文件夹里。 规则： - 一定要按表头名称对齐列，不要按列的位置对齐； - 增加一列「来源文件」，记录这一行来自哪个文件； - 跳过完全空白的行； - 只读取每个文件的第一张工作表； - 输出文件如果已存在，先备份成 全年汇总_旧.xlsx，不要直接覆盖。 跑完请告诉我：总行数是多少、每个文件各贡献多少行、有没有哪些文件的表头对不上（列出具体列名）。
- 预期结果
- 生成一个总表，列名统一，多出一列「来源文件」。终端会给出行数统计和表头差异提示。
- 这个需求用到的技巧
-
- 说清对齐方式——这是最容易出错、也最难发现的地方
- 限定只读第一张工作表，避免读到隐藏的辅助表
- 验收标准明确：总行数 + 每文件行数 + 表头差异
- 要求先备份再覆盖，防止重复运行把结果洗掉
- 常见坑
- 如果某个文件第 1 行是标题（如「XX公司2026年1月销售报表」），表头在第 2 行，必须提前说明：「表头在第 2 行」。否则整列会错位。
案例 3：从 Word 里批量提取信息
50 份合同的要素汇总成一张表
- 场景
- 合同编号、甲方、乙方、签订日期、金额分散在几十份 Word 的不同位置。逐份打开抄写，一下午就没了，还容易抄错。
- 你需要准备
- 一个文件夹放
.docx文件（注意：老格式.doc需要先另存为.docx）。先抽两份看看字段的写法是否统一。
把这段发给 Agent
D:\工作\合同 文件夹里有大约 50 份 Word 文档（.docx）。 请写一个脚本，从每份文档中提取以下字段，汇总成一个 Excel「合同清单.xlsx」： 合同编号、甲方名称、乙方名称、签订日期、合同金额。 规则： - 一行一份合同，第一列加上来源文件名，方便我核对； - 提取时按「关键词 + 后面的内容」来匹配，比如「合同编号：」后面那一段； - 如果某个字段在文档里找不到，就留空，并在「备注」列写「未找到：字段名」； - 日期统一成 2026-01-05 这种格式； - 金额只保留数字，不要「元」「¥」这类符号； - 不要修改任何原始 Word 文件。 先拿 3 份文档试跑，把提取结果打印给我看，我确认格式没问题后再处理全部。
- 预期结果
- 先看到 3 份的提取结果；确认后生成完整 Excel，缺字段的会在备注列标出。
- 这个需求用到的技巧
-
- 先给样例：抽取 3 份试跑，是最有效的质量检查
- 说明匹配规则（关键词后面那段），比「提取合同编号」具体得多
- 规定找不到时怎么办，而不是让它随便猜一个
- 统一格式标准（日期、金额），省掉后续手动清洗
- 常见坑
- 扫描件（图片型 PDF / Word）里没有可提取的文字，脚本读出来是空的。这不是脚本的问题——需要先做 OCR。先确认你的文档是「文字版」而不是「拍照版」。
案例 4：批量压缩图片
300 张商品图统一尺寸和体积
- 场景
- 上传平台限制单张不超过 500KB、长边 1200 像素。原图每张好几 MB，用在线工具一张张传太慢。
- 你需要准备
- 原图单独放一个文件夹，输出到另一个新文件夹，不要原地覆盖。
把这段发给 Agent
D:\素材\商品图 里有 300 张 jpg 图片，尺寸都很大。 请写一个脚本批量处理： 1. 把长边缩放到 1200 像素，另一边按比例缩放，不要拉伸变形； 2. 保存质量 85，尽量让单张控制在 500KB 以内； 3. 输出到 D:\素材\商品图_压缩（没有就自动新建），文件名保持不变； 4. 原图一张都不要动。 规则： - 如果某张图压缩后还是超过 500KB，自动降低质量再试，最多试 3 次，仍然超标就在结果里标出来； - 遇到不是 jpg 的文件，跳过并记录。 跑完告诉我：处理了多少张、跳过多少张、压缩前总大小和压缩后总大小。
- 预期结果
- 新文件夹里是处理后的图，原文件夹完全没变。终端给出体积对比和超标清单。
- 这个需求用到的技巧
-
- 把主观的「压缩一下」变成可量化的指标（长边 1200、质量 85、500KB）
- 输入输出分开放，天然具备回滚能力
- 为「试了还是不行」预设处理方式，避免脚本卡死或死循环
- 要求给出前后体积对比，验收有依据
- 常见坑
- 第一次会自动安装
Pillow库，需要你在终端确认。如果公司电脑装不了，把报错原文发给它，它会给出替代方案。
把脚本变成「双击即用」
脚本跑通后，让它再生成一个启动文件，以后就不用打开 Trae 了：
生成双击运行的启动文件
请在这个文件夹里生成一个「一键运行.bat」，双击就能执行刚才的脚本。 要求： - 用相对路径，指向脚本自己所在的目录，这样整个文件夹复制到别的电脑也能用； - 运行结束后暂停，窗口不要立刻关闭，让我能看到结果； - 如果运行出错，把错误信息留在窗口里，不要一闪而过。
还想更省事，可以再补一句，让它帮你设置定时：
设置每天自动运行
我想让这个脚本每天早上 9 点自动跑一次。 请告诉我 Windows 上最简单的设置方法（比如任务计划程序）， 一步一步说，每一步点哪里都要写清楚，假设我没用过这个功能。
下一步能做什么
跑通一个之后，你会发现套路是通用的。可以继续尝试：
PDF 拆分与合并
按页码拆成单页、把多个 PDF 合成一个、批量加水印。
表格清洗
去重、拆分姓名列、统一手机号格式、空值填充。
文件比对
两个版本的 Excel 找出差异行，输出变更清单。
邮件批量发送
按表格里的收件人逐条发送，附上对应附件。
自动生成周报
从数据表算好指标，套进固定模板输出 Word。
文件名与内容检索
在上千份文档里找出含某个关键词的那些。
i
一个通用公式：凡是「打开 → 复制 → 粘贴 → 保存」重复超过 20 次的工作，都值得花 10 分钟让 Agent 写个脚本。