在 DeepSeek Harness 的插件化生态中，智能体需要具体的工具来处理复杂的文档编译任务。LaTeX 开发经常遇到编译错误、引用缺失或 BibTeX 格式混乱的问题。dsh-latex-guard 旨在解决这些问题，将标准的 LaTeX 工具链集成到智能体开发流程中。
这是什么¶
dsh-latex-guard 是一个为 DeepSeek Harness 和任何智能体设计的客户端插件。它提供 LaTeX 项目编译检查和 BibTeX 审计功能。该插件由 Flan246 维护，采用 MIT 许可证。
核心功能¶
- LaTeX 编译检查：使用
latexmk编译 LaTeX 项目并返回结构化报告，包含错误、警告和未定义引用。 - BibTeX 代码检查：对 BibTeX 条目进行去重，检查每种条目类型的必填字段，并标准化格式。
- 字段填充：通过 DOI 或标题从 Crossref 填充缺失的 BibTeX 条目字段（绝不覆盖现有值）。
- 引用审计：比较
.tex文件和.bib文件中的引用键，识别引用但缺失和从未被引用的条目。
安装与启用¶
通过以下命令安装插件：
dsh plugin add dsh-latex-guard
安装后，它会注册四个智能体工具：latex_check、bib_lint、bib_fill 和 cite_audit。
典型用法¶
插件支持作为 DSH 插件运行，也支持作为独立 CLI 工具使用。
CLI 命令¶
# LaTeX 编译检查
npx dsh-latex-guard check <dir> <entry.tex>
# BibTeX 代码检查
npx dsh-latex-guard bib-lint <file.bib>
# BibTeX 字段填充
npx dsh-latex-guard bib-fill <file.bib>
# 引用审计
npx dsh-latex-guard cite-audit <file.bib> <tex...>
CLI 标志¶
--write：修改.bib文件（请确认使用）。--engine <name>：选择编译引擎（auto、pdflatex、xelatex或lualatex）。--json：以 JSON 结构化格式输出。
适用场景与注意¶
此插件以当前 DSH 进程的权限运行。安装前，请检查源代码和许可证。
已知限制与注意事项：
- 注释行识别：
cite-audit会将注释行（% ...）中的\cite键视为真实引用。 - 编译报告：
check报告可能仍包含由 latexmk 中间传递发出的引用警告；只有最终传递反映真实的引用状态。 - 环境依赖：
check命令需要系统安装latexmk（例如 TeX Live 或 MiKTeX）并在 PATH 中。如果未找到latexmk，check会返回skipped: true并跳过编译，但其他三个命令（纯 BibTeX/文本处理）仍然可用。 - 网络访问：
bib-fill是唯一需要网络访问的命令（调用 Crossref API）。 - 写入操作：
--write标志会就地修改.bib文件。
短结尾¶
该插件将 LaTeX 工具链集成到 DeepSeek Harness 中，帮助智能体处理文档编译与引用管理。详细信息请访问插件目录或GitHub 仓库。
