企业官网建设流程全解析

1. 为什么我最终把 WorkBuddy 当成了主力工作台

第一次接触 WorkBuddy 是在一个项目排期最紧的时候。当时团队里同时在跑三四个自动化任务，有的要抓数据、有的要生成周报、有的要定时整理会议纪要，工具换来换去，配置散落在各个角落，维护成本高得离谱。后来有人提了一句"你试试 WorkBuddy"，我抱着试试看的心态装了一次，结果这一装就再也没换回去。

WorkBuddy 是腾讯推出的 AI 工作台产品，核心定位不是"再做一个聊天框"，而是把 AI Agent 的能力真正落到日常工作任务上。它通过Skill（技能）机制把一个个具体能力拆成可复用、可组合的模块，再通过models.json这样的配置文件把模型接入、参数调优、任务编排统一管理起来。简单说，它解决的是"AI 能聊天但干不了活"这个老问题——让 AI 真的能下地干活，而不是停留在对话框里陪你唠嗑。

这篇内容适合几类人看：一是刚听说 WorkBuddy、想搞清楚它到底能干什么的新手；二是已经装上了但卡在配置、Skill 编写、缓存目录这些细节上的中级用户；三是想把它当成团队 AI Agent 中台来用的技术负责人。我会从安装讲起，一路讲到 Skill 开发、models.json 配置、并发处理、避坑经验，尽量把每个"为什么"都讲透，而不是只丢一堆步骤让你照抄。

需要先说明一点：WorkBuddy 和 CodeBuddy 经常被放在一起讨论，两者定位不同。CodeBuddy 更偏向编码辅助场景，而 WorkBuddy 是面向通用工作任务的 AI 工作台，Skill 体系是它的核心差异点。搞清楚这个区别，后面的很多设计选择就顺了。

2. 安装前的环境判断与版本选择

2.1 先想清楚你要的是国内版还是国际版

WorkBuddy 有国内版和国际版两个分发渠道，这不是简单的"语言不同"，而是涉及账号体系、可用模型、Skill 生态、网络环境适配等一整套差异。我的建议很直接：如果你主要处理中文工作任务、团队都在国内协作环境里，优先用国内版，模型接入和 Skill 商店的匹配度更高；如果你有跨境协作需求、需要对接某些海外服务，再考虑国际版。

很多人一上来就问"哪个版本更强"，这其实是个伪命题。版本选择的核心依据是你的任务场景和协作对象，而不是版本本身的绝对优劣。我见过有人为了"尝鲜"装了国际版，结果发现常用的几个 Skill 在国内版生态里更新更勤，又折腾着换回来，白白浪费半天。

2.2 安装过程中最容易忽略的三个细节

安装本身不复杂，下载、运行、登录，三步走。但真正决定你后续顺不顺手的，是安装阶段这几个容易被跳过的设置：

第一，安装路径不要带中文和空格。这是老生常谈但每年都有人踩的坑。WorkBuddy 底层会调用一些命令行工具和脚本执行环境，路径里有中文或空格时，某些 Skill 的调用会莫名其妙失败，报错信息还特别隐晦，你根本想不到是路径问题。我一般直接装在D:\WorkBuddy或~/workbuddy这种干净路径下。

第二，首次启动时留意默认的工作目录和缓存目录。WorkBuddy 默认会把缓存、日志、临时文件放在系统盘的用户目录下。如果你像我一样系统盘空间紧张，或者习惯把工作数据集中管理，一定要在第一次启动后就去设置里改掉。缓存目录堆积起来非常快，尤其是频繁跑 Skill 的时候，几周就能吃掉好几个 G。

第三，登录后先别急着装 Skill，先把模型配置跑通。很多人装完就冲进 Skill 商店一顿下载，结果发现模型没配好，Skill 全都跑不起来。正确的顺序是：登录 → 配置模型（models.json）→ 测试一次基础对话 → 再装 Skill。

2.3 更改系统缓存目录的完整操作

缓存目录这个问题值得单独说，因为问的人太多了。默认路径通常在系统盘，改的时候要注意几点：

