用途:在 Draw.io/diagrams.net 中制作或重设计可编辑的蛇形路线图,用连续 S 形路线承载密集学习内容,所有标签、轨道与分类均可编辑。适合海报式双色轨道知识地图;若需演示卡片可选 drawio-roadmap-ppt,若需严格学习顺序与泳道可选 drawio-roadmap-swimlane。
主要能力:定义路线顺序并分为 3–6 个主要阶段;每段水平路线限 3–5 个等宽列;每个 U 形转弯处交替阅读方向。外层车道放阶段标签,相邻内层放分类标签,知识条目置于路线之间的白色走廊,每条一行,使用统一优先级标记(如 A 必需、B 了解),每类 2–5 条。
使用方式:创建或改样式前先阅读 references/snake-style.md,可参考 assets/python-learning-snake.drawio 的布局、色带堆叠与弧线构造。先替换标题与条目,再改轨道几何;在直线段增删整列模块。转弯必须用原生 mxgraph.basic.arc 顶点构建,右 U 形用 startAngle=0;endAngle=0.5,左 U 形用 startAngle=0.5;endAngle=1,禁止用自动曲线边、嵌入图片、堆叠圆角矩形或白色遮罩。完成后在 Draw.io 中检查每个切点、颜色边界与转弯,并运行 python3 scripts/validate_snake_roadmap.py <file.drawio>。
限制与要求:直线色带保持同一车道厚度,相邻车道中心线相距一个车道厚度减 1–2 px;成对车道共用转弯圆心,内半径等于外半径减车道间距;直线段与转弯相切,相邻色带重叠 1–2 px 防抗锯齿缝隙;直线带矩形需置于弧线单元之上。视觉上使用白底与高饱和路线色,路线标题 24–30 px、条目 18–22 px,条目行间距至少 24 px,50% 缩放仍可读。交付可编辑 .drawio 源文件与内联预览;若预览与源文件不一致,应修正源文件。其他收费、平台与效果信息暂未提供。