WorkBuddy Guide

Appearance

WorkBuddy 实战一天工作坊 ​

一天，约 7 小时，动手为主。从下载安装、登录，到把一件事说清楚、加载技能、召唤专家、手机远程发指令、接入外部模型，最后让任务自己定时跑起来，全程用你自己的真实任务练习。

讲师 ​

讲师陈少波

陈少波

  • 厦门大学软件工程硕士
  • AI全栈开发工程师
  • 20+年IT互联网从业经验
  • 服务企业数1000+
  • 曾担任多家企业CTO
  • 福建省首批人工智能训练师
  • AITC模型工程师（高级）
  • Agentic Engineering实战派
  • AI应用研究院发起人

你会带走什么 ​

产出说明
一台装好并登录的 WorkBuddy知道升级、换语言、检查更新在哪里
一条改写过的任务提示词带「改写前 / 改写后」的结果对比
一份自己的成品文档、表格、PPT 等，用你的真实材料做出来
一位自己创建的专家用真实任务测试过，知道怎么优化
手机上能给电脑派活微信助理或小程序，发过一条只读指令并收到回复
一个接入的外部模型用自己的 API Key 或本地模型跑通一次
一项已试跑的自动化任务不是演示用的，是你以后真会用的

当天日程 ​

时间时长模块
09:00–09:3030 分钟① 下载安装与登录
09:30–10:1040 分钟② 主界面、任务与工作区
10:10–10:2010 分钟休息
10:20–11:1050 分钟③ 完成第一个任务：提问技巧
11:10–12:0050 分钟④ 加载 Skill 与选模型
12:00–13:1575 分钟午休
13:15–14:3075 分钟⑤ 场景实战
14:30–14:4010 分钟休息
14:40–15:2545 分钟⑥ 专家与专家团
15:25–16:1045 分钟⑦ 接入小程序与 IM 助理
16:10–16:2010 分钟休息
16:20–17:0040 分钟⑧ 外接 API 与连接器
17:00–17:4545 分钟⑨ 自动化
17:45–18:0015 分钟收尾：检查成果，决定保留哪些任务

课堂文件放哪里 ​

先把软件和文件准备好。本讲义按桌面端 5.9.0 编写。5.9.0 正在分批灰度，你的客户端可能还是 5.8.x，两者与本讲义相关的差异只有一处：模型选择器里新增了自定义模型的配置入口（模块⑧用到），5.8.x 从「设置 → 模型」进入即可。还没装软件的，先做模块①，装好登录后再回来准备文件。

第一步：下载素材包并解压 ​

下载课堂素材包（workbuddy-workshop-materials.zip）

解压到你容易找到的位置（比如桌面或文档），会得到一个 WorkBuddy工作坊 文件夹：

text
WorkBuddy工作坊/
├── input/              ← 练习材料放这里，只让它读，不让它改
│   ├── meeting.txt         会议记录
│   ├── 汇报材料.md          项目汇报材料
│   ├── 销售数据.csv         9 月销售数据
│   ├── 文章.md              一篇定稿文章
│   └── 待整理/              9 个杂乱的文件，整理练习用
├── output/             ← WorkBuddy 生成的成品都放这里（现在是空的）
└── automation/         ← 模块⑨的自动化任务用，每项任务一个子文件夹
    └── ai-daily/           每日简报任务的工作目录（现在是空的）

素材包里的内容全部是虚构的，可以放心使用。想用自己的真实材料练习，把 input/ 里的同名文件换掉就行，但不要用含客户隐私、密码或未公开财务数据的文件。

第二步：选好工作空间 ​

新建任务时，点输入框左下角的「选择工作空间」，选中 WorkBuddy工作坊。之后提示词里写的相对路径（如 input/meeting.txt）都是从这个文件夹算起。不选的话，结果会生成在默认目录里，找起来很麻烦。

第三步：知道每个练习用哪个文件 ​

练习用到 input/ 里的文件生成的文件
③ 第一个任务meeting.txtoutput/第一个任务.md
③ 整理文件待整理/ 文件夹output/inventory.xlsx、output/proposed-actions.md
③ 会议纪要meeting.txtoutput/会议纪要.md、output/待办清单.xlsx
⑤ 文案与文档不需要，从零开始output/ 里的团建策划 Word、changelog.md
⑤ PPT汇报材料.mdoutput/ 里的 PPT 文件
⑤ 数据分析销售数据.csvoutput/sales-analysis.xlsx、output/summary.md
⑤ 图像、视频文章.mdoutput/ 里的图文页面、output/口播脚本.md
⑥ 专家meeting.txtoutput/ 里的会议纪要
⑧ 外接模型meeting.txt对话里的回复
⑨ 自动化不需要automation/ai-daily/ 里每天一个简报文件

把文件交给 WorkBuddy 有三种办法：在提示词里直接写路径（如 input/meeting.txt）；在输入框里用 @ 引用文件；或者把文件拖进输入框（最多 50 个，添加后不会自动发送）。

两条规矩：

  • 原始材料只放在 input/，成品只写到 output/。这样你随时能分清哪些是自己的、哪些是 AI 生成的。
  • 每次生成后打开成品看，不要只看对话区的回复。在右侧窗口的「产物」里找目标文件，其他文件在「概览 → 工作空间文件」里。

课堂约定 ​

  • 只把练习材料放进工作目录，不让 WorkBuddy 访问你不想动的文件夹。首次操作先在演练目录里进行，处理真实业务数据前先确认授权范围。
  • 保持「默认权限」，不要打开「允许完全访问」。默认权限下，删除、修改、执行脚本或命令、访问网络这些高风险操作会先暂停，等你确认；完全访问会关掉这些确认，并且对这台电脑上的所有任务生效。
  • 连接器只授权课堂用得上的范围，课后可以随时回收。
  • API Key、Bot ID、Secret 这类凭证只填在软件里，不发到群里，不截图，不写进要分享的文件。
  • 手机远程批准操作前，看清它要做什么再点同意。
  • 成品分享给别人之前，先确认里面没有敏感或涉密信息。
  • 课堂创建的自动化任务，下课前确认保留还是关闭，不留不知道在跑什么的任务。

① 下载安装与登录（30 分钟） ​

先确认系统 ​

