literature-review

name	literature-review
description	文献综述自动化工具。当用户需要批量检索学术文献、提取文献信息、生成文献综述CSV时使用。触发词包括"文献综述"、"检索文献"、"批量提取文献信息"、"帮我查这些文献"等。该skill会自动登录华南农业大学VPN，访问知网等学术数据库，批量检索文献并提取结构化信息。
allowed-tools	Bash(npx agent-browser:*), Bash(agent-browser:*)

文献综述自动化 Skill

功能概述

本 Skill 用于学术文献的批量检索与结构化信息提取。通过自动化浏览器操作，完成以下任务：

1. 自动登录华南农业大学 VPN
2. 访问学校学术数据库（知网等）
3. 逐一检索文献，点击跳转至该文献的完整信息界面
4. 提取文献信息（特别是完整摘要），记录后返回学术库继续下一篇文献检索
5. 将所有记录的文献信息整理成 CSV 文件

输出格式

生成的 CSV 包含以下列： | 序号 | 文献完整题目 | 全部作者 | 发表时间 | 发表期刊/来源 | 完整原文摘要 | 检索备注 | 是否收集到了pdf |

执行流程

第一步：登录 VPN

# 1. 打开 VPN 登录页面
agent-browser open https://vpn.scau.edu.cn/portal/#!/login

# 2. 等待页面加载
agent-browser wait --load networkidle

# 3. 获取页面快照，确认元素
agent-browser snapshot -i
# 实际返回的元素：
# - tab "账号登录" [ref=e1] [selected]
# - tab "扫码登录" [ref=e2]
# - textbox "请输入您的账号" [ref=e3]
# - textbox "请输入密码" [ref=e4]
# - checkbox "记住密码" [ref=e5]
# - button "登 录" [ref=e6]

# 4. 填写账号密码（注意：使用时不带@符号）
agent-browser fill e3 "30004587"
agent-browser fill e4 "MLA24601"

# 5. 勾选记住密码
agent-browser check e5

# 6. 点击登录按钮
agent-browser click e6

# 7. 等待登录完成
agent-browser wait --load networkidle
# 登录成功后会跳转到学校首页或认证页面

VPN 登录凭据：

• 账号：30004587
• 密码：MLA24601（注意大小写）

VPN登录页面元素Ref对照表：

元素	ref	说明
账号登录标签	e1	已选中
扫码登录标签	e2	切换扫码登录用
账号输入框	e3	填写账号
密码输入框	e4	填写密码
记住密码复选框	e5	勾选记住密码
登录按钮	e6	点击登录

第二步：访问知网

# VPN 登录成功后，访问知网镜像站
agent-browser open https://ss-zhizhen-com-s.vpn.scau.edu.cn/

# 等待页面加载
agent-browser wait --load networkidle
agent-browser snapshot -i
# 实际返回的元素：
# - link "欢迎来自华南农业大学的朋友" [ref=e1]  # 确认登录成功
# - textbox "请输入检索词" [ref=e11]  # 搜索框
# - button "检索" [ref=e12]  # 搜索按钮
# - link "高级检索" [ref=e13]
# - link "检索历史" [ref=e14]

知网首页元素Ref对照表：

元素	ref	说明
欢迎信息	e1	确认登录成功
搜索框	e11	输入检索词
检索按钮	e12	点击搜索
高级检索	e13	进入高级检索
检索历史	e14	查看历史

第三步：批量检索文献

对于用户提供的每条文献，执行以下操作：

# 1. 输入文献题目到搜索框（使用 ref e11）
agent-browser fill e11 "文献题目"

# 2. 点击搜索按钮（使用 ref e12）
agent-browser click e12

# 3. 等待搜索结果加载
agent-browser wait --load networkidle
agent-browser snapshot -i

# 搜索结果页关键元素示例：
# - link "摘要" [ref=e61]  # 点击可切换到摘要视图
# - link "列表" [ref=e62]  # 点击可切换到列表视图
# - link "文献标题..." [ref=e66]  # 第一条搜索结果的标题，点击进入详情
# - link "被引量：31" [ref=e70]  # 被引次数

