WorkBuddy精选教程：国内普通人最快上手Agent

WorkBuddy 实战指南：从安装到深度使用，一篇讲透

先说几个核心判断：WorkBuddy 这种工具，本质上解决的是两类问题。一类是文档、表格、邮件、PPT 这些日常办公任务；另一类是网页、小工具、脚本这类轻量开发任务。

如果你不想把大量时间花在配置环境上，又希望 Agent 能直接读取本地文件、生成文档、调用连接器、甚至远程帮你处理任务，那这篇教程可以直接照着走。

内容会按「安装登录 → 界面设置 → 模型配置 → 专家/技能/连接器 → 办公实战 → 开发实战 → 远程控制 → 排错避坑」的顺序展开。

1. 安装与登录：先把客户端跑起来

结论先说——WorkBuddy 的上手门槛，其实不在于功能多复杂，而在于「选对版本、登录成功、授权完整」这三件事。

官网地址是：workbuddy.cn

进入官网后，按自己的系统下载客户端。目前常见流程是：选择 Windows 或 macOS 版本，下载完成后正常安装，打开客户端，选择登录方式，完成授权后进入主界面。

登录这一步，如果只是个人使用，直接按客户端提示完成即可。如果登录页卡住，先排查这几项：客户端是否为官网最新版、系统时间是否准确、浏览器或微信是否能正常打开授权页、公司网络是否限制了登录验证、macOS 是否拦截了客户端网络权限。

版本和权益以客户端页面展示为准。个人用户可以先拿基础能力跑几个小任务，再判断是否需要更高规格；企业用户则更应该关注权限、数据边界、团队协作和管理能力。

2. 认识主界面：先搞懂每个区域干什么

WorkBuddy 的主界面可以拆成三块：对话区、任务区、功能区。新手最容易踩坑的地方，往往不是不会提问，而是不知道当前处在哪个工作模式。

中间是主要对话区，这里一般可以切换三类场景：

• 代码开发：适合网页、脚本、工具、小型项目。
• 日常办公：适合文档处理、数据分析、研究报告、幻灯片。
• 设计创意：适合页面设计、原型、品牌物料、PPT 结构。

不同场景下面会出现不同的快捷模板。比如切到代码开发，会看到日常开发、网站开发、Agent 应用、Skill 开发等入口。

切到日常办公，入口会变成文档处理、数据分析及可视化、深度研究、幻灯片等。

切到设计创意，则会出现网站设计、移动端 App、PPT 设计、交互原型、品牌设计等模板。

模板不是必须用，但新手建议先从模板开始。点进「文档处理」这类模板后，通常会展开更细的提示词，你只需要替换文件、目标、格式要求和输出结构。

3. 工作模式与模型：Ask、Plan、Craft 怎么选

WorkBuddy 的工作模式很重要，建议一开始就养成切换习惯。常见模式可以这样理解：

• Ask：只问答，不主动执行复杂任务。
• Plan：先拆计划，再等你确认后继续。
• Craft：进入 Agent 执行模式，会开始读文件、生成内容或调用工具。

如果只是问一个概念，用 Ask。如果你还没想清楚任务边界，用 Plan。如果你已经准备好让它动手处理文件、生成项目、产出报告，用 Craft。

这里有个实用建议：复杂任务不要一上来就用 Craft。比如你要它整理一份周报，可以先用 Plan 让它列出分析维度：
请先不要生成报告，先根据我上传的数据，列出你准备分析的指标、报告结构和可能需要补充的信息。确认计划没问题后，再让它继续执行。

模型选择上，WorkBuddy 内置的模型会随产品更新而变化。你需要关注三件事：当前任务更偏写作、分析、代码还是多模态；不同模型的积分消耗是否符合任务价值；输出质量是否稳定满足你的业务要求。

如果不知道怎么选，可以先用默认推荐模型跑一遍，之后再拿同一个任务对比不同模型的输出质量、执行时间和消耗情况。

4. API Key 与模型服务配置：外部模型怎么接

如果你有自己的模型服务，也可以在 WorkBuddy 里尝试接入外部模型。这类配置一般要看三个字段：API Key（用于鉴权）、Base URL（模型服务地址）、Model（具体模型名称）。

入口通常在设置里的模型页面。点击设置后，进入模型配置，再选择添加模型。

如果工具支持 OpenAI Compatible API，就可以按服务文档填写对应字段。这里不要只复制别人给你的模型名。不同服务的模型命名、接口路径、鉴权方式可能都不一样，必须以服务文档为准。

本文在演示 WorkBuddy 外部模型接入时，使用 iThinkAPI 作为配置环境示例。由于 WorkBuddy 支持 OpenAI Compatible API 配置方式，实际填写时重点核对 API Key、Base URL 和模型名称；可用模型、接口格式和调用限制以服务文档为准。

