EduWork 文献工具
简体中文 | English
@eduwork/dsh-literature 为 DSH 提供文献检索、BibTeX 和可用全文获取能力，可独立用于其他 DSH 应用。
本包 fork 自 SihanLv/dsh-literature 0.1.2，由 EduWork 接续维护，沿用 MIT 许可证。感谢原作者和上游贡献者。来源提交及原始文件校验值见 UPSTREAM.json，许可证与归属见 NOTICE.md。
目前支持
- DBLP、arXiv 检索：合并结果、去重，保留已发表论文与预印本的区别。
- BibTeX：获取来源提供的引用条目。
- 全文获取：尝试 arXiv 源文件、HTML、PDF，以及可访问的出版方 PDF，提取内容写入当前会话工作区。
- 后台任务：全文获取默认通过 DSH Jobs 执行，支持查询结果与取消；写入遵循当前会话的沙箱策略。
全文是否可用取决于来源服务、网络和访问权限，不承诺获取付费或受限全文。出版方 PDF 链接解析使用宿主模型，本包不自带模型或账号。DSH 0.2.0 沿用无操作工具的 Subagent；0.2.1 改用同一模型的一次结构化抽取，不执行返回的工具，也不继承 Agent 自动重试。失败后可重试全文任务，取消任务会中止抽取。
兼容 DSH 0.2.x，并显式接纳 0.2.1 预发布系列；新旧 API 都需行为验收。旧版 invariant 导出保留，其 peer 为可选，0.2.1 不再为它安装旧内核组件。
安装与使用
要求 Node.js 24.18.0+ 和 DSH 0.2.x（从 0.2.0-rc.1 起）；其他内核版本尚未验证。
dsh plugin add @eduwork/[email protected]
也可以从源码构建：
# 在 EduWork 仓库根目录执行
node scripts/packages/manage.mjs install dsh-literature
node scripts/packages/manage.mjs check dsh-literature
node scripts/packages/manage.mjs pack dsh-literature
打包结果位于 dist/npm-packages/dsh-literature/，可通过 DSH 的插件安装入口选择生成的 .tgz。
启用后，Agent 可使用 literature_search、literature_bibtex、literature_fulltext。例如：“检索近年关于检索增强生成的论文，给出引用，并获取能公开访问的全文。”后台全文任务通过官方 job_output 读取结果、job_kill 取消。
原来的 literature、literature-dblp、literature-arxiv、tool-literature 配置标识保持不变。手动安装时请先停用旧 @shlv/dsh-literature，不要同时启用两套同名工具。安装本包不会自动迁移宿主已有的 profile/home 配置；更换内核或插件前请保留原配置。
配置与维护
核心 literature 条目支持 enabledSources（dblp、arxiv）、searchMaxResults、timeoutMs 及下载/提取大小限制；工具条目 tool-literature 的 subagentProvider 只用于旧版子代理，默认是 spawn；新版只读抽取使用调用方当前模型，自定义旧子代理提供者会明确报不兼容。不配置来源列表时使用全部已注册且可用的来源，空列表表示全部停用。
源码保留四层结构：src/core 负责检索协调和内容提取，src/dblp、src/arxiv 对接来源，src/tool 对接 DSH 工具与 Jobs。对应的 npm 导出为 /core、/dblp、/arxiv、/tool，同时提供 TypeScript 类型声明。原上游的五个包收为一个包，减少跨包版本配套工作。
后续计划在这一结构上拓展更多文献来源；目前仅支持 DBLP 和 arXiv。新增来源还需要完善标识、引用和全文回退规则，并补齐测试。
普通检查使用合成数据，不联网检索、不调用真实模型。npm run test:live 单独运行需要访问外部文献服务的性能检查，不作为 CI 门槛。维护与发布流程见 包维护指南。问题和贡献请提交到 EduWork。
关于 @eduwork/dsh-literature 的常见问题
@eduwork/dsh-literature 是什么？
Literature research for DSH: DBLP and arXiv search, BibTeX and full text. EduWork-maintained fork of SihanLv/dsh-literature.
如何安装 @eduwork/dsh-literature？
在项目目录运行 npm install @eduwork/dsh-literature，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（^4.0.4）、@deepseek-ai/dsh-fs（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）、@deepseek-ai/dsh-llm（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）、@deepseek-ai/dsh-jobs（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）、@deepseek-ai/dsh-agent（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）、@deepseek-ai/dsh-tools（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）、@deepseek-ai/dsh-sandbox（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）、@deepseek-ai/dsh-timeout（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）、@deepseek-ai/schemastery（^3.18.4）、@deepseek-ai/dsh-subagent（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）、@deepseek-ai/dsh-sandbox-policy（>=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.2.2-0 || 0.2.2-rc.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@eduwork/dsh-literature 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@eduwork/dsh-literature 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@eduwork/dsh-literature 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=24.18.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@eduwork/dsh-literature 可以商用吗？
@eduwork/dsh-literature 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@eduwork/dsh-literature 的下载量有多少？
根据 npm 官方下载统计，@eduwork/dsh-literature 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,588 次，日均约 153 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@eduwork/dsh-literature 还在维护吗？
最新版本 0.1.6 发布于 2026/11/05（8 天前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/09/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。