WorkBuddy 使用教程：核心功能拆解 + 接入第三方 API 实战（以魔芋为例）-拓冰建站

用了大半个月 WorkBuddy，我把它的功能翻了个底朝天，又顺手把第三方 API 接进来跑了一阵。这篇就把我踩过的坑和验证过的配置一次写清楚，不讲虚的。

适合谁看：日常有文档处理、数据清洗、批量抓取需求，又不想被积分额度卡脖子的人。

一、先搞清楚 WorkBuddy 到底在干什么

很多人把它当成又一个聊天框，这是最大的误解。

WorkBuddy 本体是一个本地 Agent 调度层。文件读写、网页抓取、窗口自动化、流程串联这些"动手"的活，它在本地跑，不消耗任何积分。真正吃算力的部分（文本推理、文档归纳、内容生成）是剥离出去的，交给模型 API 完成。

理解这一点很重要：接第三方 API，本质是把"思考"外包出去，本地只负责"动手"。所以后面那套接入流程，省的不是技巧，是实打实的算力账单。

二、八个核心功能，挨个说怎么用

1. 工作区（Workspace）

工作区是基本隔离单元。每个工作区里的配置、对话历史、知识库互不干扰。

我的做法是按项目切：日常工作一个、side project 一个、学习笔记一个。切换工作区等于换一套完整环境，多线推进不会串味。

2. 三种工作模式：Craft / Plan / Ask

权限从高到低三档：

Craft：AI 直接执行，改文件、跑命令、调工具都不用你点头。适合自动化或你完全信任的场景。
Plan：先列计划，每一步要你手动确认。改重要文件、方案不确定时用它，稳。
Ask：只能问答，不碰你的系统和文件。纯咨询用。

我的习惯：写自动化脚本开 Craft，动生产代码切 Plan，只想问个问题就 Ask。按场景随时切，别一刀切。

3. 模型选择

默认 Auto 模式，系统按任务类型自动匹配性价比最高的模型，大多数情况够用。任务复杂、要更强推理时再手动切大模型。支持的包括 GLM、DeepSeek、Qwen 这些，热门模型偶尔排队，响应会慢一点。

它也支持接自定义模型，公司内网部署的或自己搞的模型都能配进来。这是本文后半段的重点。

一句话：日常 Auto，追效果选大模型，有API接定义。

4. 技能市场与 Skill Creator

Skill 是预制工具包，装上之后 Agent 发任务会自动调用，补齐它本来不擅长的能力（文档编辑、数据分析之类）。市场覆盖几类：文档处理（PDF/Word/PPT/Excel）、数据分析（图表、清洗、报告）、自动化（定时任务、工作流、API 调用）、连接器（飞书、钉钉、GitHub、腾讯文档）。

真正值得说的是Skill Creator。它能把你的工作流固化成一个新的 Skill。比如每天都要走一遍整理资料的流程，用 Skill Creator 包成一个 Skill，以后一键调用。从"用工具"变成"造工具"，越用越顺手。

5. 专家模式

这个最有特色。选一个专家团发指令，团长接收后分发给团里最合适的 Agent 去做。团类型覆盖数据分析、软件开发、内容创作、产品战略等。

核心优势是：专家团针对特定领域优化过，知道用什么思路和工具解决问题，效果比通用对话好一截。相当于你随时有个专业团队待命，而不是一个能聊天的通用助手。

6. 记忆系统

持久化记忆，设置里能看能改。它会通过对话慢慢画出你的画像：工作性质、常用工具、偏好的表达格式、项目背景、长期关注的方向。

好处是后续对话不用每次重新解释背景。控制权在你手里，记错了直接编辑，想补背景直接加。既学你，又听你的。

7. IM 连接

能连微信、钉钉、飞书、企业微信。连上之后不用开 WorkBuddy，直接在 IM 里跟它对话、丢任务。在微信收到文件转发给它就能整理归档；钉钉群里 @它查资料做表格；飞书里生成会议纪要。

AI 能力直接接进日常沟通工具，不用来回切应用，门槛低很多。这是腾讯生态的一个明显优势。

8. 定时任务

设好时间自动跑，不用手动触发。每天 18:00 归档当天聊天摘要、每周一 9:00 出上周小结、每月 1 号统计项目进度、每天早上推一份行业资讯，都能自动化。

一个坑要记住：自动化任务只在 WorkBuddy 启动时才会跑，而它不支持开机自启。所以每天开机后先把它启动了，别指望它自己醒。

三、实战：用专家团搭一个酒店比价站

拿一个例子说明功能怎么协同。目标是做一个国内酒店三平台（携程、去哪儿、美团）比价显示网站，前后端分离，全程用专家团推进。

整个流程分五步：

