> ## Content Index
> Fetch the complete content index at: https://orbiorbi.com/news/llms.txt
> Use this file to discover other available public pages before exploring further.

# WorkBuddy 新手入门：从安装到交付第一份文件
- URL: https://orbiorbi.com/news/workbuddy-xinshou-rumen/
- Published: 2026-10-21T20:54:26.000Z
- Updated: 2026-10-21T20:54:26.000Z
- Description: 第一次用 WorkBuddy，不必先研究插件或远程控制。本文从官方下载安装开始，用一份可直接复制的笔记，带你完成新建任务、选择工作空间、生成文件与检查结果，再逐步使用计划模式和技能。
- Author: Orbis News
- Tags: API 接入与排障, #model:deepseek-v4.1-flash

## 一、先认识 WorkBuddy

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

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

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

## 二、下载安装

### 1\. 选择安装包

1. 打开 [WorkBuddy 官网](https://www.workbuddy.cn/?ref=orbiorbi.com)，点击下载。
2. 根据下面的表格选择版本。
3. 下载完成后运行安装包，按向导完成安装并打开软件。

| 电脑        | 选择与要求                            |
| --------- | -------------------------------- |
| Windows   | Windows 10 及以上，x64；ARM64 看当前兼容说明 |
| Mac M 系列  | macOS 12 及以上，ARM64 包             |
| Intel Mac | macOS 12 及以上，x64 包               |

![WorkBuddy 官网的下载选项](https://orbiorbi.com/news/content/images/2026/10/01--------------1.png)

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

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

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

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

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

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

### 3\. 完成登录

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

![WorkBuddy 客户端登录界面](https://orbiorbi.com/news/content/images/2026/10/02-------.png)

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

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

### 4\. 先使用账号内的模型

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

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

## 三、可选：结合 Orbis API 使用

### 5\. 准备 Orbis 密钥

1. 打开 [DeepSeek V4.1 Flash 模型详情](https://orbiorbi.com/pricing/deepseek-v4.1-flash?catalogKey=model%2F129&ref=orbiorbi.com)，选中 **DeepSeek · 官方线路**。
2. 点击“获取 Key”，登录 Orbis 后按页面流程创建并复制密钥，再查看“快速接入”。
3. 核对模型 ID 是 `deepseek-v4.1-flash`，密钥只填到软件的 API Key 栏。

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

模型

[DeepSeek V4.1 Flash](https://orbiorbi.com/pricing/deepseek-v4.1-flash?catalogKey=model%2F129&ref=news-workbuddy-xinshou-rumen)`deepseek-v4.1-flash`

查看 Orbis 线路、工具调用能力标注及 API 接入信息。

体验

### 6\. 添加自定义模型

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

![WorkBuddy 设置中的模型与添加模型入口](https://orbiorbi.com/news/content/images/2026/10/07-------------.png)

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

| 表单字段             | 本文填写值                                        |
| ---------------- | -------------------------------------------- |
| 提供商              | 自定义 / Custom                                 |
| 接口地址             | https://api.orbiorbi.com/v1/chat/completions |
| API KEY          | 刚才获取的 Orbis Key                              |
| 模型名称             | deepseek-v4.1-flash                          |
| 高级配置：工具调用        | 勾选，后续用实际文件任务验收                               |
| 高级配置：自定义协议       | 勾选，按上面的完整 URL 发请求                            |
| 图片输入、推理模式、输入输出长度 | 初次练习先不额外改动；按线路明确支持的参数再配置                     |

![WorkBuddy Custom 自定义模型完整配置表单](https://orbiorbi.com/news/content/images/2026/10/09----------------.png)

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

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

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

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

### 7\. 准备练习文件

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

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

```

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

### 8\. 新建任务

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

![WorkBuddy 新建任务入口和输入框](https://orbiorbi.com/news/content/images/2026/10/03-------------.png)

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

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

### 9\. 选中工作空间

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

![WorkBuddy 工作空间选择菜单](https://orbiorbi.com/news/content/images/2026/10/04-------------.png)

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

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

### 10\. 先让它读取

把这句发到输入框：

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

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

### 11\. 再让它保存

在同一任务继续发送：

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

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

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

### 12\. 找到文件，完成验收

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

![WorkBuddy 官方任务示例中的文件卡片和产物入口](https://orbiorbi.com/news/content/images/2026/10/05-------------.png)

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

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

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

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

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

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

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

![WorkBuddy 的计划与仅问答模式菜单](https://orbiorbi.com/news/content/images/2026/10/06-------------.png)

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

| 模式       | 用来做什么             |
| -------- | ----------------- |
| Ask 仅问答  | 理解材料、讨论思路，不执行文件操作 |
| Plan 计划  | 先出方案，确认后执行多步任务    |
| Agent 默认 | 目标明确时直接调用工具完成任务   |

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

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

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

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

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

### 15\. 用 Plan 处理多份材料

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

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

```

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

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

### 16\. 保存自己的整理规则

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

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

```

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

### 17\. 按需使用技能

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

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

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

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

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

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

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

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

## 七、常见问题速查

| 现象              | 先检查                        |
| --------------- | -------------------------- |
| 登录成功但客户端没变化     | 返回客户端，必要时重新发起登录            |
| 找不到文件           | 工作空间、文件名，是否多了 .txt 后缀      |
| 只有回答，没有文件       | 是否在 Ask 模式，是否明确要求保存        |
| 内容不对            | 引用原文指出具体错误，让它局部修订          |
| 401 / 模型不可用     | Orbis Key是否有效、绑定线路、模型ID与余额 |
| 404 / 只有文字不会读文件 | 完整接口地址、自定义协议开关、工具调用选项及线路能力 |
| 反复执行同一步         | 停止请求，缩小任务再试                |

## 参考资料

更新日期：2026-10-22。

- 官方：[安装](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide?ref=orbiorbi.com)、[首次任务](https://www.workbuddy.cn/docs/workbuddy/FirstTask?ref=orbiorbi.com)、[模型配置](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model?ref=orbiorbi.com)、[模式与工作空间](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Task-Bar?ref=orbiorbi.com)。
- 结构参考：阿星 AI 工作室的 [ima 教程](https://sspai.com/post/113046?ref=orbiorbi.com)与[个人工作台教程](https://sspai.com/post/113066?ref=orbiorbi.com)。