Integrate Canvas V2 subgraphs, editable edges and AI runs

README.md

@@ -54,7 +54,7 @@ Google / Slack 的提供方回调仍是 Foundry 后端地址；后端的项目
 - 本地演示提供示例图谱、搜索、新建和浏览器保存，支持图谱独立地址与刷新。
 - 图谱页面使用 React Flow 12.12.1，支持空白处平移、节点拖动、连线、多选、缩放和文本编辑。文字、脚本、图片节点和创作模板可从底部悬浮工具栏插入。
 - 右上角悬浮框提供撤销、重做、缩放、恢复 100%、适应画布和 JSON 导出；底部支持 JSON 导入及操作帮助。
-- 真实图谱先读取 Core Canvas 快照，再开放编辑；节点、样式、连线与视图以独立版本串行自动保存。旧本地草稿需用户明确选择恢复；版本冲突停止覆盖并保留恢复记录。演示模式仅本地保存。分区框及成员归属已匹配 Core 022086b 的保存契约，详见 docs/CORE_FRAME_EXTENSION.md。
+- 真实图谱先读取 Core Canvas 快照，再开放编辑；节点、样式、连线与视图以独立版本串行自动保存。旧本地草稿需用户明确选择恢复；版本冲突停止覆盖并保留恢复记录。演示模式仅本地保存。支持 Core Canvas V1/V2；V2 分区是真实子画布，内部内容按所属画布独立保存。
 - 分享、Agent、收藏、自由绘图及多人协同尚未接入。画布覆盖整个视口，侧栏和快捷浮框覆盖其上；演示数据不写入线上。
 - 收起侧栏后，左上角浮框显示 Logo 和用户头像；头像与展开侧栏底部的账户按钮打开同一个菜单。
 - 本地演示仅用于查看界面，不提供后端认证与权限。
@@ -88,57 +88,36 @@ API 测试使用本机临时后端和独立前端进程，检查会话 Cookie、
 
 ## 画布操作
 
-- 拖动空白处平移；拖动节点标题或边框移动节点。抓手模式下也可从节点内容处平移。
-- V 选择、H 抓手，按住空格临时平移，Shift 框选；拖动节点两侧的圆点创建连线。
-- 触控板滚动平移，Ctrl / ⌘ 加滚动或双指捏合缩放。右上角提供缩放和适应画布。
-- 底部可添加文字、图片、脚本或三节点创作模板。图片支持 PNG/JPEG/WebP/GIF，单张上限 2 MB。
-- Ctrl / ⌘ + Z 撤销，Shift + Ctrl / ⌘ + Z 重做；支持 JSON 导入导出和 40 步撤销历史。
-- 状态与导入回归：`node --experimental-strip-types --test tests/canvas.test.mjs tests/workspace.test.mjs`。
+- 单击选择，双击编辑文本或卡片名称。纯文本与图片可整块拖动；选中时四侧连接点可拖线。
+- 触控板滚动平移，Ctrl / ⌘ 加滚动或捏合缩放。V 选择，H 抓手，空格临时平移，Shift 框选。
+- 上方编辑栏提供文字样式、旋转和八向拉伸模式。旋转时 Shift 吸附 15°；八向拉伸时 Shift 固定比例，Esc 退出。图标保留等比缩放预设。
+- 连线可单独选择：颜色、粗细、透明度、实/虚/点线、箭头与箭尾形状/大小/填充均可设置。双击线或点击添加按钮插入曲线点，拖动锚点和控制柄制作多段贝塞尔链；支持平滑、镜像和独立控制柄。
+- 连线动画可关闭、始终播放或仅执行时播放，包含沿完整曲线的流光、流动虚线和脉冲；方向、颜色和时长可设。执行动画由真实任务边事件驱动。
+- 底部 AI 模式可保持开启；选择文本/图片/卡片后，上方为编辑栏，下方为固定屏幕尺寸的 AI 面板。模型从后端目录读取，支持原地生成、取消及可选下游传播；冲突结果保留供明确应用。
+- 新选框通过服务端事务创建并关联真实子画布。标签用三个图标切换隐藏/固定字号/随缩放，悬停查看解释。选框可收起、展开及调整概览比例，子图真实内容尺寸不变。
+- 展开内容使用子画布投影，编辑保存到实际 owner；不会在父图复制一份。拖入/移出使用多画布事务；新跨图连线按后端能力通过 connections 命令创建端口链。删除选框解散并保留内容。
+- 原地生成与用户拖动可合并；内容冲突保留本地草稿。网络结果不确定时暂停编辑，用相同幂等请求重试或重新读取。每个画布有独立版本与串行保存器。
+- 图标面板支持 2313 个 Lucide 和 24 个 Tabler 图标试用、分类/搜索、虚拟列表及本地图形分片加载。未打开面板不加载目录。
+- 有子图时导出完整 owner 文档集合；关系型子图备份不直接覆盖导入到其他画布。历史 V1/关系不兼容草稿可导出，不能覆盖 V2 子图关系。
 
