feat(*): 创作工作台 - 完善媒体上传预览与连线交互并修复任务章节及日志筛选

docs/content/docs/backend/task-runtime-stability.mdx

@@ -5,6 +5,14 @@ description: 热点回源保护、并发租约、故障边界和上线验收
 
 # 任务缓存与队列稳定性
 
+## 详情读取和日志筛选边界
+
+任务中心打开详情只读取任务和日志，不在该路径调用画布结果同步。后台同步遇到短剧领域项目任务（`domainProjectId` 等于任务 `projectId`）或没有生成节点关联时跳过画布写回，避免把短剧项目 ID 当作画布 ID 查询。
+
+管理员请求明细列表及 CSV 导出支持 `recordType`：省略或 `request` 默认仅请求（继续隐藏视频轮询并排除下载）；`download` 只包含 `request_kind=download`；`all` 包含请求、轮询与下载。非法值返回参数错误，管理员权限校验保持不变；该筛选不改变统计聚合接口。
+
+章节提取采用独立提示词操作 `chapter_assets_extract`，受保护输出契约为 `chapter-assets/v1`，要求 `characters`、`scenes`、`props` 三个数组。场景和道具要求非空的 `name`、`description`、`prompt`；角色继续执行原角色契约校验。写入候选资产时场景映射为 `environment`，继续使用现有服务的项目归属、去重与写入校验，不新增数据库字段。
+
 ## 范围与事实源
 
 当前任务仍由数据库持久化、API 进程内 worker 领取和执行，Redis 负责跨实例并发协调。本轮是热点读取和租约的止血修复，不是独立任务系统迁移，也不能替代线上事故取证。

docs/content/docs/overview/features.mdx

@@ -5,6 +5,14 @@ description: 当前项目已实现的核心工作台能力与使用入口
 
 # 功能清单
 
+## 章节资产提取与任务浏览
+
+画布视频支持鼠标悬停 350ms 后静音预览前 3 秒，不循环；全局仅一个悬停解码器，离开或操作画布立即停止并恢复封面。手动播放优先，系统开启减弱动态效果时不自动预览。
+
+剧情章节支持一次提取角色、场景与道具，分别写入角色、环境和道具待确认资产。输出必须包含三类数组；无人章节可以只产生场景或道具，不把缺失字段当作提取成功。
+
+任务详情只读取任务与日志，不因打开详情写入画布。视频任务列表和网格优先展示已有封面；没有封面时，在进入视口后提取首帧缩略图。后台请求明细默认仅显示请求，可切换仅下载或全部明细，导出沿用当前筛选条件。
+
 ## 站点及外观
 
 管理员可以在“系统配置 → 站点及外观”统一管理品牌识别、登录页、SEO、首页收尾与备案、皮肤主题。品牌识别包括站点名、英文品牌标识、浅色与深色 Logo 和 Logo 外框；登录页包括主标题、说明、品牌视频和可选封面。Logo 可以只上传任意一套并自动复用，也可以分别适配浅色与深色界面；关闭外框后 Logo 会在原导航占位内等比放大。
@@ -194,4 +202,4 @@ SEO 标题、描述、可选关键词会投影到浏览器 metadata、Open Graph
 - `web/src/lib/plugins/plugin-permission-check.ts`：命令执行权限与失败关闭策略。
 - `web/src/services/api/timeline-tasks.ts`：转写与渲染任务客户端。
 - `backend/internal/service/task_timeline.go`、`task_render.go`、`timeline_render_plan.go`、`transcription_whisper.go`：后端转写、渲染与渲染计划任务。
-- `backend/internal/repository/project_workbench_read.go`：项目概览指标聚合（含成片完成度计数）。
+- `backend/internal/repository/project_workbench_read.go`：项目概览指标聚合（含成片完成度计数）。

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

@@ -5,6 +5,54 @@ description: 当前项目已实现功能的手工验证清单与未确认边界
 
 # 待测试
 
