1. 为什么我要认真写这篇 WorkBuddy 实战指南第一次听说 WorkBuddy 是在一个技术群里有人甩了张截图说腾讯出了个 AI 工作台能把日常那些重复性的活儿全接过去。当时我的反应跟大多数人一样又一个套壳产品吧直到我自己装了一遍、配了一遍、踩了一圈坑之后才发现这东西跟市面上那些对话式 AI 助手完全不是一个物种。WorkBuddy 的核心定位是AI 工作台不是聊天机器人。它通过Skill技能机制把 AI 的能力拆成可组合、可复用、可定制的模块再用models.json做模型路由配置最终让 AI 真正下地干活——读写文件、执行脚本、调用接口、处理数据而不是只会在对话框里给你写小作文。这套逻辑跟 AI Agent 的思路一脉相承但 WorkBuddy 把它做成了开箱即用的桌面工具门槛比从零搭一个 Agent 低得多。这篇文章适合三类人看第一类是完全没接触过 WorkBuddy、想搞清楚它到底能干什么的新手第二类是装完了但不知道怎么配 Skill、怎么改缓存目录、怎么让它真正干活的半吊子用户第三类是用过 CodeBuddy 或者其他 AI 编程工具、想对比一下 WorkBuddy 差异的老手。我会从安装讲到配置从 Skill 编写讲到避坑经验把我在实际使用中踩过的坑和总结的技巧全部倒出来。提示本文基于 WorkBuddy 桌面版的通用使用逻辑撰写不同版本的具体界面和配置项可能有差异以你实际安装的版本为准。2. WorkBuddy 到底是个什么东西2.1 它和普通 AI 助手的本质区别普通 AI 助手的工作模式是你问一个问题它给你一段回答结束。整个过程是对话驱动的AI 只负责生成文本不负责执行任何操作。你想让它帮你改个文件、跑个脚本、批量处理一批数据它只能说你可以这样做然后你自己去动手。WorkBuddy 的工作模式是你给它一个任务它自己规划步骤、调用工具、执行操作、检查结果最后把做完的东西交给你。整个过程是任务驱动的AI 不只是生成文本还会实际操作你的文件系统、运行命令、调用外部服务。这就是AI Agent和普通 Chatbot 的核心分界线——能不能动手。我举个实际例子你就明白了。我有一批 Markdown 笔记文件名乱七八糟想批量重命名成日期-主题的格式。用普通 AI 助手它会告诉我你可以写个 Python 脚本用 os.rename 遍历目录……然后我得自己复制代码、保存、运行、调试。用 WorkBuddy我直接说把 D:\notes 目录下所有 .md 文件重命名成 日期-主题 格式日期从文件内容里提取它就会自己写脚本、自己执行、自己检查结果中间遇到编码问题还会自己调整。这个差别是质的差别。2.2 Skill 机制WorkBuddy 的核心竞争力WorkBuddy 最值得讲的设计就是Skill。你可以把 Skill 理解成给 AI 装的一个个技能包。每个 Skill 定义了 AI 在特定场景下应该怎么做、用什么工具、遵循什么规则。比如一个文件整理Skill定义了 AI 处理文件时的命名规范、目录结构、备份策略一个代码审查Skill定义了 AI 检查代码时的规则集、严重等级划分、输出格式一个数据清洗Skill定义了 AI 处理 CSV 时的缺失值策略、去重逻辑、格式转换规则Skill 的本质是一段结构化的指令 工具声明 约束条件。它让 AI 的行为从随机发挥变成按规矩办事。这一点非常关键因为 AI 最大的问题就是不确定性——同一个任务你今天问和明天问它给你的做法可能完全不一样。有了 Skill你就能把正确做法固化下来每次执行都走同一套流程。网上有人把 Skill 类比成给 AI 写的 SOP标准作业程序我觉得这个类比很准确。你想想一个新员工入职你要教他怎么做报表、怎么回邮件、怎么处理异常你会给他一份 SOP。Skill 就是给 AI 的 SOP只不过这份 SOP 是用自然语言 结构化配置写的AI 能直接读懂并执行。2.3 models.json模型路由的配置中枢models.json是 WorkBuddy 的模型配置文件。它决定了 WorkBuddy 在什么场景下调用哪个模型。这个设计很聪明因为不同任务对模型的要求不一样简单的文本改写、格式转换用轻量模型就够了快且省复杂的代码生成、逻辑推理需要上更强的模型涉及敏感数据的任务可能需要走本地模型models.json 让你可以精细控制这些路由规则。你可以配置多个模型端点然后按任务类型、按 Skill、按关键词来分配。我自己的配置是日常文本处理走轻量模型代码相关任务走代码专用模型涉及公司内部数据的走本地部署的模型。这样既保证了效果又控制了成本和隐私风险。注意models.json 的格式和可用字段跟版本强相关改之前一定先备份原文件。我见过有人改错了 JSON 格式导致 WorkBuddy 直接起不来最后只能重装。3. 安装与初始配置从零到能用3.1 安装前的环境准备WorkBuddy 是桌面应用支持 Windows 和 macOS。安装本身不复杂但有几个前置条件你得先确认系统要求方面Windows 建议 Win10 1903 以上macOS 建议 12 以上。内存至少 8GB但我实测 16GB 才比较舒服因为 WorkBuddy 跑任务时会同时开多个进程内存不够会卡。硬盘空间留够 5GB 以上因为模型缓存和日志会占地方。网络方面WorkBuddy 需要访问模型服务所以网络得通。如果你用的是公司网络注意有没有代理限制。这里我不展开讲网络配置你懂的。账号方面WorkBuddy 需要登录才能用。国内版和国际版的账号体系不一样功能也有差异。国内版对接的是国内模型服务国际版对接的是海外模型。选哪个看你的实际需求——如果你主要处理中文内容、用国内的服务国内版更顺手如果你需要处理多语言内容或者用特定的海外模型国际版更合适。3.2 安装步骤与首次启动安装流程很标准下载安装包 → 双击运行 → 选安装目录 → 等进度条走完 → 启动。但有几个细节值得说安装目录别选 C 盘默认路径。WorkBuddy 的缓存和模型文件会越来越大C 盘很容易被撑爆。我建议直接装到 D 盘或者专门的软件盘路径里不要有中文和空格避免一些莫名其妙的路径解析问题。首次启动会引导你登录和做基础配置。这一步别急着跳过认真看一下。它会问你默认工作目录在哪、要不要开启自动更新、遥测数据要不要上报。工作目录建议设成一个你专门用来放 AI 处理文件的目录别直接指向你的桌面或者文档根目录不然 AI 操作文件时你找起来会乱。登录后先别急着干活去设置里把模型配好。默认配置可能用的是通用模型效果不一定好。进设置 → 模型配置看看当前用的是哪个模型能不能切换。如果你有 API Key可以在这里填入自己的 Key这样用的是你自己的额度不受平台限制。3.3 更改系统缓存目录的正确姿势这是被问得最多的一个问题WorkBuddy 怎么更改系统缓存目录默认情况下WorkBuddy 把缓存放在系统用户目录下的隐藏文件夹里Windows 是%APPDATA%\WorkBuddy或类似路径macOS 是~/Library/Application Support/WorkBuddy。这个位置的问题在于第一占 C 盘空间第二重装系统或者迁移用户时容易丢第三有些清理软件会误删。改缓存目录的正确做法是先完全退出 WorkBuddy确保进程全部结束任务管理器里检查一下找到 WorkBuddy 的配置文件目录里面应该有一个 settings 或 config 相关的文件在配置里找到 cacheDir 或类似的字段把值改成你想要的路径把原缓存目录里的内容手动复制到新目录别剪切万一改失败还能回滚重新启动 WorkBuddy确认新目录生效提示有些版本不提供图形界面的缓存目录修改选项只能改配置文件。改之前一定备份原文件。如果改完启动报错把备份文件还原回去就行。我自己的做法是直接把缓存目录设到一个单独的 SSD 分区上这样既不影响系统盘读写速度也快。改完之后 WorkBuddy 的响应速度肉眼可见地提升了尤其是加载大文件的时候。4. Skill 编写实战从会用 to 用好4.1 Skill 的基本结构长什么样一个 Skill 通常包含这几个部分名称和描述告诉 WorkBuddy 这个 Skill 是干什么的触发条件什么情况下应该启用这个 Skill指令集具体的操作步骤和规则工具声明这个 Skill 需要用到哪些工具文件读写、命令执行、网络请求等约束条件不能做什么、必须遵守什么用自然语言写 Skill 是最容易上手的。你不需要懂编程只需要把这件事应该怎么做说清楚就行。但要说清楚也不容易因为 AI 理解指令有它的特点——它需要明确、具体、无歧义的描述。我写第一个 Skill 的时候犯了个典型错误写得太笼统。我写的是帮我整理文件结果 AI 每次整理的方式都不一样有时候按类型分有时候按日期分有时候按大小分。后来我改成把文件按扩展名分类到对应文件夹图片放 images文档放 docs压缩包放 archives其他放 others行为就稳定了。4.2 写一个好 Skill 的五个关键原则原则一指令要具体到可执行。优化代码是坏指令检查代码中的未使用变量并删除是好指令。AI 需要知道具体做什么而不是一个模糊的目标。原则二规则要可验证。代码要写得好没法验证函数不超过 50 行、变量名用驼峰命名、每个函数必须有注释可以验证。可验证的规则才能被稳定执行。原则三边界要清晰。处理文件没说清楚处理哪些文件、不处理哪些文件。处理 D:\work 目录下的 .txt 文件跳过子目录跳过隐藏文件就清晰了。原则四异常要有预案。如果文件不存在怎么办、如果编码不对怎么办、如果权限不够怎么办这些都要提前想好并写进 Skill。原则五输出格式要固定。如果你希望 AI 每次输出都按同样的格式就在 Skill 里把格式写死。比如输出必须包含处理文件数、成功数、失败数、失败原因列表。我拿一个实际例子来说明。下面是我写的一个Markdown 笔记整理Skill 的核心指令部分任务整理指定目录下的 Markdown 笔记文件 步骤 1. 扫描目录下所有 .md 文件不递归子目录 2. 对每个文件读取前 20 行提取标题第一个 # 开头的行 3. 如果文件没有标题用文件名作为标题 4. 检查文件名格式如果不是日期-标题.md格式重命名 5. 日期从文件内容中提取查找 YYYY-MM-DD 格式的日期 6. 如果找不到日期用文件修改时间 7. 重命名前先备份到 backup 子目录 约束 - 不修改文件内容只重命名 - 遇到无法解析的文件记录到 error.log不中断流程 - 所有操作记录到操作日志 输出格式 处理文件数X 成功重命名X 跳过X 失败X 失败列表文件名 原因这个 Skill 写完之后我每次整理笔记只需要说一句整理笔记WorkBuddy 就会按这套流程走结果稳定可预期。4.3 Skill 的组合与复用单个 Skill 的能力有限但 Skill 可以组合。WorkBuddy 支持在一个任务里调用多个 Skill也支持 Skill 之间互相引用。这就打开了很大的想象空间。比如我有一个数据清洗Skill 和一个报表生成Skill。单独用前者只能清洗数据后者只能生成报表。但组合起来我就可以说清洗 data.csv 然后生成月度报表WorkBuddy 会先调数据清洗 Skill 处理数据再把结果传给报表生成 Skill 输出报表。整个过程一气呵成。组合的关键是接口要对齐。前一个 Skill 的输出格式必须是后一个 Skill 能理解的输入格式。我在设计 Skill 的时候会特别注意这一点尽量让输出格式标准化。比如所有涉及数据的 Skill输出都用统一的 CSV 格式所有涉及文本的 Skill输出都用统一的 Markdown 格式。这样组合起来就不会出问题。4.4 那些去 AI 味的 Skill 技巧网上有个热词叫去 AI 味的 Skill说的是怎么让 AI 生成的内容看起来不像 AI 写的。这个需求很实际因为 AI 写的东西确实有股味儿——过度使用首先其次最后、喜欢用值得注意的是、动不动就综上所述。我在 Skill 里加了几条规则来去味禁止使用首先、其次、最后、总之、综上所述、值得注意的是这类连接词禁止使用通过……可以……这种句式段落开头不要用随着……的发展能用短句就不用长句能用一个词就不用一句话允许口语化表达允许不完整的句子加了这些规则之后AI 生成的内容明显自然多了。当然完全去味是不可能的但至少不会一眼就被看出来。5. 实操全流程一个完整任务的拆解5.1 任务定义与 Skill 选择我拿一个真实任务来演示把一批会议录音的转写文本整理成结构化会议纪要。这个任务的输入是一个目录里面有 10 个 .txt 文件每个文件是一次会议的转写文本格式不统一有的带时间戳有的不带有的有说话人标记有的没有。输出要求是每个会议生成一份结构化纪要包含会议主题、参会人、讨论要点、决议事项、待办任务。我先想清楚这个任务需要哪些能力文本解析提取信息、文本生成写纪要、文件操作读写文件。对应的 Skill 是一个会议纪要生成Skill内部调用文本处理工具和文件工具。5.2 关键步骤与参数配置第一步预处理。转写文本格式不统一先做标准化。我写了个预处理 Skill规则是去掉时间戳、统一说话人标记格式、去掉语气词和重复内容。这一步的输出是干净的对话文本。第二步信息提取。从干净文本里提取会议主题、参会人、讨论要点。这一步用 AI 的文本理解能力我在 Skill 里定义了提取规则主题从开头几段找参会人从说话人标记里汇总讨论要点按话题分段提取。第三步纪要生成。把提取的信息组织成结构化纪要。我在 Skill 里定义了输出模板# 会议纪要 ## 基本信息 - 会议主题 - 会议时间 - 参会人员 ## 讨论要点 1. 2. ## 决议事项 - ## 待办任务 - [ ] 任务内容负责人截止时间第四步质量检查。生成完之后让 AI 自己检查一遍有没有遗漏的参会人、有没有没归类的讨论内容、待办任务有没有明确负责人。检查不通过就重新生成。5.3 执行过程与结果验证实际执行的时候WorkBuddy 会先扫描目录然后逐个文件处理。我可以在界面上看到它的执行进度和每一步的操作日志。处理 10 个文件大概花了 3 分钟中间有一个文件因为编码问题卡了一下WorkBuddy 自己检测到编码不是 UTF-8尝试了几种编码后成功读取。结果验证我做了两件事第一随机抽了 3 份纪要和原始转写文本对照检查信息有没有遗漏或错误第二检查待办任务有没有明确负责人和截止时间。抽查下来准确率大概 85%主要问题是有两个待办任务没识别出负责人因为原文里负责人是用代词指的AI 没关联上。这个通过优化 Skill 里的指代消解规则可以改善。提示AI 处理任务不可能 100% 准确关键是要有验证环节。我的习惯是重要任务一定人工抽查抽查比例不低于 20%。6. 常见问题与避坑指南6.1 安装与启动类问题问题安装后启动闪退。最常见的原因是缺少运行库。Windows 上检查一下 .NET 运行时和 Visual C 运行库是否装全。另一个原因是安装路径有中文或特殊字符换个纯英文路径重装试试。问题登录一直转圈。先检查网络然后检查系统时间是否准确时间偏差太大会导致认证失败。如果都不行试试清除应用数据后重新登录。问题改了 models.json 之后起不来。JSON 格式错误是最常见的原因。用在线 JSON 校验工具检查一下格式。如果改之前没备份去安装目录找找有没有 .bak 文件或者直接重装。6.2 Skill 使用类问题问题Skill 不生效。检查三个地方Skill 有没有正确加载在 Skill 列表里能不能看到、触发条件有没有写对、指令有没有歧义。我遇到过好几次是触发条件写得太窄导致 Skill 根本没被激活。问题Skill 执行结果不稳定。这是 AI 的固有问题只能通过把指令写得更具体来缓解。另外可以在 Skill 里加执行前先复述一遍你的理解这样的步骤让 AI 先确认理解对了再动手。问题Skill 之间冲突。两个 Skill 的触发条件重叠时WorkBuddy 可能不知道该用哪个。解决办法是明确优先级或者在 Skill 描述里写清楚适用场景和不适用场景。6.3 性能与资源类问题问题处理大文件时卡死。WorkBuddy 处理大文件时会占用大量内存。解决办法是分块处理在 Skill 里定义每次处理不超过 1000 行处理完一批再处理下一批。问题缓存目录越来越大。定期清理缓存或者在设置里限制缓存大小。我一般每个月清一次清之前确认没有正在进行的任务。问题同时跑多个任务时互相干扰。WorkBuddy 支持多任务但多个任务同时操作同一批文件时会冲突。我的做法是给不同任务分配不同的工作目录避免交叉。6.4 常见问题速查表问题现象可能原因排查方法解决方案启动闪退缺运行库/路径有中文检查运行库、检查安装路径装运行库、换英文路径重装登录失败网络问题/时间偏差检查网络、检查系统时间修复网络、校准时间Skill 不生效未加载/触发条件错查看 Skill 列表、检查触发条件重新加载、修正触发条件执行结果不稳定指令有歧义检查 Skill 指令细化指令、加确认步骤处理大文件卡死内存不足查看内存占用分块处理缓存占满磁盘缓存未清理查看缓存目录大小清理缓存、限制缓存大小多任务冲突操作同一批文件检查任务工作目录分配不同工作目录6.5 我踩过的三个大坑第一个坑没备份就改配置。有一次我改 models.json 想试试新模型结果格式写错了WorkBuddy 直接起不来。偏偏那天有个急活要处理最后只能重装所有 Skill 配置全丢了。从那以后我改任何配置文件之前都先复制一份到备份目录。第二个坑Skill 写得太复杂。我一开始想把所有规则都塞进一个 Skill 里结果那个 Skill 有 200 多行指令AI 执行的时候经常顾此失彼。后来我把它拆成 5 个小 Skill每个只负责一件事组合起来用反而更稳定。Skill 要小而专不要大而全这是血泪教训。第三个坑完全信任 AI 的输出。有一次让 WorkBuddy 批量处理一批数据文件它跑完了说全部成功我就没检查。结果后来发现有一半文件的数据被截断了因为 AI 处理时遇到了编码问题但没报错默默跳过了。从那以后我养成了习惯AI 说完成了不算完成我自己验证过才算完成。7. 进阶玩法让 WorkBuddy 真正融入工作流7.1 用 Skill 固化重复性工作工作中那些每周都要做、每次做法都一样的活儿最适合做成 Skill。比如周报生成、数据汇总、文件归档、邮件模板填充。我目前固化了 12 个 Skill覆盖了日常 60% 的重复性工作。每次用的时候只需要说一句话剩下的 WorkBuddy 全包了。固化的关键是把隐性知识显性化。很多工作你做得顺手但让你写下来具体怎么做你会发现有很多细节是凭感觉的。写 Skill 的过程就是把这些感觉变成明确规则的过程。这个过程一开始会有点痛苦但一旦写完后面就一劳永逸了。7.2 多 Skill 协作处理复杂任务复杂任务拆成多个 Skill 串联执行是我目前用得最多的模式。比如月度数据报告这个任务我拆成了数据提取 Skill → 数据清洗 Skill → 数据分析 Skill → 图表生成 Skill → 报告撰写 Skill。五个 Skill 串起来输入原始数据输出完整报告。串联的时候要注意数据格式的衔接。我定了一套内部标准所有 Skill 之间传递数据用 JSON 格式字段名统一用下划线命名法日期统一用 ISO 8601 格式。这样不管哪个 Skill 的输出下一个 Skill 都能直接吃。7.3 给 WorkBuddy 定规则让约束持久生效WorkBuddy 支持设置全局规则这些规则对所有任务生效。我设了几条所有文件操作前先备份到 backup 目录所有输出文件用 UTF-8 编码不执行任何删除操作只做移动和重命名涉及网络请求的任务必须先确认每天的任务日志汇总到一个文件里这些规则相当于给 WorkBuddy 划了红线避免它做出我不想要的操作。尤其是不执行删除操作这条救过我好几次——有次 AI 想清理一些它认为没用的文件被规则拦住了我一看那些文件其实很重要。提示全局规则要定期回顾和调整。我每个月会看一遍规则把不再需要的删掉把新遇到的坑补进去。8. 一些个人体会WorkBuddy 这类工具最大的价值不是替代人而是把人从重复劳动里解放出来。我用了几个月最大的感受是以前每天要花两三个小时做的杂活现在压缩到二三十分钟而且做得比我手动做还规范。省下来的时间我可以用来做真正需要思考的事情。但它也不是万能的。AI 的理解能力有边界复杂判断、模糊决策、需要人情世故的场景它还是搞不定。我的原则是能标准化的交给 WorkBuddy需要判断的自己来。这个边界随着我对它能力的了解越来越清晰配合也越来越顺。最后分享一个小技巧每次 WorkBuddy 执行完任务花一分钟看一下它的操作日志。日志里能看到它每一步做了什么、遇到了什么问题、怎么解决的。看多了你会发现它的思考模式然后就能写出更贴合它理解方式的 Skill。这个反馈循环一旦建立起来你的 WorkBuddy 会越用越顺手。
1. 为什么我要认真写这篇 WorkBuddy 实战指南第一次听说 WorkBuddy 是在一个技术群里有人甩了张截图说腾讯出了个 AI 工作台能把日常那些重复性的活儿全接过去。当时我的反应跟大多数人一样又一个套壳产品吧直到我自己装了一遍、配了一遍、踩了一圈坑之后才发现这东西跟市面上那些对话式 AI 助手完全不是一个物种。WorkBuddy 的核心定位是AI 工作台不是聊天机器人。它通过Skill技能机制把 AI 的能力拆成可组合、可复用、可定制的模块再用models.json做模型路由配置最终让 AI 真正下地干活——读写文件、执行脚本、调用接口、处理数据而不是只会在对话框里给你写小作文。这套逻辑跟 AI Agent 的思路一脉相承但 WorkBuddy 把它做成了开箱即用的桌面工具门槛比从零搭一个 Agent 低得多。这篇文章适合三类人看第一类是完全没接触过 WorkBuddy、想搞清楚它到底能干什么的新手第二类是装完了但不知道怎么配 Skill、怎么改缓存目录、怎么让它真正干活的半吊子用户第三类是用过 CodeBuddy 或者其他 AI 编程工具、想对比一下 WorkBuddy 差异的老手。我会从安装讲到配置从 Skill 编写讲到避坑经验把我在实际使用中踩过的坑和总结的技巧全部倒出来。提示本文基于 WorkBuddy 桌面版的通用使用逻辑撰写不同版本的具体界面和配置项可能有差异以你实际安装的版本为准。2. WorkBuddy 到底是个什么东西2.1 它和普通 AI 助手的本质区别普通 AI 助手的工作模式是你问一个问题它给你一段回答结束。整个过程是对话驱动的AI 只负责生成文本不负责执行任何操作。你想让它帮你改个文件、跑个脚本、批量处理一批数据它只能说你可以这样做然后你自己去动手。WorkBuddy 的工作模式是你给它一个任务它自己规划步骤、调用工具、执行操作、检查结果最后把做完的东西交给你。整个过程是任务驱动的AI 不只是生成文本还会实际操作你的文件系统、运行命令、调用外部服务。这就是AI Agent和普通 Chatbot 的核心分界线——能不能动手。我举个实际例子你就明白了。我有一批 Markdown 笔记文件名乱七八糟想批量重命名成日期-主题的格式。用普通 AI 助手它会告诉我你可以写个 Python 脚本用 os.rename 遍历目录……然后我得自己复制代码、保存、运行、调试。用 WorkBuddy我直接说把 D:\notes 目录下所有 .md 文件重命名成 日期-主题 格式日期从文件内容里提取它就会自己写脚本、自己执行、自己检查结果中间遇到编码问题还会自己调整。这个差别是质的差别。2.2 Skill 机制WorkBuddy 的核心竞争力WorkBuddy 最值得讲的设计就是Skill。你可以把 Skill 理解成给 AI 装的一个个技能包。每个 Skill 定义了 AI 在特定场景下应该怎么做、用什么工具、遵循什么规则。比如一个文件整理Skill定义了 AI 处理文件时的命名规范、目录结构、备份策略一个代码审查Skill定义了 AI 检查代码时的规则集、严重等级划分、输出格式一个数据清洗Skill定义了 AI 处理 CSV 时的缺失值策略、去重逻辑、格式转换规则Skill 的本质是一段结构化的指令 工具声明 约束条件。它让 AI 的行为从随机发挥变成按规矩办事。这一点非常关键因为 AI 最大的问题就是不确定性——同一个任务你今天问和明天问它给你的做法可能完全不一样。有了 Skill你就能把正确做法固化下来每次执行都走同一套流程。网上有人把 Skill 类比成给 AI 写的 SOP标准作业程序我觉得这个类比很准确。你想想一个新员工入职你要教他怎么做报表、怎么回邮件、怎么处理异常你会给他一份 SOP。Skill 就是给 AI 的 SOP只不过这份 SOP 是用自然语言 结构化配置写的AI 能直接读懂并执行。2.3 models.json模型路由的配置中枢models.json是 WorkBuddy 的模型配置文件。它决定了 WorkBuddy 在什么场景下调用哪个模型。这个设计很聪明因为不同任务对模型的要求不一样简单的文本改写、格式转换用轻量模型就够了快且省复杂的代码生成、逻辑推理需要上更强的模型涉及敏感数据的任务可能需要走本地模型models.json 让你可以精细控制这些路由规则。你可以配置多个模型端点然后按任务类型、按 Skill、按关键词来分配。我自己的配置是日常文本处理走轻量模型代码相关任务走代码专用模型涉及公司内部数据的走本地部署的模型。这样既保证了效果又控制了成本和隐私风险。注意models.json 的格式和可用字段跟版本强相关改之前一定先备份原文件。我见过有人改错了 JSON 格式导致 WorkBuddy 直接起不来最后只能重装。3. 安装与初始配置从零到能用3.1 安装前的环境准备WorkBuddy 是桌面应用支持 Windows 和 macOS。安装本身不复杂但有几个前置条件你得先确认系统要求方面Windows 建议 Win10 1903 以上macOS 建议 12 以上。内存至少 8GB但我实测 16GB 才比较舒服因为 WorkBuddy 跑任务时会同时开多个进程内存不够会卡。硬盘空间留够 5GB 以上因为模型缓存和日志会占地方。网络方面WorkBuddy 需要访问模型服务所以网络得通。如果你用的是公司网络注意有没有代理限制。这里我不展开讲网络配置你懂的。账号方面WorkBuddy 需要登录才能用。国内版和国际版的账号体系不一样功能也有差异。国内版对接的是国内模型服务国际版对接的是海外模型。选哪个看你的实际需求——如果你主要处理中文内容、用国内的服务国内版更顺手如果你需要处理多语言内容或者用特定的海外模型国际版更合适。3.2 安装步骤与首次启动安装流程很标准下载安装包 → 双击运行 → 选安装目录 → 等进度条走完 → 启动。但有几个细节值得说安装目录别选 C 盘默认路径。WorkBuddy 的缓存和模型文件会越来越大C 盘很容易被撑爆。我建议直接装到 D 盘或者专门的软件盘路径里不要有中文和空格避免一些莫名其妙的路径解析问题。首次启动会引导你登录和做基础配置。这一步别急着跳过认真看一下。它会问你默认工作目录在哪、要不要开启自动更新、遥测数据要不要上报。工作目录建议设成一个你专门用来放 AI 处理文件的目录别直接指向你的桌面或者文档根目录不然 AI 操作文件时你找起来会乱。登录后先别急着干活去设置里把模型配好。默认配置可能用的是通用模型效果不一定好。进设置 → 模型配置看看当前用的是哪个模型能不能切换。如果你有 API Key可以在这里填入自己的 Key这样用的是你自己的额度不受平台限制。3.3 更改系统缓存目录的正确姿势这是被问得最多的一个问题WorkBuddy 怎么更改系统缓存目录默认情况下WorkBuddy 把缓存放在系统用户目录下的隐藏文件夹里Windows 是%APPDATA%\WorkBuddy或类似路径macOS 是~/Library/Application Support/WorkBuddy。这个位置的问题在于第一占 C 盘空间第二重装系统或者迁移用户时容易丢第三有些清理软件会误删。改缓存目录的正确做法是先完全退出 WorkBuddy确保进程全部结束任务管理器里检查一下找到 WorkBuddy 的配置文件目录里面应该有一个 settings 或 config 相关的文件在配置里找到 cacheDir 或类似的字段把值改成你想要的路径把原缓存目录里的内容手动复制到新目录别剪切万一改失败还能回滚重新启动 WorkBuddy确认新目录生效提示有些版本不提供图形界面的缓存目录修改选项只能改配置文件。改之前一定备份原文件。如果改完启动报错把备份文件还原回去就行。我自己的做法是直接把缓存目录设到一个单独的 SSD 分区上这样既不影响系统盘读写速度也快。改完之后 WorkBuddy 的响应速度肉眼可见地提升了尤其是加载大文件的时候。4. Skill 编写实战从会用 to 用好4.1 Skill 的基本结构长什么样一个 Skill 通常包含这几个部分名称和描述告诉 WorkBuddy 这个 Skill 是干什么的触发条件什么情况下应该启用这个 Skill指令集具体的操作步骤和规则工具声明这个 Skill 需要用到哪些工具文件读写、命令执行、网络请求等约束条件不能做什么、必须遵守什么用自然语言写 Skill 是最容易上手的。你不需要懂编程只需要把这件事应该怎么做说清楚就行。但要说清楚也不容易因为 AI 理解指令有它的特点——它需要明确、具体、无歧义的描述。我写第一个 Skill 的时候犯了个典型错误写得太笼统。我写的是帮我整理文件结果 AI 每次整理的方式都不一样有时候按类型分有时候按日期分有时候按大小分。后来我改成把文件按扩展名分类到对应文件夹图片放 images文档放 docs压缩包放 archives其他放 others行为就稳定了。4.2 写一个好 Skill 的五个关键原则原则一指令要具体到可执行。优化代码是坏指令检查代码中的未使用变量并删除是好指令。AI 需要知道具体做什么而不是一个模糊的目标。原则二规则要可验证。代码要写得好没法验证函数不超过 50 行、变量名用驼峰命名、每个函数必须有注释可以验证。可验证的规则才能被稳定执行。原则三边界要清晰。处理文件没说清楚处理哪些文件、不处理哪些文件。处理 D:\work 目录下的 .txt 文件跳过子目录跳过隐藏文件就清晰了。原则四异常要有预案。如果文件不存在怎么办、如果编码不对怎么办、如果权限不够怎么办这些都要提前想好并写进 Skill。原则五输出格式要固定。如果你希望 AI 每次输出都按同样的格式就在 Skill 里把格式写死。比如输出必须包含处理文件数、成功数、失败数、失败原因列表。我拿一个实际例子来说明。下面是我写的一个Markdown 笔记整理Skill 的核心指令部分任务整理指定目录下的 Markdown 笔记文件 步骤 1. 扫描目录下所有 .md 文件不递归子目录 2. 对每个文件读取前 20 行提取标题第一个 # 开头的行 3. 如果文件没有标题用文件名作为标题 4. 检查文件名格式如果不是日期-标题.md格式重命名 5. 日期从文件内容中提取查找 YYYY-MM-DD 格式的日期 6. 如果找不到日期用文件修改时间 7. 重命名前先备份到 backup 子目录 约束 - 不修改文件内容只重命名 - 遇到无法解析的文件记录到 error.log不中断流程 - 所有操作记录到操作日志 输出格式 处理文件数X 成功重命名X 跳过X 失败X 失败列表文件名 原因这个 Skill 写完之后我每次整理笔记只需要说一句整理笔记WorkBuddy 就会按这套流程走结果稳定可预期。4.3 Skill 的组合与复用单个 Skill 的能力有限但 Skill 可以组合。WorkBuddy 支持在一个任务里调用多个 Skill也支持 Skill 之间互相引用。这就打开了很大的想象空间。比如我有一个数据清洗Skill 和一个报表生成Skill。单独用前者只能清洗数据后者只能生成报表。但组合起来我就可以说清洗 data.csv 然后生成月度报表WorkBuddy 会先调数据清洗 Skill 处理数据再把结果传给报表生成 Skill 输出报表。整个过程一气呵成。组合的关键是接口要对齐。前一个 Skill 的输出格式必须是后一个 Skill 能理解的输入格式。我在设计 Skill 的时候会特别注意这一点尽量让输出格式标准化。比如所有涉及数据的 Skill输出都用统一的 CSV 格式所有涉及文本的 Skill输出都用统一的 Markdown 格式。这样组合起来就不会出问题。4.4 那些去 AI 味的 Skill 技巧网上有个热词叫去 AI 味的 Skill说的是怎么让 AI 生成的内容看起来不像 AI 写的。这个需求很实际因为 AI 写的东西确实有股味儿——过度使用首先其次最后、喜欢用值得注意的是、动不动就综上所述。我在 Skill 里加了几条规则来去味禁止使用首先、其次、最后、总之、综上所述、值得注意的是这类连接词禁止使用通过……可以……这种句式段落开头不要用随着……的发展能用短句就不用长句能用一个词就不用一句话允许口语化表达允许不完整的句子加了这些规则之后AI 生成的内容明显自然多了。当然完全去味是不可能的但至少不会一眼就被看出来。5. 实操全流程一个完整任务的拆解5.1 任务定义与 Skill 选择我拿一个真实任务来演示把一批会议录音的转写文本整理成结构化会议纪要。这个任务的输入是一个目录里面有 10 个 .txt 文件每个文件是一次会议的转写文本格式不统一有的带时间戳有的不带有的有说话人标记有的没有。输出要求是每个会议生成一份结构化纪要包含会议主题、参会人、讨论要点、决议事项、待办任务。我先想清楚这个任务需要哪些能力文本解析提取信息、文本生成写纪要、文件操作读写文件。对应的 Skill 是一个会议纪要生成Skill内部调用文本处理工具和文件工具。5.2 关键步骤与参数配置第一步预处理。转写文本格式不统一先做标准化。我写了个预处理 Skill规则是去掉时间戳、统一说话人标记格式、去掉语气词和重复内容。这一步的输出是干净的对话文本。第二步信息提取。从干净文本里提取会议主题、参会人、讨论要点。这一步用 AI 的文本理解能力我在 Skill 里定义了提取规则主题从开头几段找参会人从说话人标记里汇总讨论要点按话题分段提取。第三步纪要生成。把提取的信息组织成结构化纪要。我在 Skill 里定义了输出模板# 会议纪要 ## 基本信息 - 会议主题 - 会议时间 - 参会人员 ## 讨论要点 1. 2. ## 决议事项 - ## 待办任务 - [ ] 任务内容负责人截止时间第四步质量检查。生成完之后让 AI 自己检查一遍有没有遗漏的参会人、有没有没归类的讨论内容、待办任务有没有明确负责人。检查不通过就重新生成。5.3 执行过程与结果验证实际执行的时候WorkBuddy 会先扫描目录然后逐个文件处理。我可以在界面上看到它的执行进度和每一步的操作日志。处理 10 个文件大概花了 3 分钟中间有一个文件因为编码问题卡了一下WorkBuddy 自己检测到编码不是 UTF-8尝试了几种编码后成功读取。结果验证我做了两件事第一随机抽了 3 份纪要和原始转写文本对照检查信息有没有遗漏或错误第二检查待办任务有没有明确负责人和截止时间。抽查下来准确率大概 85%主要问题是有两个待办任务没识别出负责人因为原文里负责人是用代词指的AI 没关联上。这个通过优化 Skill 里的指代消解规则可以改善。提示AI 处理任务不可能 100% 准确关键是要有验证环节。我的习惯是重要任务一定人工抽查抽查比例不低于 20%。6. 常见问题与避坑指南6.1 安装与启动类问题问题安装后启动闪退。最常见的原因是缺少运行库。Windows 上检查一下 .NET 运行时和 Visual C 运行库是否装全。另一个原因是安装路径有中文或特殊字符换个纯英文路径重装试试。问题登录一直转圈。先检查网络然后检查系统时间是否准确时间偏差太大会导致认证失败。如果都不行试试清除应用数据后重新登录。问题改了 models.json 之后起不来。JSON 格式错误是最常见的原因。用在线 JSON 校验工具检查一下格式。如果改之前没备份去安装目录找找有没有 .bak 文件或者直接重装。6.2 Skill 使用类问题问题Skill 不生效。检查三个地方Skill 有没有正确加载在 Skill 列表里能不能看到、触发条件有没有写对、指令有没有歧义。我遇到过好几次是触发条件写得太窄导致 Skill 根本没被激活。问题Skill 执行结果不稳定。这是 AI 的固有问题只能通过把指令写得更具体来缓解。另外可以在 Skill 里加执行前先复述一遍你的理解这样的步骤让 AI 先确认理解对了再动手。问题Skill 之间冲突。两个 Skill 的触发条件重叠时WorkBuddy 可能不知道该用哪个。解决办法是明确优先级或者在 Skill 描述里写清楚适用场景和不适用场景。6.3 性能与资源类问题问题处理大文件时卡死。WorkBuddy 处理大文件时会占用大量内存。解决办法是分块处理在 Skill 里定义每次处理不超过 1000 行处理完一批再处理下一批。问题缓存目录越来越大。定期清理缓存或者在设置里限制缓存大小。我一般每个月清一次清之前确认没有正在进行的任务。问题同时跑多个任务时互相干扰。WorkBuddy 支持多任务但多个任务同时操作同一批文件时会冲突。我的做法是给不同任务分配不同的工作目录避免交叉。6.4 常见问题速查表问题现象可能原因排查方法解决方案启动闪退缺运行库/路径有中文检查运行库、检查安装路径装运行库、换英文路径重装登录失败网络问题/时间偏差检查网络、检查系统时间修复网络、校准时间Skill 不生效未加载/触发条件错查看 Skill 列表、检查触发条件重新加载、修正触发条件执行结果不稳定指令有歧义检查 Skill 指令细化指令、加确认步骤处理大文件卡死内存不足查看内存占用分块处理缓存占满磁盘缓存未清理查看缓存目录大小清理缓存、限制缓存大小多任务冲突操作同一批文件检查任务工作目录分配不同工作目录6.5 我踩过的三个大坑第一个坑没备份就改配置。有一次我改 models.json 想试试新模型结果格式写错了WorkBuddy 直接起不来。偏偏那天有个急活要处理最后只能重装所有 Skill 配置全丢了。从那以后我改任何配置文件之前都先复制一份到备份目录。第二个坑Skill 写得太复杂。我一开始想把所有规则都塞进一个 Skill 里结果那个 Skill 有 200 多行指令AI 执行的时候经常顾此失彼。后来我把它拆成 5 个小 Skill每个只负责一件事组合起来用反而更稳定。Skill 要小而专不要大而全这是血泪教训。第三个坑完全信任 AI 的输出。有一次让 WorkBuddy 批量处理一批数据文件它跑完了说全部成功我就没检查。结果后来发现有一半文件的数据被截断了因为 AI 处理时遇到了编码问题但没报错默默跳过了。从那以后我养成了习惯AI 说完成了不算完成我自己验证过才算完成。7. 进阶玩法让 WorkBuddy 真正融入工作流7.1 用 Skill 固化重复性工作工作中那些每周都要做、每次做法都一样的活儿最适合做成 Skill。比如周报生成、数据汇总、文件归档、邮件模板填充。我目前固化了 12 个 Skill覆盖了日常 60% 的重复性工作。每次用的时候只需要说一句话剩下的 WorkBuddy 全包了。固化的关键是把隐性知识显性化。很多工作你做得顺手但让你写下来具体怎么做你会发现有很多细节是凭感觉的。写 Skill 的过程就是把这些感觉变成明确规则的过程。这个过程一开始会有点痛苦但一旦写完后面就一劳永逸了。7.2 多 Skill 协作处理复杂任务复杂任务拆成多个 Skill 串联执行是我目前用得最多的模式。比如月度数据报告这个任务我拆成了数据提取 Skill → 数据清洗 Skill → 数据分析 Skill → 图表生成 Skill → 报告撰写 Skill。五个 Skill 串起来输入原始数据输出完整报告。串联的时候要注意数据格式的衔接。我定了一套内部标准所有 Skill 之间传递数据用 JSON 格式字段名统一用下划线命名法日期统一用 ISO 8601 格式。这样不管哪个 Skill 的输出下一个 Skill 都能直接吃。7.3 给 WorkBuddy 定规则让约束持久生效WorkBuddy 支持设置全局规则这些规则对所有任务生效。我设了几条所有文件操作前先备份到 backup 目录所有输出文件用 UTF-8 编码不执行任何删除操作只做移动和重命名涉及网络请求的任务必须先确认每天的任务日志汇总到一个文件里这些规则相当于给 WorkBuddy 划了红线避免它做出我不想要的操作。尤其是不执行删除操作这条救过我好几次——有次 AI 想清理一些它认为没用的文件被规则拦住了我一看那些文件其实很重要。提示全局规则要定期回顾和调整。我每个月会看一遍规则把不再需要的删掉把新遇到的坑补进去。8. 一些个人体会WorkBuddy 这类工具最大的价值不是替代人而是把人从重复劳动里解放出来。我用了几个月最大的感受是以前每天要花两三个小时做的杂活现在压缩到二三十分钟而且做得比我手动做还规范。省下来的时间我可以用来做真正需要思考的事情。但它也不是万能的。AI 的理解能力有边界复杂判断、模糊决策、需要人情世故的场景它还是搞不定。我的原则是能标准化的交给 WorkBuddy需要判断的自己来。这个边界随着我对它能力的了解越来越清晰配合也越来越顺。最后分享一个小技巧每次 WorkBuddy 执行完任务花一分钟看一下它的操作日志。日志里能看到它每一步做了什么、遇到了什么问题、怎么解决的。看多了你会发现它的思考模式然后就能写出更贴合它理解方式的 Skill。这个反馈循环一旦建立起来你的 WorkBuddy 会越用越顺手。
