struct-explain 是什么（人格锚：无，纯专业结构化域）
struct-explain 是 struct-* 知识结构化系列的第六个成员，定位「费曼讲解」。它读取一份讲解某个 / 若干概念的中文材料（教材片段 / 百科词条 / 讲义 / 读书笔记），抽成「一句话定义 + 大白话解释 + 类比 + 常见误解」四宫格，并量化费曼完整度。
它不是语义级「讲解引擎」（那是大模型或真人口播的事），而是更日常的「讲解收口」——一份材料里讲了一个概念，你读完却说不清它一句话是什么、用大白话怎么讲、像生活里什么、新手最容易错在哪。本引擎在你读完时，替你把这四个格子都抽出来，并指出最该补的那一格（多半是类比或误解）。
能做什么 / 不能做什么
能做的：
- 把材料切成「一、一句话定义 / 二、大白话解释 / 三、类比 / 四、常见误解」四宫格。
- 定义识别（显式标记 是指/指的是/定义为/称为/叫做/所谓/「」/冒号标题 ∪ 裸 是 句，复用 struct-map 术语清洗与守卫哲学）。
- 大白话抽取（通俗地说/大白话/说白了/换句话说/也就是说/简单说/说穿了/直白点/用大白话说 之后的从句）。
- 类比抽取（强标记 就像/好比/如同/相当于/类似于/打个比方/仿佛/犹如 整段；弱标记 像/跟 仅当接「名词+一样/般/似的/那样」才取）。
- 误解抽取（误区/误解/很多人以为/不少人以为/不要以为/其实不是/容易混淆/常见错误/常见误区/错把X当Y 之后的从句）。
- 算费曼完整度与结构化增益；产物末尾附
STRUCT_RESULT尾块供程序消费。
不能做的（诚实边界）：
- 不做语义级「真正讲懂一个概念」——深度消歧、跨材料联想、口语化润色由调用方大模型完成，本引擎只做结构化抽取与重组。
- 不生成新表述、不改写、不跨句联想；产出的每一句都来自原文，可一键回原文核对。
- 不保证命中所有写法；四格抽取是启发式，覆盖常见中文写法，偶有不中。
边界说明
- 输入应为一份讲解某个 / 若干概念的材料，建议 5 句以上、至少两段、含定义句与白话 / 类比 / 误解标记句；极短或纯叙述片段增益偏低属正常，非缺陷。
- 与 struct-summary（长文摘要）、struct-meeting（会议派活）、struct-note（零散笔记）、struct-concept（单概念卡片）、struct-map（多概念织网）分工明确：explain 处理「把一个概念讲透」，不处理长文压缩或多概念织网。
怎么用
python scripts/struct_explain.py build --input 讲解材料.md --output 四宫格.md
python scripts/struct_explain.py rules # 查看量化阈值
python scripts/struct_explain.py ledger # 归集历史产物的费曼完整度
python scripts/struct_explain.py version # 打印版本
四宫格生成后会输出四格与 feynman_completeness，并在产物末尾附上机器可读的 STRUCT_RESULT {...} 判定块，供流水线程序化消费。
量化模型（原创点）
费曼完整度 feynman_completeness（0-100，结构化增益 = feynman_completeness，保持家族字段名）：定义（权 0.30）+ 白话（权 0.25）+ 类比（权 0.25）+ 误解（权 0.20）。定义权重最高——一句话说清本体是讲解的锚；白话与类比并列次高——降门槛与搭桥是费曼法的两翼；误解权重最低——清障是加分项。阈值见 resources/thresholds.json。退出码 0/1/2/3/4（struct 非阻断型，4 保留）。
理论底座
- 费曼学习法：物理学家费曼的核心理念——能否用自己的话、用大白话把一个概念讲清楚，是对「真懂」的检验。四宫格正是这个检验的结构化落点：定义给锚点、白话降门槛、类比建桥、误解清障。
- 卡片盒笔记法（Zettelkasten）：卢曼强调「每张卡片只讲一个概念、且能被链接」。struct-explain 的四宫格是单概念卡片的讲解层，四格齐备才是一张可被复述、可被链接的好卡片。
- 抽取式 vs 生成式：抽取式（extractive）按启发式挑句重组，稳定、可重跑、不幻觉；生成式（abstractive）交给大模型。本引擎走抽取式。
与其他成员的关系
struct-explain 常接在读书 / 听课 / 读百科之后，是知识链里「把单概念讲透」的一环；上游可接 struct-note（从笔记里抽概念）、struct-concept（单概念建卡片），下游可接 struct-review（进复习排程）/ 大模型口语化润色。与 guard / check 不重叠（那是防护 / 验证，这是整理）。
