前言¶
在 DSH 里做文献跟踪时,常见做法是手动打开 IEEE Xplore 各刊目录,或把 RSS、邮件提醒堆在一起再人工筛标题。Early Access 条目往往比正式见刊早几个月出现,但分散在十余本期刊里,每周翻一遍很费时间。下面介绍社区插件 dsh-ieee-weekly(仓库 hxxhxhxx/ieee-weekly):用 Crossref 按时间窗口发现新收录 DOI,再拉 IEEE Xplore 元数据与摘要,经关键词初筛和 LLM 逐篇研判,输出 Markdown 周报并可选 SMTP 发信;同一 npm 包在 DSH 中注册 ieee_weekly 工具,可在对话里直接触发一轮流水线。
这是什么¶
dsh-ieee-weekly 由维护者 hxxhxhxx 发布,在 SkillHub 目录分类为联网工具,GitHub 星标约 3。一句话定位:按 config.json 里的期刊 ISSN 与关键词,盯住 IEEE Xplore 期刊新收录与 Early Access,生成可追溯的周报(DOI、Xplore 链接、上线日期、推荐理由),并支持邮件推送与 DOI 去重。仓库默认示例面向化合物半导体(GaAs / GaN / InP)功率放大器方向,关键词、期刊列表与评分阈值均可配置,不必改源码。
许可证为 MIT(package.json 当前版本 0.1.2)。
核心功能¶
资料中描述的处理链路如下:
Crossref(DOI 收录时间,最近 N 天)
→ IEEE Xplore(摘要 / Early Access 标记 / 作者 / 链接)
→ 关键词初筛 + 逐篇研判(DeepSeek 或规则打分)
→ Markdown + HTML 邮件(附 .md 文件)
→ 记录已读 DOI,下周自动去重
已核实的能力包括:
- 发现与抓取:通过 Crossref 公共 API 按
windowDays(默认 7)等窗口筛新 DOI;再访问 IEEE Xplore 检索接口取摘要与 Early Access 标记(需机构 IP 或 VPN 时,README 会说明降级行为)。 - 研判:配置
llm.apiKey与llm.model(如deepseek-chat)时逐篇读摘要打分;未配 key 时走关键词规则,scoring.mustReadScore / worthScore / minScore在规则模式下生效。 - 产出:
reports/ieee-weekly-YYYY-MM-DD.md、reports/last-email.html、reports/last-run.json;状态在state/seen.json(最多保留 5000 条 DOI)。 - DSH 集成:插件入口
index.js注册可调用的ieee_weekly工具,参数为days、dryRun、noEmail、ignoreSeen、limit;数据目录默认~/.ieee-weekly/(含config.json/ state / reports),首次调用会从config.example.json播种配置。
数据来源仅为 Crossref 与 IEEE Xplore 元数据与摘要,不下载全文;README 要求控制请求频率(默认篇间约 450ms),适合个人科研用途。
安装与启用¶
插件以公开 npm 包 dsh-ieee-weekly 形式发布,DSH 侧在「插件 → 市场」搜索 dsh-ieee-weekly 安装;装好后可对 agent 说「跑一下 IEEE 周报」触发工具。
仅 CLI、不经过 DSH 时,安装命令来自 README:
npm i -g dsh-ieee-weekly # 得到 ieee-weekly 命令
ieee-weekly --dry-run # 先干跑
运行环境:Node.js ≥ 20(engines.node)。peer 依赖 @deepseek-ai/dsh-tools(版本范围见包内 package.json),市场安装时会做兼容性校验。
安装前建议自行查看 GitHub 源码 与 MIT 许可证;插件在当前 DSH 进程权限下运行,会访问网络并读写 ~/.ieee-weekly/,SMTP 与 LLM API Key 写在本地 config.json,不应提交到仓库(.gitignore 已排除)。
典型用法¶
命令行¶
| 命令 | 作用 |
|---|---|
ieee-weekly --dry-run 或 node src/cli.mjs --dry-run |
只看结果,不更新去重、不发信 |
node src/cli.mjs |
正式跑一轮 |
node src/cli.mjs --days=14 |
临时把窗口放到 14 天 |
node src/cli.mjs --since=2026-10-01 --until=2026-10-15 |
指定历史窗口补跑 |
node src/cli.mjs --no-email |
生成报告但不发信 |
node src/cli.mjs --test-mail |
只测 SMTP |
node src/cli.mjs --limit=40 |
限制送入研判的篇数 |
Windows 源码目录下可用 setup.ps1 交互填写 Key 与邮箱,install-task.ps1 注册计划任务(README 注明 DSH 沙箱内可能访问不到任务计划服务,需在普通 PowerShell 执行)。
改配置¶
编辑 config.json(或 ~/.ieee-weekly/config.json),改完直接生效:
keywords[]:weight、core: true标记 PA 方向核心词。journals[]:按issn抓取,tier影响评分,enabled: false可临时关闭某刊。scoring.*:调节必读/值得读阈值。llm.model、llm.maxItems:研判模型与每轮篇数上限。email.to:收件人数组。windowDays:默认 7,与定时任务重叠部分靠 DOI 去重。
插件自检(来自 package.json scripts):
npm run plugin:check
# 加 --run 会真跑一次 2 天窗口的 dry-run(见 README)
DSH 对话¶
安装 dsh-ieee-weekly 后,通过 agent 调用 ieee_weekly,按需传入 days、dryRun、noEmail 等,与 CLI 共用同一套 src/ 流水线。
适用场景与注意¶
适合谁:需要定期跟踪多本 IEEE 期刊、尤其关心 Early Access 的研究者;希望把「翻目录 + 读标题」压缩成一份带评分的 Markdown/邮件摘要,并在 DSH 里用自然语言触发一轮抓取。
边界与限制(均来自 README):
- 校外或无 IEEE 订阅时,摘要与 EA 标记可能不可用,需 VPN 或接受 Crossref 标题+日期的降级研判。
- IEEE 偶发 500/限流会导致部分条目无摘要,报告末尾「抓取异常」会列出。
- Crossref
created时间受节假日影响,周一定时跑可能一次涌入较多篇数。 - 单轮约 1 分钟量级(视新文数量);依赖
nodemailer发信,SMTP 需按邮箱服务商开启授权码(QQ/163/Gmail 等示例见 README FAQ)。
SkillHub 上的 插件目录页 与 GitHub 仓库同属社区生态,与 DeepSeek / 幻方无官方从属关系;「一切皆插件」是 DSH 的使用方式,目录站为独立收录。
结尾¶
dsh-ieee-weekly 把 Crossref 时间窗口、IEEE Xplore 元数据、LLM 研判和 Markdown/邮件串成一条可配置流水线,CLI 与 DSH 工具共用实现,适合把 IEEE 期刊 Early Access 跟踪做成每周固定动作。进一步了解可打开 SkillHub 目录 与 GitHub 仓库。