Files
王冕 af29b26fe8 Sync OneOS workspace with new prototypes, annotations, and Gitea remote fix.
Add vehicle-h2-fee-ledger, customer-management, lease and self-operated ledgers, annotation sources, agent skills, and vite annotation runtime support. Update vehicle management, contract templates, and lease contract flows.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-30 15:27:23 +08:00

1.9 KiB

Excalidraw 基础指导

这份只说明如何把内容组织成普通 Excalidraw 图,不规定 Axhub 画布流程。流程图、关系图、架构图等请求先按 canvas-workspace 主文档分流;已确定要画成 Excalidraw 元素后,再读本文件。

先判断图类型

用户意图 适合图形
流程、步骤、审批、状态流转 流程图
模块关系、依赖、信息结构 关系图
概念拆解、头脑风暴 思维导图
系统、页面、组件、服务结构 架构图
数据输入、处理、输出 数据流图
多角色协作流程 泳道图

如果画布内容涉及真实图片、UI 设计稿或素材,先按用户目标确认它是画布参考、画布节点,还是项目实现素材。

抽取信息

动手画之前先明确:

  • 关键元素:节点、步骤、角色、页面、模块。
  • 关系:先后、依赖、父子、输入输出、跳转。
  • 复杂度:元素太多时拆成多个 Frame 或多张图。
  • 主次:优先画主路径,细节放到旁边补充。

布局原则

  • 流程图:从左到右或从上到下。
  • 关系图:核心元素居中,相关元素围绕或分组。
  • 架构图:按层级、职责或数据流分区。
  • 思维导图:中心主题 + 4-6 个主分支。
  • 泳道图:角色用列或行,活动放进对应泳道。

相关内容使用 Frame 分组,组内元素用 frameId 归属到对应 Frame。

控制复杂度

  • 单张图优先控制在 20 个核心元素以内。
  • 复杂请求先画高层图,再按模块拆详细图。
  • 避免把长文档逐句搬进画布;画结构和决策点。
  • 颜色只表达语义,不做装饰。

与 Axhub 规范的边界

  • 画布文件仍写入 src/prototypes/<prototype-name>/canvas.excalidraw
  • 字体、颜色、节点、资源和交付口径仍按本技能主文档与其他 references 执行。