Appearance
MVP 范围
当前阶段：MVP — 已接入真实 AI 后端 API
P0 — 已完成
M1：基础设施
M2：画布编辑器核心
- Workspace 画布列表 CRUD
- Canvas Editor 页面（Vue Flow 集成）
- 画布 Header / Toolbar / Footer
- 节点创建（工具栏对话框 + 浮动菜单 + 双击空白区 + 连线拖出）
- 连线校验（自连接 / 循环 / 重复）→ spec
- 画布数据 localStorage 持久化
M3：节点系统
- NodeShell 通用节点框架 → spec
- TextNode（TipTap 富文本编辑 + AI 文本生成）→ spec
- ImageNode（图片上传/预览 + AI 图片生成）→ spec
- VideoNode（视频播放 + AI 视频生成）→ spec
M4：AI 服务接入
M5：文档体系
- SDD + TDD + BDD 四层文档体系建立
- 模块契约、功能规格、测试策略、术语表
P0 — 进行中（M6：核心功能补全）
ContentOrigin 类型补全：✅ 已实现连线验证增强：✅ 已实现（handle 方向规则、uploaded 节点不可作 target、拖到节点体创建连接）→ spec- 连线兼容性软提示：自定义边组件、不兼容连线警告态样式（待后端 API）→ spec / ADR-008
节点间数据流传递：✅ 已实现（上游文本/图片输出注入下游生成参数）→ spec节点多选批量连线：✅ 已实现（group node + 多线预览 + 批量建边）→ spec
P0 — 计划中（M7：UI 打磨与质量保障）
NodeShell 紧凑 / 编辑双模式：✅ 已实现（useNodeShellState + NodeToolbar 悬浮面板 + 右键菜单 + 蒙版拖拽）→ spec- GenerateBar 上游参考图预览：上游节点的图片在下游 GenerateBar 中显示为参考图缩略图
- 节点视觉优化：颜色对比度增强、hover 时边框高亮（低于 selected 亮度）、GenerateBar 默认尺寸增大
- 撤销 / 重做：已实现但有 bug，需修复后上线
- 测试覆盖：完善单元测试 / 集成测试 / E2E 测试
P1
- 图片工具条：下载 / 抠图 / 放大 / 扩展 → spec AC-10
P2
待定
明确不做
- 移动端适配（桌面端优先，最小宽度 1280px）
- 浅色主题（MVP 仅深色）
- 右侧属性面板（配置内嵌在节点内部）
非功能性需求
| 项目 | 要求 |
|---|---|
| 浏览器兼容 | Chrome 90+, Safari 15+, Firefox 90+, Edge 90+ |
| 响应式 | 桌面端优先，最小宽度 1280px |
| 性能 | 画布 50+ 节点保持 60fps |
| 状态持久化 | 画布数据保存到 localStorage |
| 主题 | 仅深色主题 |
页面结构
| 页面 | 路由 | 描述 |
|---|---|---|
| Workspace | / | 画布列表、新建画布入口 |
| 画布编辑器 | /canvas/:id | 核心编辑页面 |