WorkBuddy 新手指南 · 从零上手（2026-09 版）

> 对齐 WorkBuddy 5.6.2（2026-09）。5.6.0 为功能版本（2026-09-19 发布），其后为修复版。
> 产品迭代快，本指南按当前版本撰写；近两个版本新增的能力见文末「十一」。

一句话

把你怎么教同事干活的话，原样告诉它就行。WorkBuddy 是腾讯出的桌面 AI 智能体工作台——不是聊天机器人，它会真的读你的文件、操作你的电脑、交付可验收的成品。

开工三步：先跑三个脚本

光看说明不如先动手。三个脚本都在本技能的 scripts/ 目录，只用 Python 标准库，不需要装任何依赖。十分钟把环境、规矩、配置一次立好。

第 1 步 · 体检：看清你现在有什么

python3 scripts/check_env.py

一次看清：配置目录、已装技能数、MCP 配置、专家包、身份文件（SOUL / USER / IDENTITY）、
记忆体系、Python/Node/Git 运行环境。每项都附下一步建议。

纯只读，不修改任何文件。 想顺便体检某个项目：

python3 scripts/check_env.py --workspace ~/my-project

第 2 步 · 立规矩：让文件不再乱

python3 scripts/gen_rules.py --dir ~/my-project

在项目里一次生成：

已存在的文件默认跳过，不会覆盖你的东西。 想先看会写什么：

python3 scripts/gen_rules.py --dir ~/my-project --dry-run

第 3 步 · 配 MCP（可选，要接外部工具时再做）

MCP 是给 AI 接外部工具的通用协议。手写 JSON 容易错，这个脚本负责安全合并：

python3 scripts/gen_mcp_config.py --list                 # 看内置模板与当前状态
python3 scripts/gen_mcp_config.py --add playwright       # 加一个
python3 scripts/gen_mcp_config.py --check                # 只校验现有配置

内置 4 个模板：playwright（浏览器自动化）、filesystem（限定目录的文件读写，需 --path）、
sequential-thinking（分步推理）、memory（知识记忆）。写入 ~/.workbuddy/mcp.json，
写前自动备份为 .bak，已存在的同名 server 默认不覆盖。

自定义 server：

python3 scripts/gen_mcp_config.py --add-custom my-srv --command npx --args "-y,some-server"

> ⚠️ 加完不会自动生效：要到「连接器」页右上角的自定义连接器入口，
> 在列表里对新增的 server 点「信任」才会启用。这一条是新手最容易卡住的。

一、先搞懂三件事

三种工作场景（新建任务时选）：日常办公（默认）、代码开发、设计创意。选对场景，它调用工具的思路不一样。
三种协作模式：Craft 直接干 / Plan 先给方案再干 / Ask 只聊不动手。

二、界面地图：只认这几处就够

新手最容易忽略的是输入框底部那行——权限档位和工作空间都在那儿，选对了能少一半麻烦。
5.5.5 起，+ 里还能直接挂上资料库里的文档或空间作为参考内容，不用先下载到本地。

三、四种能力扩展：技能 / 专家 / 连接器 / 资料库

这四个是 WorkBuddy 从"通用助手"变成"你的助手"的关键。左侧边栏都有入口。

技能怎么装（三种方式）

在侧边栏「技能」→ 点「添加技能」，三个选项：

1. 上传技能：拖拽本地技能包即可，导入后自动配置完成
2. 查找技能：输入任务描述，它去技能市场帮你找
3. 创建技能：描述你的需求，它直接给你造一个

技能市场里有官方推荐的免费技能，可以一键安装。装之前看一句提示：技能可能读写本地文件、调用第三方 API，第三方技能请先核查来源与脚本内容，优先用官方推荐。

四个新手必须知道的操作细节：
- 关闭 ≠ 卸载：在已安装列表里关掉开关，技能仍在，只是不参与自动调用；想彻底删才点卸载
- 开关状态多端同步：电脑上关掉的技能，手机上也是关的
- 建议只开当前要用的：开太多会互相干扰，误调用概率上升
- 闲置的它会提醒你关（5.6 新增）：长期没用过的插件和技能会弹出提醒卡片，可一键关闭——收到就关，别攒着

