前言¶
在 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 倉庫。