![00-cover.png](https://developer.qcloudimg.com/http-save/yehe-12564146/95e668758d9d2eb2d33bb5f0ee6007b6.png)

先说清楚我讨厌什么。

我讨厌那种"你把材料给它，它给你吐一段漂亮话"的 AI。说得头头是道，你把文件打开一看——图没了，字体被换成了等线，编号对不上，最后还是得自己上手重做。

所以我对工具只有一条标准：**它得交得出东西。** 一个能打开、能提交、能过审的实体文件，而不是一段"我已完成"的汇报。

下面这篇是我用 WorkBuddy 做完一件真实工作的全过程。材料是我手上真实有的，步骤是我实际走的，产出我现在还能打开。我希望它能回答一个问题：**同一个 AI，为什么有人用它是聊天，有人用它是工程队。**

---

## 一、事情是这样的

时间点很具体：学校要交一份综合测评的电子佐证材料册，第二天要用。

我手上有什么？
![image.png](https://developer.qcloudimg.com/http-save/yehe-12564146/bf40ef22dcb345fe6b3844c78e00333b.png)
- **一张张散着的证书照片**——奖状、证书、评比结果，拍的时候随手拍的，有斜的、有留白巨大的、有反光的；
- **几份扫描件 PDF**——成绩单、名单、检查表，几十页那种；
- **一份别人的同类材料册**，学院发下来当版式参考的 `.docx`；
- **一份算分表 `.xlsx`**，分值口径全在里面。

按传统做法，这事是：一张张拖进 Word、调大小、对齐、加文字、编号、算分、导出、再检查一遍有没有漏。看起来不难，但它有个特别恶心的性质——**它能把你的一整个晚上吞掉，而且做完了你根本不敢保证自己没漏。**

我不想干。不是因为它难，是因为它不产生任何价值，还特别容易出错。

于是我把这活整个丢给了 WorkBuddy。

---

## 二、四步走，一步都不含糊

![01-workflow.png](https://developer.qcloudimg.com/http-save/yehe-12564146/6fbb85b1c85ec493a06df1ae98eb59a8.png)

我给它定的是"每张证书一条"的最终形态：分类标题 → 每条「序号 + 项目名 + 分值」→ 紧跟着这张证书的图 → 最后黑体合计。这规矩是硬的，**绝不允许把十几项合并成一句"院级称号共 N 项"**——学校不认，交上去就是被打回。
![image.png](https://developer.qcloudimg.com/http-save/yehe-12564146/c7a8bdc979aa7532b75f9bc27019bc4f.png)
![image.png](https://developer.qcloudimg.com/http-save/yehe-12564146/d05e7b3198ba7a9e3e48429f63d11cc0.png)
然后我让它分四步走。

### 第 1 步：先把样板"量"出来，不靠眼睛猜

很多人做这种活的第一步是打开样板文档看一眼——"哦，小四号，宋体，大概这么大"。

**我不允许它这么干，也不允许自己这么干。**

它做的事是解包样板的 `.docx`，直接读 `word/document.xml`，把每个段落真实的字号、对齐方式、图片的实际尺寸（从 `wp:extent` 的 EMU 换算成厘米）全部打印出来。包括页边距的 `sectPr`，一个数字都不放过。

为什么要这么较劲？因为**"看起来差不多"是这类活最大的敌人**。字号差半号、图宽超版心 3 毫米，你肉眼看不出来，但打印出来、或者对方打开一看，就是"这人不认真"。真值从机器的数据里拿，不从眼睛拿。

这里还顺手避开一个隐蔽的坑：`<w:t[^>]*>` 这种正则会把 `<w:tabs>` 一起匹配进来，必须写成 `<w:t(?: [^>]*)?>`。细节，但细节就是要命的地方。

### 第 2 步：图的两件事——裁白边，还有"只裁那一行"

证书照片的第一件事是裁白边。A4 扫描件周围一圈灰白，直接放进文档里图会小得看不清内容。

做法是拿图像和纯白做差分，把超过阈值的区域取包围盒，一裁了事。听着简单，效果是立竿见影的——**同样的版面宽度，证书内容能大一整圈。**

第二件事更麻烦：**有些证明材料是"名单里的一行"**，比如评比结果的公示名单，一张纸上几十个名字，我只需要我那一行。

它不是截图，是拿 PDF 去查：用 `search_for(姓名)` 定位到命中文本的坐标，然后把**表头行 + 命中行**裁成一条窄条。

这里有个真实翻车点，值得单独说：**页眉区只能取页面顶部的那几行。** 我第一次想的是"把命中行上方的所有行都带上"，听起来很合理对吧？结果那一页有二十多行数据，全被带进来了，一条窄条变成一整页。

还有更阴的一层：如果命中的那一行恰好落在名单的第一页，前面没有表头，那就得**从第 1 页把表头取出来，再和这一行的窄条垂直拼接**。程序不会告诉你"你拼错了"，它只会安静地给你一张废图。

### 第 3 步：装订——两列表格，防跨页断

排版部分用的是 python-docx。核心就一句：**两列 = 无边框表格 + 插图。**

- 每行的 `trPr` 里塞一个 `w:cantSplit`，防止一条"文字 + 图"被翻页劈成两半；
- 条目段落设置 `keep_with_next`，让标题和内容永远在一起；
- 汇总表前面强制分页，否则表格会被拆成两页——这在提交件里是硬伤；
- 中文字体要"加固"：遍历样式里所有 `w:rFonts`，把 `*Theme` 那类主题属性删掉、写死 eastAsia 字体，否则 Word 会拿主题字体把宋体默默换掉。

还有一个必须提的细节：**含公式（`m:oMath`）的 run 要跳过字体覆盖**，不然在某些渲染器里内联公式会变成空白。

### 第 4 步：验收——"生成成功"这四个字，我一个都不信

![02-verify.png](https://developer.qcloudimg.com/http-save/yehe-12564146/706ee8f7ea8370f73fe1c9476cbfbe8d.png)

这是整件事里我最想推荐给所有人的部分。

脚本跑完不报错，等于什么？**等于什么都不能证明。** 图丢了是无声的，字体被替换是无声的，分值口径改了也是无声的——docx 照样生成成功，你打开看着还挺正常。

所以验收只认"拿两头的数据对账"。下面是我实际校验脚本的输出结构（具体数值就不放了）：

- **数图像**：正文里 `a:blip` 的引用数量，必须等于转成 PDF 后页面里实际渲染出的图像数量。**这两个数不等，就是图丢了。**
- **查字体名**：读 PDF 里每个文本 span 的字体，必须命中 SimSun / SimHei，**绝不能出现等线（DengXian）**。这一条能挡住所有"主题字体篡改"的暗伤。
- **断言文字**：新加的数值必须命中，被删掉的旧项必须残留 0 次。改了口径却没改干净，就靠这个抓。
- **量宽度**：用 PDF 的图像 bbox 换算实际厘米数（pt ÷ 28.35），确认没有超出 2.5cm 版心。这里有个坑——**别目测渲染出的 PNG 判断超宽**，渲染 dpi 决定页面像素宽，按 595px 去估一定误判。
- **校打包**：zip 先 `testzip()`，再按顶层目录清点条目数。

五项全绿，这份东西我才敢交。

---

## 三、翻车现场：三个"零报错"的坑

![03-pitfall.png](https://developer.qcloudimg.com/http-save/yehe-12564146/fa6d0bd07532b92040ed52dacec3549e.png)

上面说得挺顺，但真实过程不是这样的。下面这三个坑都是我自己撞的，共同点是——**它们全都零报错。**

**坑 1：改文字的时候，顺手"清理了多余的空段落"。**

这条最要命。文档里"标签文字"在第一个段落，"证书图"在紧随其后的独立段落。而**只有图片的段落，它的 text 就是空字符串**。所以任何"把空段落删掉"的清理动作，都会把图所在的段落当垃圾一起删掉。

结果就是：脚本跑得干干净净，一句警告都没有，文档里少了一张图。翻十几页才能发现。

后来的规则很简单粗暴：**改字只做 run 级文本替换，绝不碰段落结构**；改完立刻断言"这个单元格里的图片数量没变"。一句话换一条命。

**坑 2：打包时，只在"重新采样成功"的分支里写文件。**

我当时的逻辑是：图片太大了要压一压，压缩后的数据写进 zip。看起来很合理。

实际上——`if newext:` 这个分支之外的 `writestr()` 根本没执行，**所有非图片文件（PDF、子文档、截图）全部静默消失**。zip 能正常打开，体积还小了，一切"正常"。

规则：**无条件写出每一条**，压缩与否是内容的事，不是写不写的事。打包后 `testzip` + 顶层条目清点，才算完。

**坑 3：拿"跑完没报错"当验收通过。**

这个坑前面说过了，也是它让我彻底改掉了验收习惯：**只认可观测物，不认退出码。**

字体名、图像数、文字命中数、条目数——这四样东西才是证据。

---

## 四、这才是我最想说的：它得越用越强

![04-arch.png](https://developer.qcloudimg.com/http-save/yehe-12564146/5f0dc26bf8c565391d03d11ae5bc54b3.png)

上面那些坑，如果我每次都重新踩一遍，那这工具对我来说就只是个"更快的手"，而不是"更强的大脑"。

我的做法是：**任务闭环后立刻把教训写成规则。**

上面那三条坑、那个"页眉区只能取顶部"的坑、那句"改字不删段落"的军规，现在都在一个跨项目的经验知识库里，按"工具链 / 流程方法 / 失败教训"三类存放，写的时候要求"一条事实一个文件、不超过 30 行、直说怎么做"。

第一次结转出来是 18 条。几天之后是 33 条、52 条、66 条，到 9 月 21 号已经是 69 条。

这里面没有一条是"感悟"，全是能直接执行的东西，比如：

> 验证类任务的提示词要自包含——API 怎么调、遇到异常怎么办、禁止改代码只许报告。

> 能力探针必须测"真正要用的能力"，不能只测相邻语义；"碰巧通过"不等于"判据正确"。

> 台账会腐烂。一次通读 + 逐条复核，我发现 6 条标着"未做"的其实全部已经闭环——拿台账当输入之前，必须按机制而不是按名字去代码里复核。

**这就是复利。** 同一个坑，第二次不该再踩；同一个活，第二次不该再从零开始。

于是很自然地，一堆步骤被固化成了技能：材料册流水线变成一个可复用的能力，下次再来一批证书，直接重跑；数学建模也变成了一条五阶段的流水线（这个下面说）。

---

## 五、进阶玩法：把自己从"干活的人"改成"派单的人"

![05-growth.png](https://developer.qcloudimg.com/http-save/yehe-12564146/714cbce7cfa4ffb0857d9643640365c8.png)

活多了以后，我意识到我的瓶颈不是"我不会做"，而是"我只有一双手、一个上下文窗口"。

所以我改成主从编排：

- **我（第一层）只做三件事**：拆解任务、写清验收清单、拍板合并。**我不下技术结论**——这是我的纪律。
- **编排者（第二层）**：拆解与排序、冻结接口契约、派发子任务、综合校验、汇报结果。
- **执行方（第三层）**：各自开工，**结果写进文件，只回一句摘要加一个文件路径**。

这套东西我踩出来的经验，比技术本身值钱：

**1）契约先冻结，文件不相交才并行。** 两个子任务如果要改同一个文件、或者共用一套视觉语言，那就别并行，先让主线把设计令牌定死再摊发。否则你收获的是一堆互相打架的产物。

**2）执行方半途失败，第一反应是"续跑"，不是"重派"。** 重派等于它的上下文全丢，前面干的活白干。正确动作是把它叫回来，明确告诉它"不要重做已完成部分"。

**3）别用长时间的空等阻塞自己。** 等待期并行做独立的事。而且要分清"常驻服务"和"一次性监控"——后台显示"运行中"不等于它卡住了。

**4）验收的最后一步不是写完验收报告，而是合并回执落地。** 我看过太多"报告写完就算完成"的假闭环。

### 最值钱的一条：任务书要写"性质"，别写你猜的"手段"

![07-taskbook.png](https://developer.qcloudimg.com/http-save/yehe-12564146/2e8523e86556176092d45349cb864bc5.png)

这条我建议所有要给别人派活的人抄走。

我当时要给一次外部调用加"硬超时"，任务书里我写得很具体：

> 把 `if step.timeout > 0` 改成：无论是否为 0，都拼上默认值 600。

执行方回来告诉我：**你这活干了等于没干，还有害。**

因为现状是"未设就不拼"，而上游 CLI 的**内置默认值恰好就是 600**，两者数值完全等价；而按我写的硬改，反而要推翻一条有实测依据的既有断言。

我的目标（让调用有界）是对的，**我写的手段是错的**。

后来我把任务书的写法改成了这样：

> **要守的性质**：任何一次外部调用都必须有**有限**的时长上限，且**绝不下发**表示"禁用超时"的值。**手段不限**：若现有实现已满足该性质，请回报说明并保持现状；若要改动既有断言，先停下回报。

结果：执行方核对代码，回报"该性质已等效实现"，**零改动、零风险**收工，还顺手指出我任务书里另一条前提也是错的。

这就是"派单"真正的收益——**不只是省我的时间，是修正我的认知。**

顺便说一句，当执行方回报"你任务书的前提不成立"时，**那不是它在找借口不干活，那通常是一个真发现。**

---

## 六、同一套方法换个赛道：数学建模

![06-mathmodel.png](https://developer.qcloudimg.com/http-save/yehe-12564146/10094cfd89c6ba383439dcfc170392cf.png)

材料册这套打法（清单化、对账式验收、规则沉淀）不是一次性的。我把它原样搬到了数学建模竞赛上，做成了一条五阶段流水线：

1. **赛题分析与建模设计** → 分析报告；
2. **编程实现与图表生成** → 可复现的代码、结果、数据图；
3. **流程与架构图绘制** → 流程图、架构图源文件；
4. **论文撰写** → 公式、文献、排版一次到位；
5. **验证与验收** → 可复现性、一致性、产物完整性、提交就绪状态。

入口只问几个"会实质影响流程"的问题（排版引擎、竞赛类型、论文语言），其余交给阶段推进。每条流水线还带硬边界：

- 数据图表只由第 2 阶段产出，概念图只由第 3 阶段产出，**不许重复绘制**；
- 第 4 阶段**不得编造任何数值结论**——论文里的每个数字都必须能回溯到结果报告或结果表。

至于排版这块，细节是真讲究：**标题三号黑体、一级标题四号黑体、正文小四宋体、固定行距 20 磅、首行缩进 2 字符、页边距 2.5cm，图题表题五号宋体**；公式必须是可双击编辑的 **OMML 真公式**（而不是"看起来像公式"的纯文本），块级公式还要带编号；参考文献按 **GB/T 7714** 著录，中英文都要，而且必须真实可查。

顺便提醒一个特别阴的坑：用 python-docx 设"固定行距 20 磅"时，`line_spacing = EXACTLY` 会被错误地乘 240，**必须直接写 XML**（`w:line="400" w:lineRule="exact"`）。这种坑，你不栽一次是不会信的。

---

## 七、最后，三条能直接拿走的东西

**第一，让它交东西，别让它表态。**
好的产出是一份能打开的文件、一张对得上数的报表、一个能跑的脚本。判断标准写在验收清单里，不写在"我觉得挺好"里。

**第二，验收只认可观测物。**
退出码、日志里的"成功"字样、你自己扫描的那一眼——都不算证据。数图像张数、查字体名、断言关键文字，这才算。

**第三，把踩的坑变成规则，而不是变成记忆。**
记忆会淡，规则不会。写下来、分类放好、下次开工前扫一眼——你会明显感觉到这东西在跟着你一起长。

我从"一晚上贴几十张证书照片"开始，到"写一份任务书、验收一份产出、合并一次"结束。

工具没有变，变的是我把它当什么用。

**你要是也有一件"不难但就是不想干"的活，别急着硬扛——把它拆开，写成清单，交出去，然后老老实实验收。**

那种感觉，比它帮你写完更爽。

---

**#WorkBuddy**　
**#AI办公**


我讨厌那种"你把材料给它，它给你吐一段漂亮话"的 AI。说得头头是道，你把文件打开一看——图没了，字体被换成了等线，编号对不上，最后还是得自己上手重做。

几十张证书照片进去，一份能提交的材料册出来：我把 WorkBuddy 用成了工程队

开发工具

职业发展

后端

WorkBuddy 

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

腾讯云BI特惠9.9元起！


2026上云采购 | AI焕新·智启新局

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

几十张证书照片进去，一份能提交的材料册出来：我把 WorkBuddy 用成了工程队-腾讯云开发者社区-腾讯云

几十张证书照片进去，一份能提交的材料册出来：我把 WorkBuddy 用成了工程队

几十张证书照片进去，一份能提交的材料册出来：我把 WorkBuddy 用成了工程队

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