用途：对英文散文做结构可读性检查，衡量句子长度与词汇难度，不评估语义是否正确。
主要能力：用五种公式（Flesch Reading Ease、Flesch-Kincaid Grade、SMOG、Gunning Fog、Dale-Chall）分别打分并给出等级带与共识等级；按 technical、general、public 三种 profile 判定通过/失败；输出超长句列表供改写；支持 --json 机器可读输出。脚本会先剔除代码块、表格、标题和链接 URL，因为公式只适用于连续散文。
使用方式：需先安装 textstat，缺失时脚本打印安装命令并以退出码 3 退出：python3 -m pip install --user textstat。常用命令：cat <<'EOF' | python3 resources/readability.py --stdin --profile general；python3 resources/readability.py doc.md --profile technical；python3 resources/readability.py docs/ --recursive --profile general；python3 resources/readability.py doc.md --json。退出码 0 通过、1 失败、3 缺依赖。工作流为选档、打分、改写被标记句子、重新打分、循环，通常两轮即可。
适用场景：工程或科学写作、面向非专业读者的说明文、面向公众的文案。
限制：公式只测结构不测意义，通过不等于内容正确；不得为达标删减术语；表格、代码、标题不参与评分；SMOG 需 30 句以上，不足时省略而非视为通过；散文少于 40 词不评分；引用内容不应改写；无法在不损失含义的情况下通过时，应说明所缺阈值与取舍，而非静默降低档位。Dale-Chall 在领域写作中通常比其他公式高一个等级，属正常现象。