Base URL：https://token.ithinkai.cn/v1
API Key：YOUR_API_KEY
Model：以服务文档为准

配置完成后，建议用一个低风险任务测试，例如：请用 200 字总结一下 WorkBuddy 适合处理哪些办公任务。如果报错，按下面顺序排查：API Key 是否多复制了空格；Base URL 是否包含正确版本路径；Model 名称是否和服务文档一致；当前模型是否支持对话接口；账号或服务是否具备对应权限；WorkBuddy 是否需要重启后刷新模型列表。

5. 工作空间与文件：别让任务结果散得到处都是

WorkBuddy 的工作空间可以理解成项目文件夹。它决定了 Agent 读取哪些文件、把结果保存到哪里、后续任务是否能接着上下文继续处理。

建议按任务类型建立目录，而不是所有内容都丢在默认目录里。可以这样分：

WorkBuddy/
├── weekly-report/
├── ppt-outline/
├── website-demo/
├── data-analysis/
└── client-docs/

选择工作空间后，WorkBuddy 会基于该目录读取和处理文件。

如果一开始没选，也可以先创建任务，再把结果保存到工作空间。

这里容易踩坑：不要把包含隐私、财务、客户合同的整个大目录直接交给 Agent。更稳妥的做法是：复制一份任务所需文件到独立目录，删除无关敏感文件，明确告诉 WorkBuddy 只能处理指定文件，重要文件处理前先备份。例如：请只读取当前工作空间中的 data.xlsx 和 brief.md，不要处理其他文件。请输出一份周会汇报 Markdown，并把图表建议单独列出来。

6. 专家、技能、连接器：三者不要混着用

WorkBuddy 里有三个容易混淆的能力：专家、技能、连接器。一句话区分：专家是封装好的垂直角色，技能是可复用的任务能力，连接器是连接外部服务或数据源。

专家：适合复杂垂直任务

专家更像一个已经设好角色、知识范围和执行习惯的 Agent。比如你要做小程序，可以找小程序相关专家；要做市场分析，可以找行业研究类专家。

使用专家时，提示词不要只写「帮我做一个方案」。更建议这样写：
你现在作为产品专家，帮我评估一个知识库产品的 MVP 方案。背景：- 面向 20 人以内的小团队- 主要解决文档沉淀和搜索问题- 预计 4 周内做出可用版本。请输出：1. 核心用户场景 2. 首版功能清单 3. 不建议第一版做的功能 4. 风险点和验证方式

专家团适合多角色协作，但消耗也会更高。如果任务只是写一份周报、改一篇文档、生成一个页面，用单个专家或普通对话就够了。

技能：适合重复任务

技能适合封装高频工作。比如你每周都要生成运营周报，就可以把固定流程做成技能：读取数据表、计算关键指标、找异常波动、生成汇报文案、给出下周建议。

创建技能时，不要只描述结果，要描述输入、处理步骤和输出格式。可以这样写：
我想创建一个公众号数据周报技能。输入：- 一份 Excel 数据表- 一段本周重点动作说明。处理：- 统计阅读、分享、收藏、关注变化- 找出表现最好的 3 篇内容- 找出异常波动并解释可能原因。输出：- Markdown 周报- 3 条下周选题建议- 1 段适合周会口播的总结

连接器：适合打通外部服务

连接器更像 WorkBuddy 和外部工具之间的桥。例如邮箱、文档、会议、知识库等服务，都可以通过连接器接进来。

配置连接器时要特别注意权限边界。建议遵循三个原则：只授权当前任务需要的服务，不要给不必要的写入权限，涉及发送邮件、删除文件、提交表单时，要求它先确认。比如邮箱连接器配置好后，可以这样下指令：
请搜索最近 7 天来自财务的邮件，只汇总标题、时间和待办事项。不要发送邮件，不要删除邮件，不要标记已读。如果确实要发邮件，也建议让它先生成草稿：
请根据这份文件生成一封邮件草稿，先展示给我确认。我确认后，你再调用邮箱连接器发送。

7. 设置建议：这些开关建议先检查

正式使用前，建议进设置页走一遍。重点看四类设置：系统设置、系统授权、对话记忆、个性化指令。

系统设置里，如果会长期使用技能，可以打开技能自动更新。如果经常让 Agent 跑长任务，需要确认电脑不会中途休眠。

系统授权里，按实际需要打开文件、辅助功能、通知等权限。如果权限不完整，可能会出现这些情况：无法读取本地文件、无法打开目标目录、无法调用某些系统能力、远程任务执行到一半中断。

对话记忆适合长期使用者。它会记录你的偏好、常用格式和工作习惯，但如果你处理的是敏感项目，建议先理解记忆范围和删除方式。

