阿拉丁·架构图工坊

你在解决什么问题

写代码不难，但「给老板一张架构图」「把模块依赖讲清楚」「需求落成时序图」「库表画 ER」往往要手敲 Mermaid，括号不配平还会在 GitHub 上渲染失败。市面很多工具只做文本→单一流程图，不扫真实代码、不做多图型、也不在本地校验语法。

技能如何工作

阿拉丁·架构图工坊把画图收成一条纯本地链路（Python 标准库，脚本本身不出网）：

• 多源输入：自然语言需求（落成 ir.json）、代码目录、现有 .mmd / .puml / .dot，或简单流程文本，统一成中间表示。
• 六类工程图：架构（含 C4-lite / 模块依赖与子图）、流程、时序、类、状态、ER。
• 代码→架构图：扫描 py / js / ts / java / go，以文件为模块、import / require 为依赖边，自动生成模块依赖图。
• 本地语法校验：生成后检查括号、子图、节点引用等，给出可定位的错误行。
• 多格式导出：.mmd、.puml、.dot、自包含 diagrams.html 预览，以及可贴 README 的嵌入块；图源可接 omni-deck-studio 做 PPT 页。
• 设计偏好闭环：校验与格式选择沉淀到本地 diagram_playbook.json，下次 --playbook 可套用历史习惯并附带易踩坑提示。

典型流程：定输入 → 生成图源 → 校验 → 导出；需要时再用 playbook 复用偏好。

适用边界

• 产出的是可编辑文本源，高保真品牌配图、拖拽白板、业务统计图（柱线饼）不在范围内。
• 代码扫描是静态 import 级依赖，不含运行时调用或反射；提交前建议 git diff，避免把临时或 vendored 目录画进图。
• 完全离线时 HTML 里的 Mermaid 可能依赖浏览器侧 CDN；脚本侧仍不联网。涉密环境请先确认本地留痕与合规策略。