系统要求
WindowsWindows 10 或更高版本，x64 架构。不支持 Windows 7、8、8.1，这些系统无法启动 WorkBuddy。ARM64 设备是否支持，以当前版本说明为准
macOS分 Apple 芯片和 Intel 两种安装包，下载页会按你的电脑给出对应版本，具体系统版本以下载页标注为准

下载与安装 ​

  1. 用浏览器打开 WorkBuddy 官网 workbuddy.cn，点「立即下载」，选择自己系统的安装包。只从官网下载，不用来路不明的网盘包。
  2. Windows： 双击安装包，勾选「我同意此协议」，点「下一步」；安装路径用默认的就行，继续「下一步」；建议勾选「创建桌面快捷方式」；确认后点「安装」，完成后点「完成」。
  3. macOS： 打开下载好的 .dmg，把 WorkBuddy 图标拖进「应用程序」。第一次打开如果提示无法打开，到「系统设置 → 隐私与安全性」里选择仍要打开。

登录 ​

  1. 启动 WorkBuddy，点「登录」，系统默认浏览器会打开官网登录页。
  2. 在登录弹窗里勾选《用户服务协议》和《隐私政策》。
  3. 选一种方式登录：微信扫码、手机号、邮箱或 SSO，全程在当前网页完成。
  4. 登录成功后回到客户端，就可以开始用了。

登录页没有弹出来、或者登录后客户端没反应时：先确认网络正常，再检查系统默认浏览器是否可用，必要时换一个浏览器重试，再不行就重启客户端。

语言与更新 ​

  • 切换界面语言：点左下角「头像」→「设置」→「通用」→「语言」。
  • 升级到最新版：点左下角「头像」→「检查更新」，系统会自动检测并升级。本讲义按 5.9.0 编写，界面名称和你的版本不一致时，先升级再往下做。
  • 设置里的项目很多，用设置页顶部的搜索框直接搜名称最快（5.8.0 起支持）。

发第一句话 ​

先发一个不涉及文件的问题，确认能收到回复：

text
你好，请用两句话介绍你自己，再告诉我你能帮我做哪几类事情。

课堂练习 ​

  1. 完成安装并登录，把客户端升级到最新版。
  2. 发出上面那句话，确认收到回复。
  3. 下载并解压素材包，确认 WorkBuddy工作坊/input/ 里能看到 5 个文件/文件夹。

做完的标准： 你能登录并收到回复，知道「检查更新」「语言」在哪里，素材包已经解压好。

② 主界面、任务与工作区（40 分钟） ​

主界面：三个区域 ​

区域主要用途使用时重点检查
侧边栏新建、搜索、切换和管理任务是否进入了正确任务
对话区描述需求、补充信息、确认计划目标和约束是否完整
结果区查看产物、全部文件、变更与预览文件名、路径和改动是否符合预期

每个任务有自己的工作目录。工作目录既是效率设置，也是安全边界：把发票、周报、客户材料混在同一个大目录里，会增加误读、误改和信息串用的风险。按任务建目录。

三种工作模式 ​

在输入框左侧的 + 菜单里切换：

界面名称能做什么适合场景
默认（Agent）直接执行任务，可以修改文件。默认开启文档生成、表格处理、文件整理
计划（Plan）先补充信息，输出可审阅的方案，确认后再执行。方案显示在右侧面板，选「开始执行」或「调整计划」多步骤任务、需要审阅改动范围的任务
仅问答（Ask）只回答问题、提供思路，不做执行了解内容、确认需求

「计划」和「仅问答」互斥。切换后输入框下方会出现模式标识，点标识上的 × 就回到默认模式。拿不准的时候，先用「计划」或「仅问答」。

任务和工作区 ​

  • 任务： 每次「新建任务」就是一段独立的对话，有自己的上下文、产物和工作目录。一件事一个任务，不要把不相干的事塞进同一个任务里。
  • 工作区（工作空间）： 任务读写文件的那个文件夹。新建任务时点输入框左下角的「选择工作空间」来选。没有合适的，就新建一个。
  • 找成品： 右侧窗口的「产物」是这次任务生成的文件，「概览 → 工作空间文件」里能看到工作区的全部文件。

课堂练习 ​

  1. 新建一个任务，选中 WorkBuddy工作坊 作为工作空间。
  2. 在输入框里切到「仅问答」，问「input 文件夹里有哪些文件？」，观察它只回答、不动文件；再点模式标识上的 × 回到默认。
  3. 切到「计划」，发「请把 input 文件夹里的文件按类型列一份清单，先给我方案」，看右侧面板里的方案，选「调整计划」补一句要求，再看它怎么变。

做完的标准： 你能说清三种模式各适合什么，知道工作区选在哪里，知道成品去哪里找。

③ 完成第一个任务：提问技巧（50 分钟） ​

先跑通一个最小任务 ​

在 WorkBuddy工作坊 工作空间里，保持默认模式，新建任务并发送：

text
请读取 input/meeting.txt，用 5 句话概括这次会议的结论。
只读取，不要修改原文件。
把结果保存为 output/第一个任务.md。

发送后看三件事：对话区里它做了什么；右侧「产物」里有没有 第一个任务.md；打开文件对一下，是不是真的 5 句、能不能在原文里找到依据。

每次回复之后，WorkBuddy 可能会推荐几个「下一步」问题，点中就会填进输入框，不合适可以换一条。

同样一件事，说清楚和没说清楚，结果差得很远。AI 做得不好的任务，多数不是模型不会，而是人没有把交付标准说清楚。

任务说明的六个要素 ​

写任务说明时，逐项回答下面六个问题：

要素要回答的问题
目标最终要解决什么问题
输入使用哪些文件、目录或链接
动作需要分析、整理、转换还是生成
约束哪些不能改，采用什么规范
输出交付什么文件，放到哪里
验收用什么标准判断合格

四个最常见的错误 ​

常见错误为什么会发生更好的写法
「帮我做个 PPT，要高级一点」没有受众、目标和材料约束说明受众、汇报时长、页数、要做的决定，以及必须保留的数据
「分析一下这个 Excel」没有业务问题，模型只能泛泛总结说明要回答什么问题、统计哪些指标、按什么维度比较
「写一份报告」没有文档类型和语气要求说明是方案、总结、申请、纪要还是需求文档，并指定读者
「全部自动完成，不用问我」关键口径没确认，风险会被放大先让它输出方案或大纲，你确认后再生成文件