个性化指令很关键。它相当于你给 Agent 写的长期工作规范。

可以直接放一个简洁版：
工作准则：1. 执行任务前先确认目标、输入文件和输出格式。2. 不确定时先提问，不要自行假设关键事实。3. 默认使用最简单方案，不做超出需求的扩展。4. 修改文件前先说明会改哪些文件。5. 重要操作前先让我确认，尤其是删除、覆盖、发送、发布。6. 输出内容要结构清晰，优先使用列表、表格和可执行步骤。7. 如果任务失败，请说明失败原因、已尝试步骤和下一步建议。

如果你主要用它做开发，可以再加几条：
开发任务准则：1. 先阅读项目结构，再决定修改方案。2. 尽量小步修改，不重构无关代码。3. 修改后说明测试方式。4. 如果没有测试环境，明确列出人工验证步骤。

8. 办公实战：生成一份周会数据报告

办公任务最适合用 WorkBuddy 入门，因为输入明确、输出可检查。这里用「根据公众号数据生成周会报告」举例。

步骤如下：切换到日常办公，选择工作空间或上传数据文件，选择合适模型，写清楚报告目标，让它先优化提示词或先出结构，确认后执行，检查生成文件和数据口径。

也可以直接点对话框右侧加号上传文件。

提示词可以这样写：
请基于我上传的公众号数据，生成一份周会汇报报告。目标：- 给团队复盘上周内容表现- 找出表现最好的内容类型- 给出下周选题和发布建议。要求：1. 先检查数据字段，并说明你会使用哪些指标。2. 输出 Markdown 报告。3. 包含核心结论、数据概览、亮点内容、异常波动、下周建议。4. 所有结论必须能对应到数据，不要编造原因。5. 如果数据不足，请明确指出缺少哪些字段。

如果界面里有「优化提示词」按钮，可以点一下，让它把需求整理得更结构化。

结构化提示词通常会让输出更稳。尤其是数据分析、报告生成、PPT 大纲这类任务，最好提前规定输出结构。

执行过程中，界面会显示 Todo，你可以看到它正在做哪一步、下一步准备做什么。

完成后，右侧栏可以查看产出文件，也可以打开文件夹检查结果。

检查报告时，不要只看文案是否顺。重点核对：指标名称有没有认错，环比、同比口径是否正确，是否把缺失数据当成 0，是否把相关性写成因果关系，建议是否能落到具体动作。你可以继续追问：请逐条列出报告中的结论，并标注每条结论对应的数据来源。如果某条结论只是推测，请单独标记出来。

9. 开发实战：做一个功能介绍网页

WorkBuddy 也能处理轻量开发任务。它更适合做网页 Demo、小工具、脚本、页面改版、原型验证，不建议一开始就把大型复杂工程全交给它。

先切换到代码开发模式。

选择网站开发。

需求不要只写「做得好看一点」。更推荐这样写：
请帮我做一个 WorkBuddy 功能介绍网页。页面目标：- 面向第一次了解 WorkBuddy 的用户- 解释它能做哪些办公和轻量开发任务- 页面风格简洁、清晰、偏产品官网风。内容模块：1. Hero 区：一句话价值主张 2. 三个核心场景：办公、开发、远程控制 3. 功能卡片：专家、技能、连接器、工作空间 4. 使用流程：安装、登录、选择模式、执行任务 5. 常见问题。技术要求：- 生成一个可本地打开的 HTML 页面- CSS 写在同一个文件里- 不依赖后端服务- 移动端也要可读

如果你担心它直接开工，可以用 Plan 模式先让它出方案。

当它追问页面风格、内容重点、技术栈时，不要嫌麻烦。这些问题回答得越具体，第一次生成结果越接近预期。

生成完成后，右侧可以预览，也可以在浏览器里打开。

如果第一版视觉风格不满意，不要说「再高级一点」，这种反馈太抽象。可以具体改：
请优化当前页面视觉风格：1. 减少高饱和紫色。2. 背景改为浅色，主体内容更清爽。3. 卡片间距加大，标题层级更明显。4. 按钮只保留一个主色。5. 移动端首屏不要太长。6. 不改页面文案结构，只优化 CSS 和布局。

如果你有前端开发相关技能，也可以调用对应技能继续优化。

优化后再看预览效果。

开发任务的检查清单建议固定下来：页面能否本地打开、控制台有没有报错、移动端是否错位、图片/字体/按钮是否正常、生成文件是否在预期目录、是否误改了无关文件。如果要部署上线，务必让它先说明部署步骤和会操作的文件，不要让 Agent 在你没确认的情况下改服务器配置、覆盖线上目录或删除文件。

10. 远程控制：人在外面也能处理电脑任务

