📌 适用人群：职场办公人员、开发者、AI新手
💡 工具简介：WorkBuddy（腾讯CodeBuddy团队开发）桌面AI智能体，区别普通聊天AI，可在授权范围内读写本地文件、批量处理文档、执行多步骤任务，充当自动化办公助理。
官网：https://www.codebuddy.cn/work/

📌 本节学习目标

1. 完成客户端下载、安装、登录，避开新手常见报错
2. 看懂软件界面，分清三大运行模式安全边界
3. 学会配置工作区（最重要安全设置）
4. 独立完成第一条实操任务
5. 掌握标准指令写法、新手避坑清单

💡课前导读

普通AI只能给文字方案；WorkBuddy可以直接操作电脑文件：整理文件夹、合并Excel、解析PDF、生成代码文档。
⚠️ 重点安全提醒：不要开放全盘访问权限，只用独立文件夹作为工作区！

一、系统环境与安装步骤

硬件&系统要求

• Windows：Win10 / Win11
• macOS：macOS 12.0及以上（区分M芯片/Intel芯片安装包）

1.1 下载安装包

打开官网 下载安装workbuddy
系统自动识别设备，选择对应版本下载：

• Windows：WorkBuddySetup.exe
• macOS：WorkBuddy.dmg

1.2 Windows 详细安装流程

1. 找到安装包，右键 → 以管理员身份运行（关键！权限不足会导致文件操作失败）
2. 同意用户协议，尽量使用默认安装路径，不要使用中文文件夹路径
3. 勾选【创建桌面快捷方式】→ 立即安装
4. 安装结束，勾选【立即启动WorkBuddy】
5. 防火墙弹窗：允许专用/公用网络访问；杀毒软件提示，请添加信任。

❌常见坑：安装路径带中文、没有管理员运行 → 后续读写文件报错。

1.3 macOS 详细安装流程

1. 双击dmg镜像，将WorkBuddy拖拽至「应用程序」文件夹
2. 启动台找到软件，右键点击【打开】（不要直接双击）
3. 出现「无法验证开发者」弹窗：
   打开【系统设置】→【隐私与安全性】→下滑找到【仍要打开】
4. 首次启动完成授权。

二、登录与初始化设置

1. 启动软件，使用微信扫码登录，无需注册账号密码
2. 新用户福利：登录后前往个人中心领取新人积分（用于模型调用）
3. 建议开启【每日签到】，持续获取积分

2.1 什么是Workbuddy工作空间

工作空间是Workbuddy专属授权给AI读写操作的本地文件夹，相当于独立项目工位/项目文件夹。
核心作用：

1. 限定AI读取、修改、生成文件的范围，不会乱读取电脑全盘文件，保护隐私；
2. 统一存放项目所有素材、AI输出文档，解决文件找不到、新旧文件混淆、成果散落桌面的新手痛点；
3. 每个任务独立空间，不同项目数据互不干扰，多任务切换不混乱。

新手常见报错根源：未设置工作空间会出现「AI找不到素材、生成文件不知存在哪里、读取旧文档出错、任务上下文断裂」四大问题。

2.2 前期准备：基础权限与默认路径配置（首次使用必做）

步骤1：修改默认存储路径（避免C盘爆满）

1. 点击软件左上角个人头像；
2. 打开【设置】-【系统设置】；
3. 找到「默认工作空间存储路径」；
4. 将路径从系统默认C盘，修改至D盘/E盘空余分区，推荐路径示例：D:\Workbuddy项目文件\。

步骤2：授权允许AI访问目标文件夹

1. 设置页面找到【文件夹管理】；
2. 点击【添加文件夹】；
3. 选中你提前建好的项目文件夹，确认授权；

安全提示：只授权当前工作需要的目录，不要全盘授权，授权越少AI检索速度越快、隐私风险越低。

规范建文件夹命名（UP主推荐标准）

按项目/业务分类独立创建，禁止练习文件与正式项目混放：

• 练习测试：Workbuddy新手练习文件夹
• 业务项目：2026Q3客户方案、零部件DV问题整理、周报归档、发票分类整理

2.3 3种方式新建/切换工作空间（实操步骤）

方式1：全局默认工作空间（长期固定项目）

完成上面「默认路径+文件夹授权」后，所有新建任务会自动使用该目录，适合长期固定办公场景。

方式2：新建任务时临时指定工作空间（单次专项任务）

1. 在软件中间对话输入框左下角，点击文件夹图标【选择工作空间】；
2. 弹窗可选两种模式：
   • 从新工作空间开始：自动生成全新空白目录；
   • 打开本地工作空间：选择已授权的现有项目文件夹；
3. 选中目录后确认，本次对话任务仅在该文件夹读写文件。

方式3：侧边栏快速切换已有工作空间

左侧任务列表会按工作空间分组，点击分组名称即可切换对应项目空间，历史生成文件全部保存在对应目录，一键查看历史成果。

2.4 搭配任务实操：工作空间完整使用流程

