Excalidraw AI生成微服务治理全景图-编程阁

Excalidraw AI生成微服务治理全景图

在一次跨部门的架构评审会上，团队花了整整一小时才理清新上线的服务依赖关系——不是因为系统多复杂，而是没人能拿出一张准确、实时更新的架构图。开发说图在Confluence里，运维说那版早就过时了，而产品总监盯着投影屏上手绘风格的示意图，一脸困惑：“这个‘库存服务’到底被多少个模块调用？”

这并非孤例。如今一个中等规模的微服务系统动辄拥有数十甚至上百个服务，注册中心里的实例每分钟都在变化，而文档却常常滞后数周。我们有强大的监控工具追踪每个请求，却缺乏一种轻量、敏捷、能跟上迭代节奏的方式来“看见”整个系统。

正是在这种背景下，Excalidraw + AI的组合悄然成为许多技术团队的新选择。它不追求完美渲染或工业级建模，而是用“够用就好”的手绘草图风格，配合自然语言驱动的智能生成能力，让架构图从“静态文档”变成了“可对话的设计资产”。

想象一下这样的场景：你刚参加完需求会，在聊天窗口输入一句：

“画个图：用户登录后访问商品页，下单走订单→库存→支付链路，所有服务都注册在K8s。”

几秒钟后，一个结构清晰、带箭头连线和分组框的微服务拓扑图就生成了链接，点击即可打开编辑。这不是未来，而是今天就能实现的工作流。

其核心并不神秘——Excalidraw 的开放数据模型 + 大语言模型的语义理解能力，构成了这套“对话式架构设计”的底层支撑。

Excalidraw 本身是个极简的在线白板工具，但它有几个关键特性让它与众不同：第一，所有图形数据以明文 JSON 存储；第二，支持插件扩展和脚本化操作；第三，采用 Rough.js 实现的手绘风格让图表看起来更友好、更易接受修改，避免了“正式图纸”带来的权威感压迫。这些看似微小的设计取舍，恰恰为自动化集成铺平了道路。

当你把一张架构图导出为.excalidraw文件时，其实得到的是一个包含elements数组的 JSON 对象，每个元素都有明确的类型（矩形、箭头、文本）、坐标和样式属性。这意味着，只要你的程序能输出符合格式的数据，就可以“画图”。

{ "type": "excalidraw", "version": 2, "elements": [ { "id": "A1", "type": "rectangle", "x": 100, "y": 100, "width": 80, "height": 40, "text": "UserService" }, { "id": "B1", "type": "arrow", "points": [[180, 120], [240, 120]], "endArrowhead": "arrow" } ] }

这段数据完全可以由代码动态生成。比如，我们可以写一个 Python 函数来创建服务节点：

def generate_service_node(name, x, y): return { "id": f"svc_{name}", "type": "rectangle", "x": x, "y": y, "width": 100, "height": 50", "text": name, "strokeColor": "#333", "backgroundColor": "#f0f0f0", "seed": hash(name) % 1000000 }

再配合一个生成箭头的函数处理调用关系：

def generate_call_arrow(src_x, src_y, dst_x, dst_y): return { "type": "arrow", "points": [ [src_x + 100, src_y + 25], [dst_x, dst_y + 25] ], "endArrowhead": "arrow" }

接下来的问题是：如何从一句话变成这些坐标和连接？

这就轮到 AI 上场了。与其训练专用模型，不如直接调用大语言模型（LLM）来做这件事。你可以把它看作一个“架构翻译器”：输入自然语言描述，输出结构化的服务拓扑。

例如，给 LLM 提示：

请解析以下微服务描述，提取服务名称和服务间调用关系： “用户服务调用认证服务和订单服务，订单服务调用库存服务和支付服务。” 以JSON格式返回结果： { "services": ["UserService", ...], "calls": [["UserService", "AuthService"], ...] }

大多数主流 LLM 都能准确完成这类信息抽取任务。拿到结果后，剩下的就是布局算法的事了。

简单的线性排列容易重叠，也不美观。更好的做法是引入有向无环图（DAG）布局逻辑。虽然 Excalidraw 没有内置布局引擎，但可以借用 Graphviz 的dot算法预计算节点位置，再映射到画布坐标系中。例如：

import graphviz def compute_layout(services, calls): dot = graphviz.Digraph() for svc in services: dot.node(svc) for src, dst in calls: dot.edge(src, dst) # 渲染并获取节点位置（需启用layout输出） layout_data = dot.pipe(format='json').decode('utf-8') return parse_positions_from_json(layout_data) # 自定义解析函数

这样生成的图表不仅结构清晰，还能自动避让、层级分明，接近专业工具的效果。

但这套方案真正的价值，不在“自动生成”，而在“持续同步”。

很多团队尝试过将服务依赖可视化，但最终都败给了维护成本。而 AI + Excalidraw 的模式提供了新的可能性：把图表生成变成流水线中的一个步骤。

设想这样一个 CI/CD 流程：

开发提交代码，触发构建；
扫描代码中的@FeignClient或 gRPC 调用，提取依赖关系；
调用本地部署的 LLM 解析语义，生成拓扑数据；
调用布局引擎计算坐标，生成.excalidraw文件；
将新文件提交至文档仓库，并附带变更摘要：“新增物流服务，订单服务新增对其调用”。

每次发布都留下一张“架构快照”，无需专人维护，也不会遗忘。故障排查时，只需对比前后两张图，影响范围一目了然。

更进一步，还可以对接注册中心（如 Nacos、Consul），定时拉取实时服务列表，生成“当前系统状态图”。当某个服务突然消失或新增大量调用方时，图表颜色自动变红预警。

当然，这套方法也有需要注意的地方。

首先是输入质量。纯自然语言虽灵活，但歧义多。实践中建议采用“半结构化输入”提升稳定性，比如：

services: - AuthService - OrderService - PaymentService calls: - AuthService → UserService - OrderService → InventoryService

这种格式既便于人工编写，也利于机器解析，准确率远高于自由文本。

其次是安全问题。涉及核心架构的信息不应通过公有云 API 传输。理想做法是在内网部署轻量级开源模型（如 Qwen、ChatGLM3-6B），确保敏感数据不出域。

最后也是最重要的一点：AI 生成只是起点，不是终点。再聪明的模型也无法替代人的判断。Excalidraw 的优势在于，它生成的图永远是“可编辑的”。任何人都可以拖动节点、添加注释、圈出重点区域。这种“人机协同”的模式，反而促进了团队共识的形成——毕竟，一张谁都能改的图，比一份只由架构师签字的PDF更容易达成一致。

某金融科技公司在落地该方案后反馈：原本每月花8人日维护的架构文档，现在压缩到0.5人日；重大故障复盘时，平均节省40%的时间用于梳理调用链路；更重要的是，产品经理开始主动查看最新生成的拓扑图来理解系统边界。

这或许才是技术演进的本质：我们不需要更复杂的工具，而是需要能让更多人参与进来的设计方式。Excalidraw 的手绘风格消除了距离感，AI 的语义理解降低了门槛，两者的结合，正在让“系统可视化”从一项专业技能，转变为团队共享的认知基础设施。

未来的某一天，也许我们真的能做到：提交一段代码，系统自动更新测试用例、部署策略、监控规则，以及——那张人人都看得懂的架构图。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考