专家怎么用

侧边栏点「专家」，按行业分类浏览。找到合适的点「召唤专家」，然后正常描述任务就行——它会用这个领域的方法和视角来干活。

• 置顶常用专家，下次排在最前面，不用反复翻
• 在专家团会话里想换别的专家，需要开新对话（老会话不会回绑）
• 专家不会主动获取系统权限，只处理你主动给的内容；配了技能或连接器后才在授权下访问外部

怎么选：要 AI「能做某件事」→ 装技能；有「一个明确的专业问题」→ 叫专家；任务复杂要「多角色配合」→ 用专家团。

连接器怎么配（以 QQ 邮箱为例）

侧边栏「连接器」→ 找到卡片点 + → 手机扫码授权 → 确认权限（账号信息 / 读邮件 / 发邮件）→ 回到 WorkBuddy 看到绿点即成功。

当前支持 QQ 邮箱、腾讯乐享、腾讯文档、TAPD、腾讯网盘，还支持自定义连接器。
注意：授权成功时要点浏览器弹窗里的「打开」完成连接，直接关网页会导致中断、要重新配。

自定义 MCP：给 AI 接自己的工具

MCP（Model Context Protocol）是接外部工具的通用协议。5.6 起恢复了直接编辑 ~/.workbuddy/mcp.json 的能力，整份配置可自行维护、即时生效。

手工写 JSON 容易出错，本技能的脚本可以代劳：

python3 scripts/gen_mcp_config.py --list                 # 看内置模板与当前状态
python3 scripts/gen_mcp_config.py --add playwright       # 加一个
python3 scripts/gen_mcp_config.py --check                # 只校验不修改

> 两个必须知道的点：
> 1. 写完不会自动生效 —— 要到本页右上角的自定义连接器入口，对新增的 server 点「信任」
> 2. 脚本会自动备份成 .bak，同名 server 默认不覆盖

授权管理：定期清理

设置 → 应用管理（5.6 新增）可以查看所有已授权的第三方应用与 Buddy 应用，并一键撤销授权。
建议每月扫一次，不再用的就撤掉。

四、常用指令模板（直接套）

写文档

帮我把 [材料/笔记] 整理成一篇 [周报/方案/会议纪要]，要求 [格式/字数]

> 例："帮我把这周的工作笔记整理成周报，800 字左右，分本周进展、下周计划、风险事项三块"

做 PPT

根据 [材料]，生成一份 [主题] PPT，风格 [商务/科技/简约]，[页数] 页以内

> 例："根据这个方案文档，生成一份企业 AI 升级方案 PPT，10 页以内，商务风"

处理表格

把 [表格文件] 里 [操作]，导出成 [格式]

> 例："把这 3 个月的销售数据合并，按产品分类汇总，做成柱状图"

查资料

帮我查 [问题]，整理成 [格式]，标注来源

读文件 / 提取信息

读一下 [文件]，把 [关键信息] 提取出来

创意设计（5.5 新增）

帮我生成一张 [用途] 的图，要求 [风格/尺寸/内容]，输出 [格式]

• 图片处理：去文字水印、图片修复、画质增强、人像美颜、透明背景抠图
• 视频生成：可指定画面比例、是否带声音，还能描述"不希望出现的内容"
• 品牌设计：Logo、品牌标识素材

做海报长图

把 [内容] 排成一张 9:16 的手机海报，风格 [要求]，输出 PNG

发布到公众号

把 [文章] 添加到公众号草稿箱，封面用 [图片]

> 需先装公众号发布类技能并配置 AppID / Secret

建定时任务

每天早上 8 点，把 [关注的领域] 的最新动态汇总成简报，存到 [目录]

> 在「定时任务」里能看到执行记录，还能推送到小程序或企业微信