# 4. 切换到摘要视图获取更多信息
agent-browser click e61  # 点击"摘要"标签
agent-browser wait --load networkidle

# 5. 点击进入详情页获取完整信息
agent-browser click e66  # 点击第一条文献标题
agent-browser wait --load networkidle
agent-browser snapshot -i

# 详情页关键元素：
# - link "作者名" [ref=e21,e22,e23...]  # 各作者链接
# - link "期刊名" [ref=e32]  # 期刊名称
# - link "关键词" [ref=e34,e35,e36...]  # 关键词链接
# - button "全部展开" [ref=eXX]  # 展开完整摘要（如有）

# 6. 查找并点击"全部展开"按钮（获取完整摘要的关键步骤）
# 注意：详情页的摘要可能被截断，需要点击"全部展开"才能看到完整内容
agent-browser snapshot -i
# 查找"全部展开"或"展开全部"或"查看更多"按钮
# 如果存在该按钮，点击展开完整摘要
# agent-browser click eXX  # 点击"全部展开"按钮
agent-browser wait --load networkidle

# 7. 获取完整摘要文本
agent-browser get text body
# 提取完整信息：标题、全部作者、发表时间、期刊、完整摘要

# 7. 返回搜索结果页，继续下一条
agent-browser open https://ss-zhizhen-com-s.vpn.scau.edu.cn/
agent-browser wait --load networkidle

搜索结果页元素Ref对照表：

元素	ref	说明
摘要视图	e61	切换到摘要显示
列表视图	e62	切换到列表显示
第一条文献标题	e66	点击进入详情
第一条被引量	e70	查看被引次数

详情页元素Ref对照表：

元素	ref	说明
作者链接	e21,e22...	各作者信息
期刊名称	e32	发表期刊
关键词	e34,e35...	文献关键词
全部展开按钮	待确认	展开完整摘要

第三步半：详情页完整摘要获取（重要）

⚠️ 关键流程：搜索结果页的摘要是截断的，必须进入详情页才能获取完整摘要

# 进入详情页后
agent-browser snapshot -i

# 查找以下任一按钮（ref 需根据实际页面确认）：
# - "全部展开"
# - "展开全部" 
# - "查看更多"
# - "显示更多"

# 如果存在展开按钮，点击它
agent-browser click eXX  # 替换为实际的"全部展开"按钮ref
agent-browser wait --load networkidle

# 获取完整页面内容
agent-browser get text body

完整摘要提取要点：

1. 搜索结果页的摘要通常被截断（以"..."结尾）
2. 必须点击文献标题进入详情页
3. 详情页可能有"全部展开"按钮需要点击
4. 使用 get text body 获取整个页面内容后，从中提取完整摘要

第四步：信息提取规则

匹配规则：

• 输入为完整题录/完整或近似文献题目时，精确匹配
• 所有输出信息 100% 来自页面真实结果
• 检索无结果 → 标注「未检索到」

异常处理：

• 遇到验证码 → 标注「需人工介入处理」，跳过该条目
• 遇到登录认证问题 → 标注「需人工介入处理」
• 遇到付费权限问题 → 标注「需人工介入处理」
• 不要卡在异常处，立即跳过继续下一条

第五步：生成 CSV

检索完成后，按以下格式生成 CSV 文件：

序号,文献完整题目,全部作者,发表时间,发表期刊/来源,完整原文摘要,检索备注,是否收集到了pdf
1,文献全称,作者1;作者2;作者3,2024年,期刊名称,完整摘要内容...,成功检索,是
2,另一篇文献,作者A;作者B,2023年,会议名称,摘要内容...,未检索到,否

第六步：输出统计信息

📊 检索结果统计
- 本次接收待检索条目共：X 条
- 成功匹配并提取信息：X 篇
- 未检索到有效结果：X 条
- 需人工介入处理：X 条
- 多匹配结果留存：X 篇

会话持久化（重要）

为了保存登录态，避免重复登录：

# 使用 session 参数保存会话状态
agent-browser --session scau-vpn open https://vpn.scau.edu.cn/portal/#!/login

