仅生成测试文件，不连接设备、不改固件、不上传 SD、不测量颜色。目标为当前这块 HINK-T037A02-A1 / EPD037A02（JD7601）：驱动原生 720×480，观看 480×720 竖屏、排线下。历史 testicon 圆点左上是已验收方向；这里的左上圆点和不对称 L 用于继续核对，工具生成通过不代表硬件重新验收通过。
在仓库根目录、现有 Python 3.12 + Pillow 环境运行：
python tools/epd-panel-lab/panel_lab.py
python tools/epd-panel-lab/panel_lab.py --codes-per-page 16 --frames 12
python tools/epd-panel-lab/panel_lab.py --codes-per-page 64 --output .output/panel-lab-single-page
默认输出到已被仓库忽略的 .output/panel-lab/。默认 5 个 .film：ColorQual、ColorFast 各两页（每页 32 编码），MonoFast 一个 12 帧文件（518432 字节）。色卡每页有 PNG；MonoFast 每帧有 PNG。只用现有 Format 0x02 / 0x03 / 0x01，不添加波形。生成相同选项可重跑，单个文件临时写入后替换，manifest 最后写入；中断后重跑即可。换分页选项建议换输出目录，旧生成物不会自动删除；要彻底清理，删除指定输出目录。以本次 manifest 的文件列表为准。
X 表示不在当前 Web 候选列表中。X 也绘制到 .film，保留周围平坦编码区域供测量；取样时避开字、边缘和 X 笔画。占位/非候选格不会被替换为白色，也不会隐去。tools/ForFilm/js/convert.js 读取 CF_PALETTE_QUAL / CF_PALETTE_FAST 纯数字数组和各自候选列表，用 ast.literal_eval 解析数字，不执行 JavaScript。仅支持当前明确的数组结构；上游改成动态表达式会给出诊断，需相应更新读取器。当前 Web 的 measured/calibrated 变体未用于本工具默认预览。manifest.json 保存面板身份、尺寸、Format、frameCount、完整预览 RGB、候选范围、色板源文件 SHA-256，以及每个 film/PNG 的大小和 SHA-256；MonoFast 另保存每帧主体 SHA-256。它是生成物说明，不是颜色测量报告。源码核对入口：docs/film/film.md §10、Web tools/ForFilm/js/animation.js 的 animPortraitToGrid / animPixelIndex / animMonoBit / animBuildFilmFile，以及 Flutter app/flutter_app/lib/frame_codec.dart 的 packFramePixels 与 app/flutter_app/lib/animation_film.dart 的 assembleAnimationFilm。
portrait (px,py) 到 native (719-py,px)，native 行优先索引为 px*720 + 719-py。Web portrait 先逆时针转到720×480逻辑画布，再按动画打包时180°落位，得到同一映射。两种彩色和 MonoFast 共用 native_image()，PNG 直接来自转换前的同一画布。原生头尺寸是720×480，不能因观看竖屏而写成480×720。
32字节头为 little endian：bodySize@0、width@4、height@6、ColorCount@8、Format@9、FrameCount@10，保留位与v2色表填零。单帧 frameCount=1（协议允许0或1），多帧直接拼主体，等同 Web 动画工坊。Flutter 单帧 indexed 写0、Mono写1且ColorCount=2；其动画拼接沿用首帧，均在协议允许范围。工具统一使用 Web 动画工坊的 unused ColorCount=0。Mono 行宽720可整除8，MSB-first、1黑0白。
12帧移动实心块加反转棋盘，含 WW/WB/BW/BB 四类像素转移。固定方向标记与静止区域保留。文件没有 FPS/时长字段，实际帧率由设备播放逻辑和刷新耗时决定。它用于短小的传输/差分刷新对照，不是物理流体模拟。
冷启动第一帧与预热后的差分帧是不同基准。 记录首帧、后续帧、此前画面/刷新模式、温度与设备日志；不要把一次预热循环的结果当成冷启动性能，也不要仅凭 PNG 判断真实颜色或残影。重新上机时先确认圆点确在左上、排线下，再记录各编码的实际表现。
python -m py_compile tools/epd-panel-lab/panel_lab.py tools/epd-panel-lab/test_panel_lab.py
python -m unittest discover -s tools/epd-panel-lab -p test_panel_lab.py -v
单个集成测试覆盖头/大小/哈希、Qual与Fast逐格64编码覆盖、非对称左上单点映射、Mono位序、帧间差异、四类像素转移。测试生成文件置于临时目录；不运行全仓测试、不替代实屏验收。
先完成开源源码调查后才添加此候选。仅供启用 CONFIG_ARK_EPD_ABC_DIAG=y 的实验固件，默认关闭；详细来源与边界见 同屏文档。不连接设备、不自动上传、不改 palette/profile。
python tools/epd-panel-lab/abc_diag.py --output D:/dev-tool/FrameFilm-build/abc-diag-fixtures
python tools/epd-panel-lab/abc_diag.py --all-b --output D:/dev-tool/FrameFilm-build/abc-diag-all-b
python -m py_compile tools/epd-panel-lab/abc_diag.py tools/epd-panel-lab/test_abc_diag.py
python -m unittest discover -s tools/epd-panel-lab -p test_abc_diag.py -v
默认四个单帧 Format2：abc-reuse-a.film、abc-rewrite-a.film、abc-constant-b0.film、abc-constant-b7.film。每份345632字节，每页保留64个相同位置的A/C码块、原X标记和方向标记，页头区别mode/B。abc-manifest.json 记录参数、SHA256、标记、方向和4次REF合同。--all-b 共生成10份（8种B加2个控制），不自动上传。临时文件替换/重跑及输出清理方式与上面的原生成器相同。
实验标记只写native主体第0字节（文件offset32），编码为 (mode << 3) | B，对应portrait (0,719)，不是左上角圆点。mode0=原A,A,C复用RAM；mode1=第二相前额外重写A；mode2=第二相前写常量B。mode>2在实验HAL中拒绝，但普通Format2首像素仍可能碰巧命中0..2，因此不得把诊断固件作为日常固件使用。结束恢复正常固件，正常配置未启用时文件仍只是普通Format2。
每次实验强制full clear后做原Qual三次REF，总计4次REF；LUT、寄存器和电压设置不改。mode1/2额外172800字节RAM传输会改变上电停留时隙，不能宣称完整时序不变。先比较原序列与重写A控制，再少量比较B0/B7；确认影响后才扩展八B。PNG仅按现有ColorQual A/C色板帮助定位，不是新B的颜色预测。采样避开文字、边框、X、metadata像素；512组合不承诺512可辨色。生成合同测试不替代烧录、真实显示或颜色测量。
abc9_lab_io.py 只负责离线打包：私有单帧 Format 0x7F，32 字节头的 reserved offset12..15 为 ASCII ABC9，native 尺寸720×480、FrameCount=1。主体逐像素为 little-endian uint16，只有低9位有效，编码 (A<<6)|(B<<3)|C，其余高位必须为0；主体691200字节，含头总长 691232字节。portrait→native沿用上文旋转映射。这不是公开 film 格式，仅供默认关闭的 CONFIG_ARK_EPD_ABC_DIAG=y 实验固件使用。
camera_palette_lab.py compare 的64编码对照是 A,A,C rewrite-A（mode1）：第二相重新写A，与ABC9逐相写A/B/C具有相同RAM传输次数。它不同于原始ColorQual mode0的第二相复用RAM；不能把mode1对照描述成原厂原时序。control的portrait (0,719) 被设为索引8以选择mode1，该单像素属于诊断metadata。
分析依赖 Pillow、NumPy、OpenCV和SciPy。先准备manifest与四角文件，路径以manifest所在目录为基准：
{
"control": "rewrite-a.png",
"pages": {"0":"b0.png", "1":"b1.png", "2":"b2.png", "3":"b3.png", "4":"b4.png", "5":"b5.png", "6":"b6.png", "7":"b7.png"},
"repeats": [{"B":4, "path":"b4-repeat.png"}],
"captureSettings": {"source":"UI-verified-video", "ISO":1250},
"sidecar": "capture-evidence.json"
}
四角JSON使用 {"innerScreenCorners":[[xTL,yTL],[xTR,yTR],[xBR,yBR],[xBL,yBL]]}，坐标是EXIF转正后照片的内屏四角，所有帧共用同一四边形。captureSettings 记录实际观察到的固定曝光、ISO、白平衡等声明；UI-verified-video 表示视频UI观察来源，不代表独立验证传感器参数。sidecar可为相对JSON路径或内联对象。视频取帧需自行记录连续流、稳定画面区间及median/averaging方法；本工具不采集视频、不控制相机。
python tools/epd-panel-lab/camera_palette_lab.py analyze --manifest capture/manifest.json --corners capture/corners.json --output .output/camera-palette
python tools/epd-panel-lab/camera_palette_lab.py compare --palette .output/camera-palette/experimental-palette.json --image photo.jpg --crop 0 0 480 720 --output .output/camera-compare
analyze 按A行/C列采样八张固定B页，生成512组合记录；用同一control暗/白锚做线性RGB两点归一化，不逐页拉伸。单通道高/低端截断只记 qualityWarnings；全通道截断可排除候选，但指定control黑/白baseline保留并标注censored，黑锚不因low-signal丢失。被截断的暗部/高光差异无法恢复。空间MAD、重复差异和近重复阈值都是启发式诊断；greedy去重与顺序有关，不证明可辨色数量。缺失EXIF不会被当作曝光或白平衡已验证。
compare 把源内容视为 nominal sRGB目标，不对源图应用面板暗白锚。显式crop在源图EXIF转正后的坐标内，同一个crop用Pillow LANCZOS缩放到480×720，两条路径均用近似Lab欧氏最近邻、不抖动。source-target-srgb.png 保存目标图；两份simulated PNG只用于相对比较。panel候选仍是control归一化后的camera-relative近似，JPEG/视频处理、照明、视角、固定参数误差及相机未经表征均限制结论，不能宣称绝对校色、精确面板sRGB或512个稳定有效颜色。
最小离线检查（不连接设备、不构建固件）：
python tools/epd-panel-lab/camera_palette_lab.py self-test
python -m unittest discover -s tools/epd-panel-lab -p test_abc9_lab_io.py -v
这些检查仅验证合成数据和打包合同，不构成实机显示或颜色验收。
captureSettings.source 也支持 DirectShow-UVC-readback，用于记录标准驱动控制的Get/Set读回；它不补造EXIF，不代表独立sensor或色度校准。repeatCoverage 明确B0..7实际重复次数。measurementDiagnostics 基于全部512组未裁剪cameraRGB做nominal sRGB近似Lab诊断；原 usableCandidateCodes/nearDuplicateDiagnostics 继续属于render-normalized出图空间。二点拉伸可能把不同暗色裁成同黑，因此不得用预览零距离或候选数量判断物理色数上限。
abc512_render.py 使用共享控制白点增益、control+ABC全部观测最低亮度到白点的共同目标，不减面板黑锚；两套palette在同一目标下做白点适配后的线性cameraRGB最近邻。--dither 可选误差限幅蛇形FS，--error-limit 默认0.08（线性通道单位）。minimum暗端对噪声敏感，相机未经表征；manifest完整保留raw、重复诊断、生成哈希和共享映射。文件名中的512表示最多512种ABC编码，不是已验证的物理有效色数。
python tools/epd-panel-lab/abc512_render.py --palette .output/camera-palette/experimental-palette.json --image photo.jpg --crop 0 0 480 720 --output .output/abc-render --dither
python -m pytest tools/epd-panel-lab/test_abc512_render.py -q
输出control64为现有Format2、marker8的rewrite-A对照，abc512为私有ABC9。只生成文件，不连接设备。实机结果及未达成512稳定色的原因见 实验结果。
abc_spatial_render.py先对实测联合F(A,B,C)做SciPy Delaunay重心分解，再用标准Bayer8选择完整tuple、拆出三张0..7相位图。不会独立随机化各相，也不增加物理REF。生成nearest、FS和mixture三个同源、同色板、同凸包目标的比较；相位灰度PNG只显示LUT选择码，不能当作中间光学颜色。
python tools/epd-panel-lab/abc_spatial_render.py --palette .output/camera-palette/experimental-palette.json --image photo.jpg --crop 0 0 480 720 --output .output/abc-spatial/photo
python tools/epd-panel-lab/abc_spatial_render.py --palette .output/camera-palette/experimental-palette.json --chart --output .output/abc-spatial/chart
python -m pytest tools/epd-panel-lab/test_abc_spatial_mix.py -q
--chart是512个nominal sRGB目标色块，不是512种已验证的实物颜色。--fs-error-limit 1可比较较宽FS误差范围，默认0.08。完整方法、参考项目、预览与验收限制见 联合三相空间混色。
--bayer-size 16使用更细的面积权重，默认8。本轮同一512目标卡中，Bayer8有两组编码图案合并，Bayer16的512个编码图案均不同；这个软件结果不是实测物理色数。两种大小均先选完整tuple，再拆A/B/C，保持原物理三相。
epd_source_fit.py在联合量化前对源图做CIE明度全范围拟合，以及独立、默认关闭的暖色彩度收缩。abc_spatial_render.py --range-strength 0..1 --warm-strength 0..1默认均0，精确保留旧baseline；不裁测量palette或百分位尾部。
tone_preview.py提供本机实时三列对照，使用完整480×720算法，合并连续参数输入并丢弃过期响应；导出只使用已显示的参数快照。缓存限12项、可清理，换palette/源图文件后需重启服务。默认暖色关闭，UI测试时可单独开启。
python tools/epd-panel-lab/tone_preview.py --palette path/to/experimental-palette.json --image photo.png --crop 0 0 480 720 --output .output/tone-exports --port 8775
python -m pytest tools/epd-panel-lab/test_epd_source_fit.py -q
仅为实验出图和预览，生产Film/头像仍未启用新处理；通行证继续原彩色快刷。方法、实屏结果与限制见 本屏明暗拟合。