• 新目录必须是已存在的空目录，不要指向一个已经有其他程序在用的文件夹，否则可能互相覆盖。
• 改完之后建议重启一次 WorkBuddy，让配置生效。
• 如果你之前已经跑过一段时间，旧缓存目录里的内容可以手动迁移过去，也可以直接删掉让它重新生成——但删之前确认里面没有你需要的日志。

我自己的做法是专门建一个workbuddy-data目录，下面再分cache、logs、skills三个子目录，这样备份和清理都很清晰。这个习惯是从踩过"缓存和日志混在一起、出问题时找不到关键日志"的坑之后养成的。

3. models.json 配置：整个工作台的神经中枢

3.1 models.json 到底管什么

如果把 WorkBuddy 比作一台机器，Skill 是各种功能模块，那models.json就是决定这台机器用哪个"大脑"运转的控制文件。它主要管三件事：接入哪些模型、每个模型的调用参数、以及不同任务场景下默认用哪个模型。

很多人对 models.json 有误解，以为它只是个简单的模型列表。实际上它承担的是路由和调优的职责。比如你可以配置一个快速模型处理日常问答，一个强推理模型处理复杂任务，再通过规则让 WorkBuddy 根据任务类型自动选择。这个设计的好处是成本和效果能平衡——不是所有任务都需要最强模型，杀鸡用牛刀既慢又贵。

3.2 一份可参考的配置结构

下面这份结构是我在实际使用中整理出来的，字段命名以官方文档为准，这里重点讲每个字段的作用和配置思路：

{ "models": [ { "name": "fast-model", "provider": "your-provider", "model": "model-id", "temperature": 0.3, "maxTokens": 2048, "timeout": 30 }, { "name": "reasoning-model", "provider": "your-provider", "model": "model-id", "temperature": 0.7, "maxTokens": 8192, "timeout": 120 } ], "defaultModel": "fast-model", "taskRouting": { "chat": "fast-model", "code": "reasoning-model", "analysis": "reasoning-model" } }

几个关键点解释一下：

temperature 的取值逻辑。日常对话、信息提取这类任务，temperature 设低一点（0.2~0.4），输出更稳定、更可控；创意生成、头脑风暴类任务可以设高一点（0.7~0.9），让输出更多样。我见过有人所有任务都用默认值，结果要么太死板要么太飘，其实就是没根据场景调。

maxTokens 和 timeout 要配套。如果你把 maxTokens 设得很大但 timeout 很短，长任务会在生成到一半时被掐断，报错还不好定位。经验值是：maxTokens 每 1000 token 大约需要 10~15 秒的生成时间，timeout 要留足余量。复杂分析任务我一般给到 120 秒以上。

taskRouting 是提效的关键。配好路由之后，你不需要每次手动选模型，WorkBuddy 会根据任务类型自动匹配。这个功能在团队协作场景下尤其有用，能避免"每个人都用最强模型跑简单任务"造成的资源浪费。

3.3 配置改完不生效？先查这三个地方

models.json 改完没反应，是最常见的求助问题之一。按我的排查顺序：

1. JSON 格式是否合法。多一个逗号、少一个引号，整个文件就废了。建议用编辑器的 JSON 校验功能先过一遍。
2. 是否重启了 WorkBuddy。部分配置是启动时加载的，热更新不一定覆盖所有字段。
3. 字段名是否拼写正确。大小写敏感，maxTokens写成maxtokens就是无效配置，而且不会报错，只会静默忽略。

提示：改 models.json 之前先备份一份。我吃过一次亏，改错了一个字段导致整个工作台起不来，又没有备份，只能重装。

4. Skill 机制：WorkBuddy 真正的战斗力来源

4.1 Skill 是什么，为什么它比"提示词"更值得投入

Skill 可以理解成"封装好的能力单元"。一个 Skill 通常包含：触发条件、执行逻辑、依赖的工具或接口、输出格式。它和普通提示词的本质区别在于——提示词是一次性的，Skill 是可复用、可组合、可版本管理的。

