feat(canvas): 画布视觉 - 优化浮动控件与连接线可读性

docs/design/canvas-node-visual-contrast.mdx

@@ -1,7 +1,7 @@
 # 画布节点可读性设计沉淀：节点与图片创作面板
 
-> 范围：无限画布中的节点外壳、节点内容空态、节点标题和图片创作面板。
-> 目标：节点在浅色、深色，以及点阵/线稿/空白画布背景上都能被快速识别和操作。
+> 范围：无限画布中的节点外壳、节点内容空态、节点标题、图片创作面板和节点间连接线。
+> 目标：节点和连接在浅色、深色，以及点阵/线稿/空白画布背景上都能被快速识别和操作。
 > 状态：已实现首版，浏览器回归待确认。
 
 ## 1. 问题定义
@@ -10,6 +10,7 @@
 
 - 节点边界消失，空态内容看起来像画布的一部分。
 - 图片创作面板的“将使用默认模型与参数”提示、输入区和操作控件缺少稳定的表面层级。
+- 节点间普通连接线使用过低的透明度和线宽，在低缩放比例或点阵背景上难以追踪。
 
 这不是生成逻辑或参考图尺寸逻辑的问题，因此本次只调整视觉契约，不改变节点数据、生成参数、定位和交互流程。
 
@@ -42,6 +43,15 @@
 - 展开编辑 Modal 使用相同的表面、边界和阴影，避免节点内面板与放大面板产生两套视觉语言。
 - “将使用默认模型与参数”仍是状态说明，不改变模型解析或生成默认值。
 
+### 2.4 连接线可读性
+
+`ConnectionPath`（节点连接线）把交互命中层和视觉展示层分开：透明路径继续保留 16px 点击区域，视觉路径不承担点击事件。
+
+- 普通状态使用“柔和外层 + 清晰内芯”两层路径，提高连接在画布背景上的连续性，但不使用高亮色制造噪音。
+- 悬停或选中状态切换到 `accent.primary`（主题强调色），同时提高线宽、透明度和流动虚线强度。
+- 起点和终点使用轻量圆点标识，让用户能快速判断连接的两端。
+- 所有路径使用 `vectorEffect="non-scaling-stroke"`，保证缩放画布时线宽保持可读；动效继续服从 `prefers-reduced-motion`。
+
 ## 3. 状态与边界
 
 | 状态 | 处理 | 目的 |
@@ -51,6 +61,8 @@
 | 选中 | 沿用 active stroke | 与节点选中态保持一致 |
 | 禁用/无内容 | 沿用 `faint` 和既有空态文案 | 不伪造生成成功或配置状态 |
 | 展开编辑 | Modal 复用同一套主题 token | 保持放大编辑与节点内编辑一致 |
+| 连接线默认 | 中性颜色的外层 + 清晰内芯 + 端点圆点 | 在低缩放和点阵背景下保持连贯可见 |
+| 连接线悬停/选中 | 强调色、增强线宽、流动虚线 | 快速识别当前连接，不改变连接数据 |
 
 本次不调整画布背景色、节点尺寸、面板定位、参考图尺寸选项、生成参数和资源同步逻辑。
 
@@ -60,6 +72,7 @@
 - `web/src/components/canvas/canvas-node.tsx`：应用节点外壳和节点标题的主题表面。
 - `web/src/components/canvas/canvas-node-content.tsx`：应用绘图空态子表面。
 - `web/src/components/canvas/canvas-node-prompt-panel.tsx`：注入图片创作面板和放大编辑面板的主题变量。
+- `web/src/components/canvas/canvas-connections.tsx`：渲染连接线的命中层、普通层级、选中流动线和端点标识。
 - `web/src/styles/globals.css`：维护面板控件 hover 与尺寸调整手柄的唯一规则。
 
 ## 5. 验证与待回归
@@ -73,4 +86,5 @@
 
 - 浏览器中分别切换浅色/深色主题，检查图片创作面板默认、悬停、选中和展开编辑状态。
 - 在点阵、线稿和空白背景下检查节点边缘、空绘图态和“将使用默认模型与参数”的对比度。
-- 本项目按规则未自动运行 TypeScript、构建或测试；提交前只做了静态 diff 检查。
+- 在 25%、40% 和 100% 缩放下检查普通连接线、悬停/选中连接线及两个端点的可见度。
+- 本项目按规则未自动运行 TypeScript、构建或测试；提交前只做了静态 diff 检查。