diff --git a/CLAUDE.md b/CLAUDE.md index 06e526b..4717a54 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -95,6 +95,7 @@ README 开头「这本书想回答的问题」表**一节只占一行**(2026-0 电子版四样(EPUB、PDF、离线单文件、Anki 牌组),全由 `.github/workflows/book.yml` 在 main 上正文改动后自动生成,挂到固定 Release `epub-latest`(下载链接不变,README 引用的就是它),PR 只生成校验不发布;产物都进 `dist/`(已 gitignore)。**产物本身不入库**,正文几乎天天改,提交二进制只会过时和撑大历史(2026-09-18 issue #12 定的方案)。README 的结构解析和文件清单收在 `tools/lib/book.mjs`,各套构建共用,新增节或长文不用改脚本。**但新增 docs 长文必须手工挂四处链接**(2026-09-21 连漏两次,两次都是用户发现的):① README 顶部导航表格里「长文」那一格(HTML 表格,单元格里必须留空行、用 markdown 写成「[x](docs/x.md)」,写成 `` 就不被下面那个正则认;2026-09-28 导航区改成表格后不再带「(长文)」后缀);② README 末尾「长文另见」那句;③ README 对应节的目录行(写成「长文见 [docs/x.md](docs/x.md)。」);④ index.html 里 `class="doc-links"` 那一行,URL 要百分号编码。核对办法:`grep -c "docs/<名>.md" README.md` 应为 3,`grep -c "<名>" index.html` 应为 1。第 ① 处是硬性的——`book.mjs` 第 54 行靠正则 `\]\((docs/[^)#/]+\.md)\)` 从 README 里扒长文清单,只在 book/ 条目里链接,EPUB、PDF、离线单文件三套构建都收不到它。sync-stats.ps1 不检查这三处。 - **超长的收益、备注和来源在四个出口里都拆成子条目,正文 md 不动**:收益、备注超过 300 字的,在句号处、且下一句开始引用新依据(「X看《…》」「《某条例》」「刑法第…条」「另一项试验」「案例二」等)时断开;来源按括号外的「;」一条一行。规则有两份,`tools/lib/split-items.mjs` 给 EPUB、PDF,index.html 里 `// ` 那段给检索网页和离线版,**改一边要同步改另一边**,`node tools/check-split.mjs` 拿全书逐条比对两边结果,也查拆完能不能逐字拼回原文、`**` 有没有被拆开(CI 里是「拆分规则一致性检查」job)。正文仍一个字段一行,index.html 按行解析、sync-stats 按「- 来源:」行数链接都不受影响。 +- **生活自查页 `selfcheck.html`**(2026-10-11 加,入口在 index.html 页头、README 导航表格「自查」行、sitemap):一组是否题,每题按「第几节 + 标题里的一段字」对到一条条目,不写条号,结果页按做到比例、性价比和成本标签里的毅力分堆汇总。**故意不算「少活几年」**:各条的风险来自不同研究、互相重叠,不能相乘。改条目标题时,如果删掉了某题用的那段字,这题会静默消失,控制台报错;改完标题用 `grep -o "key:'[^']*'" selfcheck.html` 对一遍。离线单文件版不带它,build.mjs 把链接改写成线上地址。 - EPUB:`tools/epub/build.mjs`(只依赖 marked,zip 用 `tools/lib/zip.mjs` 自己打,Anki 牌组也用它),CI 里跑 epubcheck。本地 `cd tools/epub && npm ci && npm run build`。 - 离线单文件 HTML:`tools/offline/build.mjs`(零依赖)把正文**和 docs 长文**内联进 index.html 的 `window.__CORPUS__`(`parts` 放 book/、`docs` 放长文),双击就能看、离线可用;index.html 的 `init()` 认这个变量就不发请求,改 init 的取数逻辑要同时顾到这条路。**检索页的长文是就地弹窗打开的,不跳 GitHub**:点击处统一拦「指向 `docs/*.md` 的 GitHub 链接」(页头那行长文、条目备注里 `hrefOf()` 转出来的相对链接,形状都是这一个),弹窗自带一份可点的章节目录和 scrollspy,markdown 由 index.html 里那个只认标题/段落/列表/表格的小渲染器处理,不引库。长文里如果开始用引用块、代码块这类新语法,要同步加进那个渲染器。 - PDF:`tools/pdf/build.mjs` + `tools/pdf/template.typ`,pandoc 转 typst、typst 排版(A4、每节另起一页、页眉带节名、目录带页码、书签到条目级)。本地要 pandoc ≥ 3.1 和 typst ≥ 0.13,用环境变量 `PANDOC`、`TYPST` 指到可执行文件;CI 里按 workflow 顶部 env 里钉的版本下载。版面只改 template.typ。 diff --git a/selfcheck.html b/selfcheck.html new file mode 100644 index 0000000..092773a --- /dev/null +++ b/selfcheck.html @@ -0,0 +1,450 @@ + + + + + +生活自查 · 高性价比人生指南 + + + + + + + +
+
正在读取正文 …
+ + + + +
+ + + +