用途:在 Draw.io 中制作学习路线图与结构化图表,呈现干净、现代、完全可编辑的 PPT 视觉风格。适合演示用的阶段卡片(3–7 个节点);若需严格学习顺序、单元标题加副标题与泳道,改用 drawio-roadmap-swimlane;若需密集海报式 S 形双色知识地图,改用 drawio-roadmap-snake。不确定时先询问用户想要哪种风格。
主要能力:支持横向阶段路线(顺序学习计划与时间线)、纵向流程(步骤与决策路径)、中心辐射(主题地图)、网格(对比或独立分类)、分层(系统与归属)。
使用方式:先明确图表信息、受众、阅读方向与最终画布;将内容压缩为一个标题、3–7 个主节点、简短辅助文字与明确关系;设计前阅读 references/visual-system.md,直接编辑 XML 时阅读 references/drawio-xml.md;卡片式路线图可复用 assets/python-learning-ppt.drawio 并替换内容、调整阶段数量;生成未压缩的 .drawio 文件,使用稳定且具描述性的 cell ID;产出 SVG 预览,本地可转换时再产出 PNG;运行 python3 scripts/validate_drawio.py <file.drawio>;按正常观看尺寸检查预览并迭代。
内容规则:以一个明确结论开头;主阶段限 3–7 个;阶段标题 4–10 个中文字或 2–5 个英文词;描述尽量一行;每卡 2–4 个动作与一个可衡量里程碑;并行项视觉权重相等;顺序优先用位置、其次用箭头;删除不表达层级、分组、状态或方向的装饰。
输出规则:以可编辑 .drawio 源文件为主要交付物;使用 mxfile > diagram > mxGraphModel > root,cell 置于 parent 1 下;背景与容器先于子标签;卡片、标签、徽章、连接线尽量用独立 cell;文本形状使用 html=1;whiteSpace=wrap;;转义 XML 保留字符,换行编码为 <br>;重要内容保持在 60–100 px 安全区内;不依赖常见系统缺失的字体或字重。
视觉检查:三秒内可读出标题与阶段顺序;卡片对齐且等大(除非有意区分层级);独立对象间距至少 24 px,卡片内边距 28–40 px;文字不贴边、不别扭换行、卡内层级不超过两级;每阶段一个饱和强调色,多数表面用中性色;箭头置于卡片之后、对齐节点中心且视觉更弱;同一颜色代表同一阶段或语义;检查浅色标签与深色面板对比度;50% 缩放仍可读。若无法渲染预览,需校验 XML 并说明视觉检查尚未完成。
交付:返回 .drawio 源文件链接、可用的内联 PNG 或 SVG 预览,以及一句话说明布局与编辑方式;除非用户要求,不堆砌实现细节。