---
name: claude绘图
description: Claude 绘图 / Claude Drawing —— 不借助任何生图模型，由 Claude 用代码一笔一笔「画」出图片（程序化绘画）。内置七十种画风：中国水墨、水彩、剪纸拼贴、韩国彩铅、日本动漫、编辑风手绘（Riso）、油画厚涂（梵高式流向笔触+颜料浮雕打光）、浮世绘木版画（晕色、木纹、墨线主版、青海波）、像素风（低分辨率+Bayer 抖动+像素字体）、黏土定格（高度图捏出的彩泥+影棚打光）、蓝晒（普鲁士蓝日光晒图，植物剪影透光）、十字绣（Aida 布十字绣+回针绣+缎面绣+法式结）、复古仪器面板（60 年代收音机/仪器正面：柚木、拉丝铝、旋钮、刻度窗、指示灯）、贴纸拼贴·小票（模切乙烯贴纸、热敏小票、和纸胶带、吊牌、橡皮章）、实验笔记本·贴纸（线圈方格本、铅笔图表、荧光笔、红笔圈、便利贴）、黑板板书（墨绿石板、粉笔颗粒、板擦残影、示意图与公式）、赛博朋克（雨夜霓虹街道、玻璃管霓虹招牌、全息广告、湿路面倒影）、卡通手绘（蓝铅笔稿、毛笔线、错位平涂、赛璐璐阴影、逐帧抖线）、等轴 2.5D（正等轴微缩模型、一个太阳照出三面明暗、悬浮数据卡）、单线画（一根不断开的线一笔画完、唯一点睛色）、柔光 3D（光线追踪的糖果色小球海和鼓鼓的软字、景深）、形变动画（一条轮廓依次变形、洋葱皮残影、缓动曲线）、报刊拼贴（牛皮纸、手撕旧报纸、网点老照片、勒索信拼贴字）、弥散玻璃（弥散渐变、磨砂玻璃卡片界面）、包豪斯几何（三原色几何、丝网印刷海报）、复古 Synthwave（切口落日、霓虹网格、镀铬字、录像带质感）、拼豆（钉板上的熔珠小管、熨烫熔合）、岩画（沙漠漆上凿出的凹坑图形、新旧凿痕、剥落）、古埃及墓室壁画（灰泥墙、红格起稿、分栏叙事、象形文字、剥落）、罗马马赛克（石子与玻璃沿轮廓一排排铺、灰缝、燕尾铭牌）、彩色玻璃花窗（哥特尖拱窗、通体着色玻璃、grisaille 彩绘与银染、铅条、透光）、泥金手抄本（羊皮纸、鹅毛笔哥特体、朱红标题、打磨金箔首字母）、达·芬奇手稿（铁胆墨水、左手排线、红粉笔、镜像手写、机械分解图）、剪影（黑纸剪出的侧影小像、薄金粉、椭圆金框）、凸版印刷海报（木活字、红黑双色错版、木刻插图）、苏联构成主义（红黑两版、斜条与楔形、西里尔大字、网点照片拼贴）、装饰艺术 Art Deco（1930 年代喷枪流线型海报、交替射线、阶梯高楼、金色 Deco 字）、黄金时代漫画（毛笔墨线、Ben-Day 网点、四色错版、新闻纸）、波普丝网（多格撞色平涂 + 错位的照相黑版）、ASCII 字符画（行式打印机、绿条连续纸、叠打）、低多边形（1999 年代 3D：平面着色、仿射贴图、逐顶点雾、15 位色抖动）、喷漆模板涂鸦（混凝土墙上多层卡纸模板喷绘、雾化与滴痕）、刺绣徽章（牛仔布上的机绣徽章：填充绣、缎面绣、锁边）、蓝图工程图（描图墨线晒成蓝底白线）、儿童蜡笔画（小孩在糙纸上的蜡笔涂抹）、绿屏终端 CRT（荧光字符画、扫描线、余辉）、热成像（先画温度场再上伪彩色）、代尔夫特蓝瓷砖（锡釉砖上的钴蓝手绘）、洞穴壁画（火光下的赭石、吹喷手印）、1-bit 早期画图软件（黑白整屏、8×8 图案填充）、古希腊黑绘陶瓶（黑釉剪影、刻线、饰带展开图）、铅笔素描（石墨排线、擦笔、边缘只剩线稿）、X 光片（安检透视、轮廓发亮、伪彩）、1930 年代黑白橡皮管动画（白手套、饼切眼、老胶片）、黑白麻胶版画（刻刀减法、手拓发花、套色错版）、VHS 家庭录像（钨丝灯偏色、色度渗色、REC）、扁平矢量（分层几何色块、七色、层间投影）、绘本角色动画（小角色挤压拉伸的真动画）、圆珠笔涂鸦（蓝红圆珠笔线稿、墨团、彩铅、页边涂鸦）、描图纸叠层（灯箱上的黑线底图 + 一张张单色描图纸叠片：正片叠底、套准十字、定位钉、绘图胶带）、粉彩界面 · Pastel UI（产品发布片式的界面画面：纯色粉彩底与大光斑、macOS 窗口卡片、胶囊与粗黑标题色条、状态标签与 ✓ / ✗ 徽章、放大镜、从卡片边探头的扁平小图标）、阅卷批改 · Exam Grading（绿毛毡桌上被红笔批改的答题卡：定位黑块、考号涂卡、得分格与阅卷栏、长尾夹夹住的标准答案卡、油墨不均的朱红印章、立体红笔、波浪线 / 圈 / 引线 / 批注 / 叉 / 圈起来的分数）、皮影戏 · Shadow Puppetry（油灯照亮的幕布上，雕空、透明染色的驴皮关节人偶：镂空纹样、阳刻空脸、雉翎盔头、线结与操纵杆、离幕时虚化的双影；雕花戏台、红漆金字牌匾、红灯笼）、钢笔淡彩 · Pen & Wash（速写小卡上的针管笔线稿 + 松散淡彩：线条抖、出头、不闭合，颜色错位出线、留白缝、干边与颗粒，不铺满的背景色块；大头、圆眼镜、点点眼、红鼻子的呆萌小人；卡片拍在木桌上，旁边放着针管笔和水笔）、复古水粉 · Retro Gouache（复古绘本风的水粉大头像：不透明水粉从暗到亮一层层盖上去，单色背景用干笔皴擦；大红鼻子、腮红、圆眼和大耳朵用几阶色值塑出来；看得见针脚的毛衣和毛线帽，一根根的头发和胡子，毛毡；最后是印刷书页的纸纹）、蓝调绘本 · Blue Picture Book（软蓝色调的现代绘本跨页：几乎只用粉蓝、矢车菊蓝、深青蓝三阶蓝加黑墨和纸白，只点一点珊瑚红、粉色腮红和芥末黄；毛笔 / 墨铅笔线干、抖、断，粗细不匀，线不闭合，暗部用快速来回的乱线排出来；颜色是干蜡笔、粉彩、干水粉，错位出线，纸纹的白点透出来；白粉笔痕压在蓝上，甩点和细尘；背景蓝块毛边、不到纸边；大圆脑袋、带高光的点点眼、点彩腮红和雀斑、火柴腿穿靴子的小人，乱线毛边的白色毛绒动物；最后印在书上：中缝和页码）、江南园林 · Jiangnan Garden（细笔园林春景，数字水粉插画：成千上万片叶形小笔触按一个太阳堆出树冠，暗芯、亮边、一簇簇的高光；白色和淡粉的繁花是一簇簇圆点花瓣，枝条从缝里露出来；垂柳是一绺一绺发丝般的细枝挂满小叶；黛瓦飞檐是真的瓦垄：筒瓦板瓦一行行、檐口瓦当滴水、翘起的翼角和卷起的脊头；粉墙月洞门、冰裂纹漏窗、翡翠绿槅扇和挂落、红灯笼、匾额；九曲石桥、石阶、小木船；碧绿湖面倒映岸上的一切，更柔、更暗，加涟漪和细竖纹；睡莲、白鹭；从前景花枝到雾里青山层层退远，墙上桥上落着叶影；最后一方小红印）、干刷色块 · Dry-Brush Blocks（mid-century 海报 / 水粉拼贴式的编辑插画：米白纸上几大块干笔或滚筒刷出的色块，颜色严格限定在森林绿、鼠尾草绿、青蓝、藏蓝、近黑和朱红，外加一点天蓝、淡青瓷和米色；每块颜色在自己的笔刷坐标系里刷：一道道平行的笔，起笔饱满、收笔干枯，两侧几乎是直边，两端梳成长短不一的毛齿，块里有顺笔的鬃毛纹、皴擦斑和露出来的纸色；背后的大色板用滚筒：近乎平涂、成簇的细点、干的两侧和几道细刮痕；色块像丝网套印或撕纸拼贴一样叠起来，撕口带一圈浅色纤维边；人物拆成几个大块面：亮暗两半朝不同方向刷的外套、几块肤色平面拼的头、粗黑框眼镜、干笔皴擦的白胡子；瓶子是竖刷的深色剪影加一道高光和小块标签；一旁一个小朱红方块；不勾线、不做渐变；最后像胶印：轻微柔化、纸纹、暗部零星白点、纸上细尘）、暮色微缩绘本 · Twilight Storybook（温柔、怀旧的黄昏绘本单页，满是微缩细节：大片粉彩黄昏天空，从顶上的薰衣草紫经玫瑰、蜜桃到地平线的暖金，柔和的平底云带、细细的光线和一轮低垂的淡日；一侧天空已经入夜：星空、带暗带的银河、弯月、流星，昼夜交界经过淡紫和靛蓝，不发灰；下面是一层层粉彩条纹的起伏山丘，拼布似的田、细细的垄、小圆树；前景是几万朵小野花铺成的坡，坡顶是色点，越往下越大：雏菊、矢车菊、虞美人、波斯菊、金盏花、毛茛、羽扇豆、勿忘我，夜的一侧整片变成月光蓝；很小、扁平、可爱的原创角色；上面叠一层科学图版的语言：圆形的「detail a」放大图，细墨线、排线、尺寸标注、标签和比例尺，几行灰色的小写英文手写字；最后是细颗粒、光晕、暗角和底边一道撕纸边）、排线夜景 · Hatched Nocturne（彩铅 / 色粉排线式的小幅夜景版画：天空、云、山和海全由密密的短笔触叠成，每片区域的笔触顺着同一股「风」走——天空斜着流、蒸汽绕着云团卷、山坡顺着坡向、海面横着长拖，每一笔色相和明度都差一点，笔毛分道、拖干的笔尾、纸纹里漏出的细缝，没有一处平滑渐变；深靛蓝、藏青、冷灰蓝的夜色里只有一个暖色光源，光是一层层加上去的发光笔触：核心黄白、外圈橙红、再外是被照亮的笔触，被照亮的蒸汽按「光 × 受光」上色，所以是红橙而不是粉；发光的细丝（会蜿蜒、分股、末端亮珠）、火星、星点；海面上被横向笔触打碎的倒影和光柱；几十像素高的小人靠一点亮色（围巾）点出来；最后装裱成小版画：米白纸边、压印的版痕、左下铅笔小标题、右下更小的说明，用细的普通字体）。用户说「claude绘图」「用代码画」「你自己画」「不用生图模型画」「程序化绘画」，或点名以上任一画风（含黏土、彩泥、定格动画、蓝晒、晒图、十字绣、刺绣、复古面板、老式收音机、贴纸、小票、收据、手帐拼贴、实验笔记本、方格本、荧光笔、便利贴、黑板、板书、粉笔、赛博朋克、霓虹、雨夜街道、卡通、手绘卡通、逐帧手绘、抖线、等轴、2.5D、微缩模型、单线画、一笔画、线条动画、柔光 3D、3D 渲染、C4D 风、软糖字、小球海、形变、变形动画、报刊拼贴、剪报、达达、勒索信字、网点印刷、弥散渐变、玻璃拟态、毛玻璃、包豪斯、几何构成、丝网印刷、Synthwave、蒸汽波、合成器浪潮、80 年代复古、拼豆、拼拼豆、熔珠、熨豆、豆豆画、钉板、烫豆、岩画、岩刻、凿刻、石刻、沙漠漆、史前壁刻、大角羊、古埃及、埃及壁画、墓室壁画、法老时代、象形文字、尼罗河、底比斯、罗马马赛克、马赛克镶嵌、镶嵌画、石子拼画、地砖画、古罗马地板、彩色玻璃、彩绘玻璃、花窗、玻璃花窗、教堂花窗、哥特花窗、铅条玻璃、泥金手抄本、手抄本、彩饰手抄本、中世纪手稿、羊皮纸、哥特体、花体首字母、泥金、贴金、星盘、达芬奇、达·芬奇、达芬奇手稿、手稿风、文艺复兴手稿、发明手稿、镜像字、镜像书写、扑翼机、红粉笔、钢笔排线、机械草图、分解图、剪影、剪影肖像、侧影、侧面像、黑纸剪影、剪影小像、椭圆金框、乔治时代肖像、摄政时期肖像、凸版印刷、活版印刷、木活字、铅字海报、马戏团海报、复古海报、老海报、19 世纪海报、双色套印、错版、套色错位、木刻插图、构成主义、苏联海报、苏联构成主义、俄国先锋派、罗德琴科风、红黑海报、照片蒙太奇、照片拼贴海报、西里尔字、装饰艺术、装饰风、流线型、流线型海报、1930 年代海报、旅行海报、铁路海报、火车海报、喷枪画、喷笔画、阶梯高楼、射线背景、盖茨比风、黄金时代漫画、老漫画、复古漫画、美漫封面、漫画封面、Ben-Day 网点、本戴点、网点上色、四色印刷、四色错版、新闻纸、对白框、拟声字、1940 年代漫画、波普、波普艺术、波普丝网、沃霍尔风、丝网版画头像、撞色头像、多格重复头像、六宫格撞色头像、ASCII、字符画、字符艺术、文字画、行式打印机、绿条纸、连续打印纸、针孔打印纸、老电脑打印、叠打、低多边形、低面数、低模、多边形风、千禧年 3D、90 年代 3D、复古 3D 游戏、老游戏截图、PS1 风、N64 风、平面着色、线框、游戏 HUD、飞行游戏、穿环、喷漆、模板涂鸦、镂空模板、喷漆模板、模板喷绘、街头涂鸦、街头艺术、墙绘、滴漆、班克西风格、刺绣徽章、徽章、布章、臂章、刺绣贴、绣标、锁边、牛仔外套徽章、户外徽章、营地徽章、弧形条章、蓝图、工程图、施工图、蜡笔画、儿童画、绿屏终端、CRT、显像管、热成像、热像仪、温度图、代尔夫特、荷兰蓝瓷砖、洞穴壁画、史前壁画、赭石、1-bit、黑白画图软件、MacPaint 风、黑绘、古希腊陶瓶、希腊瓶画、铅笔素描、素描、铅笔画、X 光、X 光片、安检图像、橡皮管动画、黑白卡通、老动画、麻胶版画、黑白版画、藏书票、VHS、家庭录像、录像带、扁平插画、扁平风、矢量插画、绘本动画、角色动画、挤压拉伸、圆珠笔、圆珠笔涂鸦、原子笔、页边涂鸦、课本涂鸦、手画棋盘、描图纸、硫酸纸、叠片、叠层、分色片、灯箱、拷贝台、透光台、套准、定位钉、粉彩界面、粉彩 UI、Dot 风、Dot 那种风格、产品发布会界面、发布会质感、窗口卡片、macOS 窗口、界面卡片、讲解片界面页、小图标探头、阅卷、阅卷批改、批改、判卷、改卷、改作业、答题卡、试卷、考卷、测验卷、红笔批改、红笔打分、打分数、盖章批改、朱红印章、标准答案卡、长尾夹、讲解片评测 / 打分页、皮影、皮影戏、影子戏、驴皮影、灯影戏、皮影人偶、雕花戏台、戏台牌匾、亮相、钢笔淡彩、淡彩、淡彩速写、钢笔淡彩小人、针管笔、勾线笔、针管笔加水彩、线稿上色、速写卡片、速写本小人、水彩小卡、城市速写、街头速写、水笔、自来水笔、复古水粉、水粉、水粉画、不透明水粉、哑光丙烯、复古绘本、绘本插画、绘本大头像、童书插画、复古童书、大头像、大鼻子人物、针织毛衣、麻花毛衣、毛线帽、毛毡帽、卷发、胡子、蓝调绘本、蓝色绘本、软蓝绘本、蓝调童书、软蓝童书插画、蓝色童书插画、蓝色系绘本、限色绘本、蓝白绘本、现代绘本跨页、手绘绘本跨页、绘本跨页、绘本内页、干笔墨线、墨铅笔线、粉彩蜡笔质感绘本、白色毛绒动物、毛绒白熊、点彩腮红、江南园林、园林春景、春水园林、中式园林插画、古典园林插画、国风园林插画、苏式园林、细笔园林、园林风景插画、水榭、临水茶榭、亭台楼阁、粉墙黛瓦、黛瓦白墙、飞檐翘角、翼角起翘、月洞门、漏窗、冰裂纹窗、槅扇、挂落、九曲桥、曲桥、垂柳园林、碧水倒影、园林倒影、睡莲池、数字水粉风景、细腻厚涂风景、干刷色块、干笔色块、干刷、干刷插画、干笔插画、滚筒刷、滚筒色块、色块插画、大色块插画、毛边色块、刷痕色块、粗刷笔触、mid-century、世纪中期插画、中世纪现代插画、复古编辑插画、复古海报插画、水粉拼贴、撕纸色块、限色海报、暮色微缩绘本、暮色绘本、黄昏绘本、微缩绘本、黄昏转夜、昼夜交界、日夜交界、半边黄昏半边星空、粉彩黄昏、粉紫晚霞、黄昏星空、银河插画、野花坡、野花草坡、花海插画、萤火虫、放风筝插画、拼布山丘、条纹田野、小圆树、细节放大图、局部放大图、技术细节小窗、科学图版风插画、手写英文小字、晚安绘本、治愈系绘本插画、排线夜景、排线风夜景、彩铅夜景、色粉夜景、粉彩排线、短笔触夜景、笔触夜空、方向笔触、夜景版画、小版画、限量版画风、版画装裱、版痕、纸边标题、铅笔题字、夜景插画、夜空插画、深蓝夜景、靛蓝夜空、冷暖对比夜景、唯一暖光、夜里的火光、发光的云、被照亮的云、红色精灵闪电、精灵闪电、火山夜景、熔岩入海、熔岩、岩浆、火山喷发插画、海上风暴、海面倒影、光柱倒影、火星飞溅、星点、看海的人、礁石上的人、远处的小人、小人比例尺、雪夜篝火、渔火），或 "draw it yourself", "paint with code", "procedural painting", "watercolor / collage / colored pencil / anime / editorial / impasto oil / ukiyo-e / pixel art / clay / claymation / cyanotype / sun print / cross-stitch / embroidery / retro instrument panel / vintage radio / sticker collage / receipt / lab notebook / graph paper / chalkboard / blackboard / cyberpunk / neon city / cartoon / hand-drawn animation / isometric / 2.5D / continuous line / one-line drawing / soft 3D / 3D render / puffy letters / ball pit / shape morph / morphing / newspaper collage / Dada / ransom note / halftone / glassmorphism / aurora gradient / Bauhaus / geometric poster / screen print / synthwave / retrowave / outrun / perler beads / hama beads / artkal / fuse beads / melty beads / pegboard beads / petroglyph / rock art / rock carving / desert varnish / Egyptian tomb painting / ancient Egypt / hieroglyphs / Theban tomb / Roman mosaic / floor mosaic / tesserae / opus vermiculatum / Pompeii mosaic / stained glass / leaded glass / church window / Gothic window / grisaille / illuminated manuscript / medieval manuscript / book of hours / gold leaf / illuminated initial / blackletter / vellum / astrolabe / da Vinci notebook / Leonardo codex / Renaissance sketchbook / mirror writing / iron-gall ink / red chalk / sanguine / ornithopter / exploded view / inventor's sketch / silhouette / silhouette portrait / cut-paper profile / shade portrait / Georgian portrait / Regency portrait / oval gilt frame / letterpress / wood type / playbill / circus poster / Victorian poster / two-colour misregistration / woodcut poster / constructivism / constructivist poster / Soviet avant-garde / Russian avant-garde / Rodchenko style / photomontage poster / art deco / streamline moderne / 1930s travel poster / railway poster / airbrush poster / sunburst rays / Gatsby style / golden age comic / vintage comic book / comic cover / Ben-Day dots / four-color printing / newsprint / speech balloon / pulp cover / pop art / Warhol-style / pop silkscreen / silkscreen portrait / repeated pop portrait grid / ASCII art / text art / typewriter art / line printer / greenbar / fanfold paper / tractor feed / overstrike / printer plot / low poly / low-poly / retro 3D / 90s 3D game / PS1 style / N64 style / software rasterizer / flat shading / affine texture mapping / vertex fog / game HUD / stencil / stencil graffiti / spray paint stencil / street art / drips and overspray / Banksy-style stencil / embroidered patch / embroidery patch / iron-on patch / sew-on patch / merit badge / camp badge / merrow border / rocker patch / denim jacket patches / blueprint / technical drawing / crayon / kid's drawing / CRT terminal / green screen / thermal camera / thermal imaging / Delft tiles / Delft blue / cave painting / ochre / Lascaux-style / 1-bit / MacPaint-style / black-figure / Greek vase / pencil drawing / graphite / X-ray / baggage scanner / rubber hose / 1930s cartoon / linocut / lino print / VHS / home video / flat vector / flat illustration / storybook animation / squash and stretch / ballpoint / biro / ballpoint doodle / margin doodles / hand-drawn board game / overlay sheets / tracing-paper overlays / light box / colour separations / registration marks / acetate overlay / pastel UI / Dot-style product film / launch-film interface / macOS window cards / exam grading / grading an answer sheet / red-pen marking / graded test paper / rubber-stamped answer sheet / shadow puppet / shadow puppetry / Chinese shadow play / leather shadow puppets / backlit puppet screen / pen and wash / pen & wash / line and wash / ink and watercolour / ink and watercolor / fineliner sketch / fineliner and watercolour / sketchbook characters / sketch cards / urban sketching / water brush / gouache / retro gouache / gouache portrait / gouache illustration / opaque gouache / matte acrylic / picture-book portrait / vintage picture book / retro children's book illustration / mid-century children's book / big-nosed character portrait / cable-knit sweater / knitted bobble hat / blue picture book / soft blue picture book / soft-blue children's book illustration / modern picture book / limited-palette picture book / picture-book spread / scratchy ink line / dry-brush ink line / ink pencil line / crayon and pastel texture / chalky white marks / blue and coral palette / fluffy white bear / Jiangnan garden / Chinese garden / classical Chinese garden illustration / Chinese water garden / spring garden illustration / lush painterly garden / waterside pavilion / moon gate / lattice windows / zigzag bridge / weeping willow garden / upturned eaves / grey-tiled roof / blossom trees and reflections / lily pond with egrets / digital gouache landscape / dry-brush blocks / dry brush illustration / dry-brushed colour blocks / roller texture / brush-textured shapes / mid-century illustration / mid-century modern poster / mid-century editorial illustration / gouache collage / torn-paper collage poster / limited palette poster / scumbled texture / vintage book cover illustration / twilight storybook / dusk picture book / dusk to night sky / day and night split sky / pastel sunset sky / Milky Way illustration / wildflower meadow / wildflower hill / patchwork hills / tiny round trees / fireflies / paper kite / magnified detail inset / detail callout circle / scientific plate overlay / handwritten lowercase captions / cozy miniature illustration / bedtime story illustration / hatched nocturne / hatched night scene / pastel hatching night / coloured-pencil nocturne / directional strokes / short brush strokes sky / night print with margins / small art print / plate mark / pencilled title and caption / indigo night with one warm light / glowing cloud lit from below / red sprites / lava entering the sea / volcano at night / glowing threads and sparks / broken reflection on the sea / tiny figures for scale without an image model" 时使用；也用于需要逐步画出（draw-on）动画的插画。单独说「剪纸」指剪纸拼贴、「刺绣」指十字绣、「丝网印刷 / screen print」指包豪斯几何；「打马赛克」是打码，不是马赛克画风；单说「蓝图」指蓝图工程图，「蓝晒 / 晒图」仍指蓝晒；「铅笔 / 素描」指铅笔素描，「彩铅」指韩国彩铅；「像素」仍指像素风，「1-bit / 黑白画图软件」指 1-bit 早期画图软件；「霓虹」仍指赛博朋克；「喷漆 / 街头涂鸦」仍指喷漆模板涂鸦，「圆珠笔 / 随手涂鸦 / 页边涂鸦」指圆珠笔涂鸦；「描图纸 / 硫酸纸 / 叠片 / 灯箱」指描图纸叠层（蓝图工程图那张描图布是晒成蓝图的，不是叠片）；「Dot 风 / 粉彩界面 / 窗口卡片 / 发布会界面」指粉彩界面（纯色底 + 白色实心窗口卡片），要磨砂玻璃和弥散渐变仍用弥散玻璃；「阅卷 / 批改 / 答题卡 / 判卷 / 红笔打分」指阅卷批改，实验记录里的红笔圈和便利贴仍用实验笔记本，带「已付」橡皮章的小票拼贴仍用贴纸拼贴 · 小票；「皮影 / 皮影戏 / 影子戏」指皮影戏（透光的彩色驴皮人偶），黑纸剪出的侧影小像仍用剪影，彩纸剪贴仍用剪纸拼贴。「钢笔淡彩 / 淡彩速写 / 针管笔加水彩 / 线稿上色的速写小卡」指钢笔淡彩；单说「水彩」仍指水彩（风景、花卉的大片晕染），蓝铅笔稿 + 毛笔线 + 赛璐璐阴影的拟人小物仍用卡通手绘，「素描 / 铅笔」仍指铅笔素描。「水粉 / 复古水粉 / 绘本大头像 / 复古童书插画」指复古水粉（不透明水粉画的特写大头像）；梵高式厚涂的风景、名画感仍用油画厚涂，扁平矢量、会挤压拉伸的小角色动画（「绘本动画」）仍用绘本角色动画，针管笔线稿加淡彩的速写小卡仍用钢笔淡彩，撞色多格的头像仍用波普丝网。「蓝调绘本 / 软蓝绘本 / 蓝色童书插画 / 绘本跨页」指蓝调绘本（软蓝限色的现代绘本跨页：干笔墨线 + 干蜡笔粉彩上色 + 白粉笔痕）；单说「绘本」仍指绘本角色动画，「水粉 / 绘本大头像」仍指复古水粉，「编辑风 / Riso」仍指编辑风手绘，针管笔线稿加淡彩的速写小卡仍用钢笔淡彩，小孩自己画的蜡笔画仍用儿童蜡笔画。「江南园林 / 园林春景 / 中式园林插画 / 粉墙黛瓦 / 飞檐 / 月洞门 / 九曲桥」指江南园林（细笔数字水粉的园林春景：叶形小笔触堆出的繁茂树冠、繁花、垂柳、黛瓦飞檐、碧水倒影、层层远山）；单说「水墨 / 山水」仍指水墨，单说「水彩」仍指水彩，动漫背景 / 赛璐璐天空仍指日本动漫，浮世绘仍是浮世绘；梵高式厚涂的风景仍用油画厚涂，皮影人偶的一场戏仍用皮影戏。「干刷色块 / 干笔色块 / 滚筒色块 / mid-century 海报插画」指干刷色块（米白纸上几大块干笔或滚筒刷出的限色色块，人物拆成几个大块面，背后一块纯色板、一旁一个小红方块）；单说「水粉 / 绘本大头像」仍指复古水粉，「剪纸 / 彩纸拼贴」仍指剪纸拼贴，「丝网印刷 / screen print」仍指包豪斯几何，「Riso / 编辑风」仍指编辑风手绘，没有笔触的平滑几何色块仍用扁平矢量。「暮色微缩绘本 / 暮色绘本 / 黄昏转夜 / 昼夜交界 / 野花坡 / 细节放大图」指暮色微缩绘本（粉彩黄昏转入银河夜空、拼布山丘、几万朵小野花、很小的原创角色，加圆形放大图和手写小字）；单说「绘本」仍指绘本角色动画，「蓝调绘本 / 软蓝绘本」仍指蓝调绘本，赛璐璐天空和夏日少年感仍用日本动漫，大片晕染的风景仍用水彩，整页的机械分解手稿仍用达·芬奇手稿，剖面和施工图仍用蓝图工程图。「排线夜景 / 彩铅或色粉夜景 / 短笔触夜空 / 夜景小版画 / 熔岩入海 / 精灵闪电 / 被照亮的云」指排线夜景（满画面顺着风向的短笔触、深蓝夜色里只有一个暖光、发光的丝和火星、碎的倒影、很小的人，装成带纸边和铅笔字的小版画）；梵高式的厚涂漩涡和颜料浮雕仍用油画厚涂，明亮可爱的彩铅甜品仍用韩国彩铅，黑白石墨排线仍用铅笔素描，粉彩黄昏转入银河星空、满坡小野花仍用暮色微缩绘本，霓虹雨夜街道仍用赛博朋克。
---

# Claude 绘图

用 Python（只依赖 numpy + Pillow，系统自带的 `python3` 就能跑）按笔、墨、颜料、纸的物理规律「画」图，不调用任何生图模型。
- **构图可控**：每一笔都是算出来的，构图、留白、点睛色的位置都精确可控。
- **结果可复现**：固定随机种子，每次画出同一幅画。
- **适合做动画**：可以输出分阶段快照，做成「一幅画被逐步画出来」的动画；生图模型只能给一整张画。

## 画风与范例（质量基准）

| 画风 | 库 | 范例 | 耗时 |
|---|---|---|---|
| 水墨 | `lib/inkpaint.py` · `Painting` | `examples/bawansiqian.py` 八万四千法门；`examples/moon_river.py` 月印万川（烘云托月、孤舟、芦苇） | 约 4 秒 |
| 水彩 | `lib/watercolor.py` · `Watercolor` | `examples/watercolor_autumn.py` 秋日湖畔（秋树罩染、湖面倒影、红色小舟）；`examples/watercolor_washes.py` 水彩底纹（大片定向晕染、干边、回流水渍、颗粒、飞溅，中间留白，给讲解片当背景、上面叠界面卡片） | 约 15 秒 / 4 秒 |
| 剪纸拼贴 | `lib/papercut.py` · `Collage` | `examples/papercut_balloons.py` 热气球小镇（条纹热气球、笑脸太阳、纸云、小房子） | 约 30 秒 |
| 韩国彩铅 | `lib/colorpencil.py` · `ColorPencil` | `examples/colorpencil_dessert.py` 午后甜点（草莓蛋糕、红茶、草莓） | 约 17 秒 |
| 日本动漫 | `lib/anime.py` · `Anime` | `examples/anime_summer.py` 夏空（积雨云、乡间公路、电线杆、草帽女孩背影） | 约 30 秒 |
| 编辑风手绘 | `lib/editorial.py` · `Editorial` | `examples/editorial_ideas.py` 灵感生长（浇水长出灯泡的概念插画） | 约 11 秒 |
| 油画厚涂 | `lib/oilpaint.py` · `OilPainting` | `examples/oil_wheatfield.py` 麦田星空（旋转的星空、麦田、柏树、乌鸦） | 约 2 秒 |
| 浮世绘木版画 | `lib/ukiyoe.py` · `Ukiyoe` | `examples/ukiyoe_fuji.py` 富士曙（晕色天空、富士、云带、青海波、帆船、崖松） | 约 7 秒 |
| 像素风 | `lib/pixelart.py` · `PixelArt` | `examples/pixel_rainy_cafe.py` 雨夜咖啡店（霓虹、路灯、雨、倒影、猫） | 约 0.1 秒 |
| 黏土定格 | `lib/clay.py` · `Clay` | `examples/clay_lighthouse.py` 灯塔岛（手指抹开的天空、条纹灯塔、喷水的鲸鱼、搓条浪花、小帆船） | 约 6 秒 |
| 蓝晒 | `lib/cyanotype.py` · `Cyanotype` | `examples/cyanotype_botanicals.py` 蓝晒植物（蕨叶、银杏、蒲公英、飘散的种子、白色手写标注） | 约 6 秒 |
| 十字绣 | `lib/stitch.py` · `Stitch` | `examples/stitch_sampler.py` 家（H♥ME 字母、缎面绣爱心、小屋、苹果树、松树、花边、缝上的布标） | 约 20 秒 |
| 复古仪器面板 | `lib/panel.py` · `Panel` | `examples/panel_radio.py` Aurora 64 收音机（柚木机壳、喇叭布、背光刻度窗、琴键、魔眼管、拨杆、旋钮） | 约 7 秒 |
| 贴纸拼贴 · 小票 | `lib/sticker.py` · `Sticker` | `examples/sticker_market.py` 周末市集（热敏小票、模切贴纸：酸种面包/传家番茄/郁金香花束/咖啡豆、贴纸大字、波浪边促销贴、麻绳吊牌、和纸胶带、「已付」橡皮章） | 约 3 秒 |
| 实验笔记本 · 贴纸 | `lib/notebook.py` · `Notebook` | `examples/notebook_brewing.py` 咖啡萃取实验（线圈方格笔记本、铅笔表格与折线图、排线标出最佳区间、荧光笔、没闭合的红笔圈、便利贴结论、模切贴纸、标签机日期、桌上的六棱铅笔） | 约 3 秒 |
| 黑板板书 | `lib/chalk.py` · `Chalkboard` | `examples/chalk_lesson.py` 为什么天空是蓝的（墨绿石板、半擦掉的上节课残影与板擦痕、越往下越厚的粉笔灰；白黄粉蓝粉笔写的标题、太阳→大气层→眼睛示意图、长短波浪线、手写 ∝ 与圈出的 1/λ⁴、光谱条与散射曲线、带缺口的「小结」框；木框和粉笔槽里的粉笔、板擦） | 约 5 秒 |
| 赛博朋克 | `lib/cyberpunk.py` · `Cyberpunk` | `examples/cyberpunk_neon_street.py` 霓虹不夜城 · Neon District（雨夜街道峡谷、真玻璃管霓虹竖招牌（坏管与闪烁管）、背光灯箱、过街天桥「不夜城」、全息海月水母广告、电线、飞车光轨、井盖蒸汽、透明伞背影、湿路面与水洼倒影、胶片颗粒与一道撕裂扫描线） | 约 10 秒 |
| 卡通手绘（逐帧手绘） | `lib/cartoon.py` · `Cartoon` | `examples/cartoon_toaster.py` 早安吐司（薄荷绿吐司机笑着弹出两片举手的吐司、「叮！」爆炸框、盘子上打瞌睡的化黄油、窗外日出、墙上 7 点的钟；左侧 ①按下拉杆 ②电热丝烧红 3 分钟 ③弹起来 的图解；蓝铅笔稿留底、毛笔线、错位平涂、赛璐璐阴影、蜡笔天空与烤边、网点橱柜、抖线） | 约 4 秒 |
| 等轴 2.5D | `lib/isometric.py` · `Isometric` | `examples/isometric_weather_island.py` 岛上的气象站（漂浮的分层底座、一格一格的倒角地砖与台地、带双道浪花的海；观测场里的百叶箱、雨量筒、带风杯和风向标的风杆；看守小屋与卫星天线、太阳能板、石板路、栈桥小船、风袋、浮标、开花灌木；探空气球和平底云；四张悬浮数据卡用细引线指向各自仪器，地面上一个指北针） | 约 5 秒 |
| 单线画 | `lib/lineart.py` · `LineArt` | `examples/lineart_paper_plane.py` 从这扇窗到那扇窗（一根不断开的金线：圆树、小屋、从窗口穿墙飞出的纸飞机航迹与顶部翻圈、飞镖形纸飞机穿墙飞进对面小屋的窗；窗子亮起是全画唯一的点睛色；字距拉开的衬线标题） | 约 6 秒 |
| 柔光 3D | `lib/soft3d.py` · `Soft3D` | `examples/soft3d_rise.py` 浮出（糖果色小球海里顶出鼓鼓的软字 rise：被挤开的球堆在字脚、几颗骑在字肩上、几颗滚落，i 的点是一颗黄球；天光穹顶、柔光箱主光、粉色轮廓光、环境光遮蔽、软阴影、次表面色调、景深） | 约 46 秒 |
| 形变动画 | `lib/morph.py` · `Morph` | `examples/morph_water_cycle.py` 一滴水的旅程（一条 256 点轮廓线依次变成水滴→云→雪花→雪山→河→海浪，六块纯色背景随之切换；洋葱皮残影、挤压拉伸、虚线运动轨迹、中间帧标出对应点、缓动曲线时间轴） | 约 1 秒 |
| 报刊拼贴 | `lib/newscollage.py` · `NewsCollage` | `examples/newscollage_curiosity.py` 好奇心周刊 · 拆开看看（牛皮纸底、手撕旧报纸（程序生成的假文字栏）、被剪刀剪开并掀起上半的网点印刷闹钟照片、飞出的齿轮 / 发条 / 红色网点摆轮 / 螺丝各自剪下并配打字标签和引线、大红纸圆、勒索信拼贴字「拆开看看？」和 WHAT MAKES IT TICK、刊头、黑色邮戳、红色「附零件图」印章、美纹纸胶带） | 约 3 秒 |
| 弥散玻璃 | `lib/aurora.py` · `Aurora` | `examples/aurora_morning.py` 晨间计划（日出色弥散渐变与极光光带、光泽小球；磨砂玻璃卡片层叠：晨间计划时间线（3/5 完成，进行中那一行是玻璃叠玻璃）、专注倒计时圆环、光泽太阳躲在玻璃云后的天气卡、勿扰开关与白噪音滑块、近 7 天专注柱状图、9:00 站会提醒胶囊） | 约 2 秒 |
| 包豪斯几何 | `lib/bauhaus.py` · `Bauhaus` | `examples/bauhaus_form_colour.py` 形与色 · Form & Colour（奶油色纸上的丝网印刷讲座海报：黄三角、红方、蓝圆站在粗黑地线上，60° 弧、直角框、挖空的圆心和半径，下面大字角数 3 / 4 / 0；「形与色」大标题、挖空字的黑条论点「角越尖，色越亮」；构成网格、套准十字、裁切线、色标条、铅笔版号） | 约 2 秒 |
| 复古 Synthwave | `lib/synthwave.py` · `Synthwave` | `examples/synthwave_coastline.py` 海岸线 1987（横条切口的渐变落日沉入海面、倒影碎成一条条光带、线框小岛与线框山脉、霓虹网格地面、霓虹边线的海岸公路、灭点处亮灯的小城、带落日轮廓光的棕榈剪影、驶向城市的尾灯、镀铬大字 COASTLINE 与霓虹手写 Last Sunset、录像机 PLAY 与日期屏显、色度渗色、跟踪噪带和扫描线） | 约 4 秒 |
| 拼豆 | `lib/perler.py` · `Perler` | `examples/perler_strawberry_coaster.py` 草莓杯垫（方格图纸上的草莓图样与图例，铅笔勾掉已摆的颜色；透明方钉板上摆到一半：草莓摆完、天蓝底色一行行往下铺，镊子夹着下一颗悬在空钉上，旁边散豆；九格分色收纳盒；熨平的圆杯垫：豆子熔成一片蜡质平面、孔缩小、外沿扇贝形，压着揭下的熨烫纸） | 约 9 秒 |
| 岩画（凿刻砂岩） | `lib/petroglyph.py` · `Petroglyph` | `examples/petroglyph_migration.py` 迁徙季（带沙漠漆的砂岩岩面：一群大角羊朝同一方向往上走，一串偶蹄印通向同心圆水源，弓手和举投矛器的猎人等在后面；新月和一个月的计日刻痕、螺旋太阳、岩檐下一大一小两只手印；新、中、旧三档凿痕，几乎被漆盖回的旧符号；渗漆的裂缝、鲜橙色剥落疤、壳状地衣；左上低角度侧光） | 约 10 秒 |
| 古埃及墓室壁画 | `lib/tomb.py` · `TombPainting` | `examples/tomb_harvest.py` 尼罗河丰收（底比斯墓室的一面墙，三栏讲一件事：犁地播种（并轭的牛、扶犁人、撒种人、挥锄人），割二粒小麦（弯腰的割麦人、拾穗的女人、挂水囊的无花果树），书吏点数粮袋（蹲坐的书吏、堆成 5-4-3 的 12 袋粮和上方的象形数字 12、用量斗倒粮的人）；按身份放大的庄园总管、伪象形文字栏、凯凯尔饰带、墙脚的尼罗河；剥落处露出红格和红稿，灰泥脱落、裂缝、潮痕、烟熏） | 约 4 秒 |
| 罗马马赛克 | `lib/mosaic.py` · `Mosaic` | `examples/mosaic_harbor.py` 港口渔获 · The Day's Catch（赭红起稿的灰浆床上铺约一万六千块石子与玻璃：黑白奔浪纹边框、火焰灯塔、船首画眼的渔船和鼓起的方帆、挑在杆上的渔网、把鱼从网里拖走的章鱼、游鱼和海鸥；燕尾铭牌 CAPTVRA · DIEI / ET POLYPVS FVR「今日渔获——以及章鱼小偷」；人物沿轮廓一排排铺，背景平铺并留光环；脱落处露出石子方坑，沉降裂缝，灰缝积灰） | 约 12 秒 |
| 彩色玻璃花窗 | `lib/stainedglass.py` · `StainedGlass` | `examples/stainedglass_seasons.py` 四季之窗 · Window of the Seasons（石墙上四扇哥特尖拱窗，同一棵树的春夏秋冬：春花与燕子、夏天的苹果和一窝雏鸟、秋天金红树冠和离开的雁阵、冬天积雪的枝和知更鸟，太阳高度随季节变；VER / AESTAS / AVTVMNVS / HIEMS 银染题字带；铅条与焊点、横铁条、一处补过的裂片，窗侧斜面和窗台上的彩色光） | 约 4 秒 |
| 泥金手抄本 | `lib/illuminated.py` · `Illuminated` | `examples/illuminated_starchart.py` 星辰之书 · Liber Stellarum（暗色书桌上摊开的天文书。左页「行星的次序」：打磨贴金方框里的玫瑰色 Q 首字母，字腔里是夜空和观星塔；鹅毛笔哥特体伪拉丁正文、朱红标题、长出常春藤花枝的条形边框、一幅诸天圆图。右页「怎样量一颗星的高度」：蓝色首字母 O 配红色花笔卷须，按纬度 48° 投影的尺规星盘，规尺瞄向页边的贴金星。羊皮纸毛孔、针孔与打格线、背面透字、破洞、狐斑、金箔剥落露出红色底料） | 约 9 秒 |
| 达·芬奇手稿 | `lib/codex.py` · `Codex` | `examples/codex_ornithopter.py` 扑翼机（裱在卡纸上、缺一角的泛黄帘纹纸；一串飞鸟画出一次振翅，红粉笔鸢翼写生和一根大羽毛；中间是蝙蝠翼扑翼机仰视图：右翼用左手「\」排线画完，左翼只起了头、露着铅笔稿；尖笔圆规画的比例圆，曲柄、灯笼齿轮、冠齿轮、滑轮的传动分解图，腕关节特写，划掉的废稿；右到左的镜像伪文笔记、墨点、霉斑、水渍） | 约 8 秒 |
| 剪影 | `lib/silhouette.py` · `Silhouette` | `examples/silhouette_family.py` 剪影小像（木版印花条纹墙纸上，挂镜线铜钩的绞丝绳吊着三幅椭圆金框剪影：中间是戴鸵鸟羽毛宽檐帽、螺旋垂卷的女主人，右边一艘满帆回家的双桅横帆船，左边坐在流苏垫子上望着她的猫；单独剪下的羽枝、睫毛、胡须和缆绳，剪空的猫眼和蕾丝孔；薄金粉、铁胆墨圆体题签、玻璃背面的金线圈、凸面玻璃反光、棱顶磨出红色底漆的旧金框） | 约 3 秒 |
| 凸版印刷海报 | `lib/letterpress.py` · `Letterpress` | `examples/letterpress_circus.py` 马戏团来了（1890 年代红黑两色马戏团海报：左栏每行木活字排满版心——THE GRAND TRAVELLING、带投影的红色大字 CIRCUS、宋体黑木活字「马戏团来了」、星号节目单；右边木刻：走钢丝的舞者端着平衡杆，下面戴非斯帽的大象踩在条纹鼓上扬鼻致意，40 FT. 尺寸线；红版色块与黑版轮廓错开几像素；三折折痕裂墨、贴上的日期条 SATURDAY · MAY 17、钉孔锈斑、泛黄与霉斑） | 约 6 秒 |
| 苏联构成主义 | `lib/constructivism.py` · `Constructivism` | `examples/constructivism_radio.py` 无线电 · РАДИО（虚构的 1920 年代无线电爱好者杂志封面，红黑两版：仰拍的双曲面网格广播塔印成网点、叠在红色圆盘上，塔尖射出红色楔形和越传越细的黑色波前，送进剪刀剪下的网点照片——带号角喇叭的电子管收音机；黑色斜条里反白 СЛУШАЙТЕ ВЕСЬ МИР（收听全世界），粗体压缩西里尔大字 РАДИО，三个编号标注；对折两次的折痕裂墨、霉斑、水渍潮线、图钉锈孔） | 约 6 秒 |
| 装饰艺术（Art Deco） | `lib/artdeco.py` · `ArtDeco` | `examples/artdeco_express.py` 夜行快车 · Night Express（1930 年代喷枪流线型铁路海报：午夜蓝长渐变天空、满月外一圈交替射线、探照灯；雾中远城和阶梯退台高楼，钟楼的钟停在 11:40；河面把城市和月亮反射成横向波纹；栗红流线型列车从城里驶上拱桥迎面而来，金色速度线收拢在车鼻上，头灯照亮铁轨；Deco 金字 NIGHT EXPRESS、阶梯角双金线边框；全画没有一根描边，形体全靠明暗） | 约 12 秒 |
| 黄金时代漫画 | `lib/comic.py` · `ComicCover` | `examples/comic_rocket.py` 火箭小队 No. 3（1940 年前后的报摊漫画封面：朝灭点挤出的立体刊名 ROCKET SQUAD、价格框和黄色旁白框；暮色天空分档网点、大月亮；红色火箭起飞，June 舰长指着月亮喊「NEXT STOP -- THE MOON!」，后座小狗 Pip 戴着护目镜；没赶上的机修工 Sparky 吊在绳梯上喊「HEY!! WAIT FOR ME!!」；拟声字 WHOOOSH!；毛笔墨线与羽状排线、Ben-Day 网点、三色版错位、泛黄新闻纸、书脊裂纹和生锈订书钉） | 约 5 秒 |
| 波普丝网 | `lib/popart.py` · `PopSilkscreen` | `examples/popart_cat_moods.py` 猫的六种心情（白底漆帆布用胶带隔出 3×2 六格，同一只虎斑猫按顺序讲一件小事：歪头好奇 → 馋得吐舌头 → 吃到了眯眼笑 → 被抓包瞪圆眼 → 压耳哈气 → 歪头睡着；每格先手涂一套撞色、描得很松，再刮印同一块照相黑版，中间调成 45° 粗网点；六格放版的位置、角度和墨量各不相同：糊版、缺墨、横刮、印了两次留灰影、干版露底） | 约 3 秒 |
| ASCII 字符画（行式打印机） | `lib/lineprinter.py` · `LinePrinter` | `examples/lineprinter_launch.py` 发射记录（桌上一整张 1970 年代 132 列绿条连续纸，两侧导孔、微孔撕线；左边整幅火箭发射的字符画：尖拱头锥、. : + % # 侧光箭身、叠打 #@ 的滚转标记、从喷口往下变宽的尾焰亮柱扎进翻滚的烟云，旁边是桁架勤务塔、塔吊、远处水塔、清晨太阳和人字形鸟群；右栏是事件日志、高度-时间打印机绘图和通道状态表；鼓式打印机的上下跳字、弱锤淡列、色带渐淡；读的人用红圆珠笔打勾、圈点、写了 on plan） | 约 2.3 秒 |
| 低多边形（1999 年代 3D） | `lib/lowpoly.py` · `LowPoly` | `examples/lowpoly_canyon.py` 峡谷飞行 · Canyon Run（一帧虚构的 1999 年飞行游戏：小特技飞机在沙漠峡谷的右弯处压坡度，对准九个金环里的第五个，第六个挂在天然石拱下；阶梯状分层岩壁、起伏小面的河、十字插片杜松、雾里化开的方山；半透明螺旋桨盘、金环闪光、镜头光晕；384×216 帧缓冲、15 位色 4×4 有序抖动、无平滑放大 5 倍；HUD：金环计数 04/09、单圈时间、阶梯速度条、赛道小地图） | 约 0.2 秒 |
| 喷漆模板涂鸦 | `lib/stencil.py` · `Stencil` | `examples/stencil_kite.py` 放风筝 · Hold On（木纹模板清水混凝土墙：木纹、浆棱、对拉螺栓孔、锈水雨痕、返潮泛碱、发丝裂缝；三张卡纸模板白 → 灰 → 黑喷出的小孩：毛线帽、羽绒服、往前飘的条纹围巾，身子后仰攥着线轮；徒手喷的风筝线连到左上角的红色菱形风筝；同一张小模板转着角度喷的燕子和树叶；带桥的 HOLD ON 模板字；清晰核心、外溢雾化、飞沫、滴痕；滚筒灰漆盖掉的旧签名、被水枪冲淡的粉色签名） | 约 6 秒 |
| 刺绣徽章 | `lib/patch.py` · `Patch` | `examples/patch_camping.py` 三晚露营（牛仔夹克后背，过肩缝压着双道明线，一晚一枚徽章：第一晚是热切缎面边的拱形异形章——日落分层天空、远山、湖面倒影、亮灯的帐篷；第二晚是金色锁边圆章——雪峰、松林、营火与火星、弯月，缎面字 HIGH CAMP / NIGHT 2，上方弧形条章 THREE NIGHTS OUT；第三晚是正在手缝的指南针章，针和线还留在牛仔布上；一条刺子绣虚线把三枚徽章串成路线） | 约 6 秒 |
| 蓝图工程图 | `lib/blueprint.py` · `Blueprint` | `examples/blueprint_lighthouse.py` 灯塔剖面 · Halvard Rock Light（1911 年一套灯塔施工图，描图布上墨后晒成蓝图：南立面的花岗岩砌层和背光一侧的明暗线；A–A 剖面里越往上越薄的石墙、绕空心中柱盘上去的悬挑石阶、值守室的钟表机构；+6.50 平面和指北针；详图 1 讲灯焰、棱镜和透镜怎样送出一束平行光；总说明、比例尺、修改栏、中英文标题栏；折成六折、朝外那格褪色、碱性水渍、图钉孔，工地工程师用红蜡笔圈出楼梯批注） | 约 5 秒 |
| 儿童蜡笔画 | `lib/crayon.py` · `Crayon` | `examples/crayon_picnic.py` 我的周末（六岁小孩在糙纸上用蜡笔画的一家人野餐：戴墨镜的笑脸太阳、四种颜色写的歪扭标题「我的周末!」、风筝和彩虹，天空绕着东西涂、越往下越稀；冒卷烟的小房子和苹果树；爸爸、妈妈和我手拉手站在红格子野餐布后面，小狗扑向皮球；郁金香、蝴蝶和签名「朵朵 6岁」；纸上还躺着一根用秃的红蜡笔、一截断了的蓝蜡笔和蜡屑） | 约 8 秒 |
| 绿屏终端 CRT（荧光字符画） | `lib/crt.py` · `CRTTerminal` | `examples/crt_weather.py` 今天带伞吗 · Bring an Umbrella?（80 年代米色机壳的视频终端上敲了一条 forecast 命令，回来一屏绿色 P1 荧光字符画：一整天从左到右画成一条——清晨的太阳、积云、14:00–17:30 在小镇上下雨的雷暴云（闪电、带余辉的雨丝）、雨后碎云、夜里的月牙和灯塔光；下面同一条时间轴上的扫描线气温曲线、八分块雨量柱和反白的「umbrella? YES」；双倍高标题、方框线、烧着旧字的状态栏；扫描线、光晕、桶形畸变，机壳斜面映着绿光） | 约 7 秒 |
| 热成像 | `lib/thermal.py` · `Thermal` | `examples/thermal_kitchen.py` 厨房里的温度 · Kitchen Heat Map（晚饭时分厨房的热像仪画面：汤锅的蒸汽卷进抽油烟机，抛光锅盖因发射率低读数低一档；水壶喷出一道蒸汽；烤箱门封漏热，把手上的湿抹布比室温还凉；刚出炉的面包冒热气；冰箱门没关，冷气顺着抽屉淌到地砖上铺成冷舌；猫踩过冷坑又回到暖砖上，留下一串越早越淡的暖脚印；点测温、区域框、沿脚印的线剖面，读数全从画面上读出来；480×270 传感器、噪声与竖条纹、铁红色板） | 约 2 秒 |
| 代尔夫特蓝瓷砖 | `lib/delft.py` · `DelftTile` | `examples/delft_canal.py` 运河小镇 · 一阵风 De Windvlaag（一面锡釉砖墙：中间 11 × 7 块砖连成一幅砖画，四周是四角带角饰、圆框里画小图的单块砖。一阵西风吹过运河小镇：风车在转，平底帆船顺风驶来，烟、床单和衬衫都往右扬，郁金香一齐弯腰，一个人的帽子被吹到河面上，小狗腾空扑过去；藤蔓边框和卷轴题字 DE WINDVLAAG；每块砖单独画、单独烧，线条在砖缝处错开；开片、铁斑、崩瓷，云上一块窗户倒影在砖缝处断开错位） | 约 6 秒 |
| 洞穴壁画（赭石颜料） | `lib/cave.py` · `CavePainting` | `examples/cave_hunt.py` 篝火旁的岩洞（只靠篝火和石油灯照亮的石灰岩洞壁讲一次狩猎：野牛画在岩壁天然的鼓包上，背插两支矛，转身对着两个红色猎人；马、雄鹿和母鹿往反方向跑，上方一匹只起了炭稿的马；火堆上方四只吹喷手印，墙脚一排掌印红点；地上放着三堆研磨赭石和炭条的石板、一根吹颜料的骨管；钟乳石帘、钙华薄膜、零星掉色、熊爪抓痕、熏黑的顶壁） | 约 7 秒 |
| 1-bit 早期画图软件 | `lib/macpaint.py` · `MacPaint` | `examples/macpaint_garden.py` 窗台花园 · Windowsill Garden（一台 1984 年式黑白画图软件的整屏：菜单栏、工具栏、图案板、条纹标题栏窗口；画布上一扇窗，格子布窗帘画好左边再翻转复制出右边，窗外是图案分带的天空和山坡小屋；窗台上种子袋和三盆向日葵讲 40 天：发芽、长叶、开花，喷壶还对着第 2 天那盆滴水；黑猫盯着一只被选框行军蚁框住的白蝴蝶；Shadow 样式标题 watch it grow!；全画只有黑白两值，色调全靠 8×8 图案） | 约 0.4 秒 |
| 古希腊黑绘陶瓶 | `lib/blackfigure.py` · `BlackFigure` | `examples/blackfigure_games.py` 赛跑与赛车 · Games on a Vase（博物馆展台上一只阿提卡黑绘颈柄双耳瓶，旁边展板把两圈饰带展开成平面：上圈四马战车赛，正面是领先的两辆，转到瓶背才看得见折返柱、落后的第三辆、奖品三足鼎和裁判；下圈短跑，背面是终点柱和摆着奖品的桌子；棕榈叶莲花链、舌纹、回纹、放射纹、古希腊字母题字；赤陶橙底、黑釉剪影、刻线、加红加白，黑釉上一条柔光箱反光；加白剥落、钙质结壳、缺口和修补） | 约 7 秒 |
| 铅笔素描 | `lib/graphite.py` · `Graphite` | `examples/graphite_bicycle.py` 老街角的自行车 · The Bread Run（素描纸上的石墨写生：女式城市自行车靠在老街转角的灰泥墙上，前筐里一根法棍和一束纸包的郁金香；阴影里的侧墙挂着只画了面包的铁艺招牌，左边一扇深门洞，麻雀在啄面包屑；起形辅助线、轮廓、侧锋铺调、分层排线、纸擦笔、橡皮提亮一步步做完；只有中间画完，越往纸边越只剩线稿；页边铅笔笔记、2H–8B 试笔色阶和一枚石墨指纹） | 约 11 秒 |
| X 光片 | `lib/xray.py` · `XRay` | `examples/xray_luggage.py` 行李安检 · Security Check（双能 X 光安检机俯视图：传送带上的硬壳拉杆箱，箱壳轮廓发亮、铝拉杆是两层套管；箱里一把折叠伞、一个旅行吹风机（电机、双重螺旋电热丝）、一台仰面躺着的相机、钥匙和硬币、叠好的衣服、一瓶水，还有一副脊柱里穿着钢销的石膏恐龙骨架玩具；侧栏是同一只包的材料伪彩视图和 1 号物体放大，操作员结论：1 是玩具放行，2 超过 100 ml 要取出；Zeff 和毫升数都是从画面上量出来的） | 约 2 秒 |
| 1930 年代黑白橡皮管动画 | `lib/rubberhose.py` · `RubberHose` | `examples/rubberhose_morning.py` 早晨的闹钟（7 点整的小卧室：双铃闹钟蹦上床头柜摇铃，一只鞋踮着脚，挥着白手套指着床，「RRRING!」在头顶蹦跳；戴条纹睡帽的枕头还在打呼，举起手套「再睡五分钟」；窗外的太阳在两座山之间打哈欠伸懒腰，阳光落在地毯上，一双拖鞋已经跳起舞；灰色水粉背景、描线上色的赛璐璐、饼切眼、橡皮管四肢，拍成老胶片：柔焦、颗粒、片门晃动、圆角片门、划痕、灰尘和片门里的一根头发） | 约 3 秒 |
| 黑白麻胶版画（linocut） | `lib/linocut.py` · `Linocut` | `examples/linocut_snowy_village.py` 雪夜归途 · Homeward, First Snow（两块版的麻胶版画：V 口刀刻出的风雪流线、刻出来的满月和断续光环、两缕炊烟；雪坡的黑色等高线、山脚积雪的云杉林、五座积雪木屋；一个人提着灯笼、拖着一雪橇劈柴走回家，脚印和雪橇辙从画外进来，那家的门敞着、暖光洒在雪上，小狗跑出来迎他；灯黄套色版只印亮窗、门前的光和灯笼，略微错版；实地发花、残刀印、压印，页边铅笔版次 7/30、题名、签名和一枚钢印） | 约 9 秒 |
| VHS 家庭录像 | `lib/vhs.py` · `VHSCamcorder` | `examples/vhs_birthday.py` 吹蜡烛 · Blow Out the Candles（一家人生日录像里的一帧：70 年代客厅的圆环墙纸、胡桃木护墙板、兔耳天线电视、牛油果绿丝绒沙发、长毛地毯；彩带、HAPPY BIRTHDAY 三角小旗、戴派对帽的泰迪熊；茶几上的蛋糕四根蜡烛刚吹灭冒着烟、两根还亮着，过生日的孩子戴着尖帽从背后凑近、离镜头太近而虚焦；白平衡停在「室外」拍钨丝灯、烛焰过曝和 CCD 竖向拖影、点阵 OSD；录像带的色度渗色、跟踪噪带、磁头切换噪声、掉磁白点） | 约 6 秒 |
| 扁平矢量 | `lib/flatvector.py` · `FlatVector` | `examples/flatvector_night_camp.py` 山间夜营（七色限定色板，无描边的大块几何形一层层叠起来，层与层之间一道柔和投影，加极细颗粒；夜蓝天空里一轮带橙色光芒的月亮，紫色雪山分出亮面和折线暗面，品红、橙色两种山丘带，黄沙地；下午插在山顶的小旗下，一条虚线小路走之字形下山、穿过山丘，尽头是戴头灯走最后一段路的小小背包客；营地已经亮了：橙色 A 字帐篷门口透出光，篝火的光在沙地上铺成一圈圈平涂光环；几何松树、圆冠树、两朵平底云、一颗流星） | 约 1 秒 |
| 绘本角色动画 | `lib/storybook.py` · `Storybook` | `examples/storybook_acorn.py` 小橡果的秋天（真动画 + 旅程总图：米色纸上，枝头打盹的小橡果被晃醒、拉长掉下、落地压扁再弹起，追着一片红橡叶滚下山坡，山坡、小花、远山随它经过一笔笔画出来；跳上漂在小河上的橡叶，撞岸后空翻上岸，钻进土里发芽长成一棵还戴着橡果帽的小橡树；最后「hello, little oak」按笔顺写出来，彩纸屑飞起。总图把六个关键姿态多次曝光在铅笔运动弧上；加 `--gif out.gif` 出 15 fps 的真动画） | 约 1 秒（总图）/ 约 3 秒（151 帧动图） |
| 圆珠笔涂鸦 | `lib/ballpoint.py` · `Ballpoint` | `examples/ballpoint_board_game.py` 蛇梯棋大冒险 · Snakes & Ladders, Round 7（午休时在复印纸上用蓝、红、黑三支圆珠笔画的 8×8 蛇梯棋，彩铅一行行涂成彩虹色格子；一局正在进行：骰子刚从页边弹过来、掷出 4，蜗牛从 10 跳四格到 14（红笔虚线弧标出 1-2-3-4），正顺着长梯子爬到 38（红圈、虚线箭头、+24!），小云从 47 被绿蛇滑下去，晕乎乎地喊 nooo~，骰子怪在 51 捂着脸；页边是彩旗、太阳、井字棋、纸飞机、星星串、山坡小房子、花盆，吐槽小纸条「who drew this snake so LONG?!」、记分卡、把 three 划掉改成 four、红笔结论 slow snail, fast ladder!；右下角还有上一页购物单压过来的无墨压痕） | 约 4 秒 |
| 描图纸叠层 | `lib/overlay.py` · `Overlay` | `examples/overlay_city_map.py` 海港步行图 · Larkhaven on Foot（暖白灯箱上，定位钉挂着一张黑线灰调的海边小城底图：递归切出的街区、沿街一圈房屋和分户墙、深色地标、海岸与防波堤、铁路、城堡山和岬角的等高线；三张单色叠片对着套准十字落下——蓝片（沿岸一圈圈水线、河、港湾、渡轮航线、2 路电车）、黄片（公园、集市广场、海滩）、品红片（六站步行路线，坐渡轮去灯塔）；不同叠片的油墨正片叠底：植物园的池塘叠成绿、路线压过公园成红、压过海面成紫；描图纸背光下的纤维云纹、卷角、打孔、绘图胶带，旁边一张透明胶片上的图例卡） | 约 7 秒 |
| 粉彩界面 · Pastel UI | `lib/pastelui.py` · `PastelUI` | `examples/pastelui_packing.py` 出发前，再查一遍行李 · Pack Check（产品发布片里的一帧：蓝色粉彩底、一大片柔光和几颗白色光斑；左上胶囊「旅行清单」和步骤条 证件 → 充电 → 雨具 → 出发，粗黑大标题「出发前，再查一遍行李」压一条浅蓝色条；macOS 窗口「打包清单 · 京都 4 天」：左栏目的地、三天天气预报（周一下雨）、已装好 11 / 12 进度条，右栏打包助手的话逐行写出——行首的引用标签「证件夹 ✓」、绿色色条压在已装好的东西下、粉色高亮「周一京都有小雨」配「伞还没装」小标签；右边「出门检查」面板三行：证件 ✓、充电 ✓、雨具 ✗，结论「还差一把伞」；放大镜停在周一的雨云上，镜里是真像素放大；紫色云朵 >_ 从窗口后面探头、奶油色圆里的橙色星芒从面板后面探头、橙色像素小怪站在面板上） | 约 0.5 秒（加 `--stages` 约 5 秒） |
| 阅卷批改 · Exam Grading | `lib/grading.py` · `Grading` | `examples/grading_math_quiz.py` 数学单元测验 · Unit Test, Graded（深绿毛毡桌上一张米色答题卡，下面还压着两张：左边一排定位黑块、角标、粗黑标题、姓名班级栏、考号格和涂好的涂卡圆泡、得分 / 阅卷人表格、填涂示例；一题三道计算，二题应用题（灰底题目框 + 浅方格横线作答区 + 斜纹阅卷栏）；左边长尾夹夹着深蓝页眉的标准答案卡，下面一张评分小纸条。考生用蓝黑墨水逐行作答；两个朱红橡皮章盖进阅卷栏（书写工整 ✓、列式正确 ✓）；红笔给三道计算打勾，在 128 ÷ 16 = 6（天）下画波浪线、圈出「6（天）」、引线拉到阅卷栏写「应为 8 天」再打叉，答句里的 6 划一道，标准答案卡上 ① 打勾、② 打叉，最后在得分格写 75 并圈起来，笔放在得分格旁；印章一头发干、边缘飞白、轻微歪斜，红墨有浓淡和晕染，纸纹和灯光不均；`--stages` 出 113 个阶段，含纸落下、章落下压一下抬起、红笔边走边写的中间帧） | 约 1 秒（成品）/ 约 35 秒（含阶段） |
| 皮影戏 · Shadow Puppetry | `lib/shadowpuppet.py` · `ShadowPuppet` | `examples/shadowpuppet_cuju.py` 蹴鞠 · Cuju by Lamplight（油灯从背后照亮的琥珀色幕布，前面是雕花戏台：回纹浮雕横楣、红漆金字牌匾「蹴鞠」、透空回纹挂落、两角镂空花牙子、两盏红灯笼；幕上是雕空、透明染色的驴皮：牌楼式球门（瓦顶飞檐、鸱吻、窗棂网、红边风流眼）、底部回纹装饰带、四个关节人偶。红方球头刚起脚，一条腿踢得老高，同伴一手高一手低、提膝亮相；青方一个跳起扑球（离幕一点，边缘发软、成双影），一个指着球；鞠正卡在风流眼里；「球头」「骁色」两块小牌挂在线上。人偶是阳刻空脸或阴刻红脸、雉翎盔或三叉冠、云肩护心镜鱼鳞甲、厚底靴，皮叠在一起处更深，关节有线结，操纵杆从领口和手上垂下去；`--stages` 出 60 个阶段，全是真运动：点灯、横楣落下、灯笼晃着亮起、球门升起、人从侧幕滑进来由虚变实、传球、起脚、亮相、小牌落下） | 约 7 秒（成品）/ 约 27 秒（含阶段） |
| 钢笔淡彩 · Pen & Wash | `lib/penwash.py` · `PenWash` | `examples/penwash_neighbours.py` 街角速写 · Sketchbook Neighbours（橡木桌上并排四张冷压水彩小卡，一张一个街坊在做一件小事：吹着口哨的邮差，钴蓝帽子和外套，挎包塞得太满，两封信从背后逃出去扑扇着飞走；戴超大圆眼镜的奶奶给花盆浇水，猫却钻进了盆里，水滴正落在它两耳之间（眯眼、爪子扒着盆沿），真正的那朵红花在旁边干等；踩滑板车的小孩，钴蓝头盔大了两号、压到眉毛，吐着舌头，膝盖贴着创可贴，身后速度线和尘土；圆滚滚的面包师戴高高的白帽子，抱着一根比他还长的法棍，法棍从手绘边框里戳出去，一只麻雀落在尖上啄；针管笔线条抖、出头、不闭合、偶尔描两遍，淡彩错位出线、在线里留白缝、干边、颗粒，腮红湿中湿，不铺满的背景色块绕开人物留白边，白色水粉高光；卡片有阴影和受光的切边，旁边放着一支针管笔、一支水笔（透明杆里的水和气泡、染了颜色的尼龙笔尖）和水笔的笔帽；`--stages` 出 9 个阶段：空桌、白卡、两批墨线、两遍淡彩、背景色块、高光、放下笔） | 约 3 秒（成品）/ 约 6 秒（含阶段） |
| 复古水粉 · Retro Gouache | `lib/gouache.py` · `GouachePortrait` | `examples/gouache_rainy_day.py` 雨天三人像 · Rainy-Day Portraits（米色画板上并排三幅竖长的绘本大头像，每幅一块刷出来的单色背景：浅海玻璃绿底上的老渔夫，黄色防水雨帽上还挂着雨珠、帽檐尖上吊着一滴水，巨大的红鼻子、白色浓眉、大耳朵、一圈白色下巴胡子，藏青麻花毛衣配罗纹领，胸前毛毡口袋里探出一条银色小鱼、张着「O」字嘴，他眯着眼往下看它；绿底上被一顶巨大的芥末黄毛线帽和红白条纹围巾埋住的小孩，橙色大绒球，两只毛线手套捧着一杯冒热气的可可，杯里漂着两块棉花糖，他盯着棉花糖看成了斗鸡眼；蓝到黄渐变底上的高个女士，橙色小卷堆成一座高塔发型，蓝眼影、珍珠耳坠、红色高领、钴蓝大衣配青绿毛毡翻领，斜眼瞟着爬上她肩膀的蜗牛，蜗牛身后的大衣上还有一道发亮的黏液；不透明水粉从暗到亮：托底色、赭色起稿、背景干笔皴擦、平涂大块、几阶色值塑形（鼻子、脸颊、帽子）、帽檐和鼻子下的软投影、粉状腮红、V 字平针与麻花、罗纹、一根根发丝和胡子、毛毡、受光处的干笔高光，最后是印刷书页的纸纹；`--stages` 出 8 个阶段：托底色、起稿、背景、平涂、塑形、质感、五官与道具、高光） | 约 7 秒（成品）/ 约 8 秒（含阶段） |
| 蓝调绘本 · Blue Picture Book | `lib/bluebook.py` · `BlueBook` | `examples/bluebook_shared_umbrella.py` 借伞 · The Shared Umbrella（软蓝雨天里的一张绘本跨页，背景蓝块毛边、不到纸边：左页是一个小小的公交站，玻璃候车亭里的长椅空着，只有一只蜗牛独占整条干燥的长椅，旁边是画着小巴士的圆站牌、亮着芥末黄灯的路灯，路灯下的大水洼里一只鸭妈妈带着两只小鸭玩得正欢；右页一个穿钴蓝雨衣、扎两个珊瑚红小揪揪的小女孩，双臂伸到最高，把一把珊瑚红小伞举向一只巨大、害羞、毛茸茸的白熊——伞只遮住了它的鼻子，雨落在它的耳朵和头顶，也落在小女孩自己的头发上，她一点也不在意，仰着头冲它笑；白熊低头看着自己并在一起的爪子，脸红了；水洼里映着一点红伞，蓝黑乱线的灌木里开着几朵珊瑚红小花；照绘本画家的顺序：空白纸、蓝色色块（天空块、雾里的远树、灌木、雨衣、候车亭、水洼）、松的墨线（线不闭合、偶尔描两遍）、乱线排出的暗部、珊瑚红点缀和点彩腮红、白粉笔（云、白毛、水纹、玻璃反光）、雨丝 / 水花 / 甩点 / 细尘，最后印在书上（中缝、页码、印刷的柔化）；`--stages` 出 7 个阶段加成品：空白纸、蓝色色块、墨线、暗部、点缀色、粉笔白、雨） | 约 5 秒 |
| 江南园林 · Jiangnan Garden | `lib/jiangnan.py` · `JiangnanGarden` | `examples/jiangnan_spring_water.py` 春水园林 · Spring Water Garden（一幅横幅的江南园林春景，从前景的花枝和柳丝之间望进去：画面中间是一池碧绿的春水，岸上的一切都倒映在里面，更柔、更暗，带涟漪和细竖纹；一座带镂空石栏板的九曲石桥折了三折，穿过水面通向一道粉墙，墙上的月洞门里露出另一个洒满阳光的小院（竹子、粉色花树、一块湖石、远处又一道白墙），旁边一扇冰裂纹漏窗，墙上落着叶影；粉墙旁是一座临水茶榭，黛瓦歇山顶、翼角高高翘起、脊头卷起，翡翠绿的槅扇门和灯笼锦窗、檐下挂落、一对红灯笼、一块写着「听雨」的小匾，台基上几盆花；茶榭右边一棵开满白花的树下，一条小木船系在石阶边；左岸一棵大垂柳，墙后一棵层层托盘的松树和一片深浅不一的树冠，再后面是雾里的青山；近处水面上一丛丛睡莲叶和几朵粉色睡莲，一只白鹭站在水中的石头上，另一只从松树前掠过；前景左下是深绿的灌木、白色小花和弯弯的鸢尾叶，右下一丛粉色杜鹃，左上垂下几缕近处的柳丝，右上一枝粉色花枝，花瓣在空中飘、在水面上漂；右下角一方小红印「春水」；照风景插画家的顺序从后往前画：天空和远山、远树和雾、建筑、对岸的园子、水和倒影、桥和船、睡莲和白鹭、前景草木、垂挂的画框，最后是印章和收尾的柔化、光晕、颗粒；`--stages` 出 9 个阶段加成品：天空和远山、远树、建筑、对岸、水、桥和船、睡莲和白鹭、前景、画框） | 约 6 秒 |
| 干刷色块 · Dry-Brush Blocks | `lib/drybrush.py` · `DryBrushBlocks` | `examples/drybrush_noodle_counter.py` 面馆 · Noodle Counter（一张 4:3 的 mid-century 海报：小面馆柜台前，一位白色平头、粗黑框眼镜、白胡子的老人，穿藏青工装，一手用筷子从碗里挑起面，一手扶着碗；外套亮的一半是青蓝、暗的一半近黑，两半朝不同方向刷，袖子顺着胳膊刷；头是几块肤色平面：亮面、本色、暗面，更暗的鼻侧和暖色鼻头、腮红、暖色的耳朵；手是从拇指一侧看的几条手指，手腕露一截米色袖口；碗里是面、一块红油和葱花；身后一大块滚筒刷的鼠尾草绿色板，右边柜台上一个醋瓶、一个酱油瓶和一杯茶，衬着一块青蓝色块；米白纸上大片留白，右下一个小朱红方块；照参考海报的做法画：纸 → 大色块 → 几块面的外套和袖子 → 头 → 眼镜、胡子、筷子、近处的手 → 静物 → 红方块 → 印刷；`--stages` 出 7 个阶段加成品：纸、色块、外套、头、细节、静物、红方块） | 约 5 秒 |
| 暮色微缩绘本 · Twilight Storybook | `lib/twilight.py` · `TwilightStorybook` | `examples/twilight_paper_kite.py` 夜的边上 · The Kite at the Edge of Night（2000×1100 的一页黄昏绘本：一个穿蓝色毡子斗篷、软帽尖带绒球、圆脸点点眼、戴黄手套的原创小角色坐在野花坡顶上，把一只纸风筝放向天空入夜的地方；左边是粉彩黄昏：薰衣草紫、玫瑰、蜜桃、暖金，柔和的云带、细细的光线，一轮淡日正落到雾紫色的远山后面，一群飞鸟、几颗飘着的蒲公英种子；右边已经入夜：满天星、带暗带的银河、弯月、一颗流星，远山上一间小屋亮着一扇窗；中间是粉彩条纹的拼布山丘和小圆树，前景几万朵野花，入夜的一侧变成月光蓝，坡顶衬着天空几丛带穗的高草，花间有蝴蝶和蜻蜓；角色身边一罐萤火虫照亮一圈草，萤火虫往暗处飘；天空中间一个圆形「detail a」放大图，引线连到风筝上，用细技术图的画法画风筝骨架交叉处的绑扎和提线结（排线、ø 6 标注、标签、比例尺）；两行小写手写字「the evening waits for us.」「just a little further.」；照顺序画：黄昏天空 → 夜 → 山 → 花坡 → 角色和风筝 → 萤火虫 → 图版和手写字；`--stages` 出 6 个阶段加成品：黄昏天空、夜、山、花坡、角色和风筝、萤火虫） | 约 2 秒 |
| 排线夜景 · Hatched Nocturne | `lib/nocturne.py` · `Nocturne` | `examples/nocturne_lava_sea.py` 熔岩入海 · Lava Meets the Sea（一张装在米白纸边里的 16:9 小幅夜景版画：黎明前的火山海岸，熔岩从深色的火山坡上一缕缕淌下来，蜿蜒、分股，到海边散成一片细流，流进海里的地方是全画唯一的暖光——海水被激成蒸汽，一柱云团往上翻、顺风往左歪，从下往上被照亮：水边黄白，往上橙红，再往上是暖灰，到顶上是冷的石板蓝；火星往上飞，坡上几处停住的熔岩前锋还亮着小珠；海面上一条被横向笔触打碎的暖色光柱一直拉到画面底边，云团的红光也碎碎地映在水里；远处一座低矮的岛，海中间的一块小礁石上坐着两个看它的人（四十来像素高），其中一个围着红围巾；靛蓝的天空顺着风斜着流，零星几颗星；天、云、山、海全是顺着各自方向的短笔触，每笔色相明度都差一点，留着底色的细缝；画心外一道压印的版痕，左下铅笔小字「Forty seconds」，右下更小的「lava meeting the sea before dawn」；照画家的顺序画：纸和深色底、天空、远岛和火山、冷色的蒸汽、亮光（被照亮的云、天空和山坡上的光笔触、热源）、熔岩细流和火星、海、倒影、礁石和小人、装裱和题字；`--stages` 出 9 个阶段加成品） | 约 9 秒 |

各画风共用 `lib/core.py` 里的底层工具：噪声、模糊、样条曲线、多边形遮罩、有机轮廓 `blob_pts`、毛笔 `bristle_stroke`、中文字体查找；新四种还用到补零平移 `shift`、文字遮罩 `text_mask`、西文字体查找 `latin_font`/`load_font`，以及高度图打光 `height_normals`、`height_shadow`（沿光线步进的投影）、`ambient_occlusion`。

**用户没有指定画风时怎么选**：
- 禅意、古典、山水 → 水墨；
- 清新风景、花卉 → 水彩；
- 童趣、温暖、讲故事 → 剪纸拼贴；
- 甜点、小物、日常可爱 → 韩国彩铅；
- 青春、夏日、天空、背景美术 → 日本动漫；
- 观点、概念、商业文章配图 → 编辑风手绘；
- 浓烈、有笔触质感、名画感 → 油画厚涂；
- 日式古典、海浪、富士、东方装饰感 → 浮世绘；
- 复古游戏、夜景霓虹、小尺寸动画 → 像素风；
- 童趣立体、讲故事、手作感、定格动画 → 黏土定格；
- 植物、标本、自然科学、复古工艺感的蓝色海报 → 蓝晒；
- 家、温馨、手作礼物、贺卡、名字和字母 → 十字绣；
- 设备、仪表、音响收音机、复古科技与产品感 → 复古仪器面板；
- 清单、账单、价格、购物、市集、活动海报、轻松但成熟的讲解片封面 → 贴纸拼贴 · 小票；
- 实验记录、数据对比、复盘笔记、讲解片里的「算账 / 结论」页 → 实验笔记本 · 贴纸；
- 讲课、知识点、公式推导、原理示意图、讲解片里的「板书 / 课堂」页 → 黑板板书；
- 夜景、城市、雨、霓虹、电影感氛围、讲解片的「未来 / 科技 / 城市」封面 → 赛博朋克（要复古小尺寸或像素动画仍用像素风）；
- 可爱的拟人小物件、日常小事讲故事、带表情的角色、讲解片里轻松的「步骤 / 原理」图解、要逐帧抖线的动画 → 卡通手绘（要立体手作感用黏土定格，要纸片感用剪纸拼贴）；
- 小世界、城市 / 园区 / 工厂 / 校园示意，系统或流程的「微缩模型」图解，围着场景放数据卡的信息图，讲解片的「全景 / 系统概览」页 → 等轴 2.5D（要霓虹夜景用赛博朋克；要复古小尺寸用像素风）；
- 高级克制、极简、品牌感封面、要看「一笔画出来」的过程、讲一段路线或旅程 → 单线画（深蓝底金线或奶油底墨线，只一个点睛色）；
- 产品感、软萌立体、糖果色、MG 片头大字、「3D 渲染」、讲解片封面的立体标题 → 柔光 3D（要手作、捏泥的质感仍用黏土定格）；
- 过程、变化、循环、「从 A 变成 B」的小故事，讲解片的转场、片头和「演变」页 → 形变动画（要真的动起来，用 `Morph.at` 逐帧出图）；
- 杂志封面、观点海报、达达 / 复古拼贴、「拆开看看 / 里面有什么」类讲解页、需要老照片质感又不能用真人照片 → 报刊拼贴（要童趣温暖的彩纸拼贴仍用剪纸拼贴）；
- 产品界面、App / 小组件展示、效率工具与数据面板、明亮通透的科技感、讲解片的「功能 / 界面」页 → 弥散玻璃（要暗夜霓虹氛围仍用赛博朋克）；
- 设计感海报、讲座 / 展览 / 活动海报、概念图解（形状、比例、对比、原则）、讲解片里的「定义 / 原理」页 → 包豪斯几何；
- 80 年代复古未来、怀旧、夏夜公路与海边、音乐和歌单封面、讲解片的「复古科技 / 回到过去」封面 → 复古 Synthwave（要雨夜城市用赛博朋克，要低分辨率游戏感用像素风）；
- 手作、DIY 教程、「从图纸到成品」的步骤图、把像素图案做成可爱实物（杯垫、挂件、冰箱贴）、讲解片里的「动手做」页 → 拼豆（要屏幕上的像素游戏感用像素风，要布上的针线用十字绣）；
- 远古、史前、起源、「人类最早的记录」、狩猎与迁徙、动物群、天文与历法、讲解片里的「历史开端 / 最早怎么记事」页 → 岩画（凿刻砂岩）；
- 古代文明、历史与考古、农业和劳动场面、「一步一步」的工序或流程讲成分栏连环画、讲解片里的「最早的记录 / 起源 / 古人怎么做」页 → 古埃及墓室壁画；
- 古典、地中海、古罗马 / 古希腊题材，海洋生物、港口与渔猎、动物图鉴，门槛或地面铭文，讲解片里的「历史 / 起源 / 古代」页 → 罗马马赛克（要屏幕上的像素格子感用像素风，要熔珠小管的手作感用拼豆）；
- 教堂、中世纪、哥特、庄严而温暖的透光，节日与季节，「一年四季 / 时间流转」的分格叙事，讲解片里的「历史 / 传统工艺」页 → 彩色玻璃花窗（要现代霓虹发光用赛博朋克）；
- 中世纪、古籍、典藏感、「古老的学问」（天文、历法、草药、炼金这类老知识）的图解、书名页和章节首页、讲解片里的「历史 / 起源」页 → 泥金手抄本（一页里要有字：正文、红字标题和首字母是它的主体）；
- 发明、机械原理、「这东西是怎么动的」、从自然到设计（仿生）、工程手稿感的讲解页、「草图 / 构思 / 研究笔记」页、复古科学插图 → 达·芬奇手稿（要现代实验记录用实验笔记本，要讲课推导用黑板板书）；
- 人物小传、宠物、家族与纪念、复古肖像、「这个人 / 这只猫 / 这条船是谁」的介绍页、怀旧礼物卡片，不能用真人照片时 → 剪影（要童趣的彩纸故事用剪纸拼贴；要老照片拼贴感用报刊拼贴）；
- 活动 / 演出 / 开业 / 讲座的复古海报、「XX 来了」式的宣告、节目单与价目、旧时代广告、19 世纪美式或民国风的印刷品、讲解片里的「历史 / 老派做法」页 → 凸版印刷海报（要几何构成的现代海报用包豪斯几何，要剪报拼贴用报刊拼贴）；
- 工业、技术、发明史，「从 A 传到 B」的原理图解（广播、电报、铁路、流水线），强对角线的海报和杂志封面，讲解片里的「年代 / 历史 / 先驱」页，需要老照片质感又不能用真人照片 → 苏联构成主义（不写政治口号；要三原色几何讲座海报用包豪斯几何，要剪报和勒索信字用报刊拼贴）；
- 旅行、交通、城市主题海报，复古而有高级感的主视觉（开业、晚会、发布会、酒店、邮轮、列车），「速度 / 现代 / 黄金年代」主题，讲解片里「历史上的未来 / 1930 年代」的封面 → 装饰艺术（要 80 年代霓虹复古用复古 Synthwave，要几何构成和三原色用包豪斯几何）；
- 复古漫画、冒险故事的「出发 / 登场 / 大事件」、怀旧玩具与少儿读物感、讲解片的「故事开场 / 角色介绍」封面、需要对白框和拟声字的画面 → 黄金时代漫画（要现代日漫用日本动漫，要拟人小物件的轻松图解用卡通手绘，要红黑两色木刻海报用凸版印刷海报）；
- 同一个东西的几种状态、情绪、版本或配色并排对比，系列头像（宠物、角色、吉祥物），「一图多版」的潮流海报，讲解片里的「同一个东西的几副面孔 / 变体对比」页，要有名人肖像的波普感又不能用真人 → 波普丝网（要单张几何海报的套色印刷用包豪斯几何；要剪报和网点老照片用报刊拼贴）；
- 计算机史、老机房、复古科技、数据和日志、「当年的电脑怎么画画」、程序员 / 极客向的配图、讲解片里的「输出结果 / 运行日志 / 打印报告」页 → ASCII 字符画（行式打印机）（要屏幕上的低分辨率游戏感用像素风，要手写板书用黑板板书）；
- 游戏感、复古 3D、「90 年代末 / 千禧年」怀旧、飞行 / 赛车 / 闯关、带 HUD 的「关卡 / 进度 / 任务」页、讲解片里的「早期 3D 图形是怎么画出来的」（线框 → 平面着色 → 贴图 → 雾）→ 低多边形（要 2D 小尺寸游戏感用像素风，要柔和现代的 3D 渲染用柔光 3D，要正交微缩模型用等轴 2.5D）；
- 街头、城市、态度与幽默、一句短口号配一个小人物的海报、公益与社区宣传、「一个人 + 一件小事」的极简故事、讲解片的「观点 / 金句」页 → 喷漆模板涂鸦（要霓虹夜景用赛博朋克；要设计感的丝网海报用包豪斯几何；要剪报拼贴用报刊拼贴）；
- 徽章、勋章、打卡 / 成就 / 里程碑、旅行与户外、社团与活动标志、讲解片里的「收集 / 解锁 / 第 N 关」页 → 刺绣徽章（要手作布艺的十字格子感用十字绣；要贴纸质感用贴纸拼贴）；
- 工程、建筑、机械和设备的结构与原理（剖面、零件、尺寸、「里面是怎么造的 / 怎么动起来的」），产品或建筑的技术说明页，讲解片里的「结构 / 设计图 / 原理图 / 施工图」页 → 蓝图工程图（要植物和自然物的蓝色剪影用蓝晒；要发明构思和手绘草图感用达·芬奇手稿；要讲课推导用黑板板书）；
- 童趣、家庭与亲子、「我的一天 / 我的家 / 我的周末 / 长大想当什么」这类孩子口吻的小故事、节日与生日贺卡、儿童教育和绘本感、讲解片里「用孩子的眼光看」的页 → 儿童蜡笔画（要精致柔和的成人手绘用韩国彩铅；要彩纸拼贴的童趣用剪纸拼贴；要成熟的卡通角色用卡通手绘）；
- 终端、命令行、黑客 / 程序员向、老电脑屏幕、「敲一条命令得到结果」、复古版的数据面板，讲解片里的「查询 / 运行结果 / 系统状态」页 → 绿屏终端 CRT（荧光字符画）（要打印在纸上的日志和报表用 ASCII 字符画（行式打印机）；要低分辨率的游戏画面用像素风；要 80 年代霓虹用复古 Synthwave）；
- 温度、冷热、保温与漏热、散热、能耗，「看不见的东西」的可视化（热量、气流、体温、余温留下的痕迹），夜视 / 侦测 / 检测报告感，讲解片里的「数据告诉你哪里热、哪里漏」页 → 热成像（要霓虹夜景氛围用赛博朋克；要手写的实验数据与图表用实验笔记本；要复古仪表盘用复古仪器面板）；
- 荷兰、运河、风车、郁金香、帆船与航海，老派欧洲家居（厨房、壁炉、瓷砖墙），蓝白两色的典雅装饰，一组图标式的小图（单块砖可以一砖一个主题），讲解片里的「传统工艺 / 历史 / 一组图标」页 → 代尔夫特蓝瓷砖（要石子和玻璃拼的古代地面画用罗马马赛克；要普鲁士蓝的日光晒图用蓝晒）；
- 史前、人类起源、「最早的艺术 / 人类最早怎么画画」、狩猎与动物群、火与夜晚、讲解片里的「艺术的起源 / 远古的一个夜晚」页 → 洞穴壁画（赭石颜料）（要在日晒岩面上凿出来的符号用岩画；要分栏叙事、有文字的古文明壁画用古埃及墓室壁画）；
- 复古电脑、「第一代图形界面 / 早期个人电脑」怀旧、黑白像素插画、软件和工具的「界面 / 操作步骤」图解、讲解片里的「当年的电脑怎么画画」页 → 1-bit 早期画图软件（要彩色的低分辨率游戏感用像素风；要打印纸上的字符画用 ASCII 字符画）；
- 古希腊、古代奥运与体育比赛、「古人怎么比赛 / 劳动 / 过日子」，绕一圈又回到起点的事（跑道、循环、四季、流程），博物馆展品感、「一件器物 + 它的展开图」式的图解，讲解片里的「历史 / 起源 / 古代」页 → 古希腊黑绘陶瓶（要分栏的多彩墙画用古埃及墓室壁画；要石子铺成的地面画用罗马马赛克；要红黑两色的印刷海报用凸版印刷海报）；
- 写实而安静的日常一角（街角、老物件、静物、交通工具）、旅行写生、怀旧、「先画个草图 / 观察细节」的构思页、讲解片里的「观察 / 写生 / 手稿」页、要黑白高级感又不要漫画感 → 铅笔素描（要彩色可爱的小物用韩国彩铅；要发明与机械原理的手稿用达·芬奇手稿；要讲课推导用黑板板书）；
- 「里面有什么」「看穿」「拆开看结构」、透视 / 内部构造 / 原理图解（电器、工具、机械里面长什么样），安检、体检、检测、质检、排查问题，讲解片里的「真相 / 揭秘 / 一眼看穿」页 → X 光片（要手绘的机械分解图用达·芬奇手稿；要「拆开看看」的剪报拼贴用报刊拼贴；要冷热分布用热成像）；
- 复古动画、老电影 / 默片 / 黑白卡通的感觉、拟人的日常物件又唱又跳、起床 / 闹钟 / 上班这类节奏感强的小场面、讲解片里的「很久以前 / 第一代动画 / 老片头」页 → 1930 年代黑白橡皮管动画（要彩色、蓝铅笔稿的现代手绘卡通用卡通手绘；要网点和对白框的漫画书用黄金时代漫画）；
- 冬天、夜晚、乡村与小镇、民间故事和童话、节日贺卡和藏书票、「回家 / 守夜 / 一盏灯」这类温暖的小故事、要手作感又要强烈黑白对比的封面、讲解片里的「过去的冬夜 / 手工年代」页 → 黑白麻胶版画（要红黑两色的木活字海报用凸版印刷海报；要日式多色套印和晕色用浮世绘；要喷漆模板的街头感用喷漆模板涂鸦）；
- 家庭回忆、怀旧、「当年的那一天」（生日、过年、毕业、第一次……）、童年和老房子、found footage 式的悬念开场、讲解片里的「回到 80 年代 / 那时候的家 / 老录像里的证据」页 → VHS 家庭录像（要霓虹落日的 80 年代复古未来用复古 Synthwave；要老照片和剪报用报刊拼贴；要屏幕上的字符用 ASCII 字符画）；
- 风景、户外、旅行与露营、MG 动画式的场景背景和转场、讲解片的「场景 / 旅程 / 夜晚」页、要干净现代又有层次的插画 → 扁平矢量（要撕纸边和蜡笔的手作感用剪纸拼贴；要正等轴的微缩模型用等轴 2.5D；要 80 年代霓虹用复古 Synthwave）；
- 要「真的动起来」的小故事、一个可爱小角色的旅程或成长（从 A 到 B、出发—遇到—到达）、讲解片的片头片尾和转场、品牌吉祥物小动画、「一路走一路画出来」的过程感 → 绘本角色动画（`Storybook.gif()` 出真动画，`journey()` 出一张旅程总图；只要一条轮廓的变形用形变动画；要逐帧抖线的静态卡通插画用卡通手绘）；
- 上课 / 午休走神的随手涂鸦、纸上正在进行的游戏或计划（手画棋盘、寻宝图、清单、路线、比分）、学生和办公室日常的轻松小故事、讲解片里「在草稿纸上推演一步」的页 → 圆珠笔涂鸦（要铅笔图表、荧光笔和贴纸的实验记录用实验笔记本；要没有线稿、柔和的彩铅小物用韩国彩铅；要小孩的蜡笔画用儿童蜡笔画；要黑白石墨写生用铅笔素描）；
- 地图、路线与导览、城市 / 园区 / 校园平面图，「一层一层把信息加上去」的图解（底图 → 水系 → 绿地 → 路线），设计稿或方案的分层、叠加与对照，讲解片里「把几层信息叠起来看」的页 → 描图纸叠层（要正等轴的微缩模型用等轴 2.5D；要剖面、尺寸和施工说明用蓝图工程图；要三原色丝网海报用包豪斯几何）；
- 产品发布片 / 科技讲解片的「界面 / 流程 / 检查结果」页，要明亮干净、像真产品截图的窗口卡片，一屏讲一件事（大标题 + 一个主窗口 + 一个侧面板 + 状态），一整部讲解片统一的主画面（每节换一种粉彩底、圆形擦除转场）→ 粉彩界面（要磨砂玻璃和弥散渐变用弥散玻璃；要等轴微缩模型用等轴 2.5D；要黑白早期界面用 1-bit 早期画图软件）；
- 考试、作业、批改与打分，「对照标准答案逐条检查」的过程（评测、验收、审核、评分规则、哪里错了、为什么扣分），讲解片里的「怎么判对错 / 评分标准 / 检查结果」页 → 阅卷批改（要草稿纸上的随手推演用圆珠笔涂鸦；要实验记录、红笔圈和便利贴用实验笔记本；要明亮的产品界面里打 ✓ / ✗ 用粉彩界面）；
- 中国传统与民间艺术、节庆（元宵、庙会、过年）、戏曲和民间故事、古代体育与游戏（蹴鞠、赛龙舟、舞狮）、「一场好戏」式的小叙事（登场—交手—亮相），讲解片里的「历史 / 传统 / 一场比赛的高光时刻」页，要人物有动作又不能用真人 → 皮影戏（要黑纸剪的侧影小像用剪影；要彩纸剪贴的童趣用剪纸拼贴；要山水留白用水墨）；
- 人物小品、街坊邻居与日常小事（送信、浇花、骑车、买面包）、一组角色卡 / 人设卡、旅行和城市速写里「一个人在做一件小事」、轻松幽默的配图，讲解片里「一组用户 / 角色 / 团队成员」的介绍页 → 钢笔淡彩（要蓝铅笔稿、毛笔线和赛璐璐阴影的拟人小物用卡通手绘；要风景和花卉的大片晕染用水彩；要真的动起来的角色用绘本角色动画；要草稿纸上的随手涂鸦用圆珠笔涂鸦）；
- 人物大头像、角色特写、一组人设的「封面像」、温暖怀旧的复古童书 / 绘本插画，要有摸得着的手感（毛衣针脚、毛线帽、胡子和卷发、毛毡），讲解片里「这个人登场」的特写页 → 复古水粉（要线稿加淡彩、「一个人在做一件小事」的速写小卡用钢笔淡彩；要真的动起来的扁平小角色用绘本角色动画；要梵高式厚涂的风景用油画厚涂；要撞色多格的头像用波普丝网）；
- 温柔又好笑的小故事、绘本跨页或内页、童书封面和插页、「一个小角色帮另一个」这类有情节的一幕，下雨、下雪、夜晚这类安静的天气，要一眼就是「手画的现代绘本」，颜色只要一种主色（软蓝）加一点点睛色 → 蓝调绘本（要单人特写大头像、看得见毛衣针脚用复古水粉；要速写小卡上的针管笔线稿加淡彩用钢笔淡彩；要真的动起来的扁平小角色用绘本角色动画；要小孩自己画的蜡笔画用儿童蜡笔画；要网点和套色的观点插画用编辑风手绘）；
- 中国古典园林、江南春景、亭台楼阁和水、旅行与城市文化里的「园林 / 古镇 / 春天」，节气和节日（春分、清明、谷雨）的配图和海报，要繁茂、细腻、一眼就是「精心画出来的插画」的风景，讲解片里的「中国传统 / 生活美学 / 春天」页 → 江南园林（要留白的写意山水用水墨；要大片松散的晕染用水彩；要赛璐璐天空和夏日少年感用日本动漫；要木版套色和海浪用浮世绘；要皮影人物的一场戏用皮影戏）；
- 人物和日常小场景（吃一碗面、喝茶、做手艺、街坊小店）、杂志 / 书籍 / 唱片的复古封面、餐饮和饮品海报，要「色少而准、有手感、有态度」的编辑插画和 mid-century 海报感，讲解片里「这个人 / 这家店 / 这一口」的特写页 → 干刷色块（要剪刀剪的彩纸童趣用剪纸拼贴；要不透明水粉一层层塑形的大头像用复古水粉；要 Riso 网点和套色错版用编辑风手绘；要三原色几何的丝网海报用包豪斯几何；要干净、没有笔触的矢量色块用扁平矢量）；
- 温柔、怀旧、带一点点孤独的小故事和情绪（「一天结束了」「出发」「再走一点点」），晚安故事、童书封面和插页，季节和节日的夜晚（夏夜、萤火虫、星空、七夕、中秋），原创小角色或吉祥物的「远方」主视觉，要在一张画里同时放「风景 + 一个零件 / 一个结 / 一处构造的放大图 + 手写小字」的讲解页 → 暮色微缩绘本（要软蓝限色、乱线墨线的绘本跨页用蓝调绘本；要真的动起来的小角色用绘本角色动画；要赛璐璐天空和夏日少年感用日本动漫；要大片松散晕染的风景用水彩；要整页的机械分解手稿用达·芬奇手稿）；
- 夜里的一个瞬间：一处火光、闪电、极光、篝火、渔火、熔岩、烟花，配一大片深蓝的天和水，要一眼就是「手画的小幅版画」、有满画面的笔触感和一点孤独，讲解片里的「一个极短的瞬间」「远处发生的大事」「自然现象」页，文章配图和海报 → 排线夜景（要梵高式厚涂漩涡和颜料浮雕用油画厚涂；要粉彩黄昏转入银河、满坡野花用暮色微缩绘本；要霓虹雨夜街道用赛博朋克；要黑白石墨排线用铅笔素描；要明亮可爱的彩铅小物用韩国彩铅）。

每种画风一幅范例作为质量基准（范例都不用禅意主题）；水墨另加一幅「月印万川」（留白托月、水面倒影）。

## 一、流程（每幅画都照做）

1. **定构图**，动笔前先想清楚这几项：
   - 层次：远 → 中 → 主体 → 前景；
   - 视觉焦点在哪里；
   - 留白够不够：水墨至少四成，水彩和剪纸也要有呼吸感；
   - 点睛色只用一两处：水墨用朱红，剪纸用一个亮色主角；
   - 题字或纸条放在哪里。
   - **画面要图解内容本身**，而不是随便一幅风景。
2. **写场景脚本**：复制最接近的范例改写。
3. **渲染并自己看图**：`python3 scene.py out.png`。
   - 用 Read 打开 PNG，对照第三节该画风的毛病清单逐条自查；
   - 一般改 2–4 轮，每轮只改最显眼的问题，旧版存成 `_v1/_v2` 以便对比。
4. **交付**：转成 JPG（quality 92），用当前对话渠道支持的方式发图。
   - 要做动画时加 `--stages DIR`，按 `stage('名字')` 输出各阶段快照。

## 二、接口速查

```python
import sys; sys.path.insert(0, "<本skill>/lib")
from core import spline, curve, blob_pts, fbm1d, blur, polygon_mask
```

**水墨 `Painting`**：
- `paper()`、`ridge(base, peaks=[(x,h,w)])`、`peak(SX, SY, shoulders=...)`
- `wash(ridge, dens, decay, tex, edge, mist_y)`：墨染山体，上浓下淡、带水痕边，会遮挡后面的层
- `cun()` 皴擦、`moss()` 苔点、`ridge_line()` 淡山脊线、`trails(ridge, summit, red_index)` 汇顶小路、`mist(y, h)` 雾带
- 毛笔 `stroke(pts, width, ink, dry, taper, red)`
- 物件：`pine()`、`rock()`、`sun()`、`birds()`、`pagoda()`、`traveller()`、`dot()`
- 题字印章：`title_vertical()`、`seal()`

**水彩 `Watercolor`**：
- `paper()`：冷压水彩纸纹理
- 遮罩：`shape(pts, soft, ragged)`，soft 取 1–4 是清晰的水痕边，15–40 是湿画晕开；`band(pts, width)` 是粗笔带状遮罩
- `glaze(mask, 颜色, strength, edge, gran, bloom, variation)`：透明罩染，叠加会像真颜料一样变深、混色
- `gradient_wash(y0, y1, top, bottom)`：湿画渐变天空
- 笔触：`stroke()` 彩色干笔、`line()` 细线勾勒、`lift(mask)` 提白、`splatter()` 甩点
- `soften(mask)` 任意遮罩水彩化边缘；`blobs([(cx, cy, rx, ry)])` 一组团块合成一片（树冠、灌木、云）；`mirror(mask, 水线y)` 水面倒影（带波纹断续）
- `Watercolor.petal_pts(x, y, 角度, 长, 宽)`：花瓣或叶片轮廓；`hexc('#rrggbb')` 转颜色

**剪纸 `Collage`**：
- `background(颜色, texture)`
- `piece(pts 或 mask, 颜色, texture, torn, rim, shadow)`：贴一张纸。torn 是撕边程度，rim 是撕口白边，shadow 是纸片阴影；texture 可选 paper / kraft / crayon / newsprint / notebook
- 形状遮罩：`circle_mask()`、`cloud_mask()`、`Collage.star_pts()`
- 蜡笔和光：`crayon(pts, width, 颜色)` 蜡笔线、`dot()`、`glow()`
- `face(cx, cy, r, mood='smile'|'sleep'|'dots')`：笑眼、嘴、腮红
- `text(s, x, y, size, 颜色, vertical)`

**韩国彩铅 `ColorPencil`**：
- `paper()`：细纸纹
- 遮罩：`mask_poly(pts)`、`mask_blob()`、`mask_ellipse()`
- `hatch(mask, 颜色, pressure, angle)`：短排线铺色。蜡只挂在纸纹凸起上，pressure 越大越能压进凹处；边缘自动变淡
- `shade(mask, 颜色, angle=另一个角度)`：交叉排线加阴影
- `outline(pts, '#8a6a5a')`：浅褐色铅笔勾线；`line(pts)` 用于不闭合的线
- `sparkle(x, y, r)` 白色高光笔；`dots(mask, 颜色)` 草莓籽、糖粒之类
- 白色物体不要用白色画（白纸上看不见）：用暖奶白色，配淡紫灰或淡蓝灰阴影

**日本动漫 `Anime`**：
- `sky(top, mid, horizon_col, horizon)`：天空渐变
- `cumulus(cx, base_y, w, h, light)`：积雨云。许多不规则团块从后往前叠，每团的暗面是「团块减去朝光源偏移的自身」形成的月牙形硬边
- `sun_flare(x, y)`：光晕、光束、镜头光斑；`sparkles()`；最后加 `bloom()` 泛光和 `vignette()` 暗角
- `field(top_y, colours)`：平涂分带的田野；`pole()` 电线杆、`wire(p0, p1, sag)` 下垂电线
- 平涂和线稿：`fill(mask, 颜色)`、`gradient()`、`screen()`；`lines(pts, width, 颜色)` 画干净线稿；`poly()`、`circle()`
- 角色：平涂两色（亮色和阴影色）加深色描边

**编辑风手绘 `Editorial`**：
- 形状：`circle()`、`ellipse()`、`rrect()` 圆角矩形、`blob()`、`poly()`
- `fill(mask, 专色)`：印一层专色油墨，带颗粒、浓淡不匀、套色错位，并**叠印**（重叠处颜色相乘）
- `halftone(mask, 专色, cell, angle, amount)`：半调网点做明暗
- `line(pts, 墨色, width, wobble, breaks)`：歪扭的手绘墨线；`dashes()` 虚线；`stars()` 小十字星
- 专色控制在 4–5 种，并刻意让它们互相重叠，叠出第三种颜色

**油画厚涂 `OilPainting`**：
- 先准备两张图：参考色 `ref`（H×W×3，画面要画成什么颜色）和流向图 `ang`（H×W，每个像素上笔触的角度，比如天空打旋、麦田横扫、树木向上）
- `layer(ref, ang, length, width, density, mask)`：铺一层笔触。先大笔铺底，再中笔，最后只在要紧处（`mask`）加细节笔
- `stroke_at(x, y, angle, length, width, 颜色)`：在指定位置画一笔（乌鸦、签名、点睛）
- `render()` 自动打光：颜料平顶鼓边、有笔毛沟，落笔处更厚

**浮世绘 `Ukiyoe`**：
- `block(mask, 颜色)`：印一块平涂色版，带木纹和套印偏移
- `bokashi(mask, 颜色, y_strong, y_fade)`：晕色，从某一边浓到另一边消失，用于天空和海面
- `key(pts, width)`：墨色主版勾线
- 物件：`cloud_band(x0, x1, y, h, glow)` 不透明云带、`seigaiha(mask, 颜色, r)` 青海波纹
- 标题签和朱印：`cartouche(x, y, w, h, '标题')`、`seal()`
- 形状：`poly()`、`rect()`、`circle()`

**像素风 `PixelArt`**：
- 在低分辨率上画（默认 320×180，放大 6 倍）。坐标都是整数像素
- 画形状：`rect()`、`poly()`、`circle()`、`line()`（Bresenham 直线）、`outline(mask)`、`put(x, y)`
- 抖动：`gradient(x0, y0, x1, y1, c0, c1, steps)` 分带渐变，带与带之间用抖动过渡；`dither(mask, 颜色, alpha)` 按 Bayer 矩阵抖动上色；`glow(cx, cy, r, 颜色)` 抖动光晕
- 其他：`text('CAFE', x, y, 颜色, size)` 3×5 像素字、`rain()` 雨丝
- 交付用 PNG（无损），像素才清晰

**黏土定格 `Clay`**：
- 同时维护高度图（像素为单位）和颜色图，最后用影棚光一次性打光。部件默认「铺」在下面的东西上（`base=None`），先远后近、后铺的在上
- `backdrop(颜色)` 底板；`gradient(top, bottom, y0, y1)` 生成颜色场，可传给 `pad`/`smear`
- 部件：`pad(mask, 颜色, height, round)` 压平的一片（round 小是硬边薄片，大是鼓鼓的枕头形）、`ball(x, y, r)` 小球、`snake(pts, r, taper=(起, 止))` 搓条（线条、浪花、嘴、茎）、`text(s, x, y, size)` 鼓起的黏土字
- 工具痕：`groove(pts, width, depth)` 刻线、`poke(x, y, r, depth)` 戳洞；`smear(mask, 颜色场)` 手指抹开的一大片（会把相邻颜色拖混，留下柔和的指痕脊）
- `marble=('#颜色', 0.25)` 两色没揉匀的纹路；表面自动带小疙瘩和指纹
- 遮罩：`circle()`、`ellipse()`、`poly()`、`blob()`、`rrect()`

**蓝晒 `Cyanotype`**：
- 思路是「挡紫外线」而不是「上颜料」：放上去的东西按不透明度挡光，透过率相乘；最后显影成普鲁士蓝
- `coat(x0, y0, x1, y1)` 刷涂药水：一笔笔横刷，笔尾是干刷的断续刷丝，边上会甩几滴药水
- `place(mask, opacity, lift, texture)`：opacity 薄叶约 0.85、叶脉 1.0、绒毛约 0.3；lift 是离纸的高度（0 压平清晰，1–3 柔和半影）；texture 是叶肉的不均匀
- 批量画遮罩：`shapes([轮廓...])` 一次画很多片叶子，`lines([折线...], width, taper)` 一次画很多茎、叶脉、绒毛；`Cyanotype.leaf_pts(x, y, 角度, 长, 宽, tip, blunt)` 叶片轮廓
- 文字：`label()` 白色手写字（写在透明片上一起晒）、`pencil()` 晒完后写在纸边的铅笔字

**十字绣 `Stitch`**：
- 一切都在布孔的格子上（`cell` 像素一格）。`cells(mask)` 把像素遮罩变成格子，`at(gx, gy)` 取格子中心
- 针法：`cross(格子, 颜色)` 十字绣、`half(格子, 颜色)` 半针（天空、云、烟）、`back(pts, 颜色, step)` 回针（路径吸附到孔上，一针约 step 格）、`running(pts)` 平针虚线、`satin(mask, 颜色, angle)` 缎面绣（鼓起、有光泽）、`satin_text(s, x, y, size)`、`knot(x, y, 颜色)` 法式结
- 图样：`chart(['..#..', '.###.'], gx, gy, {'#': 颜色})` 按字符图绣；`letters('HOME', gx, gy, 颜色, scale)` 5×7 字母
- `label(x0, y0, x1, y1, 'EST. 2026')` 缝上去的织标

**复古仪器面板 `Panel`**：
- 所有部件都由同一盏左上方的主光照亮：朝光的边亮、背光的边暗、凸起的部件向右下投影
- 材质：`surface(mask, 材质, 颜色, height)`，材质可选 wood（柚木）、brushed（拉丝铝）、plastic、painted、fabric（喇叭布，`lurex=` 金丝）；`recess(mask, 材质, 颜色, depth)` 下凹的窗口；`background()`、`paint()`、`glow()`、`drop_shadow()`
- 控件：`knob(x, y, r, angle)` 车削旋钮、`button()` 琴键（`pressed=True` 按下）、`toggle()` 拨杆开关、`lamp()` 宝石指示灯、`magic_eye()` 绿色魔眼调谐管、`meter()` 指针表、`screw()` 螺丝、`grille()` 冲孔网、`badge()` 镀铬草书铭牌
- 印刷：`text(s, x, y, size, spacing=)` 丝印字、`scale_arc()` 圆弧刻度、`scale_linear()` 直尺刻度、`glass(mask)` 玻璃反光

**贴纸拼贴 · 小票 `Sticker`**：
- 思路：每样东西先在自己的透明小画纸 `Art` 上画成平面矢量图，再决定材质：`stick()` 做成模切贴纸，`lay()` 当纸平放
- `board(颜色, kind='cream'|'kraft')`：奶油色或浅牛皮纸底板，带纸纹、斑驳、纤维和杂点
- `art(w, h)` 返回 `Art`：遮罩 `circle/ring/ellipse/rrect/poly/blob/line/text`（中西文混排，`stroke` 加粗）；上色 `fill(mask, 颜色, alpha, clip)`、`gradient()`、`radial()`；`crescent(mask, dx, dy)` 明暗月牙；`speckle()` 撒面粉、籽粒；`cut()` 打孔；`texture('kraft')` 牛皮纸纹
- `stick(art, cx, cy, rot, border=14, peel='tr'|'tl'|'br'|'bl', peel_size, lift, gloss)`：模切贴纸。白边按圆角外扩，有切口厚度、覆膜高光和斜向反光，贴地阴影加柔和投影；`peel` 翻起一角，露出浅色背面和它自己的影子
- `lay(art, cx, cy, rot, curl, lift)`：纸张平放（小票、吊牌），两端微翘、翘起处影子更长；返回局部→画面坐标映射 `T(x, y)`，用来在纸上落笔、盖章
- `receipt(w, h)` 返回 `Receipt`：锯齿撕边、热敏灰字（断针竖纹、走纸浓淡、小掉点）；`centre()` 居中打印、`row(y, 名称, 金额, was='旧价')` 带点线引导和删除线、`rule('dash'|'stars'|'double')`、`barcode()`、`crease(y)` 折痕
- `tape(cx, cy, 长, rot, 颜色, pattern='stripe'|'dot'|'grid'|'plain')` 半透明和纸胶带，两头手撕锯齿；`tag_art(w, h, 颜色, 金属扣颜色)` 吊牌（`.hole` 是孔位），`twine(点列)` 双色面包师麻绳
- `stamp(cx, cy, r, 环形字, 中心字, 小字, 颜色, rot)` 圆形橡皮章（油墨半透明、压力不匀、字边积墨、漏印小坑）；`pen(点列, 颜色, width)` 红色圆珠笔（打勾、圈总价、划掉）
- 现成贴纸：`lettering_art([(文字, 颜色), ...], size)` 大字、`label_art()` 胶囊标签、`badge_art(r, 颜色, '-20%', top, bottom)` 波浪边促销贴

**实验笔记本 · 贴纸 `Notebook`**：
- 场景：`desk()` 石墨蓝灰桌面；`notebook(x0, y0, x1, y1, tabs, stack, ear, margin, header, grid, major)` 一整本笔记本（硬封底、分隔标签、错开的页边、青色方格纸、红色双边线、打孔、折角）；`binding()` 线圈（按金属管打光，带投影）
- 铅笔：`pencil(pts, width, pressure, jitter)` 手绘一笔（样条平滑、手抖、起笔轻收笔提）；`pencils([...])`；`rule(x0, y0, x1, y1)` 靠尺直线；`hatch(mask, angle, spacing, pressure)` 排线；`checkbox(x, y, size, checked)`；`arrowhead(tip, 方向)`；`axes(x0, y0, x1, y1, xlim, ylim, xticks, yticks, xlabels, ylabels)` 返回 `to_px(x, y)`
- 石墨只挂在纸纹凸起上：pressure 小是颗粒状浅灰，大才填满；线宽约 2–3.5 px
- 荧光笔 `highlight(x0, x1, y, h, tilt, alpha)`：正片叠底，斜切起笔并积墨、边缘毛、纵向纤维条纹、尾部断续，两遍重叠处更深
- 红笔：`pen(pts, width)`、`pen_loop(cx, cy, rx, ry, rot, turns=1.12)` 不闭合的圈、`pen_arrow(pts, head)`、`pen_underline(x0, x1, y, double)`
- 文字 `text(s, x, y, size, colour, font, anchor, rot, spacing, weight, medium)`：font 用 sans / sans_bold / typewriter / cjk_sans（中英混排自动换字体），medium 可选 ink、print、typed（打字机，每字浓淡和基线略不同）、pencil、opaque；`text_width()` 量宽度
- 纸片：`sticky(cx, cy, w, h, rot, colour)` 便利贴（上端平贴、下端翘起投影），返回 Frame，用 `f.pt(lx, ly)` 和 `rot=f.rot` 往上写字；`sticker(cx, cy, w, h, rot, colour, shape='rrect'|'circle', lines=[...])` 模切贴纸；`label_tape(s, x, y, size, rot)` 标签机胶带；`stain(cx, cy, r)` 咖啡杯印
- 道具：`pencil_prop(x, y, angle, length, width, label, end='eraser'|'plain')` 六棱铅笔
- 角度：`rot` 逆时针为正（同 PIL）；`angle`（铅笔、箭头方向）是屏幕角度，顺时针为正。常用色：`INK SOFT LEAD RED HI MINT MINTD`

**黑板板书 `Chalkboard`**：
- 分层：石板漆 → 粉笔层（预乘颜色 + 透明度，板擦能擦掉）→ 板前物件（木框、粉笔槽、粉笔、板擦及其投影）→ 室内光与暗角
- 板面：`slate()` 云状不匀的墨绿石板漆；`dust(amount, specks, haze)` 沉降的粉笔灰，越往下越厚；`frame(rail, top, ledge)` 斜接木框加粉笔槽，会设置写字区 `area` 和槽面高度 `tray_y`。默认尺寸构造时就已知，dust 和擦痕可以先于画框画
- 板擦：`swipe(pts, width, strength, haze, smear, keep)` 沿路径擦一遍：带走粉笔、顺擦向拖出残迹、毡面梳出细纹、毡面两端积灰；`smudge(cx, cy, w, h, rot)` 短擦一下；`with cb.erased(keep, angle, smear):` 块里画的一切都变成擦过没洗的旧课残影
- 笔尖：`stroke(pts, colour, width, pressure, jitter)` / `strokes([...])`；`line()` 徒手直线、`rule()` 靠尺直线；`box(x0, y0, x1, y1, gap=(xa, xb))` 四边出头，上边可留缺口写标签；`loop(cx, cy, rx, ry, rot, turns)` 不闭合的圈、`circle()`；`arrow(pts, head)` 两笔箭头在尖端叠厚；`underline(x0, x1, y, double)`；`wave(p0, p1, wavelength, amplitude)` 光波曲线带箭头；`dashed()` 一段段画的虚线；`dot()`；`hatch(mask, angle, spacing)` 排线；`propto(x, y, size)` 手写 ∝，返回宽度
- 侧锋：`side(p0, p1, stick, pressure)` 粉笔横躺拖一笔；`shade(mask, colour, angle, stick, pressure, overlap, weight)` 侧锋铺色，weight 是全画布 0–1 的压力图，可做渐变
- 粉笔只挂在板面「齿」的凸起上：pressure 0.2–0.4 颗粒稀疏（铺色），0.8–0.95 写字画线
- 文字 `text(s, x, y, size, colour, font, anchor, pressure, weight, rot, spacing, hand, grain)`：font 用 sans / sans_bold / cjk_sans，某套字体缺字自动换另一套；每个字各自微转、错位、轻重不一（hand=0 为排版体）；`text_width()` 量宽度
- 道具：`chalk_stick(x, cb.tray_y, length, colour, rot, worn='right'|'left'|None)` 粉笔，一端磨斜；`eraser(x, cb.tray_y + 2)` 板擦；`crumbs(x0, x1, n)` 碎粉笔
- 颜色：`WHITE YELLOW PINK BLUE` 为主，`RED ORANGE GREEN VIOLET` 用于光谱和彩色粉笔，另有 `DUST`；所有 angle 和 rot 都是逆时针为正

**赛博朋克 `Cyberpunk`**：
- 思路：一台水平的针孔相机看向街道深处，世界坐标 X 右、Y 上、Z 向前，单位是米。所有东西写进 HDR 缓冲（反照率、自发光、z-buffer 深度、倒影镜像行），调用顺序不影响遮挡；`render` 时统一算光：环境光 + 光源外溢照明、深度雾（雾色是城市光的散射）、地面倒影、蒸汽、雨、胶片
- 构造：`Cyberpunk(W, H, seed, focal=1150, vp=(x, y), eye=1.7, fog=125, wall=9.5, road=6, record=True)`；`record=False` 时 `stage()` 不出快照，渲染更快。相机工具：`project(X, Y, Z)`、`ground_row(Z)`、`near_z(side)`
- 远景：`sky()` 被街灯从下面照亮的低云；`skyline(z, x_range, heights, widths)` 远处塔楼剪影、针点窗光、红色航空灯；`light(x, y, r, 颜色, z)` 小点光源
- 楼：`building(side, z0, z1, height, wall, colour, lit, shops=(亮店, 卷帘门, 暗店, 自动售货机))` 透视楼块，正面加沿街立面贴图（窗格、空调外机、雨痕、底商、招牌字，右侧立面的字会自动镜像）
- 霓虹：`blade_sign(side, z, Y0, Y1, '字', 颜色, reach, border=颜色, latin='BAR', dead=[序号], flicker=[序号], kind='neon'|'box', text_colour, level)` 伸向街心、面向镜头的竖招牌；`sign(z, X0, X1, Y0, Y1, ..., vertical=False)` 横招牌或立式灯箱；`neon_text(s, x, y, size, 颜色, z, vertical, dead, flicker)`、`neon_path(点列, 颜色, z)` 任意灯管
- 全息：`hologram(z, X0, X1, Y0, Y1, '海月', 'SEA MOON', level, jelly=(x, y), sub_y)` 半透明投影广告（海月水母、竖排明朝标题、扫描线、撕裂切片、色边、投影边框），只加光，还会照亮雾和墙
- 街道：`street(crossing=(z, 宽), puddles)` 湿沥青、路缘、铺砖、斑马线、积水；`puddle(X, Z, rx, rz)` 指定水洼（放在近处招牌的倒影位置上，能倒映出整块招牌）；`grate(X, Z)` 井盖格栅
- 空中：`walkway(z, Y, thick, deep, windows=None)` 过街天桥（正面可再挂 `neon_text`）；`cables(n, z=(近, 远), Y=(低, 高))` 电线；`light_trail(三维控制点, 颜色, pair, strobe, fade)` 飞车光轨（左行交通：尾灯红、头灯暖白）
- 氛围：`steam(X, Z, height, width, drift, density)` 井盖蒸汽；`mist()` 只躺在远处街面的薄雾；`figure(X, Z, umbrella='clear'|'dark'|None)` 打伞背影（两侧霓虹轮廓光，无脸）；`rain(far, mid, near, slant, rings)` 三层雨和溅落圈；`glitch(y, h, shift, split)` 一道撕裂扫描线，只在成片里出现，用一次就够
- 颜色常量 `MAGENTA CYAN AMBER RED WHITE`；`save('x.jpg')` 默认 quality 88、4:4:4 色度，霓虹边缘不糊

**卡通手绘 `Cartoon`**：
- 思路：照动画师画一张原画的顺序——蓝铅笔起稿 → 勾线 → 平涂 → 赛璐璐阴影 → 蜡笔/网点 → 特效 → 字。每一笔按种类落进一个「组」：`rough` 铅笔、`ink` 墨线、`flat` 平涂、`shade` 阴影/高光/腮红、`texture` 蜡笔/网点/排线、`fx` 特效、`type` 字。`stage(name, show=[组...], rough=强度)` 只显示这些组，画完的一张图可以按作画顺序回放；`with c.group(ink='ink_bg'):` 把某一类改投到别的组，`with c.group('fx'):` 全部改投
- 遮挡：东西不透明，`fill` 会挖掉身后已画的墨线和颜色（隐藏线自动去掉），所以先远后近；`fx`、`type` 是最后叠上去的覆盖层，它们的挖空只在显示时生效，阶段快照不会出现空洞
- 墨线：`line(pts, width, taper)` 毛笔线（落笔细、中段粗、收笔尖，有手抖和压力起伏）；`outline(pts, width, weight, gaps)` 一笔画完的闭合轮廓，首尾两个尖头交叠，背光的右下侧按 weight 加粗，`gaps=n` 留几处小断口；`ink_fill()` 实心墨块、`dot()` 墨点。每条墨线会自动先起一遍蓝铅笔稿（`rough=False` 关掉），`sketch()` 只画铅笔辅助线
- 颜色：`fill(pts|mask, 颜色, slop)` 平涂，整体错开 slop 像素、边缘游走，返回 `Mask`，可作 clip；`shade(形状, 颜色, offset=(dx, dy), clip)` 硬边赛璐璐阴影（形状减去朝光源挪过的自己，得到背光侧的月牙），offset=None 时直接用给的形状；`glint(pts, width)` 白色高光笔；`shape(pts, 颜色, shade=(颜色, dx, dy), shade2=...)` 一次做完平涂、两层阴影和描边；`darker(颜色)` 取阴影色
- 质感：`crayon(形状, 颜色, pressure, angle)` 蜡笔（只挂在纸纹凸起上，顺着涂的方向有条纹，毛边；pressure 可以是整幅数组，做渐变）；`tone(形状, 颜色, cell, angle, amount)` 网点纸；`hatch(形状, angle, spacing)` 墨线排线（接触阴影）；`blush()` 腮红
- 角色：`face(cx, cy, size, mood, rot)`，mood 可选 happy（^ ^ 眼加张嘴吐舌）、wow（圆眼加 o 嘴）、sleepy、smile、wink，自带腮红；`arm(肩, 手, bend, hand, thumb)` 橡皮管手臂加带拇指的白手套（先画手臂再画身体）
- 特效（默认进 fx 覆盖层，`fx=False` 当普通物件画）：`sparkle()` 四角闪光星、`speed_lines(p0, p1, angle)` 速度线、`steam()` 热气、`puff()` 扇贝边烟团、`burst()` 爆炸星形框、`crumbs(..., avoid=遮罩)` 飞溅碎屑、`pop_lines()` 强调短线
- 字（默认进 type 覆盖层）：`letter(s, x, y, size, fill, depth, depth_colour)` 大标题字（中文圆体加漫画西文，每个字微转、上下跳，带挤出阴影、左上白边和粗墨描边）；`note()` 手写注释；`arrow()` 手绘箭头；`badge(x, y, r, '1')` 编号圆标；`pencil_note()` 纸角的蓝铅笔编号；`text_width()` 量宽度
- 形状：`Cartoon.rrect_pts(x0, y0, x1, y1, r 或 (左上, 右上, 右下, 左下))`、`ellipse_pts(cx, cy, rx, ry, rot, a0, a1)`（给 a0/a1 就是一段弧）、`densify()` 保留尖角的折线、`place(局部点, cx, cy, scale, rot)` 摆放在局部坐标里画好的物件；`mask(pts)` 整幅遮罩，可以用 numpy 相乘相减
- 抖线：`Cartoon(..., boil=2.0)`，每次 `stage()` 用一张新的平滑位移场重描墨线（1–2 像素），颜色和铅笔稿不动；`save()` 用第 0 次描线
- 角度都是逆时针为正（同 PIL）；颜色常量 `INK PAPER PENCIL WHITE RED YELLOW PINK ORANGE`

**等轴 2.5D `Isometric`**：
- 思路：一台正等轴正交相机加一个小光线追踪器。每个部件都是解析实体（平面围成的凸多面体、任意轴向的圆台、可被平面切开的椭球），逐像素求交写进 G-buffer（深度、法线、反照率、材质），画的先后不影响遮挡。同样的实体再从太阳方向画一张阴影图、从正上方画一张记录「柱子顶和底」的高度图，最后统一算光：天空环境光 × AO + 太阳 × N·L × 软阴影（PCSS，半影随遮挡距离变宽）
- 构造：`Isometric(W, H, seed, scale=每格像素, look=(x, y, z), at=(屏幕比例 x, y), sun=(x, y, z), ss=2, floor=-2.4, record=True)`。世界 x 朝屏幕左下、y 朝右下、z 朝上，一格 = 1。`iso(x, y, z)` 世界 → 屏幕；`unproject(sx, sy, z)` 屏幕 → 该高度平面上的世界点（按屏幕位置摆悬浮物）
- 地面：`backdrop(top, bottom, glow, centre)` 浅色渐变和底座下面看不见的地板（接住底座的影子）；`slab(x0, y0, x1, y1, z0, z1, layers)` 漂浮的分层底座；`tiles(levels, heights, colours, soil, gap, paved=(4,))` 倒角地砖（0 海、1 沙、2 草、3 台地、4 铺装）；`sea(shallow, deep, foam, waves)` 海面（岸边浪花、断续第二道浪线、深浅过渡、浪短线、透亮侧壁）；`top_z(x, y)` 取砖面高度；`road()` 带中心虚线的路；`path(cells)` 石板
- 基本体：`box(x0, y0, z0, x1, y1, z1, colour, side, bevel)` 倒角盒子；`obox(centre, size, yaw, pitch, roll)`；`prism(pts, z0, z1)`；`convex([(normal, d)], lo, hi)`；`cylinder(x, y, z0, z1, r, r1=None)`（给 r1 是圆锥 / 圆台）；`tube(p0, p1, r)`；`ellipsoid(centre, radii, yaw, pitch, roll, clip=[(normal, d)])`、`sphere()`、`dome()`。都接受 `paint(P, n, tag)`（按世界坐标上色：砖缝、土层、瓦行、百叶、电池片、卡面文字）、`mat='matte'|'water'|'glass'|'soft'|'gloss'|'card'`、`cast=`（投不投影）、`ao=`（进不进高度图：悬浮物和细线都关掉）
- 建筑：`building(x0, y0, x1, y1, z, h, wall, roof='gable'|'hip'|'shed'|'flat', roof_colour, axis, windows=(行, +x 墙几扇, +y 墙几扇), door=('+x', 位置), trim)`；`roof()`；`window(x, y, z, w, h, facing)`（白框、十字棂、斜向天光、窗台）；`door()`；`sign(x, y, z, w, h, '字', facing)`
- 自然与道具：`tree(x, y, z, size, kind='round'|'pine'|'poplar'|'bush', flowers=)`、`rock()`、`cloud()` 平底云、`windmill(x, y, z, h, yaw, spin)`、`windsock()`、`dish()` 卫星天线、`solar_panel()`、`fence(pts, z, h, closed)`、`pier()`、`boat()`、`balloon()`
- 信息图：`card(x, y, z, w, h, facing='+x', title, tag, value, unit, note, series, icon='wind'|'temp'|'rain'|'balloon'|'sun', anchor=(x, y, z), accent)` 竖在空中的数据卡（文字印在等轴平面上，带细引线和锚点）；`compass(x, y, z, r, north)` 平躺在地面上的指北针；`text()`、`rule()`、`dot()` 平面排版叠在最上层
- 光：太阳从左后上方来，顶面最亮，+x 面（左下）次之，+y 面（右下）只吃天光；`sun_c / sky_c / hor_c / gnd_c`、`soft`、`pen`（最小 / 最大半影）可调。不要霓虹发光、泛光和描边

**单线画 `LineArt`**：
- 思路：整幅画是一条路径。先把各个形状做成点列，再 `chain()` 按作画顺序串成一条线；线只栅格化一次成「时间图」（每个子像素记住笔第一次经过时走了多少像素），画到哪一步就是 `时间 <= s`
- 底：`backdrop('night'|'cream')`：深蓝丝绒底（中间亮、细颗粒）或奶油纸，同时设定默认线色（金 / 墨）和点睛色（琥珀 / 朱红）
- 形状（静态方法，返回点列）：`smooth(控制点)` 样条、`poly(点, r, sharp=(下标,))` 圆角折线、`arc(cx, cy, rx, ry, a0, a1)`、`scallop(cx, cy, r, a0, a1, bumps, depth)` 树冠灌木的扇贝边、`place(点, 原点, angle, scale)` 局部坐标摆放、`curl(P, s, r, span, side, aspect)` 在路径第 s 像素处插一个翻圈、`retrace(点)` 原路去再原路回
- 路径：`chain([(名字, 点列), ...])` 返回 `(P, marks)`，断开处自动用切线连续的三次曲线接上；`trim(P, s0, s1)` 按长度裁剪；`locate(P, (x, y))` 最近点的长度；`at(P, s)` 取点和方向；`length(P)`
- 画线：`line(P, width, pressure=[(s0, s1, 倍数)], sheen, glow, hot)`：起笔轻、收笔长尖、压力缓慢起伏、急转处变粗、原路折返处提笔收尖；深色底上是随角度变亮、只带一点柔光的金线
- 动画：`draw_to(s 或 marks 名字)` 移动笔头，没画完时笔头带光点、刚画的一段更亮；`stage(name)`
- 点睛：`accent(遮罩, 颜色, glow, warm)`，遮罩用 `rect()`、`disc()`；深色底上会发光，并把附近的线染暖
- 文字：`text(s, x, y, size, colour, font='display', spacing)`（Didot 类衬线，中文自动换细宋体）、`text_width()`、`hairline()` 细装饰线
- 颜色常量 `GOLD GOLD_HI GOLD_LO AMBER VERMILION NIGHT CREAM INK`；`save('x.jpg')` 默认 quality 88、4:4:4

**柔光 3D `Soft3D`**：
- 真 3D：`Soft3D(W, H, seed, eye, target, fov)` 针孔相机，世界坐标 X 右、Y 上、Z 远离镜头；每个像素一条光线，numpy 在 CPU 上算
- 球海 `ball_field(x0, x1, z0, z1, r, gap, colours, weights, mat)`：方格上成千上万颗球，光线逐格查找（DDA），每格只测一颗球，十万颗也不慢；`tint_balls(x, z, radius, colours, chance)` 局部换色；`floor(颜色)` 球缝里看到的地板
- 主体（有向距离场，只在自己的包围盒里步进）：`text(s, at, size, depth, colour, mat, yaw, spacing, bob, roll, turn, dot)` 鼓鼓的挤出字（字形→精确距离变换→挤出、整圈倒圆、再吹胀；`dot=颜色` 把 i/j 的点换成一颗球；返回 {'heroes', 'dots', 'centre'}）；`rbox()` 圆角盒、`capsule()` 胶囊、`cylinder()` 圆角圆柱、`torus()` 圆环
- `part(heap, reach, pile, pile_top)`：主体从球海里顶出来，被挤开的球落进最近的空窝、堆在脚边（pile 是被挤开球数的倍数，pile_top 是堆的最高高度，别让它挡住字的下半截），周围的球海微微隆起
- 散球：`ball(x, y, z, r, 颜色)` 指定位置；`drop(x, z, r, 颜色, roll)` 从上方落下碰到东西为止，再往低处滚进窝里（roll=0 停在落点，比如骑在字肩上）
- 灯光：`sky(top, horizon, strength, haze, haze_start)` 天光穹顶（背景渐变、地面反光、远处雾）；`key(azimuth, elevation, strength, size)` 大柔光箱主光，size 越大影子越软；`rim()` 轮廓光；`softbox()` 只出现在反光里的灯片。方位角从镜头算：0 从相机身后，−90 左，+90 右，180 主体背后
- 材质 `mat=`：candy（清漆糖果，锐利灯片高光）、satin（缎面小球）、jelly、matte、pearl；缝隙和阴影变深变饱和而不发灰
- `lens(focus, aperture)` 景深（focus 可传 text() 的返回值或一个点，最好和相机一起先设）；`film(bloom, vignette, grain)`
- `save(path, stages_dir, ss=1.5)` 成片超采样；`stage(name)` 是当前场景的真实预览渲染，还没调用 sky() 时是灰色白模

**形变动画 `Morph`**：
- 思路：每样东西都是**一条**闭合轮廓；两条轮廓重采样成同样点数（默认 `Morph.N = 256`）、统一绕向、对齐起点，再逐点插值，就是形变；背景色和形状颜色跟着切换
- 形状库 `shape(name, cx, cy, size, rot, flip, stretch)`：`SHAPES` 有 circle / square / triangle / star / heart / drop / cloud / snowflake / mountain / river / wave / sun / moon / leaf / bird / fish / pin / house；`union([('circle', x, y, r), ('line', 点列, 宽), ('poly', 点列), ('sub', 图元)], cx, cy, size)` 用图元拼出自己的形状，自动描出外轮廓
- 几何：`resample(P, n)` 按弧长等距重采样；`normalise(P)` 顺时针、从正上方起；`align(A, B)` 统一绕向并用 FFT 找最佳起点；`chain([...])` 整串依次对齐；`ease(t, 'inout'|'sine'|'quad'|'in'|'out'|'back'|'expo'|'linear')`；`tween(A, B, s, at=, stretch=, direction=, spin=, scale=)` 轮廓绕质心插值、质心单独走运动路径，stretch 是沿运动方向的挤压拉伸；`at(keys, T)` 整串关键帧在全局时间 T 的轮廓（逐帧做真动画用）；`mix(c0, c1, t)` 在 OKLab 里混色（蓝到黄不发灰）
- 背景：`paper(颜色)`；`panel(x0, y0, x1, y1, 颜色, ink=)` 一块纯色面板，ink 是画在这块面板上的残影和线条默认用的颜色；`wipe(cx, cy, r, 颜色, ink, clip_box)` 定格的圆形转场
- 形状层：`fill(P, 颜色, alpha, clip=另一轮廓, half=((x0, y0), (x1, y1)))`，half 只填直线右侧，用来做两色折面；`outline(P, 颜色, width, dash=(实, 虚))`；`stroke(点列, 颜色, width)` 圆头线（高光、水纹、热气）；`dot()`
- 定格动画：`ghost(P, fill, fill_alpha, line_alpha, width)` 洋葱皮残影，线色为 None 时取下面面板的 ink，跨面板自动换色；`points(P, every)` 标出对应点；`links(A, B, every)` 对应点连线；`path(点列)` 过质心的平滑路径，`along(路径, u)` 取点和方向；`trail(路径, dash=)` 运动轨迹；`chevron()` 方向箭头；`streaks()` 速度线
- 时间轴：`diamond(x, y, r, fill)` 关键帧菱形；`ease_curve(x0, y0, x1, y1, kind, ticks=帧时间)` 一段缓动曲线，带帧点和虚线投影
- 文字 `text(s, x, y, size, 颜色, font='sans'|'display'|'mono'|'mono_bold'|'cjk'|'cjk_bold', anchor='l'|'m'|'r', spacing, alpha)`：y 是基线，中西文自动换字体，返回宽度；`text_width()` 量宽度
- 坐标都是像素、y 向下；角度逆时针为正

**报刊拼贴 `NewsCollage`**：
- 思路：每样东西都是「先印好、再撕或剪、最后粘上去」的一张纸 `Sheet`；老照片不是贴图，而是 `Photo` 用高度图布光渲染出来，再印成网点
- 底板：`board()` 牛皮纸（云状纸浆、深浅短纤维、树皮碎屑）
- 纸片：`sheet(w, h, 颜色)` 返回 `Sheet`，可用 `text()`、`block(…, minus=文字遮罩)` 反白字、`ink()`、`rule()`；`tear('rtb', depth, rim)` 手撕（边线游走、露出白色纸芯、飞出纤维），其余边算剪刀剪；`cut_rect()` 歪一点的剪刀四边形；`cut(pts)`；`wrinkle()` 浆糊起皱；`age()` 泛黄和霉斑
- 报纸：`newsprint(w, h, columns, size, headline, picture, ad)` 返回一整版假报纸（伪词栏、刊头线、大标题、导语、小标题、栏线、框线广告、网点小照片、背面透印），接着 `tear()`
- 老照片：在 `Photo(w, h)` 上搭物件：`disc()`、`dome(…, rot, cut)`（钟铃、球）、`ring()`（表圈）、`rod()`、`poly()`（指针）、`gear(r, teeth, spokes, pinion)`、`spiral(r0, r1, turns, flare)`（发条、游丝）、`screw()`；`text()` / `lines()` 印在表面的字和刻度；`glare()` 玻璃反光。z 是底座高度，height 是自身厚度，albedo / metal / gloss 是材质
- 印成网点：`print_photo(photo, cell, angle, ink)` 显影并印成网点，返回 Sheet；`s.cutout(margin, centre)` 沿轮廓用剪刀剪下；`s.split(p0, p1)` 一剪两半
- 粘贴：`paste(sheet, cx, cy, rot, lift)` 返回 Frame，`f.pt(lx, ly)` 把局部坐标换成画面坐标；`disc(cx, cy, r, 颜色)` 剪刀剪的色纸圆
- 字：`ransom('拆开看看', x, y, size, faces=[…], styles=[…])` 勒索信拼贴字，返回 [(Frame, 字)]；`clipping(字, size, face, paper, block, fg, extra)` 单个剪字，extra 可选 'text'（带邻字）或 'tint'（网点底）；`label(文字, x, y, size, face, fg, bg, block)` 剪下的一条印刷字
- 其他：`tape(cx, cy, 长, rot)` 美纹纸胶带；`stamp(cx, cy, [(字, 字号)], shape='box'|'round', ring=环形字)` 橡皮章；`pen(pts, dash=(实, 虚), dot)` 墨线引线
- 字体：news / news_bold / news_italic / serif_bold / slab / clarendon / didone / poster / futura / grotesk / typewriter(_bold) / cjk_song / cjk_hei / cjk_round / cjk_kai；缺字自动换中文黑体
- 颜色常量 `INK BLACK RED MUSTARD KRAFT NEWS PAPER TAPE`；rot 逆时针为正

**弥散玻璃 `Aurora`**：
- 思路：一块明亮的「光屏」（弥散渐变）上面悬着几片真的磨砂玻璃。透过玻璃看到的是它下面**真实像素**的高斯模糊（背景、小球、后面的卡片和字都算），再蒙一层白纱，界面印在玻璃上。先画的在后面，后画的卡片会把前面画好的卡片连字一起模糊
- 背景：`backdrop(base, blobs=[(x, y, rx, ry, 颜色, 强度)], ribbons=[(点列, 宽, 颜色, 强度)], warp, grain)` 网格渐变：色团按权重在 OKLab 里混色，坐标扭曲成不规则形状，光带沿样条走，自带细颗粒；`sparkles(n)` 零星光点；`orb(cx, cy, r, (亮, 中, 暗))` 光泽小球：虹彩色阶、菲涅尔边缘映出背景色、高光、落在背景上的彩色投影
- 玻璃：`glass(x0, y0, x1, y1, radius, blur, tint, sat, shadow, elevation, bevel, rim, sheen)` 返回 `Card`（x0 y0 x1 y1 w h cx cy r）。blur 是磨砂程度（约 20–30）；tint 是白纱（约 0.24，近光源一侧厚）；sat 是透过来的颜色饱和度（约 1.5）；bevel 是边缘斜面，向外折射，各色通道偏移不同，带很淡的色散；rim 是朝光边的高光描边；阴影只落在卡片外，颜色取自下面的背景。`pill()` 是小玻璃胶囊（按钮、提醒、高亮行，玻璃叠玻璃），`cloud(cx, cy, w)` 是玻璃云
- 形状（带符号距离场，1 px 解析抗锯齿）：`rrect()`、`circle(ring=线宽)`、`line(点列, smooth)`，都可以传 `grad=色阶, angle=`；`divider()` 是蚀刻细线
- 控件：`toggle(x, y, on)`、`slider(x0, x1, y, value)`、`knob()`、`ring(cx, cy, r, width, frac)`（从 12 点顺时针，锥形渐变、圆头、光晕、末端白点）、`check(cx, cy, r, 'done'|'now'|'todo')`、`bars(x0, y0, x1, y1, values, labels=, highlight=)`、`spark(x0, y0, x1, y1, values, dots=)`（返回各点坐标）、`sun()`、`app_icon(x, y, size, grad, glyph)`
- 文字 `text(s, x, y, size, fill, weight='light'|'regular'|'medium'|'semibold'|'bold', anchor, alpha, spacing, grad)`：西文用 SF（按字号调光学尺寸），中文用苹方，自动分段；anchor 第二个字母 s 基线、m 居中、t 顶、b 底；`text_width()` 量宽度
- 颜色：`INK` 深靛文字；渐变色阶 `WARM`（杏→粉→紫）、`COOL`（天蓝→长春花→紫）、`MINT`；`ramp(t, stops)`、`mix()` 在 OKLab 里插值。一种渐变只代表一件事
- `save('x.jpg')` 默认 quality 88、4:4:4 色度

**包豪斯几何 `Bauhaus`**：
- 思路：画面是一张丝网印刷的印张，每种颜色一块网版，先浅后深逐版刮印；同一色版上的所有东西共享这块版的套准误差（平移加极小旋转），所以色块和黑线相接处会露出一丝纸白或压出一道深边
- 纸：`paper(colour, margin, module)` 奶油色未涂布纸（云状纸浆、短纤维、纸屑、纸齿、微微不平的受光），同时设定设计区和网格模数；`at(col, row)` 网格坐标转像素；`grid()` 用浅灰色版印构成网格
- 遮罩（全画布、抗锯齿，可以相加相减）：`circle()`、`ring()`、`sector(cx, cy, r, a0, a1)` 半圆和四分之一圆、`arc()`、`rect(x0, y0, x1, y1, rot)`、`bar(x0, y0, x1, y1, width, cap='butt'|'square'|'round')` 粗黑条和细线、`poly()`、`triangle(x0, x1, base_y)`（默认正三角）
- 印刷：`pull(mask, ink, knock, edge, density, opacity)` 刮一版：墨膜顺刮板方向有条纹、行程末端变薄，薄处露出纸齿坑点，网版灰尘留针孔，版边有网目锯齿、边缘略积墨；墨半透明（黄最透、黑最不透），叠印变深。`knock` 是挖空遮罩，`edge=0` 让细线保持干净
- 文字：`text(s, x, y, size, ink, font, anchor, spacing, rot, weight)` 直接印；`text_mask()` 取遮罩用来挖空；font 用 geo（Futura Bold）、geo_book、geo_cond（窄体特粗）、cjk（粗黑体）、cjk_book，中西文逐字换字体；`text_width()` 量宽度
- 印刷标记：`marks(targets, crop, bar, inks, overprints)` 套准十字、四角裁切线、色标条。登记后每块色版第一次刮印时自动印上自己那一份，所以十字会叠成几色错开的样子
- 印完之后：`pencil(s, x, y, size)` 页边铅笔版号，石墨只挂在纸齿凸起上
- 颜色常量 `YELLOW RED BLUE BLACK`，纸色 `PAPER`，网格色 `TINT`；角度逆时针为正，0° 指 3 点钟；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**复古 Synthwave `Synthwave`**：
- 思路：
  - 一台水平针孔相机看向无限平地（X 右、Y 上、Z 向前，单位米），颜色缓冲从远到近画；
  - 会发光的东西同时写进发光缓冲，后画的不透明物会挡掉身后的光；
  - 最后四个半径泛光，过曝的通道溢向白色，成片再「过一遍录像带」
- 构造：`Synthwave(W, H, seed, horizon=610, vp_x=1060, focal=1100, eye=3.5, record=True)`；相机工具 `project(X, Y, Z)`、`ground_row(Z)`
- 天空：`sky(stops, ground)` 暮色渐变，地平线下先铺没点亮的地面；`stars(n, bright)` 越近地平线越稀，最亮的带四角星芒；`streaks([(y, x0, x1, 厚)])` 底边被照亮的细条云
- `sun(x, y, r, bands=8, band_top, gaps=(0.2, 0.7), level, gain)`：黄→橙→粉渐变落日，横条切口越往下越厚，切口是真缺口；在地平线处截断
- 远景：
  - `mountains(x0, x1, z0, z1, height, cell, taper, edge=(MAGENTA, CYAN))`：世界坐标里的抖动网格高度场，三角面暗色平涂，边线从山脚品红渐变到山脊青色；
  - `skyline(X0, X1, Z, heights, widths, tall=(X, 高), windows)`：远处小城剪影、窗光、航空红灯
- 地面：
  - `floor(colour, spacing, width, fog, scroll, x_range)`：霓虹网格，逐像素解析线宽，远处换成平均值防摩尔纹，带粉色地雾和太阳光带；
  - `sea(coast, bar, spread, sky, glitter, stretch)`：X < coast 一侧的海，倒影碎成一条条光带；
  - `road(x0, x1, dash)`：光滑路面加霓虹边线和中心虚线；
  - `neon_line(X, colour, width, dash)`：地上任意一条纵向霓虹线（海岸线）
- 物件：
  - `palm(X, Z, height, lean, fronds)`：棕榈剪影，环节树干、仰角不一的叶柄、下垂小叶、椰子、朝太阳一侧的轮廓光；
  - `car(X, Z)`：背影跑车，整条尾灯和路面上的红色倒影
- 字：
  - `chrome_text(s, x, y, size, depth, glints=(字序号...))`：镀铬大字，深色描边、阶梯挤出、发光浅边，上映天空、下映地面，中间一道锐利地平线，左上打光的倒角和四角星闪；
  - `glint(x, y, length)`：单独一个四角星闪；
  - `neon_script(s, x, y, size, colour, rot)`：霓虹手写体；
  - `caption(s, x, y, size, colour, rules)`：字距拉开的小字加两侧细线
- 录像带：
  - `osd(s, x, y, px, anchor)`：5×7 块字的录像机屏显（PLAY ▶、日期）；
  - `vhs(bleed, shift_px, jitter, noise, scan, tracking, head)`：只作用于成片，包括 YIQ 色度模糊右移、重影振铃、逐行抖动、一条跟踪噪带、底部磁头噪声、掉磁白线、扫描线、黑位抬升；阶段快照保持干净
- 颜色常量 `MAGENTA CYAN VIOLET ORANGE YELLOW PINK RED WHITE`；字体用 `synth_font('chrome'|'script'|'caption', size)` 找系统字体（Avenir Next Heavy Italic / Brush Script / 冬青黑体），可用 `INKPAINT_FONT_CHROME` 等指定；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**拼豆 `Perler`**：
- 思路：整张桌面是高度图，每样东西都是实体（豆是带孔短管、钉板带钉子、纸有厚度），相机略向后仰：每个屏幕像素沿自己那一列找最近的表面，所以豆子露一条侧壁、缝里露出后排侧面、孔里看得到内壁和钉子。光是左上一个大灯箱：局部点光、沿高度图步进的软阴影、天光 AO，镜面反射里看得到灯箱（亮面上是锐利的弧，熔化后变成蜡质光泽）；线性空间着色，`ss` 倍超采样
- 构造：`Perler(W, H, seed, pitch=22, tilt=0.32, ss=2, light=(x, y, z))`；pitch 是珠距（像素），tilt 是后仰量
- 桌面与纸：`desk(颜色, kind='wood'|'mat')`；`chart(rows, key, cx, cy, cell, angle, title, subtitle, number, names, done)` 印好的图纸（格子、符号、行列号、每 5 格粗线、图例带颗数），返回对象的 `.done.update('RD')` 用铅笔勾掉已摆的颜色；`tape(字, cx, cy, angle, size, sub, badge='1')` 美纹纸标签；`sheet(draw, cx, cy, angle, thick, translucency, drape, cut, curl, bump)` 任意薄片
- 钉板与豆：`pegboard(cx, cy, cols, rows, shape='square'|'circle'|'hexagon', colour='clear'|'white'|颜色, angle)` 返回 `Board`（钉子都在方格点上，`xy(row, col)` 取钉子位置）；`place(board, rows, key, at=(行, 列), only='RDP', keep=lambda r, c: ...)` 按文字图样插豆，可按颜色、按区域分批；key 的值用 `BEADS` 色名（含 `pearl` 珠光、`clear` 透明、`glow` 夜光）或 '#rrggbb'
- 熨烫：`ironing_paper(cx, cy, w, h, angle, cut=((x, y), (nx, ny)), curl, wrinkle)` 盖在豆上的半透明熨烫纸，cut 表示揭开一半（卷边），wrinkle 是热皱；`iron(board, melt, where)`：0.4 半熔，0.7 成品，0.8 全平；`lift_off(board)` 取下成品
- 道具：`tray(cx, cy, [[色, ...], ...], cell, angle, fill)` 分色收纳盒（每格一堆豆）；`spill(cx, cy, colours, n, spread, standing)` 散豆；`bead(x, y, 颜色, pose='stand'|'side', angle, tilt)`；`tweezers(tip, angle, length, lift, rise, holding='sky', grip)` 悬空的镊子，尖端夹一颗豆，自带投影
- 层次与动画：`on_top(*objs)` 提到最上层，`remove(obj)` 拿走；`stage(name)` 只存快照，`save(path, stages_dir)` 时才按 1× 渲染各阶段
- 颜色常量 `BEADS`；角度逆时针为正；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**岩画 `Petroglyph`**：
- 思路：岩画不是画上去的，是把岩面的深色皮（沙漠漆）敲掉。一切都是高度（px）和颜色场，最后用左上一盏低角度侧光照亮：法线明暗、沿光线步进的投影（每个凹坑左上壁暗、右下壁亮）、凹处的 AO
- 构造：`Petroglyph(W, H, seed, light=(-0.62, -0.5, 0.6))`
- 岩石：
  - `rock(colour, relief, bedding, grain)`：砂岩高度图（大起伏、时有时无的层理、砂粒、浅凹坑）和漆下的石色；
  - `ledge(y, drop=34)`：一道折线岩檐，下面的岩面退后一个台阶、漆更薄；
  - `varnish(strength, streaks, top, scour, patches)`：沙漠漆，近乎均匀的深色漆膜 + 清晰的蓝黑流痕 + 浅色流痕，顶部更厚、近地面被风沙磨薄；
  - `fracture(pts, width, depth, seep, branches)`：裂缝，锯齿窄槽、圆肩、分叉，往下渗出深色漆痕
- 起稿：`draft()` 返回 `Draft`（`stroke(pts, w, end_w)`、`fill(pts)`、`dot`、`ring`、`add(mask)`）；现成图形都返回 Draft，可用 `into=` 合成一个：
  - `bighorn(x, y, size, facing, kind='ram'|'ewe'|'lamb', gait, rot)` 大角羊（扭转透视的角）；
  - `hunter(x, y, size, facing, weapon='bow'|'atlatl')` 拉弓 / 举投矛器的猎人；
  - `sun_spiral(x, y, r, turns, rays)`、`crescent(x, y, r, thick, rot)`、`concentric(x, y, r, rings)` 水源；
  - `hand(x, y, size, rot, outline, spread)`、`hoofprints(pts, size, every)` 偶蹄印、`meander(pts, width, smooth)` 任意线
- 凿与磨：
  - `peck(glyph, density, size, depth, age, scatter)`：用成百上千个不规则凹坑把图形敲出来，打穿漆层、碾白砂粒；
  - `abrade(pts, width, depth, age)`：磨出 V 形槽（比凿点光滑、发亮，带顺向擦痕）；
  - `abrade_tally(x, y, counts, gap, length, width, row_gap, slant, age, strike_every)`：成排计日刻痕
- 年代：`age` 0 新凿（亮、锐），0.3 几百年，0.6–0.8 几乎被漆重新盖住；新图凿在旧图上自然更亮、更深
- 风化：`spall(pts, depth, impact, age)` 剥落（小贝壳弧唇口、台阶投影、贝壳状波纹、鲜橙石面，带走上面的图）；`lichen(x, y, r, kind='green'|'orange'|'grey', n)` 壳状地衣
- 顺序：rock → ledge → varnish → fracture → 旧图（age 大）→ 新图 → spall → lichen
- 颜色常量 `STONE SCAR CRUSH VARNISH_FE VARNISH_MN LICHEN`；`stage(name)` 立即合成快照；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**古埃及墓室壁画 `TombPainting`**：
- 思路：先「声明」整面墙上的东西，再按古代画工的工序一遍遍画：`wall()` 草筋泥上抹一层石膏灰泥 → `grid(box, cell, base)` 红赭石弹线的比例格（一格是人物的一个比例单位，脚底到发际 18 格）、`guide(p0, p1)` 分栏线 → `sketch()` 红稿 → `ground(颜色)` 绕开人物刷底色 → `colour([颜料…])` 一罐颜料画一遍、`ink()` 最后勾线 → `colour(layer='text')`、`ink(layer='text')` 写字 → `age()`。每一层都留在内存里，剥落时按层露出来
- 部件：`part(pts 或 [多边形…], 颜料, paths=, ink=, width=, z=, alpha=, clip=, layer=)`；颜料名见 `PIGMENTS`（skin 男子红赭、skin_f 女子黄赭、linen、white、yellow 雌黄、blue 埃及蓝、lblue、green、dkgreen、lgreen、red、brown、ochre、black）；按逐像素 z 图叠放，所以按颜料分批画也不会叠错；勾线被上层遮住的部分自动不画
- 人物：`figure(x, 地线y, 身高, pose, facing, sex='m'|'f', wig='short'|'long'|'woman'|'cap', dress='kilt'|'long'|'loin'|'dress', collar)`；`POSES` 有 stand / walk / staff / plough / reap / sow / hoe / glean / carry / hold / scoop / squat，任一关键字都可覆盖（髋 hip、前倾 lean、膝 kf/kb、踝 af/ab、腕 wf/wb、肘弯向 bf/bb、手型 hf/hb、`turn`、脚镜像 `mb`）；返回手、腕、肩、耳的画面坐标和 z（`hand_f`、`z_hand_b`…），`S((x, y))` 把比例单位换成画面坐标，用来挂道具
- 道具：`staff()`、`sickle()`、`hoe(fig)`、`rod()`、`basket(full=)`、`sack(lean=)`、`heap()`、`measure(tilt=)`、`grain_stream()`、`scoop()`、`papyrus()`、`palette()`；拿在手里的东西 z 给 `fig['z_hand_x'] - 0.01`（从拳头后面穿过）
- 动植物：`ox(x, 地线, 长度, facing, colour, patches)` 长角牛（远侧两条腿错开一步，四条腿都看得见），返回 `poll`（架轭处）；`wheat(x0, x1, 地线, 顶, stubble=[(xa, xb)], grab=[(拳x, 拳y, (xa, xb))])` 麦田、留茬和被攥住的麦秆；`sheaf()`、`tree(waterskin=(dx, 长))`、`papyrus_clump()`
- 边饰：`block_border()` 色块边框、`kheker()` 凯凯尔饰带、`band(x0, x1, y, [(颜料, 高), ('rule', 2), …])` 分栏底带、`river()` 尼罗河
- 文字：`column(x0, y0, x1, y1, facing, n, seed)` 按方块（quadrat）排一栏伪象形文字（高窄的并排、扁的上下叠）；`glyph(名字, x, y, 字号, facing)` 单个符号（`SIGNS` 里 23 个，另有 hoe、stroke、heel、coil）；`numerals(12, x, y, 字号)` 象形数字
- 岁月：`age(losses=[(x, y, rx, ry)], zones=[(x, y, r)], cracks, flake, soot, fade, salt, tide, wear_amt)`：成簇剥落（蓝色和裂缝边先掉）、剥到灰泥露出红格红稿、颜料磨薄、灰泥脱落到草筋泥（断续白边、台阶、投影）、裂缝、埃及蓝发灰绿、顶部烟熏、墙脚潮痕和盐霜、蝇斑、灯光暗角
- `stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**罗马马赛克 `Mosaic`**：
- 思路：工匠先画一张谁也看不见的「底稿」（cartoon，平涂和渐变的颜色图），再一块块铺石子：每块石子取自己脚下底稿的平均色，从石料盒 `STONES` 里挑最接近的一种（先比色相再比亮度，带一点抖动，色阶交界像工匠混用两种石子）。石子的排向（andamento）就是画法：每种铺法都沿某个标量场（距离场或坐标）的等值线走一排（marching squares），把一排切成整数块，所以每块略长略短；弯处每块自动成小楔形，急转角处断开换一块；靠近图形脊线的石子停在距离场的脊上，两侧在中线会合。后铺的石子大半压在已铺的上面就不要，压一点就「切掉」并留灰缝（先铺的优先）。渲染是 `ss` 倍超采样的高度场：石面微拱、边缘磨圆（每块石子自己的有符号距离做倒角），灰缝更低、带砂，灰浆床再低；左上方一盏斜光，按材质的漫反射 + 高光，每块石子略有倾斜，所以同色石子明暗不一；石子在灰缝里投影、灰缝有 AO
- 构造：`Mosaic(W, H, seed, tile=13, gap=1.8, ss=2, light, bed, grout, stones=None)`；tile 是背景石子边长，gap 是灰缝宽（px）；图形里用更小的石子（size 约 6–8）
- 底稿与起稿：`paint(mask, 颜色)`；`shade(mask, c0, c1, p0, p1, gamma)` 线性渐变（鱼背深、肚白）；`sinopia(mask=… 或 pts=…)` 在湿灰浆上用赭红起稿，没铺到的地方一直看得见（动画第一帧）
- 遮罩：`poly_mask(pts)`、`ellipse(cx, cy, rx, ry, rot)`、`rect()`、`band(pts, w0, w1)` 渐细粗线（触手、船尾柱、浪尖）；`everything()` 已铺的，`free(region)` 还空着的
- 铺石子（按调用顺序，先铺的优先，要保持完整的先铺）：
  - `point(x, y, 颜色, size, 'round'|'square'|'tri', angle)`：单块（眼珠、隔字点）；
  - `line(pts, 颜色=None, size, across)`：沿路径一排（字的笔画、鳍线、桅杆、索具、网线）；颜色 None 时从底稿取色，做触手的中脊；
  - `outline(mask, 'black', rows, size)`：图形内侧的第一排深色轮廓；
  - `fill(mask, size, stones, wrap=True)`：沿轮廓往里一排排铺（opus vermiculatum）；wrap 让石子也绕着已铺的眼睛、鳃线一圈圈排；`figure()` = outline + fill；
  - `halo(region, rows, size, stones, around)`：背景里贴着图形外轮廓的一两圈「光环」；
  - `rows(region, size, angle, wobble, field, stones)`：背景平铺（opus tessellatum）；给 `field`（H×W）就沿它的等值线排，海水用波浪场；
  - `frame(x0, y0, x1, y1, width, size, stones)`：平行于矩形四边的边框排，转角斜接；带宽取排距的整数倍，黑白镶边就和排对齐；
  - `tuck(region, size, small)`：剩下的洞用切小的碎石补上，大洞先补
- 铭文：`letters(文字, x, y, 字高, 颜色)` 罗马大写（A–Y 常用字母，U 写作 V，无 J K W Z），每一笔一排石子，`·` 是三角隔字点；`tabula(x0, y0, x1, y1, [(文字, 字高, 颜色)], ear, frame=('black', 'red'))` 带燕尾耳的铭牌（tabula ansata）：字、黑框、红框、白底横排、红耳
- 岁月（最后做）：`lacuna(mask)` 一片石子脱落，露出旧灰浆床和石子留下的方坑；`crack(pts)` 沉降裂缝（穿过石子和灰缝的黑细线，带凹陷）；`patina()` 灰缝成片积灰、局部失光
- 石料：`STONES` 名字 → (颜色, 材质)，材质 stone（石灰石，哑光、斑驳、麻点）/ marble（纹理、微光）/ glass（smalti 玻璃，饱和、亮、带气泡）/ terracotta；`stones=[…]` 限定这一步能用的石料（天空只用 white / bone / cream，海只用蓝色玻璃）
- 工具函数：`edt(mask)` 跳步泛洪欧氏距离场、`iso_lines(f, step)` 一次求出所有等值线、`maxfilt()`；`STONES MATERIALS LETTERS SINOPIA`
- 动画：`stage(name)` 只记进度，`save(path, stages_dir)` 时按 `stage_ss`（默认 1×）渲染各阶段和收尾帧；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**彩色玻璃花窗 `StainedGlass`**：
- 思路：照玻璃匠的工序——画稿分块 → 选料切玻璃 → grisaille 彩绘、刮白、银染 → 上铅焊接 → 装铁条 → 从室内看日光透进来。颜色全在玻璃里，颜料只有一种棕黑；铅条落在每两块玻璃的交界上
- 构造：`StainedGlass(W, H, seed, record=True, ambient=0.05)`；`stage(name, cartoon=False)`（cartoon=True 出纸上的切线画稿）；`save(path, stages_dir)`
- 石墙：`wall(colour, mortar, course, block)` 错缝方石墙（每块石料深浅不同、斜向凿痕、磨损的棱、凹进的灰缝）；`lancet(cx, top, bottom, width, arch=1, splay, sill, hood)` 开一个尖拱窗洞，返回 `Light`，带斜面窗侧（拱上是放射状楔石缝）、斜窗台、拱上的滴水线脚；`string_course(y, h)` 腰线
- `Light`：`pt(lx, ly)` / `P(点列)` 把局部坐标（原点在拱尖，y 向下）换成画面坐标；`inner(b)` 向内缩 b 的窗形遮罩；`band(b0, b1)` 沿窗边的一圈带（边框、白条）；`outline(b, step)` 沿窗边取点（给边框切块）；`sdf()`；`half(ly, b)` 某高度的半宽
- 玻璃：`glass(遮罩, 颜色或颜色列表, cell, streak, seeds, thick, vary, flashed, aspect, angle, around, spokes, sites, streak_dir)`。颜色是透光时的样子；给 cell 就按 Voronoi 切块，每块从列表里取一种颜色、深浅厚薄各不相同；sites 按给定点切（边框、长条）；aspect / angle 把块拉长；around 绕一点放射切；flashed 是红色套料那种强条纹。后铺的料从先铺的里切出来；太小太窄的碎块自动并进同料的邻块。`cut(点列)` 加一道切线
- 遮罩：`circle()`、`ellipse()`、`poly()`、`blob()`、`branch(点列, 起宽, 止宽)` 渐细的枝
- 彩绘：
  - `trace(点列, width, taper, opacity, clip)` 不透明描线（五官、叶脉、羽毛、细枝），clip 限定只画在某个遮罩里；
  - `matt(遮罩, strength, soft, stipple)` 半透明晕染，带点彩颗粒；`shade(遮罩, offset, strength, clip)` 背光一侧的月牙形 matt；
  - `scratch(点列, width)` / `scratch_mask(遮罩)` 用木签刮掉颜料，让光透出来；
  - `diaper(遮罩, spacing, motif='cross'|'dot'|'ring'|'flake'|'quatrefoil', jitter)` 底纹，默认从一层薄 matt 里刮出，jitter 撒开就是雪花；
  - `stain(遮罩, strength)` 银染：白料变柠檬黄到琥珀，蓝料变绿；
  - `inscribe(字, x, y, size, font='lombardic', scratched)` 题字（Luminari / Herculanum，可用 `INKPAINT_FONT_LOMBARDIC` 指定）
- 上铅与铁件：`lead(width=6, rim=10, solder=True)` 在每条交界上铅（按 H 形铅条打光，焊点更亮更鼓，窗边一圈宽铅）；`crack(点列, mend=True)` 裂片和修补用的细铅条，要在 `lead()` 之前；`saddle_bar(light, y, width)` 横铁条（y 是画面坐标），两端插进石头，扎几处铜丝结，要在 `lead()` 之后
- 光：`weather(grime, pits)` 铅条边和窗下部积灰、部分玻璃的腐蚀麻点；`daylight(strength, spill, halation, sky)` 打开室内光：墙上一层彩色溢光、窗侧斜面靠玻璃处发亮、斜窗台上倒过来的模糊投影、亮玻璃的光晕吃掉一点铅条（蓝色最明显）。`daylight()` 之前墙用固定的中性光，阶段快照之间石墙不变
- 颜色常量 `RUBY BLUE DEEP_BLUE SKY GREEN LEAF SPRING OLIVE GOLD AMBER ORANGE MURREY WHITE PALE BROWN FLESH`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**泥金手抄本 `Illuminated`**：
- 思路：
  - 按作坊顺序作画：打格 → 抄写（红字和首字母留空）→ 朱笔 → 画图 → 贴金 → 上色 → 勾线；
  - 字是一支模拟的宽头鹅毛笔写的：笔尖是一段约 40° 斜握的短线段，笔画就是它扫过的面积，所以粗细随行笔方向变；菱形的头脚和发丝般的连笔都来自笔，不来自字体；
  - 打磨金箔是凸起石膏底上的一面镜子：每个像素按自己的法线（石膏底的鼓面、打孔、金箔接缝、打磨纹）反射相机光线，去查一间左上方有大窗的房间；
  - 壳金是哑光的颗粒；
  - 先贴金后上色，后画的颜料和墨会盖住金。
- 书和皮：
  - `desk()` 胡桃木书桌；
  - `codex(x0, y0, x1, y1, cover, squares, stack, dip)` 摊开的书（皮面封板、书口纸叠、页面在书脊处下陷变暗），返回左右两页的矩形；
  - `flaw(cx, cy, rx, ry, rot)` 羊皮上的天然破洞；
  - `rule(x0, x1, ys, prick_x)` 针孔、每行 x 高处的打格线、上下贯通的边框竖线；
  - `show_through(x0, x1, ys, xh, opacity)` 背面的字透过来。
- 文字：
  - `column(text, x0, x1, y, xh, leading, indent=[(行数, 左边 x)], align, filler)` 排一栏，返回 Block：
    - 标记 `*红字*`（留给朱笔）、`^词`（首字母点红）、`¶` 段落符、`|` 段落结束；
    - 自动长 s / 圆 s、断词加连字号、行尾填充；
    - `7` 写成提罗速记的 et（⁊），`ꝑ` 是 per。
  - `scribe(blk, dip)` 抄写黑字：每隔若干字重新蘸墨，铁胆墨由黑变褐，笔画边缘积墨；
  - `rubricate(blk, blue_first)` 朱红字、首字母点红、红蓝交替的段落符、行尾红锯齿加蓝点；
  - `write(s, x, y, xh, kind, rot, load)` 写一行，返回行尾 x；
  - `arc_text(s, cx, cy, r, at, xh, kind)` 沿圆弧书写；
  - `text_width()` 量宽度；
  - kind 可选 'iron' / 'red' / 'blue' / 'white' / 'diagram'。
- 金和颜料：
  - `gild(mask, cushion)` 红色底料上的凸起打磨金；
  - `punch(pts, r, depth)` 打孔装饰；
  - `shell_gold(mask)` 壳金；
  - `paint(mask, 颜色, mix=(颜色2, 0..1 场), granular)` 蛋彩，边缘积色，石青有颗粒；
  - `wash(mask, 颜色, opacity)` 透明淡彩；
  - `pen(paths, width, kind, dash)` 圆头笔线；
  - `outline(mask, width)` 沿形状描墨边。
- 遮罩：`mask(polys, lines, dots, holes)`、`circle()`、`ring()`、`ellipse()`、`star()`。
- 装饰物件（按作坊顺序调用各自的 `.draw()`、`.gild()`、`.paint()`、`.pen()`）：
  - `initial('Q'|'O', x0, y0, size, body)` 历史化首字母：伦巴第体字身配白线描、打孔金底、字腔里的夜景；
  - `border(path, width, avoid, bounds, seed, every, reach)` 金 / 群青 / 玫瑰色条形边框，递归长出常春藤花枝（金叶、花、金珠、卷须），避开 avoid 矩形；
  - `versal('O', x, y, size, colour, flourish, reach)` 两行高的分裂伦巴第字配红色花笔；
  - `astrolabe(cx, cy, R, lat, rete, rule, star)` 星盘；`.pen(labels=[(字, (x, y), (指向的 x, y))])` 加红色标注；
  - `spheres(cx, cy, R, angles, label_at)` 诸天圆图。
- 收尾和输出：
  - `age(foxing, soil, flakes, halo)` 六百年：铁胆墨晕、狐斑、翻页手印、金箔剥落露出红色底料、石青崩口；
  - `stage(name)`、`save(path, stages_dir)`。
- 颜色常量 `VELLUM INK RED AZURE ROSE GREEN WHITE SILVER LEAD OCHRE BOLE`；角度逆时针为正；`save('x.jpg')` 默认 quality 88、4:4:4 色度。

**达·芬奇手稿 `Codex`**：
- 纸：`sheet(tone, mount, margin, laid, chain, lost_corner='br', fold=x, stains=[(x, y, r)], foxing, edges, age)`：裱在卡纸上的帘纹碎布纸（帘纹、链线、纤维、纸齿），自带边缘氧化、缺角、泛黄云斑、霉斑、水渍潮线、可选旧折痕、手翻处的污渍；`show_through(x, y, width, lines)` 背面的字透过纸，左右反过来（所以是正着读的）
- 铁胆墨水和鹅毛笔：`quill(pts, width, ink)` / `quills([...])`，笔宽随宽笔尖方向变、落笔重收笔尖；笔里的墨会用完：越画越淡，再蘸一次又变浓，偶尔在落笔处积一个小墨珠；`contour(pts, searching=2)` 先轻轻找两三遍再定线（修改痕）；`ruled(p0, p1)` 靠尺直线；`dotted(pts, dot_dash=True)` 虚线 / 点划线（轴线）；`arrow(pts)`
- 排线：`hatch(mask, shade, angle=55, spacing, levels=(…), cross=0.76, cross_angle=-38, length, origin, medium='ink'|'chalk')`。55° 是左撇子的「\」；shade 0 亮 1 暗，每多一级 level 就在两线之间再插一层，超过 cross 加一层「/」交叉；按「排」下笔。明暗场：`between(a0, a1, b0, b1)`（从一条线到另一条线 0→1，蒙皮、圆杆）、`radial_shade(cx, cy, r)`；遮罩：`poly_mask(pts)`、`disc_mask(cx, cy, r)`、`Codex.arc(cx, cy, r, a0, a1)` 取弧上的点
- 红粉笔和铅笔：`sanguine(pts, width, pressure)` / `sanguines([...])` 只挂在纸齿上，`rub(mask, amount)` 用手指揉开；`leadpoint(pts)` 淡灰的铅笔起稿
- 尖笔和圆规：`incise(pts)` 无色的刻痕（侧光下一边亮一边暗），`compass(cx, cy, r, a0, a1)` 刻圆弧并在圆心留针孔，`prick(x, y)`
- 常画的东西：`cane(p0, p1, w0, w1, bend, lashings)` 两条线画的藤杆 / 木杆加绑绳，返回轮廓用来挖掉排线；`feather(base, angle, length, width, medium, side, overlapped)` 羽毛（返回轮廓、羽轴、宽羽片外缘）；`bird(x, y, size, phase)` 背视的小飞鸟，phase 从 π/2（翅膀最高）到 −π/2（最低）
- 镜像手写：`write(文本或行列表, x, y, width, size, mirror=True, max_lines)`，mirror 时 x 是右边距、每行从右往左写、左边参差；`prose(n)` 生成意大利语伪文；`label('a', x, y)` 字母标注（`mirror=False` 写正字，如收藏者的页码）
- 意外：`blot(x, y, r)` 带深色潮线和小溅点的墨点、`spatter(x, y, n)`、`strike(x0, y0, x1, y1)` 划掉废稿
- 机械零件（笔绘渲染）：`Camera(cx, cy, scale, azim, elev)` 正交相机；零件 `gear(r, teeth, depth, h, hub)`、`lantern(r, h, staves)` 灯笼齿轮、`crown(r, h, teeth)` 冠齿轮、`crank(arm, r_axle, handle_len, handle_r)`、`pulley(r, h)`、`cylinder()`、`box()`、`extrude()`；`.place(origin, axis, spin)` 摆放、`.named('wheel')` 命名表面组、`merge(...)` 合成一个网格；`solid(mesh, cam, hatch=dict(...), hatch_groups={'wheel.face': dict(...) 或 None})`：z-buffer 去掉被挡住的线、先擦掉身后的墨、按每个面背光的程度排线、只描轮廓 / 折边 / 开口边并连成长笔画；分解图就是把零件沿轴拉开再画点划线
- 颜色常量 `INK_DARK INK_LIGHT SANGUINE LEADPOINT PAPER MOUNT`；字体自动找 Apple Chancery / URW Chancery（Linux）/ Segoe Script（Windows），可用 `INKPAINT_FONT_CHANCERY` 指定；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**剪影 `Silhouette`**：
- 思路：剪影是黑纸用小剪刀剪出来的，贴在象牙白卡纸上，用薄金粉描几笔，装进玻璃椭圆金框挂到墙上。墙纸、金框、玻璃都按真实材料做，左上方一扇窗照亮整面墙
- 墙：`wallpaper(ground, ink, tint, period, repeat, length)` 木版印花条纹墙纸（刷涂的胶彩底、两块印版、错版、干斑、定位针点、每幅纸对花略错、拼纸接缝）；`picture_rail(y, h)` 挂镜线；`chair_rail(y, h, dado)` 护墙线和下面的墙裙
- 框：`frame(cx, cy, rx, ry, width, pearls, twist, eglomise, card, hook, cord, spread)` 返回 `Frame`。按线脚剖面建高度图（内口圆珠、凹槽、一圈珠饰、大圆脚、平条、外圆边；`twist` 把大圆脚做成绳纹），金面反射房间环境（窗亮、屋暗、地黑），所以出现一圈圈明暗环；有金箔方块接缝，棱顶磨出红色底漆，凹处积灰；墙上有接触阴影和柔影。`hook=True` 从挂镜线铜钩垂下两股丝绳（V 形，伸进框后面）；卡纸边缘泛黄、带霉斑；`eglomise` 是玻璃背面的黑底金线圈
- 剪纸：`sheet(f, at, scale, flip, warp)` 返回 `Sheet`，坐标用设计单位（px = at + scale × 点）；`warp` 是一个函数，可以整体改比例（头大一点、身子短一点）：
  - 贴平的主体：`shape(pts)` 主轮廓（只有一丝影子，边缘重采样成一小段一小段剪口）、`disc(x, y, r)`；`hole(pts)` 剪空，露出卡纸（眼睛、腿间、蝴蝶结的缝）
  - 单独剪下、微微翘起、影子更长的细条：`snip(pts, w0, w1)` 渐细的条（睫毛、胡须、发丝、飘带，宽度可传数组）；`line(pts, w)` 等粗的条（缆绳、桅杆）；`fringe(pts, n, length, angle, width, side, bend)` 沿曲线一排细丝（鸵鸟羽毛的羽枝、胸前的毛）；`scallop(pts, r, outset)` 一排鼓出的小圆（卷发团、帽冠抽褶、收起的帆）；`ringlet(x, y, length, width, turns, sway)` 螺旋垂卷，返回中线给金粉用；`lace(pts, depth, step)` 带一排穿孔的蕾丝花边
- `paste(sheet)` 把剪好的纸贴到卡纸上：4× 超采样再缩小，1 px 的细丝也留得住；黑纸带纤维和光泽，朝光的剪边有一道细亮线
- `bronze(sheet, strokes, width, tip, bright)` 薄金粉：每笔渐细、亮度各不相同、带颗粒，只留在黑纸上
- 字：`caption(f, 文字, x, y, size, style='roundhand'|'italic')` 铁胆墨手写题签（`sil_font` 找 Snell Roundhand / Baskerville Italic，可用 `INKPAINT_FONT_ROUNDHAND`、`INKPAINT_FONT_ITALIC` 指定）；`pen(f, pts)` 墨线
- `glaze()` 装上玻璃：凸面玻璃的柔光和窗户倒影；`smooth(pts, per, closed)` 闭合或开放的 Catmull-Rom 曲线
- `stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**凸版印刷海报 `Letterpress`**：
- 思路：每种油墨一块版（forme），先把要印这个颜色的东西都「锁」进版里，`press(ink)` 一次压印。每过一次机器纸张落得不一样：每块版有自己的平移和极小旋转（`register(ink, dx, dy, rot)`），红版和黑版永远对不齐。先红后黑
- 纸：`paper(colour, warm, tone)`：已经泛黄的廉价海报纸（云状纸浆、短纤维、杂点、纸齿、微微不平）
- 版：`lock(mask, ink, film)` 锁进任意遮罩；`clear(mask, ink, keep)` 刻掉（木刻高光、前后遮挡）；`with lp.layer('key'):` 把东西锁进版的某一部分，`press(ink, only=['key'])` 只压这一部分（阶段动图先出轮廓线、再出排线）；`press(ink, density)`：边缘随纸齿参差、边上积一圈深墨、大实地缺墨发花并露出纸齿白点、灰尘留下圆形漏印；黑压红更深
- 木活字：`type_line(s, x0, x1, base, cap, face, ink, align='justify', stretch, track, shade=(dx, dy, 另一版颜色, gap), inline=(inset, width), wear, grain, limits)`：默认把一行排满版心（字面横向压扁或拉宽、再加字距），每个字是一块木头：木纹条痕、一端偏浅、凹坑软斑、边角缺口、偶尔一道顺纹裂缝；shade 是印在另一块版上的投影，inline 是笔画中间刻一道白线。face 用 clarendon / antique / gothic / fatface / cjk（宋体黑）；`type_width()` 量宽度
- 铅字与花饰：`text(s, x, y, size, face='roman'|'roman_bold'|'italic'|…, ink, anchor, spacing, rot, stretch)`、`text_mask()`、`text_width()`；`rule(x0, x1, y, kind='single'|'double'|'thick_thin'|'thin_thick'|'dotted', ink, weight, joints)` 铜线（长线由几段拼成，接头有细缝和 1 像素错位）；`leaders()` 引线点；`star()`；`ornament(字符, ...)` 花饰字体（缺字体时画星）；`border()` 粗细双线框加方角
- 形状（整页浮点遮罩，可加减乘）：`shape(控制点)` 平滑闭合曲线、`poly()` 直边多边形、`tube(点列, widths=[...])` 变粗细的管子（腿、鼻、尾、绳）、`ellipse(cx, cy, rx, ry, rot, a0, a1)`、`rect()`、`outline_pts()`
- 木刻：`key(mask, width, heavy)` 轮廓线刻在形状内侧、背光一侧加粗；`hatch(mask, angle 或 centre+aspect, spacing, tone, lo, gain, wobble)` 线宽随明暗变化的排线，tone 低于 lo 处收尖消失、高处并成实地；`form_tone(mask, soft)` 把遮罩当成鼓起的体积打光得到 tone；`ramp(p0, p1)` 线性渐变 tone；`cast(mask, dx, dy, onto)` 投影；`line(pts, width, taper)` 两头收尖的刻线（皱纹、绳子）；`solid()`；`stipple(mask, density, size, tone)` 点刻；`tint(mask, ink=RED, loose, grow)` 另刻的套色块，边缘游走、比轮廓略胖
- 印后：`fold('v'|'h', pos, depth, crack)` 折痕（油墨裂开、积灰、两侧受光不同）；`tone_edges()` 边缘泛黄；`foxing(n)` 霉斑；`stain()` 水渍；`tack(x, y, r)` 钉孔和锈斑；`nicks(n, size)` 纸边缺口；`strip(x0, y0, x1, y1, rot, colour, draw=fn)` 另印一条日期条贴上去（fn 拿到一个小 Letterpress 往上排字，周围有浆糊印）
- 颜色常量 `RED BLACK PAPER`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**苏联构成主义 `Constructivism`**：
- 思路：一张纸、两块版。红的都在红版上，黑的（色块、字、每张照片的每个网点）都在黑版上。画东西就是「把遮罩印到某块版上」或「从某几块版上挖掉、露出纸」。合成时每块版整体带一个套准误差（平移加极小旋转），所以红黑相接处一边露纸、一边叠出深色。墨是透明滤色，相乘叠印，黑压红是暖黑
- 构造：`Constructivism(W, H, seed, misreg=2.4, red=RED, black=BLACK)`
- 纸：`paper(colour, aged, yellow)`：便宜的奶油色海报纸（云状纸浆、纤维、纸屑、微微不平、边缘发黄）
- 遮罩（全画布、抗锯齿，可加减）：`circle()`、`ring()`、`arc(cx, cy, r, a0, a1, width)`、`sector()`、`rect(x0, y0, x1, y1, rot)`、`bar(x0, y0, x1, y1, width)` 斜条或细线、`wedge(apex, angle, half, length)` 楔形、`poly()`；`along(p, angle, d, side)`：从 p 沿某个角度走 d、再往左偏 side，用来摆斜排的字和标注
- 印：
  - `ink(mask, 'red'|'black', knock=, density)`：印一版，knock 是从这块色里挖掉的字；
  - `knock(mask, plates)`：从这几块版上挖空；
  - `tint(mask, plate, level, cell, angle)`：平网；
  - `waves(cx, cy, r0, r1, step, width, a0, a1, plates, grow)`：限定角度内的同心波前，grow 为负时越传越细
- 字：`text(s, x, y, size, plate, font_style='grotesk'|'din'|'narrow'|'futura', anchor, spacing, rot, wobble, scale_x, knock)`；`text_mask()` 用来反白；`text_width()` 量宽度。grotesk 是 Helvetica Neue Condensed Black（退回 Impact / DejaVu Sans Condensed Bold），din 是 DIN Condensed（退回 Arial Narrow / PT Sans Narrow）；缺西里尔字形的字体自动跳过；`wobble` 给大字一点手绘的抖动
- 照片 `Photo(w, h, eye, target, fov, ss, key, fill, haze, shift, ...)`：小型透视 z-buffer 光栅器，单位米，Z 朝上：
  - `material(albedo, gloss, shine, metal, tex, interior)` 返回材质号，tex 是按世界坐标算的程序纹理（木纹、刻度、线圈绕线）；
  - `cylinder()`、`lathe(base, axis, [(t, r), ...])` 旋转体、`sweep(path, radii)` 变径管（鹅颈、喇叭、软线）、`box()`、`hyperboloid(z0, z1, r0, r1, n, twist, mid)` 双曲面网格塔的一节；
  - `project()` 把世界坐标点换成照片像素，用来让海报上的其他元素对准照片里的东西（如楔形对准喇叭口）；
  - `render()` 只调一次：只给有物体的像素着色，渲染后释放缓冲
- 拼贴：`montage(photo, cx, cy, rot, scale, plate, cut, close, backdrop, cell, angle, contrast, soften)`：缩放、旋转、放上去，再在海报坐标里统一加 45° 网点（所有照片共用一张网）。
  - `cut=` 沿轮廓留边剪下：盖住下面已印的东西，露出纸色白边和背景的高光小点；
  - `close=` 桥接剪刀剪不进的窄缝；
  - 不给 cut 就是去了底的照片，网点直接叠印在红色上；
  - `soften` 是加网前的模糊（单位：网格），网格塔这类细杆用 0.12
- 做旧：`age(folds=(竖, 横), foxing, stain, pins, crack, grime)`：折痕裂墨与磨损、霉斑、水渍潮线、磨旧的角、图钉锈孔
- 顺序：paper → 红版色块（圆、楔形、色块）→ 黑色波线、斜条（`knock` 掉下面的红）→ 照片 → 字和标注 → age
- 颜色常量 `RED BLACK PAPER AGED`；角度逆时针为正，0° 指 3 点钟；`stage(name)` 立即合成快照；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**装饰艺术 `ArtDeco`**：
- 思路：画家不画线。每个形状都是一张用刀刻出来的遮片（frisket），盖在板上用喷枪喷色，所以边缘锐利、里面是一段平滑渐变；形体只靠明暗：楼是一张平剪影、一侧喷暗一侧喷亮，圆柱体上肩一道高光、下腹一条反光
- 喷枪：`spray(mask, 颜色或整幅颜色场, density, grain, blend='paint'|'screen'|'add')` 一次喷涂；薄涂处有雾滴颗粒（固定噪声 × d(1−d)），实涂处没有；`fade(mask, stops, p0, p1)` 线性渐变，`glow(cx, cy, r, 颜色)` 径向光晕；遮片 `rect()`、`poly()`、`disc()`（都抗锯齿）；`ramp(t, stops)` 色阶
- 天空：`sky(stops, top, bottom)` 长渐变；`burst(cx, cy, rays, contrast, reach, colour, dark, glow, phase, taper, bottom)` 明暗交替射线（亮楔靠近中心略宽，对比随距离衰减，bottom 处截止）；`moon(cx, cy, r)` 偏心径向渐变的球形月亮、光晕、柔边月海；`searchlight(x, y, angle, length, spread)` 探照灯光束
- 城市：`tower(x, base, [(宽, 高), ...], body, rim, light=±1, flutes, windows, slits, far, spire, spire_w, mast, ledge, top_windows)` 阶梯退台高楼，返回顶层顶部中心；`far` 0..1 推进雾里（变浅变蓝变平）；`crown(x, y, w, steps)` 扇形阶梯冠顶（放射窗），返回顶点 y；`clock(cx, cy, r, 时, 分)` 钟面
- 河：`water(horizon, stops, reflect)` 先喷河面渐变，再把地平线以上已经画好的东西镜像进来，打碎成横向波纹，亮的东西反射更强
- 3D 列车：`camera(f, cx, horizon, height)` 水平针孔相机；`express(nose=(X, Z), vp_x, deck, cars, loco, car, gap, nose_len, rake, light, moon)` 在拱桥上渲染流线型列车（距离场 + numpy 球面步进，只对边缘像素 3×3 超采样），返回分层结果 `r`；按画家的顺序叠上去：`frisket(r)` 遮片平涂底色 → `model(r)` 明暗塑形（半朗伯色阶、上肩喷枪高光带、月光轮廓光、下腹反光、远处雾色）→ `lights(r, beam, beam_len, bloom, reflect)` 车窗（卧铺窗帘拉下一半）、头灯、光束、辉光、灯照铁轨、可选的河面倒影；`project(X, Y, Z)` 世界坐标转像素
- 字：`lettering(s, x, base, cap, fill, track, shadow, anchor)` 库内自建的 Deco 展示字母 A–Z（粗竖笔、发丝横笔、高腰线、椭圆字碗），金属渐变填色（中线一道硬分界），可加块状投影；`deco_width()` 量宽度；`caption(s, x, y, size, colour, track, anchor)` 宽字距几何无衬线小字（返回宽度）；`rule()` 金线；`border(inset, gap, width, step)` 阶梯角双金线边框
- 印刷：`finish(paper, tooth, warm, vignette)` 纸纹、微颗粒、暖色偏、轻微暗角
- 颜色常量 `NAVY MIDNIGHT TEAL JADE GOLD BRASS IVORY CREAM MAROON CRIMSON WARM`；坐标像素、y 向下，3D 世界单位米、y 向上；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**黄金时代漫画 `ComicCover`**：
- 思路：先按当年的分工把封面「做」出来，再按当年的印法「印」出来。墨线师在黑版上勾 key 线；上色师在色稿上给每块区域指定三原色的 Ben-Day 网点比例（0 / 20 / 40 / 70 / 100%），整张封面只有几十种颜色；印刷时每版按自己的角度加网、各自错开几像素，新闻纸吸墨让网点变毛、小点丢失、实地发花；油墨透明相乘。网点和错版都不手画
- 构造：`ComicCover(W, H, seed, screen=11, misreg=4, slop=1.6, light=(-0.6, -0.8))`：screen 是网点间距（px），misreg 是各色版的错位量，slop 是手绘分色的游走量；`register(plate, dx, dy, rot)` 手动指定某版的落点
- 纸：`paper(colour, tone, fibres, flecks)` 泛黄新闻纸（云状纸浆、深浅短纤维、树皮屑、不吃墨的纸坑）
- 形状（整页抗锯齿遮罩，可加减乘）：`mask(pts, smooth)`、`circle()`；静态方法 `ellipse_pts()`、`smooth()`（闭合样条）、`tube_pts(路径, 宽度列表)`（四肢、绳子、围巾、耳朵）、`burst_pts()`（星星、爆炸框）、`edge_normals(pts)`（轮廓点和外法线，给 `feather` 用）；`grow()` / `shrink()`
- 色稿：`flat(shape, 颜色)`，颜色是 (蓝, 红, 黄, 黑) 四个网点比例；`graded(shape, [颜色…], p0, p1, edges=[…])` 沿手裁波浪边分档的色带；`rings()` 同心色环；`knock()` 挖白
- 黑版：`part(pts, 颜色, width, heavy)` 是放前景物件的标准做法：擦掉身后的墨线和颜色、铺色、勾一圈背光侧加粗的轮廓；`brush(pts, width, taper, swell)` 两头尖、中段鼓的毛笔线；`pen()` 细笔；`outline()` / `edge()` 闭合 / 开放轮廓；`ink()` 实黑块；`erase()`；`mask_outline(mask, width, heavy)` 给任意遮罩（圆的并集、字）描边；`feather(P, N, length, width, spacing, clip, along, toward, curl)` 从阴影边长出来的羽状排线；`hatch()` 平行排线；`speed()` 速度线；`dot()`
- 字：`letter(text, x, y, size, face, colour)` 手写字，逐字微转、微跳（face：letter 漫画手写体 / logo 窄粗体 / bold / slab / heavy）；`text_mask()`；`balloon(text, x, y, size, tail, kind='speech'|'yell'|'thought')` 对白框 / 喊叫爆炸框 / 想法云；`caption(x0, y0, x1, y1, text, colour)` 旁白框；`sfx(text, x, y, size, colour, rot, shade)` 拟声字；`logo(text, quad, vp, depth, colours, shade, shadow, glints)` 透视立体刊名：四个角点定透视，朝灭点挤出 depth 像素，正面上浅下深分档，加挤出面、投影、粗黑外框和高光斜纹
- 做旧（印完以后再加，只作用在各自区域）：`brown_edges()` 边缘泛黄；`spine(ticks, staples)` 书脊折痕、白色应力裂纹、两枚生锈订书钉；`corner('br', radius)` 角上磨掉油墨、折角；`crease(p0, p1)` 折痕处油墨裂开露白；`foxing(n)` 霉斑
- 阶段：`stage(name, plates='CMYK')` 记下当时的各版，出图时只印列出的版：先用 'K' 出黑版线稿，再依次 'YK'、'YMK'、'CMYK'，就是印刷厂的「渐进打样」
- 颜色常量（色稿比例）：`WHITE CREAM PALE YELLOW GOLD ORANGE DEEP_ORANGE RED CRIMSON PINK SKIN TAN BROWN DARK_BROWN SKY LIGHT_BLUE BLUE NAVY VIOLET MAUVE LILAC GREEN LIME GREY LIGHT_GREY SILVER`；油墨颜色 `INK`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**波普丝网 `PopSilkscreen`**：
- 思路：重做 60 年代「工厂」的做法。一张照片做成黑色照相丝网版；一张画布用胶带隔出几格，每格先手涂撞色平涂（底色，再是脸、眼、鼻、项圈……），形状照着照片描得很松、对不准；然后把同一块黑版逐格刮印上去，每格放版的位置、角度和墨量都不同
- 构造：`PopSilkscreen(W, H, seed, light=(-0.55, -0.8))`；`canvas(gesso, thread=3.8, slub=0.18)`：刷了白底漆的棉帆布（平纹布纹高度场、粗节、均匀布光）
- 分格：`grid(cols, rows, gap, margin, origin=(0.5, 0.53), unit=0.285)` 返回 `Panel` 列表。每格里用「单位」作画：origin 是单位原点在格内的位置（宽、高的比例），unit 是每单位占格高的比例
- `Panel` 上取遮罩（局部窗口，四周留 pad 像素，方便渗边和错位）：
  - `shape(pts)`：闭合样条
  - `stroke(pts, w0, w1, profile=)`：渐细笔画，宽度用单位；`profile(t)` 自定粗细
  - `ellipse(u, v, ru, rv, rot)`、`dots([(u, v, r)])`
  - `soft(mask, sigma)`：柔化成给网点用的调子；`blank()`
  - 坐标换算：`at(u, v)` 单位 → 局部像素，`xy(u, v)` 单位 → 画布像素
  - 模块函数：`turn(pts, deg, about)` 屏幕上逆时针转（歪头用）、`mirror(pts)` 左右镜像、`closed_spline()`
- 手涂丙烯：
  - `ground(p, 颜色, direction, bleed)`：一格的底色，刷到胶带为止，有几处渗进胶带下的毛边
  - `paint(p, mask, 颜色, direction, wobble, drift, opacity, dry, streak)`：手涂一块平涂色。wobble 是边缘手抖（px），drift 是这块颜色描偏了多少（px）；顺笔方向有轻微明暗，边缘有干笔拖痕和一道受光的漆脊；只涂在本格里
- 黑版 `key(p, solid, tone, ink, shift, rot, density, flood, starve, pull, nicks, ghost, cell, angle)`，返回印上的覆盖率：
  - solid 是实黑的阴影块；tone 是中间调，印成 45° 粗网点（cell 约 7 px）；照相阈值的颗粒边和膜上的灰尘点自动加；`stencil()` 可以单独取照相版遮罩
  - shift、rot：这一格放版的偏移（px）和转角（度）
  - density：墨量，0.92 缺墨、1.0 正常、1.15 墨多，低于约 0.9 就印不出脸
  - flood：墨多糊版，形状变胖、细缝填死、挤出墨团
  - starve：干在网上的一块墨斑；pull：刮板方向（90 自上而下，0 自左向右）；nicks：刮板缺口留下的细白线
  - ghost=(dx, dy, 强度)：版放了两次，留下一层灰影
- `stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度
- 颜色常量（60 年代丙烯撞色）：`HOT_PINK PINK BLUSH RED ORANGE TANGERINE LEMON YELLOW CREAM LIME GREEN MINT TURQUOISE SKY BLUE ULTRA VIOLET LILAC WHITE`，底漆 `GESSO`，黑墨 `INK`

**ASCII 字符画（行式打印机） `LinePrinter`**：
- 思路：画面不直接画在纸上，而是画进一张隐藏的「角色图」（每个字符格 6×10 个采样）：每块区域带一个角色（用哪套字符）和一个调子（要多少墨），后画的盖住先画的；`compose()` 再逐格决定打哪个字：线条格按线的方向和在格里的位置选 \| / \\ _ - . ' X +，剪影转折处同样处理，填色格按调子从角色的字符阶梯里选（同角色内误差扩散），最暗的格用叠打。最后模拟鼓式行式打印机逐行击打
- 构造：`LinePrinter(W, H, seed, cols=132, top=40, cpi=10, lpi=6, form_in=14.875, ss=2, weight='bold', ppi=None, page_in=11.0)`；`top` 是撕线的位置，`ppi=None` 让纸宽撑满画面，调小就整张纸躺在桌上、左右露出桌面；`page_in` 是纸深（11 英寸 66 行，8.5 英寸 51 行，配合 ppi 能让上下两道撕线都入画），`page_rows` 是一页的行数；`rows` 是看得见的行数，坐标一律用（列, 行），可以是小数；`xy(col, row)` / `centre(col, row)` 换算成像素
- 纸：`form(white, green, desk, band=3, first_green, holes)`：14 7/8 英寸宽的绿条连续纸，每 3 行一条浅绿带，两侧导孔（孔里看得到桌面和纸的投影，偶有被拉长的破孔）、微孔撕线、每 `page_rows` 行一道横向撕线和折痕；纸比画面窄时两侧是桌面和纸的投影。要留页边就在 `compose()` 前 `erase(rect(0, page_rows − 2, cols, rows))`
- 角色：`role(name, ramp, edge='outer'|'all'|None, outline='straight'|'round'|dict, dither, noise, group, inner_max)`；ramp 从浅到深，如 `['', '.', ':', '%', '@', '#', '#@']`，`'#@'` 表示 # 上再叠打 @；`group` 相同的角色之间不描边；`inner_max` 只在亮处给同角色的块与块之间描边
- 形状（子格遮罩）：`circle(col, row, 半径列数)`（自动按格子比例变圆）、`ellipse()`、`poly(点列)`、`shape(控制点)` 平滑闭合曲线、`rect()`、`blob()`
- 调子：`sphere_tone(col, row, r, light, amb)` 球（烟团）、`cylinder_tone(c0, c1, light, amb)` 竖圆柱（箭身）、`ramp_tone(p0, p1, t0, t1)` 线性渐变
- 作画：`fill(mask, role, tone)`；`erase(mask)` 挖回白纸；`stroke(点列, width, glyphs=None|'round'|单个字符, smooth)` 画线（单个字符如 `'='` 强制用它，平台、横梁用）；`billow([(col, row, r), ...], role, light, amb, shadow, glow=(col, row, r, 强度), lift=调子场)` 一团云：每团按球打光、给身后的云团投接触阴影，glow 是火焰从里面照亮，lift 给云底加暗
- 文字：`text(s, col, row, strike=2)` 原样打字（strike=2 两次叠打成粗体，opaque 让空格挖掉底下的画）、`text_v()` 竖排；`plot(col, row, w, h, xlim, ylim, [(xs, ys, 字符), ...], xticks, yticks)` 打印机绘图（I 纵轴、- 横轴、+ 刻度），返回把数据坐标换成格子坐标的函数（好在上面圈点）
- 打印：`compose()` 出字符网格（`listing(path)` 存成纯文本）；`print_rows(r0, r1)` 逐行击打（同一行所有叠打在走纸前打完）：同一个字符总是偏高或偏低一点（鼓的相位）、每列锤子力度不同（有一两列弱锤）、叠打的那一遍整行错开零点几像素、色带随作业变淡并沿宽度磨损、偶有色带偏低的行字头发虚、磨损的字模每次都缺同一块、墨往纸里洇、锤子压出极浅的凹痕
- 批注：`pen(点列, colour, width)` 圆珠笔（起落笔略积墨、快处变淡、在纸纹上断续）、`ring(x, y, rx, ry)` 顺手画的不闭合圈、`tick(x, y, size)` 打勾、`pen_text(s, x, y, size)` 手写字；这些用像素坐标
- 层次与动画：先 `fill`/`stroke`/`text` 摆完整张画，再 `compose()`，然后分几段 `print_rows` 并各 `stage(name)`，就是一行行打出来的动画；`save('x.jpg')` 默认 quality 88、4:4:4 色度
- 颜色常量 `INK`；`save(path, stages_dir)` 时按 1× 输出各阶段

**低多边形 `LowPoly`**：
- 思路：一个只用 numpy 写的软件光栅化器，照 1999 年代主机的做法画：小帧缓冲（默认 384×216）、顶点吸附到整像素、背面剔除、整个场景的三角形按平均深度排成一张表从远到近画（画家算法 / ordering table）、近平面裁剪；每个三角形一个颜色（平面着色），贴图仿射插值、不做透视校正，逐顶点雾；最后 15 位色加 4×4 有序抖动，最近邻放大。调用顺序不影响遮挡
- 构造：`LowPoly(W, H, scale=5, seed, record=True, zbuffer=False, near=0.6, far=260)`；世界坐标 X 右、Y 上、Z 向前，单位米；`zbuffer=True` 是 N64 式逐像素深度
- 相机：`camera(eye, target 或 yaw=, pitch=, fov, roll)`；`aim(世界点, at=(fx, fy))` 转动相机让这个点落在画面的指定比例位置（构图用）；`project(p)`、`ray(sx, sy)`
- 天与光：`sky(zenith, horizon, glow, bands)` 按仰角渐变、太阳周围暖光晕、可选细条云；`sun(screen=(fx, fy) 或 direction=)` 画太阳并定光照方向；`light(lift=度)` 着色光单独抬高；`ambient(sky, ground)` 半球环境光；`fog(near, far)` 逐顶点雾，颜色默认等于地平线
- 地形：`path([(x, z), ...])` 中心线，`along(path, s, u, y)` 取点、`heading(path, s)` 取方向；`canyon(path, step, height, width, wobble, strata, buried)` 沿中心线放样的峡谷（河床、沙岸、碎石坡、两级悬崖和台阶、崖顶、台地；岩壁按高度贴岩层，平面俯贴沙地 / 灌丛）；`river(path, half, ripple, spec)` 起伏小面的河；`mesa(x, z, r, h, base)` 方山；`arch(path, s, span, rise, base)` 天然石拱；`boulder(x, y, z, r)`；`tree(x, y, z, height)` 十字插片杜松（贴图 alpha 硬裁切）
- 物件：`ring(centre, facing, radius, tube)` 多面金环；`aircraft(pos, heading, roll, pitch, size, body, trim, canopy, spinner)` 约 230 个三角形的小特技飞机加半透明螺旋桨盘；`torus()`；`mesh(V, F, colour, uv, tex, lit, spec, shine, blend, alpha, two_sided, fog, bias, cutout, glow)` 任意网格：blend 用 'opaque' | 'half' | 'add' | 'sub' | 'quarter'（当年的四种半透明模式），bias 是排序偏置（负数后画），glow 把面往全亮拉（拾取物）
- 特效：`shadow(x, z, y, radius)` 正下方的圆斑影子（'sub' 混合）；`sparkle(p, size)` 加色四角星；`flare()` 屏幕空间镜头光晕（太阳被挡住就不画）
- 贴图：`texture('strata'|'ledge'|'sand'|'water'|'rock'|'juniper'|'spark')` 32–64 像素的程序贴图，最近邻取样
- HUD（帧缓冲像素坐标）：`text(s, x, y, scale, fill=颜色或自上而下的渐变列表, italic, anchor)` 5×7 点阵字（加粗、斜切、1 px 黑描边加投影）；`counter(label, value, x, y, icon, anchor)` 小标签加大号斜体数字；`icon('ring'|'plane'|'clock')`；`gauge(x, y, value, number, unit)` 阶梯速度条；`panel()` 半透明框；`minimap(x0, y0, x1, y1, path, s0, s1, rings, done, plane, heading, finish, title)` 转到机头朝上的赛道小地图
- 动画：`stage(name)`；`stage(name, wire=True)` 隐藏线线框；`stage(name, fog=False, textures=False)` 平面着色预览（每个面取中心那个纹素）
- 颜色常量 `GOLD WHITE BLACK HUD_YELLOW HUD_ORANGE HUD_RED HUD_GREEN HUD_CYAN`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**喷漆模板涂鸦 `Stencil`**：
- 思路：一面真的墙，一张张真的卡纸模板，一罐喷漆。墙是反照率加高度图、左上方一个低太阳照亮；模板是卡纸上刻开的洞，被刻断的卡纸（O 的中间、手臂和身体之间、轮辐之间）会掉，所以要留「桥」，桥在漆上是一道道露墙的细缝；喷漆是罐子来回扫，每扫一道落下一个高斯锥，漆膜就是这些笔画的和；漆是一颗颗雾滴，厚的地方连成实色，薄的地方是散点，所以所有软边都是麻点而不是模糊；漆盖不进小孔、贴着墙面起伏、带缎面光泽；漆太厚的下边缘会往下流成滴痕
- 墙：`wall(colour, planks, ties, ground, damp, crack)` 木纹模板清水混凝土：一条条木板压出的色带和木纹（绕着树节走）、板头接缝、板缝挤出的断续水泥浆棱、对拉螺栓孔（锈铁头 / 灰浆堵头 / 空孔）、气泡孔、雨痕和锈水、返潮水线与泛碱、发丝裂缝；`pavement(colour)` 墙脚的沥青人行道（骨料、补缝沥青、口香糖渍、油渍、墙脚灰土和杂草）
- 旧痕迹：`buff(x0, y0, x1, y1, colour, roller, ragged)` 市政灰漆滚筒覆盖（竖向滚道、台阶状上下边、发干的两头、重叠处偏深，底下的东西透一点出来）；`freehand(..., wash=0.7)` 被高压水枪冲掉一半的旧签名
- 模板：`card(x0, y0, x1, y1, origin, scale, tape, material='manila'|'board')` 返回 `Card`，形状用设计单位（px = origin + scale × 点），返回局部遮罩，可以用 numpy 相加相减：
  - `poly(pts, smooth, facet)`（facet 是刀沿曲线一小段一小段切的抖动）、`capsule(p0, p1, r0, r1)`、`ellipse(c, rx, ry, rot)`、`ring(c, 外, 内)`、`stroke(pts, w0, w1)` 渐变宽度的带子
  - `text(s, x, y, size, font='stencil'|'slab'|'block', anchor, spacing, bridge)` 模板字：每个字腔自动上下各一座桥
  - `cut(mask)` 刻开；`keep(mask)` 留住卡纸（反白字、细节）；`bridge(p0, p1, width)` 手放一座桥；`bridges(width)` 自动找出所有会掉的孤岛、补最短的桥（大孤岛两座、方向相反）；`islands()` 还剩多少像素的卡纸会掉（0 才算刻好）
- 明暗分版：`shade_side(mask, light, depth, soft, wobble, seed)` 背光一侧 depth 像素宽的月牙，多层模板的灰版、黑版用它切；wobble 让边像手刻的
- 喷：`spray(card, colour, coats, cone, angle, misreg, at, rot, lift, mist, drips, drip_len, wet, linger, ghost)`。cone 是喷幅（像素）；misreg 是贴歪的随机误差（多版套色用约 2）；at / rot 把同一张小模板挪到别处、转个角度再喷（燕子、树叶、蝴蝶结）；lift 卡纸翘起量（软边和渗漆）；mist 外溢雾化；drips 滴痕多少，wet 起滴的漆膜厚度
- 徒手：`freehand(pts, colour, width, coats, speed, spits, drips, mist, wash)` 细喷嘴：线宽和浓淡跟着手速（speed 每个控制点一个系数，慢 = 重），起笔一团、停顿处滴、旁边几颗喷嘴吐出的大漆点
- `stage(name, card=c)` 快照里模板还贴在墙上（胶带、卡纸上积的漆、切口一侧亮一侧暗、卡纸投影），动图用；`save(path, stages_dir)` 默认 quality 88、4:4:4 色度
- 颜色常量 `BLACK WHITE GREY RED CONCRETE`；`HIDE` 各色遮盖力（白最差），`GLOSS` 光泽；字体 `stencil_font(style, size)` 找 DIN Condensed Bold / Impact、Rockwell、Arial Black，可用 `INKPAINT_FONT_STENCIL` 等指定

**刺绣徽章 `Patch`**：
- 思路：像绣花机那样绣：每块形状按自己的针向切成平行的行（扫描线），每行再切成针，所以形状的边缘就是一排针脚。每根线按圆柱打光，两头扎进布里（针孔是小凹坑），高光是各向异性的（Kajiya-Kay），同一种颜色换个针向亮度就不同，这正是「绣出来」而不是「印出来」的关键。徽章先是一块裁好的斜纹底布放在牛仔布上（有厚度、有投影），再绣、再包边，最后手缝上去
- 牛仔布：`denim(colour, weft, warp_px, pick_px, fade)` 3/1 右斜纹（经密纬疏，斜纹约 60°，露白纬点、竹节纱、磨白），2× 渲染；`seam(pts, thread, rows, stitch, gap, fold)` 双明线的折边缝，折棱磨白
- 底布：`blank(pts, 颜色)` 返回 `Blank`（`.pts` 轮廓、`.mask` 遮罩）；轮廓：`circle_pts(cx, cy, r)`、`arch_pts(cx, top, w, h, corner)` 拱形异形章、`rocker_pts(cx, cy, r0, r1, span, centre)` 弧形条章；遮罩：`circle()`、`ring()`、`poly(pts, smooth)`、`text_mask()`，用 `*`、`np.maximum`、`1 - m` 组合
- 填充：`fill(mask, 颜色, angle, kind='tatami'|'satin', pitch, length, stagger, maxlen)`：tatami 是大面积底色（短针约 15 px，每行错开 0.3 针）；satin 一行一根长线（字、雪顶、火焰、细长形），超过 maxlen 自动拆成交错的分段缎面；angle 是针向（度，逆时针，0 = 左右走）
- 沿路径：`column(pts, 颜色, width, closed)` 缎面柱，针和路径垂直（圆环分隔线、木柴、帐篷杆）；`run(pts, 颜色, stitch, gap, width, clip=)` 平针 / 刺子绣虚线 / 明线；`knot(x, y, 颜色, r)` 法式结（星点、火星）；`star(x, y, r, 颜色)` 四角缎面小星
- 包边：`merrow(blank, 颜色, width)` 锁边：斜着一圈圈绕过布边的圆绳，用于圆、椭圆、弧形条章；`satin_border(blank, 颜色, width)` 热切缎面边，用于其他异形轮廓
- 字：`text(s, x, y, size, 颜色)`、`arc_text(s, cx, cy, r, size, 颜色, centre=90, bottom=False)` 缎面字，每个字母斜着走针；bottom=True 沿下弧读、字头朝里
- 手缝：`whip(blank, 颜色, frm, to)` 卷边针，按轮廓长度的比例缝一段，返回最后一针的位置；`thread(pts, 颜色, lift)` 散落的缝线（有捻度，抬起越高影子越远）；`needle(eye, tip)` 躺在布上的钢针（先画线：线会从针眼里露出来）
- `stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**蓝图工程图 `Blueprint`**：
- 思路：先在描图布上用几种固定粗细的鸭嘴笔上墨（轮廓、剖面线、尺寸、单笔画字全是「墨」），再像真的晒图那样接触曝光：有墨的地方挡住弧光灯，药面不变蓝，冲洗后是白线；其余地方生成普鲁士蓝。曝光 = 透光 × 灯的照度，显影按 S 曲线（有阈值）——粗线纯白、发丝线发浅蓝、底色饱和；线的边缘有爬光（压得紧的地方锐、接触不良的地方软）和一圈淡淡的光晕；灯在中间强、四周弱，药面有涂布条纹、斑驳和晾干时自上而下的流痕；颜色按普鲁士蓝在纸上的比尔–朗伯吸收计算，纸纤维透出来。晒好之后再过它的「一生」：折叠、褪色、手摸、水渍、图钉，最后工地上的人拿红蜡笔批注
- 构造：`Blueprint(W, H, seed, ss=3, tracing=(x0, y0, x1, y1))`；`expose(time, contact)`：曝光时间（0.8 欠曝发浅、1.3 过曝）和压框接触不均的程度
- 笔：`line(pts, pen, closed)`，pen 为 `'heavy' 'thick' 'medium' 'thin' 'fine'` 或像素宽，线头有一点积墨；`dashed(pts, pen, dash)` 虚线；`centerline(pts)` 点划线；`circle`、`arc`、`box`；`fill(pts)` 涂实（薄金属剖面、箭头、比例尺黑格）；`dot`；`erase(pts)` 用刀片刮掉墨；`pencil(pts)` 留在描图布上的铅笔线（晒出来是很淡的浅线）；`Blueprint.arc_pts(...)` 取弧线点（角度逆时针、纸面 y 向上）
- 剖面线：`hatch(polys, angle, spacing, pen, holes, kind)`，kind 为 `'lines'` 石材 / 通用、`'cross'` 金属、`'glass'` 三短线玻璃、`'rock'` 岩石裂纹、`'stipple'` 混凝土点、`'solid'` 涂实；`ground(pts)` 自然地面线加短斜线组；`breakline(p0, p1)` 折断线
- 字：`text(s, x, y, size, anchor, pen, slant, spacing, rot, guide, clear)` 内置单笔画大写字体（字模板样式：A–Z、0–9、Ø ± ° × ℄ ✓ → 等），size 是大写字高，anchor 如 `'ls' 'mm' 'rs'`（s = 基线），slant 约 0.22 是斜体字，guide=True 留下铅笔导线，clear=True 先刮掉字后面的剖面线，`\n` 换行；`text_width(s, size)`；`cjk(s, x, y, size, anchor, condense)` 中文长仿宋（压窄，找 STFangsong / FangSong，找不到用中文字体，可用 `INKPAINT_FONT_FANGSONG` 指定）
- 制图符号：`dim(p0, p1, offset, text, size, arrows, scale, fmt, text_off, shift, clear)` 尺寸（尺寸界线、箭头、数字顺着尺寸线写，短尺寸自动把箭头放到外面；offset=0 时不画界线，可以自己画链式尺寸）；`level(x, y, text, side, length, mark_at)` 标高符号；`leader(pts, text, end='arrow'|'dot'|None)` 引出线；`cut_mark(p0, p1, label, view)` 剖切符号；`bubble(x, y, r, top, bottom)` 详图索引圈；`view_title(x, y, title, sub, size, bubble)` 图名（粗细双下划线 + 比例）；`north(x, y, r)` 指北针；`scale_bar(x, y, px_per_unit, units, label)` 比例尺；`border(x0, y0, x1, y1, zones)` 图框和分区编号；`table(x0, y0, widths, heights)` 标题栏 / 修改栏，返回每格坐标 `[行][列]`；`revision(x, y, mark)` 修改三角
- 图纸的一生（只作用在晒好的图上）：`fold(xs, ys, wear)` 折成档案尺寸（折痕处药面裂白、两侧一明一暗、交叉处磨损）；`fade(x0, y0, x1, y1, amount)` 朝外那一格褪色；`grime(...)` 手摸发灰；`stain(x, y, r)` 碱性水渍（蓝变锈褐、两道潮线）；`tack(x, y)` 图钉孔与锈圈；`tear(x, y, direction, length)` 折痕碰到纸边处的小裂口
- 红蜡笔：`red(pts, width)`、`cloud(pts, bump)` 修改云线、`red_text(s, x, y, size, rot)` 手写批注；红色是全图唯一不属于晒图本身的颜色
- `stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**儿童蜡笔画 `Crayon`**：
- 思路：糙纸是一张纸纹高度图，均衡成 [0, 1] 的均匀分布，所以「1 − 阈值」就是蜡能挂上的纸面比例；蜡只挂在纸纹凸起上：`纸纹 + 0.35 × 已有的蜡 > 1 − 接触 × 压力` 才上蜡，轻涂露出一片白点，重涂压进凹处，后涂的颜色更容易挂在先涂的蜡上（蜡层堆积）。蜡笔沿笔道被拖着走，所以露白的小坑被拉成顺着笔道的短条。用秃的笔头是一个带棱的平面：一笔 = K（≈ 宽 / 3）条强弱不一的平行细线，笔道里有白色细纹。颜色是半透明的乘性混合：`新 = lerp(底, 颜色 × 底^0.6, 覆盖)`，黄上涂蓝变绿、黑线涂不掉、同色重复越涂越深。最后纸纹和蜡层一起当高度图，左上低角度光打光，厚蜡处有一点蜡光
- 构造：`Crayon(W, H, seed, paper='#f7f3e9')`；`paper(tone, grain, fibres, scan)` 糙纸（纸纹、纸浆纤维、不匀的扫描光）；颜色常量 `c.C`（24 色蜡笔盒：red orange yellow yellowgreen green darkgreen sky blue navy violet purple pink magenta brown tan peach apricot black grey white …）
- 小孩的手画的形状（返回点列）：`circle(cx, cy, rx, ry, rot, lumpy)`、`rect(x0, y0, x1, y1, skew)`（四个角各歪一点）、`poly(pts)`、`wobble(pts, amp)`；遮罩：`mask(pts)`、`stroke_mask(pts, width)`、`grow(mask, px)`、`drawn()`（纸上已经画了的地方）
- 涂色：
  - `scribble(mask, 颜色, angle, width, density, pressure, reach, mess, angle_jitter, avoid, halo, fade)`：来回涂。reach 是胳膊够得着的长度，大片按块涂、每块各自的角度（None = 一块）；density 低时两道之间留三角形白缝；mess 是在轮廓处的过冲 / 没涂到；avoid + halo 绕着涂、留一圈白（绕开处转折小心，不进比 0.7 × 笔宽窄的缝）；fade=(y 满, y 无) 越往下越稀（涂烦了的天空）；
  - `loops(mask, 颜色, r, width, density)`：一圈圈的绕圈涂（树冠、太阳、皮球、斑点）；
  - `follow(pts, 颜色, width, passes, crayon)`：顺着一条带子涂（彩虹的每一道、路）；
  - `burnish(mask, strength)`：使劲压着涂：已有的蜡压进纸坑，白点合上，颜色变深发亮
- 线和点：`line(pts, 颜色, width, pressure, closed, avoid)` 一根蜡笔线，落笔重、收笔轻；closed=True 时尾巴越过起点、差几像素对不上；avoid 让线停在东西背后；`dab(x, y, r, 颜色)` 拧进纸里的实心点（眼睛、苹果、西瓜籽）
- 写字：`write(s, x, y, size, 颜色或颜色列表, width, tilt, jumble, spacing, anchor)`：细字体字形细化成中心线，再用圆头蜡笔描；每个字各自歪 ±tilt°、大小和基线乱跳 jumble、按列表轮换颜色。字体按 STHeiti Light / Hiragino Sans GB / Noto Sans CJK Light / 微软雅黑 Light 找，可用 `INKPAINT_FONT_CRAYON` 指定
- 纸上的东西：`crumbs(x0, y0, x1, y1, colours, n)` 蹭下来的蜡屑（凸起、带小影子）；`stick(x, y, angle, 颜色, length=360, radius=22, tip='worn'|'new'|'broken', wrap, peel, label)` 一根真蜡笔（哑光蜡、印花包装纸、伪文字标签、断口、撕掉的纸），合成时画、带柔和投影
- 顺序：先勾线（东西的内部遮罩收进一个 OBJ），再涂大片并绕开 `U(OBJ, drawn())`，最后在白纸上给东西上色；字和签名写在涂天空 / 草地之前
- `stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度；底层 `deposit(cover, box, 颜色)` 把任意接触场按纸纹上蜡

**绿屏终端 CRT（荧光字符画） `CRTTerminal`**：
- 思路：重做一台字符终端，不在屏幕上「画图」：
  - 屏幕上的一切都是字符内存里的字：每格带亮度属性（dim / normal / bold）、反白、下划线，行可以是双倍宽或双倍高；
  - 字库 ROM 是 7×10 点阵格里的 5×7 字，小写字母带两行下伸部；另有一套图形字符：框线 ─│┌┐└┘├┤┬┴┼、画曲线用的五档扫描线横条 ⎺⎻─⎼⎽（`SCAN`）、八分块 ▁▂▃▄▅▆▇█（`EIGHTHS`）、░▒▓、° ·、▲▼◆、箭头；
  - 字符画先画进一张隐藏的「材质 + 调子」图（每格 7×10 个采样），`compose()` 逐格选字：里面的格子按材质的阶梯和调子选字，同组之内做误差扩散；剪影穿过的格子按边的方向和位置选 _ . - ' / \ ( ) |；笔画格子按笔画方向选字。屏幕上「密 = 亮」：暗的东西要稀、要 dim；
  - 电子束每行字扫 10 条扫描线：点拉伸半个点，视频放大器有拖尾，光斑随电流变粗（bold 时扫描线之间的缝被填满）；
  - P1 荧光粉亮到饱和时发白；之后依次是余辉、烧屏、桶形畸变、边缘变暗、玻璃里的光晕，以及房间的倒影
- 构造：`CRTTerminal(W, H, seed, cols=120, rows=36, phosphor='green'|'amber'|'white', opening=(88, 60, 1832, 958), radius=62, raster=(0.955, 0.93), curve=0.065)`；opening 是机壳开口，raster 是未畸变的光栅占开口的比例，curve 是桶形强度；`cw`、`ch` 是一格的像素宽高
- 字符内存：`write(col, row, s, attr)`，attr 取 `'dim'`、`'normal'` 或 `'bold'`，可加 `'+rev'` 反白、`'+ul'` 下划线；`big(col, row, s)` 双倍高双倍宽，占 row 和 row+1 两行（这两行只能放大字，每个字占两列）；`wide()` 双倍宽；`box(c0, r0, c1, r1, attr, title)`、`hline()`、`vline()`；`cursor(col, row, 'block'|'ul')`；`clear()`；`listing(path)` 存成纯文本
- 字符画（隐藏图）：
  - `material(name, ramp, attrs, outline, group, edge, dither)`：ramp 从暗到亮，如 `' .:+*%#@'`；attrs 每档一个亮度，提亮优先靠它，不靠更花的字；outline 取 `'cloud'`（斜坡一律 ( )）、`'round'`、`'straight'` 或 `None`（只按调子，不描边）；group 相同的材质之间不描边；edge 固定轮廓字的亮度
  - 形状：`circle(col, row, r)`（r 按列数，自动按格子比例变圆）、`ellipse()`、`poly()`、`shape()`（平滑闭合）、`rect()`；调子：`sphere_tone()`、`radial_tone()`、`ramp_tone()`
  - 作画：`fill(mask, 材质, tone)`、`erase(mask)`、`stroke(点列, 材质, width, glyph)`；`puffs([(col, row, r), ...], 材质, light, amb, base, flat, base_dark)` 一朵云，base 用整数行，平底打成一根 _
  - `compose(region)` 选字，`reveal(r0, r1)` 把选好的字一段段放进屏幕；`put(col, row, s, attr)`、`sprite(col, row, 行列表, attr, attrs, swap)` 手摆的小件（星、雨、房子、灯塔、开灯的窗），sprite 行内的空格不透明
- 图表：`plot(col, row, w, h, xs, ys, xlim, ylim, attr)` 每列一个扫描线横条、每行 5 档高度，返回 `at(x, y)` 把数据坐标换成格子坐标，方便标注；`bars(col, row, h, values, vmax, attr)` 八分块柱
- 显像管：`trail(col, row, s, level)` 余辉（前一帧约 0.32、再前一帧约 0.10）；`burn(col, row, s, depth)` 烧屏，放在反白条的空白处最好认；`tear(row, dx, lines)` 行同步错位；`power(on)` 关机时只剩玻璃和倒影；`brightness` 光栅底亮
- 动图阶段：关机 → 开机光栅 → 敲命令 → 标题 → 字符画一段段出来 → 曲线 → 柱和轴 → 结论；`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度
- 常量 `LEVELS PHOSPHORS SCAN EIGHTHS PUTTY ROM_CHARS`

**热成像 `Thermal`**：
- 思路：热像仪看不见颜色和光，只看见每个表面有多热，所以不画 RGB，分三步：先画一张温度场（°C，传感器分辨率的 2 倍）；再让它经过一台非制冷热像仪（镜头模糊、按像元采样、噪声和竖条纹、中心偏凉、细节增强、自动增益）；最后用伪彩色板上色，叠清晰的 OSD。坐标都用画布像素，温度用摄氏度
- 构造：`Thermal(W, H, sensor=(640, 360), ss=2, seed, ambient=21)`；sensor 越小越有热像仪的糊，范例用 480×270
- 形状 → 遮罩：`poly(pts)`、`shape(pts)` 闭合样条、`rect(x0, y0, x1, y1, r)`、`ellipse(cx, cy, rx, ry, rot)`、`blob()`、`line(pts, width)`；用 `*`、`1 - m`、`np.clip(a + b, 0, 1)` 组合
- 温度场：`ramp(p0, t0, p1, t1, ease)` 线性渐变、`radial(cx, cy, rx, ry, t0, t1, power)`、`texture(scale, seed)` 噪声；`room(top, bottom, y_top, y_bottom)` 背景空气分层（上暖下凉）
- 物体：`surface(mask, temp, emissivity, reflected, grain, soft, fuzz, limb, limb_px)`：temp 可以是数或 ramp / radial 场；emissivity < 1 的抛光金属读数被拉向反射温度（默认室温）；grain 材料不匀（°C）；fuzz 毛边；limb 圆形物体在轮廓处变凉。`warm(mask, dT)` 加减热；`seam(pts, dT, width)` 门缝、砖缝、折线
- 热往外走：
  - `soak(mask, temp, reach, strength, onto)`：热晕渗进周围表面（先 soak 再画物体本身，onto 限定承受的表面）
  - `plume(path, temp, w0, w1, opacity, cool, eddy, wisp, puffs, seed, fade_out)`：沿路径的热气 / 蒸汽 / 冷气，越走越宽、越凉、越碎；temp 低于室温就是冷气（路径朝下）；`rise(x, y, height, sway, lean)` 生成一条往上飘的路径
  - `pool(x, y, temp, reach, spread, tongues, squash, width)`：落到地上铺开的冷（暖）气舌，spread 是地面上的方向范围（0 = 向右，90 = 朝镜头）
  - `prints(steps, temp, size, squash, spread)`：余温脚印，steps = [(x, y, 朝向°, 比例, 年龄 0 新 .. 1 没了)]，越旧越淡越散；`paw()` 单个爪印遮罩
  - `reflect(region, axis_y, strength, blur_px, fade)`：釉面地砖倒映上方更热的东西
- 相机：`camera(palette, span, agc, plateau, curve, netd, fpn, optics, dde, dde_clip, narcissus, pixel, saturate)`
  - palette：iron / rainbow / white_hot / black_hot / arctic；span=None 时按画面自动定上下限
  - agc：直方图均衡（平台限幅）占的比例；curve=[(°C, 0..1), ...] 是手调色调曲线，替代线性 span，要让房间、猫、灶台各占一段颜色时用它
  - netd、fpn：时间噪声和竖条纹（°C）；optics：镜头模糊；dde：细节增强（只放大小温差）；narcissus：中心偏凉；pixel：保留多少传感器像素格
- OSD（调用时记下，出图时按该阶段的传感器图像读数，数字和颜色永远对得上）：
  - `statusbar(rec, date, clock, battery, emissivity, mode, height, reflected)`
  - `scalebar(x0, y0, x1, y1, ticks, height)`：宽 > 高是横向；刻度按增益曲线的非线性位置放，挤在一起的自动跳过；给 height 时底部加半透明条
  - `spot(x, y, label, name, side, r)`、`box(x0, y0, x1, y1, label, name)`、`hottest(region)`、`coldest(region)`、`profile(p0, p1, inset=(x, y, w, h), label, name)` 线剖面 + 插图、`results(x, y, width)` 读数表、`reticle()`、`text()`
- `level(v)` 某个温度落在色板的哪个位置；`stage(name)` 只存温度场和 OSD 条数，`save(path, stages_dir)` 统一用最终的增益出所有快照，颜色不会在阶段之间跳；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**代尔夫特蓝瓷砖 `DelftTile`**：
- 思路：照作坊工序画一面锡釉砖墙——白坯砖排在一张从来不完全横平竖直的网格上；用刺孔纸样拍炭粉留下点线（粉印）；trek（勾线）用细长笔沿粉印勾轮廓；再用稀钴蓝大笔晕染（生釉吸水快，染色不能晕开，留下笔道、鬃毛丝、干边积色、叠染变深、和轮廓错位）；没烧之前颜料是灰黑色、釉是哑光粉白；入窑后釉面变亮，颜料按每通道 Beer–Lambert 吸收变成钴蓝，洇进釉里、带细颗粒。只有一种透明颜料，所以从前往后画，用 `occlude()` 留出前面的东西。每块砖单独画、单独烧：砖缝处线条错开一两像素，每块砖的白和蓝都不同；单块砖四角各画四分之一角饰，四块拼在一起才是一朵。墙面是高度场：每块砖略鼓、略斜，倒角打光，窗户倒影碎成弯曲的几片
- 构造：`DelftTile(W, H, seed, tile=128, joint=3.6, origin=(0, -36), ss=3, glaze=(冷白, 暖白), mortar, light)`；tile 是砖距（约 13 cm 一块），origin 让砖画对齐网格；`tableau(i0, k0, i1, k1)` 指定连成一幅画的砖（i0 ≤ i < i1），返回外框像素；`rect(i, k)`、`centre(i, k)`、`visible()`、`in_tableau(i, k)`
- 图层：`layer(名字)`，每层分 trek（线）和 wash（晕染）两份；`stage(name, hide=(…))` 可以隐藏层名（'single'）、种类（'wash'）、具体某份（'picture.wash'）、粉印（'pounce'）或全部（'*'），用来重演作坊工序
- 笔：
  - `trek(点列, width, dens, taper, wobble, smooth, pounce, bead)` 勾线：落笔有小墨珠、收笔变尖、往下走的笔画更粗、手有点抖，同时记下粉印点；`line(p0, p1, bend)`、`closed(点列)`、`dot(x, y, r)`；
  - `wash(形状, tone, angle, pool, ragged, slip, band, streak, grad, holes)` 晕染：形状可以是多边形、多边形列表或整幅遮罩；tone 约 0.1 淡到 0.5 深；angle 是笔道方向；`grad=((x0, y0), (x1, y1), f0, f1)` 沿一条线渐变；`holes=[多边形]` 留白；
  - `hatch(形状, angle, spacing, width, dens, wave)` 排线（阴面、帆、茅草、船身）；
  - `letters(字, x, y, size, font='serif', spacing)` 手绘字
- 遮挡：`occlude(形状, grow)` 把画好的东西的轮廓留出来，之后的线和晕染自动避开；`clear_occlusion()`
- 图案（代尔夫特常见题材，坐标都是画布像素）：`windmill(x, 地面y, 轮毂高, sails, squash, cloth)` 带回廊的罩式风车（squash < 1 让风叶转向左前方）；`sailboat(船尾x, 水线y, 船长, facing, belly, cargo, skipper, pennant, leeboard)` 平底帆船（斜桁主帆、前帆、披水板、桅顶三角旗、货袋、舵手），返回船体轮廓；`house(x0, x1, 地面y, 墙高, gable='step'|'bell'|'neck'|'spout', gable_h, floors, chimney, smoke=(dx, dy), vane=-1, shade='right')` 运河屋（十字窗、门、吊货梁、砖缝短线、烟、风向鸡）；`tree(x, 地面y, h, w, lean, clumps)`；`bushes(x0, x1, y, h, gap)` 地平线上的远树；`tulip(x, 地面y, h, lean)`；`cloud(cx, cy, w, h, lean)`；`birds([(x, y), …])`；`water(x0, x1, y0, y1, far, near, avoid)` 远密近疏的水纹；`reflection(x, 水面y, w, depth)`；`grass()`；`smoke()`；取点工具 `arc()`、`ellipse_pts()`
- 单块砖：`field(tiles=None, corners='spin'|'lelie'|'dot', medallion=True, motifs)` 给砖画以外的每块砖画四角的四分之一角饰、双圈圆框和小图（'tulip' 'ship' 'mill' 'boat' 'fish' 'bird' 'house' 'pot'，和左、上邻砖不重复）；也可以单独用 `corner()`、`medallion(i, k)`、`vignette(i, k, kind)`
- 边框：`border(rect, band, inset, tone, leaf, reserve=[卷轴形状])` 砖画外一圈蓝边框：藤蔓、叶子、浆果留白，四角玫瑰花，reserve 给题字卷轴留白
- 工序：`fire()` 入窑（灰黑颜料变钴蓝、釉面变亮、颜料洇开带颗粒、粉印烧掉、每块砖钴蓝浓淡不同）；`set_wall()` 石灰浆勾缝；`age(craze, chips, specks, nails, cracks=[点列])` 开片、铁斑和针孔、崩瓷、四角裁坯模板的钉孔、只在一块砖里的裂纹；`light(window=(x, y, w, h), strength=0.5, panes=(2, 3), soft=8)` 窗户在釉面上的倒影，x, y 是墙面完全平整时倒影所在的位置；倒影按滤色叠在釉面上，画面透得出来；放在画了东西的地方（云、边框）才看得出，纯白釉上几乎看不见
- `stage(name, hide)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度
- 常量 `COBALT_K`（烧成的钴蓝吸收系数）、`RAW_K`（生颜料）、`GLAZE_COOL GLAZE_WARM RAW_GLAZE MORTAR BED BODY`

**洞穴壁画 `CavePainting`**：
- 思路：颜料是涂上去的，不是凿出来的（和岩画相反）：浅色石灰岩高度图 + 一层层颜料覆盖场（乘进 albedo，石头的斑驳透出来），最后只用地上的篝火和油灯照：每盏都是点光源，半 Lambert 明暗 + 平方反比衰减 + 逐像素沿光线步进的投影（掠射光让每个鼓包都显形）、湿钙华上的高光、凹处一点冷色环境光；再叠火焰发光、泛光、烟和色调曲线。光照缓存，只有高度图变了才重算
- 构造：`CavePainting(W, H, seed)`
- 洞壁：`wall(colour, relief, scallops, grain)` 石灰岩（大起伏、岩脊、溶蚀扇贝纹、颗粒、小坑、赭色和灰色斑、凸处钙华皮）；`boss(x, y, rx, ry, height, rot)` 鼓包（把野牛的肚子、马的侧腹画在上面）；`fold(pts, height, soft, side)` 岩面转折；`flowstone(x0, x1, top, length)` 钟乳石帘（橙色条纹、湿亮）；`crack(pts, width, depth, branches)`；`floor(y, tilt)` 朝观者倾斜的泥地；`floor_h(x, y)` 地面高度
- 火与道具：`fire(x, y, size)` 篝火（石圈、灰、辐射状的柴、火舌、火星、烟柱 + 主光源）；`lamp(x, y, size)` 红砂岩油灯（碗、柄、油面、灯芯小火 + 第二光源）；`stone(pts, colour, height)` 石板 / 石子；`heap(x, y, r, pigment)` 研磨颜料堆；`stick(p0, p1, width, colour, hollow, tip)` 炭条 / 空心骨管（hollow=True，tip 是管口的颜料）
- 起稿（单位坐标，facing 1 朝右 / −1 朝左，size 是身长）：`bison(x, y, size, facing, head_drop)`、`horse(…, gait='run'|'gallop'|'stand')`、`deer(…, kind='stag'|'hind', gait='leap'|'stand')`、`hunter(x, 脚底y, 身高, facing, pose='throw'|'run')`（`anchors['grip']`、`['spear_dir']` 挂矛）、`spear(p0, p1, width)`、`hand(x, y, size, rot, side, spread, fold=(3, 4))`（腕部为原点、手指朝上，fold 是弯下去的手指）、`shape(...)` 自定义；返回 `Figure`：部件 body / legs（只算身体轮廓以下）/ tail / horns / antlers / mane / ears，区域 head / hump / belly / back / front；`fig.sel('head', 'mane')` 取一部分，`fig.anchors['eye']` 等
- 上色（都接受 Figure 或 `fig.sel(...)`）：
  - `sketch(fig, width, passes, strength)` 炭条找形线（每遍沿略微游移的轮廓）；
  - `blow(t, 颜料, density, edge, halo, speckle, rim, gradient, relief, clip, exclude)` 吹喷：软边、晕、雾点、不匀；rim 靠轮廓更浓，gradient 背上更深，relief 在背向火光的岩面上更浓（借岩面起伏），clip 不出界，exclude 留出浅色肚子；
  - `daub(t, 颜料)` 毛皮垫拍涂；`paint(fig, 颜料, kind)` 把猎人、矛整形涂实；`line(pts, width, 颜料, kind='charcoal'|'finger'|'brush')`；
  - `outline(fig, 颜料, width, top, gaps, kind='charcoal'|'blow')` 收边：轮廓内侧一条带，背上和上沿粗、肚子细、有断笔；
  - `dots(pts, r, 颜料)` 掌印点；`stencil(hand, 颜料, spread, puffs)` 吹喷负手印；`handprint(hand, 颜料)` 正手印
- 颜料：`PIGMENTS` 的 red 赤铁矿红赭 / darkred / orange / yellow 针铁矿黄赭 / brown / black 炭黑 / manganese 锰黑 / white 高岭土，或 '#rrggbb'
- 岁月：`calcite(x, y, rx, ry, amount)` 钙华乳白薄膜（盖在画上）；`flake(n, size, min_load)` 零星掉色；`claws(x, y, angle, n, length, spread)` 洞熊爪痕（新鲜浅色沟，划穿颜料）；`soot(x, y, amount, drift, spread)` 篝火熏出的烟柱和顶壁
- 顺序：wall → boss / fold / flowstone / crack → floor → fire / lamp / 道具 → sketch → 红、黄（blow / daub）→ 黑（blow / outline / line）→ 猎人、手印、点 → calcite / flake / claws / soot
- `stage(name)` 立即合成快照，`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**1-bit 早期画图软件 `MacPaint`**：
- 思路：画的不是「像素风插画」，是一台 1984 年式黑白画图软件的整屏。640×360 帧缓冲只有黑白两值，×3 最近邻放大到 1920×1080。文档位图 `doc`（1 = 黑）里的一切都按当年工具的规矩画：8×8 图案贴着文档原点平铺（同一图案的两块天然对缝，图案不随形状弯）；线是方笔头 Bresenham；形状 = 图案填充 + 画在轮廓内侧的边框；油漆桶是 4 连通泛填；文字关掉抗锯齿，样式是对字形遮罩做位运算。界面在渲染时才画，所以每个 `stage()` 都能换工具、图案、光标、菜单
- 构造：`MacPaint(seed, title='untitled', menus=(...), screen=(640, 360), scale=3, ink, paper, doc=None, scroll=(0, 0))`；文档坐标原点是窗口内容区左上角，默认 554×246
- 图案：`PATTERNS` 共 41 种（white / black / gray 50% / light 25% / lighter 12.5% / mist / faint / dark / darker，dots、polka、hlines、vlines、diag、rdiag、thick_diag、grid、xhatch、bricks、scales、weave、basket、diamonds、shingles、waves、zigzag、stars、sprigs、checker、gingham、hstripes、vstripes、wood、grass、pebbles、circles……），图案板显示其中 `PALETTE` 38 种；`paint(mask, 图案, mode='opaque'|'or'|'erase'|'invert')`；`bands(mask, [图案…], y0, y1)` 用几条图案带做「渐变」，接缝处交错打散
- 形状工具（都返回遮罩）：`rect(x0, y0, x1, y1, fill, line, radius)`、`oval(cx, cy, rx, ry, fill, line)`、`shape(点, fill, line, smooth)` 自由形 / 多边形；`line(p0, p1, width)`、`pencil(点, mode)`、`brush(点, size, shape='round'|'square'|'slash'|'backslash'|'bar'|'vbar'|'dot', pat)`、`spray(点, radius, density, pat, clip)`、`bucket(x, y, 图案)`、`dotted(点, gap, size)`；遮罩：`mask_rect / mask_oval / mask_poly / mask_path`、`border(mask, w)` 内侧边框、`pen(mask, w)` 方笔加粗
- 编辑：`copy(rect, to, flip, mask)` 选取 + 拖动复制（flip 是左右翻转，mask 相当于套索选取，背景不跟着走）、`invert(rect 或 mask)` XOR、`erase(rect 或 mask)`
- 文字：`text(s, x, y, size, font='system'|core 字体风格, style=('bold', 'italic', 'underline', 'outline', 'shadow'), anchor='l'|'m'|'r', opaque)`；'system' 是自带的粗体点阵字（大写 9 px 高、2 px 竖笔，只有拉丁字母、数字和少量符号），其他字体走 `core.load_font` 并关掉抗锯齿；outline / shadow 是空心字
- 界面状态（下一次 `stage()` 生效）：`use(tool, pattern, line)` 反白工具（`MacPaint.TOOLS` 里 20 个名字）、当前图案、线宽打勾；`cursor(kind, x, y)`（arrow / cross / ibeam / bucket / spray / brush / pencil，kind=None 隐藏）；`select(rect=…)` 或 `select(lasso=mask)` 行军蚁；`menu(名字, items, checked, hilite, styled)` 下拉菜单，styled=True 时每项按自己的样式写，`menu(None)` 收起；`zoom(x, y, w, h, at, fat)` 放大镜窗，`zoom(None)` 关掉；`retitle(标题)` 存盘改名
- `render()` 返回 640×360 的 0/1 屏幕，`image()` 放大后的 PIL 图；`stage(name)`、`save(path, stages_dir)`（JPG 默认 quality 88，纯黑白时存灰度）
- 动图：帧是纯黑白，缩到 720 宽用 BOX、配固定灰阶调色板（不要用默认的 LANCZOS + 中值切分）

**古希腊黑绘陶瓶 `BlackFigure`**：
- 思路：先在轮上拉出一只陶瓶（轮廓 r(y) 加两只圆把手），所有彩绘都画在「展开面」上（绕瓶一周的弧长 × 高度），同一张展开面既包到曲面瓶上，也能平铺成展开图，两边永远一致。工序照古代作坊：轮上画饰带 → 泥釉画剪影 → 刻线 → 加红加白 → 三段烧成（泥釉这时才变成亮黑）→ 做旧 → 按博物馆照片打光
- 构造：`BlackFigure(W, H, seed)`；`museum(wall, plinth, spot, plinth_x)` 深色展墙、聚光、浅色展台；`pot = throw(cx, foot, height, rmax=None, shape='neck_amphora', eye=0.42)`：foot 是瓶底落在展台上的屏幕 y
- 瓶上的坐标：`y` 是从口沿往下的像素；饰带里的 `x` 是该圈半径处的弧长像素，0 在左把手，正面（看得见的半圈）是 0 .. C/2，背面 C/2 .. C；`pot.TW` 是展开面宽度（按最大半径），`pot.radius(y)`
- 轮制与纹样：`pot.paint_handles()`；`pot.band(y0, y1)` 转着画的黑带（水平、收笔处有一点搭接）；`pot.palmettes(y0, y1, n)` 棕榈叶 + 莲花垂花链；`pot.tongues(y0, y1, n, red_every=2)` 肩部舌纹；`pot.meander(y0, y1, n)` 回纹；`pot.rays(y0, y1, n)` 瓶脚放射纹
- 人物：`z = pot.zone(y0, y1)`，`z.C` 是这一圈的周长；`z.quadriga(x, hw, white_horse, red_manes, bends)` 四马战车（x = 最近那匹马的肚带，hw = 马高）；`z.runner(x, height, phase, beard, back_arm)`；`z.column(x, height, red)` 多立克柱（折返柱 / 终点柱）；`z.judge(x, height, facing=-1, holds='wreath'|'rod')`；`z.tripod(x, height)` 奖品三足鼎；`z.prize_table(x, height)` 摆着小双耳瓶和花冠的桌子；`z.bird(x, y, size, facing, flap)`；`z.letters(text, x, y, size, vertical, retro)` 古阿提卡字母（细笔泥釉写，可反写）
- 自己画新人物：建一个 `blackfigure._Fig()`，用局部单位（脚在 (0, 0)，朝 +x，y 向下）按由远到近调 `slip(poly)` / `cut(pts, w)` / `red(poly)` / `white(poly)` / `reserve(poly)` / `line(pts, w)`，再 `z.emit(fig, X, G, scale, facing)`；线宽是像素（刻刀和细笔的宽度不随人物缩放）
- 三遍上色：`pot.paint()` 刷泥釉剪影（只画新声明的）；`pot.incise()` 刻线；`pot.add_colour()` 加红加白。后两遍按声明顺序重放：近处的黑剪影会盖掉远处的刻线和加彩，再刻出自己的轮廓——四匹马叠在一起也分得清
- `pot.fire()` 烧成；`pot.age(mend=(u, v, rx, ry), misfire=(u, v, r), chips=7, roots=14)`：u, v 是展开面像素（正面中心 u = TW/4）
- 展板：`panel(box, title, subtitle, english, greek)`；`rollout(pot, bands, x, y, scale, half=0|1, caption, ticks)` 把几圈饰带按各自周长展开成上下居中的几条（half 0 = 正面，1 = 背面）；`legend(x, y, [(label, 'clay'|'black'|'incision'|'red'|'white')])`
- `stage(name)` / `save(path, stages_dir)`；每次 stage 都按陶瓶当时的状态重新打光渲染（几何只算一次）

**铅笔素描 `Graphite`**：
- 思路：石墨是一张「质量场」`m`，看到的深浅是 Dmax·(1 − e^−m)，层层叠加但永远到不了黑；石墨是冷灰不是黑，重压处被压亮（`b`），在斜光下带一点银灰的反光。铅笔只在笔尖碰到纸的地方留下石墨：轻压只擦过纸纹的峰（灰里透着白点），重压和软铅才填进纸纹的谷。每一笔都有起笔、加力、收笔，越往纸边画得越少
- 构造：`Graphite(W, H, seed, ss=2)`；`paper(tone, tooth=1.6, felt, mottle)` 素描纸（纸纹高度场、斜光下的微浮雕、左上亮的光线落差）
- 铅笔硬度 `GRADES`：'4H' 'H' 'HB' '2B' '4B' '6B' '8B'，决定每笔多少石墨、能压进纸纹多深、线多宽；越硬越淡越细、纸纹越白
- 遮罩和调子场：`poly(pts)`、`ellipse(cx, cy, rx, ry, rot)`、`ring(cx, cy, r0, r1)`、`band(pts, width)` 粗线（管子、杆）、`lines_mask(lines, width)` 一批细线、`rect()`；`linear(p0, p1)` 从 0 到 1 的渐变、`radial(cx, cy, r)`；`circle_pts(cx, cy, rx, ry, a0, a1, rot)` 椭圆弧上的点（度，屏幕顺时针）
- 完成区：`focus(cx, cy, rx, ry, soft, rough)`：参差的椭圆里画完，往外调子按 finish^0.6 变淡、排线和侧锋整笔整笔地丢，线条变淡，纸边只剩线稿；各方法 `finish=False` 时不受它影响
- 起形：`guide(p0, p1, grade='2H', overshoot)` 两头出头的长辅助线（视平线、透视线、铅垂线）；`guide_ellipse(cx, cy, rx, ry, rot, loops=2)` 绕两三圈的松椭圆加轴线
- 线：`line(pts, grade, pressure, closed, searching, lost, weight, fade=0.35)`：压力沿线起伏；`lost` 让亮面的边断开；`weight` 是一张场（如背光面），高的地方线更重更粗；`searching` 先轻轻找几遍；`strokes(lines, grade, pressure, width, taper, clip, fade)` 一批自由笔画（辐条、链节、篮子的编条）
- 排线：`hatch(mask, tone, angle, grade, spacing, length, layers=(0, 0, 58, -38), pressure, zigzag, edge)`：tone 0 纸白 .. 1 最暗（数或场）；layers 是每层的角度偏移，同一角度重复一次就插在前一层的两线之间，第 k 层只在 tone > k/层数 的地方下笔，越暗压得越重；一块一块地排（每块共用略有漂移的接缝），手腕弧让每笔同向微弯，起笔重收笔挑；`zigzag` 来回不抬笔的连笔排线。`contour_hatch(lines, mask, tone, grade, pressure)` 顺着形体走的笔画（绕车胎、沿管子、沿面包）
- 侧锋：`shade(mask, tone, angle, grade='4B', width=9, pressure, passes=3)` 钝软铅的侧面，宽而软的笔触三遍交叠，只挂在纸纹峰上——晕染前的底色
- 纸擦笔：`smudge(mask, amount, radius, direction, length, pickup, contain=True)` 把石墨推进纸纹谷、往旁边匀开（可顺一个方向拖），颗粒消失；contain 时只在遮罩里匀，不把旁边的空白抹进来
- 橡皮：`lift(mask, amount)` 可塑橡皮按出柔和的亮；`erase(pts, width, amount, soft)` 硬橡皮边擦出清楚的白线（轮圈、管子高光、转角亮边、玻璃反光），会留一点残影
- 页边：`write(s, x, y, size, grade, pressure, font='hand')` 铅笔手写；`value_scale(x, y, w, h, grades)` 试笔色阶（每格一种硬度、下面写标号）；`fingerprint(x, y, r, rot, amount)` 石墨指纹；`smear(pts, width, amount)` 手侧蹭过的灰
- `stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度；颜色常量 `PAPER GRAPHITE SHEEN`

**X 光片 `XRay`**：
- 思路：不画物体的样子，只建「沿射线方向有多厚的什么材料」。每样东西往两张衰减图里累加 μ(材料, 能量) × 密度 × 沿射线的长度（双能：低能约 60 keV、高能约 120 keV），没有先后遮挡，重叠就相加；再按比尔定律 I = e^(−A) 让射线穿过去，经过探测器（散射雾、焦点模糊、线阵探测器逐行增益条纹和每 64 行的模块缝、光子噪声），最后进显示（胶片：越密越亮；或安检伪彩：按 Zeff 分有机橙 / 无机绿 / 金属蓝 / 穿不透黑）。轮廓发光不是画上去的：空心壳体在轮廓处被射线沿侧壁穿过，路径最长
- 构造：`XRay(W, H, px_cm=17, seed)`；所有长度都是画布像素，包括沿射线的深度，`px_cm` 定物理比例。材料表 `MATERIALS`：organic、water、rubber、pvc、pcb、magnesium、mica、glass、aluminium、bone、plaster、ferrite、zinc、steel、brass、copper、tin、lead
- 轮廓：`rrect(cx, cy, w, h, r, rot)`、`ellipse(cx, cy, rx, ry, rot)`、`poly(pts, cx, cy, rot, scale)`（局部坐标搬到画布）、`closed(ctrl)` 闭合样条、`path(ctrl)` 开放样条（点可带第三维深度 z）、`offset(P, d)` 侧移
- 物体：
  - `slab(outline, material, depth, edge, holes, density, tag, texture)`：实心，边缘按半径 edge 倒圆（默认 depth/2 像卵石，0 是锯切边）；holes 打穿的孔；density 可以为负（钥匙上铣出的槽）
  - `shell(outline, material, depth, wall, edge)`：空心壳（箱子、吹风机外壳、相机机身），轮廓发亮、中间淡
  - `rod(P, material, r, wall, ribs, flat)`：沿路径的圆线 / 圆棒，r 可逐点渐变；wall 变管子（两边亮中间暗）；P 带 z 时沿射线潜下去的段更亮；ribs=(幅度, 周期) 螺纹、双重螺旋、绞合线的起伏；flat 扁带（可以是弧长的函数）。`tube(P, m, r, wall)` 同上
  - `coil(p0, p1, R, turns, material, r_wire)` 弹簧 / 电热丝（侧看：转折点亮、前后两半成之字）；`edgeon(p0, p1, thick, material)` 侧看的圆片（风扇、格栅、滤网）；`disc(cx, cy, r, material, depth, hole, rim, dome)` 正看的圆片（硬币带凸边、垫圈、镜片 dome>0 中厚、镜筒圆环正对射线全是壁）；`ball()` 滚珠
  - `zipper(P, material, tooth, pitch, depth, tape)`、`screw(p0, p1, r, head, pitch)`、`cable(P, r, cores, core_r)`
  - `fabric(outline, depth, layers, sheet, density, weave, scale, angle, creases)`：叠好的衣服，折边处布翻过去成软亮边；`weave('plain' | 'twill' | 'knit', scale, angle, amount)` 也可单独给 `slab(texture=)`
  - `belt(y0, y1, lacing=x)`：传送带（纵向帘线纹）、两侧钢导轨和螺栓、钢钩接头；它的衰减记作空气校准，伪彩视图里自动扣掉
- 探测器和显示：`scan(kv, ma, flux=(低能, 高能光子数), scatter, scatter_px, focal, streak, module)`；`film(a0, amax, mix, edge=(细, 粗), glow, vignette, stops)`；`detect()` → (A'_lo, A'_hi)，`show_film(Lo, Hi)`、`show_material(Lo, Hi)`、`zeff(Lo, Hi)` 可单独用
- OSD：`status(left_lines, right_lines)` 顶栏；`footer(left, right)` 底栏（(文字, 颜色)，琥珀 / 绿 / 红自动加底色块）；`flag(x0, y0, x1, y1, n, label, note, side)` 编号报警框；`panel(x0, y0, x1, y1, title)`；`inset(src, dst, 'material' | 'film', title)` 任意区域的插图；`legend(x, y, w)`；`scale(x0, y0, x1, y1, [(标签, 材料, 厚度px)], title)` 衰减标尺（刻度按同一条显示曲线算）；`text()`、`line(pts, dash=)`
- 读数：给物体加 `tag='名字'`，OSD 文字里写 `{名字.z:.1f}`（Zeff）、`{名字.ml:.0f}`（按水折算的体积）、`{名字.cm2}`；出图时从该阶段的探测器图像上量（物体外一圈扣背景），数字和画面永远对得上；`x.readings` 留着最后一次的读数
- `stage(name)` 存 float16 的两张衰减图和 OSD 条数；`save(path, stages_dir)` 每个阶段用同一张噪声出图，阶段之间只有新加的东西在变；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**1930 年代黑白橡皮管动画 `RubberHose`**：
- 思路：照 1930 年代动画厂做一格画面的方式：背景师在板上用灰色水粉画一次背景（平涂 + 干笔刷纹、喷枪光斑和接触阴影，背景线细而灰）；动画师铅笔起稿（两遍、略错开，带结构圆、十字线和动势线）；描线员用黑墨描到赛璐璐上（粗而均匀，压力略有起伏）；上色员在背面涂几档平灰（白、浅、中、深、黑，赛璐璐上不画明暗）；叠在背景上用黑白胶片拍下、印成拷贝、放映很多遍。赛璐璐不透明、从后往前画，后画的挡住先画的；角色要从「后面」经过的背景部分（窗外近山、窗横档、窗帘、被子）存成 clip 遮罩
- 构造：`RubberHose(W, H, seed, ss=2, ink_w=5.5)`（内部 2 倍超采样）；灰阶常量 `WHITE LIGHT PALE MID DARK BLACK INK`
- 背景（画在板上）：`wash(pts, value, value2, axis, tex, line, dark)` 平涂 / 渐变水粉 + 细灰轮廓；`blob(circles, value)` 圆的并集（云、树冠），只描外轮廓；`line(pts, width, dark)`；`airbrush(cx, cy, rx, ry, amount)` 喷枪光斑（正提亮、负压暗）；`light(pts, amount, soft)` 软边光块（地上的阳光、窗档影子）；`pattern(pts, draw_fn, dark)` 小花样（壁纸、波点；dark < 0 提亮）
- 房间：`wall(y1)` 渐变墙纸 + 竖条 + 小枝花 + 踢脚板；`floor(y0, board, vp)` 透视地板、接缝、木纹；`window(x0, y0, x1, y1, bars='sash'|'cross', horizon, valley)` 窗外的早晨（天空、云、远山、树、近山；近山和窗档进 'window' clip），返回几何；`curtain(...)`、`valance(...)` 窗帘和帘头（也从 clip 里减掉）；`nightstand(x0, x1, top, bottom, floor_y)` 返回桌面 y；`bed(x0, x1, head_top, sheet_y, front_y, floor_y)` 从床尾看的床（拱形床头、球形柱头、绗缝被、垂下的被边；被子进 'bed' clip）；`rug(cx, cy, rx, ry)` 编织地毯；`sampler(x0, y0, x1, y1, lines)` 挂墙的格言框
- clip：`clip(name, add, sub, full)` 建遮罩；角色方法的 `clip=`，或 `using(name)` … `using(None)` 把之后的赛璐璐都放进某个 clip
- 赛璐璐基本件：`shape(pts, fill, ow)`（墨线只在填色外侧；fill=None 只描线）；`union(subs, fill, ow)` 几块拼成一块、中间不出线（`('poly', pts)` / `('cap', pts, r)`）；`hose(pts, width)` 等粗、没有肘和膝的橡皮管；`stroke(pts, width, taper)`；`text(s, x, y, size, fill, ow, rot)`；`shadow(cx, cy, rx, ry, amount)` 角色脚下的灰影；`guide(pts)` 只出现在铅笔稿里的结构线
- 橡皮管词汇：`hose_path(p0, p1, bend, bend2)` C 形 / S 形四肢；`glove(x, y, angle, size, pose='open'|'point'|'fist'|'palm', flip)` 四指白手套（三道缝线、外翻袖口；(x, y) 是手腕，angle 是手指方向）；`shoe(x, y, size, facing, tilt)` 大圆鞋（白高光、灰鞋底）；`pie_eye(cx, cy, rx, ry, look, wedge, lid)` 白眼眶 + 切掉一角的黑瞳，lid 是半闭的眼皮；`grin(F, x0, x1, y_top, y_bot)` 张大的笑嘴带舌头；`star()`；`Frame(x, y, s, rot, flip)` 局部坐标
- 角色：`alarm_clock(cx, cy, r, tilt, look, time=(7, 0), arms=[...], legs=[...])` 双铃闹钟（黑表壳、白表盘上的脸、指针、两只铃和甩动的铃锤；arms / legs 给手腕 / 脚踝位置和 bend、pose、facing、tilt），返回局部 Frame，`rh.bells` 是两只铃的位置；`sun(cx, cy, r, arms, ray_style='wavy'|'spiky', clip)` 半睁眼打哈欠、伸懒腰的太阳；`pillow(cx, cy, w, h, arm, clip)` 戴条纹睡帽打呼、举起手套的枕头；`slipper(x, y, size, facing, tilt)` 跳舞的拖鞋
- 特效：`vibration(cx, cy, r, a0, a1, n)` 同心震动弧；`speed_lines([pts])`；`lettering(s, path, size)` 沿曲线蹦跳的粗衬线字（白字黑边，单双号反向倾斜、上下错开）；`zzz(x, y, size)`；`slab_font(size)` 找 Superclarendon / Rockwell 这类粗衬线字体（可用 `INKPAINT_FONT_SLAB` 指定）
- 顺序与快照：背景 → `stage('layout', view='layout')`（纸上的背景铅笔稿）→ `stage('background', view='background')` → 画角色（此时是铅笔稿）→ `stage('pencil')` → `ink()` → `stage('ink')` → `paint()` → `stage('paint')` → 特效 → `film(grain, soft, halation, tone='silver'|'sepia'|'neutral', vignette, weave, gate)` → `age(scratches, dust, specks, fibres, hair, stains, flicker)` → `save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**黑白麻胶版画 `Linocut`**：
- 思路：减法。整块麻胶版滚上墨，印出来是一整块黑；画里所有白的地方都是刻刀挖掉的。每块版是一张 ss 倍分辨率的浮雕图（255 = 没刻、吃墨，0 = 刻掉了）：黑版一开始是满的，套色版一开始是清空的，只「留下」要印颜色的形状；黑版外圈一道边永远不刻，印出来就是手刻版那圈微微起伏的黑框。每一刀都是一个两头收尖、边缘带碎口的多边形；明暗不靠灰色，靠刀痕的疏密和粗细（黑里刻白线，或白里留黑线）。印的时候按真的手拓算：墨辊滚出的墨层不匀、带几道停辊横纹，木蘑菇压出一圈圈压力；墨层 × 压力压不过纸纹的地方露白（大片实地「发花」），墨被挤到形状边缘，所以边缘始终是实的；先印套色、再叠黑版，两版错开几像素；纸被压进版里，刻掉的地方和页边微微鼓起
- 构造：`Linocut(W, H, block=(x0, y0, x1, y1), seed, paper, ink, ss=2, rim=7)`；`colour_block(颜色, offset=(dx, dy), mottle)` 加一块套色版（颜色写印在这张纸上的样子），返回 `Block`，各工具用 `on=` 指定刻哪块版（默认黑版）
- 遮罩：`poly(pts, smooth)`、`disc(cx, cy, r)`、`rect()` 给 1× 浮点遮罩（可以用 numpy 加减）；区域参数也可以直接给多边形点列；`mask_of(polys)` 把一组刀痕多边形变成遮罩
- 一刀：`stroke(pts, width, tool, taper, end)` 返回刀痕多边形；`gouge(pts, width, tool='v'|'u'|'knife'|'brush', cut=True, on, region)`：v 是 V 口刀（尖入、渐宽、提刀收尖），u 是 U 口刀（圆头、碎尾），knife 是等宽刻刀，brush 的宽度从 width 线性变到 end（树枝、留下的线）；`cut=False` 是留下一条不刻（白地里的黑线）；`jab(x, y, size)` U 刀戳一下
- 成片：`clear(形状, chatter, angle)` 用大 U 刀清掉一片，留下顺下刀方向的残刀印（靠边更多）；`leave(形状)` 留住一片；`hatch(region, angle, spacing, width, dash, gap, tool, cut, density, bend)` 一排排平行刀痕：density(x, y) 决定一刀留不留、多粗（这就是明暗），bend(x, y) 把行推弯（漂雪、等高线、衣褶）；`flow(region, field, n, length, width)` 沿方向场 field(x, y)→角度 的长刀痕（风、水、毛）；`speckle(region, n, size, stars)` 落雪：U 刀戳点加少量三刀交叉的六角雪花，只刻在还有墨的地方；`rings(cx, cy, radii, width, arc, gap, cut, squash)` 断续同心环（月晕、年轮）；`outline(形状, width, cut=True)` 在形状外刻一圈白边，黑东西才能从黑底里分出来（cut=False 是留一圈黑边，白东西穿过白底）
- 物件：`moon(cx, cy, r, rings)`；`pine(x, y, h, w, tiers, snow, halo, nicks, region)` 积雪云杉；`bare_tree(x, y, h, lean, spread, width, depth, halo, snow, seed)` 枯树（返回遮罩）；`cottage(x, base, fw, wall, roof, side, rise, windows, side_windows, door=(u, w, h, 开着), chimney=(位置, 宽, 高), lit=套色版, attic)` 积雪木屋，返回 `{'apex', 'windows', 'door', 'chimney'}`；`smoke(x, y, rise, drift, width)` 一串卷着飘的烟团；`footprints(path, step, size, side, start, stop, paws)` 脚印 / 爪印
- 印：`pull(blocks)` 印出 PIL 图；`sign(edition, title, name, y)` 页边铅笔：左版次、中题名、右签名；`chop(x, y, size)` 不上墨的钢印
- `stage(name, blocks=None)` 快照（`blocks=[]` 是白纸，`blocks=[L.key]` 只印黑版）；`save(path, stages_dir)` 默认 quality 88、4:4:4 色度
- 顺序：和画家算法一样，后刻的盖前面：先清大块白（山、雪野、月亮）→ 天空刀痕 → 远景 → 房子 → 雪地 → 近景人物 → 落雪 → 套色版 → 铅笔

**VHS 家庭录像 `VHSCamcorder`**：
- 思路：不是在画面上盖一层「复古滤镜」（Synthwave 的录像带质感就是这么做的），而是照家庭录像真实的三步出图，每种瑕疵都来自其中一步：
  1. 房间：颜色画进反照率缓冲，灯罩、烛焰、窗外天空画进自发光缓冲；出图时反照率乘上房间的光（暖色环境光 + 点光源 + 画上去的光斑）再加自发光；镜头前太近的东西画在离焦图层上
  2. 摄像机：手持微倾和变焦、白平衡停在「室外」拍钨丝灯、软膝高光、泛光、CCD 竖向拖影、拖尾、镜头柔化、暗角、暗处增益噪声；摄像机的字符发生器在这里把 OSD 混进信号，所以 OSD 也跟着上带、跟着糊
  3. 录像带：降到 480 行 × 760 采样点，分成亮度 Y 和色度 I/Q；亮度低通再加回放锐化（一边亮一边暗的光晕），色度约 6 倍宽的低通、隔行平均、往右延迟（红色往右渗）；回放再加条状亮度噪声、横向色度噪声、逐行时基抖动、顶部偏摆、跟踪噪带、磁头切换噪声、掉磁白点、抬高的黑电平，最后放大回输出尺寸
- 构造：`VHSCamcorder(W, H, seed, lines=480, samples=760, ss=2, keep_stages=True)`；`keep_stages=False` 时 `stage()` 不出快照（快）
- 形状 → 遮罩：`poly(pts)`、`shape(pts)` 闭合样条、`rect(x0, y0, x1, y1, r)`、`ellipse(cx, cy, rx, ry, rot)`、`line(pts, width)`、`text(s, x, y, size, style, anchor, rot)`；颜色场 `lin(p0, c0, p1, c1)`、`rad(cx, cy, rx, ry, c0, c1)`
- 上色与光：
  - `paint(mask, colour, alpha, form, form_r, light)`：colour 可以是颜色场；form > 0 把形状打圆（边缘暗、迎光一侧亮）
  - `emit(mask, colour, level)` 自发光（不受房间光影响）；`glow(mask, colour, level)` 落在表面上的光斑（乘反照率）；`shadow(mask, strength, soft, dx, dy)`；`rim(mask, toward, colour, level, width)` 朝光源一侧的轮廓光
  - `ambient(colour, level)`、`light(x, y, radius, colour, power)` 点光源，1 / (1 + (d/r)²) 衰减
  - `with v.layer(defocus=4.5): ...` 里画的东西整体虚焦（离镜头太近的前景）
- 70 年代客厅：`wallpaper(mask, tile, contrast)` 圆环墙纸带纸幅接缝、`paneling(mask, grooves)` 胡桃木护墙板、`ceiling()` 喷涂天花板、`shag()` 长毛地毯、`window(x0, y0, x1, y1)` 黄昏的窗（剪影、对面一扇亮窗）、`rod()` + `curtain(x0, x1, y0, y1, folds)` 花朵窗帘、`console_tv()` 落地电视柜、`rabbit_ears()`、`floor_lamp(x, y_floor, y_shade)`（自带灯光和墙上的光斑）、`sofa(x0, x1, y_back, y_seat, y_front, y_floor, colour)`
- 派对：`streamer(p0, p1, sag, colour, twists)` 扭转的皱纹纸彩带、`pennants(p0, p1, sag, letters, colours, size)` 字母三角旗（浅色旗自动换深色字）、`balloon(x, y, r, colour, string_to)`、`coffee_table(quad, thick, legs, gloss)`、`cake(cx, cy, rx, ry, h, candles, sprinkles, lean)`（candles = [(角度, 颜色, 'lit' 或 0–1 烟量)]，返回火苗位置，每个放一盏 `light`）、`smoke()`、`present()`、`cup()`、`plates()`、`blower()`、`confetti()`、`teddy()`；`child_back(hx, hy, s, lean, glow_from)` 背影的孩子（尖帽、发旋、耳朵、肘），画在离焦图层里
- 三步开关（调用之后的每个阶段都生效）：
  - `camera(tilt, zoom, white_balance, exposure, knee, bloom, smear, lag, soft, vignette, gain_noise)`：white_balance 是 RGB 增益，默认 (1.08, 0.94, 0.70) 即「室外档拍钨丝灯」；smear 只对远超满阱的点光源起作用；lag = (dx, dy, 强度) 是高光身后的拖尾
  - `record(luma, chroma, chroma_v, delay, sharpen, sharp_r, saturation)`：亮度 / 色度带宽（采样点 σ）、色度延迟、锐化光晕
  - `wear(noise, chroma_noise, jitter, flagging, tracking=(中心比例, 高度比例), head_switch, dropouts, black, lines)`
- OSD（点阵字、黑边，混进信号上带）：`rec(x, y)` 红点 + REC、`battery(x, y, level, of)`、`counter(s, x, y)`、`datestamp(时间, 日期, x, y)`、`zoom_bar(x, y, pos, width)`、`osd_text(s, x, y, px, colour, anchor)`；字库只有大写字母、数字和 `: . - / >`
- `stage(name)` 存一张当前状态的完整渲染；`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**扁平矢量 `FlatVector`**：
- 思路：矢量软件的画板，每样东西是一层。形状边缘干净、没有描边；7 种平涂色，其余颜色都是它们的 `tone` / `mix`；整幅只有一个光源，每样东西分亮面和暗面；每抬起一层，先往已有画面投一道短而柔的夜蓝色阴影（「矢量纸片」的层次），最后加极淡的纤维纹和固定细颗粒（分阶段快照的颗粒一样，动图差分小）
- 构造：`FlatVector(W, H, seed, light=(-0.7, -0.7))`，light 是指向光源的屏幕方向
- 形状：都返回 `Mask`，可以 `|` 并、`&` 交、`-` 减，`moved(dx, dy)`、`scaled(k)`，只算包围盒。有 `circle`、`ellipse(cx, cy, rx, ry, rot)`、`rect(x0, y0, x1, y1, round)`、`poly(pts, round=半径或每角半径)`、`capsule(p0, p1, r0, r1)`、`star(cx, cy, r_out, r_in, n)`、`teardrop(x, bottom, r, h, lean)` 火焰 / 水滴形、`profile(pts, bottom)`（样条顶边往下填满的地块）；`half(m, p0, p1)` 取有向直线右侧的部分
- 上色：
  - `backdrop(颜色)`；
  - `fill(m, 颜色, alpha, lift, texture, shadow)`：lift > 0 时先投层间阴影（下移 0.45 × lift，模糊 0.9 × lift，乘夜蓝紫色调），再铺色；
  - `face(m, p0, p1, 颜色)`：把直线右侧改成暗面色；
  - `glow(cx, cy, rx, ry, 颜色, rings, alpha)`：一圈圈平涂半透明光环；
  - `drop(m, lift, strength)`：只投影不铺色；
  - `tone(c, k)`：k < 0 往夜蓝墨色调，k > 0 往奶油色调；`mix(a, b, t)`
- 天空：`moon(cx, cy, r, rays, ray_colour, ray_len, halo, craters)`，月亮外一圈长短交替的三角光芒，加两圈阶梯光晕；`stars(n, box, avoid=[(x, y, r)])`；`sparkle(x, y, r)` 四角星；`shooting_star(head, tail, r)`；`cloud(cx, cy, w, colour, belly)` 平底云
- 地形：
  - `mountain(peak, left, right, 颜色, snow, ridge, lift, shade)`：折线山脊分亮面和暗面，锯齿雪顶；返回 `dict(body, shade, snow)`；
  - `land(pts, 颜色, lift, shadow)`：一层山丘或沙地；
  - `pine(x, base, h, 颜色, tiers, width)`：层层三角，从中间劈成亮暗两半；`round_tree(x, base, r, 颜色, fruit)`；
  - `dashes(box, colours, n, length, thick, horizon)`：沙地上的深浅短横，越近越长；`pebble(x, y, r, 颜色)`、`tuft(x, y, h)`
- 故事道具：
  - `trail(pts, 颜色, width, dash, gap)`：越往下越粗的虚线小路，返回遮罩，可以 `& peak['snow']` 换色；
  - `flag(x, y, h)`、`tent(x, base, w, h, 颜色, depth, inside)`：亮面正面、暗面侧顶、透光的门、掀开的门帘、拉绳和地钉；
  - `campfire(x, base, s)`；`hiker(x, base, h, facing, lamp)`：没有五官的小剪影，带背包、登山杖、头灯光束
- 色板常量 `NIGHT PLUM BERRY EMBER SAND PINE CREAM`；`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**绘本角色动画 `Storybook`**：
- 思路：动画师的一个镜头，不是一张画。一切都是时间 t（秒）的函数：同一个场景既能逐帧出真动画（`frame(t)`、`gif()`），也能出一张「旅程总图」（`journey()`：世界全部画完，角色在关键姿态上多次曝光，配铅笔运动弧）。场景里每样东西都预先画进自己的裁切层，同时记一张「揭示图」：每个像素在这一层自己的画出过程里第几时刻被笔刷/钢笔碰到——墨线按弧长揭示（笔在走），水彩从一点晕开或横扫过去（带一道略深的湿边），小物件放大弹出（0 → 1.1 → 1）。层的进度来自时间窗 `when=(t0, t1)`，或者 `follow=lead`：画到角色已到达的最远 x 前方 lead 像素，所以山坡、花、河岸正好在角色经过时画出来。角色每帧用隐式曲面在自己的局部坐标里现画：整体做保体积的仿射挤压拉伸（沿轴 k、横向 1/√k）再滚转，`rest()` 让最低点正好落在地面上，光照固定在世界里（滚动时高光不跟着转），离地越高接触阴影越小越淡
- 构造：`Storybook(W, H, seed, actor_size=44)`：所有坐标都按 1920×1080 设计坐标给，输出任意尺寸（720×405 动图和 1920×1080 总图就是同一场景的两个实例）
- 编排：`act(t0, t1, fn)`，fn(u, t) → 姿态 dict 或 None（藏起来）。姿态键：`x, y`（坚果中心）、`rot`（度，逆时针）、`k`（>1 拉伸、<1 压扁）、`axis`（拉伸方向，度）、`scale`、`eyes`（0 闭 .. 1 睁）、`lid`（'blink' / 'sleep' / 'happy' 闭眼形状）、`look=(dx, dy)`、`brow`（'determined' / 'up' / 'worried'）、`mouth`（'smile' / 'grin' / 'o' / 'flat'）、`blush`、`shadow=(gx, gy, 宽, 浓度)`、`clip`（地面 y，以下不画：钻土）、`only='cap'`（只画帽子：树苗顶上）、`lead=False`（不推动 follow 层）、`speed=False` / `speed_min`（自动速度线）。辅助：`rest(gx, gy, rot, k, axis, normal)` 让角色立在地面点上；`anchor(px, py, local, rot, scale)` 让局部点（默认果柄尖）落在某点上（挂在枝头）；`ease(u, kind)`（in / out / inout / sine / back 回弹 / elastic）、`spring(u, cycles, damp)` 衰减抖动、`arc(p0, p1, 高, u)` 抛物线跳跃；`pose(t)`、`lead_x(t)`、`when_at(x, lead, dur)`（角色到达 x 时开始的时间窗）
- 场景：`paper()`；`wash(pts, 颜色, reveal='x'|'-x'|'radial'|'pop', origin, dashes)`；`ink(pts, 宽)` / `inks(paths)` 藏青细墨线（压力收笔、轻微手抖）；`ground(pts, ticks=True)` 地平线加「v」字小草；`land(top, 颜色, left_edge, right_edge, dashes)` 山坡（顶线样条、毛糙的崖边、蜡笔短线）；`hill(top, 颜色, outline)` 远山（只在顶上一条细灰线）；`tree(x, base, top, canopy, branch)` 秋天的橡树；`sun(cx, cy, r)`（圆盘弹出，光芒一根根画）；`cloud(cx, cy, w)` 厚涂白云带淡紫投影；`water(x0, x1, y)` 小河；`shape(polys, 填色, 描边, pop)` 带细墨边的小物件；`flower(x, y, h, kind)`、`tuft`、`cattail`、`leaf_on_ground`、`mound`（土堆，画在角色上面，能把它埋起来）。通用计时参数：`when`、`follow`、`pre=(t0, t1, upto)`（follow 层左边一段先按时间画）、`xa / xb`（follow 的起止 x）、`z`
- 道具：`sprite(polys, 填色, veins=)` 预画一个小道具；`prop(sprite, t0, t1, fn)`，fn → dict(x, y, rot, sx, sy, alpha, ghost)，每帧仿射贴上（飘落的橡叶用 sx 模拟翻面，落水后 sy=0.5 平躺）；`oak_leaf(长, 宽, lobes, base, angle)` 模块函数给橡叶轮廓
- 特效：`fx(kind, t0, x, y, ...)`：'impact' 冲击线、'dust' 白色尘团、'ripple' 水波、'specks' 土粒、'sparkle' 四角星、'confetti' 彩纸屑；速度线按速度自动加
- 手写字：`write(text, x, y, size, when, underline=((x0, x1), y), weight)`：文字遮罩 Zhang–Suen 细化成单像素骨架，像手一样走骨架（去斜体后最靠左的端点起笔、路口尽量直走、走到头抬笔跳回），每个墨像素取最近骨架点的时刻
- 输出：`frame(t)`；`gif(path, fps=15, t_end, hold)`：逐帧渲染（一次只留一帧浮点），共用一张加权调色板 + 固定 4×4 Bayer，没变的像素写成品红透明索引；`journey(times, t_world, arc, labels, prop_arcs, world_fx, final, props)` 旅程总图；`stage(name, t)` 存某时刻的关键帧，`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度
- 色板常量 `PAPER INK PENCIL GRASS MINT LAVENDER SUN WATER NUT CAP CONFETTI`


**圆珠笔涂鸦 `Ballpoint`**：
- 思路：圆珠笔墨是油性墨膏，靠滚珠压到纸上；颜色按光密度（比尔定律）叠加，描两遍、交叉、墨团都会更深更饱和（蓝色叠到深蓝紫，不会变成死黑）。每一笔：起笔头几像素滚珠是干的（细、淡、只挂在纸纹峰上）→ 压力 ±12% 漂移、线宽随之略变、手抖 → 偶尔断墨 2–9 px（墨断了，压痕还在）→ 停笔、急转弯、有时起笔处掉一个墨团 → 抬笔甩出 90–160° 的小钩。每一笔都在纸上压出凹槽，左上侧光下槽的左上壁暗、右下壁亮。彩铅是蜡，只挂在碰到的纸纹上：轻压颗粒发白，重压填进谷里；一块一块地斜向快速排线，出界、换方向，大面积浅、小面积重
- 构造：`Ballpoint(W, H, seed, ss=2, pen_width=2.5)`；`paper(tone, tooth=0.75, fibres=260, mottle, cockle=1.0, folds=[((x0, y0), (x1, y1))], vignette=0.09)` 灰米色复印纸：细纸纹、稀疏纤维、斑驳、低起伏和折痕（按左上光打光）、拍照的四角暗角
- 圆珠笔：`line(pts, pen='blue'|'red'|'black'|None, pressure, width, closed, smooth, wobble, bow, hook, gloop, skip, twice, start, clip, groove)`；`bow` 是徒手直线的侧弯（约 0.003–0.006 倍长度），`hook` / `gloop` / `skip` 是收笔小钩、墨团、断墨的几率，`twice` 是再描一遍（偏 0.6–1.6 px、只描一部分）的几率，`pen=None` 只压槽不出墨；`lines(paths, …)` 一批短笔画共用一次栅格化；`emboss(pts)` 无墨压痕
- 小件：`dot(x, y, r, pen)` 转一小圈压出的实心点；`eye(cx, cy, rx, ry, pen, look, shine)` 由外往里转圈涂实、留一个圆高光的眼睛；`face(cx, cy, size, mood='smile'|'grin'|'oh'|'dizzy'|'sleep'|'worry', pen, blush, look, rot)`；`dashes(pts, pen, dash, gap, pressure, smooth, clip)` 虚线（返回重采样后的路径，好接箭头）；`arrow(tip, direction, size, pen)`；`ring(cx, cy, rx, ry, pen, turns, rot)` 不闭合、越画越往外的随手圈
- 彩铅：`pencil(mask, colour, angle, pressure, spacing, length=(40, 90), overshoot, width=2.9, jitter, bow, cross, clip, groove)` 斜向排线（`length` 是一段手腕笔画的长度，接缝逐行错开；`overshoot` 出界像素；`cross` 再叠一层角度）；`pencil_line(pts, colour, pressure, width)` 单根彩铅线；颜色用 `PENCILS` 里的名字（leaf green lime mint teal sky blue violet lilac pink rose red orange peach yellow ochre brown tan grey cream）或 '#rrggbb'
- 圆珠笔排线：`pen_hatch(mask, pen, angle, spacing, pressure, length, overshoot, zigzag=0.85, cross, clip)` 来回不抬笔的之字排线，转折处带墨团（阴影、暗面、深色棋子）
- 手写：`write(s, x, y, size, pen, pressure, slant=7, spacing=1.04, jitter, anchor='l'|'m'|'r', rot, width, blind, hook, gloop)`，y 是基线，返回写出来的 (x0, y0, x1, y1)；字形取自细手写字体的骨架（Zhang-Suen 细化后描成笔路径，按字缓存），每个字母单独缩放、倾斜、上下浮动，有起笔、墨团、小钩；中文用细黑体骨架；`blind=True` 是上一页透过来的无墨压痕字；`strike(box, pen, passes)` 来回划掉一个词；`underline(x0, x1, y, pen, wavy)`
- 遮罩和点：`poly(pts)`、`ellipse(cx, cy, rx, ry, rot)`、`band(pts, width)`、`tube(pts, w0, w1)` 由粗到细的身体（蛇、尾巴），`Ballpoint.tube_sides(pts, w0, w1)` 它的左右两条边（一笔描下去绕过尾尖再描回来）；`circle_pts`、`star_pts`、`cloud_pts(cx, cy, w, h, bumps, seed, flat)`、`spiral_pts(cx, cy, r, turns, a0)`、`heart_pts`、`Ballpoint.resample(pts, step)`
- `stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4；常量 `PENS PENCILS PAPER`；字体可用 `INKPAINT_FONT_BALLPOINT` / `INKPAINT_FONT_BALLPOINT_CJK` 指定（默认 macOS Noteworthy Light / 黑体-简 细体，Linux Kalam / Caveat / Noto Sans CJK，Windows Segoe Print / 微软雅黑）

**描图纸叠层 `Overlay`**：
- 思路：透光台上的分色叠片。灯箱从下面打暖白光，画面就是一路透过率相乘：底图（胶版纸）印黑线和灰调，上面每张描图纸 / 胶片只印一种油墨。油墨按网点覆盖率 c 算透过率（c ≤ 1 是平网 1 − c(1 − ink)，c > 1 是叠印加深 ink^(c−1)）；不同叠片之间正片叠底，蓝叠黄成绿、品红叠黄成红、蓝叠品红成紫；同一块版自己不叠加（取最大覆盖率）。每张纸有自己的纸色、只有背光下才看得见的云状纤维（formation）、零星纤维丝、裁切边的一道细暗线和打孔；描图纸平放时也让下面的暗部略微发灰（frost）。抬起的纸略放大、往右下投一片宽而软的暖色阴影（透过纸也看得见），而且它是离开画面的漫射片，会把下面的一切模糊掉；放下后清晰，阴影收成一条贴边细线，套准十字落在底图的十字上
- 构造：`Overlay(W, H, seed, keep_stages=True)`；`desk(colour)`、`lightbox(x0, y0, x1, y1, radius, bezel)`、`lamp(level)`（0 关灯：灰色乳白亚克力；1 开灯：暖白，中间偏左最亮；中间值又暗又偏暖）；`peg_bar(x0, x1, y0, y1, pegs=[('round', x, y, r), ('slot', x, y, w, h)])` 定位钉条（不透明的钢条，画在所有纸下面，纸上的孔里露出钉子和一圈透光缝）
- 纸：`sheet(x, y, w, h, kind='base'|'tracing'|'drafting'|'film', ink, tint, fibre, curl=('br', 70), edge)` 返回 `Sheet`。坐标一律是**纸放下时的画布坐标**，所以几张叠片用同一组点画，自动套准。`place(sheet, lift, dx, dy, rot)` 显示、抬起（lift 0–1，偏 dx / dy 像素、转 rot 度）或放下（全 0）；第一次 `place` 决定叠放顺序；`remove(sheet)`；`tape(cx, cy, w, h, rot)` 撕口的皱纹绘图胶带，压在最上面、半透光
- 在纸上印：`fill(遮罩或多边形, cover, ink)`；`line(pts, width, cover, ink, closed, smooth, dash=(实, 虚))`、`lines(paths, …)` 一批线一次栅格化；`dots`、`circle(cx, cy, r, width=None)`、`hatch(mask, spacing, angle)`、`stipple(mask, n, r)`；`text(s, x, y, size, font_kind, cover, ink, anchor, spacing, rot, halo, knock)`：halo 先清掉字周围的墨，knock 把字从墨里反白掏出（实心圆里的站点编号）；`knock(mask)`、`cross(x, y)` 套准十字、`arrow(tip, direction, size)`、`punch(x, y, r)` / `punch_slot(x, y, w, h)` 打孔
- 遮罩（画布大小）：`poly(pts, smooth)`、`circle`、`ellipse`、`rrect`、`band(pts, width)`；`edge(mask, width)` 轮廓线、`offset(mask, d)` 外扩 / 内缩、`contour(mask, d, width)` 离边 d 像素的一圈线（海岸水线）、`Overlay.inset(凸多边形, d)` 街区从街道往里缩、`circle_pts`
- 字体 `font(kind, size)`：map / map_bold / map_heavy / map_italic / map_light（Gill Sans 一族）、title（Avenir Next Heavy）、label、cjk / cjk_light（黑体），也认 core 的样式名；可用 `INKPAINT_FONT_OVERLAY_<KIND>` 指定
- 常量 `INKS`（black blue yellow magenta cyan orange green red）、`PAPERS`；`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**粉彩界面 `PastelUI`**：
- 思路：产品发布片里的一帧界面。整片纯色粉彩底（蓝 / 粉 / 黄 / 淡紫 / 薄荷 / 桃，`FIELDS`）加一大片柔光和几颗白色光斑；上面是 macOS 窗口卡片和侧面板、胶囊、粗黑大标题压半透明色条、状态标签、✓ / ✗ 徽章、文字高亮、放大镜，三个扁平小图标从卡片边探头。所有圆角矩形、圆、环、胶囊和线性图标都是有符号距离场，1 px 解析抗锯齿（像素中心取 i + 0.5，整数坐标的边是锐利的）；只有自由多边形（小标签的尖角）是 4 倍超采样再 BOX 缩小。阴影按 CSS box-shadow 的语义算（偏移、模糊半径 σ = blur / 2、扩展、颜色、不透明度，只画在元素外面）：卡片叠两三层——一圈发丝描边、一层染着底色的宽阴影、一层中性的近阴影，所以卡片浮起来却没有灰边
- 图层：一切都画进有名字的图层（预乘 RGBA，收尾时裁到画过的范围）。`layer(name, z)` 开始往某层画（再次调用会重新打开），z 小的在后面：小图标的 z 比卡片小，就只露出探出卡片边的那一截；`end()` 之后画在底色上。每层有姿态 `pose(name, dx, dy, scale, alpha, reveal, origin, feather)`：位移、绕 origin 缩放、不透明度、从左往右揭开（reveal 0–1，软边 feather px）；`show / hide` 只改不透明度；`bounds(name)`。同一样东西的两种状态（检查行之前 / 之后）画成两层，用 show / hide 切换。`stage(name)` 按当前姿态合成快照（PNG 压缩存在内存里）
- 构造：`PastelUI(W, H, seed, keep_stages=True)`；`field(colour='blue', glow=(x, y), glow_size, glow_alpha, bokeh)` 底色（用 FIELDS 名字时同时设定强调色 `accent`、阴影色 `tint`、标题色条色 `mark_colour`）；`wipe(cx, cy, r, prev='lilac', rim, rim_width)` 圆形擦除：圆里显示一切，圆外是上一节的底色，圆边一道强调色的环，`wipe()` 清掉
- 形状：`rrect(x0, y0, x1, y1, r, fill, alpha, grad=(c0, c1), angle, ring, inset)`（ring=w 只画边，inset 决定在里还是在外）、`circle(cx, cy, r, fill, alpha, ring, grad)`、`line(pts, width, fill)`、`poly(pts, fill)`、`shadow(x0, y0, x1, y1, r, dx, dy, blur_px, spread, colour, alpha, shape=(cx, cy, r))`、`soft_shadow(cov_fn, box, …)`（任意形状的 drop-shadow）、`with clip(x0, y0, x1, y1, r):` 把里面画的东西裁进圆角矩形（窗格底色裁进窗体圆角）
- 文字：`text(s, x, y, size, fill, weight='regular'|'medium'|'bold'|'heavy', anchor, alpha, spacing, family='sans'|'mono')`，返回宽度；中英文自动分段（macOS：中文苹方、粗黑标题兰亭黑 Heavy、西文 SF Pro 可变字重、等宽 SF Mono；其他系统 Noto Sans CJK / 微软雅黑；可用 `INKPAINT_FONT_PASTELUI_<CJK|HEAVY|LATIN|MONO>` 指定）；anchor 的第二个字母 s 基线 / m 中文字身中线 / t 字身顶；`measure(…)` 量宽度；`marker(x0, x1, base, h, colour, alpha, drop)` 压在字下面的色条（文字高亮就是 h 盖满字高的 marker）
- 部件：`window(x, y, w, h, title, icon, sub, split, bar=50, radius=22, rim=9, tint)` 返回 Box（`.bar`、`.left`、`.right` 两个窗格）：55 % 白的磨砂外框、两层阴影、白色窗体、标题栏红黄绿三点、居中的应用小图标 + 粗体标题 + 等宽副标题、浅色左栏和发丝分隔线；`card(x, y, w, h, r=26)` 侧面板；`pill(x, cy, text, dot)` 带圆点的小胶囊，返回右边缘；`steps(x, cy, labels, lit, current)` 箭头连起来的步骤条；`headline(x, base, text, size, mark='关键词', draw_text, draw_mark)` 粗黑标题和色条（两者可分两层画，色条那层 z 放后面）；`chip(x, cy, text, colour, size, solid, glyph, anchor)` 状态标签；`mono_tag`；`callout(x, cy, text, colour, glyph)` 左边带尖角的实心小标签；`ref_chip(x, base, text, glyph, ok)` 嵌在正文行里的引用标签（右上角绿色 ✓ 小圆）；`badge(cx, cy, 'pass'|'fail', size)`；`spinner`；`bar(x0, x1, cy, frac)`；`tile(x, y, size, fill, glyph, grad)` 应用图标方块；`avatar`；`glyph(name, cx, cy, size, fill, sw)` 24 格线性图标（`GLYPHS`：more user code lens spark book inbox tag check x suitcase umbrella plug passport calendar pin sun bolt leaf）；`weather('sun'|'partly'|'cloud'|'rain', cx, cy, size)`；`check_row(x, y, w, h, label, tag, sub, glyph, tone, state='idle'|'active'|'pass'|'fail', result, status)` 检查行（status=False 时右端留空，用 `row_status(x1, cy, state, text)` 画到另一层，好单独弹出徽章）
- 放大镜：`magnifier(cx, cy, r, mag, colour, name='lens', z, handle=45)` 自成一层；合成时先把它下面**真实的像素**按 mag 倍双线性放大进镜片，再画白色镜框、淡紫内圈、高光和紫色渐变镜柄；用 `pose('lens', dx, dy, scale)` 移动，放大的内容跟着走
- 小图标（扁平矢量、无脸）：`spark(cx, cy, size, spin)` 奶油色圆里的橙色星芒（白圈、暖色投影）；`cloud(cx, cy, size, rot)` 紫色渐变云朵里的白色 >_（十一个圆平滑并集、径向渐变、光泽、投影）；`critter(x, y, px=9, blink)` 橙色像素小怪（10 × 6 格，整数像素对齐）
- 色板常量 `INK BLUE LILAC GREEN PINK YELLOW MINT PEACH CLAY LINE GREY FIELDS BOKEH`；`render()`、`composite()`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**阅卷批改 `Grading`**：
- 思路：深绿毛毡桌上的一张答题卡被批改。每张纸是带位姿的对象：`Paper` 在自己的坐标系里存纸色（斑驳云纹、纤维、轻微起伏、零星纤维丝）、alpha（打孔处镂空）和所有印刷；坐标一律按**纸没转动时的画布坐标**给，纸自己的 `rot` 和 `place()` 的位姿在合成时才套上。抬起的纸略放大、投一片宽软偏移的影，放下后收成贴边细影。印刷是立即的（油墨乘进纸色；反白字用 `mode='knock'` 露出纸本身）。印刷之后写上去的一切都是保留对象 `Mark`，带 `progress`（0–1，写到第几成，可以来回设）：每个 Mark 存一块密度图（比尔定律：纸色 × exp(−密度 × 油墨吸光度)，叠在印刷和别的墨上自然加深）和一张时间图（每个像素第几成时被写到），所以阶段快照能画出写到一半的笔画。最后整幅乘一盏左上暖灯的衰减、暗角和细颗粒，桌面、纸和笔受同样的光照不均
- 构造：`Grading(W, H, seed, keep_stages=True, stages_dir=None)`（给了 `stages_dir`，`stage()` 当场写 PNG，不留在内存里）；`desk(colour=FELT, nap)` 毛毡：大小两级斑驳、细绒、零星绒毛
- 纸：`sheet(x, y, w, h, tint, rot, stack=2)` 答题卡（下面再压 stack 张，错开几像素、略暗）；`card(x, y, w, h, tint, rot)` 卡片 / 小纸条（四周留 110 px，给竖起来的夹子把手）；`place(paper, lift, dx, dy, rot)` 放下（全 0）或抬起（第一次 place 决定叠放顺序）、`remove(paper)`；`paper.to_canvas(x, y)` 纸上坐标 → 当前位姿下的画布坐标；`paper.width(s, size, kind)` 量字宽
- 印刷：`text(s, x, y, size, kind='body', colour, anchor='ls', spacing, alpha, rot, mode='ink'|'knock'|'over')`（返回结尾 x）、`rect(x0, y0, x1, y1, fill, line, width, radius)`、`line(pts, width, colour, alpha, dash=(实, 虚))`、`ellipse`、`hatch` 斜纹、`grid` 浅方格、`rules(x0, x1, ys)` 作答横线、`band` 色带、`checkbox`、`circled(n, cx, cy)` 圆圈数字
- 答题卡部件：`timing_track(x, y0, y1, step=30)` 一排定位黑块、`corner_mark`、`holes(x, y0, y1, step, r)` 装订齿孔（真的镂空，露出桌面和纸影）、`title(s, x, y, size, sub)` 粗黑标题 + 字距拉开的西文副标题、`field(label, value, x, y, x1)` 灰色栏名 + 粗体内容 + 下划线、`ticket(x, y, digits)` 考号格 + 每位一列 0–9 涂卡圆泡（对应的那个涂黑）、`score_box(x, y, w, h, split, head, titles, note, lines)` 得分 / 阅卷人表格（返回得分格中心）、`fill_example(x, y)` 填涂示例、`section(x, y, num, title, sub, meta, x1)` 「一 题目」分节头（深色方块里反白序号）、`question(x0, y0, x1, y1, s)` 灰底题目框加左边竖条、`answer_frame(x0, y0, x1, y1, col, rows=[(栏名, y, 分隔线 y 或 None)], lines)` 作答框：左边浅方格加横线，x ≥ col 是斜纹阅卷栏（表头「阅卷栏 · 考生勿填」、虚线分行）；`clip(x, y, w, handle)` 黑色长尾夹：夹在纸边上的亮黑钢夹，两根竖起的银色钢丝把手各横跨整个夹子（后面那根略低、在阴影里），在纸上和桌上都有投影
- 写上去的东西（返回 Mark 或 Group，都有 `progress` 和 `tip(p)`）：
  - 红笔：`stroke(pts, width, colour, pressure, blob, feather, smooth, density)` 任意笔画（中性笔：落笔一颗墨珠，压力沿线漂移，拐弯处笔走慢、积墨更深，边缘略深，往纤维里洇一点，纸纹凸起处略淡）；`wave(x0, x1, y, amp, period)` 周期和幅度都在漂的波浪线；`ring(cx, cy, rx, ry, tilt, a0, a1, grow)` 手画椭圆圈（越过起点再画一截、越画越大一点）；`leader(p0, p1, bend)` 弧形引线；`underline`；`cross(cx, cy, s)` 两笔叉；`check(cx, cy, s)` 勾；`digits(s, x, y, h)` 按笔画骨架写数字（0–9，倾斜、略不规则）；`score(s, cx, cy, h, ring=True)` 分数：先写数字再圈起来
  - `note(s, x, y, size, kind='bold', jitter)` 批注：粗黑体（不用手写体），每个字略歪、略错位，按红墨处理（字内浓淡、边缘积墨、淡淡洇开），逐字揭开
  - `answer(s, x, y, size)` 考生的蓝黑墨水作答，逐字出现
  - `stamp(cx, cy, label, w=None, h=64, rot, size, check=True, press=(0.64, 1.0))` 朱红橡皮章印：双线圆角框、粗黑字、✓；位移出的毛边、成簇的针孔空白、一头压得轻（细框在那头断开飞白）、边缘积墨、刚盖下的湿晕（`mark.wet` 0–1）、轻微歪斜、章周围纸面压出的一圈凹痕；盖下之前 progress = 0
- 道具：`pen(x, y, lift, angle=28)` 红笔，笔尖落在画布 (x, y)，按圆柱打光：金属锥头和笔珠、带横纹的橡胶握把、镀铬环、上漆笔杆和一道窗光高光、笔夹和铆钉；投影从笔尖起沿笔身越拉越开、越来越软（笔尾被手抬着）；`pen(None)` 收走。`write(mark, progress, lift)` 设进度并把笔尖放到书写前沿（动图逐帧用）。`stamper(mark, height)` 印章悬在印痕上方 height（0–1）：上漆榉木章身（顺长木纹、倒角）、车出来的木把手（旋纹、高光），投影随高度变宽变软；height 0 就是压下去，印痕出现、带湿晕；`stamper(None)` 拿走
- 字体 `font(kind, size)`：heavy（兰亭黑 Heavy：标题、印章）、bold / medium / body / light（苹方）、latin / latin_heavy（Avenir Next）、digits（DIN）、mono（Menlo：考号）；兰亭黑和苹方是 macOS 按需下载的字体，没有时退到冬青黑体、华文黑体，Linux 用 Noto Sans CJK，Windows 用微软雅黑；可用 `INKPAINT_FONT_GRADING_<KIND>` 指定
- 色板常量 `INK GRAY RULE ANSWER PEN STAMP NAVY FELT PAPERS SHADOW`；`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**皮影戏 `ShadowPuppet`**：
- 思路：幕布上看到的每一点都是透过来的灯光。幕布是一盏油灯从背后照亮的布：灯后面那一块最亮、最淡，往外越来越深的琥珀色，带纱线粗节、一两道折痕和暗角。人偶是刮薄上油的驴皮，半透明、染透明色：每块皮（`Leather`）存覆盖率和每个通道的光密度，到达眼睛的是 灯光 × exp(−密度)，所以朱红、青绿、赭黄透亮，黑色几乎不透光，两块皮叠在一起密度相加、自然变深（关节、远侧手脚压在身上都这样），叠放顺序不影响结果。人偶贴在幕上（`d = 0`）清楚；`d` 越大影子越大越虚，又因为灯有两个灯芯，分成两个错开的影，就是「没贴紧」的那种软的双边。操纵杆在绑的地方清楚，越往下越离幕、越虚。最后整幅加一点辉光、一条柔肩的色调曲线、暗角和细颗粒；雕花戏台和灯笼在幕前，被幕布溢出的光照亮
- 构造：`ShadowPuppet(W, H, seed, keep_stages=True, stages_dir=None)`（给了 `stages_dir`，`stage()` 当场写 PNG）；`screen(colour, edge, hot, weave, folds)` 幕布（`hot` = 灯在幕后的位置）；`lamp(level, radius, flicker)` 灯：亮度、光晕铺开到几成（0.1 = 刚点着的一小团）、闪一下（±）；`proscenium(plaque='蹴鞠', top=150, valance=54, side=64, sill=80, bracket=170, plaque_w=420)` 戏台：回纹浮雕横楣 + 中间红漆金字牌匾、透空回纹挂落、两角镂空花牙子、立柱、台口，并把幕布开口设成框内；`frame(dy, alpha)` 横楣这一组的位姿（动图里从上面落下来，灯笼跟着动）；`lantern(x, top, r, drop, tassel, lit, swing)` 红纸灯笼：竹骨、里面的烛光、黑漆金边帽、金结红穗、一圈暖光晕，`set(lit, swing, shown)`
- 皮 `Leather(x0, y0, x1, y1, scale, ss=3, seed)`（坐标是设计单位，× scale 是像素，原点就是枢轴；`sp.leather(...)` 自动给种子）：`fill(形状, 染料)` 剪出 / 贴上一块皮，`dye(形状, 染料)` 给已有的皮换色，`edge(宽)` 沿剪边描黑，`contour(区域, 宽)` 给一块区域描边，`punch(形状, rim)` 打孔（孔边一圈墨），`line(点, 宽)` 一条皮线，`carve(点, 宽)` 刻一道缝，`pattern(区域, 纹样, 大小, angle, margin, origin)` 在区域里镂空，四周留 margin 宽的实皮：`dots` 圆点、`rings` 圆环、`flower` 梅花、`coins` 铜钱、`scales` 鱼鳞甲、`cloud` 如意云头、`lattice` 方格（angle=45 是斜格）、`stripes` 条孔、`ice` 冰裂纹；圆点类（dots / rings / flower / coins）转 `angle=90` 时，窄条里只剩居中的一列（门柱就是这样）；形状工具 `poly ellipse ring stroke ribbon(宽度渐变的带) text(竖排字) below / above / left_of / right_of inset grow`；`finish()` 把皮厚不匀（30 px 斑驳、90 px 色块、细纤维）算进去，变成「每个通道挡掉多少光」。形状可以给点列，也可以给同尺寸的遮罩
- 人偶 `Puppet`：`add(名字, 皮, parent, joint)` 一棵关节树（子件的枢轴挂在父件的 joint 上，关节处一颗线结；先加父件）；`pose(**角度)`：角度按「人朝右时逆时针」量，垂下的手脚 +90 是向前平伸，头 +10 是抬头，躯干 +6 是往后仰；`set(x, y, rot, d, flip, alpha)`；`state()` / `load(st)` / `Puppet.tween(a, b, t)` 存取和插值整套姿态（动图逐帧用）；`rod(部件, 点, lean, width)` 操纵杆；`ground(地板 y, [部件])` 让最低的鞋底落在地上；`away[部件] = 距离` 让某一件单独离幕；`point(部件, 点)` 部件上一点的画布坐标
- `figure(robe, trim, accent, trousers, face, skin, facedye, headdress, plume, pom, pattern, hands, scale)` 出一个标准人偶（朝右，`flip=True` 朝左）：`pelvis` 短裙腰带为根，`torso` 云肩、护心镜、鱼鳞甲、腰带，`head` 侧脸（`face='hollow'` 阳刻空脸：脸挖空，只留侧脸线、一只长眼、一道长眉；`face='solid'` 阴刻：脸留着 `facedye` 染的皮，五官刻空），`arm_f / arm_b` 上臂（只有近侧带护肩花），`fore_f / fore_b` 小臂和袖口，`hand_f / hand_b`（`'open'` / `'fist'`），`thigh_f / thigh_b`，`shin_f / shin_b` 绑腿和厚底靴；头饰 `'plume'` 盔 + 两根带黑横斑的雉翎、`'crown'` 三叉冠 + 绒球 + 侧穗、`'bun'` 发髻飘带；scale 1 时鞋底到盔顶约 520 px
- 道具（一块皮的 prop，可以像人偶一样移动、离幕）：`gate(w, h, net_h, eye, eye_r, post, beam, roof, net, trim)` 牌楼式球门：立柱（一列铜钱孔）、额枋、瓦顶飞檐、鸱吻卷、宝珠，窗棂网和红边风流眼，枢轴在地面中点；`ball(r)` 鞠：六道缝线、红芯、每瓣一个梭形孔；`border(y0, y1, dye, trim)` 底部装饰带（圆点条、镂空回纹带、黑边，画布坐标，放在 0, 0）；`nameplate(text, dye, size, string)` 挂在线上的竖排小牌（枢轴在线头）；自己做的：`sp.prop(皮)`；`place(p, x, y, **kw)` 放上幕布或更新，`hide(p)`
- 字体：`plaque` / `label`（牌匾、小牌）：魏碑（macOS 按需下载的字体）→ 隶变 → 楷体 → 宋体，Linux 用 Noto Serif CJK，Windows 用华文新魏 / 楷体；可用 `INKPAINT_FONT_SHADOWPUPPET_PLAQUE` / `_LABEL` 指定
- 染料 `DYES`：plain red crimson teal green ochre yellow blue brown pink black；色板常量 `SCREEN SCREEN_EDGE HIDE WOOD LACQUER GOLD SPILL ROD LAMPS`；`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度

**钢笔淡彩 `PenWash`**：
- 思路：每张卡片是一张独立的冷压水彩纸（自己的缓冲区，按卡片坐标 = 画布像素、不转着画，内部 2 倍分辨率），拍照时才按位置和小角度放到桌上。纸：约 1 mm 的凸点（这里 2–4 px）叠在更缓的起伏上，按左上窗光打光；切边略不直、有毛边。墨线是针管笔：几乎等宽，每一笔重采样后加低频手抖和一点颤动，线宽 ±9% 漂移，落笔处一个小墨点，部分笔画收尾一甩变细；画得快，闭合形状由 1–3 笔组成，接口处要么停早留缺口、要么冲过头沿切线出头，方框的角各画各的、相互出头，偶尔一段再描一遍、偏 1–2.5 px；墨按比尔定律光密度叠加，纸纹最深的谷里略漏白；部件按 z 遮挡，被前面部件盖住的轮廓线自动断开。淡彩（墨干后上）先算「本来要涂的区域」（部件减去前面的部件），再像手快那样涂：整块错位 2–5 px（一边出线、另一边在线里留白缝）；边缘在模糊副本上用游走的阈值重新取（负的出线、正的回缩，另有成片回缩的白缝），利落但抖、顺着纸纹；干边（水干时颜料跑到边上）；颗粒（颜料沉进纸纹的谷）；平刷条纹；浓淡斑驳；可选干笔飞白；湿中湿 `bleed`（滴进还湿的色块、软边、停在湿边）；打湿的地方纸面起皱。颜料也按光密度叠加，相叠变深、混色。背景色块是不铺满卡片的粗糙平涂矩形，绕开人物留几 px 白边。白色水粉最后上、不透明
- 构造：`PenWash(W, H, seed, ss=2, keep_stages=True, stages_dir=None)`；`table(kind='oak'|'pale'|'walnut'|'linen', plank=176)` 桌面（橡木板：带「山纹」拱形的年轮、导管、板缝和拼接缝、缎面光泽）；`card(cx, cy, w, h, rot, tone, corner, tooth, seed)` 放一张白卡并设为当前卡（rot 是顺时针度数），`use(card)` 切换；之后的绘制都画在当前卡上（也可以传 `card=`）
- 部件（墨线在 `ink()` 时才画）：`part(pts, z, ink=True, strokes=None, corners=False, smooth=True, width, reserve=True, nseg)` 一个区域加它的轮廓（`strokes` 改成只描给定的几段开放路径；`corners` 在角上拆成相互出头的直线；`reserve=False` 时背景色块不绕开它；`nseg` 指定闭合轮廓分几笔）；`limb(pts, w0, w1, z, caps=(False, True))` 袖子、腿、背带（只描两侧和指定的端头）；`stroke(pts, z, width, closed, smooth, corners, wobble, over=(0, 3), double, flick, nseg)` 单独一笔（被 z 更高的部件挡住的部分不画）；`lines(paths, …)`；`dot(x, y, r, z)` 点出来的眼睛；`ink()` 给当前卡上所有待画的笔画上墨
- 脸和小件：`glasses(cx, cy, r, gap, z, temple=(x, y))` 一副大圆眼镜（两片镜片是部件，后面的肤色涂到镜框就停、镜片里留白），返回两片镜片；`brows(paths)`；`tufts(x, y, n, length, spread, angle)` 几根翘起的头发；`frame(x0, y0, x1, y1)` 手绘边框（四边各一笔、角上出头）；`ground(x0, x1, y)` 两笔粗地线；`signature(x, y, size)` 角上的小螺旋签名
- 形状（静态方法，卡片坐标）：`PenWash.oval(cx, cy, rx, ry, rot, egg, wob)`（`egg` > 0 是下宽的大头）、`rrect`、`box(cx, cy, w, h, rot)`、`turn(pts, cx, cy, deg)`、`smooth(pts, closed)`、`tube(pts, w0, w1)` → (轮廓, [左边, 右边, 末端, 起端])、`hand(x, y, angle, size, kind='mitten'|'open'|'fist', flip)` → (轮廓, 指缝线)
- 颜料：`wash(target, colour, strength, shift, slip=(2, 4.8), warp=1.6, gaps=2.2, soft=2.2, edge=0.35, gran=0.14, streak=0.08, angle, var=0.13, dry)`，target 是部件、部件列表、点列或 `('mask', sl, m)`；区域等效半径小于 16 px 时错位、白缝和抖动按比例缩小；`bleed(target, x, y, r, colour, strength)` 湿中湿（腮红、面包烤色）；`background_block(x0, y0, x1, y1, colour, strength, rough, corner, halo, angle, edge, streak, dry)`；`spatter(colour, n, box, size)` 甩上去的颜料点；`highlight(pts, width, alpha)`、`glint(x, y, r)` 白色水粉；颜色用 `PAINTS` 里的名字（coral red pink rose peach skin tan ochre yellow brown terracotta teal mint sage green cobalt sky bluegrey grey warmgrey black lilac）或 '#rrggbb'
- 桌上的道具：`pen(x, y, angle, length=430, r=10.5, cap=True)` 针管笔（笔尖在 (x, y)、笔身朝 angle 度：纤维笔尖、金属套管、灰色锥头、哑光笔杆上印着线宽、套在尾部的亮面笔帽和笔夹）；`water_brush(x, y, angle, length=320, r=12, stain='teal', cap=(x, y, angle))` 水笔（尼龙笔尖、尖上染一点颜料、螺纹握把、微雾的透明水杆按圆柱折射下面的东西、尾部气泡；`cap` 另放一个透明笔帽）；都按圆柱打光、带投影（透明部分影子浅、有一点焦散）。比例：卡片约 9 cm 宽时，针管笔比卡片还长（范例 640 px、r 16），水笔 600 px、r 24
- 常量 `PAINTS INK PAPER WOODS LINEN SHADOW`；`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度；笔杆上的字用 core 的 sans_bold（可用 `INKPAINT_FONT_SANS_BOLD` 指定）

**复古水粉 `GouachePortrait`**：
- 思路：不透明水粉一层盖一层，从暗到亮、从大到小（托底色 → 赭色起稿 → 背景 → 平涂 → 色值塑形 → 质感 → 五官 → 高光 → 印刷颗粒）。
  - 颜料：每一笔都替换下面的颜色（C ← C + (色 − C)·A），湿笔会带起一点底层的颜色（`pickup`）。
  - 纸纹：画板有一张纸纹高度场 `G`。
  - 一笔：扁笔沿短弧拖过去。横向每根鬃毛含色不同，所以顺着笔有条纹、颜色略有深浅；纵向颜料越用越少。含色高时全覆盖，变少后只落在含色多的鬃毛经过纸纹凸起的地方，所以笔尾断成干笔丝和点；两侧毛边，落笔处圆头。
  - 边缘：形状先模糊一像素，再按低频摆动和纸纹重新取阈值，利落但不是矢量边。
  - 塑形：遮罩模糊后按内缘归一化、再开方当穹顶高度（也可以给 `height`；球体用精确椭球）。一盏左上偏正面的光，受光量化成 3–5 个软台阶，映射到五色阶（暗部偏紫红，亮部偏暖白）。先湿铺一遍，再用顺着形体的短笔（等高线方向、顺坡或绕球心）按落点取色盖上去。
  - 针织：每针一个 V（两条斜椭圆、圆柱截面的纱线，带捻股斜纹，相邻行交叠，谷底遮蔽），按光照乘到已有颜料上，大的明暗保留。行可以拱、垂、旋转或沿路径走；麻花是两股交替在前的圆管；罗纹是凸起的正针列和凹下的反针列，每列上有小的人字针。
  - 头发：先画暗色的发团，再沿流向场画成百上千根锥形细线，按受光场从暗到亮分档，暗的先画，少数飞出轮廓。
  - 毛毡：两种尺度的斑驳，加短纤维和轮廓外的绒毛。
  - 最后 `grain()` 叠印刷书页的感觉：纸纹颗粒、亮部的暖纸色、墨色到不了纯黑、饱和度略收。
- 构造：`GouachePortrait(W, H, seed, keep_stages=True, stages_dir=None)`（总像素不超过 4096²）。
  - `panel(x0, y0, w, h)` 新建一块画面并设为当前；之后的坐标都是这块画面里的局部像素。`use(p)` 切换。
  - `ground(tone='#c88f5a', paper, alpha=0.5)` 画米色画板，每块画面刷一层薄的暖色托底。
  - `sketch(mask, colour, width=2.2, alpha=0.8, breaks)` 用稀释的赭色勾出遮罩轮廓，即起稿，会被后面的颜色盖住。
- 形状：返回画面大小的浮点遮罩，用 `np.maximum`、相乘、`1 −` 组合。
  - `ellipse(cx, cy, rx, ry, rot)`、`poly(pts, smooth=True)`、`blob(cx, cy, rx, ry, rough, seed, rot)`
  - `band(path, w0, w1)` 粗路径；`GouachePortrait.tube(path, w0, w1)` 给轮廓点。
  - `rough(mask, amount)` 画出来的毛边。
- 笔：角度一律是度，0 向右，90 向下。
  - `stroke(x, y, angle, length, width, colour, bend, dry, alpha)` 一笔。
  - `strokes(mask, colour 或颜色场, angle 或角度场或 f(x, y), length, width, density, dry, alpha, clip, load)` 在遮罩里撒很多笔，每笔在落点取颜色和方向。`load` < 1 是落笔就半干的皴擦。
  - `dry_brush(path, width, colour, dry, alpha, taper)` 沿折线拖一长笔（热气、长扫）。
- 画：
  - `scumble_background(colour, bottom=None, avoid=人物遮罩, angle, light, dark, scratches, flecks, blend)` 单色或上下渐变的背景：满载的长笔铺底，再用半干的亮、暗两遍皴擦，加短的浅色刮痕和溅点，绕开人物。
  - `block_in(mask, colour, angle)` 平涂一块，返回毛边遮罩。
  - `model_form(mask, colours 五色阶, steps=4, height=None, angle='contour'|'fall'|数|场|函数, relief=0.55, round_=0.5, bias, ambient=0.08)` 几阶色值塑形，返回受光场。
  - `form_light(mask, height, relief)` → (受光 0–1, 高度, 梯度)。
  - `sphere_shade(cx, cy, rx, ry, colours, mask, rot)` 球形塑形：笔触绕球心，下缘有反光。
  - `glaze(mask, colour, alpha, mode='multiply'|'screen'|'normal', soft)` 罩一层。
  - `cast_shadow(caster, dx, dy, soft, alpha, colour, on)` 帽檐、鼻子、胡子下的软投影，只落在 `on` 上。
  - `dry_highlight(mask, colour, above=0.62, angle)` 受光处的干笔高光，穹顶用 `'fall'`。
  - `blush(cx, cy, rx, ry, colour, strength)` 粉状腮红。
  - `dab(x, y, r, colour)` 一小点（高光、扣子）。
  - `line(path, width, colour, alpha, taper, dry)` 小圆笔画线。
  - `spatter(mask, colour, n, size)` 溅点。
- 脸：
  - `eye(cx, cy, r, ry, iris, iris_r, look=(dx, dy), lid, lid_colour, lashes, lash_dir, ring, lower, iris_light)` 圆眼：米白眼球、眼皮下的阴影、深色或青色虹膜（下半亮）、黑瞳孔、白色高光、眼皮和眼皮线、细的暖色外框。`look` 取 1 是贴边，两只眼往里、往下就是斗鸡眼。
  - `nose(cx, cy, rx, ry, colour, on, cast)` 大鼻子：脸上的软投影、球体塑形、下缘反光、鼻孔、柔和的粉白高光加一点白。
  - `ear(cx, cy, rx, ry, colour, side)` 大耳朵。
- 质感：
  - `knit(mask, stitch=(宽, 高), origin, curve, angle, path, cables=[(x, 宽)], strength, highlight)` V 字平针。`curve` > 0 行往下垂，< 0 往上拱；给 `path` 时沿围巾走。
  - `rib(mask, path, period)` 罗纹（领口、袖口、帽檐翻边）。
  - `hair_strands(mask, flow, colours 暗→亮, n, length, width, shade, curl, jitter, roots, clip)` 发丝、眉毛、胡子、绒球、卷发。
  - `felt(mask, strength, fibres, fuzz)` 毛毡。
- 颜色与常量：
  - 颜色用 `PAINTS` 里的名字（vermilion red orange mustard yellow ochre cobalt cerulean navy teal seaglass green olive peach skin ruddy nose rose blush pink umber sienna cream white grey ink brown cocoa）或 '#rrggbb'。
  - `ramp(base, deep, shadow, light, pale, cool, warm)` 给五色阶；皮肤记得给暖的 `cool`。
  - 常量 `PAINTS PAPER LIGHT`；`grain(amount)`、`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度。

**蓝调绘本 `BlueBook`**：
- 思路：照绘本画家的顺序画一页、再印出来（空白纸 → 蓝色色块 → 墨线 → 乱线暗部 → 点缀色和腮红 → 白粉笔 → 雨、水花、甩点 → 印刷）。
  - 纸纹：一张直方图均衡过的纸纹高度场 `T`（0–1 均匀分布），所以「工具碰到纸纹高于 1 − 接触压力的地方」直接就是覆盖率。另外预先算好沿 8 个方向拖开的纸纹 `TD`，每一笔按自己的方向取，干的工具漏掉的白点会顺着笔拉成短道。
  - 一笔（墨线、彩色蜡笔线、粉笔线、雨丝共用）：路径先过样条、按 2 px 重采样，再加慢的手抖和细颤。Pillow 把每段的序号画进 32 位整数图，得到这一笔覆盖的像素和所属线段，再精确投影出每个像素的弧长和横向偏移。
    - 落笔快、收笔慢（`taper`），沿途粗细起伏（`swell`）。
    - 横向几根笔毛含墨不同，沿笔越用越干（`dry`）；接触 × 含墨低于纸纹的地方断成顺着笔的白道。
    - 边缘随纸纹游走，不是矢量边。
  - 上色是干蜡笔、粉彩或干水粉：
    - 区域先整体错开 1.5–3.5 px（`slip`），边缘在模糊过的遮罩上用游走的阈值重新找（`loose`），靠边的地方压力减小、断成干边（`edge`、`dry_edge`）。
    - 覆盖率只由压力和纸纹决定（`pressure` 0.95 只留细白点）；颜色深浅由低频斑驳和平行笔道决定（`mottle`、`lanes`）。
    - 蜡和粉彩半透明：新 = 旧 + (色 × 旧^0.55 − 旧) × 覆盖。盖在白纸上就是本色，盖在墨上仍是黑，蓝上加蓝更深；`medium='gouache'` 和 `'chalk'` 不透明。
  - 墨在上：墨的覆盖记在 `K` 里，之后再上的颜色在墨上几乎挂不住（`over_ink` 默认 0.1，粉笔 0.5，眼睛高光 1），所以线一直在颜色上面，像印出来的书。
  - 最后 `printed()`：印刷的轻微柔化、只把黑抬到深墨色（白纸不变灰）、细纸点，可选中缝（柔和的阴影、一道细折痕和一线亮边）。
- 构造：`BlueBook(W, H, seed, keep_stages=True, stages_dir=None)`（总像素不超过 4096²），先 `paper(tone='paper', tooth, drag)`。坐标是整张画布的像素。
- 形状：返回画布大小的浮点遮罩，用 `np.maximum`、相乘、`1 −` 组合。
  - `ellipse(cx, cy, rx, ry, rot)`、`poly(pts, smooth=True)`、`blob(cx, cy, rx, ry, rough, seed, rot)`、`band(path, w0, w1)`；`BlueBook.tube(path, w0, w1)` 给轮廓点。
  - `cloud(cx, cy, w, h, bumps, seed)` 云；`rect(x0, y0, x1, y1, rough, corner, seed)` 手画的毛边矩形。
- 颜色：
  - `block(box 或遮罩, colour='powder', rough, corner, pressure, angle, edge, dry_edge, streaks, avoid, halo)` 背景大色块：毛边、不到纸边，边缘的笔道顺着边走、拖干，再贴着边拖几十笔干笔（限在边缘附近）。
  - `fill(mask, colour, pressure=0.9, angle, slip, loose, edge, dry_edge, mottle, lanes, lane_var, passes, medium='crayon'|'gouache'|'chalk', avoid, halo, clip, streak, over_ink)` 涂一块，返回实际涂到的区域。`angle` 是数或画布大小的角度场；`avoid` + `halo` 绕开前面的东西、留一圈白缝；`slip=0` 不错位。
  - `crayon(paths, colour, width, pressure, dry, medium)` 沿路径的彩色干笔（头发丝、远树干、湿地面、倒影）。
- 墨：
  - `ink(path, width=4, dry, taper, wobble, swell, overshoot, clip)` 一笔毛笔 / 墨铅笔线。
  - `outline(pts, width, closed=True, open_=0.45, overshoot, strokes=(1, 3), twice=0.35)` 快速的轮廓：闭合形分 1–3 笔，在接头前停下留缺口，或冲过接头顺着切线出头；`twice` 是某一段再描一遍、偏开一两 px 的几率。
  - `scribble(mask, width=5, spacing=4.5, angle=80, reach, overshoot, dry, colour, clip)` 暗部：沿一个方向来回不抬笔的之字乱线，转折处冲出或不到轮廓，一次一个手腕的范围。
  - `hatch(mask, angle, spacing, length, width, colour, medium, density)` 一根根平行的快速短排线（衣服暗面、白毛的阴影）。
  - `blades(x0, x1, y 或 f(x), n, height, lean, width, clip)` 从底线长出来的锥形草叶。
  - `dot(x, y, r, ry, colour, medium)` 边缘不规则的实心小点（眼睛、鼻子、扣子）。
- 白与天气：
  - `chalk(遮罩 或 路径列表, width, pressure=0.62, angle, over_ink=0.5)` 不透明的白粉笔 / 白粉彩：给遮罩就涂（云、小巴士），给路径就画（高光、玻璃反光），只挂在纸纹凸起上，顺着笔拉成长道。
  - `rain(region, n, angle=100, length, width, colour='deep', avoid)` 短的干笔雨丝。
  - `splash(x, y, size, colour, n, up)` 雨点落下溅起的一圈小短线和水珠；`ripples(cx, cy, rx, ry, rings)` 水洼上断开的同心圈。
  - `spatter(region, colour, n, size, satellites)` 甩出来的颜料点（幂律大小、略拉长、带小卫星点）；`speckle(region, colour, n, size)` 更细的尘点和闪点。`region` 是遮罩或 (x0, y0, x1, y1)。
- 角色：
  - `head(cx, cy, rx, ry, width, ears=[(x, y, r)])` 大圆脑袋的开口轮廓，耳朵只画露出来的那段，返回头（含耳朵）的遮罩。
  - `eyes(pts, r, look=(dx, dy), glint)` 带白高光的点点眼；`smile(x, y, w, depth, tilt)`；`blush(cx, cy, r)` 点彩腮红（一层很淡的蜡笔底 + 稀疏的粉点）；`freckles(cx, cy, n, spread)`。
  - `fluff(mask, 'ink' 或 'chalk', length, width, curl, avoid, gaps, curls, reach)` 毛绒。`'ink'` 把轮廓画成一串短的扇贝形小弧（不闭合，有缺口）；`'chalk'` 是从里往外越过边缘、压在背景蓝上的白毛；`curls` 是里面的小卷。
  - `flower(x, y, r, colour='coral')` 小花：不透明的花瓣加墨点花心。
- 收尾：`printed(amount, gutter=x)` 印在书上；`folio(x, y, '14', size)` 小页码；`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度。
- 颜色用 `COLOURS` 里的名字（paper chalk ink mist powder cornflower blue cobalt deep teal navy slate coral tomato cheek flesh freckle mustard butter）或 '#rrggbb'；常量 `COLOURS`、`INK`。

**江南园林 `JiangnanGarden`**：
- 思路：照风景插画家的顺序从后往前画（天空 → 远山 → 雾 → 远树 → 屋后的树 → 建筑 → 对岸的园子 → 水面和倒影 → 水上的东西 → 前景 → 垂挂的画框 → 印章），不透明的颜料盖住后面的，画的顺序就是遮挡关系。
  - 空气透视：每个画法都有 `far`（0 近 – 1 很远），越远颜色越往雾色（淡青绿）靠、对比越低；深度层之间用 `haze()` 铺一道雾带，最浓处在山脚。
  - 笔触：一笔就是一个小多边形（尖叶、圆花瓣、剑形叶、圆点），各有大小、角度和颜色。成千上万笔一次画完：Pillow 把每个多边形按序号填进 2 倍超采样的整数 id 图（序号就是先后，后画的盖住先画的），numpy 按 id 查颜色和透明度表，再缩回 1 倍，边缘都有抗锯齿，一笔不到 1 微秒；颜料里叠一层固定的细画布纹理，明暗差几个百分点。
  - 光：太阳在左上、略靠前。树冠是一组团块（椭圆，排在后面的在前）；每一笔先找到自己落在哪个团块上（包含它的最前面那个），把团块当穹顶：法线给漫射，整团越往下越暗，再加低频噪声打散。这个 0–1 的值从一条混好的绿色色阶里取色（深青绿的芯 → 中绿 → 黄绿 → 淡的阳光绿）。
  - 树冠照水粉画家的画法：暗底（团块的芯 + 1.7 倍大的暗叶，底色的边缘也是叶子）→ 满冠中暗的叶 → 穿出轮廓的叶 → 受光值高的地方一簇簇（5–14 片）亮叶 → 最亮的几笔。叶尖朝外、微微下垂；近景灌木用 `veins` 给亮叶加一道浅叶脉。托盘松是同一个模型：歪扭的树干加几层扁平的针叶盘，针叶用很细的叶片、几乎不下垂。
  - 繁花树：枝干、笔触暗底（暗花瓣 + 深绿叶，不是一块平涂）、细枝、几片嫩叶，然后几百个花簇按明暗排序（亮的压在暗的上面），簇里朝阳的花瓣更白，枝条从簇间的缝里露出来；`blossom_branch()` 是近景花枝：一朵朵五瓣花、花蕊、花苞和嫩叶。
  - 垂柳：树干和几根弯枝先画，再用一层垂叶的树冠盖住枝；几百上千根柳丝一绺一绺（同一处垂下 3–9 根，绺与绺之间留缝），从枝上或树冠里出来，先往外拱一点再垂下，带一点摆；每根是发丝细的茎，两侧随机地挂着小窄叶，略张开、朝下。从后往前画（后排暗、偏蓝，前排亮、偏黄），受光一侧和梢头的新叶更亮。
  - 屋顶：正面看的歇山顶是一张曲面 S(u, v)（u 横向 −1..1，v 从正脊 0 到檐口 1）：上陡下缓（举折，檐口一段被透视压扁），越往下越宽，翼角向外甩出，檐口两端急速起翘。曲面拆成小四边形网格画进 id 图，每个像素用两步牛顿迭代反求精确的 (u, v)，瓦就能解析地上色：筒瓦（左侧受光，旁边一道暗缝）和板瓦一行隔一行，每层瓦口一道亮边、下面一道阴影，每片瓦各有一点明暗，偶尔一片发绿；檐口一排瓦当和滴水，檐下是椽头和檐底，墙面上落一道檐影；正脊有镂空花脊和卷起的脊头，戗脊一直通到翘起的翼角尖。
  - 建筑：粉墙是平涂加低频斑驳、檐下雨渍、发绿的墙脚和一层淡笔触；`dapple()` 是树叶在受光面上投下的叶影（阈值噪声的冷色斑，离投影的树越近越重）。槅扇和窗（方格、斜格、灯笼锦、冰裂纹）在 3 倍图上画棂条，左上沿亮、右下沿暗，在里面的暗室或窗纸上投一点影；柱子是漆过的圆柱加柱础；灯笼是带骨的红色椭球，金色顶底和流苏；匾额是带框的木板和描金字；台基、台阶和桥都是一块块有缝的石头，每块各有明暗。九曲桥是真的几何：桥段、石板、桥墩、望柱、镂空栏板和扶手都经针孔相机（`camera()`、`project()`）投影，每个面按法线上色，背对镜头的面剔掉。
  - 水：湖面是碧绿的本色，远处映着天更淡。倒影是岸线以上的画面按岸线镜像，横向被细浪推开，竖向模糊（离岸越远越糊），压暗，并按菲涅尔越往近处越多地混进本色，所以和岸上的东西对得上，只是更柔、更暗。立在水里的东西自带倒影：桥把几何的高度取反再投影一遍，船和白鹭把自己那一层按水线翻下去。最后是从水面本身取色的横向笔触、淡淡的涟漪线（映天的亮、映岸的暗）和细竖纹。睡莲叶经相机躺在水面上（椭圆按 眼高 / 距离 压扁），带缺口、叶脉、亮的远边、暗的近半边和一点影子。
  - 收尾 `grain()`：轻微柔化、亮部一圈春天的光晕、暗部偏青、细颗粒、极淡的画布纹和竖纹；`seal()` 一方边缘磨损的小红印，白字。
- 构造：`JiangnanGarden(W, H, seed, keep_stages=True, stages_dir=None)`（总像素不超过 4096²）；`camera(horizon, eye, focal, cx)` 定湖面上的针孔相机，配 `project(X, Y, Z)`、`ground_y(Z)`、`depth_at(y)`、`px_per_m(Z)`。画布坐标是像素；世界坐标是米（X 向右、Y 从水面向上、Z 向远）。
- 底层：`dabs(xs, ys, length, width, colours, angle, shape='leaf'|'round'|'blade'|'dot', alpha, far)` 一次画很多笔（角度用弧度）；`stroke(path, w0, w1, colour)`；`fill(mask, colour, alpha)`；`poly(pts)`、`ellipse(cx, cy, rx, ry)` 返回画布大小的遮罩；`crown(cx, cy, w, h, n, size)` 生成团块 (cx, cy, rx, ry)；`with g.clipped(mask):` 只画在遮罩里（月洞门里的景）。
- 天空和远处：`sky(top, bottom, y1, clouds)`；`hills(ridge, base, colour, far)` 山脊样条、浮雕噪声打光、树冠凸起的轮廓、山脚渐隐；`haze(y0, y1, y2, colour, strength)` 从 y0 升到 y1、到 y2 消失的雾带。
- 草木：`foliage(clumps, ramp_='spring', leaf=(5, 9), density, far, light, droop, aspect, veins, edge, highlights)`；`blossom_tree(branches, clumps, kind='white'|'pink'|'azalea', petal, density, far, leaves, gaps)`，branches 是 [(path, w0, w1), …]；`blossom_branch(path, w0, w1, kind, flowers, spread, size)`；`willow(trunk, boughs, strands, length, ramp_, leaf, far, sway, crown, tips, gap, bundle, splay, aspect, crown_anchor)`；`pine(trunk, limbs, pads)`；`branch(path, w0, w1)`；`reeds(x0, x1, y 或 f(x), n, height, lean, width, bend)` 弯曲的剑形叶；`petals(region, n, kind, water)`；`rock(cx, cy, rx, ry)`；`pot(x, y, w, h, colour, band)` 返回盆口中心。
- 建筑：`wall(x0, y0, x1, y1, colour, stains, damp)`；`dapple(x0, y0, x1, y1, amount, scale, cover, falloff=(x, y, r), mask)`；`roof(cx, y_ridge, y_eave, ridge_w, eave_w, upturn, flare, rows, courses, ridge_h, soffit, shadow)` 返回曲面函数；`coping(x0, x1, y, h)` 墙头瓦；`column(x, y0, y1, w)`；`beam(x0, x1, y0, y1)`；`lattice(x0, y0, x1, y1, pattern='lantern'|'grid'|'diamond'|'ice', cell, bar, frame, back='interior'|'paper'|颜色|None, kind='window'|'door')`；`fretwork(x0, x1, y0, h)` 挂落；`round_window(cx, cy, r, ring, pattern 或 inside=函数(遮罩), ground, reveal)` 漏窗 / 月洞门；`stonework(x0, y0, x1, y1, course, block, damp)`；`steps(x0, x1, y, n, rise, tread, grow)`；`bridge(path=[(X, Z), …], width, deck, thick, rail, post, rails='both'|'rear'|'none', reflection)`；`lantern(x, y, h, cord)`；`plaque(cx, cy, w, h, text)`。
- 水：`lake(y0, y1, far_colour, near_colour, bank)`；`reflect(bank, strength, blur, ripple, darken, fresnel, src)`（`src` 传画水之前的画布）；`layer()` + `reflect_layer(before, axis, box)` 给船、白鹭这类东西单独做倒影；`ripples(box, n, light, dark, alpha, brush)`；`lily_pads(pads=[(X, Z, 半径米)], flowers=[(X, Z, 大小米)])`；`lotus(x, y, s)`；`boat(x0, x1, y, h)`；`egret(x, y, s, pose='stand'|'fly', facing)`。
- 收尾：`seal(x, y, w, h, text)`；`grain(amount)`；`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度。
- 颜色用 `PAINTS` 里的名字（sky sky_low haze cloud plaster coral jade jade_dark jade_light lacquer beam interior paper stone tile board gold wood lantern seal bark bark_light water water_deep water_far terracotta porcelain egret）或 '#rrggbb'；色阶用 `RAMPS` 里的名字（spring jade deep olive willow far white pink azalea tile stone rock pad）或自己给一串颜色；常量 `LIGHT`。

**干刷色块 `DryBrushBlocks`**：
- 思路：照参考海报的做法，先铺最大的色块，再用几块面拼出人物，最后是细节和一个小红方块；不勾线、不做渐变，形体全靠色块的边和叠压。
  - 笔刷坐标系：每块颜色在自己的坐标系里刷：把遮罩（Pillow）旋转到笔触方向沿 +u，在里面用横平竖直的数组算覆盖率、明暗和混色，再转回去，所以鬃毛纹、笔道和干笔收尾永远顺着笔走。
  - 纹理：每张画布只生成一次几张周期纹理，每块颜色取随机位置的一窗：鬃毛条纹（沿笔长约 40 px、横向 1–3 px）；干笔齿（鬃毛条纹 + 更粗的拖痕 + 纸纹，直方图均衡到 0..1，于是「齿 > 1 − 接触压力的地方上色」直接把压力变成覆盖率）；滚筒齿（成簇的各向同性细点）；梳齿边的噪声；笔道明暗；拉长的斑驳。噪声都是白噪声按方向模糊（循环边界）得来的，不是放大粗网格。
  - 笔道：大色块是一道道平行的宽笔或滚筒（`lane` 宽，每道略宽略窄），每道起笔饱满、往收笔越来越干，各干各的（`dry`、`dry_from`）；`stroke_len` 把每道打断成长短不一、各有明暗和干尾的短笔；`passes=2` 再盖一层，块身合拢、两端仍是毛的；`direction` 定走向（+1 / −1 同向、0 随机、2 来回）。
  - 边：横向只稍微柔化（`side`，两侧是略抖的直边），顺笔方向柔化很多（`fringe`），再拿鬃毛纹阈值化：两侧近乎直，两端梳成长短不一的毛齿，干的一端更长（`tines`），毛齿只从柔化带里长出来。
  - 皴擦：斑驳高的地方接触压力下降（`scumble`），颜料只挂在纸纹的齿上，露出纸色或下层颜色；`edge` 是沿轮廓几段干擦的边，只放在顺笔的两侧。`load` 大于 1 是蘸满的笔，快干的地方也照样实（瓷碗）。
  - 叠色：默认不透明水粉（新 = 旧 + (颜色 − 旧) × 覆盖率），干笔扫过另一块颜色时下层从缝里透出来；`mode='multiply'` 像丝网油墨套印（玻璃杯、茶）；`mix=(颜色, 比例)` 让同一支笔里带第二种颜色的条纹。
  - 收尾 `printed()`：像这幅画的胶印：轻微柔化、细纸纹、暗部零星的纸色白点、纸上零星的灰尘（在 render 里加）。
- 构造：`DryBrushBlocks(W, H, seed, keep_stages=True, stages_dir=None)`（总像素不超过 4096²）；`paper(tone)` 铺米白纸并生成纹理。画布坐标是像素，角度是度（0 向右、90 向下）。
- 形状（画布大小的浮点遮罩）：`rect(x0, y0, x1, y1, rot)`、`poly(pts, smooth)`、`ellipse(cx, cy, rx, ry, rot)`、`tube(path, w0, w1)`、`quad(pts)`。
- 色块：`slab(shape, colour, angle, load, dry, lane, fringe, side, tines, scumble, streak, vary, direction, passes, seam, edge, stagger, dry_from, stroke_len, tooth='brush'|'roller', mix, mode, alpha, avoid, clip)` 返回覆盖率，shape 可以是遮罩、(x0, y0, x1, y1) 或多边形点；`piece(shape, colour, torn, cut, rim, …)` 撕 / 剪的纸片：只有一部分轮廓是撕口（`cut` 是留作直切的比例），撕口可带一圈浅色纤维边；`backdrop(box, colour, angle, rough, scratches)` 主体背后的滚筒大色板（几乎平涂、成簇细点、起笔边干净、干的两侧、几道细刮痕）；`accent(x, y, size, colour, rot)` 小方块（x, y 是左上角）；`scratches(mask, colour, n, length, width)`。
- 笔：`stroke(path, width, colour, load, dry, taper, wobble, square, mode, alpha, clip)` 沿路径的一笔干刷（每个像素都知道自己的弧长和横向偏移，纹理顺着曲线走，扁笔头、越画越干）；`scumble(mask, colour, n, length, width, angle, spread, load, dry)` 在遮罩里撒短干笔（胡子、头发、高光），angle 可以是函数 f(x, y)。
- 人物：`head(cx, cy, w, h, tilt, turn, light, skin, lit, shade, warm, ear, hair, crown)` 返回锚点字典（眼睛、鼻子、嘴、下巴和遮罩）；`glasses(head, colour, lens, frame)`；`beard(head, colour, shade, length, width)`；`jacket(neck, shoulders, bottom, lit, shade, dark, shirt, collar, light)`；`sleeve(path, w0, w1, colour)`；`hand(x, y, size, angle, grip, cuff)`。都在局部单位坐标里（中心、大小、倾斜），一个姿势就是几个数；`light=-1` 是光从观者左边来。
- 器物：`bottle(x, base, w, h, colour, shoulder, neck, neck_w, dark, light, label, label2, cap, glass)`；`bowl(cx, rim_y, w, h, colour, band, inside, shade)` 返回（碗身, 碗口里面）；`cup(cx, base, w, h, colour, glass, level, tea)`。
- 收尾：`printed(amount)`；`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度。
- 颜色用 `PAINTS` 里的名字（paper cream bone white ink black forest green slab sage leaf ash celadon mint khaki teal lagoon tealblue navy deep sky ice vermilion tomato coral blush ochre tan skin skin_light terracotta umber brown mustard）或 '#rrggbb'。

**暮色微缩绘本 `TwilightStorybook`**：
- 思路：照绘本的顺序画：黄昏天空 → 夜 → 山 → 花坡 → 角色和风筝 → 发光的东西 → 图版和手写字；先定一块「夜度」场，后面受光的东西都按它着色。
  - 黄昏天空：六段渐变（薰衣草紫 → 丁香 → 玫瑰 → 蜜桃 → 杏 → 金，按地平线定位），分段位置被横向拉长的低频噪声扰动，颜色是一层层软的，不是尺子拉的直色带，再叠几个百分点的细斑驳。云是透镜形的带：一条扁透镜加几团圆块（中间高），轮廓模糊，底部更平更清，越往下越浓，半透明；云下有细光线；太阳是带两层光晕的淡圆，先于山画，山把它切掉。
  - 夜：`night_split()` 由一条游走的边界线定出整幅画的夜度场 N（0 黄昏 – 1 夜），过渡带很宽、带羽化；夜空渐变、银河、星星、月亮都按 N 当透明度铺上去，星星越过边界慢慢变稀、变淡，不会停在一条线上；靠近边界时夜色偏靛蓝，交界带再补饱和度（`richness`），黄昏 → 淡紫 → 靛蓝 → 黑，不发灰。
  - 之后所有「受光」的东西（山、花草、人物）都按同一个 N 着色：颜色经一个 3×3 线性变换（先降饱和、再偏冷）按 N 混过去，白雏菊在夜的一侧成了淡淡的月光蓝，草成了深石板色。自发光的（星星、萤火虫、灯、流星）和图版放在 `with t.unlit():` 里画，不受影响。
  - 银河：两点之间、带弯曲和游走中心线的解析带，密度是横截面的高斯 × 两个尺度的云状噪声，中间一条更窄的暗带；几千颗暗星按带的密度抽样。星星：均匀位置、幂律亮度（多数暗、少数亮），少数偏暖或偏蓝，亚像素精度地溅到画布上（大星用圆盘覆盖核，小星用保质量的高斯，bincount 累加）；最亮的几颗加四芒星（长的渐细光芒加短对角线），只放在夜深处、离地平线远的地方。
  - 山：远山是填充的山脊（每列解析抗锯齿的边），越往山脚越淡（谷里积雾）；条纹山丘是顺着山脊的一层层带，越近越宽（透视），每条带切成斜的拼布田，部分田有平行的细垄，带与带、田与田之间一道深一点的树篱线，坡顶一道淡亮边；`trees()` 放小圆树（影子、树干、树冠、左上亮面）。
  - 花坡：地面是鼠尾草绿到橄榄绿的渐变加斑驳和细点，坡顶一道亮边（越过交界从金变银）。花和草按透视用拒绝采样放：大小随离坡顶的深度按幂次增长（默认 t²），密度 ≈ 覆盖率 / (π · 大小²)，所以坡顶是几千个色点、最底下是几十朵大花；花种按低频噪声成片漂移（一片雏菊、一片矢车菊）；远处的花沉进带雾的地色。按大小是一个色点、一朵带花心的小花或一朵完整的花头（雏菊、矢车菊、虞美人、波斯菊、金盏花、毛茛、羽扇豆、勿忘我），各有细茎，大的带一片叶；花头按透视压扁，朝后的花瓣先画。所有多边形按根部的 y 排序，一次光栅化进超采样的整数 id 图（画家顺序 = id 顺序），查色表再缩回来，几万个抗锯齿形状不到一秒。
  - 角色：扁平可爱的绘本角色，用平滑多边形拼：`wanderer()` 是坐着的小斗篷角色（毡子质感的斗篷、软塌的帽尖和绒球、奶油色圆脸、带高光的点点眼、腮红、手套和靴子，夕阳一侧一道暖色柔边，一圈断续的深色细轮廓）；`jar_lantern()` 是一罐萤火虫，会发光、照亮周围的草；`kite()` 四片的菱形风筝，有骨架、提线和一串蝴蝶结尾巴；`kite_string()` 略下垂，跟着身后的天空从深（黄昏）变银（夜）。`fireflies()`、`butterfly()`、`dragonfly()`、`seeds()`（蒲公英种子）、`birds()` 是留给细看的小东西。
  - 图版：细墨线在 3 倍图上画成折线（略带手抖、可渐细）再缩回来，0.8 px 的发丝线也是平滑的；`hatch()` 在形状里排平行的手绘线（换个角度再调一次就是交叉排线），`dimension()` 画延伸线、带建筑式斜短线的尺寸线和小标签（`across=True` 横跨一根伸出画外的杆件，引到外面写「ø 6」这类），`ruler()` 小比例尺，`wash()` 平的水彩底色加一道深边；`inset()` 是圆形放大图：带淡阴影的纸圆片、裁在里面的 `draw(t, cx, cy, r)` 回调、细双圈、目标上的标记圈和引线、标签。
  - 手写字：细手写体（macOS 上是 Noteworthy Light，或设 `INKPAINT_FONT_HAND_LIGHT`）逐个字母排：每个字母各有一点旋转、基线起伏、间距和轻重，在 2 倍图上画再缩小，叠一层淡淡的铅笔纹。
  - 收尾 `finish()`：轻微柔化、亮处光晕、细颗粒加大一点的柔和斑驳、偏梅紫的淡暗角，可选底边一道米色撕纸边；只记参数、在 render 里加，所以在画第一笔之前调用，每张阶段快照都和成品一致。
- 构造：`TwilightStorybook(W, H, seed, keep_stages=True, stages_dir=None)`（总像素不超过 4096²）；`with t.clipped(mask):` 只画在遮罩里（放大图里面），`with t.unlit():` 不受夜度着色。画布坐标是像素；角度除注明外用弧度（`hatch()` 用度）。
- 底层：`lines(paths, width, colour, alpha, wobble, taper)`；`fill(mask, colour, alpha)`；`shapes(polys, colours, alpha)`；`poly(pts)`、`ellipse(cx, cy, rx, ry)` 返回遮罩；`glow(x, y, r, colour, strength)`；`splat(xs, ys, rad, colours, alpha)`。
- 天空：`dusk_sky(stops, horizon, mottle)`；`cloud(x0, x1, y, h, colour, alpha)`；`streak(x0, x1, y)`；`sun(x, y, r)`；`mist(y0, y1, y2, colour, strength)`；`birds(pts, size)`；`seeds(pts, size)`。
- 夜：`night_split(edge, soft, ground)`（edge 是从上到下的折线，夜在它右边；在 `dusk_sky()` 之后调）；`night_sky(top, low, indigo, richness)`；`milky_way(p0, p1, width, bend, rift, stars)`；`stars(n, region, sparkles, dusk)`；`sparkle(x, y, size)`；`moon(x, y, r, phase, tilt)`；`shooting_star(p0, p1)`。
- 地面：`hills(ridge, colour, base, fade, rim)`；`striped_hill(ridge, colours, stripe, grow, fields, rows, hedge)` 返回 info（ridge、bounds，用来放树）；`trees(pts, size)`；`meadow(crest, size, density, grass, kinds, drifts, haze)` 返回 info（crest）；`grass_heads(x0, x1, base, n, height, lean)` 坡顶衬着天空的带穗高草。
- 角色和小东西：`wanderer(x, y, s, facing, reach)` 返回手的位置；`jar_lantern(x, y, s)`；`kite(cx, cy, size, tilt, tail)` 返回提线结的位置；`kite_string(p0, p1, sag)`；`nightline(path, width)` 跟着天色变色的细线；`fireflies(pts, size, trails)`；`butterfly(x, y, s, colour)`；`dragonfly(x, y, s)`。
- 图版和字：`hatch(shape, angle, spacing, width)`；`dimension(p0, p1, text, offset, across, lead)`；`ruler(x0, y, x1, labels)`；`wash(pts, colour)`；`leader(p0, p1)`；`inset(cx, cy, r, draw, target, label, sub, leader_colour)`；`caption(x, y, text, size, colour, anchor, rot)`。
- 收尾：`finish(grain, vignette, bloom, soft, edge)`；`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度。
- 颜色用 `COLOURS` 里的名字（天空 lavender lilac rose peach apricot gold sun cloud cloud_low streak；夜 night night_low indigo star moon milk；地面 mauve mauve_dark haze rim silver meadow meadow_far meadow_near grass tree tree_light trunk field_sage field_lav field_wheat field_green field_rose；线和纸 ink pencil caption paper pale；花 daisy cornflower poppy cosmos marigold buttercup lupine forgetmenot eye stem；角色 cloak cloak_dark face cheek boot mitten kite kite_cream spar string lantern firefly glass）或 '#rrggbb'；花种见 `SPECIES`。

**排线夜景 `Nocturne`**：
- 思路：照粉彩 / 彩铅画家的顺序画一张小幅夜景（纸和深色底 → 天空 → 远处的陆地 → 冷色的云 → 加光 → 发光的细丝和火星 → 海 → 倒影 → 小人 → 装裱和题字），整张画只由一笔一笔的短笔触组成，暖光是最后一层层「加」上去的笔触。
  - 纸：直方图均衡过的纸纹 `T`（0–1 均匀分布）、低频斑驳和几百根纤维；画心先铺一层深色底，以后每一笔都裁在画心里（像贴了胶带），纸边始终干净。另外预先算好沿 8 个方向拖开的纸纹，每一笔按自己的方向取，漏掉的纸纹顺着笔拉成短道，不是孤立的黑点。
  - 一笔：中心线在一个方向场里积分出来（方向按 mod π 处理，一笔中途不会掉头），再带一点弯，落笔钝、收笔尖。几万笔一次画完：Pillow 把每一笔的轮廓按序号填进 2 倍超采样的整数 id 图（后画的盖住先画的），numpy 对每个像素查出那一笔的颜色、起点、方向、长和宽，算出像素在笔上的位置（沿笔 u、横向 v），由 v 得到笔毛道：每笔 6 道，各有自己的深浅和含量，越往笔尾越干（`dry`），颜料只落在纸纹低于压力的地方（`pressure`），所以每一笔都有笔毛条纹和颗粒，深色的底从细缝里透出来；再缩回 1 倍。同一批里最上面那笔说了算（不会糊成一团），层次靠多遍叠。
  - 颜色：一笔取一个颜色——一个颜料、一条色阶按明度场取，或任意 f(x, y)；再加每笔自己的明度抖动（`value`）和色相抖动（`hue`，绕灰轴真正转色相）；`lit` 把光照图加到笔上，所以光里的笔触本身是暖的。
  - 方向场：`flow(角度, 扰动, 尺度)` 整片的风向；`radial(cx, cy)` 从一点放射（锥形山的坡向、光的放射）；`contour(密度)` 顺着等高线（绕着云团、沿着山脊）；`blend(f1, f2, w)` 用双倍角混合（0 和 π 是同一个方向）。云团里的笔顺着上升的柱子走，只在团边上绕着卷，处处都绕会卷成漩涡。
  - 光：`light()` 点光源、`light_from()` 发光的遮罩（熔岩细流）合成一张光照图。`glow()` 铺光笔触：落笔的概率跟着「光 × 受光」走、颜色取光照图，所以光是越往外越稀的暖色笔触，不是一团平滑的光晕。空气和眩光用加光（screen）；被照亮的表面用 `blend='paint'` 按「光 × 受光」直接上色——蓝灰的云加上橙光会变粉，直接画成被照亮的颜色才是红橙；`whiten` 让离热源最近的那些笔偏向暖白（白色的蒸汽）。
  - 热源 `source()`：一小撮黄白的笔、一圈圈往外放射的橙、红笔触，一个很小的白芯和很小的辉光。
  - 细丝：`threads()` 是带惯性、一直转向终点（并顺着坡离开山顶）的游走，所以是蜿蜒的细流不是折线闪电；分股的细丝越往末端分得越开，小角度的支流分出去后渐隐或停在一颗亮珠上，亮度一段段有结壳的暗处，前锋最热。`filaments()` 把它们画进 2 倍浮点发光缓冲：细线、紧贴的光晕、照到旁边东西上的光笔触、末端和沿途的亮珠。`sparks()` 是抛物线飞出的火星：一小段渐淡的拖尾和一个热的头。
  - 水：`reflect()` 在海面上铺横向笔触，颜色取水线以上画面的镜像（被浪拉长、被涟漪横推、压暗并混进海色），只在镜像亮的地方落笔，所以倒影是碎的；`glitter()` 是水线上的光源朝观者拉出的光柱：近处热而窄，往下变宽、变红、更碎。
  - 小人和剪影：`figure()` 是几十像素高的坐着的小人（头、躯干、屈起的腿、搭在膝上的手），剪影色，一点亮色（围巾、帽子），朝光的一侧一道暖色轮廓光；`silhouette()` 用笔触画深色的块（礁石、岛、山），可选朝光一侧的轮廓光。
  - 装裱：`mount()` 在画心外压一道版痕（凹槽的上沿和左沿暗、下沿和右沿亮）；`caption()` 用细的普通字体（Helvetica Neue Light / Thin 一类，不用手写体）逐字写铅笔小字，基线和角度有一点点抖，石墨在纸纹上发虚。收尾 `bloom()` 只给画心里最亮的光一点克制的辉光，`grain()` 细颗粒。
- 构造：`Nocturne(W, H, seed, keep_stages=True, stages_dir=None)`（总像素不超过 4096²），先 `sheet(box=(x0, y0, x1, y1), paper, ground)`。坐标是整张画布的像素；方向场是弧度，`flow()` 的角度用度（屏幕 y 朝下，正角度向右下斜）。
- 遮罩：`poly(pts, smooth)`、`ellipse(cx, cy, rx, ry, rot)`、`blob(cx, cy, rx, ry, rough)`、`below(xs, ys, invert)`（一条样条线以下）返回画布大小的浮点遮罩；`value(top, bottom, y0, y1, mottle, scale)` 竖向明度场加低频斑驳。
- 笔触：`hatch(region, field, colour, length, width, density, jitter, bend, value, hue, alpha, pressure, dry, lanes, lit, mode='paint'|'light', taper, clip)`。`region` 是落笔概率遮罩或 (x0, y0, x1, y1)；`density` 约等于把区域铺几遍；`length` / `width` 给 (最小, 最大)、一个数或 f(x, y)（海面越近越长）；`colour` 给颜料、(色阶, 明度场或 f(x, y)) 或 f(x, y) → (N, 3)。
- 光：`light(x, y, r, colour, power, squash)`、`light_from(emission, spread, colour, power)`、`lightmap()`；`glow(receptivity, field, length, width, density, power, reach, blend='light'|'paint', ambient, whiten)`；`source(x, y, r, power, field, squash, core)`。
- 细丝和点：`threads(start, ends, wander, strands, spread, branches, branch_len, width, fall, heat)` 返回路径；`filaments(paths, gain, halo, light, receptivity, field, beads)`；`sparks(x, y, n, spread, speed, streak)`；`embers(region, n)`；`stars(region, n, size, bright)`。
- 水：`reflect(waterline, region, src, stretch, ripple, darken, mixw, thr, length, width, density)`（`src` 传画海之前的画布，`waterline` 可以是逐列的数组）；`glitter(x, y_water, y_end, w0, w1, power)`。
- 剪影和小人：`silhouette(mask, ramp_, field, val, density, rim, rim_from)`；`figure(x, y, h, facing, accent, accent2, legs='knees'|'dangle', lean, rim_from, rim, hat)` 返回小人的遮罩。
- 收尾：`mount(plate, depth)`、`caption(text, x, y, size, anchor, weight='light'|'thin', alpha, jitter)`、`bloom(amount)`、`grain(amount)`；`render()`、`composite()`、`stage(name)`、`save(path, stages_dir)`；`save('x.jpg')` 默认 quality 88、4:4:4 色度。
- 颜色用 `PAINTS` 里的名字（paper pencil ground night indigo navy dusk haze starlight mist slate steam steam_lit rock rock_lit sea sea_deep glint blood ember lava flame core scarf star warmstar）或 '#rrggbb'；色阶用 `RAMPS` 里的名字（fire ember sky sea steam land isle）或自己给一串颜色。

**顺序**：都是先远后近、先大后小，文字最后叠加。水墨的雾要画在它该吞没的东西之后；水彩的叶梗要先画，并且只画在叶子外面。

## 三、毛病清单（都真实出现过）

**水墨**

| 问题 | 改法 |
|---|---|
| 后面的远山透过主峰 | 先远后近，`wash` 默认会遮挡身后 |
| 笔画像梯子或串珠 | 落笔间距跟笔毛挂钩（`bristle_stroke` 已处理） |
| 小路像头发丝，或是折线像裂缝 | 16 条左右，用 `spline` 平滑，只画在山体上，从雾里伸出来 |
| 皴擦像撒逗号 | 约 150 笔，长而顺坡，集中在阴面 |
| 山脊像卡通描边 | 山脊线用淡墨（0.3）加飞白，边缘靠水痕 |
| 松针像海胆 | 扇形松针，下面垫一团淡墨晕 |
| 主峰像锥子 | 左右坡宽度不同，加山肩和起伏 |
| 远山被挖出方块、断边生硬 | 用「从水线以下升起的山包」来留出水面，不要直接挖空一段 |

**水彩**

| 问题 | 改法 |
|---|---|
| 纸纹像砂纸或拉毛墙 | 纸纹受光强度约 0.3，纸纹要细 |
| 叶子中间一圈深色像靶心 | 第二层深色用湿画（soft 约 16）偏向一侧积色，不要同心 |
| 叶梗画到了叶面上 | 先画梗，用 `*(1 - 叶遮罩)` 限制只在叶外 |
| 颜色发脏 | 同一处罩染不超过三层；亮部留白或用 `lift` 提白 |
| 深色团块漂到树冠外，成了孤立的圆点 | 后几层罩染乘以第一层树冠遮罩（稍微扩一点），深色只积在冠内 |
| 树枝乱成一团 | 只画 3–5 根，从树干向上向外伸进树冠，长度按树冠大小算 |

**剪纸拼贴**

| 问题 | 改法 |
|---|---|
| 大面积蜡笔纹像满屏刮痕 | 大色块用 paper / kraft，蜡笔只用在点缀或小物件上 |
| 撕纸白边看不见 | 白边要宽出 5–8 像素（大半径模糊加低阈值），并且只出现在部分边缘上 |
| 画面顶边或左边多出一条阴影 | 阴影偏移不能用会首尾相接的循环平移，要用补零平移（已修） |
| 月亮画了光芒，像太阳 | 月亮用蜡笔光圈加几颗闪光，不要放射线 |
| 脸的五官太粗太凶 | 线宽约 r×0.035，腮红用 `glow` |
| 小鸟画成了一团 | 小鸟用两道细弧线（线宽约 2.6），不要用很短的粗笔 |
| 纸片被画面边缘切掉 | 云、气球这类主体要完整留在画面内，留出边距 |

**韩国彩铅**

| 问题 | 改法 |
|---|---|
| 颜色淡得几乎看不见 | 排线要够密（叠加后趋于饱和）；颗粒阈值不要卡太狠，用 pressure 控制能压进多少纸纹 |
| 奶油、白瓷等白色物体消失 | 用暖奶白色铺底，配淡紫灰或淡蓝灰阴影，再加一点白色高光 |

**日本动漫**

| 问题 | 改法 |
|---|---|
| 云是一个个正圆泡泡，明暗交界是斜直线 | 用不规则团块，数量多、大小不一；暗面用「团块减去偏移的自身」做成月牙形 |
| 人物腿太长 | 裙摆到膝盖附近，露出的腿约为身高的三分之一 |

**编辑风手绘**

| 问题 | 改法 |
|---|---|
| 色块死板，像电脑矢量图 | 每层专色都要有颗粒、浓淡不匀和几像素的套色错位 |
| 颜色太多太杂 | 4–5 种专色，靠叠印得到其他颜色（比如青叠黄出绿） |

**油画厚涂**

| 问题 | 改法 |
|---|---|
| 笔触像一根根塑料管、橡皮泥 | 凸起要克制：平顶鼓边的截面，高光约 0.1，打光范围约 0.8–1.18 |
| 笔触之间大量露底 | 铺底笔加密（density 约 2），宽笔铺满后再上细笔 |

**浮世绘**

| 问题 | 改法 |
|---|---|
| 云带半透明，透出后面的轮廓线 | 云带用不透明的色版（strength 超过 1，确保完全盖住） |
| 标题签和云带、主体撞在一起 | 标题签放在天空的空白处，其他元素给它让位 |

**像素风**

| 问题 | 改法 |
|---|---|
| 背景底部露出一条黑带 | 天空渐变和楼群都要铺到地面线，不留缝 |
| 光晕变成一大块方形点阵 | 光晕半径要小（约 20 像素）、强度约 0.4–0.5；霓虹光晕压扁一些 |

**黏土定格**

| 问题 | 改法 |
|---|---|
| 手指抹开的天空像揉皱的锡纸 | 指痕要宽（40–70 像素）、数量适中（200–350 笔）、脊线柔和低矮（`smear` 的 height 约 4）；先铺几种颜色再抹，拖色才看得出来 |
| 天空里出现笔直的矩形色块边 | 不可平铺的噪声不能取模循环平移，要在噪声图内部取窗口（已修） |
| 预先铺的色块边缘太硬，抹完还是一块一块 | 色块之间用 smoothstep 柔和过渡，再用手指抹 |
| 浪花像一排排一模一样的墙纸花纹 | 每朵浪的长短、高低、间距都随机；只排两三行，近大远小 |
| 鲸鱼像一条面包，尾鳍像两根分开的香肠 | 头要圆、身体向后收窄入水；尾鳍用一整片带中间缺口的翼形轮廓 |
| 前景水面在藏在下面的尾柄处鼓起一个包 | 部件默认顺着下面的高度铺；被遮住的部分别伸进水面太深，或在水线处用泡沫盖住 |

**蓝晒**

| 问题 | 改法 |
|---|---|
| 蕨叶像一串箭头或锯齿（鱼骨状） | 每片羽片做成一整片带圆齿边的叶片，加淡色小叶脉；不要一颗颗分开的小叶 |
| 小叶改成椭圆后又像含羞草 | 同上，蕨类的羽片是连在一起的 |
| 蒲公英绒毛几乎看不见 | 细丝不透明度约 0.3、lift 约 1；抬得太高会被半影模糊掉 |
| 刷涂边缘像毛刺、撕纸或动态模糊 | 按一笔笔横刷建模：每根刷毛在自己的位置干净利落地停住，干刷的断续用横向拉长的噪声（已修） |
| 茎穿过白色题字 | 题字放在留白处，茎的走向给题字让路 |
| 飘散的种子被涂布边缘裁掉，只剩一根线 | 小物件要完整落在涂布区域以内 |

**十字绣**

| 问题 | 改法 |
|---|---|
| 斜向的短线（太阳光芒）被吸附成一串 L 形台阶 | 短斜线就绣一针，从孔到孔（`step` 设大） |
| 半针叠在十字绣上，像贴了一层纹理 | 真实绣法不会这样叠：亮部直接换浅一号的线绣十字 |
| 烟囱被屋顶整个盖住、烟线穿过标题 | 先算好屋顶轮廓再定烟囱高度；烟用半针小烟团，往留白处飘 |
| 布面格子太黑，像方格纸 | 布孔暗度约 0.34，布块起伏约 0.065 |
| 花朵和松树重叠 | 摆放前按格子算好每样东西占的列 |

**复古仪器面板**

| 问题 | 改法 |
|---|---|
| 喇叭布上的金丝像一排点点，看着像冲孔板 | 金丝纬线要长浮（压过三根经线再钻下一根），闪光沿线缓慢变化 |
| 刻度单位和最后一个数字挤在一起 | 单位放到刻度末端外侧，或者直接写完整数值（530…1600 kHz） |
| 浅色字印在浅色喇叭布上看不见 | 丝印颜色要和底材拉开明度 |
| 一大片喇叭布太平、太假 | 布是半透明的：把后面喇叭的圆形暗影淡淡透出来 |

**贴纸拼贴 · 小票**

| 问题 | 改法 |
|---|---|
| 面包只有一道长割口，像红薯或叶脉 | 三道斜向交叠的割口：浅色裂口加深色翘边，再撒面粉 |
| 花束的花用同心圆画，像靶心或棒棒糖 | 侧面郁金香：两片带尖的外瓣，前面一片浅色瓣 |
| 印章小字压在内圈线上 | 中心字上移，分隔线放在 +0.16r，小字写短，全部收在内圈以内 |
| 小票字太黑，像打字机不像热敏纸 | 灰色油墨 #4f525a、浓度约 0.8、边缘微糊，加断针竖纹和走纸浓淡 |
| 小票右半边整条发灰 | 横向卷曲压到很小，只让长边两端翘起 |
| 纸边的贴地阴影像描了一圈黑线 | 纸张接触阴影降到约 0.26 |
| 印章盖在条码上看不清 | 盖在金额和星号一带的稀疏处，只压一点字，更像真的 |
| 印章墨色太匀，像电脑填色 | 加压力倾斜、大块浓淡和漏印小坑 |
| 标签上的字溢出圆标 | 文字改短、字号调小 |
| 右下角空出一大块 | 加摊位号圆贴纸，第二个吊牌用长绳垂下来 |

**实验笔记本 · 贴纸**

| 问题 | 改法 |
|---|---|
| 铅笔线像干净的矢量墨线：细、匀、太黑 | 手绘线宽约 3 px、抖动约 1.6；石墨只挂在纸纹凸起上，重压也保留一点颗粒 |
| 轻压的排线、表格横线断成一串点点 | 覆盖率保留约四成连续的浅灰，颗粒只调制剩下的部分（`_graphite` 已处理） |
| 折线图数据点画成小圆圈，像字母 o、c | 用压实的小铅笔点（很小的螺旋，pressure 1） |
| 曲线一笔画成，太完美 | 分两笔画，接头处稍错开、稍重叠 |
| 标注字压在曲线上，单位和刻度撞在一起 | 标注放到曲线下方空白处，用铅笔小箭头指过去；单位放到轴端上方 |
| 贴纸孤零零浮在图下面，看不出指什么 | 从最佳点画铅笔虚线到横轴，贴纸贴在同一个 x 上 |
| 标签机胶带两端剪成 V 形缺口，像彩带横幅 | 两端直剪、略斜、小圆角 |
| 咖啡渍像肥皂泡或透镜 | 外缘一圈细而深的水痕线，内部几乎均匀的淡色；圈有断口、一侧更深 |
| 红笔箭头被后贴的便利贴盖住 | 箭头停在便利贴边缘外，或先贴便利贴再画箭头 |
| 标题上的荧光笔起笔压到了前一个字 | 起点按字宽算，落在目标字的左边缘 |

**黑板板书**

| 问题 | 改法 |
|---|---|
| 粉笔线像干净的矢量线：满压几乎实心、边缘光滑 | 满压也要留约 15% 的坑点（阈值 0.98 − 0.86 × 压力）；笔尖接触面按线宽的 0.26 倍模糊，边缘才会毛、才会断 |
| 中文（黑体）比 Helvetica Bold 细一截；加粗后 30 px 的复杂字糊成一团 | 中文按字号加粗，小字加粗减弱；40 px 以下自动加压、减轻颗粒和边缘扭曲（已处理） |
| 字体的粗体 ∝ 被粉笔加粗后闭合，看着像 ∞ | 用 `propto()` 手写一笔：双纽线的左瓣加两条向右的尾巴 |
| 大气层用侧锋铺色，成了一整块发闷的矩形，压住上面的波浪和标注 | 压力约 0.3、strength 约 0.6，用 `weight` 做渐变（近地面浓、往上淡），左右两端长距离渐隐 |
| 上节课的残影被后来的大擦痕又擦没了，或者压在新板书下面影响阅读 | 残影 keep 取 0.26–0.34，大擦痕 strength 不超过 0.6；残影放在空白处（上沿、角落、标题和图之间） |
| 动图调色板只取最后一帧，满屏绿色吃掉色位，粉彩粉笔、光谱条发灰 | 调色板用加权像素样本做中值切分（彩色像素 ×5、亮色 ×2），所有帧仍共用这一张 |

**赛博朋克**

| 问题 | 改法 |
|---|---|
| 倒影按一条地平线整体翻转，位置全错；被近处天桥挡住的远景在倒影里成了黑洞 | 每个物体按自己的着地行（mirror row）翻转，最近者优先；被挡住的空洞用对应行的雾色填 |
| 一楼店面发光太亮太大，近处成了过曝的纯色墙，货物画成色块像霉斑或柱状图 | 店内亮度 0.2–0.45，从天花板往下衰减、两侧变暗，加货架侧影和人影；最近的街区多放卷帘门和自动售货机 |
| 雨丝统一提亮成满屏灰帘，溅落圈太大像气泡 | 每根雨丝按周围光照上色，只在霓虹附近看得见；溅落圈半径 3–11 厘米，只在水洼里亮 |
| 蒸汽用背后的暗画面照亮，完全看不见 | 蒸汽按光源外溢光照明（像一块浅色表面），再加前向散射 |
| 光轨沿街飞，全都汇向灭点，像激光或钢丝 | 让飞车横穿街道：从一侧墙后出现，拱形掠过，消失在另一侧墙后；加频闪点 |
| 全息水母的 1 像素线被雾和扫描线吃掉；C 形生殖腺像数字「93」，后排两个像一双眼睛（成了脸） | 线宽至少 2 像素；生殖腺放在伞内的水平面上，侧视压成一条柔和的粉带；副标用 Light 字重，撕裂切片别落在字上 |

**卡通手绘**

| 问题 | 改法 |
|---|---|
| 窗外的太阳画到了墙上 | 窗里的东西都乘玻璃遮罩；被挡住的轮廓只画露出来的那段弧（`ellipse_pts` 给 a0/a1） |
| 手臂从头顶直直伸出、末端一个圆球，像触角或棒棒糖 | 肩膀放在身体侧面中部，先画手臂再画身体；bend 的正负让手肘朝外弯；手套加拇指、袖口和两道指缝 |
| 两个角色挨得太近，一个的手套落到另一个脸上 | 只画外侧那只手臂，内侧的藏在身后 |
| 烤色蜡笔涂在面包中间，像脸上的脏污 | 烤色只涂面包芯内缘一圈（轮廓遮罩减去内缩的轮廓），脸所在的中间保持干净 |
| 纸纹太粗，色块上像砂纸 | 纸纹受光约 0.026，颜料盖住的地方纹理减半（已处理） |
| 闪光星像菱形 | 用指数约 3 的星形线，竖向拉长（已处理） |
| 白字写在米色纸上看不见；白云、手套、烟团都是白色小圆团，挤在一起分不清 | 浅色字只写在深色块上；白色圆团之间拉开距离，背景里不放白云 |
| 飞溅的碎屑落到脸上 | `crumbs(..., avoid=角色遮罩)` |
| 动图 2.3 MB：铅笔稿每阶段换强度又跟着抖，网点和蜡笔也跟着抖，每次叠化都整片重编码 | 只抖墨线，颜色和铅笔稿留在纸上不动；铅笔稿强度在勾线之后固定；阴影和质感合成一个阶段（1.9 MB） |
| 黄油的嘴压在底边线上；滴落太小，水洼像一根黄条 | 脸按物件正面的高度缩放、上移；滴落画成从前沿挂下来连到水洼的一道，最后画，压在轮廓线上 |

**等轴 2.5D**

| 问题 | 改法 |
|---|---|
| 白墙整面发灰，比同一面墙上方的山墙暗一截 | 高度图 AO 会把楼自己的高度算进墙面；侧面改为沿法线（及左右 40°）看地平线，只算挡在前面的东西（已处理） |
| 屋檐、树冠被当成实心柱子，墙顶一圈发黑 | 顶视图同时记录最高那根「柱子」的顶和底：相接的实体合并，悬空的单算，只挡它实际覆盖的那段仰角；檐下不算墙角折痕（已处理） |
| 平顶楼墙上出现一条锯齿状灰带 | 柱子的顶 / 底不能跨边插值：细檐口一插值就在墙边造出一块假悬空板；改最近邻采样（已处理） |
| 长投影的半影满是颗粒 | PCSS 每像素旋转采样之后，再做一遍按深度保边的可分离模糊（已处理） |
| 海面上的短浪线竖着立起来 | 等轴视角里世界 (1, 1) 是屏幕竖直方向；浪线沿世界 y − x 走才是屏幕水平（已处理） |
| 砖缝像棕色勾缝，沙滩缝像一根根圆木 | 草地砖侧面保持草色，只让台地露出土层；缝宽约 0.028 格 |
| 岛占满底座，沙滩一圈像棋盘，看不出是岛 | 屏幕左下、右下两条前边留 1.5–2 格海面；沙滩只放在部分岸边 |
| 卫星天线正对镜头，像棒棒糖或路牌 | 朝向和视线错开（yaw 约 125°、仰约 50°）；反射面中间暗、边缘一圈亮（已处理） |
| 数据卡字太小，折线图压到单位上 | 卡片约 2.9 × 1.65 格，大数字约 0.7 格高；折线图从「数值 + 单位」之后开始（已处理） |
| 引线横穿房顶，画面乱 | 卡片围着各自仪器摆，用 `unproject()` 按屏幕位置定点，引线短、不跨主体 |
| 草地上散落的小花像彩色糖珠 | 花开在灌木上：`tree(kind='bush', flowers=…)` |

**单线画**

| 问题 | 改法 |
|---|---|
| 纸飞机画成小三角，像风筝或三角旗 | 用 3/4 俯视的飞镖形：近翼大、远翼透视缩小、中间一道折痕；笔从尾部缺口进、从机头出，四个角保持尖 |
| 航迹从谷底地面起飞又落回地面，看不出从哪飞到哪 | 线从 A 屋的窗里穿墙飞出，从机头穿墙飞进 B 屋的窗；两屋之间不画地面 |
| 翻圈放在爬升段，像挂在线上的气球或套索 | 翻圈放在轨迹顶部、路径接近水平处，`curl(..., aspect≈1.2)` 让圈更圆 |
| 航迹和房子一样粗、从地面附近起落，整条读成山丘或山脉轮廓 | 航迹段 `pressure=[(s0, s1, 0.62)]` 用轻手画细，从窗口直接上扬，不先下沉 |
| 轨迹末端急转直下，在飞机尾部勾出钩子，还和后翼边贴成细长条 | 把飞机尾部缺口的坐标作为轨迹最后一个控制点，入射角放缓到约 35° |
| 窗户、山肩这类要从里面够到的形状一笔连不过去；原路回来的短线头是钝圆头 | 用 `retrace()` 原路去再原路回（成图看不见）；原路折返处自动提笔收尖（已处理） |
| 树冠贴着屋檐，两样东西粘成一团 | 物件之间留出间隙 |
| 动图里深蓝渐变出现一圈圈色带，唯一的琥珀色窗被量化成米黄 | 调色板拆开：空底色 110 色、画出来的东西 145 色（饱和像素 ×6）；量化前加固定的 4×4 Bayer 抖动，每帧相同 |

**柔光 3D**

| 问题 | 改法 |
|---|---|
| 掉下去的球悬在字上方，字面上有莫名的暗斑 | AO、阴影、落球这类查询在包围盒外用了盒子距离，球停在了看不见的盒子上；字形距离网格覆盖的范围内一律用精确距离（已修） |
| 字脚一圈球发黑，字的下半侧有黑带 | 球海距离场只查 2×2 格、封顶半格，清空的格子旁边 AO 以为贴着球；改查 3×3 格、封顶一整格，AO 半径 0.3、强度 1.25、留 0.1 的底（已修） |
| 字从球海冒出来，脚下一圈空槽露出黑地板，像抠图 | 被挤开的球不删，按「落进最近的空窝、层层叠、要有三点支撑」堆到字脚：`part(pile=10, pile_top=0.3)` |
| 字埋得太深，s 只露出上半截像 c，整词读成 rice | s、e 用 bob 单独抬高，让它的下半弯露出来；part() 加 pile_top=0.3，只堆一层，堆起的球不能高过字母下半部 |
| 阴影里的薄荷球发青灰、发脏 | 淡紫天光乘薄荷色会发灰：阴影加按材质自身色调的次表面补光，天光调强、主光调弱 |
| 球排成直行一直通到远方，像条纹墙纸 | 整个场景转 30°，行列斜着走 |
| 清晰的字边有锯齿，高光一节一节 | 成片 1.5 倍超采样再 Lanczos 缩小；字形距离场模糊 2 像素，法线差分步长 2.5 个格（已处理） |
| 上三分之一一片惨白，远处和背景之间有一道硬地平线 | 雾色等于背景地平线色，雾距约 42；镜头稍抬，露出天空渐变 |
| 动图 3.4 MB，小黄球被量化成一块平色片 | 景深跟相机一起先设好（每个阶段都柔），曝光并进灯光强度，主光和轮廓光合成一个阶段；调色板样本里彩色像素 ×5 |

**形变动画**

| 问题 | 改法 |
|---|---|
| 起点、绕向没对齐，中间帧塌成一条条碎片 | 先 `normalise`（同样点数、顺时针、从正上方起），再 `align`（FFT 互相关找最佳起点）；一串关键帧用 `chain` 依次对齐 |
| 每段 5 个残影、关键帧又太大，雪花和云的花边残影叠成一片噪点 | 关键帧约占面板宽的六成；每段只画 3 个残影，中间那帧填色约 0.42，两侧只留细线和约 0.14 的淡填色 |
| 运动轨迹画成圆点，和中间帧上的对应点混在一起，看着像轨迹绕了个圈 | 轨迹用虚线（`trail(dash=)`），圆点只用来标对应点，图例里分开写 |
| 速度线等长等距，像梯子，落在河边还被当成水流线 | 海报里不画速度线，靠挤压拉伸和残影间距表现速度 |
| 纸纹把奶白色的云也盖成了砂纸 | 形状保持纯平：纸纹只加在露出的纸面上（`tooth` 遮罩），面板和形状只有极轻的印刷颗粒 |
| 闭合样条在直角处过冲，海浪底角鼓出一个包；太阳的细光芒是断开的小棍 | 只对曲线部分做样条，底边用直线接；光芒用楔形加圆头，和圆盘连成一体再描外轮廓 |
| 后一段的残影线压在前一个关键帧上；标签重复画了两遍，颜色变深 | 画完残影后重画前一个关键帧（只重画形状内的细节）；文字和形状外的点缀只画一次 |
| 「↺」在所用中文黑体里没有字形，显示成方框 | 循环箭头用 `outline` 画圆弧再加 `chevron`，方向取圆弧终点的切线 |

**报刊拼贴**

| 问题 | 改法 |
|---|---|
| 齿轮像一块灰饼：齿面和背景一样亮，窗口被投影压灰，齿比网点还细 | 齿面反照率约 0.56、metal 约 0.3，加车床纹的「领结」反光；抬起高度约 8，背景投影 0.35；齿距至少约 4 个网点（r=108 用 36 齿），剪边约 9 px |
| 发条画成一圈圈同心圆，像靶子 | 圈数 4–5，`flare` 约 1.6：里圈密、外圈松，才看得出是螺旋 |
| 打字机字体没有「→」，出现豆腐块 | 逐字检查字形，缺字自动换中文黑体（已处理） |
| 问号纸片压住主体表盘的数字 | 用上一个字的 Frame 算位置，整排标题缩小；主体整体右移给标题让位 |
| 红章盖在密密的报纸字上认不出 | 章盖在牛皮纸的空处 |
| 邮戳环形小字断成「CUR:OSTI」 | 环形字至少 18 px；橡皮漏印改成部分漏墨（0.3 + 0.7 × keep），细笔画不断（已处理） |
| 剪下的照片白边处处一样宽，像模切贴纸 | 白边宽度沿周长慢慢变宽变窄（`wander` 约 0.45），但永远不剪进物体（已处理） |
| 散落的零件看不出是从闹钟里飞出来的 | 先从缺口画几条虚线弧再贴零件，起点错开别汇成尖点；离缺口最近放一颗螺丝 |
| 带邻字的报纸剪字，邻字太大太黑，抢了主字 | 邻字字号约 0.075 倍、浓度 0.62，主字周围留一圈空 |
| 报纸透印太重，镜像标题像渲染错误 | 透印浓度约 0.045，模糊 1.4 px |
| 牛皮纸纤维太长太黑，像裂纹或头发 | 纤维 4–20 px，深色浓度 0.2 |
| 动图调色板被牛皮纸和报纸占满，芥末黄纸片变成土黄 | 调色板取样时高饱和像素算 5 倍（色差 24 → 2.7 / 255） |

**弥散玻璃**

| 问题 | 改法 |
|---|---|
| 前面的卡片压住后面卡片的字（「周三」「60%」被切掉一半） | 卡片只在对方的内边距里重叠（不超过内边距），文字离重叠区远一点 |
| 列表最后一行和底部按钮撞在一起 | 先按行距（约 84）算好列表总高，按钮从卡片底边往上放，不够就加高卡片 |
| 玻璃太「奶」，像磨砂塑料，后面的东西透不出来 | 白纱 tint 约 0.24（近光源一侧厚、另一侧薄），saturate 约 1.5；背景色团之间要有足够的色相差 |
| 小球刚好顶在卡片边上，像放在卡片上面 | 让小球三到四成真正压在玻璃后面，模糊的那一半才读得出「透过玻璃」；小球也别和卡片边相切 |
| 背景的色团和光带几乎全被卡片挡住 | 光带穿过卡片之间的空隙走，色团饱和度提一点 |
| 折线图的面积填充在末端成了一团紫雾 | 填充 alpha 约 0.16，两端各 22 px 渐隐（已处理） |
| 柱状图柱子太细，满高的空槽像幽灵柱，「一」看着像减号 | 柱宽取间距的一半，空槽 alpha 0.1；横轴用日期加「今天」 |
| 动图调色板被浅色背景占满，渐变控件量化成灰，小球出现等高线色带 | 调色板样本给饱和像素加权（×6 / ×3，暗色 ×4），每帧叠同一张 4×4 Bayer 抖动（约 ±2.4 级）：逐帧不变，「和上一帧相同」的透明差分照样有效 |

**包豪斯几何**

| 问题 | 改法 |
|---|---|
| 颗粒太重（约一成面积露纸），色块像砂纸、字像磨旧的橡皮章 | 露纸坑点控制在约 2%，只出现在墨膜偏薄的刮板条纹里；黑墨最少（GRAIN 0.4） |
| 坑点成团，像均匀撒了一层雪 | 纸齿用像素级白噪声加少量团块；墨膜另加约 ±2.5% 的浓淡微纹理，不全靠露白点 |
| 方块直角被磨圆 | 版边只做 3×3 轻模糊再加噪声阈值，不用大半径模糊 |
| 页边小字、铅笔版号、色标条压在裁切线上 | 左起 x≈86、右止 x≈1834，色标条末端离裁切线至少 40 px |
| 叠印色标全显示成上层颜色 | 丝网墨基本不透明，叠印色标默认关（`overprints=False`） |
| 黑色标注印在蓝色上看不清 | 深色块上的标注从该色版挖空（`knock=`），露出纸色 |
| 「60 °」度数符号离得太远 | 度数符号自动收紧 0.1 em（`_KERN`） |
| 标题和右上角讲座信息撞在一起 | 先按 120 px 模数排好每栏宽度，信息行写短 |

**复古 Synthwave**

| 问题 | 改法 |
|---|---|
| 太阳被泛光冲成一团白，横条切口被光晕填平 | 太阳底色先压到约 0.72、发光 level 约 0.4，让泛光提回来；切口厚度从条距的 0.2 递增到 0.7 |
| 横穿太阳的细条云像多出来的切口 | 有切口的太阳前面不加 `streaks`，细条云只放在太阳外 |
| 海面倒影是一团糊的圆，像水下还有一个太阳 | 按世界深度把水面切成横带，每带横移、以太阳所在列为中心随机拉伸或压缩（越近越乱），再用短划调制；光源的倒影比天空强约 2.4 倍 |
| 远处网格变成一大片平的橘色雾带 | 雾距 150 m，雾色压暗、偏品红；网格线按屏幕像素距离算覆盖，格子小于几个像素就换成平均值，不出摩尔纹 |
| 录像带噪点像画布纹理，线条满屏抖动打折 | 噪点约 0.014、横向拉长；逐行抖动约 0.35 像素，只留一条跟踪噪带和底部磁头噪声 |
| 霓虹手写字白芯太粗，整句像白字；随机断管像渲染错误 | 白芯只取笔画最中间，core 约 0.5；断管默认不加 |
| 棕榈冠像冷杉，改了又像平顶伞 | 叶柄仰角从陡到平均匀分配，加两片下垂枯叶；小叶在 3D 里朝叶尖前扫、向两侧展开再下垂后投影，不要一律竖直挂下 |
| 城市摆在线框山前面，暗对暗，高楼像幽灵 | 城市放在灭点旁、背靠落日余晖，山脉从城市右边才开始 |
| 小岛挡住太阳正下方，吃掉最亮的一段倒影 | 小岛只和太阳左缘略微相交 |
| 阶段快照里地平线下是整块橘色，太阳下半截露在地上 | `sky()` 先铺一层没点亮的暗色地面；太阳在地平线处截断 |

**拼豆**

| 问题 | 改法 |
|---|---|
| 钉板四周出现一整块深灰方框 | 豆子高度只写在豆子覆盖处（其余设 -1e3），别把整个窗口抬到板面高度 |
| 熨过的豆还是一颗颗分开的甜甜圈，和没熨的差不多 | melt 同时控制：外半径 +22%、smooth-min 融合宽度增到 0.55 倍珠距、孔缩 74%、高度降 40%，外沿和孔口分开倒圆；0.4 是半熔（孔在、珠粘、留菱形缝），0.7 是成品 |
| 熨平的杯垫像一块块六角螺母，表面像糖霜 | 接缝沟只在半熔时有（×(1 − m/0.7)²），顶面只留 5% 的枕形起伏，熨烫纸细纹 0.08 px |
| 收纳盒里的豆堆成一根根塔 | 散豆落在下面的东西上，但限高约一层豆（`cap`）；每格约 20 颗，按抖动网格铺开 |
| 镊子像两根筷子、像白纸条 | 两腿成 V 形，尾部合拢、尖端张开一颗豆宽，腿宽 1.5→4.9 px；钢色偏暗，靠拉丝纹和窄的灯箱反射显出金属；悬空层单独投影 |
| 白豆侧壁出现竖条纹、钟乳石状锯齿 | 侧壁的 AO 和阴影改从平滑图上、在墙脚和墙顶内侧取样；墙顶取最近几行的最大高度；太陡的抗锯齿斜坡按侧壁着色 |
| 熨烫纸（缓坡）上出现发丝状细线 | 朝镜头的缓坡会把一行拉成约 1.1 屏幕行，超过 1.5 行才算侧壁 |
| 高光要么看不见，要么每颗豆一圈白光环 | 用灯箱反射：镜面方向落在主光方向 8° 内（越粗糙越宽）才亮，得到左上沿和孔内远侧唇口两道弧；菲涅尔权重压到 0.08 |
| 熨烫纸盖住标签，字变半透明 | 后放的会盖住先放的，用 `on_top()` 把标签、杯垫提到最上层 |
| 图例铅笔勾挤到前一栏数量上；深绿、叶绿都印成 G | 勾直接打在豆子图标上；符号原样印，不转大写 |

**岩画（凿刻砂岩）**

| 问题 | 改法 |
|---|---|
| 沙漠漆像木纹、像一整幅竖条窗帘 | 不用全幅竖条噪声；漆膜近乎均匀（0.86 ± 0.09），流痕是一条条独立的对象：多从顶部起、往下变窄变淡、略左右漂移，边缘 ±2.5 px |
| 流痕像条形码（硬顶的黑色矩形） | 流痕顶端 50 px 渐入、长度 30%–100% 段渐隐，不从硬边矩形源往下涂 |
| 流痕糊成一团团烟，挂在羊身下面像投影 | 不要整体 bicubic 放大成软团；只在横向留 ±2.5 px 的过渡，纵向才平滑 |
| 流痕像一根根火柴棍 / 芦苇帘 | 宽度取对数正态（中位约 18 px）、约 110 条、只把漆加厚 0.2、锰色 0.6；再加约 26 条更宽的浅色流痕（漆被水流冲薄） |
| 薄漆的「窗口」成了迷彩斑块 | 不用块状窗口，浅色也做成竖向流痕 |
| 凿点太稀，图形像撒了一层粉笔末 | 凹坑数 ≈ 3.4 × 图形面积 / 单坑面积；坑深相加后饱和（dmax ≈ 2.9 px），内部打满只留小暗缝，轮廓在一个坑的尺度上毛糙 |
| 羊身细长像腊肠，整群首尾相连成一条带 | 身体加深（-0.20 到 0.15 个身长）、颈粗；大羊一排、母羊小羊一排错开，彼此留空 |
| 剥落像贴上去的光滑椭圆，四周一圈黑 | 轮廓拆成 14–40 px 的小段、每段向内弯成小贝壳弧；AO 减弱（深度 2.4 / 7 / 22）；疤面颗粒减半、鲜橙色带铁质色带，唇口一圈浅色风化皮 |
| 地衣像绿色颜料点、像一枚枚硬币 | 低饱和橄榄色，椭圆加不规则叶状边、龟裂纹、小黑子实体、周围卫星小点，alpha 约 0.7 |
| 太阳螺旋中心成了「f」，光芒离螺旋太远像飘着 | 螺旋从 1.4 rad、10% 半径起步，中心只点一个小点；光芒从最外圈外 1.7 倍线宽处开始 |
| 蹄印像等号或乱点 | 两瓣从蹄跟到蹄尖向中线收拢成心形（尺寸 ≥ 30 px，凿点 size 0.66）；第一枚离羊蹄远一点 |
| 小孩手印糊成一团 | 手印 ≥ 约 95 px，凿点 size 0.62、density 1.2，手指才分得开 |
| 光秃砂岩像一块木板（层理像木纹、小凹坑像钉眼） | 层理振幅减半且时有时无，石色只随层理变 1–3%；凹坑改成 7–26 px 的浅碟 |
| 画面顶边、左边多出一条黑带 | 投影步进前用边缘复制把高度图 pad 一圈（越界补 0 会被当成一堵墙投下影子） |
| 岩檐只像一道裂缝 | 台阶 34 px 才有一条看得见的檐下投影；檐口折线 + 轻微倒圆 |
| 新旧凿痕只有「全新」和「鬼影」两档 | 加中间档 age 0.3（新月、计日刻痕、掷矛手）：0 新凿、0.3 几百年、0.6–0.7 几乎被漆盖回 |
| 动图里橄榄绿地衣被量化成灰 | 给偏绿像素单独留 6 个调色板位，「和上一帧相同」的占位色用品红 |

**古埃及墓室壁画**

| 问题 | 改法 |
|---|---|
| 弯腰的人还是正面宽肩，后肩翘到头顶上，横过胸前的手臂像一条绶带 | 按前倾角把肩宽往侧面收（前倾 32° 时只剩约 15%），两只手臂都从胸前出发；坐姿直接给 `turn` |
| 蹲坐的书吏把脚转 180° 后脚底朝天，两臂缠在一起 | 压在身下的脚左右镜像（`mb=True`，脚尖朝后），肘部 IK 一律朝下弯，`turn=0.45` 收窄躯干 |
| 灰泥脱落像贴上去的褐色石片，带一圈发亮的白边 | 做成真的高度图：洞深 8 px，低角度光沿高度图投影（左上内壁一道影），洞底近壁处加环境遮蔽；石膏白边只留 2–4 px 且断断续续，洞口四周的颜料按台阶剥落 |
| 底色把人物里的红稿整个盖掉，剥落处只露出黄底 | 底色绕开要上色的形状刷（`ground(around=True)`）：动画里红稿一直留到上色那一步；人物上的剥落露出灰泥上的红格和红稿（`age(zones=...)` 可以指定几处） |
| 干活的人都戴宽项圈，分不出主仆 | 只有总管和书吏戴项圈；劳工赤膊，有的剃短发（`wig='cap'`，露耳朵） |
| 象形数字 ∩‖ 读成「ΛI」：一竖藏在 ∩ 的腿后面 | 每个 ∩ 之后让 0.78 em，竖笔间距 0.3 em，字号 46 px 以上 |
| 粮袋正中那道褶像一张笑脸 | 褶线挪到袋子一侧，竖着走 |
| 无花果树冠是一格格圆点，像波点布 | 尖叶按行排、隔行错开、下一行压住上一行（像鳞片），深浅绿隔行；水囊挂在一根截断的枝上 |
| 锄地的人像在推棍子，量斗像一本书 | 锄头画成倒 V：双手握柄，柄顶绑宽木刃斜插进土，中间一道绳；量斗是上宽下窄的木桶，口上堆着粮，倾斜着倒出一股粮粒 |
| 扛东西的人手捂额头，袋子盖住了脸 | 后手举起扶住，货物压在后肩、在头后面（z 夹在躯干和举起的手臂之间）；部件细节的 z 偏移只给 +0.002，否则筐的编织纹会跳到手臂上面 |
| 埃及蓝像一层蠕虫状噪点 | 蓝、绿两色改用稀疏的亮晶粒加暗颗粒（`T_cryst`），通用颗粒压到 0.05 |
| 底色的斜向刷痕整面平铺，像雨丝 | 两个方向、按大块噪声时有时无，幅度 0.012–0.015 |
| 潮痕像一条钢笔线横穿人物 | 宽约 0.012 H 的柔和带，上沿稍清楚，往下逐渐泛褐 |
| 动图 3.7 MB（满墙颗粒让每次叠化都改掉一半像素） | 关键帧先做 1 px 高斯平滑；量化时新颜色和上一帧已显示的颜色相差不超过 10 级就沿用上一帧的索引（透明差分照样有效，自检仍逐帧比对）→ 1.85 MB |

**罗马马赛克**

| 问题 | 改法 |
|---|---|
| 石子像一个个鼓起的枕头，整幅像碎石路 | 地面是打磨过的：石面只高 1.5–2 px、倒角半径约 1.7 px，漫反射 0.45 + 0.55；切石抖动 4.5%、缺角 20%、转角 ±1.6° |
| 灰色的鱼身里混进淡蓝、粉色石子 | 取石在「亮度 + 红绿 + 黄蓝」对立色空间里比，色度权重 2.6，抖动主要加在亮度上（已处理） |
| 轮廓那一排又宽又长（约 13 px 深而不是 8 px），第二排轮廓铺不出来 | 判断「里面还有没有下一排」用的脊线最大值滤波半径小于一排间距，每排都以为自己是最后一排、往里加宽：半径取 2 × 排距（已修） |
| 波浪纹边框整圈不见了，只剩白排 | 局部坐标的周期被带高乘了两次，波浪画到几千像素外：周期 / (1.5 × 带高) 再乘带高 |
| 边框的浪是一条条细 S 线，像卷草不像浪 | 浪身是从黑框边长出来的实心块，浪尖沿一条渐细的粗线卷回去，中间留一个白「眼」 |
| 收起挂在帆桁上的帆像一把伞 | 改成从帆桁垂下、向一侧鼓起的方帆，竖向缩帆索用浅色石子 |
| 小海鸥外面套两圈背景光环，像装在泡泡里 | 所有东西先一圈光环；第二圈只给大图形（船、灯塔、铭牌、网、章鱼），量距离时把第一圈也算进去 |
| 网里的鱼被网线切成碎块，看不出是鱼 | 网里的鱼先铺（眼、鳃线、轮廓、填满），网线后铺，碰到鱼自动断开 |
| 被偷的那条鱼太小、贴着网，看不出章鱼在偷 | 鱼放大到约 150 px、拖到网外，章鱼最长的那条腕绕住鱼尾 |
| 天空里的脱落像一个灰色加号 | 脱落放在边框和海里、靠着裂缝；旧灰浆床压暗偏暖，留下石子方坑 |
| 铭牌燕尾耳尖上散着红色碎屑，小字像虚线 | 耳朵填完只补大于半块的洞（`tuck(small=0.55)`）；字的石子边长取字高 / 5.6，不小于 5.6 px |
| 动图 3.2 MB：最后一次叠化整幅都在变 | 阶段快照和收尾帧都按 `stage_ss` 渲染（分辨率一致）；积灰只成片出现、不整幅压暗；和屏上颜色差 ≤ 10/255 的像素按「没变」透明 → 1.57 MB |
| 动图里金色火焰、光芒变成粉橙色 | 调色板分两份：饱和像素按 12 个色相区等量抽样，单独中值切分 48 色，其余 207 色 |
| 峰值内存 2.6 GB | 2× 渲染按 96 行条带做，起稿、噪声、裂缝图留在 1× 逐条放大；paint / shade / sinopia 只在遮罩外接框里算 → 1.35 GB |

**彩色玻璃花窗**

| 问题 | 改法 |
|---|---|
| 铅条像半透明的灰色铅笔线 | 光晕叠到铅条上只留约两成，铅的颜色压到 #2c2d31 左右（已处理） |
| 同一道条纹横穿相邻几块玻璃，像盖了一层滤镜 | 每块玻璃取自整张料的不同位置：条纹按块加随机相位，方向也按块随机（已处理） |
| 树冠每个圆团单独一块料，铅条围出一圈圈圆，像肥皂泡、像葡萄 | 整个树冠用一次 `glass()`（多种绿随机分给各块），团块的体积靠彩绘：背光侧月牙 `shade`、下缘一串扇贝形描线、受光侧从 matt 里刮出叶形 |
| 小叶子用描线勾轮廓，缩小后成了一团乱线 | 暗部画实心叶片（不透明度约 0.8）再刮出叶脉；亮部从 matt 里刮出叶形 |
| 细枝也切成玻璃，两条铅夹一道棕线像梯子；冬树成了一个「Y」 | 玻璃只切树干和宽 16 px 以上的大枝，大枝要弯；更细的枝和小枝用 `trace` 画在天空上 |
| 太阳周围另切一圈放射块，外沿多出一道圆形铅条 | 区域交界一定是铅条：同一片天空只用一次 `glass()` |
| 燕子像喷气式飞机 | 用从下往上看的雨燕剪影：镰刀形后掠弯翼、短身、深叉尾 |
| 横铁条正好横穿知更鸟的头和鸟巢 | 先定铁条高度（范例是 286 / 490 / 694），鸟、巢、太阳、字都避开 |
| 每个铅条交叉处都扎一个铜丝结，铁条像一排缝线 | 每根铁条只扎几个小结（已处理） |
| 题字带从中间切开，铅条正好穿过字 | 短题字的饰带用一整块料 |
| 树干被切成一节节竹子 | 树干和大枝用竖向拉长的块（`aspect=1.8, angle=π/2`） |
| 秋天透过树冠的画枝和画的叶子拼成像字母的黑块 | 画枝只画在露出天空的地方（`trace(..., clip=)`） |
| 上铅之后整扇窗发暗发闷 | 铅条下面的玻璃压暗只做 4.5 px、0.22（已处理） |
| 带 `--stages` 和不带出的图不一样 | 渲染时才生成的噪声和气泡改用构造时就定好的种子，阶段快照不再挪动随机序列（已处理） |
| 动图 3.3 MB：每个阶段墙面溢光都跟着窗变，整面墙在每次叠化里重编码 | `daylight()` 之前墙用固定的中性溢光；叠化帧里色差 ≤ 18（关键帧 ≤ 6）的像素沿用上一帧（1.8 MB） |
| 小形状也开整幅数组做模糊和遮罩：44 秒、1.6 GB | `matt / shade / circle / ellipse / poly / saddle_bar / lancet` 都只在包围盒里算（约 4 秒、约 1 GB） |

**泥金手抄本**

| 问题 | 改法 |
|---|---|
| 羊皮纸像拉毛墙、灰泥墙 | 封皮的细颗粒起伏误铺到了书页底下：封皮起伏只加在露出的封皮上；皮面起伏只用低频（尺度约 240 px、振幅约 6 px，靠近页边加倍） |
| 正文溢出压进圆图；首行红字标题被挤成两行 | 动笔前用 `text_width` 量：x 高 18 px 时一行约 45 个字符，标题写短；正文按行数算好再定图的位置 |
| 首字母旁窄栏两端对齐后，词距大得像空洞 | 拉伸上限 2.2 个词距；放不下就按拉丁音节加连字号断词（已处理），还不行就左对齐 |
| 打磨金箔像一块黄颜料，带横向稻草纹 | 金是镜子，颜色就是它映出的房间：让平面的反射落在窗光的斜坡上（窗方向 z≈0.8），给石膏底加打磨留下的大尺度起伏（尺度约 60 px、±2 px），才映得出明暗带；拉丝纹振幅压到 0.04，金箔接缝 0.12 |
| 同样的金，在跨页一边亮、另一边发橄榄黑 | 相机放远（z≈6000，接近正交），明暗只看表面法线，不随画面位置漂移 |
| 星盘的网架金色太粗，盖住盘面，看不出是星盘 | 网架变细（黄道环 0.06R、横梁 0.017R、星指针 0.024R），盘面加方位圈（过天顶和天底的圆，只画地平线以上），墨线 0.75 px、不透明度 0.85 |
| 圆图里的行星名字摞成一竖排 | 每个名字沿自己的环写，角度错开成阶梯（150° → 36°） |
| 恒星天里的金星被群青盖掉 | 先贴金后上色，颜料遮罩要乘 (1 − 金)，绕开已贴金的地方 |
| 常春藤叶子像金色小铃铛，压到正文和边框条上 | 叶形要有两侧尖角和深缺口；叶、花、金珠放下前先检查：叶尖和两侧角离正文至少 9 px，离边框条至少「叶长 + 3」px；卷须不能弯回去穿过边框条 |
| 首字母上的白色短划像随手画的加号 | 去掉短划，只留沿笔画中线的白线和三点一组的白点 |
| 次级首字母的红色卷须压进红字标题，像鱼骨 | 卷须放在字左侧 16 px 外；钩子只朝页边一侧，长短交替，末端打卷 |
| 背面透过来的字太重，像渲染错误 | 透印不透明度 0.03，模糊 1.6 px |
| 动图里玫瑰色和金色被量化成褐色 | 调色板取样时，饱和像素算 5 倍 |

**达·芬奇手稿**

| 问题 | 改法 |
|---|---|
| 排线像一团卷毛、像波浪 | 不要把一条长排线切成一串各自弯曲的短笔首尾相接；手是一排一排地排线：同一层排线共用一组带轻微错位的「排界」，长线只在排界处断开，留 0–2 px 的空隙或交叠；手抖 jitter 降到 0.1，所有笔画朝同一边微弯 |
| 蒙皮整片涂黑，像一幅幅窗帘 | 每片蒙皮用 `between()` 取「从前一根肋到后一根肋」的 0→1 场，明暗取 t²：靠前那根肋留白、靠后那根肋才排线、最深处才交叉，蒙皮才会鼓起来 |
| 翼后缘一段段往外鼓 | 蝙蝠翼蒙皮在两个肋尖之间往里凹；镜像到左翼时法线方向会反，弯曲方向按「朝翼内某一点」决定，不按左右写死 |
| 翼形又钝又圆，像一面帆 | 指骨肋从腕点呈扇形散开，翼尖收成尖角，越往外翼弦越短 |
| 红粉笔鸟翼像梳子、像流苏 | 羽毛不画完整轮廓：只画宽羽片的外缘、圆的羽尖和窄羽片的尾段（`overlapped=True`），一片压一片；羽尖要圆不要尖；初级飞羽比次级飞羽长，外侧几根张开约 7° 成「指」；宽羽片靠外缘处排线（被下一根羽毛压出的影子），覆羽画成成排的小圆弧再揉开 |
| 单根羽毛像一片带叶脉的叶子 | 羽枝每 2.6 px 一根、很细很轻，朝羽尖斜；加一段光秃的羽管和两处羽枝分叉的缺口 |
| 扇形排线时有时无，一块一块 | 明暗值不要正好压在排线阈值上（噪声会让它一半过线一半不过），整片均匀的排线 shade 给得比阈值高一截 |
| 尖笔辅助线横穿整页、像划痕 | 圆规只在需要的地方刻一小段弧（翼尖 ±12°），中心线、肩线可以长；刻痕没有颜色，只靠侧光的明暗 |
| 曲柄看起来像个 L 形铁片 | 曲柄臂在轴端加一个套轴的凸台，木把手更长更粗，并用点划线示意它沿轴滑上去 |
| 分解图的零件和机翼撞在一起 | 先算好投影：相机方位角改为 +22°，轴往左下伸，轴缩短到 250，曲柄落在空白处 |
| 旧纸太干净、像新打印纸 | 除了霉斑还要大片柔和的泛黄云斑（纸的施胶老化不均）；霉斑要有清楚的小核，不能只是一团模糊的晕 |
| 霉斑的晕被切成小方块 | 每个斑点的计算框要按晕的半径（约 7 倍斑点半径）开，不能按斑点本身 |
| 墨色发灰 | 铁胆墨水偏暖：淡处琥珀褐、浓处深赭，叠处更深；纸纤维把墨线轻轻打散 |
| 飞鸟序列只是一串「V」 | 每只鸟加身体、尾羽、腕部转折和翼尖张开的初级飞羽，按 `phase` 走完一次上扑下扑 |

**剪影**

| 问题 | 改法 |
|---|---|
| 垂卷用一串椭圆叠成，像一串葡萄 | `ringlet()`：一条左右摆动、每圈鼓一下、越往下越细的长条（约 5 圈），金粉只在每圈上画一笔短斜线 |
| 头发的金粉画成随机小弧，像一串气泡；改成 10 条等距平行线，又像条纹头盔 | 只画 6 条左右长短不一的发丝，顺着发团从额头梳向脑后，线宽约 2 个设计单位 |
| 帽檐是等粗的直条，像一根签子插穿了头 | 帽檐沿一条 S 形中线 `snip`：靠帽冠处最厚（约 22），两头收到 3，前沿上翘，后沿下垂 |
| 帽冠的褶纹全汇到一点，像顶帐篷 | 褶纹画成互不相交的短弧；帽冠上沿用 `scallop` 鼓出一排小圆，做出抽褶感 |
| 蝴蝶结是两个圆环加圆洞，像眼镜，还被帽檐挡掉一半 | 环拉长成椭圆，中间剪一道窄缝（宽约 0.12 倍）；放在帽檐上方、背后是底卡的地方 |
| 猫又高又窄、头很小，像保龄球瓶 | `sheet(warp=)` 只改比例、不重敲坐标：头放大 1.12 倍并下移，身体朝垫子压到 0.62，臀部加宽；再剪出眼睛和前后腿之间的空隙 |
| 船的两面三角帆互相重叠、又压着前桅帆；主帆和后纵帆连成一大块黑 | 第二面三角帆整个放在第一面后缘的右边；主桅最下面的大横帆收起（帆桁下一排小圆）；后纵帆缩到主上桅帆下面；上下横帆之间至少留 14 个设计单位；三角帆保留尖角，只让后缘鼓 |
| 侧框外圈的红色底漆磨成一大片一大片棕斑 | 底漆只在棱顶露出：噪声尺度 5 px（2× 采样再 ×2），阈值 0.66–0.80，强度 0.6 |
| 名字和小字贴到黑色描边带上 | 椭圆越往下越窄：先按 hw = rx·√(1−(dy/ry)²) 算那一行的半宽再定字号；名字 32 px，小字不超过 25 个字符 |
| 墙纸条纹笔直清晰，像现代印刷 | 印版遮罩加约 ±0.9 px 的横向漂移，奶白色墨不透明度 0.66，每幅纸单独印、各自错位和对花，再加一层泛黄 |
| 动图里深红丝绳被量化成棕色，玻璃反光下的黑纸出现一块块色阶 | 调色板样本加权：饱和像素 ×5、深红 ×15、被反光抬亮的黑（亮度 0.075–0.28）×7，再叠同一张 4×4 Bayer（约 ±2.4 级） |
| 峰值内存 1.1 GB：整幅 `blur` 和细尺度 `noise2d` 产生大量 float64 中间数组 | 挂镜线、护墙线的阴影只和 y 有关，按一维算；整幅细噪声换成白噪声加 3×3 均值；2× 金框按 192 行一带分带渲染（重叠 24 行），降到约 0.6 GB |

**凸版印刷海报**

| 问题 | 改法 |
|---|---|
| 大面积实地满是白点，像加了噪点滤镜，木刻黑块发灰 | 漏白（salt）只出现在实地内部，纸齿阈值 0.975 以上，约占 1%–5%；边缘积墨处几乎不漏；木活字凹坑软斑浓度降到 0.15–0.35 |
| 大象前腿斜着伸到老远的鼓上，像撑地的肘 | 以髋为轴把身体整体抬起（约 22°），四条腿都竖直向下；鼓放在前肩正下方，鼓顶 = 前肩高度 + 前腿长（腿比后腿短 4%） |
| 大象像秃头圆球加一根水管，耳朵像第二个头、像垂耳狗、像兜帽 | 象鼻根部宽约一个头高（104→26 渐细），并进前额；耳朵是扇形：前缘弧形贴在眼后，顶端低于头顶让圆顶露出来，后缘波浪、下端收尖；加小象牙和张开的嘴 |
| 腿根在身体里画出一圈圆头轮廓，像插上去的柱子 | 先刻远侧两条腿；近侧身体、头、鼻、近侧腿、尾巴合成一个剪影只刻一圈外轮廓，内部只补大腿、肘几笔短轮廓线 |
| 排线整片一样密，大象像条纹木桶 | 排线线宽跟随明暗（`hatch` 的 tone），lo 约 0.3：背上最亮处线条自然收尖消失；身体用绕远处圆心的弧线，腿用竖线，鼻子斜线加横向皱纹 |
| 鼓上的条纹印成一整块红色楔形 | 条纹相位 = arcsin(u)·9 − y/9，一圈正面看到 4–5 条斜纹，上下各留出箍 |
| 象头上的小帽画成红色贝雷帽、像一颗樱桃 | 非斯帽用直边多边形 `poly`（不用平滑闭合曲线），流苏从帽顶垂到后面 |
| 象鼻尖碰到钢丝，看着像要去抓钢丝 | 鼻尖离钢丝留约 70 px，卷向演员 |
| 画面偏右，桅杆和大象之间空出一大片 | 大象放在两根桅杆正中；背后加雕版衬线：横向细线、椭圆向外渐隐，每样东西周围先 blur 出一圈白再清掉 |
| 舞者的站立腿是两根细线，平衡杆横穿胸口 | 腿加粗（17→9 px）、加黑色舞鞋；手肘弯下，杆放到腰的高度 |
| 马戏圈的圈沿伸出画面右边；锯末和地面投影太黑，像污渍 | 圈的半宽按两根桅杆间距算；锯末密度 0.0035、只在脚边，投影用横向排线（tone 0.55） |
| 纸边的小缺口是一颗颗黑点，像墨团 | 缺口只留 3 个、3–7 px |
| 峰值内存 1.5 GB | `press` 按 240 行一带处理；木刻印完就释放整页遮罩（1.19 GB） |

**苏联构成主义**

| 问题 | 改法 |
|---|---|
| 网格塔印成网点后是一根实心的点状锥体，看不出格子 | 每节每组杆件从 24 根减到 16 → 8 根（越往上越少），杆件加粗（0.55 m 往上收到约 0.27 m）；远侧半圈的杆件反照率最多 ×6.5，显得浅；雾的距离从 520 m 改到 2600 m（否则全塔被雾冲成均匀的中灰）；塔照片加网前的模糊从 0.3 格降到 0.12 格（`soften=0.12`），塔顶的横担才分得开 |
| 收音机照片认不出：喇叭正对镜头成了一个黑球，电子管是白疙瘩 | 喇叭口轴线与视线约成 60°，侧面看得到外扩的喇叭口和口内暗面；黄铜反照率 0.45、金属度 0.5，底座改黑漆；玻璃管反照率 0.42，加一道内部阳极暗带 |
| 收音机面板像照相机（两个一样大的象牙色刻度盘像镜头） | 改成一个黑色胶木大刻度盘（镍圈 + 白刻线）加两个小旋钮、接线柱、铭牌，机顶加蜂巢线圈，喇叭到机身拉一根软线；照片放大到 1.16 倍，网点格从 6.5 px 改成 5.5 px |
| 编号方块里的数字不见了 | 黑色电波弧压在了标注上，黑上加黑挖不出空。电波只占楔形 ±9° 的范围、到喇叭口为止，标注都放在电波范围外 |
| 电波弧铺满半张纸，像梳子、像肋骨 | 波前只画在楔形附近，从塔尖画到喇叭口；线宽随半径变细（`grow=-0.045`）；上沿只到 +6.5°，别碰到标题 |
| 斜排的标注里，数字跑到方块外面 | 方块和数字都用 `along()` 从同一个左下角算；不要一个绕自身中心转、一个绕角点转 |
| 剪下的照片放在纸色上，剪刀留的白边看不出来 | 让照片压在红块、黑条或楔形上：收音机后面垫一块从黑条升起的大红块，楔形一直伸到喇叭口下面 |
| 红块只从照片缝里露出几条细缝，像渲染错误 | 红块要比照片大一圈（高 410 px），从黑条一直顶到标题下面；剪刀剪不进的窄缝用 `close=` 桥接，被照片围住的洞自动填平（剪刀只能绕着外轮廓剪） |
| 楔形末端的直边在喇叭口旁边露出一个红角 | 楔形只伸到喇叭口再多 20 px，半角 5.6°，宽度和喇叭口差不多，末端整个藏在剪下的照片下面 |
| 折痕太弱，像画上去的一根细线 | 折痕处墨层断断续续地裂开（约 2–3 px 宽），两侧约 ±3 px 的磨损带墨最多淡 22%，再加一亮一暗的折棱和一道污渍带 |
| 图钉孔像一个黑点 | 孔周围加一圈偏向一侧的锈色晕 |
| 红版套印错位后，画面右边缘露出 2 px 纸白 | 错位前先把版用边缘复制 pad 8 px：成品是印完再裁切的，边上不会露白 |
| 填洞后剪下的照片反而整片印满底色网点 | `ImageDraw.floodfill` 对 `Image.fromarray()` 得到的图不起作用（不报错），要先 `.copy()` 再填 |

**装饰艺术**

| 问题 | 改法 |
|---|---|
| 车鼻前下方一圈圈指纹状条纹，法线乱跳 | 「把截面朝一个点缩放」得到的不是合格的距离场（命中点残差 0.19 m）；改成竖直核心线段膨胀 R 的精确截面（直侧壁、圆车顶、底部平切），车鼻只沿轨道方向拉伸（只会低估距离，步进安全），残差降到 0.008 m |
| 车头竖直，像电车 | 核心前缘做成斜线（`rake` 约 2.2 m），车鼻向前下方倾斜 |
| 头灯飘在车头前面；奶油窗带在车鼻上被一刀竖直切断 | 斜车头实际伸出的长度比 nose_len 长得多（垂直斜边膨胀）：用二分法实测车鼻表面，头灯、条纹收拢、车鼻素色端头都以实测车尖为准；条纹在最后 14% 前停下，窗带收成尖头 |
| 车身只有几道细金线，远看是一整块红 | 加奶油色窗带（1.95–3.15 m）和上下金线；腰线在车鼻上按截面坐标向车鼻收拢，成为速度线 |
| 钟和扇形冠顶浮在楼顶上面，戳进标题 | 钟画在顶层楼身上（`top_windows=False` 把这层的窗空出来），冠顶从顶层上沿起；近景楼顶都压在副标题下方 |
| 副标题两侧的金线穿过副标题文字 | 先画副标题拿到宽度，金线从标题两端画到副标题外侧 28 px |
| 头灯是一大团白光，像一只眼睛 | 灯球半径 0.3 m、铬圈 0.47 m，光晕 80 / 10 px，自发光 0.85 |
| 头灯光束指回车身 | 光束终点取 60 m 前方会跑到相机后面、投影翻转；终点改为 min(60, 0.6·Z/dz) |
| 头灯照亮前方铁轨，但画面里看不见 | 护栏 0.56 m 高、相机只比轨面高 1.4 m，桥面被护栏挡住；护栏降到 0.25 m、相机抬到轨面上 2 m；掠射角的朗伯项只有约 0.1，改成包裹式（×5 封顶），铁轨成了从左下引进画面的两道亮线 |
| 喷枪颗粒太粗，光束和射线像撒了沙 | 颗粒 = 固定噪声 × 0.2 × d(1−d)：只在薄涂处有，实涂和空白处没有；射线的颗粒 0.45 |
| 河面倒影是一块块迷彩斑 | 波纹按压缩后的深度坐标取噪声，横向拉长约 90 倍、只用两层：近处长而稀、远处细而密 |
| 月亮倒影太弱，黑天空和月亮反射得一样多 | 镜像按亮度加权（0.45 + 1.3·smoothstep(0.35, 0.85, 亮度)），月亮和窗灯拉出一条光路 |
| 车窗倒影成了高架下面一串孤立亮点 | 范例里关掉（`lights(r, reflect=False)`）；要用就把拉伸调长 |
| 月海是脏兮兮的斑点 | 月海用 smoothstep 柔边、浓度 0.13、颗粒 0.25 |
| 动图里红色车身被量化成棕色色块，天空出色带 | 加权调色板（饱和像素 ×5、亮像素 ×2）+ 每帧同一张 4×4 Bayer（约 ±2.4 级）；量化只用 255 个真实颜色，占位透明色用品红，否则最暗的像素被当成透明（自检 9 帧对不上） |

**黄金时代漫画**

| 问题 | 改法 |
|---|---|
| 羽状排线像一排梳齿、像尺子刻度：等长、等距、完全平行 | 长度跟着两层慢噪声起伏（0.25–1.15 倍），间距 ±30%，每根略弯、偏离平行约 4°；起笔压在阴影边上，越往亮处越短 |
| 羽状排线穿过白色色环上的字，RS-1 被看成 RS-T | 排线的 clip 去掉文字所在的区域 |
| C40 M70 Y100 的棕色（头盔、山体暗面）在 11 px 粗网下花成发绿的斑 | 棕色不用蓝版：M70 Y100 + 黑 40% / 70%（`BROWN` / `DARK_BROWN`） |
| 天空七条等宽色带像一面旗；中间几档两版都挂网，花点太闹，压住人物 | 色带用 `edges=` 指定不等宽；过渡档尽量只挂一个版（蓝 40%、蓝 20%、黄 40%），两版叠网只留在顶部一两档 |
| 月亮光晕的同心色环盖过所有色带，在橙色带里切出一个蓝色圆盘 | 去掉光晕；`rings()` 只用在单一色带里 |
| 顺风飘的围巾正好盖住后座小狗的头，小狗只剩一团白 | 围巾往后上方飘（漫画夸张），小狗后移；先画后座再画前座；狗脸用纯白（不挂网）配黑耳、黑鼻、金色护目镜 |
| 护目镜比脸还大，像第二个头；挡风玻璃像两颗牙、像多出来的尾翼 | 护目镜只露一只镜片推在额头上；去掉挡风玻璃，只留座舱口沿 |
| 座舱里的人画在船体之后，下半身露在船体外面 | 先画人，再画船体：`part` 会擦掉被挡住的墨线和颜色，最后补座舱口沿 |
| 尾喷管是一块挂网灰方盒；火焰外层深橙和橙色天空同色，又被下尾翼和烟挡掉 | 喷管涂黑加银色口沿；火焰由外到内红、深橙、橙、黄、白五层，烟只吞掉火焰末端，下尾翼缩小，去掉横穿舷窗的中间尾翼 |
| 烟团是锯齿星形、挂橙色网，像一堆石头 | 烟团用近圆形加轻微起伏，白底；只在右下月牙挂黑 20%，靠火焰的一侧挂黄 40% |
| 右边台地看不出是悬崖：斜面、羽线、暗面混成一团，暗面花成墨绿 | 平顶加竖直崖壁：崖顶下一道黑影，裂缝从黑影往下用 `feather(along=(0, 1))`；崖脚另起一道碎石坡，换一种颜色 |
| 地平线正好穿过 Sparky 的头；他在画面里太小，故事的笑点看不见 | 地平线下移到胸口；人物放大 1.15 倍，飞走的帽子挪开、别压在手上 |
| 动图超过 2 MB（2.34 MB），网点缩小后成了摩尔纹 | 缩到 720 宽时用 BOX 不用 LANCZOS：1.79 MB，网点仍隐约可见 |
| 内存峰值 1.25 GB | 网点阈值图等缓存改成 float16；印刷按 180 行一带处理；刊名只在自己的裁切区里算；做旧效果只作用在各自区域：峰值约 0.85 GB |

**波普丝网**

| 问题 | 改法 |
|---|---|
| 好几格里多出贯穿整格的黑斜线 | 闭眼弧线的粗细用 `sin(πt) ** 0.7`，末端 sin 是 −1e-16，幂运算得 NaN，多边形就连到了窗口原点。`stroke()` 里已把宽度 `nan_to_num` 并截到 ≥ 0；自己写 `profile` 时先 `clip(sin, 0, 1)` |
| 底色上一道道白色横纹，像划痕 | 底色 `dry=0`，`streak` 约 0.012；笔触纹拉长（长约 140 px、宽约 7 px）；干笔拖痕只出现在形状边缘一圈 |
| 缺墨时黑块里露出规整的方格编织纹，像数码图案 | 布纹对墨膜的影响降到 0.035；露底主要来自顺刮板方向的条纹、约 5 px 的团块噪声和一块干版斑 |
| 闭眼的 ∩ 太细，下面又垫一块椭圆眼影，读成「眉毛 + 睁着的眼」 | 闭眼弧线宽约 0.10 单位，两端收细；开心那格不垫眼影，改用腮红；困那格的眼影做成闭合的眼皮形状，只在闭眼线上方 |
| density 0.84 的缺墨格，脸几乎印不出来 | 0.92–0.95 是「缺墨但认得出」，1.0 正常，1.1–1.15 墨多；flood 超过约 0.5 会糊掉半张脸 |
| 墨多那格，远侧耳朵糊成一顶黑礼帽；耳朵压平后，耳背描边和头顶虎斑纹交叉成一个 X | 耳朵外转超过 40° 时，耳窝只印网点、只描上沿；被耳朵挡住的那道头顶虎斑纹不印 |
| 远侧耳朵的阴影和耳背描边分成两块：描边像一根飘着的棍子，耳毛像羽毛球 | 远侧整只耳朵做成一块暗面，一直到外缘；耳毛 4 根，宽约 0.026 单位 |
| 吐舌头只是嘴下面一团红点 | 舌头色块伸出嘴外（下沿到约 0.74 单位）；黑版给舌尖描 U 形轮廓和一道中线 |
| 每格边缘一圈浅色细线，像内描边 | 漆脊的 relief 从 0.9 降到 0.35 |
| 左肩上的长弧形虎斑纹像几道「翅膀」 | 受光一侧的胸前斑纹不印实线，只印成网点带（tone 约 0.38） |
| 峰值内存 1.08 GB | 脚本把 60 多张整窗遮罩放进列表再 `np.stack`；`canvas()` 和合成时又整幅算临时数组。改成用 `np.maximum` 就地累积遮罩，颜色层按格现算，布纹和合成按 180 行一带计算，降到约 0.46 GB（改遮罩累积这一步前后，成品逐字节相同） |
| 动图里黑网点和六套配色的混合色量化错（p99 误差 100） | 调色板样本里，已上黑版的后半关键帧 ×3，再用 `kmeans=4` 精修：p99 降到 39，误差大于 70 的像素从 3.7% 降到 0.03%，体积不变 |

**ASCII 字符画（行式打印机）**

| 问题 | 改法 |
|---|---|
| 箭身和烟用 I H M N 之类字母铺调子，远看像一行行单词「IMM」「HNM」 | 填色字符只用符号：箭身 `. : + % # #@`，烟 `. : % @ # #@`；字母只留给真正的文字 |
| 按形状相关度给线条挑字，桁架塔变成一串 `<> <>`、`^V` | 改成按方向和位置选：方向在真实像素里量（格子是瘦高的），陡的 \| / \\，平的按在格里的高低选 `' - . _`，两条线交叉才用 X / + |
| 斜线、竖线同时压到左右两格，到处是 `//`、`\\`、`)\|` | 同一条线、同一方向的相邻两格只留笔画更多的那格（非极大值抑制；斜线还要求字符相同，免得吃掉尖顶的 /\\） |
| 桁架斜撑交点落在四格交角，中间成了 `\_/`、`/-\`，没有 X | 斜撑按「一列一行」走、过格心：塔宽取 6 列（中间 5 格），交点正好落在格心出 X；横撑放在行中心，压在行界上会被两行平分、谁也不到阈值 |
| 箭身和黑色滚转标记、尾焰之间也描出一圈轮廓，箭身里横七竖八的 \| 和 ---- | 角色分组（`group='rocket'`）：同组之间不描边，只有对外的剪影描边 |
| 烟云每个云团都描边、调子又加误差扩散，底下一片乱码 | 云团用 `edge='all'` 但 `inner_max=0.5`：只在亮的云顶画 ( ) 和 .-'，暗部只靠调子；光从上方来、云底再加一层自身阴影（`lift`），抖动降到 0.2；云团改成少而大（半径 5.5–10 列） |
| 字太干净，像激光打印或屏幕截图 | 字模先按墨的洇开模糊约 0.5 px，再和色带织纹、纸面齿纹一起过阈值：力度够就满铺，力度弱就变细、断开、起麻点，而不是变灰；改用粗体字模 |
| 火焰内部加了一根根 ' ! 的条纹，像引号和珠串；内焰锥画成一串 () | 尾焰从箭身底部直接长出来、和箭身同组，不用随机抖动 |
| 尾焰只剩两条 ( ) 竖线围出的空白，读不出是在点火 | 尾焰做成从喷口往下变宽的亮柱：外层 `plume` 角色按离轴距离 u 从 . 过渡到 % @ # 的烟套（u>0.45 起变暗），内层 `core` 角色是几道从喷口散开、沿长度明暗闪动的条纹（! \| 在喷口、往下变成 : . '），两层都不加随机抖动才对称 |
| 下面两团前排烟云从两侧压住亮柱，形成往下收窄的漏斗，看着像火焰变细 | 前排烟团外移（离轴 13.5 列），亮柱两侧各放一个小烟团接住烟套，中间那团的云顶 ____ 正好接住柱底 |
| 头锥用平滑闭合曲线，肩部鼓出一块，又一版太钝像圆顶 | 头锥按弹头曲线 半宽 = R·(2s − s²) 逐点算多边形，不用样条 |
| 左边天空加一层随机点「晨雾」，像纸上的脏点，还在第 94 列切出一条竖边 | 去掉；空的天空留白，右侧大空位放一座远处水塔平衡构图 |
| 表头「RUN … PAGE」和参考图的格式太像 | 换成 JOB 4471 / SHEET 2 这类自编字段 |
| 最底下一行烟云被画面下边切掉半行字 | 改用 8½ 英寸深的连续纸（`page_in=8.5`，51 行一页），`ppi` 调小让整张纸连同上下两道撕线都在画面里，左右露出桌面；画面在 `page_rows − 2` 行 `erase` 掉，留两行页边再到撕线；横向撕线和折痕加深 |
| 太阳只是一圈线加几根离得很远的光芒，鸟东一只西一只，像随手的符号 | 太阳盘面用 . : 填出边缘发暗（中间 .、边上 :），光芒贴着盘面、8 根等长；鸟排成一队人字形往太阳方向飞 |
| 动图里红圆珠笔被量化成灰色 | 红色像素太少，加权也抢不到颜色：调色板单独给红色留 14 格 |
| 峰值内存约 1 GB | 纸张按通道就地合成、成图分 480 行一带合成，降到约 0.7 GB |

**低多边形**

| 问题 | 改法 |
|---|---|
| 悬崖上满是竖向的绿条纹，平台上反而是横向岩层 | 材质错位一格：每个面的材质取剖面里靠内侧的那个点（两端下标取小的），悬崖才贴岩层、平台才贴灌丛 |
| 河床三角形一块块从水面里戳出来 | 画家排序按平均深度，埋在水下的河床有时算得比水面「更近」：完全在水下的面干脆不生成（`canyon(buried=)`），水面带 −2 的排序偏置，像贴花一样后画 |
| 水面一片发白的青色 | 涟漪短划减到 16 条、颜色压暗，水面 spec 0.35；逆光看水本来就亮，别再加 |
| 构图照搬参考图：飞机在正下方、大环正居中、后面的环一个个叠在环里 | 赛道改成右转弯，相机放到飞机右后方，用 `aim()` 把飞机放到左下三分点，金环沿对角线往右上排开 |
| 外弯的岩壁把天空整个挡住，太阳和光晕都没了 | 峡谷整体压低（`height=0.75`），相机降到飞机上方约 2.6 m，视场 52°，留出约两成天空 |
| 从正后方追尾看，飞机只剩一个「十」字，还被画面底边切掉 | 相机放在右后上方，能看到机翼上表面；飞机离镜头约 11 m |
| 一级台阶和相机差不多高，被看成一道发亮的裂缝 | 相机高度避开台阶高度（台阶约 11.8 / 20 m，相机约 16.6 m） |
| 金环又细又发橄榄色，看不出多面体 | 管径 0.6（半径 3.4）、12×5 个面、暖金 #ffaa1a、glow 0.28、spec 2.0、shine 4：暗面偏橙、亮面发黄、迎光的面闪白 |
| 逆光下飞机和金环发灰发闷 | 着色光和画里的太阳分开设：`light(lift=26)` 把着色光抬高 26°（当年的游戏也这么做） |
| 光晕里的空心圆像多出来的金环，正中的绿色六边形像一块石头 | 光晕只用小圆点和实心六边形；画面中心附近只放 2 px 的小点，大六边形放到远端并调淡 |
| 「"」加粗后两撇连成一道横线，「1'07"42」读成「1'07-42」 | 两撇之间空两列（`'#  #'`）；零不加斜杠，斜体时才不像 8 |
| 螺旋桨盘几乎看不见，像一块灰斑 | 半透明盘 alpha 0.36，再加一圈更亮的桨尖圆环 |
| 杜松在逆光里成了黑剪影 | 树带 glow 0.3，叶色提亮 |
| 动图 2.08 MB，金色 HUD 偏棕 | 缩小用 BOX 而不是 LANCZOS（像素硬边不出振铃噪点），调色板样本里饱和像素 ×5：1.63 MB |

**喷漆模板涂鸦**

| 问题 | 改法 |
|---|---|
| 每张模板四周都有一圈带麻点的大方框（风筝、燕子、字周围最明显），一开始还是贴着卡纸边的几条细直线 | 喷的区域按 2.5 倍喷幅往外扩，卡纸外的漆才落得到墙上；扫过卡纸边的「卡纸残影」系数降到 0.0035；扫到头折返时只减速到 0.55，不再在边上积一大团 |
| 所有边缘都是 6–8 像素的毛刺，像发霉，清晰核心没了 | 卡纸翘起量不再按「离胶带越远越高」涨到 1：平贴为主（0.15 + 0.35 × 离胶带距离 + 0.5 × 局部鼓起）；底下渗漆只用 1.8 像素模糊、权重 0.2 + 0.5 × 翘起量；外溢雾化 7 / 24 像素两层，强度 0.022 / 0.012 |
| 滴痕到处都是：白漆滴痕从围巾一路流过外套和裤子，每座桥上面都往下滴 | 只从真正的下边缘起滴（往下 7 和 12 像素都是空的，桥不算）；数量按 amount × min(26, 2 + 过量/40) 封顶，白版 0.06、灰版 0.2、黑版 0.7；滴痕的凸起降到 0.45 + 0.25 × 宽度/3，否则被后面几版盖住了还以白色棱线透出来 |
| 三版叠起来灰糊糊：灰版跟黑版几乎一样深，白版喷不匀一片麻点，黑版只剩细边 | 灰改 #7b7c79；白漆遮盖力 2.0、喷 3 层；黑版阴影加深（躯干 34、腿 18 / 44 像素），`shade_side(wobble=)` 让阴影边像手刻的 |
| 燕子像喷气式飞机 | 弯月形后掠翅（一上一下）、细身子、长长的分叉尾 |
| 围巾先像面条，再像「VAV」字母，最后像一只举起来带手指的条纹胳膊 | 从脖子前一个结里分出两条长短不一的窄尾巴，往前稍往上飘；只画横条纹，尾巴上不加阴影月牙；流苏扇形散开、互不相碰（碰上了会围出孤岛被桥切成方框） |
| 帽檐压住眼睛，下巴下的黑阴影像小胡子 | 帽檐整体上移 6 个单位，眼睛放大、鼻头往前凸、嘴是轮廓上的一个缺口；下巴阴影改进灰版、变细 |
| 小孩像在往前走，躯干像一只蛋 | 上半身绕髋部再后仰 9°，前腿伸直、脚跟着地脚尖翘起，后腿弯着撑住；羽绒服缩短到胯部、收窄 |
| 黑版快照里卡纸整张喷成黑的，看不出刻了什么 | 卡纸上的漆按「粉尘」画（0.82 × (1 − e^−0.55D)，透出牛皮纸），切口边按卡纸厚度一侧亮一侧暗 |
| 墙像木板墙，木纹太清楚；裂缝像画上去的黑线；泛碱像一条白色虚线 | 木纹起伏减半，只在一块块区域里压出来；加水泥色斑和浮浆；裂缝变细变淡；泛碱用噪声断开 |
| 市政灰漆像一块模糊的圆角方块 | 改成一道道竖着的滚筒：每道起止高度不同（上下边缘成台阶）、两头发干拉丝、相邻两道重叠处颜色深一点，底下的旧签名透一点出来 |
| 动图里红风筝变成砖红色、粉色签名没了 | 调色板样本加权：红 ×12、其他饱和色 ×5、黑 ×3，再叠同一张 4×4 Bayer（约 ±2.4 级）；透明占位色用品红，不用黑 |

**刺绣徽章**

| 问题 | 改法 |
|---|---|
| 牛仔布像印出来的 45° 斜条纹，白纬又亮又粗 | 经纱比纬纱密（1.5 × 2.5 px），斜纹约 60°；纬纱只露一小点、每点露多少随机；经纱加竹节纱的染色起伏和磨白；2× 渲染再缩小 |
| 缎面边框像条形码，黑白条太硬 | 缎面线截面压扁（起伏 ×0.6），线与线之间的暗沟只降到 0.74 |
| 填充绣满片像砖墙 | 针孔凹陷只暗 30%；每行起针位置加 ±6% 的漂移 |
| 缎面平平的，看不出「线的光泽渐变」 | 缎面长线按衬垫拱起（拱高约 0.11 × 线长，最多 3.2 px），一根线上就有从亮到暗的过渡 |
| 深色线被高光冲淡，指南针每个尖角的明暗两半分不出来 | 高光整体 ×0.62；亮半边别用太亮的颜色（亮红 #cf4637 / 暗红 #721a14） |
| 雪峰亮面太白，雪顶糊进山里 | 山的亮面用中灰蓝，白只留给缎面雪顶；阴面明显更暗 |
| 火焰用竖向缎面，长线被拆成交错短针，看着像填充绣 | 针向横着走（约 ±15°），maxlen 放到 90；外焰、中焰、内焰一层压一层 |
| 湖面波纹穿过帐篷，还伸出徽章压到边框和牛仔布上 | 细节针按层次排在压在它上面的东西之前画；`run(clip=徽章遮罩)`，路径留在边框以内 |
| 异形章圆角的缎面边框出现放射状摩尔纹 | 按相位梯度算每处针距，小于约 2 px 时把单根线的起伏淡掉；圆角半径至少是边框宽度的两倍（34 px 对 17 px） |
| 锁边上周期性的暗条和小黑点，底下的颜色从里面透出来 | 两个原因：2.6 px 的绕线和像素网格拍频，改成按 (s, d) 4 次子采样再平均；PIL 粗折线画的带状区域有针眼大的洞，再做一次 5×5 最大值滤波 |
| 弧形条章的字挤到两头的锁边上 | 字号 42、跨角 98°，字间距 0.05 倍字号 |
| 整组徽章太小，画面上方三成空着 | 设计坐标统一乘 1.14 再上移；针单独按画布坐标摆，别跟着放大推出画面 |
| 动图里金色锁边和营火被量化成橙褐色 | 调色板样本里暖色饱和像素 ×5、亮色 ×2（暖色平均误差 9.5 → 5.6） |

**蓝图工程图**

| 问题 | 改法 |
|---|---|
| 细字和细线在大片区域里糊掉，像对不上焦，备注、标题栏、引出文字整段看不清 | `core.blur` 会把亚像素 sigma 量化成 0 或约 1.4 像素，「压框接触不良」的区域整片被糊了 1.4 像素：改用库里自带的真高斯 `_gauss`，接触好 0.55、接触差 0.9；单笔画字的笔宽至少 1 像素 |
| 「断墨」噪声被做成一大片，一行字的后半截淡掉 | 只在 3 像素尺度细噪声的 0.84–0.96 峰值上断墨，再乘一个 90 像素尺度的门控；断墨只减 45% 墨量 |
| 小数点不见了：17.90 印成 1790 | 句点是 0.08 个单位长的线段，圆头只剩 1 像素：短于 0.2 单位的笔画一律画成实心圆点 |
| 标题栏里的仿宋中文印不出来；加粗后又糊成一团 | 仿宋笔画太细，晒图的 S 曲线把它当成浅铅笔线：先压窄（0.82），再 3×3 最大值滤波、灰度 ×1.35 实化；别用 5×5，会糊 |
| 剖面里的螺旋楼梯像一层层楼板 | 被剖到的踏步是一条条实心白条，远半边只有 fine 线：远半边的踏步前沿、贴墙的踏面—踢面锯齿改用 thin，加一条贴墙的螺旋底面线；被剖到的踏步只留 0.13 m 厚 |
| 剖面墙上的窗洞像裂缝或墙体错位 | 窗洞改成内大外小的八字口（外口 ±0.38 m、内口 ±0.55 m），窗扇退进墙面 0.25 m，画一粗一细两道 |
| 尺寸数字压在剖面线上读不出来 | `dim()` 默认 `clear=True`：写数字前先把它后面的剖面线刮掉——制图员本来就这么做 |
| 比例尺刻度乱了，有一截白条跑到别处 | 把「每格像素」当成了「每单位像素」：接口改成 `scale_bar(x, y, px_per_unit, units)`，刻度用真实数值 |
| 透镜详图里的棱镜像一串叠在一起的飞刀和箭头 | 棱镜画太大了（进光面很长）：光路缩短到 L1 0.1 m、L2 0.03 m，棱镜里加 30° 的细剖面线表示玻璃 |
| 详图里的灯室檐口和窗台画成两块大白方块，还盖住了说明文字；穹顶弧线一直伸到图框 | 改成细线框加金属交叉剖面线；穹顶只画起拱的一小段，下面用折断线截断；光束说明挪到详图上方 |
| 平面图的 UP 箭头画成了整整一圈，看不出是箭头，跟铅笔辅助圆混在一起 | 只画约 205° 的弧，起点一个圆点、终点箭头，UP 写在起点；去掉同心的铅笔圆 |
| A–A 剖切符号撞上剖面右侧的引出文字；低处标高（±0.00、−1.80）压在岩石和海浪线上 | 剖切线缩到墙外 0.56 m，两张图整体左移、引出文字列从 806 起；低处两个标高挪到剖面右边，海浪线在标高前截断 |
| 水渍像一块灰色圆饼 | 按「水洇开再分两次干」建模：两道干燥前沿各留一条清晰的褐色潮线，里面只淡化约三成、带斑驳 |
| 折痕交叉点像一颗亮星 | 交叉处磨损半径 7 像素、只淡化 38%，折痕磨白只混 0.2 |
| 动图里红铅笔变成灰蓝色 | 调色板先对全部关键帧中值切分 238 色，再从红铅笔像素里单独切 17 色补上（`claude_drawing/blueprint_work/make_gif_bp.py`） |

**儿童蜡笔画**

| 问题 | 改法 |
|---|---|
| 第一版色块像一层均匀的砂纸，看不出来回涂的笔道，和彩铅、喷砂分不开 | 纸纹先沿笔道方向拖着平均一遍（双线性取样 ±6 px，与原纸纹 0.35 : 0.65 混合）再重新均衡，露白的小坑被拉成顺着笔道的短条；笔道间距 = 笔宽 × (2.3 − 1.6 × density)，每道压力 = pressure × (0.84 + 0.36 × 慢噪声)；纸纹改细（1.7 / 3.8 / 14 px 三层） |
| 蜡块像橡皮泥浮雕，空白纸像拉毛墙 | 打光时蜡的高度 1.35 → 0.55（再模糊 1.6），纸纹浮雕 1.1 → 0.65 |
| 山坡线从人脸、裙子上横穿过去 | `line(..., avoid=c.grow(OBJ, 10))`：线走到东西背后就停；所有东西的内部遮罩先收进 OBJ |
| 后画的郁金香、蝴蝶、签名压在草地上，红 + 绿发褐、紫字看不清 | 蜡笔是半透明的乘性混色，盖不住底色：东西先勾线，大片（天空、山坡、草地）`avoid=U(OBJ, c.drawn())` 绕着涂（孩子本来就是这么涂的），最后在白纸上给东西上色 |
| 胳膊、手、狗腿、花茎被草地涂没 | avoid 里加上 `drawn()`（已经画过的线）；狗腿在身体上完色后再用 17 px 重压一遍，脚加一个圆点 |
| 天空绕着标题涂，蓝笔道还是扫进字里（红字发紫、橙字发绿） | 绕开处的转折要「小心」：停在边界内 0.45 × 笔宽、不过冲；被绕开的东西覆盖率 × (1 − 0.9 × 遮罩)；比 0.7 × 笔宽窄的空隙不进笔 |
| 标题像粗黑体，「我」糊成一团、右半边丢了 | 细字体字形先 Zhang–Suen 细化成单像素中心线，再用圆头蜡笔膨胀（默认字号 × 0.068，标题指定 11.5 px）；手抖扰动 0.045 × 字号、尺度 0.55 × 字号；字距按字形实际宽度算（西文才不会散开） |
| 签名夹在郁金香的茎叶之间看不清 | 挪到花下面的空处，草地给名字留一圈 18 px 的空白（`c.grow(名字的蜡, 18)`） |
| 纸上的蜡笔：包装纸像理发店转灯 / 条形码，蜡像塑料，第三根竖着像立在纸上 | 包装纸：两头各两道细线 + 一段波浪纹 + 中间浅色标签上一行伪文字（无商标）；蜡改哑光（高光指数 12、强度 0.13），断面略亮；半径 22 px（直径约 7 mm，接近真蜡笔放在 1920 px 宽的 A4 上的比例），只放两根：一根用秃的、一根撕了半截纸的断蜡笔 |
| 蝴蝶翅膀圈涂太满，糊成两团还压住身子 | 翅膀离身体 7 px、改来回涂、加黄点；身子和带圆头的触角最后画 |
| 墨镜只是一块灰黑，看不出是玻璃 | `burnish()` 把黑蜡压进纸坑：白点合上、和下面的黄混成深橄榄、带一点蜡光；皮球同样处理 |
| 烟囱的烟是等半径螺旋，像一根弹簧 | 圈越往上越大（9 → 33 px）、往右上飘，灰色轻压 |
| 动图最后一帧 EOFError | 最后一个 `stage()` 和成品相同会被合并：`save()` 前不再调 `stage()`（第四节已有这条） |
| 动图里小面积的紫、粉发灰 | 调色板样本加权：饱和像素 ×5、亮色 ×2（1.47 → 1.33 MB，0 帧对不上） |

**绿屏终端 CRT（荧光字符画）**

| 问题 | 改法 |
|---|---|
| 桶形畸变用的是归一化坐标里的交叉项（u·v²）；宽屏下，角上的字被剪切成斜体 | 改成真实像素里的径向畸变 src = p·(1 + k·\|p\|²/hw²)，k = 0.065；字不再歪，四边照样外鼓 |
| 反白的 YES 和状态栏里的黑字看不清：点拉伸和视频带宽把 1 个点宽的暗笔画吃掉了 | 点拉伸改在半点分辨率上做，而且放在反白之前；状态栏改用 `dim+rev` |
| 云的内部用 - = + 这类像线的字，远看是一团 `/=-\` 乱码 | 云用 `outline='cloud'`：斜坡一律打 ( )，平顶、平底打 _ . - '。内部只用 . :，亮部靠 dim → normal → bold 提亮，不换更花的字 |
| 剪影成对出现 `//`、`((`，两个格子都当了边 | 剪影只留一格厚：相邻两格是同一个字时，留覆盖率最接近 0.5 的那格，另一格按覆盖率归入里面或外面 |
| 云底是一排扇贝 `(...)(....)` | `puffs(base=整数行)`：底部 `flat` 行内按云的宽度补满，并闭合泡泡之间的小缝；整条云底打成一根 `_` |
| 细线勾的月牙在 5×7 字里像 S 或 < | 月牙不描边，用 bold 的 % # @ 填满（`outline=None`）。内圆半径约等于外圆，向右偏约 0.45r |
| 太阳像六角蜂箱，往下的光芒像腿 | 太阳用 `cloud` 轮廓加径向渐变 . : + * % # @；光芒只画地平线以上那 9 根 |
| 瘦高格子里拿覆盖重心的方向当法线，斜边的字选偏 | 法线按格子尺寸反比换算：nx = −mx/cw，ny = −my/ch |
| 光晕把整屏蒙成灰绿，失去黑底 | 中、远两层光晕只对 L² 做（bold 发光，dim 不发光）；亮度底（brightness）降到 0.016 |
| 房子比天气还抢眼；光标块贴着反白的 YES，连成一个框 | 墙和屋顶改 dim，只有夜里的窗户用 bold #；提示符后面打了半条命令 `forecast --tomorrow`，光标停在命令末尾 |
| 动图里挡圈边上振铃出一圈亮边，暗玻璃和窗户倒影出色带 | 缩到 720 宽用 BOX，量化前每帧叠同一张 4×4 Bayer（约 ±2.4），调色板样本里绿色像素 ×4、亮像素 ×2 |
| 峰值内存 834 MB | 拨轮、LED、压纹图标改在局部窗口里算；机壳斜面朝向屏幕的程度缓存起来；不再每次渲染都建整幅 int64 网格。降到约 0.73 GB |

**热成像**

| 问题 | 改法 |
|---|---|
| 地面被底部色标栏挡住，猫只露半身，脚印看不见 | 相机再往下俯（灭点 y 150 → 100，焦距 1900 → 1750），地面留出约 200 px；底栏压到 78 px |
| 自动直方图均衡把 20–24 °C 的房间拉成一大片品红，猫和墙同色 | 改用手调色调曲线 `camera(curve=)`：冰箱内 0–0.05、房间 0.23–0.29、脚印 0.35–0.5、猫 0.6–0.72、锅 0.9、只有火圈到白；直方图均衡只混 0.22，留一点局部对比 |
| 锅和水壶饱和成两个白块，锅像个大马克杯 | 曲线把 100 °C 放在 0.91；锅改宽矮，加卷边和两侧环形把手；抛光锅盖 `emissivity=0.55`，读数比锅身低一档，盖子自己显出来；锅身、壶身、面包加 `limb=`，轮廓处变凉、有体积 |
| 烤箱门是画面正中一块巨大的橙色长方形，抢焦点，还和猫同色 | 烤箱降温（门框 23–26.5 °C、玻璃 26.5–31.5 °C，只有顶部门封 46 °C）；把手上搭一条湿抹布（17.5–20 °C，蒸发降温），把大块面打断 |
| 灶后墙面的热晕像一根发光的柱子一直通到画面顶 | `soak` 只取锅后到油烟机下沿这一块，reach 38、strength 0.4，`onto` 限在油烟机下沿以下、挖掉锅壶罩 |
| 冰箱冷坑在地上看不出来：8–18 °C 都挤在色板最暗的一段 | 铁红色板低端提亮（0.14 → #1f0e6e，0.24 → #3d1192），曲线给 2–19 °C 留出 0–0.23；冷坑芯部降到 6.5 °C |
| 冷坑用噪声阈值做边，成了一片迷彩斑块 | `pool()` 改成从源头分出的几条软冷舌：按地面透视压扁、沿舌头衰减、再模糊 |
| 冰箱里一片死黑，格板和瓶子都看不见 | 格板前沿画成 10.5 °C 的细亮线，瓶罐比内壁高 6–8 °C；冷冻抽屉面板改回接近室温（它有保温层），顺着它往下淌的冷气才显得出来 |
| 冰箱侧板压到下柜前面，多出一条斜边 | 侧板只画台面以上那段和下柜前沿以内的 10 cm |
| 冰箱底的压缩机格栅是一道粉色横杠，挨着黑色冷坑像故障 | 删掉 |
| 猫像一块平涂剪影；Sp3 十字盖住了眼睛 | 加 `limb=`（掠射角发射率下降、毛尖更凉），胸口薄毛加 1.4 °C，后腿折线压暗；眼睛 38.6 °C 并把曲线 35–39 °C 段拉陡；Sp3 挪到胸口 |
| 后腿椭圆的轮廓变凉一圈，看着像一盘蚊香 | 后腿的 limb 降到 1.2 °C |
| 线剖面插图的曲线是暗紫色画在暗底上 | 曲线画成白线加黑描边，下面另画一条按色板着色的色带 |
| L1 虚线压在脚印上 | 虚线改成 1 px |
| 动图里蒸汽和墙面热晕出一圈圈色带，OSD 白字被量化成淡黄 | 调色板取样时饱和色 ×5、亮色 ×2，每帧叠同一张 4×4 Bayer（约 ±2.4 级）；强制留出纯白、纯黑、REC 红、最冷标记蓝和两级灰 6 个色位 |

**代尔夫特蓝瓷砖**

| 问题 | 改法 |
|---|---|
| 钴蓝像荧光宝蓝，一看就是屏幕色 | 按 Beer–Lambert 逐通道吸收算颜色，k = (2.3, 1.95, 0.95)：淡染是灰蓝，浓线是紫藏青（`COBALT_K`） |
| 窗户倒影是一团闪烁的白碎点、边缘起毛，看不出是窗户 | 去掉小尺度橘皮纹，釉面起伏只留约 46 px、幅度 ±0.15 px 的缓波，再加每块砖的鼓起（±0.3 px）和倾斜；窗棂宽度要大于高光柔化宽度（soft 3.5），否则窗格糊成一片白 |
| 高度场求导把 x、y 写反，倒角打光和倒影按错的轴偏移 | `np.gradient` 返回的是 (d/dy, d/dx)，要写 `hy, hx = np.gradient(h)` |
| 开片满墙都是，像碎冰 | 每块砖的开片量取 Beta(1, 2.6)，线只压暗 13%，多数砖几乎看不见 |
| 一条裂纹穿过好几块砖，像钢笔线 | 裂纹按砖编号裁剪，只在一块砖里、到砖缝就停；只压暗 50% |
| 砖缝 5 px 太宽，整面墙像浮雕网格 | 砖缝 3.6 px（13 cm 砖约 3–4 mm），倒角 3.4 px、高 1.3 px |
| 云是一块扁长方形 | 云是一串圆凸起的上包络：左高右低（风从左来），每个凸起单独一笔、凸起之间留尖角；底线断成两三截，晕染从底边往上变淡 |
| 树冠像一串气球、花椰菜 | 只描外轮廓的扇贝边；里面在背光一侧画两圈缩小的扇贝短弧；第二遍晕染用渐变，不要每团一个月牙 |
| 船上的面粉袋像一排舷窗；披水板像挂着的布袋 | 袋子坐在甲板上、只描上半圈和扎口；披水板画成上窄下宽的扇形木板，先画并 `occlude`，船身排线不穿过它 |
| 远处的树林像一排鸡蛋；烟像电线 | `bushes()`：地平线上一簇簇小扇贝丘配淡晕染；烟是一串越来越大、越来越淡的卷 |
| 人像穿裙子的小孩，狗像腊肠 | 人：头发和发梢往前飘、张嘴、翻袖口、马裤、长袜、带扣鞋，上身前倾、后脚踢起；狗：四脚离地的飞扑，耳朵和尾巴往后飘，背上一块深色斑，不排线（排线像斑马纹） |
| 晾的衣服垂着不动，看不出有风 | 床单、衬衫的下摆几乎水平地往右扬，挪到近岸空地上，不要藏在树后 |
| 窗户倒影放在右侧单块砖上，是几块纯白、边缘锐利的碎片，远看像砖掉了或渲染出错 | 倒影改成按「滤色」叠在釉面上（`img + (白 − img) × s`，s 最大约 0.65），最亮处底下的蓝线仍透出来；柔化宽度 6、窗格缩小到 112 × 150；挪到画面里右上那朵云和天空上，跨两三块砖，在砖缝处断开错位，一眼看出是釉面反光 |
| 崩瓷是几个橙色小点，像锈斑 | 半径 5–11 px，露出灰褐坯体（`BODY`），靠光一侧被釉边投影、背光一侧的坑壁亮 |
| 动图 3.4 MB | 调色板样本里蓝色像素 ×3；和屏上已显示颜色相差 ≤ 10/255 的像素记透明 → 1.7 MB |

**洞穴壁画（赭石颜料）**

| 问题 | 改法 |
|---|---|
| 颜料发灰，像褪色的水彩 | 喷涂内部只剩一半覆盖（rim 0.35 × 斑驳 × 0.32 的烟）：主色 density 0.95–0.97、rim ≤ 0.2，空气里的烟降到 0.16，指数色调曲线之后再加对比度 1.18、饱和度 1.18 |
| 岩面像绗缝被、一团团棉花云 | 溶蚀扇贝纹单元 70 px、深 6 px 太规整：放大到 110 px、深 1.8 px、只在一片片区域出现；大起伏用光滑噪声会像云和烟，叠一层脊状噪声 (1−\|2n−1\|)² × 10 px 做岩脊（3 次方、振幅 22 会变成一块块台地） |
| 岩面像砂纸 / 揉皱的纸 | 低角度火光会把逐像素颗粒放大：高度颗粒从 0.55 降到 0.12，40 px 中尺度起伏只给 1.1 px，albedo 颗粒 0.022 |
| 满墙小黑点像波点，改浅后又成了白色亮点 | 小溶蚀坑减到 60 个、深度 0.3 × 半径，坑里 albedo 压暗 30%（积了泥），掠射光下就不会只剩亮边 |
| 墙上一团团「脏影子」 | 是油灯的掠射光把 80 px 的大起伏拉出长影：大起伏降到 46 px，油灯不算投影、只有篝火算，投影最多压暗 70%、soft 5 px |
| 鼓包在火堆对面投下黑团，像污渍 | 小鼓包（18 px）在掠射光下只剩投影：只给要画动物的地方放鼓包、高 26–38 px，而且让动物盖住它的背光面 |
| 折痕末端多出一道刮痕 | 有符号距离在折线末端沿最后一段的延长线翻号：按弧长在两端 220 px 内淡出 |
| 手印喷绘像红色描边的椭圆、甜甜圈 | 用「整只手模糊一次」做喷雾，细手指周围几乎没有颜料、外沿一刀切：改成 11 口气，每口一个高斯团、瞄准指尖和手侧（2/3 瞄上半部），叠加后 1 − exp(−1.8·c)，边缘自然淡出，外围撒雾点；前臂只挡一半 |
| 手印被烟熏成灰手套 | 烟熏 0.22、烟柱窄（spread 0.22），手印 density 0.95、spread 26 |
| 后半身两团黑大腿 | 腿的笔画从髋部 0.13 个身长宽起笔，涂黑时把整条大腿涂了：`legs` 部件 = 腿 × (1 − 身体)，只剩身体轮廓以下的部分 |
| 野牛头和隆肉糊成一大团黑，看不出脸 | 隆肉吹黑，头用深红 0.62；眼睛先点一个浅色杏仁（kaolin）再点黑瞳 |
| 野牛像长方箱子配桌腿 | 重画轮廓：前高后低的背线、肩上高耸的隆肉、深胸和须、腹线往后收、小屁股、短细腿 |
| 马鬃和脖子之间漏一条白缝；区域（头、腹）漏到腿上 | 鬃毛笔画压在颈脊线上；各区域只和 `body` 求交，不和整个剪影求交 |
| 鹿角像一把小梳子 | 鹿角放大、主干向后扫，5 个分叉，宽 0.04 → 0.012 个身长 |
| 裂缝像吊着的细绳、像小树枝（让上面那匹马像挂在绳上） | 改成细的之字形窄缝：两端收尖、宽度随机、深 4 px、最多一条短分叉；别从动物身上穿过 |
| 篝火是一团白光 | 火焰发光降一半，每条火舌按 2× 超采样画、只糊 1.3 px，15 条，外橙内黄，中心光斑 0.55；篝火功率 1.6、衰减距离 1150 |
| 火堆石头像骨头两头的圆钮、柴像哑铃 | 16 块小石头（11 点不规则轮廓、深色、圆顶幂 0.85）排在火堆两侧和后面；柴从火心朝观者方向辐射，按圆柱打光（顶部被火照亮）加发光裂纹 |
| 研磨好的颜料堆像平的色块 | 堆高 1.3 × 半径、颜色边缘放软，低角度火光才照得出一面亮一面暗 |
| 掉色的小片像彩色纸屑、像白灰尘 | 12 点圆滑小片、1.5–4 px、只掉在覆盖 > 0.6 的地方、28 片；露出的石面 × 0.93，不加高差（否则掠射光给每片一圈亮边） |
| 炭条起稿在动图里看不见 | 起稿线是一条约 2.6 px 宽的带（先按线宽糊一下再取 0.12–0.88 的等值带），强度 0.7，画两遍 |
| 炭笔轮廓像一串珠子 | 覆盖 = 线带 × (0.5 + 0.5 × 抓附)，不要全靠岩面「牙口」 |
| 野牛尾巴尖像棒棒糖、火星像雨丝 | 尾尖改成一笔短而粗的黑色笔触；火星减到 11 颗、2–6 px、只在火舌上方 |

**1-bit 早期画图软件**

| 问题 | 改法 |
|---|---|
| 写一行 Shadow 样式的字，整张画被擦成白的 | `Image.fromarray()` 出来的图是只读的，`ImageDraw.floodfill` 在只读图上静默不做事，找字腔的泛填就把整张画都当成了字腔；先 `.copy()` 再填（油漆桶 `bucket` 用的是同一个泛填） |
| 蝴蝶放在格子布窗帘和云前面完全看不见；套索的行军蚁把背后的窗帘图案也框进去，一团乱 | 小东西放到最空的底上（天空的白带）；蝴蝶改成白翅膀 + 黑翅尖 + 黑点，1-bit 里白底黑边最好认；成品的选区用矩形选框，套索只在纯白底上用，或把物体自己的遮罩传给 `select(lasso=)` |
| 窗台下的喷枪阴影像一条脏草地，花盆脚边和云底的喷点像乱涂 | 喷枪只在窗台下沿浅喷一道（半径 8、密度 0.22），上面先垫一条 50% 灰图案；花盆投影改成灰图案小椭圆；云底不喷 |
| 窗外的山、草地、栅栏全是图案，花盆糊进背景 | 删栅栏，草地换最稀的 `dots`，山用 25%；花盆加深（盆身 50%、背光侧 75%），盆沿最浅 |
| 天空顶带用 12.5% 太密，窗户反而不比墙亮 | 天空 `mist → faint → 白` 三条带，墙纸用 `sprigs`：窗户（光源）是全画最亮的地方 |
| 窗外的圆树正好在苗或向日葵后面，像花上长了根棒棒糖；窗户竖棂正好在第 14 天那盆苗后面，像插了根支架 | 远景小物不要和前景植物重叠（删了树）；盆往旁边挪，避开竖棂 |
| 右边窗帘的坐标没镜像，下半截藏在黑猫后面 | 只画左窗帘，`copy(rect, to, flip=True, mask=窗帘遮罩)` 翻转复制到右边（当年的 Flip Horizontal）；带遮罩，背后的墙纸不跟着走；猫挪出窗帘 |
| 正面坐的黑猫是一团，胡子画在窗帘上 | 改成侧面：椭圆臀、斜椭圆胸、前腿、头、口鼻、两只三角耳拼成剪影，再用白线勾腿和臀的分界、项圈、耳内和眼；胡子用 XOR（`invert`），在黑脸上是白、出了脸是黑 |
| 喷壶嘴和水滴压在格子布窗帘上读不出来 | 喷壶挪进窗洞，壶嘴尖对准第 2 天那盆的盆沿，只留一滴水；左边窗台改放种子袋，标签行补上 day 0 |
| 两盆挪近后 day 2 和 day 14 的标签撞在一起 | 标签中心不跟盆走，单独给一组坐标 |
| 放大镜窗压在主窗口标题栏上 | 放在这一阶段还没画的日历位置；放大范围框住眼睛、耳尖和一点墙纸，才看得出「一格一格」 |

**古希腊黑绘陶瓶**

| 问题 | 改法 |
|---|---|
| 马像趴在地线上游泳：肚皮离地只有 0.1 个马高，四条腿水平伸着 | 身体抬高（肚皮 0.43、鬐甲 0.93 个马高）；近前腿高高折起、远前腿向前下够地、两条后腿向后下蹬，蹄子落在地线上 |
| 驾车人比马背还矮，像个小玩偶 | 车厢抬到轮轴上方，车夫身高 0.9 个马高、前倾 0.24，头和马耳平齐；胸墙挡住白袍下半截 |
| 白马夹在马队中间，只露几条白腿 | 白马放在最远的一匹，头抬得最高（颈部弯折 0.2），并且给瓶子正面中央的那辆车 |
| 颈部棕榈叶饰像一排电线塔：花瓣是直刺，卷须竖着往上走 | 9 瓣圆头扇形（中间长两边短），红色掌心描一道刻线；卷须改成垂花弧，从掌心下方荡到莲花挂点；莲花一长瓣加两瓣外卷 |
| 左边马队上一大片白雾，像多了一匹白马 | 那是大柔光箱在黑釉上的反射：箱子收窄成一条竖光（反射方位角 -0.90..-0.76）、强度 9 → 6，另加一层很弱的大面积柔光 |
| 圈足正中一个白三角 | 是环境里「天花板」方框光源在圈足顶面的反射，改成一层很柔的穹顶光 |
| 做旧过头：结壳成片白云，根痕太亮，加白剥成斑点狗 | 结壳只在下半身、阈值提高、强度 0.7；根痕透明度 35–75；加白只按大块剥掉约 20%，剥处留 20% 和一层哑光残影 |
| 修补填料是一个太规整的浅米色椭圆，缺口是白色小三角 | 填料轮廓加 0.42 的 fbm 抖动、调成偏暗的赭橙，黑色部分补成灰黑，外面几道胶合裂缝；缺口用 24 点 fbm 轮廓，露出的胎色改成暗橙 #c98a60 |
| 圈足的黑釉像木纹 | 薄釉发红的横向条纹噪声太强：釉厚底数提到 0.78、条纹权重降到 0.08；未烧泥釉的条纹也一起减弱 |
| 把手像两根铁丝；粘土上拉坯横纹太显 | 管径 0.046R → 0.072R；拉坯纹的法线扰动 0.018 → 0.009，只在反光里隐约看得见 |
| 动图里暗墙聚光灯和素坯出一圈圈色带 | 调色板从所有关键帧加权取样（饱和色 ×5、亮色 ×2）再中值切分，每帧量化前叠同一张 4×4 Bayer（约 ±2.4 级），透明占位色用品红 |

**铅笔素描**

| 问题 | 改法 |
|---|---|
| 轮廓线几乎看不见，整幅发白 | 1.5 px 的细线抗锯齿后每个像素覆盖只有一半，纸纹阈值又按覆盖算，线被吃成稀疏的颗粒：笔尖能压进纸纹多深按 √覆盖 算（按压力，不按像素覆盖）；勾线的石墨量 ×2（`gain`），散笔 ×1.6，顺形排线 ×1.3 |
| 纸像粗纹水彩纸，满屏一块块斑 | 纸纹以约 1.6 px 的细颗粒为主（细的一层 σ 0.3 倍，粗的一层 σ 1.3 倍），毛毡纹只占 0.05，浮雕光 0.07；细颗粒 σ 到 0.7 就成了砂纸 |
| 侧锋铺调一条条斜带、一块块云斑 | 三遍、每遍角度差 11°，行距 0.42 倍笔宽，压力只抖 ±10%，笔锋边缘柔化 0.22 倍笔宽；侧锋笔画按 8 px 重采样（连同栅格化提速，大面积侧锋快约 3.6 倍） |
| 排线块与块之间的接缝成了一道道亮带 | 收笔渐细只占笔长的 20%（原来 32%），每笔在接缝处多出或缩回 ±3 px，接缝每行漂移一点 |
| 边缘「只剩线稿」像喷枪渐隐 | 调子按 finish^0.6 衰减之外，排线和侧锋按笔画中点的 finish 整笔整笔地丢，越往外越稀；线条在纸边保留 35% 压力 |
| 纸擦笔把画面边上的灰抹到对面去、顶边出黑团 | 拖抹不能用 `np.roll`（会卷绕），改成边缘延伸的平移 |
| 车身周围一圈白边 | 擦笔在遮罩里做归一化模糊（`contain=True`）：只匀开遮罩内的石墨，不把车身那块空白「抹」进墙 |
| 墙上的车影像一辆糊掉的幽灵车 | 影子不带辐条，边只模糊 1 px，只用排线不用侧锋铺底，灰泥墙晕染时绕开影子，调子降到 0.4，车本身先被读到 |
| 转角侧墙成了一块奇怪的灰色楔子 | 楼太矮（顶边只到 y −60，相当于 1.6 m 高），顶边斜着落进画面：顶点放到 y −1400（三层楼），侧墙远端用噪声参差地收掉，招牌处挖空 |
| 车架是一条白色剪影，只有两根细线 | 车架当成深色漆管：沿管子顺形排线，越往背光侧越重，最外缘留一点反光，再用纸擦笔顺着管子匀一遍，最后橡皮擦出一道清楚的高光 |
| 法棍几乎全白 | 先侧锋铺一层面包皮的底色，再沿面包长轴两遍交错的顺形排线，下沿压一条 4B；刀口用可塑橡皮提亮，下唇再描一道深线 |
| 门是一整块深灰，抢了车 | 门降到 0.42，做成四块凹板：上沿和左沿一条暗边、下沿和右沿用橡皮擦出亮线；最深的只留门洞左壁和顶 |
| 页边笔记压在石子路上读不出 | 笔记和色阶两块区域不画石子轮廓，也不排线 |
| 色阶下面的 2H–8B 看不清 | 字号 22、用 2B、压力 0.95 |
| 出图 40 秒、峰值 1 GB | 栅格化时每段的宽度和灰度先整体算成列表；遮罩（多边形、粗线）只在包围盒里画；坐标用广播的行列向量而不是满幅 mgrid；纸纹用 float32 的小核卷积；用完的满幅遮罩及时 `del`：11 秒、约 0.72 GB |
| 动图 2.07 MB | 纸纹颗粒每次叠化都整片重编码：叠化帧里和屏上已显示颜色只差 ≤ 7/255 的像素沿用上一帧（透明），1.26 MB |

**X 光片**

| 问题 | 改法 |
|---|---|
| 恐龙骨架是全画的主角，却又淡又小，头骨被箱子圆角切掉一块 | 骨头半径和厚度都 ×1.6（铸的玩具骨头本来就粗），整体放大到 1.02 倍；脖子放低、头骨下移 22 px、后移 6 px，整副骨架挪到圆角以内 |
| 整幅画太暗，物体像沉在墨水里 | 显示曲线满白点从 A=11 降到 8.5、拐点 0.32 → 0.30；荧光辉光 0.35 → 0.5 |
| 毛衣和牛仔裤看着像比空箱子还暗的「黑垫子」 | 量了一下其实比空箱子亮（红通道 35 对 19），是被亮的折边衬暗了；密度提高（毛衣 0.33 → 0.5、牛仔裤 0.9 → 1.15），加针织 / 斜纹纹理，折边才显得是布 |
| 材料伪彩视图整片橙色：橡胶传送带也算有机物 | 真机做空气校准时传送带就在里面：`belt()` 记下自己的衰减，伪彩视图先减掉它，空处才是白的 |
| 骨架里穿的钢销把 Zeff 读数拉高 | 读数先用物体外一圈的中位数扣掉背景，再取逐像素 A_lo/A_hi 比值的中位数（不用总和之比），石膏读 14.4、水读 6.9 |
| 图例「INORGANIC」挤进了 METAL 色块 | 图例按字宽排，不按等分 |
| 结论表的字跑出侧栏 | 每行压到 40 字符以内（16 px 等宽） |
| 放大插图写着「×0.8」：框的是整副骨架，其实是缩小 | 只框头骨和胸腔，放大约 1.4 倍 |
| 1 号标签压在箱子亮边和密码锁上，看不清 | 标签文字下垫深色底板；读数和标签放同一行 |
| 八根伞骨偏移量正负对称，两两重合，看着只有四根棍子；伞面几乎看不见 | 伞骨绕伞杆的相位错开 0.3 格；伞面 14 层、密度 1.3，加弧形折痕 |
| 传送带接头（一列钢钩）挨着侧栏，像一条拉链 | 挪到画面最左边 |
| 动图用一张调色板时，伪彩插图里的绿骨架变成灰蓝，CLEAR / REMOVE 发白 | 调色板分两段切：蓝色胶片像素切 186 色，彩色像素（橙、绿、红、琥珀）切 69 色；每帧叠同一张 4×4 Bayer（约 ±2.4 级） |
| 峰值内存 0.86 GB | 散射雾在 1/4 分辨率上算；模糊改用切片视图（不用 `np.take` 复制）；OSD 辉光改用 Pillow 的 uint8 模糊；暗角用广播不用 `mgrid` |

**1930 年代黑白橡皮管动画**

| 问题 | 改法 |
|---|---|
| 画面太干净，像矢量插画套了个滤镜 | 镜头柔焦 0.85 px、四角再糊一档；颗粒 0.07、按 √(v(1−v)) 在中间调最重，再叠一层半分辨率的团粒；黑位抬到 0.075、白位压到 0.93，再加片门晃动和圆角片门 |
| 太阳的拳头像带盖的玻璃罐、盐瓶 | 拳头 = 手掌椭圆 + 顶上一排 4 个小圆（卷起的手指，成扇贝边）+ 指缝短线 + 横在前面的拇指；袖口缩短到 0.36 |
| 睡帽帽檐是一个扁椭圆，横在枕头上像一圈光环 | 帽子扣在枕头右上角，帽身从角上长出来往右下耷拉，帽檐改成沿帽口的一条宽带；角色头顶不要放任何扁椭圆 |
| 枕头像方盒子、像吐司 | 超椭圆指数 0.5 → 0.72，四边中点往里收 13%、四角往外顶（枕头角），不倾斜，四角加折痕短线 |
| 拖鞋像礼帽、像汉堡 | 稍微俯视来画：长椭圆鞋底 + 后半开口露出鞋里（浅色鞋口、中灰内底）+ 只盖住前半的毛绒鞋头 + 绒球，眼睛画在鞋头上 |
| 太阳一圈尖三角像参考帧里的太阳（也像皇冠）；改成细波浪线又像睫毛、小虫 | 扇贝边光晕 + 每个凹口一道粗短的放射短线（长短交替、两端略收） |
| 「RRRING!」字母挤在一起 | 字距 0.78 → 0.9 倍字宽；单双号字反向倾斜 ±10°、上下错开 0.12 倍字号 |
| 踢腿的速度线贴着床头柜像裂缝，跳起的拖鞋下面的竖线像钉子 | 去掉贴着家具的速度线，在踮脚的鞋尖外画三道放射短线（敲桌面）；跳起的拖鞋下面画两道「︶」弧线 |
| 绗缝被的棋盘格太抢眼 | 深格只压暗 0.17（原来 0.3） |
| 地板一大片空 | 窗户投下一块梯形阳光（软边 9 px、提亮 0.45）和一道窗横档的影子，拖鞋就在阳光里跳 |
| 动图里铅笔稿几乎看不见 | 铅笔画两遍（1.7 px / 1.1 px），强度 0.8 |
| 动图 2.34 MB | 胶片颗粒让每次叠化都改掉大半像素：和屏上已显示的颜色相差 ≤ 8/255 的像素沿用上一帧（记成透明），自检按实际显示的帧比对，1.54 MB |

**黑白麻胶版画**

| 问题 | 改法 |
|---|---|
| 天上的白色风痕又多又宽，夜空成了一片灰白，大块黑白对比没了 | 风痕从 520 条减到 300 条，宽度从 2–6.5 px 改成 1.6–5 px；只在两条斜云带里刻密，月亮 215 px 以内不刻；天空保持六七成是黑的 |
| 月亮上刻的三个黑斑像一张笑脸 | 去掉月海，只在背光一侧留 5 条同心弧做明暗（V 刀，宽 2.2 → 4.2 px，越靠边越粗）；光环每段 0.35–1.2 rad、缺口 0.15–0.6 rad，否则像靶心 |
| 炊烟飘过白色雪坡就看不见，只剩两根黑线；改成一串圆团后，又像一串珍珠、像毛毛虫 | 烟是一串互相压住的团：按弧长累计「半径 × 0.8」排开，越往上越大，铺满整条路径；穿过白色的地方留一圈 2 px 黑边（`outline(cut=False)`）；每三团留一道黑色卷纹；两股烟的控制点各加随机偏移，免得一模一样 |
| 烟囱像一架梯子 | 不再刻一排横缝，只刻两道短灰缝，顶上加一顶白雪帽 |
| 老树根部是一大块黑三角 | 根部外扩从 1.9 倍干宽降到 1.05 倍 |
| 树梢一截截平头，像修剪过 | 末梢一级的宽度收到 0.5 px（`brush` 的 `end`），高处的分叉改成 1–2 枝 |
| 人物站在黑房子前，头和墙糊成一片；脸挖成一个白圆，像幽灵；雪花刻在脸上，像一颗星 | 人物挪到雪地上（头顶低于雪野边缘）；脸改成朝左的侧脸剪影（额头、鼻尖、嘴、下巴），留一个黑点做眼睛；`speckle(region=)` 避开人物、狗、柴堆和灯笼 |
| 雪橇上的柴像长凳、像木箱 | 改成稍从后方看的柴垛：六根原木的截面排成 3-2-1，白色截面上留年轮和一道裂纹；木身是黑的，顺长刻两道树皮缝 |
| 黑版像压了浮雕，每道白刀痕都有一亮一暗的斜边 | 压印凹凸只留一点：法线明暗 × 0.3，限幅 ±3.5% |
| 套色像机器印的，平得发假 | 套色版加 mottle 0.25：浅色油墨更显纸纹和墨层不匀 |
| 清底的残刀印像头发丝、像铅笔划痕 | 改成顺下刀方向的直短线，1–3 条一组平行（相邻几刀之间的刀脊），数量减到原来的约 2/3 |
| 门前的光先是一个规整的梯形，后来又成了靴子形 | 远端用正弦加随机做成参差边，左右都往外张成扇形；套色版上横着用 U 刀挖几道，黑版的雪脊线照样从光上穿过 |
| 动图里的灯黄被量化成米色 | 中值切分 238 色，再从饱和像素（饱和度 > 0.28）里单独切 16 色补进调色板；透明占位色用品红 |

**VHS 家庭录像**

| 问题 | 改法 |
|---|---|
| 落地灯那一列从画面顶到底一整条白，墙面也被冲白 | CCD 竖向拖影改成按列累加「远超满阱」的溢出（阈值 2.2，只有烛焰这种点光源够得上），不再取每列最大值；灯罩墙上的光晕从 0.9 / 0.45 降到 0.38 / 0.2；泛光阈值 0.85 → 1.0、拖尾阈值 0.95 → 1.2 |
| 被烛光照亮的白奶油也越过阈值，拉出一根宽宽的橙色光柱 | 烛光 0.42 → 0.3、半径 300 → 280；拖影只认 2.2 以上的溢出 |
| 灯罩是一块灰白的平方块，被小彩旗压住，看不出是灯 | 灯罩下移 60 px，避开彩旗；自发光带左右明暗，上下加黄铜边、顶上加灯头和顶珠，外面再加一圈暖色辉光 |
| 前景孩子的上身是一块和墙纸同色的芥末黄长方块 | 换青绿色 ringer T 恤，和满屋的橙撞开；轮廓重画：头大、肩斜，上臂单独画到手肘，前臂伸向桌子，肘和身子之间露出背景；加肩胛骨暗线、发旋放射的发丝、两只耳朵、朝蛋糕一侧的暖色轮廓光 |
| 派对帽太小，蓝白条纹被墙纸吃掉 | 帽子放大到头半径的 1.75 倍，红黄螺旋条纹，朝蛋糕歪 24°，顶上一团锡箔绒球，帽子在头上投一点影 |
| 刚吹灭的蜡烛冒出的烟像几根发光的白棍，过了录像带像又多出几根火苗 | 烟改成灰色、不发光：从细到粗、越往上越淡、带卷曲的一缕；另外「烟量 1.0」和「点着」用的是同一个数，蜡烛状态改成 `'lit'` / 0–1 烟量 |
| OSD 的 0 看成 8，W 看成 U / H，PM 看成 PN | 字符发生器把每个点向右加粗，1 点宽的缝会被填死：0 去掉斜线，W、M 改成 7 点宽 |
| 变焦条的刻度和细边框在录像带上糊成一团 | 用和字体同一套点阵画：外框 + 实心填充 + 一根游标，不画刻度 |
| 泰迪熊坐在锈红沙发上，同色看不见 | 沙发改牛油果绿丝绒，熊改蜂蜜色 |
| 圆环墙纸对比太强，满墙抢戏 | `contrast=0.72` 把图案色往底色收；加纸幅接缝和几像素的错位，看着是贴上去的墙纸 |
| 电视屏幕中间一团橙色反光，像屏幕上破了个洞 | 改成窗户在屏幕左上角的一块冷色反光 |
| 黄色小旗上的白字看不见 | 按旗色亮度自动换字色：浅色旗用深棕字 |
| 掉磁白点一样长，满屏像下雨 | 数量 45 → 24，长度按指数分布：多数是一两个采样点，偶尔一长条 |
| 不存阶段快照时 `stage()` 也做一遍完整合成，出图 13 秒；峰值内存 1.15 GB | `keep_stages=False` 时 `stage()` 什么都不做（范例按有没有 `--stages` 设）；泛光的两个大半径在 1/4 分辨率上做；大彩色图的模糊逐通道做：6 秒、0.85 GB |

**扁平矢量**

| 问题 | 改法 |
|---|---|
| 旧版「周末书店」被用户否掉：东西堆满一整面墙，无五官的「企业扁平风」人偶比例别扭，满屏单一蓝色显得压抑 | 重做成风景：几层大形状（三角山、波浪丘、圆月）加大片留白的天空；人物只留一个 70 px 的剪影；夜蓝、紫的冷色对橙、黄沙的暖色，一共 7 色 |
| 层内纹理像木纹，月亮和云上一道道竖纹 | 纤维纹幅度 1.6% → 0.8%，条纹改短改细（14 × 2 px 网格），每层取不同偏移；全画颗粒 1.1% |
| 云像一条面包：底座是粗圆角矩形，下面一整条深色底带 | 三四个大小不一的圆坐在同一条平底线上，下面垫一条薄药丸；暗面 = 云减去朝光源挪动后的自己，只剩右下一道月牙 |
| 半透明烟柱压在紫山和品红山丘上，又灰又脏 | 删掉烟；半透明形状只放在单一底色上（沙地上的光圈、头灯光束） |
| 火焰底部被平切，像蜡烛；木柴藏在火后面；围石是突兀的蓝紫色 | 火焰用 `teardrop()`（圆 + 两条切线收成尖），外层加两条侧舌，三层套叠；木柴交叉压在火脚前面，锯口画一圈浅色；石头改成淡紫灰 |
| 背包客的橙色背包、帐篷的橙色尖顶贴着橙色山丘带，就看不见了（没有描边） | 把人和帐篷整个挪到黄沙上，让轮廓四周只有一种对比色 |
| 小路走到雪线就断了：奶油色虚线落在雪顶上看不见 | `trail()` 返回遮罩，把 `path & peak['snow']` 改成紫灰色，路一直通到山顶小旗 |
| 篝火光圈看不见；火星飘到山丘带上，看不出和火有关 | 光圈 4 层，每层 alpha 0.2，颜色 `tone(SAND, 0.5)`；火星只出现在火焰上方 120–190 px |
| 动图里，大块图层交接（夜蓝 → 橙 → 沙）的叠化帧满是粗杂点 | 调色板样本里加上 1/3、2/3 两张叠化帧；叠化帧只在两张关键帧不同的地方叠一张固定的 4×4 Bayer。整帧都叠是 1.5 MB；改用 Floyd–Steinberg 有 1.97 MB，还会抖到品红透明占位色，5 帧对不上 |

**绘本角色动画**

| 问题 | 改法 |
|---|---|
| 远山又高又满，压掉大半天空；两岸之间、水面上面露出一条米色纸缝 | 远山顶线压到 470–660，薄荷远山的底伸到画面底边（藏在两岸后面），淡紫远山的底停在 760（藏在薄荷后面）；淡紫的「提前量」比薄荷小（300 对 360），动画里淡紫的下沿永远不会露出来 |
| 总图里关键姿态挤成一团：落地压扁和预备动作在同一个点叠在一起，钻土的残影躲在小树苗后面，终点那片橡叶和漂流时的橡叶重叠成两片 | 只留沿路分得开的六个姿态（下落拉伸、落地压扁、滚动、飞跃、漂流、空翻）；终点的发芽用「最后一帧」本身（`final=True` 画出树苗顶上的橡果帽）；`props=False` 不画道具终点位置，只画和角色同一时刻的橡叶残影 |
| 落地压扁那一帧头顶冒出几根竖直速度线 | 速度线按前一帧的速度自动加，落地帧前一帧还在高速下落：冲击帧的姿态写 `speed=False` |
| 蜡笔短线一根都没画上 | 「内部」判断写成 blur(a) > 0.97，而水彩层不透明度只有 0.96–0.97：改成相对阈值 0.97 × a.max() |
| 蜡笔短线一出来就碎成麻点，像一行行小字 | 1920 宽时纸纹太细，按纸纹断线就成了点：改用 3.5 px 的粗颗粒，断得少；短线减少、加长加粗（44 × 5 px），透明度 0.55 |
| 河面上的白色反光像潦草的字 | 改成 16 根 80 px 长、略往上拱的白色长笔触，越靠近水面越密（top_bias），再加 9 根往下弯的深蓝波纹 |
| 树冠上的点缀先像圆点病斑，后像迷彩方块 | 换成三十几片小橡叶形「印」上去（两种秋色、半透明），树冠右下的暗面月牙加宽（偏移 40, 46 px） |
| 挂橡果的树枝被树冠盖住，看着像橡果悬在空中 | 缩小右边那团树冠，让树枝梢和挂果的小枝伸出树冠；树干、树枝的层放在树冠下面 |
| 手写字顺序不对：「little」先写了后半截，开头的 l 最后才出现 | 起笔点选「去斜体后最靠左」的端点：键值从 x − 0.3y 改成 x + 0.35y（向右上斜的字母，顶端比底部靠右）；720 宽时发丝线断掉，文字遮罩加 1.6 设计像素的笔宽 |
| 跟着角色画出来的远山、山坡，前沿是 120 px 宽的一团雾 | 柔边写成层宽的比例（0.06 × 2000 px）：改成最多 14 设计像素，前沿成了一道干脆的湿边 |
| 开场 0.2 秒整块绿色山坡就画出来了，右边一道竖直的「悬崖」挨着树 | 开头只画树和墨线地平线；山坡的绿色和远山放到「看树叶」那一秒（1.95–2.9 秒）先画左边一段（`pre=`），其余跟着角色滚下去再画（`follow=`） |
| 钻土时溅起的土粒一直掉到草地里去 | 土粒落回地面以下就不画 |
| 钻土的头一两帧，橡果被地面裁出一道笔直的横边 | 土堆在钻土开始 0.1 秒就弹出来，把裁切边盖住 |
| 彩纸屑又小又全压在字上 | 纸屑放大（10–19 px），从字下方炸开、横向散得更开（spread 1500、起点宽 640） |
| 12.5 fps 时滚动一帧转四五十度，有点跳 | 改成 15 fps；GIF 延时只能写厘秒，按累计取整写成 7、7、6 厘秒交替，平均正好 15 fps |

**圆珠笔涂鸦**

| 问题 | 改法 |
|---|---|
| 蛇太细像蚯蚓，棋子小得读不出 | 蛇头宽 54 / 44 / 38 px（约半格到六成格），头比脖子宽；蜗牛、云放大 1.1–1.3 倍，云的脸 84 px |
| 梯子横档和格线从蜗牛、云身上穿过去 | 先画棋子，后画的蛇、梯子、格线都用棋子遮罩 `clip` 掉（笔走到已经画好的东西前就停住）；格子上色也绕开蛇和棋子 |
| 跳格的红虚线像一串锯齿 V | 每跳一格用一条 14 点的抛物线弧（高 24 px）配箭头，不用三点样条 |
| 跳格的计数 1–4 压在格子编号上，「1」落在竖格线上整个看不见 | 弧的起止放到格子下部 0.4 格，数字放在弧顶、往右偏 13 px，离开格线 |
| 「+24!」被竖格线劈开、「nooo~」被汗滴和云挤住 | 标注整块放进一个空格子里；云只留一颗汗滴放在侧面，去掉两只手 |
| 折痕成了贯穿全画的一道亮白线 | 折痕的谷只深 0.1、宽 3 px，沿线加一点摆动，主要靠两侧纸面坡度不同带出的明暗 |
| 上一页透过来的无墨压痕字像白色浮雕字 | 盲压的槽深 ×0.55，只在侧光下隐约可见 |
| 手写字母互相撞（slow 看成 dow） | 每个字母的步进按它自己抖动后的字号算，字距默认 1.04，步进抖动降到 2% |
| 冒号、i 和 ! 的点丢了 | 字形骨架里小于 0.11 字号的连通块全部当「点」画，单像素的也算 |
| 格子编号末尾的墨团像小数点 | 小号数字的 gloop 降到 0.15 |
| 蛇头背后缺一段轮廓；鼻孔和嘴像多出来的眼睛 | 头的弧画到 ±148°，身体两侧从路径第 4 个点开始；去掉鼻孔和嘴，只留墨眼、彩铅腮红和红舌头 |
| 红笔沿梯子的虚线箭头从蜗牛壳上穿过去 | 箭头放到梯子没有棋子的那一侧（+40 px），再用棋子遮罩 `clip` |
| 墨线旁边的压痕亮边太抢、像浮雕 | 压痕打光增益 0.16 → 0.13，上限 ±0.1 |
| 动图里蛇和格子的彩铅颜色被量化成土褐色 | 两段调色板：150 色从「有色像素 ×5」的样本里中值切分，另外 104 色只从有色像素（饱和度 > 0.12）里切；49 帧约 0.6 MB |

**描图纸叠层**

| 问题 | 改法 |
|---|---|
| 三张描图纸叠在一起，整张图发灰发脏，背光纤维像大理石纹 | 描图纸透过率 0.955 → 0.98，云纹幅度 5% → 2%、尺度改细（6 / 22 px）；底图纸的云纹只留 1% |
| 抬起的纸下面糊成一片、整块发暗 | 漫射模糊 σ 5.5 → 2.8 px（描图纸），阴影不透明度 0.30 → 0.22，落在纸下面的那部分阴影再减半（室内光还能透过纸照下来） |
| 胶带像一块灰色塑料片 | 胶带是皱纹纸：一半透光、一半反射室内光（I·T·0.58 + T·0.36），颜色用暖奶油 `#f7ebcf`，皱纹和纤维只压暗 3–4% |
| 胶带贴在黄色公园上，成了一块橄榄色斑 | 胶带别贴在色块上：挪到纸边经过街区的地方，或者换个角 |
| 卷角成了一条灰色斜带，像脏印子 | 阴影带收窄（0.11R、只暗 7%），加一道折痕高光；卷角只放在空白页边，蓝片那个落在叠层最密处的卷角干脆不要 |
| 站点圆里的反白数字看不清 | 反白就是「露出下面一层」：站点压在深色地标（车站、集市楼、城堡、灯塔）上，数字就变成深灰。把站点挪到浅色街道、公园或水面上 |
| 步行路线和电车线在同一条路上叠成一条紫黑线 | 同一条路上分道走：电车偏左 4 px，步行偏右 6 px |
| 电车线从路名「STATION ROAD」上穿过去 | 把路名放到别的路上，或者删掉 |
| 公园和马路之间剩下 8–15 px 的细条街区，像一串虚线 | 递归切分的叶子块，按短轴厚度（3.46 × 短轴标准差）小于 12 px 就丢掉，留成空地 |
| 动图 5.1 MB：每落下一张纸，整片带纹理的区域都重新编码 | 见第四节：只重发明显变化的像素，开灯的叠化帧不加抖动；1.9 MB |
| 跳过小变化以后，灯箱渐变和海面上出现一圈圈等高线似的色斑 | 差值拆成平滑分量（模糊 2 px）和细节残差分开判断；停 900 毫秒的关键帧把平滑分量追到 3 级以内；开灯那几帧逐像素精确发送 |

**粉彩界面**

| 问题 | 改法 |
|---|---|
| 放大镜压在四天天气预报上：一列只有 86 px，镜片盖住了「周一」、切掉半个「18°」，粉色选中框在镜里变成两道竖条 | 预报改成三天（每列 113 px），日期和温度离图标中心 66 / 76 px，正好在镜框外；镜片半径 47、放大 1.42 倍，镜里只看得到那朵雨云 |
| 绿色色条压在字的下半截，看着像删除线 | 色条下沿落到基线下约 0.22 em（32 px 字：drop 7、高 13），只垫在字脚下 |
| 两个窗格下面各空出约 100 px | 正文行距 70 → 72、首行下移 10 px，进度条贴着预报卡往下放 |
| 「根据 [证件夹]：护照、机票都在」读着别扭 | 引用标签放到行首：「[证件夹 ✓] 里，护照、机票都在；」 |
| 换成薄荷底，步骤条和胶囊跟着变绿，和「通过」的绿色撞在一起 | 有 ✓ / ✗ 的画面用蓝底（强调色是蓝），绿色只留给通过 |
| 回弹缓动前两步就走完 99 %，五步的弹出看着像直接冒出来 | 窗口和面板的弹出改成六步 |
| 动图里橙色像素小怪和星芒变成粉色、绿色徽章变成青色、奶油色圆盘抖成粉点 | 这些颜色面积小、最后几秒才出现，中值切分分不到色位：把整套界面色（47 个精确色值）强制放进调色板，最后一帧取样 ×8 |
| 84 张阶段快照留在内存里，峰值 1.27 GB | `stage()` 存成 PNG 压缩字节（compress_level=1），峰值约 0.54 GB |

**阅卷批改**

| 问题 | 改法 |
|---|---|
| 红圈从「=」上压过去 | 「6（天）」前只有一个空格（约 11 px），放不下 3 px 宽的圈和两边的空白：让考生在「=」后空两格（约 23 px），圈的左边离「6」12 px、离「=」11 px，右边留 18 px |
| 引线斜着穿过整个作答区，又长又乱 | 阅卷栏里把「批注」排在第一行，和出错那一行同高，引线变成一道平缓的弧 |
| 印章压住阅卷栏的栏名 | 每行留出约 104 px，章高 60、字号 28，章心放在栏名基线下约 42 px |
| 印章一头太淡，「书写」两个字读不出来 | 轻的那头压力 0.52 → 0.58 → 0.64：还是一头发干、细框断开，但字认得出 |
| 红墨像电脑字，看不出浓淡 | 红色在绿、蓝通道吸收很强，密度 0.8 以上只是略微变深：让密度在 0.74 上下浮动（压力 ±0.20、两级斑驳、拐弯积墨最多 +0.26，实测约 0.4–1.2），边缘加深 0.18，洇开的软边模糊 1.7 px；批注字的斑驳按字号的 0.7 倍取尺度，一个字里就有浓有淡 |
| 波浪线像一条正弦曲线 | 周期和幅度都用 1D 噪声漂移，整条往下坡斜一点 |
| 长尾夹的把手像两根发卡 | 真夹子每根钢丝把手都横跨整个夹子：两腿插在夹子两端、顶上一根横梁；画两根，后面那根略矮、在阴影里 |
| 印章木块像一块饼干，把手像巧克力球 | 木纹方向反了（沿长边是高频）：改成跨章身方向高频、沿长边低频再加一点扭曲；把手用同色系的木头，加车旋纹和根部一圈暗环 |
| 章压下去时纸上一圈青边 | 阴影色原来按毛毡调成偏绿，乘在米色纸上发青：改成近中性的 (0.15, 0.14, 0.12)，毛毡上的影照样是绿的 |
| 分数外的圈压到「7」的头 | 圈的纵半径 0.66h → 0.70h，横向多留 0.30h，从左上方 −118° 起笔 |
| 113 张 1920×1080 阶段快照 | 给 `stages_dir`，`stage()` 当场写 PNG（compress_level=1），峰值内存约 0.78 GB |

**皮影戏**

| 问题 | 改法 |
|---|---|
| 幕布像一面白墙，颜色像印在纸上，不发光 | 光晕衰减太缓、热点太白：光晕半径缩到 0.47W × 0.64H，底亮度 0.20 → 0.10，热点压成琥珀 (1, 0.75, 0.37)、边缘深橙；色调曲线用柔肩，亮处只微微溢出 |
| 衣服像渔网袜，一身全是小孔 | 镂空太密：大面积的袍子留实色，纹样只放在一段里（裙上云头 26、胸前鱼鳞 17、袖子一段云头），裤子只在外侧缝一列圆点；画布上一个纹样单元至少约 12 px |
| 人偶细长、脖子长、头小 | 躯干加宽到约 90，腿缩短（大腿 100、小腿到鞋底 116），头单独放大 1.15 倍，脖子关节下移 7 |
| 两肩一团黑 | 两只上臂都带护肩花，叠在云肩上：只让近侧那只带 |
| 举起来的手臂盖住了脸 | 侧身时肩在头的正下方，近侧手臂抬过约 140° 就从脸前过：要高举就举远侧那只（向后上方），近侧手臂斜向前上（130–147°）；亮相用一手高（远侧向后上）一手低（近侧向前下）加提膝 |
| 离幕一点（d = 0.05）的人整个糊了 | 虚化长得太快、双影分得太小：σ = 0.5 + 16d，放大 1 + 0.30d（两个灯芯的影子分开约 5 px），得到一个清楚的影加一条软的双边，而不是失焦 |
| 挂落和花牙子被照成一片橙色 | 溢光拿整块幕布算，木头后面的也算上了：只用露出来的幕布（× (1 − 木头遮罩)），木头正面是暗的，挨着亮处的边才有一圈暖光 |
| 花牙子只是几根细线 | 改成一块四分之一圆的雕板，挖空中间、留宽边，里面三个涡卷 |
| 鞠放进风流眼里像一朵淡花 | 太淡、孔太多：实心赭黄、红芯、六道黑缝线、每瓣一个梭形孔，半径 28 |
| 两个红方人物挤在一起（翎子扫到同伴头上、同伴的手搭在球头背上） | 翎子给后仰踢球的那个，同伴戴三叉冠，左右拉开到 262 / 612；踢球的人往左让，脚停在左门柱左边 |
| 动图里鲜红和绿裤子被量化成土红、灰绿 | 人偶最后才出场，均匀取样把这些颜色平均掉了：成品取样 ×8，再只从最后几帧的饱和色和冷色（青、绿）里切 105 色，最后 6 轮 k-means，末帧 p99 误差 34 → 16 |
| 结尾灯闪三下多出 360 KB | 每闪一下整片幕布都变，要整帧重发：只暗一下（7%）；点灯也从 7 帧减到 5 帧 |
| 画戏台时峰值内存 1.2 GB | 浮雕打光在整张画布上算：只在横楣一条、两根柱子、台口一条上分段算，远处溢光用半分辨率，球门和底带用 2 倍超采样；峰值约 0.8 GB（出阶段约 0.9 GB） |

**钢笔淡彩**

| 问题 | 改法 |
|---|---|
| 卡片像拉毛墙，淡彩像彩铅一粒一粒 | 纸纹受光 0.42 → 0.20；淡彩颗粒 0.35 → 0.14、笔刷条纹 0.18 → 0.08（背景色块 0.2 / 0.12）。颗粒和条纹只要隐约看得见 |
| 鼻子、舌头、面包屑变成一个个白圈 | 小区域也照样错位 3–5 px、留 2 px 白缝，颜色就被挤没了：`wash()` 按区域等效半径缩放错位、留白缝和边缘抖动（小于 16 px 按比例缩小，最低 0.22 倍） |
| 胡子下面吹口哨的小「o」读成字母 p | 小圆圈挂在胡子下面就是一个字母：删掉，口哨只靠旁边两个音符 |
| 红色圆顶头盔读成毒蘑菇 | 红顶 + 白通风孔 + 一块大高光就是蘑菇：换钴蓝头盔、深色通风槽、珊瑚色条纹，不加大高光；帽檐压到眉毛，两只眼睛从下面露出来，「头盔太大」才看得出来 |
| 浇水壶像烧水壶 | 壶身前倾约 14°，长壶嘴从壶底前侧斜伸出去，头上一个莲蓬头带几个小孔，提手从顶上跨过去 |
| 白围裙椭圆像雪人肚子；换成蓝袖白前胸又像企鹅 | 白厨师服的圆身子 + 窄一点的钴蓝背带围裙；围裙口袋只描线，做成不上色的部件会变成白洞，把围裙变成「6」字 |
| 小孩的第二只眼、鼻子、舌头落在脸的轮廓外 | 五官收进头的轮廓里，只让鼻子在轮廓边上鼓出一点；车把立杆放在脸的前方，不能从脸上穿过 |
| 透明水杆没有影子，像浮在桌上，还有橙色光斑 | 透明部分影子密度 0.62（实心是 1），焦散只提亮 0.10；杆身加一点雾面（+0.08）才像塑料不像玻璃 |
| 木纹像贴膜地板，中间突然断一截 | 每块板单独生成，加 1–2 组「山纹」拱形年轮；不要用 `np.roll` 挪纹理（卷绕处会断开），拼接缝右边换一块新板 |
| 笔太小，下面三分之一桌面空着 | 按真实比例：卡片约 9 cm 宽时，针管笔比卡片还长（640 px、r 16），水笔 600 px、r 24 |
| 动图里淡蓝、灰绿背景块变成灰青和米色，黄衣服发橙 | 橡木桌本身就是饱和色，「饱和像素 ×5」把色位都给了木头：56 色只从空桌面切，198 色只从和空桌面不同的像素切；末帧 p99 误差 35 → 23 |

**复古水粉**

| 问题 | 改法 |
|---|---|
| 背景像一根根香肠，圆头，颜色一块一块地跳 | 每笔都满载落笔才会这样：底层的长笔触几乎同色（vj 0.012），只在笔尾变干；上面亮、暗两遍落笔就半干（load 0.72–0.74，dry 约 0.5），只挂在纸纹凸起上，断成一道道；托底色先薄铺一层平的，再加笔触 |
| 帽子和脸像扁盘子，亮的是轮廓边而不是面 | 「模糊遮罩开方」的枕头中间平、边缘陡，光又太偏侧：高度改成按遮罩内缘的值归一化、再开方的穹顶，光加正面分量 (-0.44, -0.56, 0.70)，relief 默认 0.55（脸 0.45–0.5） |
| 皮肤暗部发紫发灰，一块一块的 | `ramp()` 默认的冷色偏紫，只适合衣服：皮肤用暖的五阶（#c0705d → #fbe3cc）或 `ramp(..., cool='#a02a3a')`；`model_form` 默认 ambient 0.08，遮罩边缘就不会取到最深一阶，同色的袖子边上也不再冒出孤立的深色短笔 |
| 大红鼻子像迷彩 | 大笔触不透明地铺几阶颜色造成的：`sphere_shade` 改用小笔触、alpha 0.55、密度 3.2、湿底 0.9、色阶交界 soft 0.3 |
| 防水雨帽读成遮阳盔，帽檐像游泳圈，雨珠像铆钉和珍珠，系带像两根筷子 | 去掉冠上的缝线和系带，冠压低变圆；帽檐不按枕头塑形，height 全 0 平涂，下垂的两侧罩暗，底下一条深边，顶面一道亮边；雨珠是透明的：比帽子更饱和的黄、右下一块琥珀色投影、反侧一小块焦散亮斑、很小的白高光，位置打散，不排成一行 |
| 小鱼读成鸟头 | 嘴画在头外面成了一个黑球，眼珠贴边像翻白眼：嘴放进吻端、加一圈浅色唇，眼珠只略偏；鱼身放大，用亮银色压在藏青毛衣上 |
| 围巾像颈枕或香肠，热气从鼻子连到杯子像鼻涕 | 一个 U 形环、两端圆头悬在肩外：改成绕两圈，下卷压在肩上，上卷在下卷上投影，垂下的那一端先画（在两卷后面）；热气两缕从杯口往两边歪，停在围巾上，不碰鼻子 |
| 一塔卷发像一盘肉桂卷 | 每个卷中心最亮、笔触同心：卷改成「环」，中心是暗的空洞，鼓起在 0.5 r 处；卷减到约 30 个，半径 34–60 不等；再加几百根往上梳的长发和少量飞丝，把卷连成一个发型（这一遍不用最深的颜色，深色长线像划痕） |
| 衣领两片像两个靠垫 | 两片圆鼓鼓的领子改成带缺口的平西装领（relief 0.25），领口下露出红高领的 V 区 |
| 质感跑到前面的部件上（高领的罗纹画到翻领上，外套的高光画到杯子上） | `knit`、`rib`、`dry_highlight` 是对遮罩里已有的颜料做乘法或加笔：遮罩先乘 (1 − 前面的部件) |
| 帽子和外套大块干净，像塑料 | 少了最后的干笔高光：`dry_highlight` 只在受光 > 0.62–0.7 的地方拖半干的浅色；穹顶用 `angle='fall'`（顺坡），用 `'contour'` 会画成一个漩涡 |
| 动图里瞳孔和眼皮线发蓝 | 中值切分出来最深的一色是毛衣的藏青：强制放进三个深中性色，另外 9 色只从末帧误差最大（> 18 级）的像素里切 |

**蓝调绘本**

| 问题 | 改法 |
|---|---|
| 背景蓝块里白道太多，像刮花的粉笔 | 压力的斑驳和笔道直接改了覆盖率，压力掉到 0.7 就露出三成白纸：覆盖率只由 `pressure`（0.95 左右）和纸纹决定，斑驳和笔道只改颜料浓淡；纸纹只一半顺笔拖开（`streak` 0.45），里面只剩细白点 |
| 白纸发灰发脏 | 纸纹在白纸上的明暗 0.022 → 0.012，印刷细点 0.016 → 0.009；纸色改成更白的 #fbfaf5 |
| 墨点像带刺的墨团 | 点的半径每个顶点单独随机：改成沿一圈的低频起伏 |
| 熊的毛边是碎碎的虚线 | 小弧太短太干：长 16–30 px，间隔为平均长度的 0.62 倍（相邻小弧叠一点），dry 0.12，12% 的位置留缺口 |
| 珊瑚红小花、伞的倒影在深色上发褐 | 蜡的半透明混色（色 × 底^0.55）盖在深青、蓝上会变暗：深底上的点缀用不透明的 `medium='gouache'`（倒影 alpha 0.8）；伞、头发这些大块在背景色块里先留白（`avoid`），蜡笔涂在白纸上 |
| 后上的颜色把墨线盖掉，眼睛的白高光不见了 | 墨的覆盖记进 `K`，之后上的颜色乘 (1 − 0.9·K)；高光 `over_ink=1`，粉笔 0.5 |
| 举伞的胳膊从小孩脸上横穿过去 | 两只胳膊都从右肩出发，在头的右侧往上伸：先确认胳膊在头的高度上 x 大于头的右边缘 |
| 草叶和乱线画到了熊腿和小孩身上，靴子是白的、只有几道灰线 | `blades`、`scribble` 加 `clip=1 − 前景遮罩`；小面积的靴子先用近黑的不透明水粉涂满，再在上面乱线 |
| 熊整只发灰发蓝 | 暗面的淡蓝、排线和落在熊身上的雨都太多：暗面只留最右边一窄条，排线行距 14–16、density 0.6–0.7，熊身上只下 45 笔雨，用粉蓝 |
| 熊的鼻子在伞边上，不像「只有鼻子是干的」 | 口鼻往左拉长（rx 80 → 92），鼻子挪到伞的雨影正中；雨按斜度留出伞下一条不下雨的柱子，熊的头顶、耳朵加水花和挂着的水珠 |
| 乱线暗部是一把梳子、一条黑带横贯整页 | 暗部遮罩的上缘是一条直线，转折全排在一条线上：改成按「越往下越暗 + 低频噪声」取阈值的一团一团（深青灌木 0.66、蓝灌木 0.9），笔 5.2 px、行距 4.6 px 叠成一片；蓝灌木用藏青不用黑；灌木底线改成波浪 |
| 蜗牛读成长椅靠背上的一个芥末黄圆盘 | 去掉靠背；候车亭里加一块淡蓝玻璃（不透明水粉，alpha 0.82），蜗牛坐在座板上，眼柄和小笑脸落在浅色玻璃前面才看得见 |
| 远处的树是一个个平涂的气球 | 改小、颜色改成接近天色的 #a3c1e2、两团叠成不规则的树冠，加竖向的干笔树干；小孩身后那棵删掉，免得像她头后面的气球 |
| 线条像马克笔，太细太匀 | 主要轮廓加粗约 20%（小孩头 5.2、熊毛边 4.2、伞 4.8），`swell` 0.3–0.35；`outline` 默认 35% 的几率把一段再描一遍、偏开 1.5–3 px |
| 雨像数码雨，一样长、一样密 | 深蓝 560 笔（10–40 px）、矢车菊蓝 260 笔、粉笔白 240 笔，三种深浅、长短拉开 |
| 鸭妈妈的头伸进天空色块，染成了蓝 | 鸭子放低，并加进背景色块的 `avoid` |
| 背景块角上一道干笔斜着戳出纸外 | 贴边的干笔用 `clip` 限在块的边缘附近 |
| 印刷一步把白纸压灰，动图最后一帧整体一暗 | 「黑色抬到墨色」原来是整体混进 5% 深墨：改成 c0 + 颜色 × (1 − c0)，白纸不动，只抬黑 |

**江南园林**

| 问题 | 改法 |
|---|---|
| 树冠是一团团带噪点的绿球（「西兰花」） | 每个团块当穹顶打光；暗底先画团块的芯，再画 1.7 倍大的暗叶（底色边缘也是叶子），叶片穿出轮廓，亮叶 5–14 片一簇、只落在受光值高的地方；团块 24 个、大小 0.15–0.34，轮廓才碎；屋后的树 far 0.3、更后一排 0.4–0.6，越远越蓝、越平 |
| 垂柳是一整片石灰绿的帘子 | 柳丝 3–9 根一绺，绺与绺之间留缝；叶子 3–5 px、宽只有长的 0.28；后排的绺暗、偏蓝，前排亮、偏黄，受光一侧再亮一点 |
| 柳树顶上露出几道细黑弧线，像伞骨 | 先画枝，再用一层垂叶的树冠盖住，三成柳丝从树冠里长出来，树冠顶上才不是一条硬线 |
| 近处的柳丝是一根根麻花辫 | 叶子严格左右交替，成了人字纹：改成随机挂在一侧，离茎张开 0.18–0.5 弧度，长短不一；只画 34 根，每根稀一点，叶片更瘦（宽 0.22） |
| 九曲桥是一排横在水上的灰栏杆 | 太近、太大、栏杆太高、望柱太密：起点退到 15 m，栏高 0.5 m，望柱 1.9 m 一根；眼高 3 m 时近侧栏杆会把桥面整个挡住，改成只留远侧栏杆（很多曲桥本来就只有一侧栏杆），石板和缝才看得见，折线才读得出来 |
| 桥面像一块漂在水上的薄板 | 桥板侧面和桥墩的法向算反了，朝向镜头的面被剔掉：法向改成 (−e_z, 0, e_x)，桥板厚度和桥墩才出来 |
| 石桥满是麻点，像花岗岩 | 画布纹理 0.07 → 0.025，每个面只做一点明暗抖动 |
| 水面竖纹太重，像在下雨 | 细竖纹 3.5% → 1.3%，竖向模糊 9 → 14 px；另加从水面本身取色的横向笔触，水才像画出来的 |
| 睡莲叶是一圈红边的卡通盘子 | 卷边露出红背的只留 12%，边更细；近半边压暗改成 alpha 0.45、内缘收到 0.55 / 0.3（不再是一圈内线），远边一道浅亮边；叶子按几丛分布，不铺满水面 |
| 白花树是一团紫灰色的棉花 | 平涂的暗底缩到团块的 0.55，改成偏绿的深色，再用暗花瓣和深绿叶的笔触打底；花簇数量 ×1.5、每簇 12–25 瓣，受光一侧的花瓣更白 |
| 粉色灌木里露出几块平涂的褐紫色大斑 | 平滑的椭圆暗底换成笔触暗底（45% 深绿叶 + 55% 暗花瓣），椭圆只留团块中心 |
| 窗格中间一块黑方块像个洞，换成窗纸后又像一块空白牌子 | 侧窗用糊纸的底；灯笼锦中间的空框缩到宽 40%、高 34% |
| 漏窗被柳丝挡住 | 挪到月洞门和茶榭之间那段墙上 |
| 屋顶一片死黑、看不出瓦 | 瓦的色阶提亮；筒瓦受光侧 0.6，瓦口亮边 +0.3、下面的阴影 −0.26，越往檐口越亮（反射天光） |
| 飞着的白鹭像一根白羽毛 | 翅膀改成宽、往后掠的形状，翼尖分出五根飞羽，远侧翅膀发灰，颈缩回去，腿拖在后面 |
| 远山被树全挡住，看不出层次 | 两层山脊抬高 40–70 px；山脚 60 px 渐隐（不然动图前几帧山脚是一条硬横线） |
| 对岸右边是一片发白的雾墙 | 补上岸边的灌木和小树，一直到水边 |
| 光是平的，看不出春天的太阳 | 墙上、台基上、桥上加叶影（阈值噪声的冷色斑，离投影的树越近越重；桥上用桥的遮罩限住，不压暗水面）；檐下阴影 0.42 → 0.5 |
| 所有树都一个样 | 墙后加一棵托盘松（针叶用细叶片、几乎不下垂）；前景加白色小花和弯曲、带受光边的鸢尾叶（原来是直挺挺的绿刺） |
| 墙和水面太干净，像矢量图 | 墙上叠一层淡笔触（alpha 0.6，明暗浮动 −3.5% 到 +2.5%）；收尾加轻微柔化、亮部光晕、暗部偏青 |

**干刷色块**

| 问题 | 改法 |
|---|---|
| 色块里全是垂直于笔触的「梯子横档」，像蜡笔排线，不像干笔 | 各向异性噪声原来是把粗网格放大，格点对齐的列一阈值化就成横档：改成白噪声按方向模糊（沿笔方向在 1/f 分辨率上做再拉回去）；干笔齿改成鬃毛条纹 + 粗拖痕 + 纸纹的混合，干掉的地方才是成簇、宽窄不一的点，不是发丝线 |
| 某些位置空出一整列 | 一维模糊用补零边界，纹理块边缘变暗，色块或绕回的笔触碰到边缘就空一列：纹理改用循环边界 |
| 弯的笔触上还是有横档 | Pillow 的粗线 `line()` 把线段方向量化了，约六成像素记到了错的线段上：改成每段一个垂直于线段的浮点四边形加圆形接头，再修半像素偏移（中位偏差 −0.7 px） |
| 笔触末端一圈圈同心环 | 末端的纹理坐标被钉死：让纹理沿弧长一直延伸过笔端；干笔开始得更晚（`dry_from`），起笔更钝、更饱满 |
| 毛齿伸得太远，拖出一根根长尾巴 | 毛齿只从柔化带里长出来，块身的皴擦也减轻 |
| 外套是一条条整齐的平行条纹，近看像排线 | 每道笔打断成长短不一、各有明暗的短笔（`stroke_len`）；暗的一半几乎实色（`load` 1.02），暗半边上拖过的藏青笔 4 → 3 笔；亮暗两半朝不同方向刷 |
| 第一版有一块颜色是 NaN | 酱油瓶传了 `dark=None`，混色时拿它去算：没有 dark 就不混 |
| 帽子像毛线帽，胡子像巫师的山羊胡，碗又小又扁 | 换成平头白发（顶上和鬓角干笔皴擦，暗侧另一种颜色）、更宽更短的白胡子、更大更深的碗 |
| 白发太高，像一顶发套 | 头发轮廓的顶往下压（−1.12 → −1.06）；交付时白发仍有一点发套感 |
| 热气是一根根细铁丝，改成皴擦带后又是一团灰雾 | 低压力的笔只碰到几行长齿，所以成了线；最后去掉热气 |
| 背景大色板像在下雨，满是竖向条纹 | 两遍原来共用同一窗纹理，缝对着缝：每一遍取自己的一窗；参考图那块是滚筒的平涂细点，不是鬃毛条纹：加 `tooth='roller'` 和 `scratches()`，`backdrop()` 默认用滚筒 |
| 背景色板干的细点落在起笔的顶边上 | 干擦的边按方向加权，只放在顺笔的两侧，起笔边保持干净 |
| 眼镜像墨镜 | 镜片里的暗色 0.45 → 0.22 |
| 近处的胳膊和外套混成一片 | 袖子改用藏青、混一点青蓝，和外套亮的那半分开 |
| 手先像面包、又像软木塞 | 改成从拇指一侧看：亮的手背、四条明暗交替的手指（最下面一条在暗部）、指间暗线、上面一根拇指、指节一笔干高光，手腕加一截米色袖口和袖子分开；交付时手仍是最弱的地方 |
| 碗边的干笔毛齿像速度线 | 碗身毛齿 14 → 5 px，色带 16 → 6 px |
| 瓷碗上有深色条纹，透出后面的黑外套 | 接触压力约 0.97 时纹理窗口的起伏留下约 7% 的空隙，压在深色上很显眼：`load` 允许大于 1（上限 1.08），碗身用 1.05 |
| 鼻子看不见，鼻头像嘴 | 脸颊暗面的边界往外推（0.18 → 0.34），鼻侧用更深的褐色，加一笔亮的鼻梁、更小的暖色鼻头和鼻下阴影 |
| 青蓝色块里的皴擦太花 | 皴擦 0.2 → 0.07，干笔推迟到每道的后段（`dry_from` 0.72–0.95） |
| `jacket(light=+1)` 直接报错 | 暗半边那几笔的 x 范围上下限写反了：改成按光的方向取暗半边 |

**暮色微缩绘本**

| 问题 | 改法 |
|---|---|
| 第一版天空里漏出 NaN | 云的包络 `sin(πu)` 在两端略小于 0，再开 0.55 次方：先截到 0..1 |
| 云是一条条细线 | 重写成透镜形：一条扁透镜加 4–5 团圆块（中间高），轮廓模糊，底部更平更清，上浅下浓 |
| 昼夜交界是一片灰雾 | 交界带补饱和度（`richness`），夜空靠边界的一侧偏靛蓝（靛蓝提亮），边界羽化的噪声尺度 90 → 170、幅度减半：黄昏 → 淡紫 → 靛蓝 → 黑 |
| 补了饱和度以后，交界成了一堵霓虹紫墙 | `richness` 0.9 → 0.5，靛蓝压回一点 |
| 昼夜边界是一条直的斜线 | 边界折线改成六个点的弧（夜像穹顶一样压过来），过渡带 150 → 185 px |
| 天空的薰衣草紫太深太艳，云融进天里 | 六个色标都提亮、降饱和；云色压暗一点，云顶往浅色混的比例 0.4 → 0.22 |
| 银河的暗带太弱 | 加一个更亮更窄的内核，暗带收窄、加深（`rift` 0.65 → 0.8）；交付时银河仍偏烟雾、暗带仍比参考图弱 |
| 四芒星太多、太大，靠近交界和地平线也有 | 9 颗 → 6 颗，大小 9–17 → 7–13 px，只放在夜度 > 0.8、离地平线 180 px 以上的地方 |
| 远处坡顶的花是一条又密又亮的带 | 覆盖率改成越远越低（0.24 + 0.32 t，t 从坡顶 0 到底边 1），远处的花沉进带雾的地色（`haze`） |
| 风筝在深夜里，被夜度着色压成了灰蓝 | 风筝挪进交界带，珊瑚色才保得住 |
| 角色夕阳一侧的边光是灰的；改暖以后又成了一道硬的棕色带 | 边光用暖杏色，从轮廓往里 3 px、模糊 1.4 px、最多 0.6，越往下越淡 |
| 放大图的目标标记圈落在珊瑚色风筝上看不见 | 标记圈和引线固定用深墨色（`leader_colour`） |
| 放大图的标签越出圆片，尺寸数字压在线上 | `dimension()` 的数字按字的「上方」放到背离物体的一侧；横跨杆件的「14」还撞上提线：去掉，改成 `across=True` 的「ø 6」直径标注，引到杆件外面写 |
| 拼布条纹田像一面面旗 | 田的颜色降饱和、彼此更接近，山脊起伏加大，树篱线 0.45，底部渐隐 |
| 阶段快照没有颗粒、暗角和撕纸边，和成品对不上 | `finish()` 只记参数、在 render 里加，改到画第一笔之前调用 |

**排线夜景**

| 问题 | 改法 |
|---|---|
| 云团里一圈圈同心的漩涡，像梵高的星空 | 笔触处处沿团块的切线走：团块里面改成顺着上升柱子的方向（顶上顺着风），只在团块边缘（半径 0.55–0.97）混进切线，最多 0.75 |
| 海面和云里满是孤立的黑点，像脏了 | 纸纹缝隙是一个个孤立像素，深色的底从里面透出来：纸纹沿 8 个方向拖开，每笔按自己的方向取，漏白顺着笔成短道；默认压力 0.9 → 0.95，海面、倒影 0.96–0.975；底色从 #0a0f27 提到 #0d1331 |
| 熔岩细流像一道道闪电劈向海面 | 直线段加大角度的分叉、黄白色：改成带惯性的游走（一直转向终点、顺坡离开山顶），支流只分 0.18–0.5 弧度；发光的颜色在色阶上压到 0.3–0.92（主要是橙红），只有亮珠和前锋发黄 |
| 改成游走后细流打圈、像一团意面 | 转向噪声太大、拉向终点太弱：每步转角 0.035·wander（0.85 衰减），拉力 0.16–0.46 |
| 熔岩入海处是一个平滑的大白团，像爆炸 | 光改成一圈圈放射的笔触（黄白 → 橙 → 红，色阶起点 0.28–0.72）；平滑的白芯缩到 0.11 r、辉光 0.18；横向压扁（0.6）；沿入海的一排细流再放两个小热源 |
| 被照亮的云是一片鲑鱼粉 | 橙光用 screen 加到蓝灰的云上就是粉：受光的云改用 `glow(blend='paint')`，颜色 = 光 × 受光 + 一点暗的环境色，才是红橙；另一层很淡的加光只给最亮的底部 |
| 云柱底部像一丛火苗 | 往上走的长笔触、饱和的黄橙、中间的暗缝：近热源的笔 `whiten` 0.6 偏暖白（蒸汽是白的），底部的小团块多混一点切线（卷起来），亮笔触压力 0.97、密度 1.8 |
| 天空的浅色短笔像在下雪 | 浅色笔触太多、太亮、太短：只落在噪声的高处（成片成带），密度 0.35 → 0.16，长 18–42、宽 1.1–1.7，明度只比底色高 0.3 |
| 天空是饱和的宝蓝，不是夜色 | 天和海的色阶整体压暗、去饱和，往靛蓝和冷灰蓝靠；天顶明度 0.04、地平线 0.6 |
| 倒影两侧边缘一道道白横线 | 镜像取样被涟漪推到了画心外的米白纸边：取样坐标限制在画心里 |
| 礁石上一块块橙红，像也有熔岩 | 礁石离热源远，轮廓光太强：rim 0.9 → 0.14；小人的轮廓光 0.45 |
| 版痕的线一直延伸到纸的边上 | 用的是到四条无限长直线的距离：改成到矩形的距离，上沿和左沿的暗线也只在矩形范围内 |
| 成品一步画心边缘多了一圈褐色 | 辉光把画心外米白纸边的亮度也模糊进来了：辉光只取画心里的亮度 |
| 远处的岛看不见 | 太矮、颜色和地平线的天一样：岛加高 10–15 px，改用最暗的陆地色阶 |
| 两个小人在深色海面上看不出来 | 他们身后加一小片浅色波光（横向短笔，只在礁石外），剪影才立起来；小人 40–44 px，围巾是唯一的亮色 |
| 熔岩路径有 NaN | float32 里 sin(π) 是一个很小的负数，`** 0.8` 得到 NaN：先 clip 到 0–1 |

## 四、做成动画

- 各画风都有 `stage(name)` 和 `save(path, stages_dir)`，按阶段依次淡入叠化，就是「一幅画被逐步画出来」。README 里的动图就是这样做的。
- 动图规格（多数现有动图和后来新增的都一致）：720×405；每个阶段停 900 毫秒，再用 5 帧（每帧 90 毫秒）叠化到下一阶段，最后一帧停 2600 毫秒，无限循环。后来新增的动图所有帧共用一张 256 色调色板，文件小、不闪烁。
- 调色板别只取最后一帧：满屏单色（黑板的墨绿、赛博朋克的夜色）会吃掉色位，彩色部分被量化成灰。黑板按加权像素样本做中值切分（彩色像素 ×5、亮色 ×2）；赛博朋克从全部关键帧的拼图取 255 色，留 1 个透明色标记「和上一帧相同」的像素，并去掉 Pillow 每帧重复写入的局部调色板（3.8 MB → 1.8 MB）。
- 调色板的另外几条经验（新增的几种里反复出现）：
  - 小面积的点睛色（报刊拼贴的芥末黄纸片、单线画的琥珀色窗、柔光 3D 的黄球）会被量化成土黄、米黄或平色片：取调色板样本时饱和像素 ×5 左右，限定色板的画风可以把色板色强制放进调色板。
  - 大片渐变（弥散玻璃的背景、单线画的深蓝底、Synthwave 的天空）出现一圈圈色带：量化前叠一张固定的 4×4 Bayer 抖动，每帧同一张，「和上一帧相同」的透明差分照样有效。
  - 标记「和上一帧相同」的透明占位色不要用黑色：最暗的阴影像素会被当成透明，自检时大批帧对不上，改用纯品红这类画面里没有的颜色。
  - 最后一个 `stage()` 和成品完全相同时，Pillow 会把相同的帧合并，按帧数自检会报 EOFError：`save()` 前不要紧挨着再调一次 `stage()`。
  - 卡通手绘的抖线动图只抖墨线，铅笔稿和颜色不动，否则每次叠化都整片重编码，体积翻倍。
- 后来新增的十六种（岩画到刺绣徽章）动图又反复用到几条通用做法；改版的动图脚本放在各画风自己的工作目录（如 `claude_drawing/mosaic_work/`），没有进仓库：
  - 加权调色板：取样时饱和像素 ×5 左右、亮色 ×2；红、金、橄榄绿这类面积小的点睛色加权也抢不到颜色时，单独给它们留调色板位（先中值切分出约 240 色，再从这类像素里单独切 6–14 色补上；饱和色多的可按色相区等量抽样，单独分几十色）。
  - 大片渐变、深色上的反光出色带：量化前每帧叠同一张固定的 4×4 Bayer 抖动（约 ±2.4 级）。
  - 满屏网点或硬边像素（漫画网点、低多边形）缩到 720 宽时用 BOX 不用 LANCZOS，否则网点成摩尔纹、硬边出振铃，体积也更大。
  - 满屏细纹理（灰泥、石子、玻璃）每次叠化都会改掉大半像素：叠化帧里和屏上已显示颜色只差一点（约 10/255）的像素沿用上一帧、记成透明，自检按实际显示的帧逐帧比对；墓室壁画、马赛克、彩色玻璃花窗都是靠这一条（再加各自的小改动，见第三节）把动图从 3 MB 多压到 2 MB 以下。
- 这一批十五种（蓝图工程图到绘本角色动画）又多了几条：
  - 满屏几乎一种色调（X 光片的蓝胶片）时，补几个色位不够：按「主色调像素 / 其余彩色像素」两段分别中值切分（186 + 69 色）；OSD 里必须精确的纯白、纯黑、REC 红这类颜色直接强制占色位（热成像、VHS 家庭录像），否则白字被量化成淡黄。
  - 大块色层整片交接的叠化（扁平矢量的夜蓝 → 橙 → 沙）：调色板样本里加上 1/3、2/3 两张叠化帧，Bayer 只叠在两张关键帧不同的地方（整帧都叠更大；Floyd–Steinberg 更大，还会抖出透明占位色）。只有黑白两值的画风（1-bit 早期画图软件）缩小用 BOX、配固定灰阶调色板，不做中值切分。
- 描图纸叠层的动图（脚本在 `claude_drawing/overlay_work/make_gif_overlay.py`）：阶段是 关灯 → 灯变暖 → 开灯 → 底图 → 每张叠片「抬起、偏着」→「放下」→ 胶片图例卡 → 贴胶带。一张纸落下，会让一大片带纹理的区域整体变几级、线条由糊变清，逐帧精确差分要 3–5 MB。做法：目标和屏上已显示颜色的差值拆成平滑分量（模糊 2 px）和细节残差，平滑分量超过阈值（叠化帧 12 级、关键帧 3 级）或单点超过阈值（30 / 16 级）才重发，只有单点超阈值的孤立像素（纸纹在阈值上下翻动）不发；开灯那几帧逐像素精确发送，其中的叠化帧不加抖动（加了每帧每个像素都变）；最后一帧收紧阈值追平。73 帧约 1.9 MB，按解码结果逐帧自检。
- 粉彩界面的动图（脚本在 `claude_drawing/pastelui_work/make_gif_pastelui.py`）：阶段是 圆形擦除铺开底色 → 窗口弹出 → 胶囊、标题、色条、左栏、正文逐行写出 → 面板弹出 → 徽章依次打勾 / 打叉（中间放大镜从第三行飞到天气预报上）→ 三个小图标探头。会动的东西不用叠化：范例里 `move()` 给每样东西几个缓动 / 回弹的中间姿态，存成 `mv_*` 阶段，动图里每个 50 毫秒硬切，就是真运动（写字是 reveal 从 0 到 1，徽章是绕自己中心从 0.3 倍回弹到 1）；其余阶段用 70 毫秒的帧叠化。调色板先强制放进整套界面色，再按加权样本中值切分；固定 4×4 Bayer，没变的像素记成品红透明。107 帧、15.6 秒、约 0.35 MB，按解码结果逐帧自检。
- 阅卷批改的动图（脚本在 `claude_drawing/grading_work/make_gif_grading.py`）：阶段是 桌面 → 答题卡抬着淡入、两帧落下 → 标准答案卡和纸条同样落下 → 夹上长尾夹 → 五行作答逐字出现 → 两个章各「落下两帧 → 压下停 360 毫秒 → 抬起 → 拿走」→ 红笔从右下角进来，给三道计算打勾，画波浪线、圈、引线、批注、叉，划答句，在标准答案卡上打勾打叉，写分数再圈起来，每一笔之间抬笔移过去 → 笔放回得分格旁。阶段名里带时间：带 `~` 的是运动帧（硬切、不叠化），`@毫秒` 是停留时间，其余是关键阶段（停 900 毫秒，相邻两个关键阶段之间 5 帧叠化），所以章和笔是真的在动。重发规则沿用描图纸叠层的平滑分量 / 细节残差阈值；帧一张张算、不全留在内存里；调色板 180 色中值切分（饱和像素 ×5、亮色 ×2）+ 75 色只从饱和像素里切（红笔、朱红印、深蓝页眉、木章），固定 4×4 Bayer。133 帧、21.4 秒、约 1.17 MB，按解码结果逐帧自检，末帧误差和单纯调色板量化相同。
- 皮影戏的动图（脚本在 `claude_drawing/shadowpuppet_work/make_gif_shadowpuppet.py`）：阶段是 黑场 → 灯点着、光晕一圈圈铺开、闪动 → 横楣带着灯笼从上面落下，灯笼晃着亮起来 → 底带和球门从下面升上来，边升边贴紧幕布（由虚变实）→ 四个人从两边侧幕滑进来，离幕远时又虚又是双影，边走边贴上幕布 → 站定 → 同伴挑球传过去 → 球头收腿、起脚，球画一道弧穿过风流眼，青方一个跳起扑空、一个指着球，同伴摆出亮相 → 全体带一点过冲定住 → 两块小牌顺着线落下 → 灯暗一下 → 成品。全部是真运动（`~` 运动帧），一个叠化都没有；阶段名的约定和阅卷批改一样（`~` 运动帧、`@毫秒` 停留）。重发规则同阅卷批改；调色板 150 色中值切分（成品取样 ×8、饱和像素 ×5、亮色 ×2）+ 105 色只从最后几帧的饱和色和冷色里切，再做 6 轮 k-means 收短误差尾巴；固定 4×4 Bayer。61 帧、10.8 秒、约 1.75 MB，按解码结果逐帧自检，末帧误差（p99 16）和单纯调色板量化相同。点灯那几帧和结尾灯暗一下要整帧重发，是最贵的几帧（各 75–130 KB）。
- 钢笔淡彩的动图（脚本在 `claude_drawing/penwash_work/make_gif_penwash.py`）：阶段是 空桌面 → 四张白卡放下 → 第 1、2 张上墨线 → 第 3、4 张上墨线 → 第一遍淡彩 → 第二遍（鼻子、鞋、细部）→ 背景色块 → 白色水粉高光 → 放下针管笔和水笔，都是 900 毫秒 + 5 帧叠化。橡木桌本身就是饱和色，「饱和像素 ×5」会把色位都给木头，淡蓝 / 灰绿背景块被量化成灰青和米色：调色板改成 56 色只从空桌面切、198 色只从和空桌面不同的像素（卡片、墨线、颜料、笔）切（饱和 ×3、末帧 ×3），固定 4×4 Bayer，和屏上已显示颜色差不到 7 级（叠化帧）/ 4 级（关键帧）的像素沿用上一帧，末帧精确发送。49 帧、13.4 秒、约 0.77 MB，按解码结果逐帧自检，末帧 p99 误差 23。
- 复古水粉的动图（脚本在 `claude_drawing/gouache_work/make_gif_gouache.py`）：
  - 阶段：托底色 → 赭色起稿 → 背景绕开人物皴擦 → 平涂大块 → 几阶色值塑形 → 针织、罗纹、发丝、毛毡 → 腮红、鼻子、眼睛和道具（鱼、可可杯、蜗牛）→ 雨珠、热气、干笔高光 → 印刷颗粒（成品）。每段 900 毫秒 + 5 帧叠化。
  - 调色板：56 色只从托底色那帧切；186 色从和它不同的像素切（饱和 ×3、末帧 ×3）；再留 12 色，其中 3 个是强制的深中性色（不然最深的一色是毛衣藏青，瞳孔和眼皮线全变蓝），另外 9 色只从末帧误差最大（> 18 级）的像素里切。
  - 固定 4×4 Bayer。和屏上已显示颜色差不到 7 级（叠化帧）或 4 级（关键帧）的像素沿用上一帧，末帧精确发送。
  - 结果：49 帧、13.4 秒、约 1.79 MB，按解码结果逐帧自检，末帧 p99 误差 25。
- 蓝调绘本的动图（脚本在 `claude_drawing/bluebook_work/make_gif_bluebook.py`）：
  - 阶段：空白纸 → 蓝色色块（不到纸边的天空块、远树、灌木、雨衣、候车亭、水洼）→ 墨线 → 乱线暗部、草叶、靴子 → 珊瑚红点缀、腮红、芥末黄 → 白粉笔（云、熊的白毛、水纹、玻璃反光、站牌上的小巴士）→ 雨丝、水花、甩点、细尘 → 印在书上（中缝、页码、印刷的柔化，成品）。每段 900 毫秒 + 5 帧叠化。
  - 调色板：第一帧几乎只有纸白，只给它 12 色；230 色从和它不同的像素切（饱和 ×3、末帧 ×3）；再留 12 色，其中 3 个是强制的深中性色（墨线和眼睛保持黑，不变藏青），另外 9 色只从末帧误差最大（> 18 级）的像素里切。
  - 固定 4×4 Bayer。和屏上已显示颜色差不到 7 级（叠化帧）或 4 级（关键帧）的像素沿用上一帧，末帧精确发送。
  - 结果：43 帧、12.05 秒、约 1.04 MB，按解码结果逐帧自检，末帧 p99 误差 18。
- 江南园林的动图（脚本在 `claude_drawing/jiangnan_work/make_gif_jiangnan.py`）：
  - 阶段：天空和远山 → 远树和雾 → 粉墙、月洞门和茶榭 → 垂柳、白花树和对岸 → 湖面和倒影 → 九曲桥和小船 → 睡莲和白鹭 → 前景草木 → 垂下的柳丝和花枝 → 印章和收尾（成品）。每段 900 毫秒 + 5 帧叠化。
  - 调色板：第一帧（天空渐变和远山）给 40 色；200 色从和它不同的像素切（末帧 ×3），按满屏叶子和繁花的需要加权：绿色 ×2.5、白和浅色 ×2、其他饱和色（灯笼、睡莲、杜鹃）×3，满屏的绿才不出色带、白花不发灰；再留 14 色，其中 3 个是强制的深中性色（瓦缝、树皮、窗格空隙），另外 11 色只从末帧误差最大（> 16 级）的像素里切。
  - 固定 4×4 Bayer。和屏上已显示颜色差不到 7 级（叠化帧）或 4 级（关键帧）的像素沿用上一帧，末帧精确发送。
  - 结果：55 帧、14.75 秒、约 1.57 MB，按解码结果逐帧自检，末帧 p99 误差 18。
- 干刷色块的动图（脚本在 `claude_drawing/drybrush_work/make_gif_drybrush.py`）：
  - 画幅：范例是 4:3（1600×1200），墙上的动图都是 16:9。不裁画面，用纸本身把画幅加宽：左右离颜料还有 130 px 左右的空白纸，把这条纸来回镜像铺出去，纸纹和印刷颗粒接得上、看不出接缝，再缩到 720×405（画面本身在中间占 540 px 宽）。
  - 阶段：空白米色纸 → 两块大色块（滚筒刷的绿色板、青蓝色块）→ 外套和袖子 → 头（几块肤色平面、鼻子、腮红、耳朵、平头白发）→ 眼镜、胡子、筷子、近处的手 → 静物（柜台、碗和面、扶碗的手、两个瓶子、一杯茶）→ 朱红小方块 → 印刷（成品）。每段 900 毫秒 + 5 帧叠化。
  - 调色板：第一帧几乎只有纸色，只给 12 色；230 色从和它不同的像素切（饱和 ×3、末帧 ×3）；再留 12 色，其中 3 个是强制的深色（近黑的外套暗半边、眼镜框、柜台下沿的墨线），另外 9 色只从末帧误差最大（> 18 级）的像素里切。
  - 固定 4×4 Bayer。和屏上已显示颜色差不到 7 级（叠化帧）或 4 级（关键帧）的像素沿用上一帧，末帧精确发送。
  - 结果：43 帧、12.05 秒、约 0.38 MB（画面只占中间四分之三、四周多是纸，所以比别的小），按解码结果逐帧自检，末帧 p99 误差 17。
- 暮色微缩绘本的动图（脚本在 `claude_drawing/twilight_work/make_gif_twilight.py`）：
  - 画幅：范例是 2000×1100（20:11），左右各裁 22 px（只有天空和花坡，宽度的 2.2%）成 16:9，再缩到 720×405。
  - 阶段：黄昏天空（渐变、云带、光线、淡日、飞鸟、蒲公英种子）→ 夜从右边进来（夜空渐变、银河、星星、弯月、流星）→ 山（远山、拼布条纹山丘、小圆树、小屋）→ 野花坡 → 小斗篷角色、萤火虫罐和风筝 → 萤火虫 → 放大图和两行手写字（成品）。颗粒、光晕、暗角和撕纸边在 render 里加，每个阶段都有。每段 900 毫秒 + 5 帧叠化。
  - 两大片渐变（黄昏天空、昼夜交界）最容易出色带。照前面的做法（各段中值切分 + 4×4 Bayer + Pillow 按调色板量化）出的第一版，交界处是一圈圈紫 / 粉 / 黄的等高线；交界带的像素到最近调色板色的距离 p90 有 13.6 级。改法：
    - 天空一起切 136 色：一份样本里放第一帧（只有黄昏天空）、夜改动的像素（交界带，即亮度 > 0.13 的部分 ×8，比纯黑重得多）和天空 → 夜那次叠化的中间帧（×0.5）；黄昏和夜分开切时，两份调色板在交界处接不上，留下一块锯齿边的紫斑。其余 104 色从后面的阶段切（末帧 ×3、饱和 ×3），再留 14 色给末帧误差最大（> 14 级）的像素。每份都是中值切分后再做 10 步 k-means。
    - 不用 Pillow 的 quantize(palette=…)，numpy 逐像素找精确最近色（同一张调色板，天空的 p90 误差 8 → 6）。
    - 8×8 Bayer：别处 ±2.4 级，交界带（夜改动过、又不是近黑的天空）加到 ±6.4 级，调色板再密也还差几级的地方靠它抹平。
  - 和屏上已显示颜色差不到 7 级（叠化帧）或 4 级（关键帧）的像素沿用上一帧，末帧精确发送。
  - 结果：37 帧、10.7 秒、约 0.87 MB，按解码结果逐帧自检，末帧 p99 误差 16；交界带模糊 1.5 px 后和原图比 p99 7 级。
- 排线夜景的动图（脚本在 `claude_drawing/nocturne_work/make_gif_nocturne.py`）：
  - 阶段：米白纸和深色底 → 斜向的天空笔触和星星 → 远岛和火山 → 冷色的蒸汽云团 → 亮光（云被照亮、天空和山坡上的光笔触、热源）→ 熔岩细流、亮珠和火星 → 海面笔触 → 碎的倒影和光柱 → 礁石和两个小人 → 版痕、题字、辉光和颗粒（成品）。每段 900 毫秒 + 5 帧叠化。
  - 调色板：第一帧（纸和平涂的深色底）只给 12 色；228 色从和它不同的像素切（末帧 ×3），按夜景的需要加权：深蓝 ×2（占满画面，色位不够时排线变成一块块平色、天顶到地平线出色带）、饱和的暖色 ×3（熔岩、被照亮的云、倒影）、浅米色 ×1.5（题字后面的纸）；再留 14 色，其中 3 个是强制的（最深的底色藏青、题字的铅笔灰、白热的芯），另外 11 色只从末帧误差最大（> 16 级）的像素里切。
  - 固定 4×4 Bayer。和屏上已显示颜色差不到 7 级（叠化帧）或 4 级（关键帧）的像素沿用上一帧，末帧精确发送。
  - 结果：55 帧、14.75 秒、约 1.18 MB，按解码结果逐帧自检，末帧 p99 误差 18。
- 绘本角色动画的动图是真动画，不是阶段叠化：`Storybook.gif()` 按时间逐帧渲染，720×405、15 fps（GIF 延时只能写厘秒，按累计取整写成 7、7、6 厘秒交替），共用一张加权调色板 + 固定 4×4 Bayer，没变的像素记成品红透明，151 帧（动作 9.95 秒 + 末帧停 1.4 秒）约 0.56 MB；范例加 `--gif out.gif` 出这张，`--stages` 的关键帧仍可喂给上面的阶段动图工具。
- 形变动画可以直接出真动画：`Morph.at(keys, T)` 给出全局时间 T 的轮廓，逐帧渲染即可。
- 更细的逐笔动画：把一组笔画单独画到透明层上导出，再用 Motion Canvas 遮罩按顺序显现。这个还没做成现成接口。

## 五、文件

```
lib/core.py            公共底层（噪声、模糊、样条、遮罩、毛笔、字体）
lib/inkpaint.py        水墨
lib/watercolor.py      水彩
lib/papercut.py        剪纸拼贴
lib/colorpencil.py     韩国彩铅
lib/anime.py           日本动漫
lib/editorial.py       编辑风手绘
lib/oilpaint.py        油画厚涂
lib/ukiyoe.py          浮世绘木版画
lib/pixelart.py        像素风
lib/clay.py            黏土定格
lib/cyanotype.py       蓝晒
lib/stitch.py          十字绣
lib/panel.py           复古仪器面板
lib/sticker.py         贴纸拼贴 · 小票
lib/notebook.py        实验笔记本 · 贴纸
lib/chalk.py           黑板板书
lib/cyberpunk.py       赛博朋克
lib/cartoon.py         卡通手绘（逐帧手绘）
lib/isometric.py       等轴 2.5D
lib/lineart.py         单线画
lib/soft3d.py          柔光 3D
lib/morph.py           形变动画
lib/newscollage.py     报刊拼贴
lib/aurora.py          弥散玻璃（弥散渐变 · 玻璃拟态）
lib/bauhaus.py         包豪斯几何（丝网印刷海报）
lib/synthwave.py       复古 Synthwave
lib/perler.py          拼豆（钉板、熔珠小管、熨烫融合）
lib/petroglyph.py      岩画（凿刻砂岩：沙漠漆、锤击凹坑、磨刻、剥落）
lib/tomb.py            古埃及墓室壁画（灰泥、红格红稿、分栏、象形文字、剥落）
lib/mosaic.py          罗马马赛克（底稿取色、沿轮廓排石、光环、灰缝、铭牌、脱落）
lib/stainedglass.py    彩色玻璃花窗（玻璃切块、grisaille 彩绘与银染、铅条焊点、透光）
lib/illuminated.py     泥金手抄本（羊皮纸、宽头鹅毛笔哥特体、打磨金箔、尺规图解）
lib/codex.py           达·芬奇手稿（铁胆墨水鹅毛笔、左手排线、红粉笔、尖笔圆规、镜像手写、机械零件分解图）
lib/silhouette.py      剪影（黑纸剪影、薄金粉、椭圆金框、木版印花墙纸）
lib/letterpress.py     凸版印刷海报（木活字、红黑双色错版、木刻插图）
lib/constructivism.py  苏联构成主义（红黑两版、套印错位、网点照片拼贴、剪刀留边、折痕老化）
lib/artdeco.py         装饰艺术（Art Deco 流线型海报：喷枪渐变 + 遮片硬边、交替射线、阶梯高楼、3D 流线型列车、Deco 字母）
lib/comic.py           黄金时代漫画（毛笔墨线、Ben-Day 网点、四色错版、新闻纸）
lib/popart.py          波普丝网（沃霍尔式：手涂撞色平涂、错位的照相黑版、刮印的墨不匀）
lib/lineprinter.py     ASCII 字符画（行式打印机：绿条连续纸、按区域选字、叠打、色带渐淡）
lib/lowpoly.py         低多边形（1999 年代 3D：软件光栅化、平面着色、仿射贴图、逐顶点雾、15 位色抖动、点阵 HUD）
lib/stencil.py         喷漆模板涂鸦（清水混凝土墙、卡纸模板与桥、喷雾、滴痕）
lib/patch.py           刺绣徽章（牛仔斜纹、填充绣 / 缎面绣、锁边、热切边、手缝针线）
lib/blueprint.py       蓝图工程图（描图布墨线、单笔画字、制图规范、接触晒图、折痕水渍、红蜡笔批注）
lib/crayon.py          儿童蜡笔画（糙纸纸纹、宽头蜡笔来回涂、出界、蜡层堆积与压光、圆头蜡笔写字、纸上的真蜡笔）
lib/crt.py             绿屏终端 CRT（字符内存与 5×7 点阵字库、按材质和边选字、扫描线电子束、荧光余辉与烧屏、桶形畸变与光晕、米色机壳）
lib/thermal.py         热成像（温度场：物体温度、发射率、热晕、热气羽流、冷气舌、余温脚印、釉面反射；热像仪：低分辨率传感器、噪声与竖条纹、细节增强、手调曲线 / 直方图均衡、伪彩色板；读数 OSD）
lib/delft.py           代尔夫特蓝瓷砖（锡釉砖墙：刺孔粉印、钴蓝勾线与晕染、生坯到入窑、逐块错位、单块砖角饰、勾缝、开片、窗户倒影）
lib/cave.py            洞穴壁画（石灰岩洞壁、赭石与炭黑、吹喷与手印、借岩面起伏、篝火与油灯照明、钙华与熊爪痕）
lib/macpaint.py        1-bit 早期画图软件（640×360 黑白帧缓冲、8×8 图案、当年的绘图工具与文字样式、菜单 / 工具栏 / 图案板 / 窗口界面）
lib/blackfigure.py     古希腊黑绘陶瓶（拉坯轮廓 + 展开面、轮制饰带与纹样、泥釉剪影、刻线、加红加白、三段烧成、做旧、博物馆打光、饰带展开图）
lib/graphite.py        铅笔素描（素描纸纹、2H–8B 石墨、起形辅助线、轮廓、分层排线、侧锋铺调、纸擦笔、橡皮提亮、边缘只剩线稿、页边笔记与试笔色阶）
lib/xray.py            X 光片（双能衰减图：实心 / 壳体 / 圆棒管子 / 弹簧 / 侧看与正看的圆片 / 拉链螺钉电线 / 叠放衣物；比尔定律、散射、线阵条纹、光子噪声；胶片显示与安检伪彩、Zeff 与体积读数 OSD）
lib/rubberhose.py      1930 年代黑白橡皮管动画（灰色水粉背景、铅笔稿 → 描线 → 平灰上色的赛璐璐、橡皮管四肢 / 白手套 / 饼切眼、黑白胶片：颗粒、片门晃动、圆角片门、划痕灰尘）
lib/linocut.py         黑白麻胶版画（整版减法刻：V 口 / U 口刀痕、清底残刀、留黑线、一块套色错版、手拓发花、压印、铅笔签名编号）
lib/vhs.py             VHS 家庭录像（70 年代客厅：反照率 × 灯光 + 自发光、离焦图层；家用摄像机：手持倾斜、钨丝灯偏色、软膝、泛光、CCD 竖向拖影、拖尾、增益噪声、点阵 OSD；录像带：YIQ、亮度带宽与锐化光晕、色度带宽 / 隔行平均 / 延迟、噪声、时基抖动、跟踪噪带、磁头切换、掉磁）
lib/flatvector.py      扁平矢量（分层几何色块、七色限定色板、层间柔和投影、细颗粒）
lib/storybook.py       绘本角色动画（按时间取帧：带揭示图的场景层、follow 边走边画、隐式曲面角色挤压拉伸、动作编排、特效、按骨架笔顺手写、旅程总图）
lib/ballpoint.py       圆珠笔涂鸦（复印纸纹、纤维与折痕；圆珠笔：干起笔、压力线宽、断墨、墨团、收笔小钩、描两遍、压痕；彩铅斜向排线出界；圆珠笔之字排线；字体骨架重描的手写、划掉重写、无墨压痕字）
lib/overlay.py         描图纸叠层（灯箱发光、黑线灰调底图与单色叠片、透过率相乘的油墨、背光纤维云纹、抬起时的漫射模糊与投影、卷角、打孔与定位钉、套准十字、绘图胶带、透明胶片）
lib/pastelui.py        粉彩界面（纯色粉彩底与光斑、距离场抗锯齿的窗口卡片与部件、CSS 式多层阴影、带姿态的图层、真像素放大镜、圆形擦除、三个扁平小图标）
lib/grading.py         阅卷批改（绿毛毡桌、带位姿和投影的纸与卡片、答题卡部件与装订齿孔、长尾夹、带进度和时间图的红笔 / 批注 / 作答 / 印章、比尔定律红墨、立体红笔与木章道具）
lib/shadowpuppet.py    皮影戏（油灯照亮的幕布、两个灯芯；按光密度叠加的透明染色驴皮：剪、染、描边、打孔、九种镂空纹样；关节树人偶、线结、操纵杆；离幕虚化与双影；标准人偶（阳刻空脸 / 阴刻脸、雉翎盔 / 三叉冠）；牌楼球门、鞠、底部回纹带、小牌；雕花戏台、红漆金字牌匾、灯笼）
lib/penwash.py         钢笔淡彩（冷压水彩小卡：受光纸纹、不直的切边；针管笔线：手抖、出头、不闭合、描两遍、按 z 遮挡断线；淡彩：错位出线与留白缝、游走的边、干边、颗粒、平刷条纹、湿中湿、起皱；不铺满的背景色块与白边；白色水粉；呆萌小人部件；橡木桌、卡片阴影、针管笔与透明水笔）
lib/gouache.py         复古水粉（托底色的画板与纸纹；不透明水粉：鬃毛条纹、越用越干、挂在纸纹上的干笔，湿笔带起底色；毛边；穹顶光照的几阶色值塑形与球体塑形；软投影、粉状腮红、干笔高光；圆眼、大鼻子、大耳朵；V 字平针、麻花、罗纹；顺着流向的发丝、胡子、绒球、卷发；毛毡；印刷书页的颗粒）
lib/bluebook.py        蓝调绘本（直方图均衡的纸纹与 8 个方向拖开的纸纹；毛笔 / 墨铅笔线：手抖、落笔收笔、粗细起伏、笔毛含墨、越画越干、顺笔的干白道、不闭合的轮廓与再描一遍；之字乱线暗部、平行短排线、草叶；干蜡笔 / 粉彩 / 干水粉上色：错位、游走的边、干边、笔道、纸纹白点、半透明混色，墨线始终在上；毛边、不到纸边的背景色块；白粉笔；雨丝、水花、水纹、甩点、细尘；大圆脑袋、点点眼、点彩腮红、雀斑、扇贝形毛边和白毛；印刷：柔化、抬黑、中缝、页码）
lib/jiangnan.py        江南园林（叶形小笔触的 id 图光栅化：Pillow 按序号填多边形、numpy 查色表、2 倍超采样；按团块穹顶光照取色的树冠：暗底、穿出轮廓的叶、成簇的高光、最亮的几笔；花簇按明暗排序的繁花树、五瓣花的近景花枝；一绺绺细枝的垂柳、托盘松、弯曲的鸢尾叶；网格反求 (u, v) 的歇山瓦顶：筒瓦板瓦、瓦当滴水、飞檐翼角、卷脊头、檐下阴影；粉墙、叶影、方格 / 灯笼锦 / 冰裂纹槅扇、挂落、月洞门和漏窗、石作、台阶、针孔相机投影的九曲桥；湖面、按岸线镜像的倒影、自带倒影的桥船白鹭、横向笔触、涟漪和细竖纹、睡莲；红灯笼、匾额、小红印；柔化、光晕、颗粒）
lib/drybrush.py        干刷色块（笔刷坐标系：遮罩转到笔触方向再算、再转回；周期的鬃毛条纹 / 干笔齿 / 滚筒细点 / 梳齿边 / 笔道 / 斑驳纹理；一道道平行的笔或打断的短笔：起笔饱满、收笔干枯、梳齿般的两端、近直的两侧、皴擦、顺笔两侧的干擦边、多遍覆盖、同笔混色、蘸满的笔；滚筒大色板和细刮痕；部分撕口带纤维边的纸片；沿路径的干笔和散撒的短干笔；几块面拼的人物：头、眼镜、白胡子、外套、袖子、手；瓶、碗、杯；朱红小方块；胶印收尾：柔化、纸纹、暗部白点、细尘）
lib/twilight.py        暮色微缩绘本（被噪声扰动成软层的六段黄昏渐变、透镜形云带、光线和淡日；羽化的夜度场：按它铺夜空、银河、星星和月亮，交界补饱和度，后面受光的东西按它压成月光蓝，发光的东西不受影响；解析的银河带和暗带、幂律星场、亚像素溅射、四芒星、弯月、流星；远山、拼布条纹山丘、细垄、树篱、小圆树；按透视拒绝采样的花坡：八种花和草叶，按根部排序一次光栅化进 id 图；小斗篷角色、萤火虫罐、风筝和随天色变色的风筝线、萤火虫、蝴蝶、蜻蜓、蒲公英种子、飞鸟、带穗高草；3 倍图上的细墨线、排线、尺寸标注、比例尺、淡彩、圆形放大图；逐字母抖动的手写小字；柔化、光晕、颗粒、暗角、撕纸边）
lib/nocturne.py        排线夜景（直方图均衡的纸纹与沿 8 个方向拖开的纸纹；在方向场里积分出中心线的短笔触：落笔钝、收笔尖、带一点弯；id 图光栅化：Pillow 按序号填轮廓、2 倍超采样，numpy 逐像素查回这一笔的位置和方向，算出沿笔 / 横向坐标、6 道笔毛的深浅与含量、越往笔尾越干、颜料只落在纸纹低于压力处；每笔的明度抖动和绕灰轴的色相旋转；风向、放射、等高线方向场与双倍角混合；点光源和发光遮罩合成光照图，加光（screen）或「光 × 受光」上色的光笔触，暖白化；放射笔触的热源；带惯性游走的蜿蜒细流、分股、支流、结壳的亮度和前锋亮珠，2 倍浮点发光缓冲与紧贴的光晕；抛物线火星、零星火星、星点；镜像取样的碎倒影、光柱；笔触画的剪影和朝光轮廓光、几十像素高的坐着的小人和围巾；米白纸边、纤维、胶带边、压印版痕、细体铅笔小字；画心内的克制辉光、细颗粒）
examples/*.py          范例脚本；*.jpg 成品；drawing_*.gif 逐步画出的动图
中文字体：自动找 Kaiti/Songti（macOS）、Noto CJK（Linux）、KaiTi/SimSun（Windows），或设 INKPAINT_FONT
西文字体（后来新增的画风用）：core.latin_font(style) 按 sans / sans_bold / rounded / script / hand / typewriter 等找系统字体，可用 INKPAINT_FONT_<STYLE> 指定；字体文件不要放进仓库
```