@dsh-external/dsh-paper-checker
检查学术期刊投稿审稿状态并定时汇报的 DSH 插件。
- Editorial Manager 期刊：内置确定性 Playwright 抓取（
channel: msedge，用系统 Edge，无需下载浏览器）。
- 自动识别稿件阶段：主菜单上所有「活跃投稿分区」自动抓取（审稿 submission / 修改 revision / 生产 production），报告按分区分组 + 摘要统计三阶段篇数。
- 已决策稿件：自动抓取
Submissions with a Decision（含拒绝/接受结果），但只在决策后 7 天内列进报告（避免历史决策刷屏），独立分组「📂 近期决策（7 天内）」。
- 其他投稿系统（
system: 'other'）：返回「回退信号」，由 AI 用浏览器工具交互式处理（方案 C 混合模式）。
- 守护定时：每天到点自动检查 → 写报告 → 推微信（Server酱）。
- 按需工具：
check_paper_status，agent 可随时调用。
- 设置面板：DSH「设置 → 投稿检查」里可视化配置时间/时区/期刊列表，并支持「自动识别」新期刊。
安装
本插件是标准 dsh bundle（package.json 声明 dsh.bundle.patch，自带 cordis.patch.yml），可被官方 CLI 直接识别安装。
前提
- DSH 客户端（任意 profile，示例用
web）。
- 命令行里有
dsh 与 pnpm（DSH 插件管理的标准工具链）。
- 电脑已装 Microsoft Edge（Windows 默认有，用于确定性抓取）。
方式一：官方 CLI（推荐）
cd <tgz 所在目录>
dsh plugin --profile web add ./dsh-external-dsh-paper-checker-0.0.1.tgz
（相对路径会被 CLI 锚定到你的调用目录；也可用绝对路径 dsh plugin --profile web add E:/path/to/dsh-external-dsh-paper-checker-0.0.1.tgz。）
dsh plugin add 会：
- 把 tgz 装进 profile（依赖
playwright-core 一并安装）；
- 检测到本包声明了
dsh.bundle，自动把 @dsh-external/dsh-paper-checker 写入 profile 的 dsh.profile.bundles 启用名单。
装完重启 DSH 即可在「设置」里看到「投稿检查」面板，按需配置期刊后生效。
没有 pnpm 时先 corepack enable pnpm（Node 18+ 自带 corepack）或 npm i -g pnpm。
方式二：插件市场（若客户端装了 plugin-market / zat-dsh-engine）
把本仓库发布到 GitHub 并打上 dsh-plugin topic 后，在市场的「安装」入口搜索即可一键安装（市场同样会写启用名单）。
方式三：手动（无 dsh CLI 时）
cd <DSH_HOME>/profiles/web
pnpm add file:/绝对路径/dsh-external-dsh-paper-checker-0.0.1.tgz
# 然后编辑 <DSH_HOME>/profiles/web/package.json，
# 确保 dsh.profile.bundles 数组里含 "@dsh-external/dsh-paper-checker"，重启 DSH。
配置
安装后推荐在「设置 → 投稿检查」面板里配置（可视化 + 可自动识别新期刊）。配置持久化到 settings.yaml 的 paper-checker 命名空间。
配置结构（也可直接编辑 settings.yaml）：
journals:
- name: '某期刊名'
baseUrl: 'https://www.editorialmanager.com/xxxx'
username: 'your-email@example.com'
password: 'your-password'
sections:
- 'Submissions Being Processed'
- 'Submissions Needing Revision'
# sections 可选：面板「自动识别新期刊」会探测主菜单全部投稿分区并自动写入（含当前 0 篇的），
# 之后每次检查按此抓取、出现新稿件即被抓到，无需手动维护；手动加分区也可以，优先抓取
system: 'editorial-manager' # 默认；'other' 则回退给 AI
- name: '某非 EM 期刊'
baseUrl: 'https://example.com/submit'
username: 'xxx'
password: 'xxx'
sections: []
system: 'other' # 回退：AI 用浏览器工具处理
time: '08:00' # 每天触发时间 HH:mm
timezone: 'Asia/Shanghai' # IANA 时区
scheduleEnabled: true # 是否启用守护定时
serverchanKey: 'SCTxxxx' # Server酱 SendKey；留空则不推微信
reportDir: '' # 报告目录；留空默认 ~/.dsh/paper-checker/reports
reportSessionId: '' # 可选：检查结果同步汇报到某个对话会话
discoverProvider: '' # 可选：自动识别新期刊用的模型 Provider（留空用全局默认）
discoverModel: '' # 可选：自动识别新期刊用的模型（留空用全局默认）
字段说明
| 字段 | 类型 | 说明 |
|---|
journals[].name | string | 期刊显示名 |
journals[].baseUrl | string | EM 站点根地址（如 https://www.editorialmanager.com/xxx） |
journals[].username/password | string | 登录凭据 |
journals[].sections | string[] | 要检查的分区名；面板自动识别新期刊时探测主菜单全部分区自动写入，之后检查按此抓取（可选，留空则靠自动发现补抓） |
journals[].system | 'editorial-manager'|'other' | 抓取方式；EM 确定性，other 回退 AI |
time | 'HH:mm' | 每天触发时间 |
timezone | IANA 时区 | 如 Asia/Shanghai |
scheduleEnabled | bool | 是否开启守护定时 |
serverchanKey | string | Server酱 key，推微信用；空则跳过 |
reportDir | string | 报告输出目录 |
reportSessionId | string | 检查结果同步汇报的会话 id（可选） |
discoverProvider / discoverModel | string | 自动识别新期刊所用模型（可选，留空用全局默认） |
输出
- 报告写入
{reportDir}/report-{date}.md 和 latest.md，运行日志 run.log。
- 报告按分区分组列出每篇稿件（
- 📂 分区名（计数） → - [状态] 稿件号: 标题（投稿/更新/截止）），末尾摘要统计三阶段：审稿 N 篇 · 修改 N 篇 · 生产 N 篇；若有 7 天内决策的稿件，追加独立分组「📂 近期决策（7 天内）」与摘要 · 近期决策 N 篇。
- 微信推送（若配置了
serverchanKey）标题 📊 投稿状态报告 (日期)。
- 工具
check_paper_status 返回中文报告文本。
依赖
- 本机需安装 Microsoft Edge（Windows 默认有）。
playwright-core（声明为 dependency，安装时自动带入；确定性抓取只驱动本机 Edge，不下载浏览器）。
说明
- Editorial Manager 登录兼容两种形态：直接表单 / 折叠在「Alternatively, use your username and password」里。
- 新增期刊自动探测：面板「自动识别新期刊」登录后确定性探测主菜单上全部投稿分区（含当前 0 篇的分区，按菜单顺序，排除 Task Assignments 任务区与 with Production Completed 已完成历史）写入
sections，模型只识别期刊名/系统类型（期刊名可能识别不准，面板里可直接修改后加入）；保存后每次检查按探测结果抓取，count=0 分区自动跳过、一有稿件即被抓到。老配置未写 sections 时，检查时自动发现 count>0 的投稿分区补抓（排除 New Submissions 入口与 with Production Completed 已完成历史）。
- 已决策分区：
Submissions with a Decision 也自动纳入抓取（跨分页遍历全部历史，最多 8 页），报告层只显示决策日期在最近 7 天内的稿件；决策日期取 Status Date / Final Decision Date / Decision Date 列。
- 表格兼容：
table#datatable 与 table#GridSubmissions（表头在 tbody 首行 <th>）两种 EM 结构都能解析。
- 状态翻译：Under Review→审稿中、In Production→生产中、Needs Author Action→等待作者操作、Major/Minor Revision→大修/小修、Awaiting Author Approval→等待作者确认 等 40+ 状态，另有前缀/关键词模糊匹配（含 Reject 即→已拒稿、含 Accept 即→已接受、含 Revis 即→修改中，可覆盖 Completed - Reject / Completed - Accept 等组合状态）。
- 非 EM 期刊（
system: 'other'）在守护定时中仅标记「需 AI 检查」，交互式调用 check_paper_status 时由 AI 用浏览器工具完成。
构建（开发者）
产物 lib/index.js（host，自包含，已内联 @deepseek-ai/* 依赖）与 lib/client.js（client 面板）已随包分发，使用者无需构建。如需改代码后重打：
npm install # 安装 typescript / tsdown / @types/node
npm run build:client # tsdown 打包 host + client 到 lib/
npm pack # 产出 tgz
