WorkBuddy 新手入门：从安装到交付第一份文件

一、先认识 WorkBuddy

这篇的目标：安装登录后，让 WorkBuddy 把四行笔记整理成文件，找到结果并完成一次修订。

WorkBuddy 是腾讯的桌面 AI 智能体。你给任务，它可以读取材料、调用工具、保存文件。只需先记住：任务是一段工作的对话，工作空间是使用的文件夹，产物是交付的文件。

按顺序走：安装登录 → 准备材料 → 新建任务 → 生成文件 → 核对修订。这次不需要写代码或预装技能。

二、下载安装

1. 选择安装包

1. 打开 WorkBuddy 官网，点击下载。
2. 根据下面的表格选择版本。
3. 下载完成后运行安装包，按向导完成安装并打开软件。

看“立即下载”下方的系统选项；Mac 芯片可在苹果菜单“关于本机”查看。

成功标志：打开 WorkBuddy，看到登录入口。

2. 可选：给 agent 一句话安装

已有能操作本机的 agent，可把下面这句发到它的聊天框：

请按 https://www.workbuddy.cn/ 官方指南检查我的系统和芯片，帮助安装匹配的 WorkBuddy 桌面版，保留已有配置并验证能打开；登录、付费及系统授权由我处理，安装后指导我新建练习工作空间。

这是任务提示词，不是终端命令。成功标志：它说明安装结果，并能打开客户端。 没有现成 agent 就按前两步手动做。

3. 完成登录

1. 点击客户端“登录”，在打开的官方页面验证账号。
2. 个人用户选择个人登录方式，完成后回到客户端。
3. 检查当前账号有没有可用模型和额度。

看窗口中间的“登录”；浏览器完成验证后，需要回到客户端继续。

成功标志：可以进入“新建任务”。 模型使用额度按账号页面显示，不等于下载安装免费就无限可用。

4. 先使用账号内的模型

1. 登录后点击“新建任务”，打开模型选择器。
2. 先选择账号当前可用的内置模型，发送“只回复：连接成功”。模型与额度以账号页面显示为准。
3. 收到回答后，可以直接进入下面的“四行笔记变成清单”练习。

成功标志： 不添加自定义提供商，也能通过账号可用的内置模型完成对话。如果希望使用 Orbis 的模型，再配置下一节；WorkBuddy 账号登录仍需保留。

三、可选：结合 Orbis API 使用

5. 准备 Orbis 密钥

1. 打开 DeepSeek V4.1 Flash 模型详情，选中 DeepSeek · 官方线路。
2. 点击“获取 Key”，登录 Orbis 后按页面流程创建并复制密钥，再查看“快速接入”。
3. 核对模型 ID 是 deepseek-v4.1-flash，密钥只填到软件的 API Key 栏。

成功标志：你手上有该线路的 Key，以及快速接入页给出的地址和模型 ID。 Key 绑定线路；只改模型名不能自动切换线路。账号额度、计费与可用状态以当前页面为准。

6. 添加自定义模型

1. 回到 WorkBuddy，打开“设置 → 模型 → 添加模型”。
2. 提供商选择 自定义 / Custom，按下表填写；Orbis Key 不代替 WorkBuddy 的账号登录。

看标号1“模型”和标号2“添加模型”；图中供应商是官方示例，接入 Orbis 时要改选 Custom。

看“接口地址”和“自定义协议”：开启后按原样请求，不再自动补路径，必须保留 /chat/completions。

3. 保存后回到新建任务，从自定义模型分组选择该模型。

成功标志：模型出现在选择器中。 保存不是连通性测试；下面的读写练习才验证这条线路能否完成任务。

四、第一次使用：四行笔记变成清单

7. 准备练习文件

1. 在桌面新建 WorkBuddy练习 文件夹。
2. 用记事本或纯文本编辑器，把以下材料存为 活动笔记.txt：

分享会的场地已确认。
报名表还需要检查重复报名，周四完成。
宣传海报已做好，但标题需要再检查一次。
现场签到由谁负责，还没有确定。

成功标志：文件夹里能打开这份文字。

8. 新建任务

• 回到 WorkBuddy，点左侧“新建任务”。
• 打开模型菜单，官方路线选择账号可用的内置模型；Orbis 路线在自定义模型分组选择 deepseek-v4.1-flash。

看左侧“新建任务”和中间输入框；选择与你所用路线对应的模型。

成功标志：出现可输入要求的新任务页面。

9. 选中工作空间

1. 点输入框下方“选择工作空间”。
2. 选择“打开本地文件夹”，找到桌面的 WorkBuddy练习。
3. 确认当前目录名与练习文件夹一致。

看菜单底部“打开本地文件夹”，这次选择已有练习目录。

成功标志：任务使用的是 WorkBuddy练习，而不是整个桌面。

10. 先让它读取