1. 提前把本次需要AI处理的Excel、Word、图片等素材，移入选定的工作空间文件夹；
2. 选择对应工作空间；
3. 在对话框输入自然语言任务指令（无需专业代码），示例：
   • 帮我整理文件夹内所有销售数据，生成季度分析报告；
   • 根据文件夹里的会议纪要，生成标准化PPT；
4. AI执行任务后，所有产出文件自动保存至当前工作空间；
5. 右侧结果面板可直接预览、导出、二次修改，文件同步存在本地文件夹。

2.5 工作空间配套使用技巧（UP主避坑总结）

1. 文件引用快捷指令
   对话内输入@+文件夹名可直接调用整个目录素材；输入@文件名.xlsx单独调取单个文件，AI读取速度大幅提升。
2. 三种运行模式搭配空间使用

• Craft（直接执行）：简单文档撰写、表格整理，搭配单一工作空间快速出稿；
• Plan（分步规划）：复杂数据分析、长篇方案，独立新建工作空间存放多版本草稿；
• Ask（仅查询）：只读取文件、不修改内容，可临时选择只读文件夹，避免误改原文件。

1. 多项目管理规范
   每个业务项目单独创建独立工作空间，不共用文件夹；项目结束后可直接备份整个文件夹归档，清理软件内任务列表不丢失本地文件。

三、界面讲解 & 三大运行模式（新手必看懂）

左侧导航栏

• 新建会话：开启独立任务
• 会话列表：保存历史任务上下文
• Claw连接器：微信/飞书远程下发任务（进阶功能）
• 技能市场：安装扩展能力（Excel处理、PDF解析、周报生成等）
• 设置：模型切换、权限、快捷键

三大执行模式（安全等级区分）

输入框上方切换模式，新手优先按照风险选择：

1. Ask 问答模式【最安全｜新手首选】
   仅读取文件、文字问答，不会修改、新建任何本地文件。
   ✅适用：文档总结、代码解释、方案咨询、需求梳理。

2. Plan 规划模式【中等风险】
   AI先输出完整执行方案预览，需要你手动确认，才会执行文件操作。
   ✅适用：文件整理、批量重命名、数据处理、复杂多步骤任务。

3. Craft 执行模式【高风险】
   收到指令直接自动操作文件，无需二次确认。
   ⚠️熟悉软件后再使用，不要随便交给陌生任务！

四、第一个实操任务（跟着复制操作）

任务目标

读取 01-input 内一份会议记录txt，整理标准会议纪要，保存到03-output

步骤1：切换模式

新手选择 Plan模式（先预览方案，确认后执行）

步骤2：输入标准化指令（直接复制参考）

你是办公助理，当前工作区为绑定文件夹。
任务：读取01-input内【会议记录.txt】
输出规范会议纪要，结构：
1.会议主题 2.参会人员 3.核心结论 4.待办事项（负责人+截止时间）
不要修改原始文件，生成文档保存至03-output，文件名：会议纪要.md
执行前先向我展示方案，等待我确认再操作。

步骤3：发送指令，观察流程

1. AI自动扫描工作区文件
2. 输出执行方案预览
3. 你回复【确认执行】
4. 自动生成文档，存入output文件夹

📝指令优化小技巧（承接提示词工程理论）

好指令四要素：角色 + 任务 + 约束 + 输出格式
❌差指令：帮我整理会议记录
✅标准指令：角色+文件路径+结构要求+保存位置

五、常用基础实战场景模板

场景1：文件批量整理

Plan模式执行
读取01-input文件夹内所有文件，分析文件类型。
输出预览表格：原文件名、建议新名称、文件类型。
等待我确认后，再统一重命名，不要直接改动文件。

场景2：Excel数据合并

读取01-input下所有.xlsx文件，合并全部表格；
统一表头字段，去除重复数据；
最终结果保存至03-output/合并结果.xlsx
先展示数据预览，确认后执行。

场景3：开发者场景｜代码文档生成

你是后端开发工程师，读取01-input下Controller源码；
生成接口API文档，使用Markdown格式；
包含请求地址、请求方式、入参、返回示例；
输出保存到03-output/api文档.md

六、新手高频问题 & 避坑指南

🔴权限类问题

1. AI提示无法读取文件
   ✅解决：管理员启动软件、工作区路径无中文、文件夹权限放开。
2. 担心误删文件
   ✅解决：长期使用优先Plan模式；重要文件先备份；禁止使用Craft处理核心资料。

🟡指令效果问题

1. AI找不到文件
   ✅必须写相对路径（01-input/xxx.txt），不要只写文件名。
2. 输出内容残缺
   ✅补充约束：明确格式、输出存放位置、不要省略关键信息。

🟢积分与模型

软件内置多款大模型：混元、DeepSeek等；

• 文案、办公总结：通用模型
• 代码开发：代码专项模型
  模型越强大，积分消耗越高，可以按需切换节省额度。

七、进阶方向预告

1. Claw连接器：绑定微信，手机远程向电脑下发任务
2. 技能市场：安装自动化技能，定时生成周报、报表
3. 自动化流程：搭建重复任务工作流，一键执行
4. 结合提示词工程：编写长期生效的Agent角色提示词