五个让结果更稳的习惯 ​

  1. 先看方案，再动手。 涉及移动、改名、覆盖文件时，要求它先给方案，你确认后才执行。也可以直接切到「计划」模式，它会先输出方案，等你确认再做。
  2. 说不确定就写待确认。 明确告诉它：原文里确认不了的负责人、日期、数字写「待确认」，不要自行补全，不要编造。
  3. 改稿说差异，不要重来。 第二次提要求时写「在上一版基础上修改，不要重新生成整篇」，再逐条列出要改的地方。
  4. 给一个满意的样例。 给出范例并说「照这个来」，比用文字描述要求更稳定。
  5. 改文件前先备份。 让它修改文件之前，先复制一份原件，方便回退。

两个可以直接套用的例子 ​

整理文件（注意：先出方案，确认前不动文件）：

text
目标：整理 input/待整理 目录中的练习文件，便于按类型查找。
输入：仅处理当前工作区的 input/待整理 目录，不要动 input 下的其他文件。
动作：识别文件类型，提出分类和重命名方案。
约束：不删除、不覆盖原文件；重名时保留两份并标记序号。
输出：先生成 output/inventory.xlsx 和 output/proposed-actions.md。
验收：清单文件数与 input/待整理 实际文件数一致，所有动作可追溯。
在我确认 output/proposed-actions.md 前，不移动文件。

生成会议纪要（注意：不能确认的内容写待确认）：

text
请把 input/meeting.txt 整理为结构化会议纪要。
必须包含：会议结论、待办事项、负责人、截止日期、待确认问题。
不能从原文确认的负责人或日期写“待确认”，不要自行补全。
输出 output/会议纪要.md 和 output/待办清单.xlsx。
验收：每一项结论可以在原文找到依据；待办不遗漏负责人和时间状态。

课堂练习 ​

  1. 拿出你想解决的真实任务，用一句话先让 WorkBuddy 做一次，保存结果，这是「改写前」。
  2. 用六要素把它改写成完整的任务说明，再做一次，这是「改写后」。
  3. 对比两份结果，写下你改了哪几处、各自带来什么变化。

做完的标准： 同一件事有「改写前」「改写后」两份结果，你能说出改了哪几处、各自带来什么变化。

④ 加载 Skill 与选模型（50 分钟） ​

Skill：Prompt 是任务，Skill 是做法 ​

维度PromptSkill
核心作用描述当前任务定义一类任务怎么做
生命周期通常针对一次请求长期复用
内容指令、上下文、示例指令、脚本、资料、模板、资源
复用经常复制粘贴原生可复用

适合做成 Skill 的，是你反复在跟 AI 说的话。比如你每次都要强调「不要写得太像 AI、长短句结合、不要编造例子」，这就是一个写作风格 Skill 该装的内容。以后你只需要说「写一篇文章」，风格、资料标准和流程都由 Skill 提供。

怎么找、装、用：

  1. 打开左侧「专家·技能·连接器」，进入「技能」页签。「技能市场」里是可以一键安装的推荐技能，「已安装」里是你装好的。
  2. 点「添加技能」，有三种方式：「上传技能」导入本地的技能包；「查找技能」用一句话描述需求，让 WorkBuddy 帮你找；「创建技能」用自然语言描述，让它帮你做一个。
  3. 不需要手动调用。 已启用的 Skill 会在对话中由 WorkBuddy 按任务自动选用，所以任务说明里要把要做的事写清楚，必要时直接点名要用哪个 Skill。
  4. 暂时不用：关掉开关，它还留在「已安装」里，随时可以恢复。彻底移除：「卸载技能」，支持批量。

安装前注意：优先选官方技能；第三方技能先看来源、权限和脚本；有些技能会把你的输入发给第三方；涉及删除文件、批量写入的技能，先小范围试一次。

选模型 ​

新建任务时，在输入框里选好模型再发送。5.9.0 起，模型选择器里也能直接进入自定义模型的配置（模块⑧会用到）。内置模型目前有：

模型官方定位
Auto平衡效果与速度，由 WorkBuddy 按任务自动选择模型
Hy3混元思考模型，推理能力增强
GLM-5.2能力均衡
GLM-5.1针对 Agent 场景深度优化
GLM-5v-Turbo原生多模态模型
MiniMax-M3能力均衡
Kimi-K2.7-Code专注代码生成
DeepSeek-V4-Flash、DeepSeek-V4-Pro能力均衡
Kimi-K2.6多模态，适合日常任务

模型清单会随版本更新，以你客户端选择器里显示的为准。拿不准就选 Auto；想比较效果，就把同一个任务换两个模型各做一次。

选模型时能看到各模型当前的繁忙度，繁忙时可以换一个。不同模型消耗的积分不同。对话中途换模型，下一轮才生效，而且可能降低效果、增加积分消耗，所以尽量在开始时选好。

课堂练习 ​

  1. 拿模块③里的同一个任务，换一个模型再跑一次，和上一次对比。
  2. 找一个和你的任务相关的 Skill，安装后在任务说明里点名使用，再跑一次。
  3. 在三份结果里选一份你最想用的，写下原因。

做完的标准： 你能回答两个问题：这个任务该选什么样的模型？为什么这里该用 Skill，而不是反复写提示词？

⑤ 场景实战（75 分钟） ​

下面六类场景都附了可以直接复制的提示词，你从中选两个，用 input/ 里的文件（或自己的材料）做出成品。

所有场景共用一条流程：先让它出大纲或方案 → 你确认 → 再生成文件 → 你逐项核对。 办公类任务先把五个问题说清楚：

问题要说清什么示例
目标这份材料要帮助谁做什么决定给部门负责人看，用于判断项目是否继续投入
受众阅读者是谁，懂不懂背景管理层只看结论；项目组需要过程和责任人
材料哪些文件是事实来源，哪些只是参考data.xlsx 是唯一数据口径，旧版 PPT 只参考结构
格式要 Word、Excel、PPT，还是联动一份复盘 Word、一张风险台账 Excel、一份 8 页汇报 PPT
验收怎么判断结果可用数字能回到源文件，表格公式可刷新，PPT 投屏不溢出

