WorkBuddy 和 ONLYOFFICE 的自定义 AI 工具，我各跑了一轮，只有一个能落地

ONLYOFFICE 那套自定义 AI 工具，给有开发资源、要改编辑器底层行为的人用；WorkBuddy 给手上有一堆活要干完的人用。同一件事我在两边各走了一遍，一边走到第 4 步就停了，一边十来分钟出了结果。

今天五点起床练腿，练废了。练完灌了 25 克乳清，早餐称了 180 克鸡胸，坐那儿刷到 ONLYOFFICE 放出来的自定义 AI 工具测试版文档。看完第一反应是这流程我熟。我上个月给秋季训练营做招募海报的时候，也动过自己写个插件的念头。

一、ONLYOFFICE 这条路，我走到第 4 步就停了

先把它的流程摆出来。文档写得挺清楚，把 onlyoffice.github.io 仓库克隆到本地，在 sdkjs-plugins/content/ai/.dev/helpers 里写你的函数，按编辑器类型分别丢进 cell/、slide/、word/ 文件夹，然后改 config.json 里的插件版本号避免缓存，跑 helpers.py，把 ai 文件夹里的文件压缩、重命名成 ai.plugin，放回 deploy，push，构建 GitHub Pages，最后拿一个带 /store/index.html 的自定义商店链接，去插件管理器里装。

十来步。中途还有一步是把版本号从 3.0.3 改成 3.0.4 这种。

它的函数注册设计我觉得是对的。RegisteredFunction 对象里要写 name、description、parameters、examples，examples 还得给出「AI 该怎么调用这个函数」的正确示例，比如把 prompt 和 arguments 一起写进去。这套东西就是给模型看的说明书，让模型自己判断什么时候该调哪个函数。思路没问题，写清楚了模型就少犯傻。

函数注册在代理环境里声明元数据，函数执行才去实现核心逻辑，包括向 AI 模型发请求、再用 Office API 改文档内容。

问题是，我想干的事只是让 AI 在选中的段落旁边加条批注。为了这一件事，我得先建仓库、维护一套插件、每改一次重新打包、推 Pages、再重新装。这不像用工具，像接了个小项目。

我走到第 4 步，改版本号那一步，停下来了。算了一下投入产出，这插件我大概一个月改两次，每次发布流程十几分钟，维护成本比它省下的时间还高。

二、WorkBuddy 这边，同一件事我跑了三遍

我用 WorkBuddy 一个多月了，最早是拿它整理半年的训练记录。这次换成学员月度复盘，素材是三个文件夹，训练记录表、课消表、餐盘备注。目标是一页 Word 周报加一张课消汇总表。

我的做法分三步。

第一步，把文件夹结构摆平。三个子目录，名字写清楚，别让模型猜。

第二步，需求写全。读者是谁、素材在哪、结构长什么样、哪些话不许说。这一步我踩过坑。有次我只写了「每周五出一页周报」，它开头就来一句「本周进展顺利」，跟学员没热身直接上大重量一样，完全没落点。后来我把禁区写进去，不许写「进展顺利」「效果显著」这种没有数字支撑的话，必须点名具体学员、具体动作、具体次数。

第三步，一次只让它干一件事。这是我用了一个多月才学乖的。一开始我总想一口气把所有需求说清楚，结果出来的是四不像。现在我把它拆开，先出课消汇总表，确认数字对，再让它基于这张表写周报正文。顺序反了都不行。

效果我这边测下来，以前手动合并三个表加写周报要半个下午，现在整套跑完大约十二分钟。中间还得人工过一遍，主要是餐盘备注那栏，学员自己写的字有时候不统一，「鸡胸 200g」和「鸡胸 200 克」它偶尔会当成两个东西。这也印证了我上个月写的那篇，表格模型再强，也救不了表里那几行脏数据。

另外我沿用了一个习惯，默认全驳回，再逐条过。这套逻辑是我从学术校对工具那边搬过来的。它给的建议我不点「接受」，全部先驳，然后一条条看哪条该留。听着绕，但比事后发现课次或者交期搞错要划算得多。

三、到底谁该用哪个

要在文档里注入自定义评论、脚注，或者要改编辑器的底层行为，团队里有能长期维护插件的人，那 ONLYOFFICE 这套值得投入，它的可编程深度确实比一般办公套件高。只是要把手上的表格、文档、邮件、PPT 串成一条能跑的流水线，那就别碰源码，WorkBuddy 干这个。

ONLYOFFICE 的自定义 AI 工具管的是插件怎么写，WorkBuddy 管的是活怎么干完。 这两件事看着挨着，其实差得很远。前者要求你先把需求翻译成代码，后者要求你先把需求翻译成人话。

我还想说一句可能有人不爱听的。这类自定义工具，宣传价值大于实际价值。文档里那套流程，对开发者是十分钟的事，对普通办公用户是一道墙。一个功能如果只有少数人能用起来，那它更像个技术展示。 当然这是我自己的判断，也可能我理解偏了。

如果你现在正被「要不要自己写个 AI 插件」这个念头勾着，我建议先缓一缓。把你手上最烦的那件事拆成三步，素材放哪、要出什么、哪些话不能说，丢给 WorkBuddy 跑一遍。跑通了，你大概就不想写插件了。跑不通，再去折腾源码也不迟，那时候你至少知道自己到底要什么。