如果你想试试能直接处理本地文件、生成文档和执行多步骤任务的国产 AI Agent，WorkBuddy 是一个比较容易上手的入口。这篇教程按新手最容易卡住的顺序，讲清楚下载安装、任务模式、模型选择、自定义模型、工作空间和权限设置。
本文适合第一次使用电脑端 Agent 的普通用户。如果你准备把重要文件直接交给 AI 全自动处理，却不打算备份和检查结果，这种用法风险太高。
WorkBuddy 是什么
WorkBuddy 是腾讯推出的全场景 AI 办公工作台。它不只回答问题，还能在获得授权后读取文件、整理目录、生成 Word、表格、PPT 或代码，并把结果保存到工作空间。
判断一个 Agent 好不好用，不能只盯着模型排行榜。模型影响理解和生成，产品生态决定它能不能顺畅接触文件、文档、会议和日常办公工具。WorkBuddy 更贴近中文办公环境和腾讯生态。碰到复杂编程任务，仍然要和 Codex、Claude Code 这类工具按场景比较。
第一步：下载安装并完成首次登录
从 WorkBuddy 官网 下载与你电脑匹配的版本。当前官网提供 Windows 10 及以上版本，也有适用于 Apple 芯片和 Intel 芯片的 macOS 安装包。安装完成后，用微信扫码登录，再回到客户端新建任务。
第一次不要马上让它整理整台电脑。先建一个测试文件夹，放一份可公开、可恢复的文档副本，再给它一个小任务：
读取这个文件夹里的两份会议记录，整理成一份 Markdown 摘要，不修改原文件。
先看它能不能找到文件、理解要求，并把结果放到指定位置。都没问题，再增加任务复杂度。
第二步：先分清 Ask、Craft 和 Plan
WorkBuddy 当前的新建任务文档把任务分成三种模式。
Ask：只问不改
Ask 适合了解文件内容、确认思路和排查问题。它以问答和信息查看为主，不修改文件。第一次接触 WorkBuddy，可以先从 Ask 开始。
Craft：直接执行
Craft 会执行任务并修改文件，适合生成文档、处理表格、整理目录或输出成品。使用前要把工作空间选对，涉及重要文件时只放副本。
Plan：先看计划再动手
Plan 会先列出执行方案，再按确认后的步骤处理。任务涉及多个文件、批量改名、目录整理或连续操作时，我更建议先用 Plan。执行前看一遍范围，发现计划过大还能及时收回来。
一些早期教程把界面分成“日常办公、代码开发、设计创意”。当前官方文档已经改成 Ask、Craft、Plan。你看到的界面如果不同，以客户端版本为准。
第三步：模型不要只选最贵的
WorkBuddy 内置 Auto 和多种国内模型。Auto 会根据任务调度模型，省去手动选择。不想让消耗失控，可以按任务来选。
- 日常问答和短文案，先试响应快、倍率低的模型。
- 多步骤分析和长流程任务，可以试 GLM 等偏推理的模型。
- 截图理解、图片转文档，要选择带视觉能力的模型。
- 中文会议纪要和中文文档处理，可以比较腾讯混元与其他中文模型的结果。
WorkBuddy 用积分管理内置模型消耗。模型倍率越高、任务越长、调用工具越多，积分通常花得越快。免费额度、会员价格和模型倍率会调整，使用前看一眼官网定价页和客户端模型面板，不要沿用旧教程里的数字。
如果你还分不清 Agent、Token 和上下文，可以先看AI入门60个术语，再回来配置模型。
第四步：积分不够时，可以接入自己的模型
手里已有模型服务商的 API Key，可以在设置中的模型配置页面添加自定义模型。顺序不复杂：
- 打开设置中的模型配置。
- 选择已有供应商，或者选择自定义 API。
- 填写接口地址、API Key 和模型名称。
- 按服务商能力勾选工具调用、图片输入或推理模式。
- 保存后回到任务页面，选择刚添加的模型做小额测试。
标准供应商通常会自动填入接口格式和能力标记。只有服务不在列表里时，才需要手动填写 URL 和模型名。不要照抄别人截图里的地址，不同服务商的接口路径和模型名称可能完全不同。
官方模型配置文档说明，自定义模型配置和 API Key 保存在本地的 workbuddy/models.json。不过，你的输入仍会发给所选的第三方模型服务商，费用、日志留存、隐私和可用性也受第三方规则约束。
不要在共享电脑填写密钥，不要把 Key 发到群聊或截图中。停用后，及时撤销或删除。
第五步：一个任务使用一个工作空间
工作空间就是 WorkBuddy 本次任务主要读取和保存文件的目录。它不是一个随便点选的设置，而是控制文件范围最实用的一层边界。
我建议按任务建立独立文件夹，例如 周报整理、客户资料清洗、短视频脚本 或 待处理照片副本。只放当前任务需要的材料。不要把桌面、下载目录或整个用户目录直接当成测试空间。独立目录更容易检查改动，也能减少模型读取无关文件。
这种整理方法和 Codex 的项目思路很接近。想继续比较，可以看Codex新手教程里的项目、Skills与权限设置。
第六步：新手保持默认权限
WorkBuddy 提供默认权限和完全访问权限。
默认权限下，遇到敏感路径、工作空间外操作、删除、脚本执行或其他高风险动作，系统会要求你确认。它可能多问一次，但你能看清 AI 准备做什么。
完全访问权限会减少确认步骤，适合范围明确、文件可恢复、你能看懂操作结果的任务。不要为了省几次点击长期打开。任何能操作文件的 Agent 都可能理解错要求，也可能因为一句含糊指令扩大处理范围。
处理重要资料前，至少保留原始文件备份，并且只把副本交给 Agent。默认权限能降低风险，不能代替备份。官方权限说明也建议日常使用默认权限，只在可恢复、可隔离的任务里短时间切换完全访问。
新手第一次可以这样练
第一次使用，按下面的顺序测试就够了：
- 用 Ask 让它解释一份普通文档，不改文件。
- 新建测试文件夹，用 Craft 生成一份 Markdown 摘要。
- 用 Plan 让它先列出批量整理方案，检查范围后再执行。
- 对比两个内置模型完成同一任务的速度、质量和积分消耗。
- 确实有 API 需求，再接入自定义模型，并设置服务商预算提醒。
这五步跑通后，再尝试批量文件处理、PPT、表格分析或自动化任务。想比较另一种面向普通用户的国产 Agent，可以继续看腾讯元宝Agent办公实测。
常见问题
WorkBuddy 一定要注册新账号吗？
个人用户可以按当前客户端提示使用微信扫码登录。登录方式可能随版本调整，以官网和客户端页面为准。
Auto 模型适合一直开着吗？
不知道怎么选时可以先用 Auto。需要控制积分或固定输出风格，再手动比较具体模型。长任务先用小样本测试，不要一次投入全部材料。
自定义模型会不会消耗 WorkBuddy 积分？
官方文档说明，自定义模型产生的 Token 或订阅费用由第三方服务商收取。实际调用和套餐规则可能变化，使用前同时检查 WorkBuddy 和模型服务商的用量页面。
完全访问权限能不能一直开？
不建议。只有任务目录已经隔离、文件有备份、操作可恢复，而且你理解任务范围时，才短时间开启。
最后说一句
WorkBuddy 对新手的价值，不是让所有任务一键全自动。它更像一个把文件、模型和执行步骤放进同一处的中文工作台。
先用 Ask 看懂内容，再用 Plan 检查范围，最后让 Craft 执行。这套顺序慢不了多少，却能少掉很多误操作。
参考资料与版权说明
- 选题与教程顺序参考：小墨同学的X文章《WorkBuddy零基础小白教程》
- 产品资料：WorkBuddy官方简介、开启第一个任务、模型配置