# 登录后，状态会自动保存
# 下次使用相同 session 名称即可恢复登录态
agent-browser --session scau-vpn open https://ss-zhizhen-com-s.vpn.scau.edu.cn/

有头模式（调试用）

遇到问题需要人工介入时，使用有头模式：

# 启动有头模式（显示浏览器窗口）
agent-browser --headed open https://vpn.scau.edu.cn/portal/#!/login

# 用户可以手动处理验证码等特殊情况

常见问题处理

1. 验证码问题

# 检测到验证码时，启动有头模式让用户手动处理
agent-browser --headed snapshot -i
# 提示用户：检测到验证码，请在浏览器窗口中手动完成验证

2. 登录态过期

# 重新登录 VPN
agent-browser --session scau-vpn open https://vpn.scau.edu.cn/portal/#!/login
# 重新执行登录流程

3. 页面加载慢

# 使用更长的等待时间
agent-browser wait --load networkidle
agent-browser wait 3000  # 额外等待3秒

完整示例

# 用户输入：帮我检索以下文献
# 1. 南亚热带马尾松人工林根系生物量分布格局
# 2. 草灌植物根系对煤系土加固效果研究

# ========== 第一步：登录 VPN ==========
agent-browser --headed open https://vpn.scau.edu.cn/portal/#!/login
agent-browser wait --load networkidle
agent-browser snapshot -i

# 填写登录信息（ref: e3=账号, e4=密码, e5=记住密码, e6=登录）
agent-browser fill e3 "30004587"
agent-browser fill e4 "MLA24601"
agent-browser check e5   # 勾选记住密码
agent-browser click e6   # 点击登录
agent-browser wait --load networkidle

# ========== 第二步：访问知网 ==========
agent-browser open https://ss-zhizhen-com-s.vpn.scau.edu.cn/
agent-browser wait --load networkidle

# ========== 第三步：检索第一条文献 ==========
agent-browser snapshot -i

# 检索第一条（ref: e11=搜索框, e12=搜索按钮）
agent-browser fill e11 "南亚热带马尾松人工林根系生物量分布格局"
agent-browser click e12
agent-browser wait --load networkidle

# 切换到摘要视图（ref: e61=摘要标签）
agent-browser click e61
agent-browser wait --load networkidle
agent-browser snapshot -i

# 进入详情页获取完整信息（ref: e66=第一条文献标题）
agent-browser click e66
agent-browser wait --load networkidle
agent-browser snapshot -i

# ⚠️ 关键步骤：点击"全部展开"获取完整摘要
# 查找页面上是否有"全部展开"或"展开"按钮
# 如果存在，点击展开完整摘要
# agent-browser click eXX  # eXX 为"全部展开"按钮的实际ref

# 获取完整页面内容
agent-browser get text body
# 从页面内容中提取：完整标题、全部作者、发表时间、期刊名称、完整摘要
# 记录提取的信息...

# 返回知网首页，准备检索下一条文献
agent-browser open https://ss-zhizhen-com-s.vpn.scau.edu.cn/
agent-browser wait --load networkidle

# ========== 第四步：检索第二条文献 ==========
agent-browser fill e11 "草灌植物根系对煤系土加固效果研究"
agent-browser click e12
agent-browser wait --load networkidle
# ... 重复上述提取流程（进入详情页→展开摘要→记录信息→返回）...

# ========== 循环：继续检索剩余文献 ==========
# 对每条文献重复：搜索 → 进入详情页 → 展开摘要 → 提取信息 → 返回学术库

# ========== 最后一步：生成 CSV 并输出统计 ==========

注意事项

1. 严格按顺序执行：必须先登录 VPN，再访问知网
2. 不编造信息：所有输出必须来自页面真实结果
3. 完整摘要：原文摘要必须 100% 完整复制，不得截断、改写
4. 异常跳过：遇到问题立即跳过，不要卡住
5. 会话管理：使用 session 参数保持登录态
6. Ref不带@：使用 fill/click/check 等命令时，ref 不需要带 @ 符号
   • 正确：agent-browser fill e11 "内容"
   • 错误：agent-browser fill @e11 "内容"