在 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 倉庫。