远程控制适合处理「电脑里有文件，但人不在电脑前」的场景，比如把电脑里的文件发给同事、查询本地目录中的资料、生成一份临时文档、继续一个已经在电脑上跑的任务。

打开功能区里的助理。

进入设置后，按提示打开对应开关。

连接成功后，界面会显示已连接状态。

手机端通常会有两类工作方式：云端工作（任务在云端环境执行，不依赖本地电脑一直操作）和连接电脑（远程使用本地电脑能力，适合读取本地文件）。

一个典型场景是：你在外面，需要把电脑里某份文件发给财务。如果你已经配置好邮箱连接器，可以这样说：请在我的电脑工作空间中查找「6月报销汇总.xlsx」。找到后先确认文件路径和文件大小，不要立即发送。我确认后，再帮我发送给财务邮箱。如果没有配置邮箱连接器，也可以让它把文件发到小程序对话里，再由你手动处理。

远程控制的核心不是炫技，而是降低临时任务的等待成本。但涉及发送、删除、覆盖、提交这类动作，一定要保留人工确认。

11. 常见问题与排错：出问题先看这里

WorkBuddy 用起来不复杂，但 Agent 类工具常见问题比较集中。下面这些排查路径建议收藏。

任务跑偏了怎么办

先暂停，不要连续追加模糊指令。改成让它复述任务：请暂停执行，先复述你理解的任务目标、输入文件、输出格式和下一步动作。如果理解错了，再修正边界：你的理解有两点需要修正：1. 只处理 data.xlsx，不处理其他文件。2. 输出 Markdown 报告，不生成 PPT。请基于这两个要求重新制定计划。

文件读不到怎么办

优先检查：是否选了正确工作空间、文件是否在当前目录下、文件名是否包含特殊符号、客户端是否有文件访问权限、文件是否被其他软件占用。可以让它列目录：请列出当前工作空间下的文件结构，并告诉我你能读取哪些文件。

输出质量不稳定怎么办

不要只换模型，先优化输入。高质量提示词至少包含：背景、目标、输入文件、输出格式、评价标准、禁止事项。比如：请不要泛泛总结。每个建议必须包含依据、动作、负责人角色和预期结果。如果依据不足，请写「数据不足，无法判断」。

积分消耗过快怎么办

先看是不是模式用错了。常见原因：本来只是问答，却用了 Craft；简单任务调用了专家团；大文件反复上传和分析；让它多轮生成无关版本；没有先用 Plan 控制任务范围。建议策略：问答用 Ask，不确定用 Plan，执行用 Craft，大任务先拆小，每轮只改一个目标。

外部模型配置失败怎么办

按顺序检查：API Key 是否有效、Base URL 是否和文档一致、Model 名称是否拼写正确、当前模型是否支持所需接口、服务是否有访问权限、WorkBuddy 是否保存并启用了该模型。不要把不同平台的 Base URL、模型名和 Key 混着用。

远程控制断开怎么办

常见原因是电脑休眠、网络变化或权限不足。可以检查：电脑是否仍然开机、客户端是否仍在运行、是否开启防休眠相关设置、手机端是否登录同一账号、本地网络是否临时断开、系统权限是否被更新后重置。

12. 使用建议：把它当执行助手，不要当全自动黑盒

WorkBuddy 的价值在于把办公流和轻量开发流串起来。更适合它的任务包括：资料整理、数据报告、周报月报、PPT 大纲、邮件草稿、网页 Demo、简单脚本、文件归档、多工具协作。

不建议直接交给它的任务包括：高风险线上操作、涉及敏感数据的大目录处理、没有测试的大型代码改造、需要强审计的财务/人事/法务决策、你自己也说不清验收标准的任务。

一个好用的工作流是：Ask 问清楚思路 → Plan 拆解步骤 → Craft 执行任务 → 人工检查关键结果 → 把高频流程沉淀成技能 → 用连接器接入常用工具。

如果你刚开始用，不要追求一次让它完成所有事。先从一个小任务开始：整理一份文档、生成一份报告、做一个网页、发一封草稿邮件。跑通后，再逐步把固定流程沉淀下来。

写在最后

WorkBuddy 更适合解决真实办公里的重复任务：读文件、写报告、整理数据、生成页面、调用连接器、远程处理临时需求。它不是让你完全放弃判断，而是把你从大量机械步骤里解放出来。

真正用好 Agent 的关键，是把任务说清楚、把权限控住、把结果验收好。如果你是第一次上手，可以按这条路线练习：

安装登录 → 设置权限 → 选择工作空间 → Ask 提问 → Plan 拆任务 → Craft 执行 → 检查结果 → 固化技能

把这条链路跑通后，WorkBuddy 才会从一个聊天窗口，变成一个可以长期复用的办公与轻量开发助手。