前言¶

在 DeepSeek Harness（DSH）裏做科研或寫綜述時，常見做法是：模型負責生成文字，文獻檢索、入庫、分類和引用仍分散在瀏覽器、Zotero 和本地腳本之間。對話裏很難穩定復現「找新論文 → 去重入庫 → 打標籤歸集 → 批量讀摘要 → 寫稿插 \cite」這一整條鏈，也缺少與本地書庫一致的狀態（哪些已讀過、哪些屬於同一課題）。

下面介紹社區插件 dsh-zotero-skill（維護者 Eason-0712），它把上述步驟封裝爲 DSH 技能：基礎能力用 Python 標準庫直連 Zotero 本地 API 與 OpenAlex，無需 MCP 或 Zotero 雲端 API Key；寫庫前可預覽，首次寫入需在 Zotero 彈窗授權。項目改編自 OpenAI Zotero 插件（MIT），當前 npm 包版本爲 0.5.5，GitHub 星標 5，分類爲工作流。目錄頁：skillhub.cn/plugins/Eason-0712/dsh-zotero-skill；源碼：github.com/Eason-0712/dsh-zotero-skill。

這是什麼¶

dsh-zotero-skill 是爲 DeepSeek Harness 打造的 Zotero 文獻技能，目標是把文獻工作按順序打通：找文獻 → 追前沿 → 篩核心 → 管理歸集 → 批量閱讀 → 分類整理 → 提煉脈絡 → 發現空白，並支持導出 BibTeX、向 LaTeX / Markdown 草稿插入引用。0.5 版起還包含可選的全文精讀與跨論文綜述工作流（本地 PDF/OCR 組件首次按需下載，分析與翻譯走 DSH 當前模型配置）。

插件以 DSH 插件或獨立 skill 目錄兩種形式安裝；運行 DSH 插件形態時需要 Node 20+。Zotero 側開發時驗證版本爲 Zotero 10.0.6，默認連接本機 127.0.0.1:23119 的本地 API，不直接讀寫 zotero.sqlite。

核心功能¶

文獻發現與管理¶

• 找文獻：從 OpenAlex 按主題檢索，可按期刊影響力、引用速度、相關度、新鮮度排序，並與本地庫去重；--source crossref 可改用 Crossref 元數據。
• 中文文獻：知網無公開檢索 API；技能生成檢索鏈接，並解析你從知網導出的 RefWorks / EndNote 再入庫，保留卷期頁、關鍵詞與 language=zh。
• 追前沿：將常讀方向存爲 watch，每次只拉「上次運行以來」的新論文。
• 篩核心：把候選或庫內條目分爲核心 / 重要 / 參考三檔，輸出短名單。
• 管理文獻：批量打標籤、歸集到分類、按 DOI / 標題查重並清理副本。
• 批量閱讀（元數據層）：一次爲多篇生成閱讀包（元數據、摘要、章節大綱、筆記骨架）；README 說明現有 digest 仍是元數據閱讀包，不是 0.5 精讀流程的模型精讀結果。
• 分類整理：按論文類型、方法、數據集、年份等維度在 Zotero 建文件夾或生成 auto:method:* 等標籤計劃，預覽後寫入。
• 提煉脈絡 / 發現空白：統計年份、期刊、方法、數據集及共現；按項目找方法×數據集未交叉組合、停更標籤等。
• 檢索與引用：關鍵詞搜條目，返回 item key 與 BibTeX key；在草稿標記處插入 \cite{key} 或 [@key] 並同步 .bib。
• 每日收錄：按主題從 OpenAlex 抓新論文，去重排序後導入指定分類；可配置數量、開關與定時（見下文）。

改庫前支持 --dry-run；實際寫入需你在 Zotero 裏一次性「Always Allow」授權。

全文閱讀與輕量增強（0.5）¶

在 DSH 中用自然語言說「精讀 Zotero 當前選中的論文」或「比較這個分類中的論文」即可觸發。插件可輸出 Markdown 筆記、譯文、標註 PDF、雙語 PDF、Zotero 中文筆記等；分析帶塊 ID、頁碼與原文片段，便於覈對（校驗定位不等於自動證明結論正確）。

按需能力還包括：聚焦問答（SQLite FTS5，無向量庫）、寫入 Zotero 原生 annotation、證據對比表、術語與數字複覈、bilingual-markdown 逐段對照、引用的一跳參考/被引候選（OpenAlex，含撤稿標記）等。精讀「當前選中條目」需額外安裝包內生成的 Zotero 擴展（Zotero 10 本地 API 鑑權），並完成已有 authorize 流程；分類、標籤與明確 item key 的操作不依賴該擴展。

首次準備全文閱讀組件（私有 Python 3.12、PDF、OCR、Noto 字體等，不改變系統 Python）：

