前言¶
在 DeepSeek Harness（DSH）裏做研究類智能體，常見做法是手動刷 arXiv、把摘要貼進會話，或靠通用搜索拼一篇「今日論文」。痛點在於：類別和時間一多就難堅持，推薦和真實興趣也容易脫節，筆記散落在各處，很難在後續會話裏複用。
下面介紹的 arXiv Inspiration（維護者 Lxion0553）把 arXiv 收成可按興趣庫過濾、經 LLM 排序的按需調研流，並在設置頁審閱、反饋、推送到會話；論文會累積到本地庫，支持深讀筆記與畫像演進。它在社區目錄中歸類爲聯網工具，當前 GitHub 星標爲 0。
這是什麼¶
arXiv Inspiration 是 DSH 插件，定位是「個性化 arXiv 研究啓發源」：按你配置的類別與工作日（UTC+8）拉取論文，先用本地興趣知識庫粗篩，再並行 LLM 批處理排序，輸出逐篇推薦理由（中文推薦理由、啓發、建議行動及英文 agent 上下文）。數據默認落在 ~/.dsh-arxiv-inspiration/；卸載插件不會刪除該目錄。
與「只在聊天裏臨時問一句 arXiv」相比，它強調：設置頁可配置、結果需你點頭再推送、反饋會反哺興趣庫與後續排序，而不是全自動往會話裏灌摘要。
核心功能¶
按需調研（Survey）¶
- 在設置頁選擇 arXiv 分類、工作日（UTC+8）、模型與推送偏好；也可在會話中通過
arxiv_inspiration工具觸發。 - 流程：抓取 → 興趣 KB 粗篩 → 並行 LLM 排序 → 蒸餾爲每篇推薦說明。
- 可選 alphaXiv assist：在已配置類別之外做語義發現，並用 alphaXiv 做全文 Q&A（見下文憑證說明）；每次調研可單獨關閉相關開關。
設置頁 UI¶
arXiv Inspiration 卡片內可：配置分類/工作日/模型/推送、發起調研、瀏覽雙語標題與摘要、對結果給出 👍 / 📖 / 👎。README 明確不做自動推送——由你決定哪些內容進入對話。
反饋與畫像¶
- 👍 會自動增加興趣塊；👎 會在後續調研中對相似標題溫和降權（≤25% 分懲罰，並排除單篇 id）。
- 反饋參與 Profile evolution：由 LLM 根據歷史反饋草擬新版研究興趣畫像，你在 UI 中採納/編輯/丟棄；插件不會靜默改寫畫像。
論文庫¶
抓到的論文寫入 ~/.dsh-arxiv-inspiration/papers.jsonl，含分數、反饋、中文翻譯、筆記與深讀狀態。支持關鍵詞檢索，可選語義檢索；UI 可瀏覽，智能體可通過 arxiv_knowledge_base 工具（如 search_papers、get_paper、add_paper 等）查詢。
深讀筆記¶
推薦論文可走全文深讀：優先 alphaXiv PDF Q&A，本地 PyMuPDF map-reduce 爲後備。完整筆記在 ~/.dsh-arxiv-inspiration/analyses/<id>.md，獨立查看器打開；卡片展示 3–5 條中文要點。智能體可 read_analysis / write_analysis，以及 add_note / list_notes 管理時間線筆記。
會話推送¶
可將摘要（面向用戶、雙語）或論文列表 + prompt（面向 agent）推入你指定的會話。
可選：agentero paper-reader¶
若同時安裝 agentero-dsh 的 paper-reader，可在設置中填寫 agenteroPapersDir（持久化於 ~/.dsh-arxiv-inspiration/config.json），在深讀頁並排展示其 NOTES.md（只讀引用，不合並、不寫回 vault）。留空則關閉集成。
環境與依賴¶
| 項 | 要求 |
|---|---|
| DSH | >=0.1.5-rc.1（見插件 package.json） |
| Node.js | >=22 |
| LLM | DSH 中已配置 provider；默認用宿主 llm 服務與會話模型，可在設置中固定模型 |
| Python（可選，推薦） | 用於 PDF 深讀與語義檢索；無 Python 時調研、排序、庫與筆記仍可用，PDF 深讀跳過，語義檢索回退關鍵詞 |
插件版本（資料中）：0.5.2。
安裝與啓用¶
安裝前請自行查看 GitHub 倉庫 源碼與許可證。插件以當前 DSH 宿主進程權限運行，會訪問網絡拉取 arXiv、調用你所配置的 LLM，並在本機讀寫 ~/.dsh-arxiv-inspiration/。
1. 拉取插件包¶
dsh plugin --profile web add github:Lxion0553/dsh-arxiv-inspiration
2. 註冊 bundle¶
在 ~/.dsh/profiles/web/package.json 中，將 dsh-arxiv-inspiration 加入已有的 dsh.profile.bundles 數組（與 README 說明一致；僅 dsh plugin add 不會自動把 patch compose 進運行配置）。
"dsh": { "profile": { "bundles": [ /* … */, "dsh-arxiv-inspiration" ] } }
3. 重啓 DSH 宿主¶
從 GUI 插件市場安裝時，README 說明會同時完成拉包與註冊；CLI 安裝需手動完成第 2 步。
可選：Python 環境（推薦）¶
用 uv 在數據目錄建 venv 並安裝 pymupdf、fastembed（語義模型 bge-small-en-v1.5，首次使用下載到 ~/.dsh-arxiv-inspiration/models/）：
curl -LsSf https://astral.sh/uv/install.sh | sh
mkdir -p ~/.dsh-arxiv-inspiration
uv venv ~/.dsh-arxiv-inspiration/.venv
uv pip install --python ~/.dsh-arxiv-inspiration/.venv/bin/python pymupdf fastembed
插件解析 Python 的順序：安裝目錄內 .venv/bin/python → ~/.dsh-arxiv-inspiration/.venv/bin/python → PATH 上的 python3。
可選：alphaXiv 憑證¶
alphaXiv 能力沒有獨立配置項，從本地 alphaxiv MCP bundle 的 ~/dsh-bundles/alphaxiv-mcp/cordis.patch.yml 讀取 Authorization: Bearer <token>。無文件或無 token 時，相關開關會靜默降級，調研仍可進行，深讀回退本地 PyMuPDF。修改 token 後需重啓 DSH 宿主。
典型用法¶
- 日常掃文獻：在設置頁選好 arXiv 分類與工作日，發起調研；在結果頁用 👍/👎 校準推薦，滿意條目再推送到當前或指定會話。
- 會話內臨時調研：在 DSH 會話中調用
arxiv_inspiration工具，按當次需求跑一輪 survey。 - 智能體查庫：用
arxiv_knowledge_base的search_papers、get_paper等動作檢索papers.jsonl中累積的論文與元數據。 - 深讀與筆記：對推薦論文觸發深讀，在 UI 或
analyses/<id>.md查看完整筆記；需要時用read_analysis/write_analysis與會話協作。
適用場景與注意¶
適合：需要長期跟蹤若干 arXiv 分類、希望推薦與本地興趣 KB 對齊、並要把「審閱 → 反饋 → 推送 → 筆記」留在 DSH 工作流裏的開發者與研究者。
注意：
- 依賴你所配置的 LLM 與（可選）alphaXiv 配額；聯網與 API 調用由宿主環境承擔。
- 社區插件目錄 SkillHub 上的條目 與 GitHub 爲信息發佈渠道，與 DeepSeek / 幻方無官方從屬關係；安裝前請覈對倉庫與許可。
- 敏感 token 僅存本機（如 alphaXiv Bearer）；勿將
config.json或 patch 文件提交到公開倉庫。
結尾¶
arXiv Inspiration 把「拉 arXiv → 按興趣篩排 → 人工把關 → 入庫與深讀」收成一套 DSH 插件能力，減少手動複製摘要、又避免不加審閱的自動推送。進一步瞭解可看社區目錄頁與倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/Lxion0553/dsh-arxiv-inspiration
- GitHub：https://github.com/Lxion0553/dsh-arxiv-inspiration