-## 悬浮栏尺寸
+## Canvas V2 接口与检查
 
-左上角显示当前图谱标题，复用页面已读取的资料，不额外请求后端；长标题省略并可悬停查看。左上、右上、底部与帮助按钮共用 `toolbar.module.css`：图标/Logo/浮框头像 20px，图标按钮含 padding 的总尺寸为 32×32px，主文字 14px，容器内边距 4px，间隙 4px，圆角 8px。悬浮栏距屏幕边缘统一为 12px；右上角窄屏时下移避免与标题重叠。
+后端基线由用户交付的部署 `b4e537b`、CI #912/#913 与指定测试画布迁移摘要确认。跨图 connections 扩展以线上 `capabilities.subgraphs.connections` 为准；客户端先检查能力，再发事务。前端未重复运行迁移或调用线上付费模型。
 
-## 图谱改名
+同源代理转发 V2 Accept、If-Match、Idempotency-Key 和事件分页查询，保留 ETag/schema/Retry-After；受管图片通过带会话的二进制代理读取。快照上限 5 MiB，图片上传支持受限 multipart；服务令牌不会发给浏览器。
 
-左上角标题第一次点击选中，选中后再次点击进入编辑；回车或失焦保存，Esc 取消，F2 也可直接编辑。真实图谱改名先读取最新资料和版本，再携带 If-Match 更新名称，保留描述与内容；版本冲突时提示重试。演示模式保存到本地。保存后标题、侧栏列表及导出文件名同步更新。
+验证命令：
 
-左上和底部工具栏按右上视图控件的分组节奏增加横向留白（间隙 6px、横向内边距 6px），按钮仍为 32×32px，竖向内边距仍为 4px。三处分隔线统一；左侧标题不再额外叠加外边距，右上现有样式保持不变。
+```sh
+npm run typecheck
+node --experimental-strip-types --test tests/*.test.mjs
+CANVAS_UI_TOOLS=/path/to/isolated-tools node tests/canvas-ui-check.mjs
+```
 
-卡片选中时，四边正中心淡入固定尺寸的小连接点；取消选中后淡出隐藏，不再显示大加号。拖动连接点建立贝塞尔连线，曲线直接连接两端卡片边缘中心，缩放及旋转后同步更新；选中后点击连接点打开菜单，选择文本、上传图片或脚本后再创建节点并连线。选中卡片拖线到空白处，也会在释放位置打开类型菜单。新增节点与连线组成一步撤销。
+DOM 工具仅需在临时目录安装 esbuild/jsdom，见测试文件开头；不启动浏览器。生产构建与 `tests/api-smoke.mjs` 使用隔离副本和临时本地服务，避免影响现有开发服务器。实际结果及限制见 VALIDATION.md。
 
-## 元素变换、样式与继承
+Headless Canvas API 的拆包方案保留在本地忽略的 `docs/HEADLESS_CANVAS_API_DRAFT.md`，当前没有创建或发布该库。其他已被替代的元素/分区草案已清理。
 