场景一：问答与资料调研 ​

适合先用「仅问答」模式了解资料、确认需求，再决定要不要动手。调研类任务要求它附来源：

text
请调研【行业/公司/产品】。
输出：市场背景、主要玩家、竞品对比、趋势判断、机会点、风险点。
请附上信息来源链接。

核对点：每条关键结论有没有来源，来源链接能不能打开。

场景二：文案与文档 ​

先让它列框架，再逐条改，不要一次要求写满：

text
帮我生成一份公司团建活动策划的 Word 文档框架。
公司约 80 人，包含：活动目标、活动主题建议、整体流程安排（含时间节点）、分组与互动游戏建议、预算构成清单、人员分工、风险预案和注意事项。
语言简洁实用，不需要写得过于详细，重点把整体框架和关键决策项列清楚，适合直接拿去和领导确认活动方向。

二次修改时说差异，并要求留下修改记录：

text
请在上一版基础上进行修改，不要重新生成整篇。
将活动目标压缩为 3 条，每条不超过 50 字；
将流程安排改成表格，列为：时间、环节、主要内容、负责人、所需物料；
新增风险预案，覆盖人员迟到、设备故障、节目超时和突发安全问题；
整体语言更加正式、简洁，适合提交审批。
输出修改后的 v2 版 Word 文档到 output/，并在 output/changelog.md 中列出本次修改内容。

场景三：PPT ​

PPT 最容易被误用。写「帮我做一份高级感 PPT」，AI 只能猜风格，生成一堆好看的空话。先回答三个问题：这次汇报给谁看、对方听完要做什么决定、你有多少时间讲。故事线必须你先确认，再让它做页面。

text
请根据当前工作区材料制作一份 8 页以内的汇报 PPT。
受众：【谁】。汇报时长：10 分钟。
目标：让听众理解【什么】，并做出【什么决定】。
素材：input/汇报材料.md 是主要内容材料；不要补充工作区材料之外的事实和数据。
每页只表达一个核心结论；案例、数据和关键判断必须标注素材来源，无法确认的不要自行补充；
标题直接表达观点，不使用「背景介绍」这类泛化标题。
先输出每页标题和要点，等我确认后再生成 PPT，保存到 output/ 目录。
生成后检查文字溢出、页面留白、图表口径、图片缺失、字体一致性和页码。

核对点：每页只有一个核心观点；关键数字和原文一致；投屏状态下正文能读清。

场景四：数据分析 ​

先定义业务问题，再决定图表，不要先生成漂亮图。让它先读表、说明字段含义、检查脏数据，再分析：

text
请读取 input/销售数据.csv，先不要修改原文件。
业务问题：分析本月各产品线的销售表现和盈利能力，判断哪些贡献高、哪些利润偏弱，并识别销售过程中的异常波动。
请输出：
说明字段含义，并检查缺失值、重复记录、异常值和格式问题；
按产品线统计销售额、毛利、毛利率和占比，并排名；
生成柱状图对比各产品线，生成折线图展示每日变化；
识别明显异常的日期或记录，结合数据说明，不要在缺少依据时推测原因；
总结表现最好和需要重点关注的产品线，以及 3 条可用于复盘的结论。
输出 output/sales-analysis.xlsx 和 output/summary.md。
要求：保留原始数据，统计过程和公式可追溯；无法从数据中确认的原因标注为待核实。

核对点：汇总数能和源表对上；公式可重算；异常没有被悄悄删掉；图表用的字段和汇总表一致。

场景五：图像 ​

不要直接说「做一张好看的封面」。先让它写视觉需求（版式、层级、文字量），你确认后再生成图片：

text
把 input/文章.md 改造成 8 页图文，不新增事实。
第 1 页只表达一个承诺；第 2 页写读者正在经历的问题；
第 3-6 页每页只讲一个动作并给一个例子；第 7 页写常见误区；
第 8 页给可保存的检查清单。
先返回逐页文案、视觉层级和预计字数，我确认后再生成图片，保存到 output/ 目录。

提醒：图片生成消耗的积分较高，先把文案和版式确认好再生成，避免来回重做。图像效果取决于你所选的模型，不保证每次都满意；图片里的数字和专有名词要逐一核对。

场景六：视频 ​

先出分镜脚本，不要一上来要成片。下面是把一段文字改成 60 秒口播的写法：

text
把 input/文章.md 改造成 60 秒真人口播，目标是让第一次使用的人理解【核心观点】。
输出时间轴表格：时长、景别、画面、口播、屏幕文字、素材来源、转场。
前 3 秒必须提出真实问题，不夸大收益；结尾给一个可以立即尝试的指令。
同时列出必须实拍、可用截图、可由 AI 生成的画面，禁止伪造用户反馈。
结果保存为 output/口播脚本.md。

三条规矩：脚本不过关就不进入配音和渲染；成片要检查旁白和字幕是否一致、素材是否有版权风险；默认不要自动发布，账号、素材、标题和合规都人工确认后再发。

课堂练习 ​

  1. 从六个场景里选两个，用你的真实材料做出成品。
  2. 每个成品都按「核对点」逐项检查，圈出你需要自己核对的数字、引用和事实。

做完的标准： 成品能直接拿去用，或只需要你改几处措辞；你能指出其中哪些内容是需要自己核对的。

⑥ 专家与专家团（45 分钟） ​

专家、专家团、Skill 怎么选 ​

方式本质适合的问题
普通任务通用理解与执行一次性的清楚任务
Skill特定工具能力需要稳定执行某个动作
专家人设 + 方法论 + 工具链明确领域的单点专业问题
专家团多位专家 + 协作流程需要拆解、并行、汇总的复杂项目

怎么召唤： 打开左侧「专家·技能·连接器」，默认进入「专家」页签，专家和专家团都在这里。浏览卡片，看能力介绍和任务示例，点「召唤专家/专家团」进入对话，再描述任务。想在对话中换一位专家，可以用搜索找，常用的可以置顶。

怎么创建： 在「专家」页点右上角「我的专家」，再点「创建专家」，按对话提示配置头像与名称、人设身份、擅长领域和提示词。创建后用真实任务测试，再按结果优化。注意：专家名称创建后不能修改。创建时可以把下面这段发给对话：