举个例子，你让 AI"帮我整理今天的会议纪要"，用提示词你得每次把格式要求、输出结构重新说一遍；做成 Skill 之后，你只要触发它，格式、逻辑、输出全都固定好了，而且可以分享给团队其他人用。这就是为什么我说 Skill 才是 WorkBuddy 的核心价值，值得花时间投入。

从热词里能看到很多相关概念：agent skill、skill 插件、skill 脚本、skill 开发指南、book to skill、去 AI 味的 skill……这些其实都指向同一个方向——把重复性的工作沉淀成 Skill。我个人的判断是，未来衡量一个人 AI 工作台用得好不好，很大程度上看他积累了多少高质量 Skill。

4.2 一个 Skill 的典型结构拆解

虽然不同版本的 Skill 定义格式略有差异，但核心结构是相通的。一个完整的 Skill 一般包含这几部分：

我特别想强调元信息里的描述。很多人写 Skill 描述就写一句"处理文档"，结果这个 Skill 要么从不被触发，要么在不该触发的时候乱触发。好的描述应该像这样："当用户需要把会议录音转写文本整理成结构化纪要时使用，输入为纯文本，输出为带议题、结论、待办的 Markdown"。这样 AI 才能准确判断调用时机。

4.3 从零写一个 Skill 的实操思路

写 Skill 不要一上来就追求复杂。我的建议是从"你每天重复做的一件小事"开始。比如我写的第一个 Skill 是"把零散的需求描述整理成标准任务卡"，逻辑很简单：接收一段自由文本 → 提取关键信息 → 按固定模板输出。就这么个简单东西，帮我省了大量重复劳动。

写的时候注意几个原则：

• 单一职责。一个 Skill 只干一件事。想干多件事就拆成多个 Skill 再串联，这样每个都可独立测试和复用。
• 输入输出明确。输入是什么格式、输出是什么格式，写死在 Skill 里，不要依赖"AI 自己理解"。
• 可测试。写完先用几个典型输入跑一遍，看看输出是否符合预期，再拿去实际用。
• 留好错误处理。输入不符合预期时，Skill 应该给出清晰提示，而不是直接崩掉。

关于"去 AI 味的 skill"这个热词，我的理解是：很多 Skill 生成的内容一眼就能看出是 AI 写的，套话多、结构僵。解决办法是在 Skill 里加入风格约束，比如指定语气、禁用某些模板化表达、要求用具体案例代替泛泛而谈。这个思路和我写这篇内容的原则其实是一样的。

4.4 Skill 组合：从单点能力到工作流

单个 Skill 解决单点问题，多个 Skill 串联起来才能形成完整工作流。WorkBuddy 支持把 Skill 按顺序编排，前一个的输出作为后一个的输入。这个能力用好了，能搭出相当复杂的自动化流程。

举个我实际搭过的例子：一个"周报生成"工作流，由四个 Skill 串联——第一个抓取本周的任务记录，第二个提取完成项和阻塞项，第三个按团队模板组织内容，第四个做语言润色。整个过程一键触发，几分钟出结果，以前手动整理要花小半个小时。

组合的时候最容易出问题的地方是数据格式衔接。前一个 Skill 输出的是 JSON，后一个 Skill 期望的是纯文本，中间就会断。所以我在写每个 Skill 时都会明确标注输入输出格式，组合前先确认能对上。

5. 并发与稳定性：AI Agent 扛并发的真实经验

5.1 为什么并发是绕不开的坎

"AI Agent 怎么扛并发"是个高频问题。当你把 WorkBuddy 用在团队场景，多个任务同时触发、多个 Skill 并行执行时，问题就来了：模型调用被限流、任务排队、部分任务超时失败。

这个问题的本质是资源竞争。模型接口有速率限制，本地执行环境有 CPU 和内存上限，Skill 依赖的外部服务也有各自的承载能力。并发上不去，通常不是某一个环节的问题，而是整条链路上最慢的那一环在拖后腿。

5.2 我踩过的并发坑和解决思路

坑一：无脑并发导致大面积超时。一开始我让所有任务同时发起，结果模型接口直接限流，一半任务失败。后来改成分批 + 队列，控制同时执行的任务数，稳定性立刻上来了。

