dsh-cite
给一个 DOI，还你规范参考文献——GB/T 7714 / APA / MLA / Chicago / BibTeX。
DeepSeek Harness 参考文献工具插件：通过 Crossref API 查询文献元数据并格式化引用。五个工具（含 cite_health 自检）、零运行时依赖、全平台通用。
工具
| 工具 | 作用 | 关键参数 |
|---|
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 |
cite_health | 自检：探测 Crossref 连通性并报告延迟 | 无 |
兼容性
已在官方 @deepseek-ai/dsh@0.1.5-rc.1、Node 24.16.0 上验证（2026-09-11）：18 个组件与 Modlens 同载，工具 schema、技能注册及离线只读调用检查通过。采用 cordis.patch.yml + dsh.bundle.patch 组合包模型。Node 要求与该版本 Harness 一致：22.19 及以上的 22.x，或 24 及以上。外部服务的实际业务操作需按各组件配置单独验证。
安装
dsh plugin --profile web add dsh-cite
卸载
dsh plugin --profile web remove dsh-cite
卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile cordis.patch.yml 中覆盖的插件行。
示例
用户：给我 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
License
MIT（见 LICENSE）
