售前题库出题质量规范
凡生成售前刷题题库，逐题对照本规范。质量红线不可妥协。
一、依据与来源
- R1 严格溯源：每题事实来自给定文档/PPT/知识点，不超纲、不杜撰；无来源的知识点写「需向产品确认」，不出题。
- R2 术语用原文：用源文档术语，不擅自换成近义词（如原文「特征」不改成「特点」）。
二、选项质量
- R3 选项绝对不重复：ABCD 四项的文字、句意、所指答案互不重复、互不相似。
- R4 高干扰性：错项来自易错点 / 混淆概念 / 相似知识点 / 常见误区，非明显离谱。
- R5 选项逻辑独立：四项互不包含、互不推导、互不提示答案（A 是 B 的子集即废）。
- R6 选项长度均衡：四项文字长度尽量接近，正确项不因描述详尽明显更长/更短（防长度泄答案）。
- R7 单一正确答案：每题恰有一个无歧义正确答案，解析可证伪、可复核。
- R8 杜绝垃圾选项：禁「以上都对 / 以上都错 / 不确定 / 无所谓」等敷衍项。
三、题干质量
- R9 题干严谨：一句话只考一个核心知识点，不模棱两可。
- R10 否定式显标：若题干为「以下错误的是」，须加粗【错误】提示，避免误读。
四、解析质量
- R11 每题全解析：正确项写清为何对；每个错项分别写清错在哪、混淆了什么知识点。
五、难度与分布
- R12 难度配比均衡：基础 / 中档 / 易错 / 陷阱合理配比，不全简单、不偏怪。
- R13 知识点全覆盖：均匀抽取，覆盖定义 / 区别 / 分类 / 特征 / 误区 / 应用；同知识点不重复出题。
- R14 概念区分优先：重点出易混淆成对知识点（特征 vs 作用、方法 vs 原则、技能 vs 素养）。
- R15 错题针对性强化：专设易错易混题，提升刷题效率。
- R16 难度+知识点标签：每题带难度标签（基础/中档/易错/陷阱）与知识点标签，支撑错题库与薄弱分析。
六、结构与渲染
- R17 正确项位置均衡：渲染时旋转使 A/B/C/D 均衡分布，不固定首/末位。
- R18 题量下限：每章题数设下限（建议 ≥30）保证覆盖；每题带模块标签
m。
禁止清单
- 编造知识点或超纲出题
- 选项文字/句意重复或相似
- 错项明显离谱、无干扰性
- 选项互含/互推/互泄答案
- 出现「以上都对/以上都错/不确定」
- 一题考多个知识点或题干模棱两可
- 只给正确项解析、漏写任一错项解析
- 全卷偏易或偏怪、知识点扎堆同一处
七、渲染规范（刷题网页实现）
本规范第六条只规定"正确项位置均衡、题量下限"，没有给出题变网页。下面是把题库 JSON 渲染成可双击即开、即时判分、全解析、进度跟踪的刷题网页时，必须实现的条款。所有条款带可视/grep 校验方式。
7.1 数据契约（题目 JSON 必须字段）
除 R18 的 {q, o:[4], e:[4], m} 外，渲染需要补充三字段：
difficulty：基础 / 中档 / 易错 / 陷阱（R16 要求，渲染时右上角显示角标）knowledge：知识点标签数组（R16，支撑错题归类与薄弱分析）case_ref：案例归属字符串（如"快手""商汤"）。错项解析可引用别案例归属（"R8628 G13 是商汤案例中的产品"），但必须能在题库中找到依据，否则退回通用错因写法
模块层级约定：m 取 "章.题" 两段式，如 1.3 表示第 1 章第 3 题；进度与章节标题由此推算。全卷 m 格式必须统一（RR4）。
7.2 布局规范（对照成品截图）
| 区域 | 内容 | 约束 |
|---|---|---|
| 顶部 | 章节标题（如"1.3 快手案例"） | 灰底小字，显示在题干之上 |
| 题干 | 单行/多行自动换行 | 不撑爆视口 |
| 选项区 | 4 项垂直排列，每项整行卡片 | 左：字母徽标(A/B/C/D 圆圈) 中：文字 右：状态色块 |
| 反馈后 | A/B/C/D 四项全部显示 ✓/✗ 与解析 | 非只看所选项（落实 R11 全解析） |
| 底部三栏 | 左：返回首页 / 中：上一题 下一题 / 右：进度 X/Y + 正确 N | 固定底部，永远可见 |
7.3 判分与即时反馈（截图核心）
- 触发：点任一选项立即判分，无"提交"按钮
- 视觉：✓ 绿底+勾；✗ 红底+叉；未点：白底+悬停态
- 答题后：4 选项锁定不可再点（RR2，防刷分）
- 答题后：该题标记"已答"，回看时显示解析不重判
- 答对：正确计数 +1，进度增长；答错：计数不变，进度仍增长（错题由错题库累计，见 7.6）
- 允许"跳过"：点下一题不扣分
7.4 进度与统计（右下角"第 2 / 18 题 正确 1"）
- 必须实时显示：当前题号/总题数、已答正确数、已答错误数
- 模块进度：本章已答/总题（如 1.3 已 6/8）
- 整体进度条：当前章节百分比；完成章后下一章解锁
- 完成度阶梯（复用工作台阈值）：未练 / <60 / 60–80 / ≥80 → 红橙绿四色
7.5 导航与边界
- 返回首页 → 关卡选择页（见 7.10）
- 上一题：本章内循环，到第 1 题禁用；下一题：答过自动前进，到末题变"完成本章"
- 完成本章 → 成绩单：分数 + 错误率 + 易错知识点 Top3 + 错题入口
- 浏览器关闭重开能续进度（localStorage 落盘）
- 重置：章节卡上"重置本章进度"按钮，二次确认防误触
7.6 持久化键（命名强约束，避免与 wb_* 冲突）
qz_scores_<moduleId> 本章答对题号清单 例 qz_scores_1
qz_progress_<moduleId> 本章已答最大题号 例 qz_progress_1 = 7
qz_wrong 错题库（与 workbench-quiz 的 wb_wrong 统一）{module, idx}
qz_meta {lastOpenAt, version, schema}
- 必须
mem{}内存兜底：file:// 下浏览器可能禁 localStorage，不兜底即白屏（与 workbench 同源规则） - 禁止用 IndexedDB（file:// 下 API 不一定可用）
7.7 渲染防漏硬规则（RR1–RR7，每条可校验）
- RR1 解析跨案例引用必须有依据：错项写"X 是别案例产品"，数据须支持，否则退回"X 用于 Y 场景"通用错因
- RR2 答题后禁止重新点击选项（grep：选项 onclick 在 answered 状态须 return）
- RR3 答对/答错都用全解析（R11），不得只显示"错了"
- RR4 题号显示为 "1.3" 或 "1-3" 须全卷统一（grep：模块分隔符只有一种）
- RR5 难度角标全卷可见（右上角小标"易错"），让学员知道在练什么
- RR6 选项可点击区域 ≥ 44px（移动端兼容），不细到像素级
- RR7 进度条必须真实反映状态：已答/未答颜色不同，禁止全部涂成 100%
7.8 视觉规范（从成品反推，固定复用）
--side:#1f2937 --side2:#273449 --brand:#2563eb
--bg:#f5f7fa --card:#ffffff
--ok:#22c55e --ok-soft:#dcfce7
--err:#dc2626 --err-soft:#fee2e2
--skip:#d97706 --untrained:#94a3b8
圆角：卡片 12px / 按钮 8px
字号：题目 18 / 选项 16 / 解析 14 / 元数据 12（px）
7.9 离线自包含 + file:// 兼容
- 禁用任何 CDN / 外链字体 / 外链 JS；CSS 全内联
- 状态用 localStorage，不引框架
- 双击 .html 直接开，不依赖 Web Server
7.10 首页 / 关卡选择页（闭环入口，未展示但必须）
关卡主页（每章一卡）：
1.1 AI训练 8/8 ✓ 85% ← 已练满分
1.2 商汤 6/8 ◐ 75% ← 已练未满分
1.3 快手 1/18 练这章 ← 当前章节
1.4 今日 🔒 待解锁 ← 前一章未达 60% 不解锁
首页是上一题/下一题逻辑成立的前提；无首页则闯关无意义。
渲染禁止清单
- 点了选项还要再点"提交"才判分
- 只显示所选项的对错、隐藏其余三项解析
- 答题后选项仍可重复点击刷分
- 进度/正确数不实时更新或造假（全涂 100%）
- 引入 CDN / 外链资源导致断网白屏
- 用 IndexedDB 而在 file:// 下不兜底
- 关卡首页缺失，闯关无入口
