dsh-literature

在 DSH Web 侧栏识别 DOI、arXiv、PMID、ISBN 和论文标题，解析开放学术元数据、阅读 PDF、生成引用，并可保存到内置库、目录或 Zotero。

• DSH Web 测试 Profile（必需）：在独立 web Profile 中安装和验证，不直接使用生产会话。
• 公开论文样本（必需）：准备一个公开 DOI 或 arXiv ID，用于只读元数据与开放获取链路验证。
• Zotero（可选）：仅在确实需要本地文献库同步时启动，并先备份 Zotero 数据。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.1.1-rc.2

安装来源

GitHub 源码（锁定提交）

固定目标

@a9i5k4/dsh-literature@0.2.6

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   GitHub 源码（锁定提交）复制命令

   npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add @a9i5k4/dsh-literature@0.2.6

3. 03
   如遇构建脚本拦截

   GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。

4. 04
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 @a9i5k4/dsh-literature或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config

5. 05
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove @a9i5k4/dsh-literature

DSH 文献侧窗 → 设置

选择保存方式、识别策略、下载重试、导出目录和自定义来源。

~/.dsh/dsh-literature.json

插件设置与自定义来源配置；含请求头时应按敏感配置保护。

~/.dsh/storages/dsh-literature

默认内置文献库、索引和已保存 PDF 的本地存储。

保存方式：内置文献库
自动扫描回复：关闭
导入文件夹自动扫描：关闭
自定义下载源：留空
重复条目策略：询问

1. 重启独立 DSH Web Profile，打开文献侧窗并先保持内置文献库、自动扫描关闭和自定义下载源为空。
2. 确认 ~/.dsh 下的插件设置和存储目录只对当前系统用户可访问，再决定是否启用目录导出或 Zotero。

1. 01
   导出或查看 web Profile 的组合配置，确认固定版本插件已进入 Bundle。

   期望结果：组合配置中出现 @a9i5k4/dsh-literature@0.2.6 对应的插件层。

2. 02
   在文献侧窗粘贴公开 arXiv:1706.03762，只检查元数据识别，不配置私有下载源。

   期望结果：界面显示论文元数据或明确的联网失败原因，不应要求输入真实机构凭据。

3. 03
   保存一条测试记录后检查内置库，再从界面删除该测试记录。

   期望结果：记录只出现在插件内置库，删除后不再显示；未启用目录或 Zotero 时不应写入外部库。

• 粘贴“arXiv:1706.03762”，核对标题和作者后生成 APA 引用，不自动下载非开放全文。
• 让 Agent 查询一个公开 DOI 的元数据，但不要保存、导出或连接 Zotero。

可监听 DSH 会话、注册文献查询与保存工具，联网请求学术 API 或自定义下载源，读写本地 PDF、索引和导出目录，并访问 Zotero 回环接口。

数据存储：默认写入 ~/.dsh/storages/dsh-literature 和 ~/.dsh/dsh-literature.json；目录模式会写入用户选择的目录，Zotero 模式会通过本机回环接口写入 Zotero。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

无法解析或下载论文

先确认 Crossref、arXiv、OpenAlex 或 Unpaywall 可访问；付费墙内容改为用户合法下载后手动导入，不添加未知镜像。

Zotero 查询或保存失败

确认 Zotero 正在本机运行、Connector 接口可用；不需要 Zotero 时切回内置文献库。

出现意外的 doctor supervisor 日志

这是固定提交中的自修复逻辑；停止测试 Profile，检查是否已安装 dsh-doctor，并在接受该额外行为前不要继续使用。