《HowToLiveBetter》开源项目分析：一本把人生建议做成"性价比清单"的书
分析基于仓库
eternity4719/HowToLiveBetter，克隆时间 2026-10-05。
一、这是什么项目
《HowToLiveBetter》（中文名《高性价比人生指南》）自称是"高性价比人生指南"------用最少的钱、时间和精力，换回最多的寿命、金钱和人身自由。它不是一本小说式的心灵鸡汤，也不是营销号式的人生格言合集，而是一份按性价比排好序的条目清单。
作者谦虚地把这本书定位成"备选单，不是任务清单"："不用全做，挑走一两条就算数，作者自己也没做到其中大部分。"这种极度克制、不下命令、不贩卖焦虑的姿态，是这个项目最鲜明的气质。
项目目前的体量：
- 663 条建议，分布在 34 个章节里；
- 每条都标注成本、收益、证据等级和"说人话"翻译；
- A 级证据 433 条（有具体数字、出自荟萃分析或大型随机试验）、B 级 176 条、C 级 54 条；
- 1644 条原始文献链接，只引期刊论文（附 DOI）和官方机构文件（WHO、CDC、国家统计局等）；
- 提供在线检索页、PDF、EPUB、离线单文件 HTML 四种阅读方式；
- 附带一个可供 Claude Code / Codex 安装的 AI skill，让 AI 照书回答"该不该做、值不值"。
二、核心理念：四样资源 + 性价比排序
本书不像传统的健康/人生建议书只盯着"活得久"，它把人生的有限资源拆成四样：
- 寿命------活得更久，少死于本可避免的事；
- 时间与精力------不把活着的日子花在没有回报的事上；
- 金钱------少花冤枉钱；
- 人身自由------不因为不知道一条红线，把自己送进拘留所或看守所。
每一章节围绕一件"别做的事"展开（不要早死、不要慢慢死、不要浪费钱、别把自己搭进去......），面覆盖极广：从系安全带、换低钠盐、打疫苗，到婚姻彩礼、创业办证、程序员写代码踩的法律红线、出工伤拿补偿、老人遗嘱监护，再到身故后的处理流程。
排序原则是"性价比优先"而不是"类别优先"：几乎不花成本、换回好处又大的条目放在最前面。每条都必须回答"花掉什么"和"换回什么"两个问题，并且把收益率、成本维度（钱/时间/精力/毅力）、受益人口径（受益落在你自己、家人、朋友还是陌生人）都明确分开。
衡量标准也因此非常"数据化"：比如"把食盐换成低钠盐"这条------中国农村一项 20995 人的随机试验显示，得过卒中或 60 岁以上高血压的人五年内死亡风险低约 12%，中风低约 14%。数字、置信区间、样本人群、来源文献一应俱全，可复核性极强。
三、项目结构
HowToLiveBetter/
├── README.md # 总入口：定位、目录、读法、部署说明
├── index.html # 在线检索页（纯静态，README 和 book/ 就是它的数据源）
├── book/ # 正文，34 章 × 663 条 Markdown
├── docs/ # 8 篇长文 + 数十篇"核实记录"（新增条目的依据说明）
├── skills/
│ └── life-decision-guide/ # AI skill（SKILL.md），Claude Code / Codex 用
├── tools/ # 生成 EPUB/PDF/离线 HTML、检查引用、同步统计数字的脚本
├── .github/workflows/ # CI：每周自动检查链接失效、交叉引用检查、统计数字检查
├── CLAUDE.md # 项目改动规则，是全书"宪法"级的编辑规范
└── LICENSE / LICENSE-CODE # 正文用 CC BY 4.0，代码用独立的软件许可技术上的亮点是------这个"在线检索页"没有任何后端、数据库和依赖 。README 和 book/ 目录就是数据，index.html 是纯静态页面，丢给任何静态服务器（GitHub Pages、Nginx、对象存储）都能跑，python -m http.server 在本地就能启动。内容每更新一次，PDF、EPUB、离线单文件三个版本由 CI 自动重新生成。
四、为什么说它"认真"
这个项目最打动人的地方，是近乎偏执的可信度纪律。写在 CLAUDE.md 里的编辑规则细到苛刻：
- 证据分级：A 级（有可量化证据，来自荟萃分析/大队列/RCT）、B 级（有支撑但难量化）、C 级（经验或共识）。有争议的 A/B 级条目必须标注"争议"并列出反方证据。
- 只引原始文献：期刊论文带 DOI，或 WHO/CDC/官方机构报告；明确禁止引知乎、微信公众号、搜狐、网易等二手平台。
- "说人话"不得掺水 ：这一栏把统计语言（HR、RR、OR）翻成人话，但不许出现收益栏里没有的数字，不许新增收益栏没写的症状、断言或机制解读------被用户抓出两处后专门立了这条规矩。
- 句子层面的硬标准：为照顾老年人、残障和读得慢的读者，全书重写了一遍，平均句长从 66 字压到 29 字，超过 70 字的句子从 1385 句降到 64 句。
- 反 AI 腔：专门开列"元叙述、段尾升华句、电报体、空转加强词"等毛病清单，用户实测调查后第二天改掉 306 处"也就是"。
- 写"法律支持你"时必须写过程成本：不打官司、大概多久、谁掏律师费，不能把"胜诉率"当收益糊弄读者。
更有意思的是交叉引用的自检机制 ：正文里 257 处"见第 X 节第 X 条"只记条号不记内容，一旦插入新条，后续条号集体顺延，引用却留在原地，很容易悄悄指错。项目专门写了 check-refs.mjs 工具，把每处引用实际指向的条目标题连同上下文生成一份《引用对照表》入库，CI 里用独立的"交叉引用检查"任务每天把关，防止引用错位。
每周一的 CI 还会自动跑 check-links.mjs，扫描 1644 条文献链接是否失效。失效时按"官网新地址 → 官方原文 → web.archive 存档"的顺序修复，并且区分"确定失效"和"只是 gov.cn 挡境外机房 IP 连不上"两种情况，避免误报、误删。
五、优点与独特价值
- 可复核是核心竞争力。绝大多数建议书的问题是"说了一堆正确但无法验证的话"。这本书把每一条都挂到 DOI 和官方文件上，你想较真随时能去核对原文，这是极其罕见的信任建设。
- 覆盖面罕见地广。从医学证据、急救常识，到法律红线、社保待遇、创业办证、境外安全，一个人一生可能用到的"避坑"信息几乎都收纳进去了，而且都是针对中国大陆现行制度写的。
- 把"选择权"还给读者。它不命令、不贩卖焦虑，而是把性价比清单摊开让你自己挑。作者自己都没做全这件事，本身就是在示范"这是备选单，不是劫持你人生的任务清单"。
- 工程化与自动化程度高。反馈闭环很完整：有 AI skill、有在线检索、有 CI 自检、有统计数字同步脚本，甚至有一条规则专门防"网页上直接合并的 PR 不经过统计脚本导致数字过时"。维护质量像在维护一个严谨的开源软件项目。
- 开放协作机制友好。GitHub Issue 模板分"纠错"、"新内容"两类，docs/ 下每一批新增条目都留有"核实记录"，说明缘起、依据和权衡，整个过程像考古档案一样透明可追溯。
六、值得注意的局限
- 证据等级不等于因果。作者自己诚实指出：A 级只说明"有具体数字、出处可核"，不说明这个数字一定是因果。你的观察性研究（只跟踪记录、不分组）分不清是这件事起了作用，还是做这件事的人本来就健康。读者若只看结论门槛，容易过度相信。
- 中国大陆语境。法律、医保、社保等内容"按中国大陆的现行规定写"，受众地域是明确的；制度变化后需要持续跟进维护，好在有 CI 和定期核查兜底。
- 维护成本极高。全书 663 条、1644 条文献、300 多条编辑硬规则，全靠一个（或多个）极其投入的维护者维持，这种质量能持续多久，取决于作者的热情能否长期支撑。
- "说人话"与"收益栏"可能相互打架。为了防止这一栏掺水，规则把它限制为只能转译收益栏已有的内容------这保证了严谨，但也意味着最通俗的话仍受原始研究措辞的约束，给普通读者造成的一定理解门槛没有被完全消除。
七、结语
《HowToLiveBetter》值得被称为"开源精神在人生建议领域的稀缺样本"。它把通常只存在于鸡汤和营销号内容里的题材，用科研论文的严谨标准、软件工程的自动化流水线和开源社区的透明协作重做了一遍。它最大的创新不是"写了什么建议"，而是证明了人生建议可以做成一份可复核、可筛选、按性价比排序、还能源源不断被社区纠错和改进的数据集。
对普通读者来说，它是一份随时可查的避坑备选单；对做内容、做科普、做开源的人来说，它更是一个如何"让信息可信"的教科书级范本。