text
我想创建一位「会议纪要助理」。
人设：严谨的行政秘书，只依据原文整理，不编造。
擅长：把会议记录整理成纪要，提取结论、待办事项、负责人和截止时间。
规则：原文没有负责人或日期的，标注“待确认”，不要自行补全；输出固定为：会议结论、待办清单（表格）、待确认事项。

专家团： 由团长负责拆解和汇总。开始之前先确认四件事：成员分工是否覆盖完整、哪些步骤依赖前一步、什么时候需要人来拍板、最终由谁整合。专家团会多轮调用模型，积分消耗通常是单个专家的 3–5 倍，召唤前先确认积分余额。

用专家团做一次分工 ​

在「专家」页签召唤一个视频类专家团，把下面这段发给它：

text
请把 input/文章.md 做成一条 60 秒的口播短视频。
分工：一位专家提炼文章里的核心观点并保留出处；一位写脚本和分镜；一位制作成片。
流程：先交出脚本和分镜，等我确认后再配音和渲染；脚本不过关不要进入下一步。
要求：不新增文章之外的事实；成片的旁白和字幕保持一致；素材注意版权；不要自动发布。
结果保存到 output/ 目录。

积分不够时，可以只做到脚本和分镜这一步。

课堂练习 ​

  1. 按上面的方式创建「会议纪要助理」，用 input/meeting.txt 测试，对照结果改一次它的规则，再测一次。
  2. 积分够用的话，召唤一个专家团跑一次上面的视频任务，只做到脚本和分镜这一步；积分紧张就只观察团长怎么拆分任务。
  3. 写下：这件事用普通任务、Skill、专家、专家团里的哪一种最合适，为什么。

做完的标准： 你创建的专家用真实任务测试过，并且你能说出什么时候该用专家团、什么时候不该用。

⑦ 接入小程序与 IM 助理（45 分钟） ​

两件事解决同一个问题：人不在电脑前，也能给电脑上的 WorkBuddy 派活。指令从手机发出，任务仍在你的电脑上执行，结果回到手机。

入口是什么适合
微信小程序手机上的 WorkBuddy 入口，可用文字、语音、图片、文件下达任务经常在外面、想像用 App 一样用
微信助理（推荐）在微信聊天里直接给电脑上的 WorkBuddy 发指令想用熟悉的聊天界面，扫码就能绑定
企业微信、飞书、钉钉机器人在对应软件里用机器人收发指令团队已经在用这些软件，需要先在对应平台创建应用或机器人

微信助理：扫码绑定 ​

准备：电脑端 WorkBuddy 保持运行，手机微信保持较新版本，两端都能上网，使用同一账号或已关联的账号。不需要 App ID、App Secret 这类开发凭证。

  1. 打开 WorkBuddy，在左侧「助理」栏点齿轮图标，进入「助理设置」。
  2. 在集成列表里找到「微信助理集成」，点右侧的「配置」。
  3. 按钮会短暂显示「绑定中...」，然后二维码出现在卡片下方，用手机微信扫码。
  4. 卡片状态变成「已绑定」就完成了。二维码有时效，过期了重新点「配置」生成。

绑定后，先发一条只读的测试指令：

text
请告诉我现在的日期，以及你当前的工作目录是哪个文件夹。只读，不要修改任何文件。

在微信里还可以：发起新任务或继续助理里没做完的会话、回答它的追问、批准命令执行和文件修改、查看任务输出和差异、在任务完成或需要你处理时收到通知。支持文字、图片、文件和语音（语音靠微信自带的语音转文字）。

微信小程序：连接电脑 ​

桌面端：

  1. 鼠标悬停在侧边栏底部的「连接移动端」图标上，弹出面板。
  2. 打开「允许移动端连接此设备」开关。
  3. 在面板里选「小程序」分页，可以扫二维码打开或下载小程序（二维码只用来打开，不参与配对）。

手机端：

  1. 微信里下拉进入「小程序」搜索栏，搜索「腾讯 WorkBuddy」并进入。
  2. 首次打开时，勾选《用户协议》和《隐私政策》，点「授权手机号登录」，选择手机号。
  3. 点侧边栏顶部的设备入口，在「选择设备」面板里选中你的电脑。建联后不用重复配对。

关键要求： 小程序登录的微信账号要和电脑端登录的账号一致，否则连不上本机。

小程序有两种执行环境：「云上模式」在云端沙箱里执行，不依赖你的电脑；「本机模式」远程操控电脑上的 WorkBuddy，能读你电脑上的文件。默认是云上模式，想让手机控制这台电脑，选择上面连接好的设备。

想让手机一直连得上 ​

  • 电脑休眠、断网或关闭 WorkBuddy，远程访问就会中断。
  • 在连接面板里打开「保持唤醒状态，以便远程访问」，或到「系统设置 → 通用 → 允许锁屏运行」选择「熄屏后保持唤醒」（省电）或「保持屏幕常亮」（费电）。
  • 笔记本建议接通电源、保持开盖。
  • 离开工位前，确认连接开关和保持唤醒都开着。

要知道的限制与风险 ​

  • 助理使用一个固定的专属文件夹作为工作目录，只有一个会话，所有远程指令集中处理，历史记录不能清空。要在指定文件夹里做事，用电脑上的普通任务更合适。
  • 远程会话用的是你电脑上的文件和凭证，手机只发指令和审批操作，所以批准之前先看清它要做什么。删除文件、修改系统配置、执行命令这类高风险操作会先等你确认，不要图省事一路点同意。
  • 设备断连时，没法在手机上修改技能、专家、连接器、权限、模型这些配置。连接器没授权时，要回电脑上授权；自定义模型也要在电脑上配置好才能在小程序里选。
  • 不用了就解绑：「设置 → 助理设置」里点平台卡片右侧的「解绑」。解绑后该平台不能再发指令，本地接入配置会删除、历史保留，但平台那边创建的机器人或应用还在，需要自己去平台清理。

企微、飞书、钉钉：先在平台创建机器人 ​

这三类要先在对应平台创建一个机器人（或应用），再回 WorkBuddy 填凭证。下面全部用「长连接」方式：不需要服务器，也不需要公网地址，个人电脑、办公室电脑都能用。

