docs(user-manual): 强制纳入 dist 交付物（html/pdf/docx）并补充重建说明

2026-09-18 09:53:17 +00:00
parent 8142389b4b
commit 65df9d13ed
4 changed files with 794 additions and 1 deletions
@@ -24,4 +24,6 @@ node docs/user-manual/scripts/capture-screenshots.mjs
 node docs/user-manual/scripts/build-formats.mjs
 ```

-依赖：pandoc（`brew install pandoc`）、playwright（复用仓库 `web/node_modules`，chromium 已安装）。
+注意：`dist/` 在根 `.gitignore` 中被忽略，本仓库通过 `git add -f` 强制纳入版本管理；本地重新生成后需同样 `git add -f docs/user-manual/dist`。
+
+依赖：pandoc（`brew install pandoc`）、playwright docker 镜像 `mcr.microsoft.com/playwright:v1.63.0-noble`（PDF 打印在容器内执行，主机缺 chromium 系统依赖）。