快速上车 — 3步开始用

第一次用 WorkBuddy？按这3步来，大约5分钟。

---

第1步：安装 WorkBuddy

下载安装 WorkBuddy →

Mac 和 Windows 版本都在下载页面。安装完成后用微信扫码登录。

装好打不开？

• Mac：系统设置 → 隐私与安全性 → 找到 WorkBuddy → 点击「仍要打开」
• Windows：检查安全软件是否拦截，加白名单后重试

---

第2步：接入西瓜 AI Hub 模型

WorkBuddy 安装后没有 AI 能力，需要连接公司的模型服务。整个过程只需要3步，WorkBuddy 自动完成配置。

做法：把配置文档交给 WorkBuddy，它来完成剩下的

第一次配置（全新安装）：

1. 先连接公司内网（公司 WiFi xigua-sec，或在外使用 VPN）
2. 打开浏览器，访问 https://aihub.xiguacity.cn/，登录账号
3. 进入「我的API」→ 创建或选择已有的 API-KEY → 申请以下4个模型的权限：
   • deepseek-v4-flash · deepseek-v4-pro · gemini-3.1-pro-preview · gemini-3-flash-preview
4. 复制 API-KEY
5. 下载配置文档，拖入 WorkBuddy 对话框，发送这句话：

这是西瓜 AI Hub 的模型配置文档，请按文档完成配置。
我的 API Key 是：[粘贴你的Key]

WorkBuddy 会自动配好4个模型和路由规则，完成后告诉你。

已有配置（换设备/重装）：

直接下载配置文档拖入 WorkBuddy，它会自动检测本地已有的 Key，无需再提供。

⬇ 下载模型配置文档

下载后拖入 WorkBuddy 对话框即可，AI 自动完成配置。

---

配置好之后你有什么？

配置完成后，WorkBuddy 接入了4个模型，分工如下：

模型显示名称	角色定位	如何触发
Deepseek v4 Flash	日常主力，速度快、成本低	手动选择
Deepseek v4 Pro	深度思考，适合复杂任务	手动选择
Gemini 3.1 Pro	子代理推理任务（深度思考路由目标）	自动路由，无需操作
Gemini 3 Flash	后台子代理默认模型	自动路由，无需操作

手动 vs 自动，一句话说清楚：

• 手动：你在对话框顶部选哪个模型，AI 就用哪个。平时选 Flash，复杂任务换 Pro。
• 自动：AI 在后台分发多步骤子任务时，会自动调用 Gemini 系列模型，不需要你介入。

对话框左下角的三个模式控制权限，不控制模型：

模式	权限范围	什么时候用
Craft	可读写文件、执行命令	写东西、改文件、完成具体任务
Plan	只规划、不执行	复杂分析、多步规划、先看方案再动手
Ask	纯对话，不操作文件	轻量提问、问信息、头脑风暴

切换 Craft / Plan / Ask 不会自动切换模型，底层始终使用你手动选定的模型。

关于 relatedModels 路由（进阶说明）

配置文件中为 Deepseek 两个模型设置了 relatedModels 字段，这是 WorkBuddy 特有的路由机制：当 Agent 工具内部指定 model: "lite" 或 model: "reasoning" 时，系统会据此自动跳转到对应模型。

此字段目前官方文档尚未收录，属于 WorkBuddy 扩展配置。已配置好，随软件版本完善后会自动生效，现在无需重新操作。

---

第3步：放入你的工作场景配置包

配置包告诉 AI 你在哪个公司、做什么工作、习惯什么风格。放进去后 AI 会自动了解你的背景。

1. 在工作场景页面找到你的场景，下载对应的 .zip 文件（默认保存到 ~/Downloads/）
2. 打开 WorkBuddy，把下面这句话发给它：

我下载了工作场景配置包，文件在 ~/Downloads/[文件名].zip，请帮我完成配置。

WorkBuddy 会自动解压、放置文件，逐步引导你填写姓名、岗位、工作背景等信息，确认后重启即可。

文件名怎么填？

下载的文件名类似 quality-config-pack.zip、marketing-config-pack.zip，把你下载的文件名直接替换进去发送就行。

---

完成！现在可以开始了

从一个真实的工作任务开始，不需要「练习」——直接把你今天要做的事情告诉它：

我桌面上有5个部门的费用表，格式不一样，
帮我整合成一份统一格式的汇总，标出超预算的项目

输出不满意？直接说「太啰嗦」「换成表格」「语气更正式」，不用重新开始。