坑二：长任务阻塞短任务。一个耗时两分钟的分析任务占着资源，后面一堆几秒钟的小任务干等着。解决办法是按任务类型分队列，快任务和慢任务走不同的通道，互不阻塞。

坑三：失败重试没有退避。任务失败后立刻重试，结果越重试越堵。正确的做法是指数退避——第一次失败等 1 秒，第二次等 2 秒，第三次等 4 秒，给系统喘息的空间。

下面这张表是我总结的并发调优对照：

5.3 稳定性比峰值性能更重要

做 AI Agent 有个心态上的转变很重要：别追求"能同时跑多少"，要追求"跑多久不出错"。峰值性能好看，但生产环境里稳定才是王道。我现在的配置原则是：并发数留 30% 余量，宁可慢一点，也不要因为打满资源导致整批任务失败。

另外，日志一定要开全。并发场景下出问题，没有详细日志根本没法定位是哪个任务、哪个 Skill、哪一步出的错。我专门配了一个日志目录，按天切分，出问题时能快速回溯。

6. 那些没人告诉你但一定会踩的坑

6.1 规则设置：让 WorkBuddy 记住你的偏好

WorkBuddy 支持设置全局规则，让某些要求对所有任务生效。这个功能用好了能省很多重复沟通。比如我设了几条：

• 所有输出默认用中文，除非明确要求其他语言。
• 生成的内容避免使用"综上所述""随着……的发展"这类模板化表达。
• 涉及数据的结论必须标注来源或计算过程。

这几条规则一设，后面所有任务都自动遵守，不用每次重复交代。热词里"给 workbuddy 定几条规则，后续对所有任务都生效"说的就是这个。我的经验是：规则不要设太多，5 条以内，聚焦最高频的偏好，设多了反而互相冲突。

6.2 Skill 装了却用不起来？按这个顺序查

Skill 装了不生效，排查顺序建议是：

1. 模型是否配置正确。Skill 依赖模型，模型没配好一切白搭。
2. 依赖是否齐全。有些 Skill 需要额外的工具或接口权限，缺了就跑不起来。
3. 触发条件是否匹配。你的输入没命中 Skill 的触发条件，它自然不会启动。
4. 版本是否兼容。老版本 Skill 在新版本 WorkBuddy 上可能不兼容，去商店看看有没有更新。

6.3 关于"哪些 Skill 最好用"的实话

经常有人问 WorkBuddy 哪些 Skill 最好用。我的看法是：没有普适的最好用，只有最适合你场景的。别人推荐的文档处理 Skill，如果你不做文档工作，装了也是吃灰。

我的建议是先从自己的高频任务出发，缺什么补什么。用一段时间后你会发现，真正天天用的可能就那么三五个 Skill，但每一个都深度嵌入了你的工作流。与其装一堆用不上的，不如把几个核心的用透。

6.4 数据安全和备份

最后说个容易被忽略的点：备份。你的 models.json、自定义 Skill、规则配置，这些都是心血，一旦丢失重来很痛苦。我现在的做法是定期把配置目录打包备份，改配置前先存一份。这个习惯帮我躲过好几次"改崩了想回滚"的窘境。

7. 我个人的使用体会

用 WorkBuddy 这段时间，最大的感受是：它的价值不在于"AI 多聪明"，而在于"你把多少重复劳动沉淀成了可复用的能力"。刚开始我也只是拿它当个高级聊天工具，直到开始认真写 Skill、配 models.json、设全局规则，才真正体会到工作台和聊天框的区别。

如果你刚上手，我的建议是别贪多。先把模型配通，写一两个解决自己实际痛点的 Skill，用顺了再逐步扩展。AI Agent 这东西，用起来容易，用好需要积累，而积累的核心就是那些你亲手打磨的 Skill 和规则。

后续我还会继续折腾 Skill 组合和并发调优，有新发现再分享。如果你在配置或 Skill 编写上卡住了，大概率是上面提到的某几个坑，按顺序排查一遍，基本都能解决。