CanvasAnvil is an open source AI diagram maker and flowchart generator - an infinite-canvas diagram editor and self-hosted drawio alternative that writes editable .drawio files. Text to diagram, then fix nodes, layout and labels in place. Also AI presentations, interior design CAD/BOM, posters and infographics.
TypeScript ai-agentsai-diagramai-presentationbomcadcanvasdiagramdiagram-generatordrawioflowchartinfographicspptppt-generatorpresentation-generatorreactsvgedittext-to-diagramtypescriptworkflow
交接文档
版本 v2.2.0 · 2026-10-26。详细架构见 architecture.md。
一句话
CanvasAnvil 是一个 AI 多画布创作平台:Vite + React 前端、一个很小的 Node API,四个画布共用一套外壳、UI 组件和模型调用。
| 画布 | 代码目录 | 说明 |
|---|---|---|
| 图表绘制 | client/workspaces/diagram |
draw.io 图表,走流式 /api/chat |
| 室内设计 | client/workspaces/cad |
分析图、2D 图纸(svgedit)、效果图、物料清单 |
| PPT 演示 | client/workspaces/ppt |
先大纲后生图,导出 PDF / 图片版 PPT |
| 自由画布 | client/workspaces/canvas |
Excalidraw 白板,文生图 + 圈画标注改图 + 版本条 |
跑起来
npm install
npm run dev # http://127.0.0.1:8001,API 和前端同一个进程
npm run check # TypeScript
npm run lint # ESLint,目前 0 错误
npm test # 458 个测试,全部通过
npm run build # 生产构建
模型配置在页面右上角「设置」里填:文本模型和生图模型各一组 Base URL / Key / Model,任何 OpenAI 兼容接口都行。部署见 deploy/README.zh-CN.md。
去哪里改
- 加画布:
client/app/workspaces.ts加一项,门户在client/pages/portal/补卡片和详情页。 - 加接口:
server/routes/加文件,再在server/http/routes.ts登记一行。 - 改提示词:
resources/prompts/<画布>/*.md(服务端运行时读取);PPT 生图提示词在client/workspaces/ppt/lib/ppt-service.ts。 - 改文案:全站和 CAD / PPT / 自由画布在
client/shared/i18n/messages.ts,图表画布单独在client/workspaces/diagram/lib/translations.ts。中英文必须成对写,不要在组件里写死中文。 - 模型调用:浏览器侧统一走
client/ai/client.ts→/api/ppt-ai;图表画布走/api/chat。
必须遵守的约定
- 存储键名不能改。 localStorage / IndexedDB 的键名(含
next-ai-draw-io-前缀的那批)承载着用户已保存的数据,改名等于清空。 server/不能引用client/,且只用相对路径导入(不能用@/),两边共享的只放contracts/。- 画布内部分三层:
lib/纯函数(测试只测这层)、hooks/一个功能一个、views/只写 JSX。 - 动效用
client/shared/motion里的现成参数,不要自己写时长和曲线;全局已遵守系统「减少动态效果」设置。 - 门户在矮屏幕(高度 ≤820px)用
short:断点收紧布局,改门户时两种高度都要看一下。
本版本主要变化
- 「流程画布」全面更名为「图表绘制 / Diagram」(目录、id、提示词、
diagram-skill),旧数据自动兼容。 - 新增自由画布;四个交互区都有空状态和示例;顶栏可一键切中英文;首页有了主按钮。
- 门户在各种窗口尺寸、中英文下都不再挤压或被截断。
- PPT 生图只参考模板的风格色调、不参考版式;自由画布改图准确度大幅提升。
- 清理:模板图 285 MB → 34 MB,svgedit 18 MB → 4 MB,示例图 42 MB → 12 MB,删除无用代码、依赖和接口。
待办与已知问题
| 优先级 | 事项 | 位置 / 说明 |
|---|---|---|
| 高 | 访问码没有输入入口。服务端仍会按 ACCESS_CODE_LIST 校验 /api/chat,但图表画布的设置弹窗已删,用户无处填写。部署时若开了访问码,需要在顶部设置里补一个输入框 |
server/routes/chat.ts、client/workspaces/diagram/lib/ai-config.ts |
| 中 | 「导出可编辑 PPTX」已隐藏,代码完整保留,改回 true 即恢复 |
client/workspaces/ppt/canvas/views/DeckView.tsx 顶部 SHOW_EDITABLE_EXPORT |
| 中 | 自由画布改图是整张重画,没有遮罩(mask),标注以外的地方可能有细微变化 | client/workspaces/canvas/canvas/annotated-edit.ts |
| 中 | PPT 模板作为主参考图发给改图接口,若模型仍常照抄模板版式,可改为只发文字风格描述 | ppt-service.ts 的 generatePageImage |
| 低 | 自由画布生成中无法中途停止;选中图片后按回车是生成新图而不是编辑 | client/workspaces/canvas/chat/ChatPanel.tsx |
| 低 | OCR 里判断中文的正则范围写宽了(会把韩文、emoji 当中文),只影响可编辑导出 | client/workspaces/ppt/vision/read-boxes.ts 的 CJK_PATTERN |
| 低 | lint 还有 274 条警告,主要是 any 类型,不影响运行 |
npm run lint |
| 低 | 修复前发出的自由画布标注消息,刷新后只能显示占位文字(新消息不受影响) | — |