vividdraft 是一套基于 VividBook 的 LaTeX 文档类（vividdraft.cls），把原本「教科书式」的笔记排版，整体重装成暗场工程制 图的视觉语言：黑底、方格纸、墨线、朱红强调、图号标题栏、尺寸线、气泡标注、剖面线、公差带——一整套工程师读图时才懂的符号系统。

它不只是一层皮肤，而是一套「内容 = 图纸」的隐喻：章节是「图纸」，小节是「视图 / 详图」，知识点是「零件」，目录是「图纸目录（BOM）」，连封面上都 摆着图号、修订表、图例和系列课程的「装配关系图」。你写的笔记，会被编排成一份可以「审图」的工程文件。

设计语言

三种底色一键切换：默认 dark 暗场、bright 白图（打印用：白纸 + 粗方格 + 墨线 + 朱红单强调）、blueprint 晒图蓝。封面三选一：六门课的预设图纸、\coverview{bom} 自动列章（零成本），或 \coverdrawing 自己画一张 TikZ 装配图。

与 VividBook 的关系

零迁移成本：老文档只改第一行 \documentclass[...]{vividdraft} 即可，\title、\subtitle、\version、\bioinfo、各类定理与盒子环境原样保留。模板内置了完整的 VividBook 兼容层，demo 里「VividBook 环境迁移对照」一章就是把旧环境的 definition / theorem / lemma / example / minted / lstlisting / problemset 原封不动搬过来、验证都能编译的。

适用场景

• 想把学习笔记 / 讲义 / 课程资料做出「工程图纸」质感的个人项目；
• 机器学习的原理可视化——demo 把「学习机器」拆成总装图、详图 A（神经元）、详图 B（梯度下降）、剖视 C（三种学习方式）、视图 D（拟合公差），正好演示了这套语言怎么讲技术概念；
• 需要打印输出的场景（切 bright 即可）。

快速开始

  \documentclass[lang=cn,10pt,newtx,thmcnt=section,cod=minted]{vividdraft}
  \title{Python 课程笔记}
  \coverview{bom}
  \begin{document}
  \maketitle \tableofcontents \mainmatter
  ...
  \end{document}

  编译：xelatex -shell-escape main.tex，跑 2～3 遍（总张数 / 目录 / 部分页明细表依赖上一遍的 .aux）。不加 -shell-escape 也能编译，代码高亮自动退回
  listings。推荐字体：B612 Mono（标注 / 代码）、Noto Sans SC（正文，含 Black 字重做标题）。

声明：这玩意是闲来无事让 Claude做的
  ---