学术检索助手 yui-hanasaka/dsh-academic-toolkit

dsh-academic-toolkit 使用说明

给 DSH 加一组"学术检索 + 下载 + 阅读"工具：通过你本机已登录学校 CARSI 的调试 Chrome检索学校已购资源，按学校权限下载 PDF，并把论文读成可整理的结构化文本（文本层优先，必要时高精度 OCR）。

工具列表

| 工具 | 作用 |
| academic_status | 检查调试浏览器、知网/万方机构登录态、学校身份、论文目录与 OCR 配置 |
| academic_browser_start | 启动调试 Chrome（默认端口 9222，独立配置目录保留登录态） |
| academic_open_login | 打开学校 CARSI 登录入口（知网），登录态过期时用 |
| academic_login | 用学号+密码重新登录 CARSI，并自动恢复知网/万方会话（密码不落盘） |
| academic_open_carsi | 打开指定库的 CARSI 入口：cnki/wanfang/wos/sciencedirect；也可用 resource 参数按资源 id/名称打开任意已购资源 |
| academic_carsi_resources | 列出学校 CARSI 资源（按校购/免费/试用过滤），配合上面工具直接打开 |
| academic_search | 检索知网/万方（支持 page 翻页）、Web of Science、ScienceDirect |
| academic_paper | 读取文献详情：摘要、关键词、期刊、年份、卷期、页码、DOI、PDF 链接 |
| academic_download | 用浏览器登录态下载 PDF 到论文目录，返回保存路径 |
| academic_read | 读本地 PDF：文本层优先；子集字体/扫描件自动转 OCR。path 支持绝对路径或论文目录下的文件名（宿主内不要带 papers/ 前缀） |
| academic_cite | 生成标准引用：GB/T 7714-2015（默认）/ APA 7 / BibTeX |

前置条件

1. 调试 Chrome（只监听本机）：运行 scripts/start-chrome.ps1（默认端口 9222、配置目录 D:\chrome-debug）。窗口不要关，登录态保存在该配置目录。
2. 学校 CARSI 登录：知网用 academic_open_login，在弹出的窗口里用学号+密码登录学校统一身份认证（一次即可，由 cookie 保持）。
3. 万方机构绑定：在调试浏览器打开 <https://fsso.wanfangdata.com.cn>，选择你学校完成统一认证；页面显示"绑定机构 <你学校>"即检索/摘要可用。万方全文下载一般还需要在该浏览器里登录一次万方个人账号（登录后重试 academic_download）。
4. OCR（可选但建议）：Gemini 视觉 OCR 走本机 Antigravity（Google 账号）订阅 + 本机代理；没有的话把 ocrModel 留空，用 Windows 内置 OCR（扫描件识别质量一般，有文本层的 PDF 不受影响）。

典型用法

1) 学术助手，先 academic_status 看看状态
2) academic_search 查 "多模态桌面智能体"，db 用 wanfang（覆盖更全）或 cnki
3) academic_paper 看摘要和 DOI，academic_download 下载到论文目录
4) academic_read 读 PDF，整理成文献笔记/综述

配置（profile cordis.patch.yml 的 academic-toolkit 行）

| 字段 | 默认 | 说明 |
| browserEndpoint | http://127.0.0.1:9222 | 调试浏览器 CDP 地址 |
| chromePath | Chrome 安装路径 | 浏览器没启动时用于拉起 |
| chromeProfileDir | D:/chrome-debug | 独立浏览器配置目录（登录态） |
| papersDir | D:/papers | PDF 保存目录 |
| proxy | 空 | Gemini OCR 走的代理（如 http://127.0.0.1:7887） |
| ocrModel | gemini-3.8-flash-high | 视觉 OCR 模型；留空则用 Windows 本地 OCR |
| pdftotextPath | 空（搜 PATH） | poppler pdftotext，用于文本层提取 |
| powershellPath | 空（系统 PowerShell） | OCR/渲染脚本入口 |
| profileNodeModules | 空（desktop profile 的 node_modules） | 供 OCR 脚本加载代理/鉴权模块 |
| ocrMaxPages | 10 | 单次 OCR 最多页数（控制耗时/额度） |
| schoolName | 空（必须填写） | 学校全称，CARSI 门户选校用 |
| idpEntityId | 空（自动识别） | 学校 Shibboleth IdP 地址；同校可留空（自动学习），他校可手填 |

验证（重启 DSH 之后）

1. 新开一个对话（插件工具在会话创建时装配）并让助手调用 academic_status；
2. 应看到 browser.alive: true、cnki.loggedIn: true、wanfang.loggedIn: true、plugin.version: "0.9.0"；
3. academic_search 与 academic_download 各跑一次，确认论文目录出现 PDF 且 academic_read 能读出正文；
4. 插件加载记录：%USERPROFILE%\.dsh\academic-toolkit\state.json；学校 IdP 识别缓存：%USERPROFILE%\.dsh\academic-toolkit\identity.json。

说明与限制

- 文本层优先：知网/万方 PDF 多数带文本层（poppler 直接提取，秒级、零成本）；只有子集字体/扫描件才走 OCR。OCR 单页约 30-60 秒，关键数字（页码、DOI、统计量）建议抽检。
- 登录过期：会话几小时后失效；academic_status 会显示 loggedIn:false。用 academic_login 重新认证即可（各人自己的学号密码）。插件不保存密码。
- 万方下载：机构绑定只保证检索/摘要；全文下载若返回 HTML，请先在调试浏览器里登录万方个人账号再重试。
- ScienceDirect 下载：PDF 端有 Cloudflare 人机验证（403）；在调试浏览器里手动过一次验证（cookie 保留）后重试；仍失败则在浏览器里手动下载。
- Web of Science：可检索并返回结果量；题录（标题/作者/摘要）需先在调试浏览器里完成 WoS 机构/个人 Sign In。
- 只本地、只自己：所有访问都在这台机器、你自己的登录态下进行；不共享 cookie、不批量并发下载（避免触发出版社风控封学校出口 IP）。
- 安装方式：desktop profile 的 cordis.patch.yml 里加 id: academic-toolkit 的 insert 行（config 见上），profile package.json 的 dependencies 引用本目录 file:<插件目录>；重启 DSH 后加载。
- 删除插件：移除 profile cordis.patch.yml 中的 academic-toolkit 行与 package.json 的依赖后重启 DSH。

移植

换电脑或换学校见 README-PORTABLE.zh.md。

License

MIT