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 和模型名称；可用模型、接口格式和调用限制以服务文档为准。
本文在演示 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 才会从一个聊天窗口，变成一个可以长期复用的办公与轻量开发助手。
