论文套件 zhouxzh/dsh-paper-suite

dsh-paper-suite

论文套件：一个 Host 插件 + 两个技能。插件负责必须被执行的动作（生成骨架、核对引用、编译、拉取证据），技能负责必须被记住的判断规则（证据边界、中文 LaTeX 约定）。

组成

工具（lib/）

| 工具 | 作用 |
| paper_scaffold | 生成中文 LaTeX 论文骨架，已存在文件一律跳过，手写正文不会被覆盖 |
| paper_audit | 离线审计：引用 ↔ .bib 双向核对、重复键、缺字段、花括号、占位符、claim map locator、作者 TODO、PDF 新鲜度 |
| paper_build | latexmk 编译，返回结构化诊断：引擎、页数、错误、未定义引用、缺字形、overfull box |
| paper_sync_evidence | 从远程代码仓只拉 .csv/.json/.md/.yaml/.bib 到 evidence/，逐个记 SHA-256；二进制产物拒收 |
| paper_kit | 骨架 + 三处仓库登记 + 审计 +（可选）编译，一次跑完 |

技能（skills/）

| 技能 | 作用 |
| paper-evidence | 数字必须绑定证据文件与协议；协议不混池；negative 必须保留；claim 状态如何判定 |
| paper-latex-cn | 中文稿的目录、前言、章节、表格约定与编译排错顺序 |

技能是纯文件，复制进技能根即可被 dsh-skill-filesystem 扫描到。新增技能后需要新开 DSH 会话，当前会话不会热更新。

安装

1. 插件（工具）
npm pack
dsh plugin --profile desktop add file:C:/path/to/dsh-paper-suite-0.1.0.tgz

2. skills（纯文件）
node scripts/install-skill.mjs # 默认装到 ~/.dsh/skills
node scripts/install-skill.mjs --check # 校验是否已装且为最新

重启 DSH 桌面端后工具生效。

边界

- 离线：不判断 DOI 是否真实存在，也不判断结论是否正确。paper_audit 只证明内部证据链自洽。
- 不覆盖：paper_scaffold 与仓库登记对已存在内容保持沉默。
- 登记默认 dry-run：README.md、AGENTS.md、docs/code_repository_split.md 只在 applyRegistries=true 时落盘。
- 证据边界：paper_sync_evidence 的扩展名白名单是硬约束。

安全与权限边界

这个插件会调用外部程序并写文件，公开使用前应知道它的边界：

- paper_scaffold / paper_kit 会在你传入的绝对 root 下创建目录与文件；它们不会覆盖已存在的文件，但会创建新路径。
- paper_sync_evidence 通过 scp 拉取文件。host 必须匹配 [A-Za-z0-9][A-Za-z0-9._-]*，远程路径必须以 / 或 ~/ 开头；这两条校验会阻止 host 被当成 scp 选项（例如 -oProxyCommand=...）。scp 以 BatchMode=yes 运行，不会交互式索要密码。
- paper_build 会在指定工作区执行 latexmk。TeX 能读文件、能通过 \write18 执行命令，因此不要对来源不可信的 .tex 运行编译。
- paper_audit 只读：读 .tex / .bib / manifest 并报告问题，不修改稿件。
- 仓库登记（README.md、AGENTS.md、docs/code_repository_split.md）默认 dry-run，只有 applyRegistries=true 才落盘。

测试

npm test

CI 在 Node 18 / 20 / 22 上跑同一套测试，并额外执行 npm pack --dry-run 校验发布文件清单。

三组测试，全部离线：

1. test/smoke.mjs — 脚手架幂等、正文不被覆盖、引用双向核对、日志解析、登记行插入、二进制拒收。
2. test/host.mjs — 用桩模块启动 apply()，确认 5 个工具都能注册、render 正常、失败路径退回文本。
3. test/skills.mjs — 每个技能的 frontmatter 合法、name 与目录一致、description 足以路由，安装后可 round-trip 校验。

目录

dsh-paper-suite/
├── lib/ # 工具实现 ├── skills/ # paper-evidence, paper-latex-cn ├── scripts/ # install-skill.mjs ├── test/ # smoke / host / skills ├── cordis.patch.yml └── SOURCE.md # 上游归属与再分发条件