Files
OneOS1.2/.agents/skills/canvas-workspace/references/excalidraw-basics.md
王冕 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

48 lines
1.9 KiB
Markdown

# Excalidraw 基础指导
这份只说明如何把内容组织成普通 Excalidraw 图,不规定 Axhub 画布流程。流程图、关系图、架构图等请求先按 `canvas-workspace` 主文档分流;已确定要画成 Excalidraw 元素后,再读本文件。
## 先判断图类型
| 用户意图 | 适合图形 |
|----------|----------|
| 流程、步骤、审批、状态流转 | 流程图 |
| 模块关系、依赖、信息结构 | 关系图 |
| 概念拆解、头脑风暴 | 思维导图 |
| 系统、页面、组件、服务结构 | 架构图 |
| 数据输入、处理、输出 | 数据流图 |
| 多角色协作流程 | 泳道图 |
如果画布内容涉及真实图片、UI 设计稿或素材,先按用户目标确认它是画布参考、画布节点,还是项目实现素材。
## 抽取信息
动手画之前先明确:
- 关键元素:节点、步骤、角色、页面、模块。
- 关系:先后、依赖、父子、输入输出、跳转。
- 复杂度:元素太多时拆成多个 Frame 或多张图。
- 主次:优先画主路径,细节放到旁边补充。
## 布局原则
- 流程图:从左到右或从上到下。
- 关系图:核心元素居中,相关元素围绕或分组。
- 架构图:按层级、职责或数据流分区。
- 思维导图:中心主题 + 4-6 个主分支。
- 泳道图:角色用列或行,活动放进对应泳道。
相关内容使用 Frame 分组,组内元素用 `frameId` 归属到对应 Frame。
## 控制复杂度
- 单张图优先控制在 20 个核心元素以内。
- 复杂请求先画高层图,再按模块拆详细图。
- 避免把长文档逐句搬进画布;画结构和决策点。
- 颜色只表达语义,不做装饰。
## 与 Axhub 规范的边界
- 画布文件仍写入 `src/prototypes/<prototype-name>/canvas.excalidraw`
- 字体、颜色、节点、资源和交付口径仍按本技能主文档与其他 references 执行。