把这句发到输入框：

只读取当前工作空间的“活动笔记.txt”，用四条短句复述，不修改文件，不补充原文没有的信息。

成功标志：四项内容正确，且识别出“海报已做好，但标题仍要检查”。 如果找不到文件，先检查工作空间和文件实际名称。

11. 再让它保存

在同一任务继续发送：

整理为“已完成”“待办”“待确认”，保存到当前目录的“活动清单.md”。保留原文件；未写明的期限标“未说明”，不要推测，不向任何人发送消息。

• 保持默认 Agent 模式，让它执行文件操作。
• 出现权限提示时，看清读写对象是不是练习目录。

成功标志：生成 活动清单.md。 .md 是文本格式，用记事本也能打开。

12. 找到文件，完成验收

1. 点结果中的文件卡片，或右侧“产物”；也可直接打开练习目录。
2. 对照下面三项检查，发现问题就在原任务里修改。

看文件卡片与“查看所有产物”；这是另一项官方示例，你应找到 活动清单.md。

• 场地已完成；报名去重是待办，期限为周四。
• 海报制作已完成，但标题检查仍要保留。
• 签到负责人未定，不能擅自补一个人名。

可直接追加：“把海报制作和标题检查拆开，只修订清单。”

成功标志：文件通过检查，原笔记保持不变。

五、基本使用：选对工作模式

13. 区分问答、计划和执行

1. 点输入框左侧加号，打开“模式”。
2. 按任务选择；需要写文件时退出仅问答。

看“计划 Plan”和“仅问答 Ask”两个开关，关闭后回到默认模式。

成功标志：只想问问题时不改文件，要交付时能执行。 修改同一成果沿用原任务，换主题再新建任务。

14. 给材料定位，做局部修改

1. 在同一任务里明确引用 活动清单.md，不要只说“改一下”。
2. 发送：“只把待办部分改成复选框列表，其他段落和活动笔记.txt 保持原样。”
3. 打开产物对照，而不是只看回复里的完成提示。

成功标志：待办格式改变，其他信息不变。 如果换成另一场活动，另建任务并重新选材料，避免旧日期混入。

六、进阶使用：把任务拆开，再复用

15. 用 Plan 处理多份材料

1. 新建 补充说明.txt，写入：“海报标题由小陈检查；签到负责人仍未定。”
2. 通过加号菜单启用 Plan，发送下方要求。

阅读活动笔记.txt与补充说明.txt，先列出合并计划和需要我确认的信息。
目标是生成活动清单-v2.md，保留旧清单和两份材料。
先不要修改文件。

3. 核对计划：小陈只负责标题检查。确认后再让它执行；如当前停留在仅计划状态，切回默认 Agent。

成功标志：新清单补上标题负责人，签到仍待确认，旧版没有丢失。

16. 保存自己的整理规则

让它将下面四行保存为 清单规则.txt，以后先读取规则再处理新材料。

按已完成、待办、待确认分组。
一句话含多个状态时拆开记录。
没出现的人名与期限写“未说明”。
新建输出文件，保留所有输入材料。

成功标志：换材料后格式仍一致。 它是你主动引用的参考文件，不会仅因放进目录就自动生效；“周四完成”属于这次活动，不写入通用规则。

17. 按需使用技能

1. 从技能入口查看介绍，优先选与你当前文件任务直接相关的能力。
2. 使用前核对来源、读写范围与是否需要外部账号；一次只增加一种。
3. 对练习材料试用，打开产物复核；失败就回到已跑通的普通提示词。

成功标志：你能解释技能帮忙完成了哪一步，并能检查输出。 技能提供可复用方法，连接器负责接入外部资料，两者不必同时配置。

18. 重复任务先做一个本地草稿样本

• 先手动完成两次同类任务，确定输入目录、输出文件名、核对标准。
• 再考虑定时生成本地草稿：注明运行时间与时区，使用新文件名，禁止覆盖输入或发送给别人。
• 检查首次运行记录和文件；没有按预期交付就停用计划，修正后再启用。

成功标志：重复任务得到可检查的文件，而不是无人核对的外发消息。 运行条件以当前定时任务界面说明为准。

19. 用自己的小文件再验证一次

1. 将一份无敏感信息的短笔记复制进练习目录，改名为 我的笔记.txt。
2. 要求：“只读我的笔记.txt，引用其中两句原文，再列出待办；这次不要写文件。”
3. 亲自打开原文核对引用，并查看是否真的出现读取记录。

成功标志：引用与原文逐字对应，未编造内容，也未修改源文件。 通过后再尝试真实工作材料；不要把 API Key 或账号文件当测试素材。

七、常见问题速查

参考资料

更新日期：2026-10-22。

• 官方：安装、首次任务、模型配置、模式与工作空间。
• 结构参考：阿星 AI 工作室的 ima 教程与个人工作台教程。