从零到第一篇精读
五步，大约二十分钟，其中十五分钟在等依赖下载。做完你已经完成一轮检索、读完一篇论文的全文，这条流程以后每次都能复用。
-
装 DeepSeek Harness
需要 Node 22.19 或更新。装的是全局命令，不是每次现下——你在开发或长期使用时，版本稳定比自动跟最新更重要。第一次用 dsh，可以先过一遍官方快速上手。
npm install -g @deepseek-ai/dsh -
装科研插件市场
先装这一个。它会在设置里加一页「科研插件」，其余的在那里点着装，不用再回终端。
dsh plugin --profile web add dsh-research如果你已经知道要装什么，也可以一次装齐、跳过后面的点击：
dsh plugin --profile web add dsh-research dsh-ai4scholar dsh-academy -
装上文献工具，填 API key
跑
dsh web，打开127.0.0.1:3080，进 设置 → 科研插件，找到dsh-ai4scholar点安装，装完点面板里的「重启 dsh」。回来后进 设置 → 插件 → AI4Scholar，粘贴 ai4scholar.net 的 key。
key 存进 dsh 的凭据库，不会出现在对话里，也不会发给模型。arXiv、bioRxiv 和 DOI 全文不需要 key，想先试试可以跳过这步。
-
第一次检索：先检索再断言
直接用自然语言问。插件的指令要求 Agent 先检索再回答，所以它不会凭记忆编论文。
「找一下最近三年关于 你的主题 最扎实的证据，按被引排序，告诉我每篇的核心结论。」
回答末尾会显示这次消耗和剩余的积分。arXiv、bioRxiv、DOI 全文这些免费源不计费。
-
精读与引用
挑一篇让它读全文——读的是 PDF 正文，不是摘要。全文按片段返回，问什么读什么，不会一次把几万字塞给模型。
「读一下 10.1038/s41586-021-03819-2 的方法部分，它的对照是怎么设计的？」
写作时把你自己的段落粘给它要引用：
auto_cite会在正文里标出该引的位置，并附上一份可核对的参考文献表（计积分，约 20–90 秒）。
还能让它做什么
装上文献工具之后，这些说一句就能用。
引用图谱
沿着引用和被引两个方向走：这篇引了谁、谁引了它、相近的还有哪些，顺藤摸瓜把一个方向理清。
自动引用
把你写的段落粘给它：标出每个该引的论断，附上可核对的参考文献表。
科研绘图
生成、改样式、组合、评图，可出 SVG——机制图和流程图不用再开画图软件。
作者与推荐
查一位作者的发表脉络，或从一篇你喜欢的论文出发，要相似工作的推荐。
常见问题
装的时候一堆 peer dependency 警告，是坏了吗？
不是。这些 @deepseek-ai/* 包本来就该在运行时解析到全局 dsh 安装，不装进 profile 目录。官方的插件市场也会报同样的警告。
启动报 EADDRINUSE 端口被占用
有一个 dsh 还在后台跑着——常见于关掉终端窗口后进程被系统收养。用 lsof -nP -iTCP:3080 -sTCP:LISTEN 找到它，kill 掉再启动。
装完插件为什么没生效？
profile 是在 dsh 启动时加载的，新装的插件要重启才进得去。刷新页面不够。
积分怎么算？哪些不花钱？
Semantic Scholar、PubMed、Google Scholar 的检索与 auto-cite、绘图按次计费，每次回答末尾会显示消耗与余额。arXiv、bioRxiv/medRxiv、DOI 全文抽取不计费。
能不能只装其中一个包？
可以，三个包各管一层、互相独立。只要检索就装 dsh-ai4scholar；dsh-research 是市场面板本身；dsh-academy 只管行为规则。