本页目录
接工具
1. 工具装不上，卡在下载。
先看它用的是不是国内镜像：npm 应是 https://registry.npmmirror.com，pip 应是清华或阿里云的源。不是的话，把工具说明“安装与配置”一节的提示词重新发给它，提示词里写了换源的命令。GitHub 在国内能打开，但慢、时好时坏，能走镜像就不走 GitHub。
2. Claude Code 里 /mcp 看不到 playwright。
多半是装好后没有退出重开 Claude Code。输入 /exit 退出再启动，输入 /mcp 看。换一个文件夹启动还看不到，说明只装到了某一个项目里，按 Playwright MCP 工具说明 用户作用域的写法重装。
3. WorkBuddy 里登记了 Playwright 连接器，任务里还是用不了。
先看连接器状态灯：红色是配置有误，Windows 上多半是找不到 playwright-mcp，按工具说明第 3.5 节改用 node 加 cli.js 的完整路径。状态变绿后要新建一个任务，已经打开的旧任务里加载不到新登记的工具。
4. 它说“没有浏览器”或要下载浏览器。 Playwright 默认用本机的 Chrome，Windows 上没装 Chrome 的可以用系统自带的 Edge，见工具说明里“前置条件”一节。不用另外下载浏览器。
练习一：采集岗位
5. 它说页面是空的，没有岗位。 它用的是只读网页正文的工具。这个网站的岗位列表要等网页里的程序加载出来，只读源码拿到的是一个空框架。告诉它“用浏览器工具打开，等列表加载出来再读”。
6. 它说“已打开第 2 页”，采到的却和第 1 页一样。 两种可能：一是它想靠网址翻页，这个网站翻页时网址不变，打开的还是第 1 页；二是点了“>”马上就读，列表还没刷新。让它点分页栏的“>”，等第一条职位名称变了再读。
7. 分页栏有 5 页，后面几页却是空的。
这个网站的分页栏不管有多少条结果都画 1 2 3 4 5 >，不代表真有 5 页。判断采完了，看这一页是不是不满 10 条。另外，不登录只能看前 5 页，点第 6 页会弹出“请登录后查看”。练习一第 5 步就是让你看这两件事。
8. 选“广州”搜不到岗位。 多数岗位的地区只登记到省一级，按城市筛会漏掉。练习一用“全国”。
9. 我采到的 30 条和同桌不一样，和手册也不一样。 正常。平台的岗位每天在更新，几分钟之内排在前 3 页的岗位都可能变。比较时先对齐采集时间和搜索条件；条件和时间相近、结果差很多的，再翻工具记录找原因。
10. 按“职位名称+单位”数只有 28 条，是不是采重复了？
不一定。同一家单位会发两个同名岗位，职位ID 不同，算两条。按职位ID 数是 30 条，就没有重复。职位ID 在职位名称的链接里，见 采集要求.md。
11. 招聘人数“不限”怎么填？ “招聘人数”列留空，“招聘人数原文”列照写。写成 0 的话，求和、求平均时会被当成 0 人。
12. 网站打不开，或者浏览器工具一直接不上。
用材料包里的 备用数据/jobs_备用_20261019.csv 做第 3 步的核验脚本，在采集记录里写明用的是备用数据。
13. 它绕过浏览器，直接请求了一个网址拿到了数据，算不算完成？ 这个网站的列表数据是网页从一个接口取来的，智能体有时会找到这个接口直接请求，结果和浏览器采的一样。这对应课件“能走接口，就别爬网页”。练习一要练的是浏览器翻页，可以让它两种都做，再对比两份 CSV 是否一致。
练习二：核文献
14. Semantic Scholar 一直返回 429。 429 是请求太多，被限流了，不是文献不存在。等几秒再试；还不行就改用 Crossref。不要因为 429 把文献判成“未找到”。
15. DOI 返回 404，能直接判“未找到”吗？ 先查 DOI 是不是抄错了，再用题名加第一作者到 Crossref 和 Semantic Scholar 各查一次，都查不到才判“未找到，需人工核查”。
16. 它给出了一篇查不到的文献的摘要。 那是它编的。文献库查不到的文献，智能体给出的摘要、页码、卷期都不能采信。在对话里指出来，让它改成“未找到，需人工核查”。
17. 中文文献查不到，是不是假的？
不是。Crossref、Semantic Scholar 收录的中文期刊很少。按 核验要求.md 填“论断未核验”，再用 CNKI Skills 或自己到知网查。
18. 年份差一年算不算信息有误？ 工作论文和正式发表常差一年，对照时要看清清单给的是哪个版本。清单写的是期刊、卷期和 DOI 的，以这个 DOI 在 Crossref 的记录为准，期刊名、卷期页对不上就是信息有误。
19. “支持”还是“不支持”拿不准。 把综述那句话拆成几个部分（对象、方向、数字、范围），逐个到摘要里找。找不到对应的部分，或者摘要讲的是另一件事，就是不支持；读不到摘要的，写“论断未核验”。
19a. 第 2 步为什么不直接装文献核验技能？ 这一次要看清智能体自己怎样调用接口、哪里出错，第 5 步再把这套做法写成技能。先把一件事做对，再把做对的方法写成技能，和 W04 一样。
19b. 在 WorkBuddy 里打 /skill 看不到 skill-creator。
先确认拷的是整个 02_文献核验 文件夹：.workbuddy/skills/skill-creator/SKILL.md 要在（隐藏文件夹，Mac 访达按 Command + Shift + . 显示；Windows 资源管理器“查看”里勾选“隐藏的项目”）。有的话，点“新建任务”、重新选 文献核验 工作空间再看：WorkBuddy 同一个任务里新出现的技能不会进列表。Claude Code 看的是 .claude/skills/，退出重开后 /skills 里才有。
19c. 草稿里把这 6 条文献写进去了。 让它删掉：“技能要能核任何一份清单，不要写具体文献；需要例子的话，用虚构的写法示意。”删完再发第二段。
19d. 脚本版核验表和第一次不一样。 先看是哪一列。“是否支持原句”要读摘要，脚本版空着是对的。第 6 条中文文献，你在第 4 步用知网改判过的，脚本只查国际库，两者不同也是对的。“是否存在”“信息是否一致”不一样，就让它说出脚本的比对规则，改脚本再跑一遍。
练习三到六
课上四条演示改成的练习，常见问题写在上机材料各练习的“常见问题”一节。