dsh-latex-guard
适用于 DeepSeek Harness 和任何智能体的 LaTeX 编译检查及 BibTeX 检查、填充和审计工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-latex-guard@0.1.3Latex Guard 以 dsh-latex-guard 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
LaTeX compile check and BibTeX lint/fill/audit tools for DeepSeek Harness and any agent.
latexmk and return a structured report of errors, warnings and undefined citations.tex files against a .bib file: cited-but-missing and never-cited entries. Recognized commands: \cite, \citep, \citet, \parencite, \textcite, and the biblatex commands \autocite, \footcite, \fullcite, \nocite (a \nocite key counts as cited).All commands return human-readable output by default and structured JSON with --json. Exit codes: 0 success, 1 business error, 2 usage error. A check that compiles but reports status: "failed" also exits 1; a skipped check (latexmk unavailable) exits 0, since graceful degradation is not an error.
dsh plugin add dsh-latex-guard
Registers four agent tools: latex_check, bib_lint, bib_fill, cite_audit.
npx dsh-latex-guard check <dir> <entry.tex> [--engine <name>] [--json]
npx dsh-latex-guard bib-lint <file.bib> [--write]
npx dsh-latex-guard bib-fill <file.bib> [--write]
npx dsh-latex-guard cite-audit <file.bib> <tex...>
--write modifies the bib in place — confirm before using it. As a safety net, both write paths refuse to write when the bib cannot be fully parsed (e.g. an entry missing its closing brace), instead of silently dropping the unparseable tail.
check --engine <name> selects the latexmk engine: auto (default), pdflatex, xelatex or lualatex. In auto mode the engine is detected from the entry tex (and a local \documentclass file): a % !TeX program = ... magic comment, \RequireXeTeX, xeCJK or {ctex select xelatex, \RequireLuaTeX selects lualatex, otherwise pdflatex. The report's engine field records the engine actually used; when a compile fails without any parseable error line, the report also carries a logTail with the last lines of the latexmk log.
cite-audit counts \cite keys inside commented-out (% ...) lines as real citations.passed check report may still carry citation warnings emitted by latexmk's intermediate passes; only the final pass reflects the true citation state.The skill/SKILL.md bundled in this package teaches any SKILL.md-compatible agent how to drive the CLI.
check requires a TeX installation providing latexmk on PATH (e.g. TeX Live or MiKTeX). When latexmk is not found, check degrades gracefully: it returns a report with skipped: true instead of failing, so the other three commands (pure BibTeX/text processing, no TeX needed) remain fully usable.
bib-fill is the only command that needs network access (Crossref API, 10s timeout, one retry).
MIT