三步通用流程，先记住：

  1. 在平台上创建机器人，拿到两样凭证（相当于机器人的账号和密码）。
  2. 回 WorkBuddy 的「助理设置」，把凭证填进去，点「注册」，看到「已连接」。
  3. 在平台里发布机器人，给它发一条只读的测试指令。

WorkBuddy 里的入口（三个平台都一样）： 在左侧「助理」栏点齿轮图标，进入「助理设置」（也可以点左下角头像 →「设置」→「助理设置」）。在集成列表里找到对应平台，点「配置」。

开始前确认： WorkBuddy 正在运行，并且助理服务已开启；你有可以创建机器人的账号（飞书、钉钉需要企业账号，钉钉创建应用需要管理员权限）。凭证只填在软件里，不发群、不截图。

测试时统一发这一句，它只读、不会改你的文件：

text
请告诉我现在的日期，以及你当前的工作目录是哪个文件夹。只读，不要修改任何文件。

企业微信 ​

用企业微信的「智能机器人」，长连接模式只要 Bot ID 和 Secret 两样。

  1. 创建机器人。管理员：用管理员账号登录企业微信管理后台，依次点「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」。普通成员：打开企业微信客户端，依次点「工作台」→「智能机器人应用」→「创建机器人」。
  2. 如果进入了「AI 自动生成」页面，点左下角「手动创建」，再选「API 模式创建」。
  3. 填基本信息：机器人名称写「WorkBuddy 助手」之类好认的名字。管理员在「可见范围」后点「添加」，普通成员在「可使用成员」后点「修改」，选择谁可以用这个机器人（先只选你自己）。点底部「保存」。
  4. 在页面右侧「API 配置」区域选择「使用长连接」。这个模式不需要填 URL、Token 或 Encoding-AESKey。
  5. 复制页面上的 Bot ID，再点「点击获取」拿到 Secret，两个都先粘贴到记事本里暂存。Secret 只显示一次，丢了要重新获取。
  6. 回 WorkBuddy 的「助理设置」，在集成列表里找到「企微助理集成」，点「配置」。
  7. 在弹窗里选「WebSocket 长连接」，然后二选一：手动绑定，填 Bot ID 和 Secret，点「注册」；快捷绑定，点快捷绑定，用企业微信扫码完成。
  8. 测试：在企业微信通讯录的「企业创建的」分组里找到刚创建的机器人，点「发消息」，发上面那句测试指令。机器人回复了，就是成功。

没反应时：确认 WorkBuddy 在运行；确认企业微信里选的是「使用长连接」；重新复制 Bot ID 和 Secret，注意别带进空格；Secret 失效了就回企业微信后台重新获取。

飞书 ​

飞书目前有两种创建方式。先用方法一，步骤少；如果在开放平台顶部找不到「创建飞书智能体应用」入口，或者做完机器人仍不回复，改用方法二，逐项手动配置。

方法一：创建飞书智能体应用（较新，步骤少）

  1. 用浏览器打开 open.feishu.cn，用企业账号登录，在页面顶部找到「创建飞书智能体应用」，点「立即创建」。
  2. 在创建页选一个头像，填应用名称（如「WorkBuddy 助手」），点「立即创建」。
  3. 创建成功后，页面会显示 App ID 和 App Secret，两个都复制下来，暂存到记事本。这个方式由飞书自动完成大部分配置，不用再手动加机器人、导权限、配事件。
  4. 回 WorkBuddy 的「助理设置」，找到「飞书集成」，点「配置」。在「注册飞书通道」弹窗里选「WebSocket 长连接」，填入 App ID 和 App Secret，点「注册」。

你会看到：WorkBuddy 里状态变成「已连接」。

  1. 应用发布：企业开启了免审规则的会自动通过，否则按企业规则提交给管理员审批。发布成功后，在飞书里点「打开应用」。
  2. 测试：给机器人发上面那句测试指令。收到回复，并且在 WorkBuddy 里能看到对应的对话，就成功了。

方法二：创建企业自建应用（逐项手动配置）

下面分五段，每一段做完核对一下「你会看到」再往下。

第一段：创建应用并添加机器人

  1. 用浏览器打开 open.feishu.cn/app，用企业账号登录。
  2. 点「创建企业自建应用」。
  3. 填应用名称（如「WorkBuddy 助手」）和应用描述，上传一个应用图标，点「创建」。创建成功后自动进入应用详情页。
  4. 在应用详情页找到「添加应用能力」区域，找到「机器人」卡片，点「添加」。

你会看到：应用的能力列表里出现了「机器人」。

第二段：导入权限

  1. 左侧菜单点「权限管理」，再点「批量导入 / 导出权限」。
  2. 先把输入框里原有的内容全部清空，再粘贴下面的权限列表。
点开复制权限列表（应用身份，收发消息和卡片用）
json
{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": []
  }
}
  1. 点「确定新增权限」，等几秒。

你会看到：页面提示权限添加成功，权限列表里出现了上面这些项目。

第三段：拿凭证，在 WorkBuddy 里注册

  1. 左侧菜单点「凭证与基础信息」，记下 App ID，再点查看 App Secret，两个都暂存到记事本。
  2. 回 WorkBuddy 的「助理设置」，找到「飞书集成」，点「配置」。
  3. 把 App ID 和 App Secret 填进去。如果弹窗里还有 Encrypt Key 这一项，回飞书左侧菜单点「事件与回调」，在加密策略里点刷新按钮生成一个，复制过来填上；没有这一项就不用管。
  4. 连接方式选「WebSocket 长连接」，点「注册」。

你会看到：WorkBuddy 里状态变成「已连接」。这一步必须先成功，才能做下一段。

第四段：回飞书配置事件

  1. 回飞书，左侧菜单点「事件与回调」。在「订阅方式」里选「使用长连接接收事件」，点「验证」。页面显示「连接成功」就对了。
  2. 在「事件配置」区域点「添加事件」，搜索「接收消息」，勾选添加。
  3. 切换到「回调配置」页签，搜索「卡片回传交互」，点「确认添加」。

你会看到：事件列表里有「接收消息」，回调列表里有「卡片回传交互」。少了其中一个，机器人就收不到消息。

第五段：创建版本并发布

  1. 点页面上方的「创建版本」。
  2. 填版本号（如 1.0.0）和版本描述（如「首次发布，接入 WorkBuddy」），点「确定」。
  3. 创建成功后，点版本右侧的「发布」。企业管理员提交的应用通常会自动通过；如果需要审批，请联系你们企业的管理员。