-- 右下角缩放符号始终显示，拖动会选中并调整大小，已移除八向缩放控件。样式浮栏中的旋转按钮开启旋转模式，拖动元素旋转，Shift 吸附 15°；点击外部或按 Esc 退出。纯文本宽、高独立调整，文字随宽度换行，字号由样式栏控制；图标保持等比缩放。
-- 卡片标题位于框外，整个框内是文本编辑区域；卡片与纯文本均取消独立的聚焦内框。
-- 样式浮栏提供文字颜色、字体、字号、加粗、斜体、下划线、对齐、行距、背景及旋转；样式作用于整个文本节点。选中与取消选中、菜单均有动画，尊重系统减少动态效果偏好。
-- 底部 T 添加纯文本，便签按钮添加文本卡片。纯文本没有卡片外框、连接点或四向加号。
-- 底部图形按钮打开左侧图标浮层，可搜索并分批加载 2313 个 Lucide 图标；图标支持移动、缩放、旋转和颜色设置，无需额外图标目录服务。
-- 大小、角度、样式、字号和图标标识通过独立 Canvas 快照接口存入数据库，并保留本地恢复记录及 JSON 导出。保存使用独立版本及 If-Match，串行提交并合并等待中的更新，冲突后停止自动写入。分区框、名称模式和成员归属已随 Core 022086b 部署支持，使用同一个快照接口保存。
-- 业务类继承为 `CanvasElement → CardElement → TextCardElement / ImageCardElement / ScriptCardElement`；`PlainTextElement` 和 `IconElement` 直接继承 `CanvasElement`。基础元素拥有缩放和旋转能力，卡片层追加连线和分支能力。React 组件通过组合共享 `TransformableNode`。
-- `/dashboard/{workspace}/{board}` 的两个 ID 分别标识工作空间和图谱。
-- 回归：`node --experimental-strip-types --test tests/canvas-style.test.mjs tests/canvas-geometry.test.mjs tests/canvas.test.mjs tests/workspace.test.mjs`。
+## 会话期限
 
-## 框选区
-
-底部「添加框选区」插入可调整大小的分区；选中框可改名，名称提供隐藏、固定屏幕字号、随画布缩放三种模式。拖动边框或名称移动分区，右下角调整大小。框在内容下方，内部空白仍可平移画布。
-
-只有实际拖入的内容才建立归属，以内容中心进入分区为准；拖出后退出，重叠区域优先较小分区。移动分区只带动已有成员，不会自动收纳覆盖到的其他内容；删除分区会保留成员位置与内容。单次拖动及归属变化可以一步撤销，分区设置和归属进入草稿与 JSON。
-
-## 服务端快照与 slug 路由
-
-Core 57aab71 提供基础快照，022086b 已补齐分区框并部署。前端允许 `/workspaces/{workspace}/materials/{board}/canvas`，保留 ETag / If-Match，只为 Canvas 路由放宽至 5 MiB。打开画布并行读取材料信息和快照；读取失败时不开放空白编辑器，避免覆盖远程数据。800ms 防抖提交，更新串行化；失败停止自动写入并提供重试、导出和重新读取。旧草稿和未同步恢复记录都需明确选择，默认使用服务端快照。
-
-URL 的 workspace 与 board 可分别使用 ID 或 slug，支持全部四种组合。以接口返回的 canonical ID 做身份校验、本地恢复隔离与保存路径，侧栏高亮、标题及改名支持 slug；新侧栏链接优先使用可用 slug。改名不自动更改 slug。
-
-分区字段契约：[CORE_FRAME_EXTENSION.md](docs/CORE_FRAME_EXTENSION.md)。前端已按该契约保存分区，无需额外数据库结构或接口。
-
-首页现提供可点击的画布预览、三段创作说明、FAQ 和本地演示入口；已登录访问 `/` 仍跳转无画布的 `/dashboard`。
-
-## 最新编辑交互
-
-文本卡片、脚本和纯文本统一为单击选中、双击进入编辑（采用系统双击窗口）；选中后隔很久再单击不会误进编辑。非编辑状态可直接拖动整个文本区域，不再使用纯文本左上角拖动按钮；Esc 或失焦退出编辑。卡片外部标题可双击改名。
-
-底部同时提供图片卡片与纯图片入口；纯图片按原图比例插入，没有卡片标题/连接点，支持整图拖动、等比缩放及旋转。分区工具栏显式提高层级，修复可见但无法操作的问题。完整继承关系见 [CANVAS_ELEMENTS.md](docs/CANVAS_ELEMENTS.md)。
-
-会话策略已按确认方案准备前后端实现：30 天闲置续期、90 天绝对期限，Core PR #10 已随主线 7847167 的部署 #889 成功上线；既有过期会话不会复活，有效会话可在下一次鉴权时续期。详见 [SESSION_LIFETIME.md](docs/SESSION_LIFETIME.md)。纯图片快照配套 Core PR #11（codex/plain-images）已随部署 #889 上线；其余已部署节点保存保持兼容。
+会话为可撤销的随机令牌。30 天闲置续期、90 天绝对期限由 Core 控制，代理按剩余期限更新 HttpOnly Cookie；既有过期会话不恢复。详细本地说明为 `docs/SESSION_LIFETIME.md`。