第一篇：先把 WorkBuddy 安全地用起来
这一篇从最朴素的用法开始：建立隔离的练习工作区，完成一项会议纪要任务，再沿着实际界面认识 Skill、专家、连接器和自动化。十章读完，手里会留下一套能复用的操作方法。
这篇教程按什么版本写
这篇教程以腾讯 WorkBuddy 官方文档 为核对基线，章节结构参考 WorkBuddy 社区实战蓝皮书，书中的实操截图来自 macOS WorkBuddy v5.3.14。
三者偶尔会出现叫法或位置差异。例如 v5.3.14 的界面写“默认模式”，当前官方文档称为“做一做（Craft）”。本书会把这种对应关系直接写出来。你实际使用时，判断顺序是：
- 先看本机当前版本和界面；
- 再查腾讯官方文档和更新说明；
- 最后服从组织的 IT、安全、数据和 SOP 要求。
官方文档能说明产品如何操作，但不能替你的组织批准临床试验数据进入某个模型、Skill 或连接器。
先把几个概念说清楚
本篇反复出现的词，指向的是不同层次。可以先按下面的定义理解，后面看到产品按钮时不容易把“方法”“工具”和“权限”混成一件事。
| 概念 | 本书里的意思 | 使用时要记住 |
|---|---|---|
| WorkBuddy | 桌面 AI 工作台：接收任务说明和材料，调用模型与已启用的能力，生成工作草稿 | 它辅助加工，不替代正式系统、专业判断或批准人 |
| 任务 | 一次完整的工作记录，包含输入、配置、执行过程和输出 | 任务结束后要检查产物、工作区和留痕 |
| 工作区 | WorkBuddy 当前可以读取或写入的本地目录范围 | 目录越宽，误读材料和误写文件的范围越大 |
| 权限 | 对文件、系统和动作的允许范围 | 只给当前任务需要的权限，默认从只读开始 |
| 模式 | WorkBuddy 处理任务的方式，例如 Ask、Craft、Plan | 模式影响执行步骤，不会降低数据和复核要求 |
| 模型 | 负责理解材料、生成文本或执行推理的 AI 引擎 | 模型或版本变化后，同一任务要重新验证 |
| Skill（技能） | 把一类任务的规则、步骤、指令和工具入口打包成可重复调用的组件 | Skill 是方法包，不是专业资质，也不是组织批准 |
| 专家 | 一套角色化的提示和工作方法配置 | “专家”这个标签不会带来临床资质或签字权 |
| 资料库/知识库 | 可以被搜索和引用的材料集合 | 搜得到不等于当前有效、属于本项目或获准使用 |
| 连接器 | WorkBuddy 与邮箱、网盘、文档或业务系统之间的连接桥 | 连接后会扩大可读、可写或可发送的范围 |
| Agent | 能分解任务，并按配置调用模型、文件和工具的一种软件工作方式 | 能执行不等于能批准；高影响动作仍需人工关卡 |
| API | 让一个软件按约定访问另一个软件数据或动作的接口 | API Key 是凭证，不应放进提示词、文件或截图 |
| MCP | 一种把工具或数据接口提供给 Agent 使用的连接方式 | 需要查看它背后的服务、账号、动作和权限 |
| 自动化 | 按时间或条件重复运行的任务配置 | 保存前要写清来源、失败处置、复核人和停用条件 |
| SOP | 标准操作流程文件，规定谁在什么条件下按什么步骤完成工作 | AI 草稿要回到获批 SOP，不把模型输出直接当成流程 |
临床试验里的缩写也按同样的方式理解：
| 缩写 | 含义 |
|---|---|
| GCP | Good Clinical Practice，临床试验质量管理与受试者保护所遵循的规范原则 |
| EDC | Electronic Data Capture，电子数据采集系统 |
| CTMS | Clinical Trial Management System，临床试验管理系统 |
| eTMF | electronic Trial Master File，电子试验主文件系统或文件集合 |
| ICF | Informed Consent Form，知情同意书 |
| AE / SAE | Adverse Event / Serious Adverse Event，不良事件 / 严重不良事件 |
| QA / QC | Quality Assurance / Quality Control，质量保证 / 质量控制 |
| CRC / CRA | Clinical Research Coordinator / Associate，临床研究协调员 / 监查员 |
| DM / PV | Data Management / Pharmacovigilance，数据管理 / 药物警戒 |
| HIS / QMS | Hospital Information System / Quality Management System，医院信息系统 / 质量管理系统 |
| OCR / CSV | Optical Character Recognition / Comma-Separated Values，光学字符识别 / 逗号分隔值文件 |
本篇案例主线
贯穿本篇的是一份虚构的中心启动准备会记录。WorkBuddy 会从 input/meeting.txt 提取结论、行动项和待确认问题，再到 output/ 里生成 Markdown 会议纪要和 CSV 行动项清单。后面讲工作区、权限、模型、任务卡和人工验收时，都会回到这次操作，不另外编一套空案例。
章节与交付物
| 章节 | 要解决的问题 | 完成本章后的交付物 |
|---|---|---|
| 第 1 章 | WorkBuddy 能做什么、不能做什么 | 一张岗位任务边界表 |
| 第 2 章 | 本机能打开是否等于能用于项目 | 环境准入检查记录 |
| 第 3 章 | 如何选工作区、权限、模式和模型 | WB-GCP-001 练习工作区 |
| 第 4 章 | 怎样从任务描述得到可验收产物 | 会议纪要与行动项 CSV |
| 第 5 章 | 怎样让一次成功变成可复用流程 | 一张 GCP AI 任务卡 |
| 第 6 章 | 邮件、截图、扫描件和乱表格怎么进场 | 材料接收与脱敏清单 |
| 第 7 章 | Skill 能否直接安装使用 | Skill 验证记录 |
| 第 8 章 | 多角色如何协作又不稀释责任 | 三角色复核流程 |
| 第 9 章 | 接入资料和系统会扩大什么风险 | 最小权限登记表 |
| 第 10 章 | 自动化如何可停、可查、可复核 | 法规监测自动化任务卡 |
官方使用手册与本书的章节结构并不一一对应。本书保留安装、主界面、第一个任务、Skill、专家、连接器和自动化，又加入任务卡与脏材料处理；小程序、IM 助理和远程控制则放在权限章节说明准入条件，不把它们设为 GCP 新手的默认配置。
练习工作区
text
WB-GCP-001/
├── input/ # 只读输入
├── reference/ # 边界与参考材料
└── output/ # WorkBuddy 产物练习材料已经放在 sample-files/WB-GCP-001。整套数据都是虚构的。第一次跟做时保留原样，不要使用真实受试者资料试手。
贯穿全篇的四项检查
- 任务前：判断数据与权限是否允许。
- 任务中：限制来源、动作和写入范围。
- 任务后：逐条回查来源，保留未知，指定人工复核人。
- 定稿前：回到组织批准的系统、模板和签核流程。