weike-zhang/architecture-canvas

这是什么？

核心功能

• 01通过对话从上传的文档、表格、PDF 和图片生成架构图。
• 02基于 Excalidraw 的可编辑画布，支持拖动、改字、撤销和导入。
• 03可导出 SVG、PNG 以及包含图片的可编辑文件。
• 04修改方案需确认后才生效，选中的组件可固定位置。
• 05仅在本机 127.0.0.1 运行，每个会话数据保存在本地工作区。
• 06提供 Python SDK 和 MCP stdio 服务，便于嵌入渲染和文档读取能力。

适用场景

• 将需求文档快速转化为系统架构图初稿。
• 在保留手动排版的前提下，通过对话持续修改已有架构图。
• 在本机处理资料并产出可编辑的架构图，无需使用托管的在线编辑器。
• 通过 MCP 为 AI Agent 添加文档读取和图表渲染工具。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/weike-zhang/architecture-canvas.git
2. 2

   进入项目目录

   cd architecture-canvas
3. 3

   启动应用（首次运行会安装依赖并构建页面）

   python3 start.py
4. 4

   在浏览器中打开工作区，并在“模型设置”中配置模型

使用前须知

• !当前为本机运行的 Alpha 版本，仅监听 127.0.0.1，不含多用户账号。
• !对话、文件理解和图表生成需要支持工具调用的模型服务及 API Key。
• !生成通常不超过 22 个组件，不支持时序图、ER 图和复杂分支流程。

标签

常见问题

architecture-canvas 是什么？

本机运行的架构图工作区，通过对话读取上传资料，生成并修改可编辑的 Excalidraw 架构图。 Architecture Canvas 可以上传需求文档、表格、PDF 和图片，由 AI 助手阅读这些资料后生成架构图初稿。图形保存在可编辑的 Excalidraw 画布上，可以拖动节点、修改文字，并导出 SVG 或 PNG。

architecture-canvas 可以免费使用吗？用的什么许可证？

architecture-canvas 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

architecture-canvas 还在维护吗？

活跃维护中。architecture-canvas 最近一次提交是在 2026年10月3日。

architecture-canvas 适合用来做什么？

将需求文档快速转化为系统架构图初稿。 在保留手动排版的前提下，通过对话持续修改已有架构图。 在本机处理资料并产出可编辑的架构图，无需使用托管的在线编辑器。 通过 MCP 为 AI Agent 添加文档读取和图表渲染工具。

architecture-canvas 怎么安装和运行？

克隆仓库: git clone https://github.com/weike-zhang/architecture-canvas.git 进入项目目录: cd architecture-canvas 启动应用（首次运行会安装依赖并构建页面）: python3 start.py 在浏览器中打开工作区，并在“模型设置”中配置模型

在哪里获取 architecture-canvas？

源代码和安装说明在 GitHub 上：https://github.com/weike-zhang/architecture-canvas