Wjs Voicedrop Writing Explainary Book

科普书写法 — 讲清一件事（explainary）

这是 wjs-voicedrop-writing-book 的写作模块之一（type: explainary）。工作目录、book.json、build.mjs、发布、封面、断点续跑、修书模式、编排、红线等通用机制全部在 wjs-voicedrop-writing-book，本文只规定科普书怎么写：读者画像、文风、大纲要求、写手/评审提示词、专属 HTML 约定。

这类书解决的问题：让一个好奇的人真正弄懂「它到底怎么运作 / 为什么是这样 / 如果不是会怎样」——科学、技术、历史、商业、制度背后的因果与规律。

读者画像：对世界有好奇心、想弄懂运作规律的人；默认理工背景 / 软件工程师——爱因果、爱类比、烦空话、烦面面俱到。

文风铁律（费曼式，一票否决）：

• 不用大词。每个专有名词第一次出现都当场用大白话解释。
• 宁可用一个精准的类比，也不用一句正确的废话。
• 讲因果链，不堆词条；讲「怎么运作」，不背「是什么的定义」。
• 宁少而深，拒绝百科口吻和面面俱到。

先例：/a/jingangjing/（金刚经·理工男读本）就是这个文风的样子。

建筑师：大纲怎么切

Spawn 一个 agent，产出书名、slug、subtitle、切入角度、8–20 章清单（每章 no / title / 一句 brief）、tint/dark 配色、一句 introTeaser。要求：

• 章节是递进的，不是并列词条；每章解决上一章留下的疑问。
• 每章可独立成篇（读者可能从中间进来），但合起来是一条线。
• 面向理工好奇者：多用「怎么运作 / 为什么是这样 / 如果不是会怎样」。
• 定一个贯穿全书的问题（读者读完能回答的那个），大纲围绕它推进。
• 拒绝百科口吻和面面俱到；宁少而深。
• book.json 写上 "type": "explainary"，tagline 建议 "费曼式写法 · 由多个 AI 代理撰写与互相审校"，meta 建议 "面向理工背景的好奇者"（随书调）。

写手 subagent：提示词要点

给写手：本章 no / title / brief + 全书大纲（知道上下文、别重复别的章节）+ 上面的读者画像与费曼铁律。要求：

• 输出格式：一段 <article> 里面的 HTML 片段，只用这些标签： <p> <h2> <h3> <ul>/<ol>/<li> <strong> <blockquote> <code> <figure><img><figcaption> <dfn>。
• 科普专属 HTML 约定：
  • 名词第一次出现，用 <dfn>词</dfn> 标记，并紧跟一句大白话解释。
  • 需要「翻译成人话」的地方，用大白话盒子：<div class="plain"><p>……</p></div>（build.mjs 的 CSS 会给它加「大白话」标签样式）。
  • <strong> 只标真正的重点（会被渲染成强调色）。
• 不写 <h1>（标题由模板出）；不写内联 style；不编造图片 URL（配图是最后一遍，见通用 skill 第 6 步）。
• 长度：一章约 1200–2500 字，够把一件事讲透即可。
• 存到 chapters/NN.html。

评审 subagent：维度与判定

独立 spawn（不能是该章写手，不喂写手思路），只喂「该章成品 HTML + 全书大纲」。提示词：

你是独立评审，没参与写作。从三个维度打分（各 1–5，给一句理由），并给出必须修的问题清单：

1. 准确度：有没有事实/因果/数字错误？可疑处自己查证（web / Explore）再下判断。列出每一处硬伤。
2. 新颖性：有没有超出「维基百科第一段」的洞见？还是正确的废话？点出哪些段落是陈词滥调。
3. 有趣度 & 费曼度：类比好不好？名词有没有当场讲人话？有没有大词/黑话没解释？读起来累不累？

判定 pass：准确度必须 ≥4，且新颖性、有趣度都 ≥3，且没有未解决的事实硬伤。否则 fail。 输出 JSON：{"scores":{"accuracy":n,"novelty":n,"fun":n},"verdict":"pass|fail","must_fix":["…"],"note":"一句总评"}

存 reviews/NN.json。不过就按通用 skill 的循环换新写手照 must_fix 重写，最多 3 轮。

导读页（建议有）

全书过半后写 intro.html（也走写→评）：用一个钩子把读者领进门——点出那个「贯穿全书的问题」，给一个反直觉的入口（先例：熵那本的「先别背公式，先想想一副新牌」）。在 book.json 填 introTeaser。

插图密度：默认不配

默认整本不配插图。 只有当某个概念不画图就真的讲不清楚（绝对必要）时，才配一张；纯粹「好看/点缀/帮气氛」一律不配。宁可一张都没有——大多数章节都不需要图。判断要克制。

真到了绝对必要时（每章至多 1 张，走通用 skill 的 paint 流程）：无字纯画面——绝不放大标题、不放正文文字、不放乱码/水印（说明写在 <figcaption> 里，不在图里）；风格随书 tint/dark、淡雅。

科普专属 Red Flags（通用红线见 wjs-voicedrop-writing-book）

• 正文出现没解释的大词/黑话 → 违反费曼铁律，回写手重写。
• 名词第一次出现没用 <dfn> + 大白话 → 补上。
• 章节像百科词条堆砌、彼此不递进 → 大纲没做好，回建筑师。
• 段落是「正确的废话」、没超过维基百科第一段 → 新颖性不合格，重写。
• 用类比只是为了花哨、反而更绕 → 类比要精准降低理解成本，否则删。
• 准确度评分 <4 或有未解决硬伤 → 一票否决，必须改到 ≥4 才放行。
• 为了好看/点缀加插图（非「不画就讲不清」）→ 违反默认不配，删掉。