reportlisted

# report - 研究成文与三件套 **成文型 skill**:模板在 `assets/templates/report.md`(骨架)与 `assets/templates/report.typ`(渲染),渲染脚本 `scripts/render.py` 是交付物,本文件是它的用法面;写作规范、管线、版式、信源细节在 `references/`。检索与获取管线在同插件 research。 ## 一、意图路由 | 你要做的事 | 入口 | | --- | --- | | 开写一篇新报告 | `references/skeleton.md` + 复制 `assets/templates/report.md` 起步 | | 渲染 PDF / 编译门禁 | 本文件「二、命令」 + `references/triple-output.md` | | 出 Word(docx) | `references/triple-output.md` 第五节(管线知识面) | | 版式复检 | `references/layout-check.md` | | 信源分级 / 原件存档 / 完成登记 | `references/sources-and-index.md` | | 找论文、搜网页、下载原件 | 同插件 skill `evo-research:research` | | 轻量结论落 docs/research | 同市场 skill `evo-adr:doc-gov`(flow-archive 口径) | ## 二、命令(本节命令本会话实证可跑) ```bash # 渲染:生成同名 PDF(md 是唯一真源,生成物禁手改) uv run <skill>/scripts/render.py <报告.md> # 编译门禁:渲到临时目录只校验,不覆盖正式产物(退出码 0/非 0 可接 CI) uv run <skill>/scripts/render.py <报告.md> --check ``` - typst 定位三选一:PATH(默认)、`TYPST=<路径>` 环境变量、`--typst <路径>` 显式指定;命令分发由宿主工具链 omc 与 ark 统一维护,本工具不内置安装路径 - 首次编译联网拉取 `@preview/cmarker` 包,之后走缓存 - lint 面:题头里 `**关键词:**内容` 形态会告警(加粗失效且星号印进 PDF),写成 `**关键词**:内容` ## 三、产出纪律 - 三件套 `reports/YYYY-MM-DD-短名.md` + 同名 `.pdf` + `.docx`,缺一不算完成;md 改动必重渲全部产物 - 版式复检按 `references/layout-check.md` 口径(逐页转图 + 行距度量),不靠猜 - 完成登记:INDEX 一行 + 日记钩子 + 立项状态流转 ## 四、坑(实证) - **报告须有二级标题**:模板以首个 `## ` 拆题头与正文,缺失时原家族模板会让 cmarker 报 Markdown must be a string(已修为空串兜底) - **WSL 调 Windows typst.exe**:render.py 自动把路径参数转 Windows 形态;但 Windows exe 看不到 WSL 专属挂载,报告与根目录要放 Windows 盘路径(如 /mnt/d)一侧,或改用 Linux typst [实证: 2026-09-16 /mnt/d 样