docs(canvas): 补充媒体链路与工作条验收说明

docs/content/docs/overview/features.mdx

@@ -5,6 +5,41 @@ description: 当前项目已实现的核心工作台能力与使用入口
 
 # 功能清单
 
+## 素材库分类与画布媒体链路
+
+素材库支持用户手动新增、重命名和删除分类，也可以按分类或“未分类”筛选素材，并批量移动素材。删除分类不会删除素材，分类内素材会回到“未分类”。
+
+画布中的远程图片、视频和音频展示统一使用资源文件地址，不把浏览器 Blob Object URL 写入节点或预览状态；Blob 缓存只用于导出、抽帧、供应商输入等字节处理。画布生成的视频在进入成功态前会先完成资源 Blob 缓存，缓存失败会保留失败语义，不会显示为已成功。
+
+### 相关实现
+
+- `web/src/pages/assets/index.tsx`：素材库分类筛选、新建、重命名、删除和批量移动入口。
+- `web/src/services/api/user-data.ts`：素材分类及素材移动 API。
+- `web/src/services/file-storage.ts`、`web/src/services/image-storage.ts`：远程资源地址解析。
+- `web/src/services/resource-blob-cache.ts`：按用户 scope 隔离的媒体字节缓存。
+- `web/src/lib/canvas/canvas-generation-task-sync.ts`、`web/src/services/project-asset-sync.ts`：生成视频缓存完成后再写入成功结果。
+
+## 画布连线可读性与底部工作条
+
+画布左下角自动整理节点旁提供“设置隐藏节点连线”开关。开启后默认隐藏连线；鼠标划过、聚焦或选中节点时显示该节点关联的连线，已选中的连线保持可见。设置按浏览器保存，并同时应用于视觉层和连线命中层，避免隐藏连线仍可点击。
+
+底部工作条将素材入口改为“素材 + 数量”标签按钮；手势切换保持纯图标胶囊滑块，使用指针 / 抓手图标和单个圆形选中滑块，保留悬停提示、键盘语义和原有操作。
+
+### 相关实现
+
+- `web/src/lib/canvas/canvas-connection-visibility.ts`：隐藏连线筛选和本地设置。
+- `web/src/pages/canvas/project.tsx`、`web/src/components/canvas/canvas-zoom-controls.tsx`：画布状态、开关和渲染接线。
+- `web/src/components/canvas/canvas-asset-tray.tsx`、`web/src/lib/canvas/tool-registry/definitions/main-toolbar-tools.tsx`：底部工作条入口。
+
+## 文本节点尺寸联动
+
+文本节点的普通文本、富文本和编辑态输入框共用同一套字号缩放规则。节点尺寸变大时字号随宽高联动增长，并保留最小、最大字号边界，避免极端尺寸造成不可读或失控的排版。
+
+### 相关实现
+
+- `web/src/lib/canvas/canvas-text-scale.ts`：字号缩放和边界规则。
+- `web/src/components/canvas/canvas-node-content.tsx`：文本节点展示与编辑态应用字号。
+
 ## 支付订单与对账导出
 
 管理员在 `/admin/payments` 可按关键词、状态、渠道和创建/支付/入账日期筛选订单，并导出全部匹配记录的 CSV。对账支持按渠道、执行状态和账单日期导出每日汇总；单次对账明细支持按结果或“仅异常”导出。单次最多 10000 行，超限明确提示，不静默截断。文件使用中文表头和北京时间，保留完整订单号、精确金额/积分及失败原因。导出不触发查单或积分补发；对账运行中不能导出明细。具体字段和参数见 [HTTP API 合同](../backend/http-api)。

docs/content/docs/progress/pending-test.mdx

@@ -5,6 +5,26 @@ description: 当前项目已实现功能的手工验证清单与未确认边界
 
 # 待测试
 
+## 画布素材链路与工作条改造（2026-09-19）
+
+已实现：
+
+- 素材库已有手动新增、重命名、删除分类，以及分类筛选和批量移动能力。
+- 画布支持“设置隐藏节点连线”：开启后隐藏普通连线，悬停、聚焦或选中节点时显示关联连线。
+- 画布底部素材入口改为带“素材”文字和数量徽标的按钮；手势切换恢复无文字的纯图标胶囊滑块，不使用标签按钮外观。
+- 手势图标固定为 16px，统一选中 / 未选中描边粗细，未选中态使用不透明颜色而非整体半透明。工具栏切换专项覆盖普通 / 紧凑尺寸、无文字及单个圆形滑块的真实组件静态渲染；尚未完成浏览器视觉验收。
+- 远程素材展示统一走资源文件地址；Blob 只保留给字节处理和本地缓存，不作为远程媒体展示 `src`。
+- 画布生成视频在进入成功态前先完成 Blob 缓存；缓存失败不得标记成功。
+- 文本节点字号随节点尺寸联动，普通文本、富文本和编辑态保持一致。
+
+自动化验证已完成：画布连线可见性与文本字号专项测试通过，前端类型检查和 `git diff --check` 通过。以下仍需真实页面验收：
+
+- [ ] 登录真实账号打开素材库，新建、重命名、删除分类并移动素材；确认刷新后分类和素材归属仍正确，删除分类不会删除素材文件。
+- [ ] 在浅色、深色主题和窄屏布局下检查画布底部工作条，确认素材数量徽标、选择 / 移动切换、键盘焦点和提示文案可读。
+- [ ] 开启隐藏节点连线后，确认默认连线不可见且不可点击；悬停、聚焦、单选和多选节点时只显示关联连线，取消交互后恢复隐藏。
+- [ ] 使用真实视频生成渠道验收：资源缓存完成后再显示成功；网络或资源下载失败时显示失败，不出现“成功但视频不可播放”。
+- [ ] 调整文本节点宽高，确认普通文本、富文本和编辑态字号都随尺寸变化，极端尺寸仍在可读范围内。
+
 ## Agent 工具诊断与错误恢复
 
 针对交互日志中的字段误报、输出可引用状态被误认为输入缺失、已绑定任务无法诊断、展示字段导致审批快照失效等问题，调整工具的数据合同和共用准入规则。没有新增场景关键词路由、自动选参考图、自动重试生成或新的系统提示词规则；工具说明明确区分编辑画布和提交收费生成，去除具体广告场景例子。