测试： 在飞书顶部搜索框里输入机器人名称，点进对话窗口（或点「打开应用」），发上面那句测试指令。

没反应时，按顺序查：应用有没有真的发布成功；WorkBuddy 是否在运行、助理服务是否开着、状态是不是「已连接」；「接收消息」事件和「卡片回传交互」回调是不是都加了；权限是不是都导入成功了。

钉钉 ​

钉钉需要企业管理员权限。三段：创建应用并加机器人、拿凭证注册、发布。

  1. 用浏览器打开钉钉开发者后台 open.dingtalk.com，用管理员账号登录。如果提示账号还没加入组织，按提示先创建一个组织（个人企业也可以）。
  2. 点「应用开发」，再点「创建应用」。填应用名称和应用描述，应用类型可以先不填，点「保存」。
  3. 保存后自动进入「添加应用能力」页面，找到「机器人」，点「添加机器人」。
  4. 填机器人名称、机器人描述，上传一张头像，点「确认发布」。
  5. 在应用详情页左侧菜单点「权限管理」，在搜索框里分别搜索下面三个权限，每个都点「立即开通」：
text
Card.Streaming.Write
Card.Instance.Write
qyapi_robot_sendmsg
  1. 左侧菜单点「凭证与基础信息」，复制 Client ID（也叫 AppKey）和 Client Secret（也叫 AppSecret），暂存到记事本。
  2. 回 WorkBuddy 的「助理设置」，找到「钉钉集成」，把 Client ID 和 Client Secret 填进去。
  3. 连接方式选「WebSocket 长连接」，点「注册」。机器人配置页里的消息接收模式保持默认的「Stream 模式」就行，它对应 WorkBuddy 的长连接，不要改成 HTTP 模式。

你会看到：WorkBuddy 里状态变成「已连接」。

  1. 发布应用（最容易漏掉的一步）： 回钉钉开发者后台，点页面上方的「查看版本详情」，填版本描述，点「确认发布」提交，等审批通过（通常很快自动通过）。发布时如果让选可使用范围，先只选你自己。
  2. 测试，两种方式任选：单聊，在钉钉顶部搜索框搜索机器人名称，进入对话发测试指令；群聊，进入群设置，点「机器人」→「添加机器人」，选你创建的机器人，在群里 @它 再发测试指令（群的「归属组织」要和创建机器人时的组织一致）。

没反应时：先查应用有没有发布并通过审批（配好凭证不会自动发布）；三个权限是否都开通了；WorkBuddy 是否在运行、助理是否开启；群里找不到机器人时，检查群的归属组织，并重启钉钉客户端再试。

课堂练习 ​

  1. 绑定微信助理，发一条上面的只读测试指令，确认手机上收到回复。
  2. 打开小程序，登录并选中你的电脑，在里面发一句「你好，请回复收到」，确认能在电脑上看到这个任务。
  3. 设置保持唤醒，写下你离开工位前要检查的三件事。
  4. 在企业微信、飞书、钉钉里选你团队真在用的一个，照上面的步骤接入，并发一条只读测试指令。没有对应平台账号的，就把微信助理和小程序做扎实。

做完的标准： 手机上发出的只读指令能得到回复，你知道账号要一致、电脑要保持运行，并且知道怎么解绑。

⑧ 外接 API 与连接器（40 分钟） ​

WorkBuddy 自带的模型之外，你可以把自己的模型服务接进来，也可以把你在用的工具接进来。这一模块讲两种「外接」：

外接什么怎么接典型用途
模型 API在「设置 → 模型」里添加公司有自己的模型服务、想用某家的模型
工具与数据「连接器」，或自定义连接器邮箱、文档、会议、项目管理等

接入自己的模型 ​

  1. 点左下角「头像」→「设置」→「模型」。
  2. 选择接入方式：
方式怎么用
提供商接入从列表选供应商，或选「自定义 API」。URL、模型列表和能力标记会自动填好，只需要补全 API Key。另有 Token Plan、Coding Plan 两类套餐入口，套餐要先在腾讯云购买
自定义 / Custom供应商列表里没有的服务，手动填写 URL、API Key 和模型名称
  1. 保存。之后新建任务时，输入框里的模型选择器会多出一组自定义模型，可以直接选，也能从那里跳回配置界面编辑。管理操作是「添加 / 编辑 / 删除」。5.9.0 起，模型选择器里还有自定义模型的配置入口，不用先去设置里找。

要填哪几项 ​

你需要从模型服务商的控制台和文档里拿到下面这些，写好再填：

text
提供商：（列表里选；没有就选「自定义 / Custom」）
URL：（服务商文档里的接口地址，标准路径以 /chat/completions 结尾）
API Key：（在服务商控制台创建，只填在软件里）
模型名称：（服务商文档里的模型标识，原样复制，不要自己改）
能力标记：（工具调用、图片输入、推理模式，按这个模型的实际能力勾选）
字段含义
URL模型服务的接口地址
API Key访问第三方模型的凭据，只保存在本地
模型名称要调用的模型标识
能力标记工具调用、图片输入、推理模式等，选标准供应商时会自动写入
自定义协议（高级开关）关闭（默认）：按标准 /chat/completions 路径，自动校验并补全地址；开启：直接用你填的地址发请求，跳过校验和补全，适合经过网关或代理封装的非标准路径

接入后用同一个只读任务验证，并在输入框里确认选中的是你添加的模型：

text
请读取 input/meeting.txt，列出这次会议的 3 条结论，并指出哪些结论在原文里没有明确负责人。
只读取，不要修改任何文件。

外接模型的风险 ​

  • 中转服务有提示： 使用非官方的中转服务时，WorkBuddy 会弹出数据安全风险提醒，看清楚再继续。
  • 费用自己担： 自定义模型的 Token、订阅等全部费用由你向第三方服务商支付，注意盯着对方账户的消耗。
  • 数据去哪了： WorkBuddy 只是通信链路，你的输入会直接转发给第三方模型。接入前先看服务商的协议和隐私政策，涉密材料不要发给不了解的服务。
  • Key 要保管好： API Key 只存在本地，不要在共享电脑上填写或导出；不再使用时，到配置里删除。
  • 稳定性在对方： 第三方模型的可用性、稳定性、安全性和合规性由第三方负责。

