dsh-cite

给一个 DOI，还你规范参考文献——GB/T 7714 / APA / MLA / Chicago / BibTeX。

DeepSeek Harness 参考文献工具插件：通过 Crossref API 查询文献元数据并格式化引用。四个工具、零运行时依赖、全平台通用。

工具

工具	作用	关键参数
cite_lookup	查文献元数据（DOI 精确查询 / 题录检索）	doi 或 query 至少一个；limit 1-10 默认 5
cite_format	生成规范引文	doi 必填；style：gb-t-7714 / apa / mla / chicago
cite_bibtex	生成 BibTeX 条目	doi 必填；key 可选
cite_check	从文本提取 DOI 并并发校验是否存在（并发 3，保持输入顺序）	text 必填；maxChecks 1-50 默认 10

安装

dsh plugin --profile web add dsh-cite

示例

用户：给我 10.1038/nature12345 的 GB/T 7714 引用
Agent：
  cite_format { doi: "10.1038/nature12345", style: "gb-t-7714" }
  → LeCun Y, Bengio Y, Hinton G. Deep learning[J]. Nature, 2015, 521(7553): 436-444.

用户：检查这段参考文献的 DOI 是否有效
Agent：
  cite_check { text: "..." }

配置

- id: cite
  name: 'dsh-cite'
  config:
    timeoutMs: 15000   # Crossref 请求超时（也可用 DSH_CITE_TIMEOUT_MS）
    # userAgent: ...   # 自定义 User-Agent（也可用 DSH_CITE_USER_AGENT）
    userAgent: ''      # 自定义 UA（建议带上可联系邮箱）

说明

• 数据源：Crossref REST API，无需 API key
• 引文为纯文本输出；格式按常见模板生成，正式投稿前请核对目标期刊的细节要求
• 不采集、不上传任何本地文献数据

开发

pnpm test       # 构建 + 18 个测试

MIT