课前准备：连接知识库与 AI 写作
适用课次：第 13 次课《WorkBuddy 连接器：给 AI 接上你的知识库》 目标：课前完成 WorkBuddy 登录、飞书连接器授权、QQ 邮箱与腾讯会议选做授权，并下载本课论文素材。 完成标准：WorkBuddy 能列出你的飞书文档；
D:\AIGC\lesson-13下有 DeepSeek-R1 论文 PDF。邮箱、会议授权按任课教师要求选做，课上现扫也来得及。
1. 硬件与软件检查
| 检查项 | 课堂建议 | 说明 |
|---|---|---|
| WorkBuddy | 已登录桌面端 | 连接器授权和所有实操的入口 |
| 浏览器 | 最新版 Chrome / Edge | 打开飞书网页版、arXiv 和课程资料页 |
| 网络 | 可同时访问飞书与 arXiv | 课前在机房网络下各打开一次试通 |
| 账号 | 你自己的飞书账号 | 授权绑定个人账号，共用会互相顶下线 |
| QQ 邮箱 | 已开通 SMTP/IMAP 或网页版可登录 | 案例⑤选做，按老师要求课前授权 |
| 腾讯会议 | 已安装客户端并登录 | 案例⑥选做，按老师要求课前授权 |
本课最容易卡住的是授权，不是操作。 三类连接器各自独立：飞书是 M1、M2 的必做项，邮箱和会议是 M3 的选做项。授权成功的标志见第 3 节，每完成一个就在检查表打勾。
2. 下载论文素材（必做，课前完成）
打开本课资料页的「案例①素材」，进入 arXiv 官方页（
https://arxiv.org/abs/2501.12948），点右侧 View PDF 下载。把 PDF 存到本机课程目录
D:\AIGC\lesson-13（目录不存在就新建一个），文件名保持默认即可。执行后你会看到：D:\AIGC\lesson-13里有一个 DeepSeek-R1 的 PDF 文件。课堂解析只用前 20 页：打开 PDF 后确认总页数，超过 20 页不影响使用——提示词里 AI 会通读全文，太长时老师会发布指定的截取版本。
案例②的网页链接和案例③的日报结构都写在讲义提示词里，无需提前下载任何文件。
为什么课前下载：课堂 30 分钟的 M1 要留给操作本身，不要浪费在等一个 5MB 的 PDF 从 arXiv 慢慢爬下来；机房网络对境外站点时快时慢，课前下好是最稳的兜底。
3. 连接器授权（按连接器分组，每类只授权一次）
飞书（M1、M2 必做）
- 打开 WorkBuddy，左侧边栏进入「专家·技能·连接器」，搜索
飞书，点「连接」。 - 在授权页里用你自己的飞书账号扫码，勾选读取文档和创建文档权限后确认。执行后你会看到（授权成功的标志）：连接器列表里「飞书」显示已连接，并且你在 WorkBuddy 对话框里说「列出我的飞书云文档」时，AI 能报出你的文档列表。
- 加入教师建的「班级测试空间」（邀请链接或二维码由老师课前发到学习通），确认能在飞书里看到这个空间。
- 授权页若出现删除文档、批量管理等权限，一律不勾——本课只用读和写。
QQ 邮箱（案例⑤，选做，按任课教师要求）
- 进「专家·技能·连接器」，搜索
QQ 邮箱，点「连接」。 - 授权页只勾读取邮件；出现删除、代发、退订等权限一律不勾。执行后你会看到：连接器列表里「QQ 邮箱」显示已连接。
- 自查：在 WorkBuddy 里说「读取我最近的 3 封邮件」，AI 能报出正确的发件人。
腾讯会议（案例⑥，选做，按任课教师要求）
- 进「专家·技能·连接器」，搜索
腾讯会议，点「连接」。 - 授权页确认权限包含创建会议。执行后你会看到：连接器列表里「腾讯会议」显示已连接。
- 自查：在 WorkBuddy 里说「帮我查一下我明天有没有会议」，AI 能给出正确结果或「无会议」。
4. 课前验证清单（老师用，课前 10 分钟走一遍）
| 检查项 | 操作 | 通过标准 |
|---|---|---|
| WorkBuddy 登录 | 打开桌面端确认已登录 | 主界面正常，能进「专家·技能·连接器」 |
| 飞书连接器 | 对话框发「列出我的飞书云文档」 | AI 列出真实文档列表 |
| 飞书写入 | 让 AI 新建一篇测试文档再手动删除 | 文档出现在你的飞书云文档里 |
| ima 备用连接 | 「专家·技能·连接器」搜 ima 确认可连接 | 列表里 ima 显示可连接（备用方案用） |
| QQ 邮箱（选做） | 对话框发「读取我最近 3 封邮件」 | 报出的发件人与真实邮箱一致 |
| 腾讯会议（选做） | 说「帮我查明天有没有会议」 | 返回正确日程或「无会议」 |
| 论文 PDF | 打开 D:\AIGC\lesson-13 | PDF 存在且能打开 |
5. 可选安装：记笔记 skill
本项不影响课堂主线。想提前体验“把长文稳定整理成结构化笔记”的同学，可以在 WorkBuddy 对话框发送：
请帮我安装这个 skill：https://github.com/VinsonLiangyc/content-digestion
安装完成后告诉我如何触发它。只安装这个仓库里的 content-digestion skill，不要安装其他无关工具。安装成功的标志：WorkBuddy 能说出触发方式，并能用本课 DeepSeek-R1 论文生成一份中文结构化笔记。课堂会再次给出完整使用提示词；未安装成功时直接使用讲义案例①的普通提示词。
6. 常见故障与处理
- 飞书扫码后 WorkBuddy 一直「连接中」：刷新授权页重扫；仍不行就换手机热点再试一次。课前还没搞定的，上课先跟同桌共用一台机器看演示，课后再单独授权。
- 授权成功但 AI 读不到文档：先确认连的是本人账号（列表里显示的账号名是你的名字）；再确认文档在「我的文档」而不是他人共享给你的只读目录。
- ima 索引延迟：本课主线用飞书，不走 ima；如果老师启用 ima 备用方案，注意刚上传的文件要等几分钟才能被检索到，属于正常现象，等待期间先做后面的步骤。
- QQ 邮箱授权失败：确认邮箱已开启 IMAP 服务（QQ 邮箱设置-账户里开）；上课时间不够就放弃案例⑤，只做案例⑥。
- arXiv 下载慢或打不开：用老师课前发布到学习通的镜像链接或直接下载好的 PDF。
7. 课前自查完成标准
全部满足才算是「课前准备完成」：
- WorkBuddy 已登录，能进「专家·技能·连接器」；
- 飞书已连接，AI 能列出你的文档清单；
D:\AIGC\lesson-13里有论文 PDF；- （选做）QQ 邮箱、腾讯会议已连接并通过自查。