+## 连线目标节点 3D 倾斜反馈
+
+- 拖动连线进入现有合法目标吸附区时，目标节点按接近点倾斜，最大约 5°，以接近点作为支点；支持单条和批量连线，不扩大连线命中区域或改变节点坐标。移出、完成或取消后恢复，普通 hover、点击和选中不启用此效果。
+- 性能降级模式、拖动节点和系统减弱动态效果下不启用倾斜。修复逐帧传入鼠标坐标导致目标节点 memo 失效的问题：仅在进入目标时锁定接近点，同一目标内移动保持引用和倾斜不变，切换、退出或取消时更新；连线端点仍按原有 RAF 节奏更新。
+- [x] 方向、边界、缩放、600 次同目标移动引用稳定性及相邻连线/媒体专项共 40 项测试通过，前端构建通过。真实浏览器验证样式在普通/选中状态为 `none`，目标状态为 3D 变换，清除后恢复 `none` 和 `will-change: auto`。
+- [ ] 在用户出现卡顿的大画布复验连线延迟和渲染开销；独立浏览器渲染计数实验初始计数异常为零，未获得有效的渲染次数对比，不能据此认定性能验收通过。
+- [ ] 登录画布验证不同缩放下从各方向接近目标、完成、Escape 取消、窗口失焦，以及批量连线的合法/非法目标切换。
+
+## 画布视频悬停预览
+
+- 鼠标停留 350ms 后静音播放前 3 秒，播放完恢复静态封面；短视频结束即停止，不循环。触屏、按键拖拽以及系统减弱动态效果下不自动播放，点击播放仍使用完整播放器。
+- 同时仅一个悬停预览（包括待加载任务），快速划过不解析视频地址；离开、滚轮、按下鼠标、键盘操作、窗口失焦、页面隐藏、节点离开视口或画布变换均释放播放器。手动播放优先，悬停不触发整文件后台缓存。
+- [x] 悬停生命周期与相邻媒体专项测试共 31 项通过，前端完整构建通过；真实浏览器以 4.2 秒本地生成视频验证静音播放及约 3 秒后播放器移除。此验证不依赖登录，也不等同于完整画布验收。
+- [ ] 在真实大画布中验收大量视频节点下的快速划过、拖拽、缩放、慢网和跨域失败，记录目标设备的帧率与内存；本地专项测试不代表所有设备的性能保证。
+
+预览使用原视频，3 秒限制是播放时长而非下载字节上限；实际网络流量取决于浏览器缓冲、源视频码率和服务端 Range 支持。
+
+## 任务详情、章节资产与请求明细
+
+- [x] 前端专项回归覆盖图片自引用、任务同步边界、章节三类资产解析及相邻媒体逻辑；无角色章节允许保留场景和道具，缺失必填字段仍报错。
+- [x] 后端 repository、service、handler 测试通过，覆盖请求/下载筛选及导出、章节资产输出校验。
+- [x] 视频首帧组件使用浏览器内生成的视频验证：输出 400×225 缩略图，卸载后释放对象 URL；此项不等同于登录态任务页面验收。
+- [ ] 登录后打开画布任务和短剧任务详情，确认不再因详情读取触发画布同步而报 `record not found`。
+- [ ] 检查生成图片的提示词面板：不含自身引用，原有上游素材引用仍保留。
+- [ ] 使用真实文本模型提取章节，确认角色、场景、道具均进入待确认资产，重复提取与刷新恢复不重复入库。
+- [ ] 请求明细默认仅请求，切换仅下载/全部后，分页、检索、CSV 导出一致。
+- [ ] 视频任务列表和网格检查已有封面、无封面、跨域失败、滚动懒加载及明暗主题。
+- [ ] “参考 LibTV 的深度动作捕捉”尚未实现，需确认对应功能入口、截图或预期输入输出。
+
+本轮不涉及数据库迁移；前后端需一起更新，后端重启后才会提供新章节提取模板和日志筛选参数。
+
+## 文件上传占位、真实进度与磨砂流光
+
+- 图片、视频按本地读取的真实宽高比占位；音频、TXT / Markdown 文本使用各自节点尺寸。普通 multipart 与大文件分片上传回传真实字节进度，磨砂和流光随百分比逐渐变淡；传输 100% 后显示保存处理中，不能当作服务端保存成功。
+- 四类文件共用上传、拖入、替换及失败重试流程；完成后填入同一节点，上传弹窗提前关闭，批量仍按顺序处理。纯剪贴板文字直接插入，不伪造网络上传过程。文本按 UTF-8 读取，不支持 PDF / Word 文档解析。
+- 上传失败保留明确错误和重新选择入口；替换失败保留原资源；上传中删除节点不会在完成后重新插入；刷新后中断占位转为错误。减弱动态效果设置下禁用流光和淡出过渡；媒体本地降级明确提示尚未上传到服务器。
+- [x] 占位、进度浓度、四类文件、错误状态、相邻回归与普通/分片传输模拟测试通过，前端类型检查和完整构建通过；静态渲染与模拟传输不等同于真实网络及浏览器视觉验收。
+- [ ] 慢速网络下验证横图、竖图、视频、音频、TXT / Markdown、拖入和替换：比例正确，遮罩随实际进度变淡，完成前后位置稳定，右上角与节点状态同步。补验大于 50MB 的分片上传及保存失败。
+- [ ] 验证明暗主题、上传失败重试、刷新中断、上传中拖动或删除节点，以及系统减弱动态效果；未确认真实网络上传的浏览器交互。
+
+## 上传图片保护与画布浮层顺序（#438 / #436）
+
+- 上传/导入的纯图片素材不再显示生成框和生成设置入口；空白生成节点、已有生成结果和显式复制/版本节点仍保留配置入口。替换上传会清除旧生成落点状态。
+- 人物质感操作创建独立图片编辑节点，通过入边引用原图；底部添加与外观面板接入统一浮层管理，打开或交互时置顶。
+- [x] 图片素材判定、人物质感节点构造、入口接线、浮层接线及相邻布局/引用测试共 24 项通过；前端完整构建通过。浏览器访问现有服务进入登录页，尚未完成登录后的交互验证，也未调用真实生成接口。
+- [ ] 上传、拖入和替换图片，确认原图没有生成框；执行人物质感、局部重绘、裁剪、放大与表情编辑，确认原图保留、结果生成到新节点并有原图连线。
+- [ ] 先打开节点编辑框，再打开底部添加/外观菜单，确认后打开的面板在上层；再次点击节点编辑框能置顶，键盘操作、明暗主题和菜单关闭正常。
+
 ## Tiptap 依赖版本对齐
 
 - Tiptap 核心、React、扩展及间接依赖统一锁定为 `3.28.0`，同步 Bun 与 pnpm 锁文件；显式声明 `pm` 和 `extensions`，避免 pnpm 保留旧 peer 解析。此项不修改编辑器业务代码和 UI 样式。