生成需求文档：用探索功能，找"产品需求文档"模板，输入项目主题，AI 吐出一份结构完整的 Markdown 需求文档（背景、功能需求、用户故事、技术约束）。这是后面所有阶段的输入。
产品架构：切到产品战略专家团，把需求文档喂进去，要它出功能模块划分、用户流程、信息架构、技术栈建议。产出一份架构蓝图。
前端页面：换前端开发工程师团，把架构文档发过去，要求现代简约 UI、响应式、实现搜索/比价/趋势图核心页面。前端团直接生成 HTML/CSS/JS，浏览器里能预览。
后端模块：换后端架构师团，要它做数据获取逻辑、多平台比价逻辑、数据库设计、技术栈推荐。产出后端代码加 API 接口文档。
集成上线：换高级开发工程师团，把前后端代码一起丢过去，要联调步骤、本地运行方法、部署方案对比、常见问题排查。最后拿到一份能照着跑的部署指南。

跑完这五步，一个能用的比价站就成型了：输入出发地目的地日期，点搜索同时拉三个平台价格，卡片对比加趋势图，PC 和移动端自适应。

重点不是这个站多厉害，而是从需求到上线，一个 WorkBuddy 顶一整个团队。专家团之间交接靠文档，你只要会把上一阶段的产出喂给下一阶段。

四、接入第三方 API（以魔芋为例）

为什么要接第三方 API

回到第一节的算力分离逻辑。WorkBuddy 本地调度不花积分，但用内置模型做文本推理是要扣积分的。高频批量任务（几十份 PDF 拆解、上万行表格清洗、全网竞品抓取）跑下来，积分掉得很快。接一个外部模型 API 进来，把推理这一段甩出去，本地任务全程零积分消耗。免费额度用完换个平台接着用，长期成本压到很低。

而且更重要的是，能体验全球流行的大模型（如Claude和gpt），不用自己折腾帐号和网络配置环境。

魔芋是什么

魔芋（moyu.info）是一个 OpenAI 兼容的 API 中转平台。我实测验证了它的接口契约，确认几点：

接口 Base 地址是https://moyu.info/v1，遵循 OpenAI 标准路由（/v1/models、/v1/chat/completions）。
鉴权用Authorization: Bearer <你的密钥>。
服务跑在阿里云 CDN 后面，国内直连延迟低，不用挂代理。
报错格式是{"error":{"message":"...","type":"moyu_api_error"}}，带 request id，排查问题方便。

对比了一些其他中转站，魔芋的稳定性、价格和速度上还是很有性价比的。

第一步：在魔芋拿到 API Key

标准流程（各中转平台基本一致，菜单名按魔芋后台实际为准）：

点击前往（手机号或邮箱一键注册）魔芋AI大模型网关I全球大模型一站式调用及服务平台魔芋AI大模型聚合平台（大模型网关平台）专注于提供高效能、低成本的多品类 AI 模型服务，助力开发者和企业聚焦产品创新。https://www.moyu.info/register?aff=qBX9
2、注册成功后进入【令牌管理】

3、模型广场上复制要使用的模型ID
要配置moder ID时候要去模型广场复制名称。
我们可以前往模型广场查看全球主流模型。如果注册后前往模型广场没有看到想用的全球模型，可以联系客服，添加客服申请模型广场开白。有技术问题也可以联系客服进行解答。

分组不同可以设置在令牌管理那选择

第二步：WorkBuddy 添加自定义模型

打开 WorkBuddy，点左下角齿轮进设置，切到「模型管理」标签。
下滑找到「自定义模型」分区，点「添加模型」，提供商选 Custom（自定义）。
填三个核心参数，填错直接连不上：

参数	填什么	说明
接口 Base 地址	`https://moyu.info/v1`	必须带`/v1`，结尾不要多余斜杠
API 密钥	`sk-你的密钥`	从魔芋后台复制，前后别带空格换行
模型 ID	平台模型广场的完整名称	区分大小写，不能简写

4. 点保存。

第三步：重启生效（最容易漏的一步）

保存完不算完。必须右键托盘图标完全退出软件，再重新打开，配置才会加载。只关窗口的话它还挂在后台托盘，新配置不会出现在下拉列表里。这一步卡住了很多的新手。

第四步：在 WorkBuddy 里选用

重启后新建任务，顶部模型下拉框拉到最下面，自定义模型分组里选刚配的那个。正常建批量任务跑就行，全程不扣官方积分。跑完能在模型日志里看到调用记录，确认走的是外部 API。

避坑清单（实测过的）

接口地址少/v1：只填域名会 404。Base 地址必须是https://moyu.info/v1，直接复制别手敲。
没带 key：返回{"error":{"message":"未提供令牌 (request id: ...)","type":"moyu_api_error"}}。检查 WorkBuddy 里密钥字段是不是空的。
key 错了或失效：返回{"error":{"message":"无效的令牌 (request id: ...)","type":"moyu_api_error"}}。回魔芋后台重新生成一个，粘贴前清空输入框，别带空格换行。
模型 ID 写错：大小写、横杠严格对应平台展示名，简写或拼错会出现调用无返回。用上面那个/v1/models接口查准了再填。
配完没重启：见第三步，右键托盘彻底退出再开。
老版本改 JSON：没有图形界面时手动改models.json，别留末尾多余逗号，用 JSON 校验工具过一遍再存。