node lib/reader-runner.js reader-config
node lib/reader-runner.js bridge --out dsh-reader.xpi

將 dsh-reader.xpi 在 Zotero 工具 → 插件 → 從文件安裝 中安裝一次。組件下載需網絡，地址與 SHA256 由包內啓動器鎖定。

安裝與啓用¶

環境¶

• Python 3.10+（Windows 可用 py -3 或 python，macOS / Linux 用 python3）
• 桌面版 Zotero（README 寫明開發驗證於 10.0.6）
• DeepSeek Harness；插件形態需 Node 20+

裝進 Harness（推薦：DSH 插件）¶

npm 已發佈包 dsh-zotero-skill，自帶 dsh.bundle 清單：

dsh plugin --profile <你的 profile> add dsh-zotero-skill

npm 不可達或需要跟蹤 GitHub 最新代碼時：

dsh plugin --profile <你的 profile> add github:Eason-0712/dsh-zotero-skill

本地開發調試：

dsh plugin --profile <你的 profile> add "link:/path/to/dsh-zotero-skill"

卸載：

dsh plugin --profile <你的 profile> remove dsh-zotero-skill

獨立 skill 目錄（方式 B）¶

在倉庫根目錄執行：

python install.py

默認複製到 $DSH_HOME/skills/zotero（未設置時爲 ~/.dsh/skills/zotero），目標已存在時不覆蓋。項目級僅對當前倉庫生效：

python install.py --skills-dir .dsh/skills

打開 Zotero 本地 API¶

Zotero → 設置 → 高級 → 其他 → 勾選「允許此計算機上的其他應用程序與 Zotero 通信」。

也可在完全退出 Zotero 後由腳本寫入配置並重啓：

python zotero/scripts/zotero.py enable --restart

驗證連通¶

python zotero/scripts/zotero.py status --json

當 api_running: true 且 api_status: 200 時表示本地 API 可用。

典型用法¶

在 Harness 裏用自然語言描述任務即可，技能會選擇子命令並在寫庫或寫文件前給出預覽。README 中的示例包括：

幫我找一下 knowledge distillation 用在運動想像 EEG 上的新論文，按重要性排個序。

我常看的方向有這幾個，做成 watch，以後只給我新出現的。

從庫裏 project:MI-EEG 這 18 篇裏挑出最核心的幾篇，列個短名單。

把這批論文生成閱讀包，我看完再寫綜述。

按方法和數據集給整個庫打上標籤，先給我看計劃。

這個方向現在有哪些明顯的空白？

讀一下 /path/to/draft.md，把相關論斷後面補上引用，並更新同目錄的 references.bib。

每日自動收錄（可選）¶

在 Zotero 中先選中目標分類，再配置並試運行：

python zotero/scripts/zotero.py daily-config --enable \
  --topics "transformer;large language model" --max 10 --mailto "you@example.com"

python zotero/scripts/zotero.py daily --dry-run
python zotero/scripts/zotero.py daily

Windows 上可註冊每天固定時間任務：

python zotero/scripts/zotero.py daily-schedule --time 08:00

候選論文從 OpenAlex 檢索最近 N 天結果，默認按期刊影響力（權重 0.45）、引用速度（0.30）、主題相關度（0.15）、新鮮度（0.10）加權排序；同一期刊默認最多 3 篇（max_per_venue）。已導入 DOI 記錄在 ~/.zotero-skill/state.json 避免重複。關閉總開關：daily-config --disable。

適用場景與注意¶

適合誰：已經在用 Zotero 管庫、希望在 DSH 對話裏完成檢索、歸集、閱讀包、寫稿引用與（可選）精讀/綜述的研究者；依賴 OpenAlex 做英文發現，中文側以知網導出文件爲主。

權限與安全：插件以當前 DSH 進程的用戶權限運行，可讀寫你授權的路徑與 Zotero 庫（經本地 API）。安裝前應自行查看 GitHub 倉庫 源碼與 MIT 許可證；社區目錄 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。

邊界：README 寫明已提供離線 PDF、引用、緩存等測試，但未在所有使用者的 Windows DSH/Zotero 實例上完成端到端驗證；10–15 頁文字型論文的首分鐘響應等爲待測性能目標。Windows 爲主要使用環境，macOS / Linux 提供運行時映射但仍需各平臺實測。Zotero 未運行時，每日任務腳本會嘗試啓動並等待 API 就緒。

結尾¶

dsh-zotero-skill 把 OpenAlex 發現、本地 Zotero 管理與 DSH 模型閱讀/寫稿放在同一條技能鏈上，標準庫實現降低對 MCP 和雲端 Key 的依賴，寫操作保留預覽與一次性授權。若要安裝或跟蹤更新，可從目錄頁 Eason-0712/dsh-zotero-skill 進入，或直接查看 GitHub 倉庫 的 README 與 zotero/references/ 下的工作流說明。