连接器 ​

连接器基于 MCP（模型上下文协议）。可以把它理解成 AI 世界的「USB-C 接口」：工具按标准提供一个接口，任何支持这个标准的 AI 应用都能即插即用，不用每个应用单独对接。

目前内置的连接器有：QQ 邮箱、腾讯文档、腾讯乐享、腾讯会议、TAPD、腾讯网盘。也可以点连接器页面右上角的「自定义连接器」，安装自己的 MCP 服务。

怎么用：

  1. 打开「专家·技能·连接器」，进入「连接器」页签，找到目标卡片，点右上方的「+」，按提示登录、授权。
  2. 授权完成后，卡片名称旁会出现绿色圆点，右侧有「去对话」按钮，点它就可以开始。
  3. 也可以在新建任务时，点输入框左下角的「+」→「连接器」，开启需要的连接器。任务里需要还没连接的连接器时，输入框上方会出现引导卡片，授权后任务会自动继续。
  4. 不想用了：在「+」→「连接器」里取消启用，或者在连接器页面选中它并「解绑」。

接入「腾讯会议」后，可以直接复制这句话试一下：

text
帮我创建一个明天下午 3 点的会议，主题「项目讨论」，时长 1 小时。创建前先把会议信息发给我确认。

每个连接器独立授权，只在你下指令时才读取数据。发邮件、创建文档或会议这类写入操作需要你明确确认，对外发送前再核对一次对象和内容。

课堂练习 ​

  1. 有自己的 API Key：按「提供商接入」或「自定义」配置一个模型，用上面的只读任务测试，再用内置模型跑同一个任务，对比结果。
  2. 没有 Key：把「要填哪几项」那五行按你打算接入的服务写完整，并写下每一项去哪里拿。
  3. 授权一个你真在用的连接器，发一条只读或需要你确认的指令，看它怎么暂停等你确认。

做完的标准： 至少有一个外部来源（模型或连接器）用只读任务跑通了一次，你知道费用、数据和密钥三方面的风险在哪里。

⑨ 自动化（45 分钟） ​

适合自动化的，是「时间固定、步骤相似、结果可检查」的工作。用下面六个问题判断，回答「是」越多越适合作为第一批：

  1. 会重复吗：至少每周发生一次，而不是一次性需求
  2. 输入稳定吗：文件夹、网页、表格或连接器来源相对固定
  3. 步骤相似吗：虽然内容变化，但处理方式基本一致
  4. 结果可验收吗：能检查条数、字段、时间范围、来源或文件是否生成
  5. 失败可恢复吗：失败后可以重跑，不会立即造成不可逆损失
  6. 权限可控制吗：可以限定工作目录、账号和允许调用的工具

起点要小。不要写「替我运营整个公司」，而写「每天 8 点收集 10 条行业新闻，去重、保留链接，生成简报到指定目录」。

稳定运行靠五个要素：明确的触发时间、可重复的输入来源、足够具体的提示词、固定受控的工作目录、能判断成功或失败的验收条件。可以直接套用这份模板：

text
任务名称：每日 AI 行业简报
触发时间：每天 08:00，时区 Asia/Shanghai
工作目录：WorkBuddy工作坊/automation/ai-daily
输入：
- 检索过去 24 小时的 AI 产品、模型和行业新闻
- 仅使用可以访问并保留链接的公开来源
处理规则：
1. 合并重复事件，按产品、技术、商业三类整理
2. 每条包含标题、100 字摘要、来源、发布时间和链接
3. 无法确认发布时间或来源的内容放入“待核验”，不要编造
输出：
- 保存为 YYYY-MM-DD-ai-daily.md
- 正文最多 10 条，最后附来源清单

创建时在「自动化」页面点「添加自动化」，依次配置：

配置项填写建议
名称写清对象和频率，如「每日 AI 简报」
提示词用上面的模板，不只写一句口号
工作空间指定执行目录和文件保存位置，每项自动化用独立目录。不指定会自动分配一个 automation 工作空间
权限模式选「默认权限」。任务无人值守，不要用完全访问
模型和技能可以指定模型，以及技能、专家和连接器，只选任务真正需要的
定时规则设置频率和生效日期。每周几天、每月几天都可以写在一条规则里，不要拆成多个任务
通知可以推送到 WorkBuddy 小程序或企业微信 bot，开启前确认哪些结果会同步出去

也可以直接用任务模板，涵盖新闻推送、周报生成、体检预约和学习计划等，但选用后仍要改数据来源、时间范围、输出位置、验收标准和禁止动作。

看结果： 同一个任务的历次运行会按时间线汇总在定时任务页面，可以集中看执行结果和产物；任务完成后会有系统通知，点击就能打开对应产物。配置保存在这台电脑的客户端里，到点以你当前的登录身份运行。任务无人值守，涉及写入、删除的提示词要谨慎；复杂任务积分消耗较高，先低频试运行，确认结果再提高频率。

哪些保留人工检查： 周报汇总，确认进度和风险表述后再发送；销售日报，核对金额、客户状态和负责人；费用与发票整理，财务提交前核对税额和重复票据。

课堂练习 ​

  1. 用六个问题给你的真实任务打分，选出最适合自动化的一个。
  2. 用模板把它改写成完整的任务说明，在「自动化」里创建，把时间设在几分钟之后，在课堂上等它触发一次。
  3. 触发后在运行记录里打开结果，检查：产物在哪里、内容对不对、出错时先看哪里。

做完的标准： 自动化任务至少成功运行了一次，并且你知道结果会出现在哪里、出错时先看哪里。

课后怎么继续 ​

  1. 第一周： 每天用一次今天练过的那个任务，哪里不顺手就改任务说明。
  2. 第二周起： 把反复出现的要求固化成自己的 Skill，把常用的角色做成自己的专家。
  3. 再往后： 在团队常用的聊天软件里接入机器人，把外接模型和连接器用到真实业务里，并把多个专家搭成一支协作的团队。

最后更新:

以真实任务为主线的 WorkBuddy 社区实战读本 · Pixel icons by HackerNoon

Copyright © 2026 WorkBuddy Guide Contributors