五、让它是"你的"助手，不是"一个"助手

记忆（不花积分）

WorkBuddy 每晚整理当天会话，自动提取你的偏好、习惯、人物关系、跟进事项。下次对话会当背景参考。

• 在哪管：头像 → 设置 → 记忆；也可从个人面板的「记忆与进化」直接进
• 三种操作：查看 / 用对话方式让它记住或忘掉某件事 / 一键清空
• 省钱提示：记忆提取由平台自费完成，不消耗你的积分
• 还能搬家：支持从其他 AI 导入你的使用习惯
• 重要提醒：记忆由模型自动抽取，可能有偏差或过时，重要判断前先核验；涉及他人信息请确认已获授权

工作空间

工作空间是这次任务主要读写文件的文件夹。新建任务时选，或让它自动建。

给新手的建议：处理重要资料前，先建一个独立文件夹，把要处理的副本放进去。默认权限能减少误操作，但替代不了备份。

六、把重复的活交出去：定时任务

> 该功能此前叫「自动化」，5.5.4 起在客户端统一更名为「定时任务」。

适合这类活：每日简报、周报汇总、定时数据整理。在侧边栏「定时任务」→「添加定时任务」里配：

两个省事技巧：
- 不想写提示词就用内置任务模板（新闻推送、周报生成、体检预约、学习计划等），选完改改就行
- 多个执行日期合并在一条规则里，别为每天单独建任务

如果失败了：5.5.6 起支持在当前会话中直接重试，不用重建任务。

跑长任务：5.5.4 起「允许锁屏运行」有三档 —— 关闭 / 熄屏后继续运行 / 保持屏幕常亮。
夜间汇总这类长活选「熄屏后继续运行」，省电又不中断。

七、不只在电脑上：多端与协作

多端同步已经比较成熟：任务标题、置顶状态、顺序都会同步，断线能自动恢复。会话产物在移动端只保留最终交付文件，过程文件不会混进来。

Buddy 应用（5.5.0 新增）：首页左上角的应用入口里，可以切换到企业定制的专属工作台，有专属界面、场景入口和配套的专家/技能/连接器。首次进入要授权，在 设置 → Buddy 应用 里可以随时取消。

八、省积分与安全

省积分

• 简单任务别开高强度档：模型有快速 / 均衡 / 极致三档，改稿、查资料用快速档就够
• 上下文窗口按需调：档位会分别记忆，下次沿用；长文档才需要开大
• 记忆功能不花钱：别担心长期开着费积分
• 积分会过期：在「订阅和用量」里按有效期分类查看，别让积分包睡过了

安全

权限模式在输入框底部，是个常驻按钮，分两档：

还有一层「删除保护」兜底——普通单文件删除有保护，批量删除、重要目录会被拦下来确认。

三条纪律：开重要任务前先建独立工作空间放副本；动手前扫一眼权限档位；涉及他人信息先确认已获授权。

九、踩坑避雷

十、三周上手路线

第一周 · 学会派活
每天挑一件真活交给它：整理笔记、做周报、汇总表格。重点练"把要求说具体"。

第二周 · 装上顺手的能力
- 装 2–3 个技能（内容类、文档类各一个）
- 召一个对口的专家试一天
- 配一个连接器（邮箱或文档最实用）
- 打开记忆，把常用格式和写作习惯告诉它

第三周 · 让它自己跑
- 建 1–2 个定时任务，把每天重复的汇总类工作交出去
- 试试手机端接收推送
- 用 Plan 模式处理复杂任务：先看方案再动手

三周之后你会发现：真正省时间的不是它一次答得多好，而是你不再需要重复交代同一件事。

十一、最近两个版本新增了什么（2026-09）

产品迭代很快。下面只列和日常使用相关的，方便你对照自己的客户端：

怎么查自己的版本：桌面端侧栏能看到当前版本号（5.5.1 起）。
完整清单见官方更新日志：workbuddy.cn/docs/workbuddy/Changelog