@q253595422/dsh-imagegen-video 1.31.0 → 1.33.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +76 -0
- package/README.md +11 -2
- package/docs/releases/v1.32.0.md +64 -0
- package/docs/releases/v1.33.0.md +211 -0
- package/lib/client.js +54926 -4267
- package/lib/client.js.map +1 -1
- package/lib/index.js +529 -27
- package/lib/locale-tables-chunk.js +891 -9
- package/package.json +13 -6
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,82 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
|
|
|
5
5
|
|
|
6
6
|
## Releases
|
|
7
7
|
|
|
8
|
+
### 未发布 — 导演台在桌面 App 里顶部两颗按钮点不动
|
|
9
|
+
|
|
10
|
+
只在 macOS 桌面 App(Electron)里出现,浏览器与 web 宿主都复现不出来,所以拖了这么久:宿主的窗口拖动条 `[data-window-drag]` 被 Electron 当成标题栏(`-webkit-app-region: drag`),**它不是一个 CSS 层,点在那里的事件由浏览器进程吃掉、页面根本收不到**。导演台面板是 `position: fixed; inset: 0`、`.shell` 又几乎铺满窗口,于是它最上面那一排——左栏的折叠与关闭——正好落在宿主窗口左上角那块拖动区里。
|
|
11
|
+
|
|
12
|
+
- **修复**:给 `.shell` 补 `-webkit-app-region: no-drag`。动态面板不该被窗口手势穿透。规则挂在 `.shell` 而不是 `.root`,因为 `.root` 是 `pointer-events: none`,它根本不参与命中测试,拖动区照样赢。
|
|
13
|
+
- **为什么以前测不出来**:`app-region` 在普通浏览器里是空操作,预览页、headless、web 宿主全都测不到。这次的证据是真 Electron 窗口(`titleBarStyle: 'hidden'`,与桌面版同款)里的一次真实 OS 点击:同一枚按钮、同一个坐标——不加规则时 DOM 收不到任何事件,加了之后立刻触发;同一窗口里放在拖动区外的对照按钮两种情况都正常,所以不是点击本身没到。
|
|
14
|
+
- **回归守卫**:`verify-ui-contracts.mjs` 新增一条源码断言(`-webkit-app-region: no-drag` 必须在 `.shell` 上),并做过反向注入验证——把这条规则删掉,断言立刻报出这个失败。这条只能从源码守,因为任何浏览器都看不见这个差别。
|
|
15
|
+
|
|
16
|
+
### 1.33.1 — 局域网部署不再 403;多模型对比从历史打开不再空白
|
|
17
|
+
|
|
18
|
+
两条都来自用户上报(#50 / #49)。数据层没有改动:两处的磁盘与路由本来都是对的,坏在门口那道守卫和面板那一句 `Promise.all`。
|
|
19
|
+
|
|
20
|
+
- **#50 局域网访问时全部接口 403**:`isLoopbackRequest` 只认「连接来自回环地址」,而浏览器直连本机网卡(`192.168.x.y`)时 `remoteAddress` 永远是那个网卡地址——于是宿主把 `webServer.host` 绑到具体网卡后,插件每一条 `/api/dsh-imagegen` 都回 `403 forbidden: loopback-only`。现在认两种权威之一:连接来自回环,**或**请求的 `Host` 精确等于监听绑定地址。绑定地址本身就是用户的显式选择,所以它授予权威;`0.0.0.0` / `[::]` 是通配、不是某个地址,一律不授予。真正防 DNS rebinding 的 `sec-fetch-site` 与 Origin 同源检查对两种权威都照旧生效——Host 校验只是让 Origin 比较有了意义,不是替代它。**没有新增 `allowLan` 开关**:多一个开关就多一个「开了就全放行」的误配面。绑定地址按运行时值宽松读取而不是按类型收窄——本地 devDependency 的 `Config.host` 还只写了两个字面量,照类型写会让新宿主支持的网卡地址在类型层就被抹掉。
|
|
21
|
+
- **#49 多模型对比重启后点开只剩提示词**:`loadHistoryGroup` 用的是 `Promise.all`——对比组每个模型一个成员条目,**任何一个成员任何一张图取不到**(文件被清理、404、一次瞬时失败),整批 rejected,`setImages` 与 `setBoardView` 都不执行,结果板停在「提示词 + N 张」的空白。单条生成只有一个成员,所以照常出图;四条模型的对比把「什么都不显示」的概率放大了四倍,正好是报告里的形状。现在每个成员各自 settle,一个坏成员只损失它自己。失败数**如实返回**而不是吞掉:静默少画两张会被读成「这次对比只出了两张」。
|
|
22
|
+
- **两条都是可复跑的用例,不是「改完看着没问题」**:`smoke-lan-bind-auth.mjs` 把真实路由表起在本机网卡上走真实 HTTP,10 条——含「外域 Host」「外域 Host 且自带自洽 Origin」「cross-site」「Origin 不匹配」四种仍然 403,以及**不传 `bindHost` 时局域网客户端保持旧 403** 这条反向控制(没有它,「一律放行」也能让正例全绿)。`smoke-history-group-images.mjs` 6 条,最后一条是反向对照:同样的输入交给旧的 `Promise.all` 折叠必须整组失败——否则断言太弱,测不出这个 bug。两个都进了 `pnpm test`,另有 `test:lan-auth` / `test:history-group` 单独入口。`smoke-lan-bind-auth.mjs` 自己探测本机非回环 IPv4,探测不到就明确 SKIP(不是「绿」)——测试只在作者那台机器上过,等于没测。
|
|
23
|
+
|
|
24
|
+
### 1.33.0 — 导演台换成真 3D + 时间轴;画布补上层级、锁定隐藏、套图、找节点、体检与目录
|
|
25
|
+
|
|
26
|
+
本版把 `v1.32.0` 的「静态构图导演台」升成「一段能播的镜头」。完整说明见 [docs/releases/v1.33.0.md](./docs/releases/v1.33.0.md)。
|
|
27
|
+
|
|
28
|
+
- **视口换成 three.js 真深度缓冲**:原来那层是手写的 2D 画家算法(metaball 球拼人、逐球排序)。它做不到的不是「不够精致」,而是**遮挡**——立方体摆在人前面挡不住人。换 three 的全部理由就是这一件事,已由 `verify-stage-3d.mjs` 的 V3 用像素证据守住(立方体在前 → 人偶只剩头肩)。人偶仍是同一份骨架求解与关节半径,两个渲染器画出同一种体型。
|
|
29
|
+
- **底部时间轴**:播放/暂停/逐帧/循环、2–15 秒、30fps、拖动 scrub、逐轨关键帧菱形、五种运动轨迹。时间以「秒」存、帧号是渲染期派生量;整份时间轴集中在 `stage.timeline` 而不是散落到 actor/camera 上,删角色时轨道不会成孤儿;关键帧所有字段可选,同一时刻「转身」与「摆姿势」是一条而不是两条。
|
|
30
|
+
- **轨迹与位置关键帧不是互斥的**:牧野在这一点上报 `motionPathsCannotCoexistWithPositionKeyframes`,我们选「活动区间内轨迹覆盖位置关键帧」。轨迹段在轨道上画成琥珀横条——一段区间用横条、一个时刻用菱形。
|
|
31
|
+
- **导出视频走宿主 ffmpeg 而不是 WebCodecs**:宿主本来就有 ffmpeg(`src/clip-compose.ts`),放上去之后画幅不受浏览器编码器能力表限制,也不用给用户看「当前浏览器不支持此画幅的 H.264 编码」。代价是逐帧上传(一帧 1–3MB,串行),取舍与「中止时已上传的帧靠会话超时清理」这个已知缺口都写进了 `stage-export.ts`。
|
|
32
|
+
- **没有 WebGL 就退回 2D**,不报错也不白屏。这条同时是验收里必须显式断言的原因:3D 静默回退会让一张「看起来还行」的截图其实验的是早就不用了的渲染器。`stage-preview-shot.mjs` 因此先断言视口 canvas 真有 WebGL 上下文,再加 `launchChrome({ gpu: true })`——那个 helper 的默认 `--disable-gpu` 会让 `getContext('webgl2')` 返回 null。
|
|
33
|
+
- **从截图里捞回并修掉的三个真问题**:① 结尾那颗关键帧菱形被轨道的 `overflow-x: hidden` 裁成「◀」——`left: 100%` 配 `margin-left` 只把中心拉回,右半边仍探到轨道外,改成 `calc(<百分比> - 3.5px)` 并给滚动容器留 `padding-inline`;② 轨迹条用 `brand-primary` 混色,而这套主题的品牌色**就是黑与白**(浅 `#0f1115` / 深 `#f9fafb`),`color-mix` 混出 `oklab(0.177 …)` 一条灰带,换成 `state-warn-primary`(两主题下都是 `#f59e0b`);③ 首帧取景贴着几何包围球算,最边上那个角色名标签被视口切掉一半(「角色B」只剩「角色」),放宽到 1.6 倍并改成首帧自适应取景。
|
|
34
|
+
- **调研结论留档**:[`docs/research/muye-director-desk.md`](./docs/research/muye-director-desk.md) 记录牧野工作台那块导演台的实测证据(WebGL2 真 3D、蒙皮 GLB 的 `JOINTS_0`/`WEIGHTS_0` 映射、固定 30fps 的校验文案、导出自动建节点连线)与「我们跟了什么、没跟什么」。
|
|
35
|
+
- **人形是放样出来的人体,不再是关节球串**:每一段(骨盆、腹胸、颈、头、大臂、小臂、大腿、小腿、手、脚)都是一串椭圆截面的放样面——胸腔左右宽前后薄、小腿肚后厚前薄、大腿上粗下细。原来那版是「每个关节一颗球 + 每根骨一根等粗圆柱」,横截面永远是圆,于是躯干是一根管子、大臂是一根管子,远看是球关节木偶、近看是几根香肠。肩肘膝胯踝保留外露小球:木偶人偶本来就这样,也补上两段放样弯到极限时的缝。「生成参考图」一并改走 3D——视口里是人体、导出却是 2D 球串的话,用户拿到的是一张和眼前完全不同的图。四处硬伤(头是扁碟、头又撑成 5.5 头身的大鸡蛋、肩线落在颈上导致手臂浮空、骨盆底是平切圆盘)都是拿放大图看出来的,现在由 `smoke-stage-humanoid.mjs` 的 11 条几何断言守着,做过反向注入(把头改回扁碟 → H1 / H11 立刻红)。
|
|
36
|
+
- **木偶的样子主要来自材质与光**:原来只有环境光 1.15 + 一盏平行光、无阴影,等于把形体全抹平。现在环境光 0.22 + 半球光 + 开投影的主光 + 冷色背光,木身 `#d9b483` 与关节 `#a7814f` 分两档颜色(浅木身配深关节才是木制人偶的辨认特征)。找过现成模型:唯一能直接下载的 CC0 木偶只有 6 个网格、肘膝不能弯;Mixamo 派生的 `Xbot.glb` 不能随包分发;`mannequin.js` 是 GPL-3.0。所以问题不在造型来源,在渲染。
|
|
37
|
+
- **导演台视口拖动/滚轮/重置一度全是死的**:面板把拖动写进自己的 `view` state,而它没有任何消费方——3D 场景的 `orbit()`/`zoom()`/`resetView()` 写好了却没有调用方;就算调用了也不动,因为它们只改 `orbitState`,出帧靠 `render(stage)`。现在 `StageViewRenderer` 加了三个可选转发方法,场景在相机变化后自己重画一帧。`stage-preview-shot.mjs` 补了一条逐字节对比拖动前后画布的断言。
|
|
38
|
+
- **验证**:`pnpm run test:stage` 79 条离线断言(含真 ffmpeg 编码 6 帧 → 真 mp4)、`verify-stage-3d.mjs` 真浏览器真 GPU 5 条、`stage-preview-shot.mjs` 五种宽度两套主题的截图 + WebGL 断言;画布侧 9 个纯函数套件(geometry 71 / layers 12 / node-flags 16 / prompt-set 14 / node-search 21 / health 18 / align 21 / history 23 / example 8)与新反向用例组全部接入 `pnpm test`;全量 `pnpm test` 与 `pnpm typecheck` 无回归。
|
|
39
|
+
|
|
40
|
+
- **图层顺序:置顶 / 置底 / 上移一层 / 下移一层**。这一版之前画布上**没有层级概念**:绘制顺序就是 `document.nodes` 的数组顺序,由「谁先被创建」决定,用户看不见也改不了。于是后来放上去的卡永远盖住先放的(想在图上面写字,字必须比图晚创建,否则被压在图底下、框选也选不到),而被盖住时画布只会描一条黄边说「这张被挡住了」,却不能把它拿到前面来。现在四个动作各有三个入口:右键菜单、⌘K 目录、键位(`⌥]` / `⌥[` 走一格,加 `⇧` 走到底,与 Figma 一致)。**顺序存在数组里,不新增 `z` 字段**:老文档零迁移、不会有「两个节点 z 相同」的并列态、撤销栈里一次层级调整就是一次普通的数组变化;末尾在最上面。**多选当刚体**:`layer-order.ts` 先把整组折成一个槽位再跨过紧邻的那一张,逐个 `splice` 会让三张卡的内部次序反转(a,b,c 变 c,b,a),而用户没有要求过。**`coveredNodes` 跟着改了语义**:原来只按几何包含判定谁盖住谁、不看绘制顺序,层级可改之后就成了真 bug——小卡明明画在上面却被报成被盖住,而置顶之后提示还不消失;现在方向由下标唯一决定。**关掉 react-flow 的选中提权**(默认给选中节点加内联 `z-index: 1000`,被置底的卡一点中就跳回最上层,刷新后又是对的),`flowNodes` 显式写下标为 `zIndex`。验证:`smoke-canvas-layers.mjs` 12 条(整组跨一位、已到位不动、幂等、上移再下移回原样、不复制对象)+ `smoke-canvas-geometry.mjs` 的 G10–G12(层级决定方向、置顶后不再报、三张嵌套)+ 契约组 11 条(一次 `mutate`、`moved === false` 不写、四行接到对的方向、右键四个方向齐、键位读 `event.code`)+ 反向注入 7 条。
|
|
41
|
+
- **真机截图捞回来的一个真问题**:被完全盖住的那张卡上,「与「X」完全重叠」的琥珀徽标**自己也被盖住了**。它原本挂在被盖住卡片的右下角,而那恰好是它最不能待的地方——以前只是靠着 react-flow 给选中节点加的内联 `z-index: 1000`(拖动会选中被拖的那张)碰巧浮上来;选中提权一关,它就彻底消失,截图里只剩一圈也在下面的黄边。现在徽标由画布覆盖层 `.world` 按被盖住卡片的右下角绘制:它说的是画布层面的事实(谁压着谁),就该由画布这一层来说,坐标跟着世界变换一起平移缩放。
|
|
42
|
+
- 上面这条由两条反向断言守住:徽标回到卡片内 → 红;覆盖层不再画它 → 红。加上 `smoke.mjs` 的 (7e):右键四行都在且带键位、置顶真的写进文档、置底后一次撤销回原样、已在最下面再置底既不写也说出来。
|
|
43
|
+
- **拖动时的吸附参考线**。吸附(`snapOffset`)一直都在,但它只改坐标、不留痕迹:卡片在离邻居 3px 时自己「跳」到贴边,用户看到的是一次无法解释的位移。现在拖到对齐位时画一条红线(`snapGuides`),松手就消失——线与吸附**分开算**:吸附拿拖动原点和位移,线拿「已经落位之后」的位置,只问「谁跟谁重合」;写成一个函数会让「吸附算错」和「线画错」两种症状混在同一个返回值里。容差是世界像素的半个像素(位置在拖动里被取整,所以「重合」就是精确相等,留半个吸收缩放浮点误差),同一条坐标上的多根线合并成一个区间——一列整齐的卡只画一条长线而不是三条重叠的。与节点过滤同一条纪律:只对着画面上的卡吸附与画线,对着藏起来的卡会让可见的那张停在空处、而画面上没有任何东西解释它为什么停在那里。测试:`smoke-canvas-geometry.mjs` 的 GG1–GG6 + 契约组 3 条 + 反向注入 4 条。
|
|
44
|
+
- **节点锁定 / 隐藏**。上一版把叠放顺序交给了用户,跟着来的第一件事就是「我不想动它」和「我现在不想看见它」。锁定(`⌥⇧L`)拒绝四件事:拖动、删除、批量删除、整理画布——锁不住 Delete 的锁等于没锁,而用户正因为相信它锁上了才敢把它留在那里。隐藏(`⌥⇧H`)把卡片从渲染、框选、`⌘A`、缩略图、`fitView` 里一起摘掉,**连线跟着一起消失**(只过滤卡片会在画面上留下一条通往空气的线,那比整条线不画更让人困惑)。两个标记都住在 `node.metadata` 里,老文档零迁移。三个刻意的取舍:① 锁定按「这组里还有没锁的吗」决定方向,混选时按下去是**锁**而不是一个永远猜不准的三态开关;② 复制 / 粘贴 / 原地复制**都清掉标记**——复制一张锁住的卡,用户要的是「再来一份能动的」,复制一张藏起来的卡则会让粘贴完屏幕上什么都没有;③ 隐藏是单向门,所以底栏常驻一条「N 张卡片已隐藏 / 全部显示」,找节点(`⌘F`)也仍能搜到藏起来的卡并标出「已隐藏」,跳过去时自动把它叫回来。测试:`smoke-canvas-node-flags.mjs` 16 条(严格 `true`、引用相等、顺序、`unlockedIds` 不改入参、连线两端、复制真实路径)+ 契约组 9 条 + 反向注入 7 条。
|
|
45
|
+
- **套图(提示词组):N 条不同提示词各出一张**。原来画布上只有 `count`(同一条出 N 张,用来挑最好的一张);套图是它的反面——一个配置卡上挂一组带标题的提示词(正面 / 侧面 / 背面…),跑一次各出一张,标题落到结果卡上。**两者的语义相反,没有合并**:把套图做成 `count` 的扩容会让填 3 想出三视图的人拿到三张一样的正面。住在自己的字段 `node.metadata.promptSet`(`{id,title,prompt}[]`,上限 12),老文档零迁移。UI 是 composer 那一侧的三态切换(单张 / 套图);卡片上只显示一枚只读徽标「套图 · N 条」——**不在卡片上再加编辑入口**,否则撞「一个提示词只准有一个编辑入口」那条守卫(那条守卫守的是「看起来能编辑、写入却没人读」的假入口)。提交路径按套图跑:每条独立 `api.taskSubmit`、各自 taskId、各自占位卡、各自标题,回填路径按 taskId 配 asset 天然就是「一个任务一个占位」。三条边界全在纯函数层 `canvas/prompt-set.ts`:空提示词条目丢弃(否则白跑一次)、标题截 24 字、超上限截断——写侧 `normalizePromptSet` 保留空条目(用户正在打字,保存瞬间消失会让光标跳走),读侧才丢。测试:`smoke-canvas-prompt-set.mjs` 14 条 + 契约组 1 条(三处入口 + locales 三块数量)。
|
|
46
|
+
- **调研留档与一个可复跑的大图基准**:[`docs/research/canvas-workflow-benchmark.md`](./docs/research/canvas-workflow-benchmark.md) 对照 LibTV / Figma Weave / ComfyUI,按 P0 保存恢复、P1 定位与编辑响应、P2 复用交付给出固定场景与验收门槛;`scripts/benchmark-canvas-interaction.mjs` 在 200 / 1000 节点上量缩放帧耗时、平移帧间隔与搜索命中时间(`long-animation-frame` 优先,取不到时退回 `longtask`),只量不写宿主画布,声明为手动脚本——它需要一个已经导入基准画布的真宿主,天然进不了门禁。
|
|
47
|
+
|
|
48
|
+
- **刚装好的画布不再自带一份「已保存的画布」**:以前打开画布标签页时,只要画布库是空的就立刻 `canvasCreate` 落盘一份,并往里塞一对示例节点(标题「示例:第一张图」+ 一句柴犬提示词)。用户从没建过它,下拉里却多一份,删掉还得多按一次;更糟的是空态(那排快捷卡)因此永远渲染不出来——种子固定注入两个节点,`nodes.length === 0` 从未成立。现在首屏与「+」给的都是**内存草稿**(状态条如实写「未保存」),只有用户真往里放了东西(建节点 / 落图 / 粘贴 / 拖文件)才创建画布;删掉最后一份画布同样回到空草稿,而不是悄悄补一份新的。示例种子与它的三语文案随之下线。反向注入实测:把挂载时的 `canvasCreate` 放回去 → E1 红(「opening the canvas with an empty library creates no canvas on disk」)。
|
|
49
|
+
- **测试不再往用户真实的数据目录里写画布**:上面那条「首次打开就落盘」是产品行为,另有一条测试侧的:`~/.dsh/dsh-imagegen/canvas/` 与测试目录只差一个 `DSH_HOME`,不设它就等于指到家目录,而 `canvas/create` 是真写盘。2026-10-13 到 10-15 三天里这样攒下 1408 条 `gone`/`deck`/`extract`/`polish`/`files`(内容是一个 `report.txt`),用户的画布下拉从可用变成 1425 条滚不完的列表。`smoke.mjs` 早在 `c10cf07` 就有了隔离,但那补的是**一个脚本**而不是一条规则。新增 `scripts/verify-test-isolation.mjs`:扫出所有会写画布的脚本,要求它们的 `DSH_HOME` 指向 `mkdtempSync()` 建出的目录;接进 `pnpm test` 与 `test:negative`(新组 `isolation`)。判据是「赋值成了什么」而不是「有没有赋值」——反向验证在这上面连挂三次:注掉的赋值、字符串字面量、`= previousDshHome`(恢复原值)都曾被当成隔离证据,每次都是「缺陷还在、守门却绿」。反向注入实测:把 `smoke.mjs` 的 `mkdtempSync` 赋值注掉 → 守门红(退出码 1)。
|
|
50
|
+
- **整理画布(⌥⇧F)**:一张有向图排成从左到右的列。分层不另起一套,直接复用执行器用的 `planLayers`——整理出来的第 N 列就是运行时第 N 层,看图顺序与跑图顺序不会打架。四条硬边界:**有环拒绝**(环上的节点没有「第几层」,照排会得到一张井然有序却跑不起来的图);**没接线的卡片不混进第一层**(它们不是流程源头,落在流程下方两倍行距的停放带里,保持原有左右顺序);**原地整理**(锚点是当前包围盒左上角,视野不动,否则按下按钮的瞬间像点空了);**幂等**(连按两次逐字节相同)。层内按用户原来的 `y` 排序而不是边的插入顺序——他有意摆在上面的那张卡,整理后还在上面。整件事是一次 `mutate`,撤销按一下就回到整理前。反向注入 8 条(几何组 7 条 + 契约组 1 条视口)。
|
|
51
|
+
- **运行前就说清楚哪张卡跑不了**:`canvas/readiness.ts` 把「缺什么」从卡片内的一枚徽标扩成一次全图扫描,与 `node-body.tsx` 读同一组事实(标注卡不算提示词、空 asset 不算参考图、`renderer: 'code'` 免模型渠道)。「运行工作流」旁边的箭头按钮现在会写「2 个节点没准备好:缺提示词」而不是等用户按下去、跑到一半才发现。
|
|
52
|
+
- **上一次运行的失败留在画布上**:`canvas/run-marks.ts` 把结局折成两种标记——实线红「这次失败」、虚线橙「被跳过,没跑」。只有 `completed` / `cycle` 不留痕;`cancelled` 也落痕,因为「按停之前就已经失败」的节点是真的坏了。新一轮开始时清空,单节点重试只摘自己那颗红标(下游仍没有产物,标记不能跟着清)。缩到 40% 时颜色会先糊掉,所以两种标记同时用线型区分。反向注入 6 条(其中一条「取消分支漏落痕」正是新断言当场抓出来的:纯函数说对、接线没做)。
|
|
53
|
+
- **全部功能目录(⌘K / 底栏放大镜)**:画布的能力原来散在底栏 14 格、节点悬停条、右键菜单三处,每一处只在自己那类动作里给得全,于是「拼接视频」要先选中两段视频才看得见。现在一张 47 行的可搜索表把全场动作收在一起:六个分组(添加 / 运行 / 编辑 / 视图 / 画布 / 帮助),中英文同义词都能搜(「接片」「排版」「ffmpeg」「storyboard」),↑↓ 只在能点的行之间走,回车执行。**不可用的行不隐藏**,压暗并写明原因(「先选中至少两段视频」)——藏起来等于告诉用户「这个功能不存在」。每一行都由 `Record<CapabilityId, () => void>` 强制接上一段真代码,契约组比对目录与动作表两侧的 id,多一行少一行都红。反向注入 6 条(几何组 4 条:只搜标题 / 藏起不可用项 / 方向键停在灰行 / 灰行排前面;契约组 2 条:某行没接 / 执行前不关弹窗)。
|
|
54
|
+
- **顺手修掉的两个「声明被浏览器丢弃」**:`--dsw-alias-border-secondary`(画布提案条的接受/丢弃按钮)与 `--dsw-specific-sidebar-nav-item-hover`(侧栏入口的悬停底色)在 DSH 里都不存在,整条 `border` / `background` 声明会被丢掉——按钮没边框、入口悬停毫无反馈。换成契约文档给的 `border-l2` 与 `interactive-bg-hover`。这条是 `verify-native-ui` 在 `DSH_ASAR_DIR` 指到真机安装目录时才会报的,平时 skip 所以一直没露。
|
|
55
|
+
- **找节点(⌘F / 左下放大镜)**:画布少则五张卡、多则上百张,用户知道「我要找那张写着樱花的图」,却只能缩到 10% 自己扫。现在一个搜索框同时搜标题、正文、提示词、模型名:中英文、全角空格、多词「都要命中」;同一张卡只出一条结果(字段按 标题 > 正文 > 提示词 > 模型 逐级退让),结果行显示的是**命中的那段原文**而不是标题——搜「樱花」命中一张叫「街景」的图时,只显示标题这一行就解释不了自己为什么在结果里。回车跳过去、选中它、并把它放进视野正中:视野计算走有单测的 `focusViewport`(0 尺寸视口、Infinity 输入、缩放夹取都在那里守住,NaN 一进 `transform` 整个画布会变空白且不报错),顶栏与底栏是浮层,所以可画区域从顶栏下方算起。⌘F 原本会拉起浏览器的页内查找——在一个铺满画布的应用里,那个框永远找不到用户想找的**卡片**。
|
|
56
|
+
- **画布体检:一次看全「这张图为什么跑不起来」**:执行器的报错是「跑到哪一步才说哪一步坏了」,用户面对一张图要改一个、跑一次、再撞下一个。`canvas/graph-health.ts` 一次算全五类问题——环、残线(指向已删除节点的连线)、空配置(没有上游输入)、未就绪配置(缺提示词 / 模型 / 渠道)、孤立产物。三条与执行器对齐的口径:环的判定直接复用 `planLayers`(两份图论逻辑迟早分叉成「体检说能跑、按下却失败」);环只描**真正在环上**的节点,不含挂在环后面的下游(否则用户顺着高亮找不到那根首尾相接的线);残线绝不因为它把某个节点算成「有上下游」。清单出现在「运行工作流」的选项菜单里——用户打开它正是在问「这一次怎么跑」——每一条都可点,点了跳到那张卡并选中。阻断项永远排在提醒项前面:一条「这张图有环」如果排在「有张图没人用」后面,用户可能根本滚不到。
|
|
57
|
+
- **空画布多一张「载入示例」**:前五张快捷卡都在要求用户先知道自己要放什么、怎么连,而第一次打开画布的人恰恰不知道。第六张一次落一条 提示词 → 配置卡 的链(列间距取整理画布同一档,两卡中心线严格对齐),选中配置卡并提示「按生成就能出图」。整件事是**一次** `mutate`:分几次写会在撤销栈里留下几条记录,按一次 Ctrl+Z 只撤回半条示例,剩下的半条既跑不了也删不干净。
|
|
58
|
+
- **历史面板:一次退回「还没乱的那一版」**:撤销一次只退一步,而真实用法是「刚才连着做了七八件事,想退回还没乱的那一版」——那时用户不知道要按几次,也不敢按。现在**按住 Shift / Option 点撤销**、或**右键撤销**,弹出这张画布的全部历史:每步一行(「移动 3 个节点」「删除图片节点」),点一行就退回那一步。文案与撤销按钮调同一个 `describeStep`,两处不可能对不上。三条边界:当前状态也占一行(不可点,否则用户以为最上面那行就是现在);坏快照**截断不跳过**(`stepsBack` 是相对栈深的偏移,跳一格会让下面每行都退到错的地方);只动视口的一步不列出。回退 N 步是一次文档替换而不是循环 `undo()`——栈同步改、`document` state 不是,中间帧读到的 `documentRef` 还是旧的。重做栈逐条回填,所以退回去之后 Ctrl/⌘+Shift+Z 仍能一步步走回来。规范在 `history-model.ts` 的 `historyRows`(单测 19 → 23 条),面板只负责画。
|
|
59
|
+
- **⌥ 系列快捷键在 macOS 上从来没生效过**:真机实测(headless Chrome + CDP 派发原生键码)确认,按住 Option 时 `event.key` 是**该布局下的组合字符**——⌥F 给 `ƒ`、⌥A 给 `å`、⌥H 给 `˙`。所以 `altKey && key === 'f'` 永远不成立,「整理画布」的 ⌥⇧F 自上线起按了没反应且不报错,源码读起来却一切正常。全部改按 `event.code`(物理键位)。同时补上一组对齐键位:⌥⌘← / → / ↑ / ↓ 四边对齐,⌥⌘H / V 水平、垂直居中,⌥⌘E 水平等距(垂直等距没有键位——写在表里而按不出来比不写更坏)。键位只在 `ShortcutHelp.tsx` 的 `CANVAS_SHORTCUTS` 写一份,多选对齐条的 tooltip 通过 `shortcutKeysFor` 反查,两处不会走散。
|
|
60
|
+
- **目录从 30 行长到 47 行**:补进历史面板与 8 个对齐/分布动作(选中不足两张 / 三张时压暗并说明原因),全部接真代码。
|
|
61
|
+
- **历史面板的两个「点下去之前先知道」**:悬停某一行时,画布上这一步会动的那几张卡描一圈虚线(`outline`,不改几何,指针扫过一列行时画布不抖;预览不写文档,否则撤销栈里会多出几十条空步骤);退回去之后选中这一步动过的卡,并与目标文档求交(「删除」类步骤点名的节点已经不存在,不筛就会选中幽灵)。Esc、点一行、关面板三个出口都清预览。
|
|
62
|
+
- **目录行尾的键位徽章**:每行显示对应快捷键,没有的不显示、不留空列;灰行不显示(等于承诺能用)。键位只从 `shortcutKeysFor` 取一份。做这件事时揪出一个一直在撒谎的文案:`canvas.duplicate` 写的是「创建副本 (Ctrl+D)」,macOS 上按的是 ⌘D,而这半句括号也不参与反查,于是目录里那一行永远没有徽章。现在文案只留动作名,右键菜单与节点工具条改走 `labelWithKeys`;`canvas.paste` 同一类问题,快捷键表里这两条也补了 `action`。
|
|
63
|
+
- **预览构建的两个打包清单漏项**(`three` 的裸包名与它的 `examples/jsm` 子路径分别列):漏掉时预览页整块白屏,报的是 `three is not defined` / `unexpected require`,读起来像 3D 那一块的 bug,实际缺的是清单里的一行。
|
|
64
|
+
- **一条只看得见第一处的守卫**:套图「编辑器不许进参数排」的契约检查只取第一个 `.composerControls` 块,注入点在它之后,于是缺陷回来、检查照样绿(反向用例组报 FALSE GREEN)。改成按标签配对切出所有参数排逐个检查;contracts 组 93/93 现在全部能打红。
|
|
65
|
+
- **多选对齐条(左/中/右、上/中/下、水平/垂直等距)**:选中两张以上时,底栏上方出现一条 8 枚按钮的对齐条;两张时两枚「等距」压暗并**写出原因**(「至少要选中三个节点」)——一枚只是灰着、不说为什么的按钮会让用户以为是自己选择方式不对。规则全在 `canvas/align-model.ts`(21 条单测):只动选中、**分组是刚体**(只选中组里一个成员时,整组按同一个整数 delta 平移,否则用户以为只对齐了一张卡、实际把组拆了)、内部跑到**不动点**(宽度奇偶不同的卡居中时半像素取整会让第二轮再动一像素,所以交给界面的必须是映射的不动点)、结果全在整数格点上。接线侧钉了三条:一次 `mutate`(撤销一次退回到对齐前,而不是「按一次退一张卡」)、`moved === 0` 不写(已经对齐的图按一下不该多出一条空撤销)、拒绝与「没变」都说出来。
|
|
66
|
+
- **对齐条为什么不在 `bottom: 66px`**:它第一版就是又一个绝对定位浮层,真浏览器布局守卫当场量到它在 860px 及以下压住缩放排 805–7625px²。底栏、缩放排、缩略图当年各自绝对定位时犯过同一个错,改成同一条 `flex-wrap` 行之后才不再互相压住。现在拼接条与对齐条都是那一行的成员、各自 `flex-basis: 100%` 独占一行,几何上不可能重叠;守卫也扩到 8 个两两组合,失败时逐对报面积。
|
|
67
|
+
- **撤销/重做按钮说得出「这一步是什么」**:`canvas/history-model.ts`(23 条单测)把前后两份快照折成一句话——新增 / 删除 / 移动 / 编辑 / 连线 / 断线 / 分组 / 改标题 / 换背景,互相独立的两类合成「改了 N 项」。三条口径:删节点**连带**删掉的线不算第二次变化(否则每次删卡都变成「混合操作」,tooltip 永远说不出「撤销删除」);新节点自带的自动连线归给新增;只动视口不报成改了节点。`arrange` 刻意不由纯函数产出——「整理画布」与「多选手拖一批节点」在两份快照里是同一件事,猜错就是撒谎。接线侧每 160ms 防抖算一次:`document` 在拖动时每帧都换对象,不防抖等于每像素 `JSON.parse` 一次几十 KB 的栈顶快照。
|
|
68
|
+
- **分镜镜头时长按模型收窄,台词装不下时说一句**:`SHOT_SECONDS` 补上 12 / 15,并按所选模型**显式声明**的 `catalog.durations` 收窄——模型只收 6/10/15 就只列这三个,而不是拿一个 4 秒去换一次 400。这里刻意用 `catalog.durations` 而非 `durationsOf(catalog)`:后者在模型未声明时返回面板通用默认 `[5,10]`,会把 Seedance 实际支持的 4–15 一起抹掉。老文档里存着当前模型不收的秒数时把该值插到选项最前,不静默改写文档。`shotSpeechFit` 按 4.5 字/秒 + 2 秒表演余量估时,超了在这一镜下面单独显示一行警示——是**提醒**不是**错误**:不染红边框、不禁用运行按钮。
|
|
69
|
+
- **分镜执行接上身份参考;「接上一镜尾帧会丢参考」写在板上**:`submitShot` 原先只做了 `carry` 的尾帧 → 首帧,`castRefsFor` / `castPromptOf` 只在两个 composer 里被调用,所以钉住「阿禾」后在分镜里连跑十条,十条都没有她的图。现在 `cut` 与 `carry` 首镜带最多 4 张身份参考(`MAX_SHOT_REFERENCES`),第一张进 `frames.image`、其余进 `frames.images`,读不出的那张跳过而不是整镜失败;顺带修掉 `castLine` 的 0 基序号(提示词里原本写「参考图 0 是角色…」)。`carry` 第 2 镜起带不上参考**不是漏接线而是契约互斥**(`first_frame` / `last_frame` 与 `reference_image` 在 Seedance / MiniMax 里不能混用)——接缝优先是对的,但用户只会在成片里看见她悄悄变了,所以板上多一行说明会丢哪些镜头、丢几个,对应行挂一枚「不带身份参考」角标:一粒角标而不是整行染色,这一镜仍然能跑。反向注入实测:把 `castSlots` 写死成 0 时所有源码 grep 仍绿,只有 SB5 的运行时断言变红(请求体里没有那张图)。
|
|
70
|
+
- **「镜头衔接」下拉在 380px 卡片里被截断**:那一格只有 65px,而 `接上一镜尾帧` 需要 94px;英文 186px、俄文 203px(那一格缩到 27px,几乎只剩箭头)。根因是三格 `flex: 1` 的 basis 为 0、永远等分。改成按内容起算 + 允许换行:中文仍是一行 26px,英俄各两行 58px,镜头列表本来就是 `flex: 1` 的滚动区,少 32px 挤不掉底部按钮。三种改法在真浏览器上量过 380 / 420 / 560px × 三语;`verify-canvas-layout.mjs` 新增三语量宽断言,反向注入(退回三格等分)实测变红。
|
|
71
|
+
|
|
72
|
+
### 1.32.0 — 姿势人偶升级成导演台:一个场景、多个角色、多台机位;画布底栏改成三档层级
|
|
73
|
+
|
|
74
|
+
本版把 `v1.31.0` 的「原生姿势节点」升成导演台。完整说明见 [docs/releases/v1.32.0.md](./docs/releases/v1.32.0.md)。
|
|
75
|
+
|
|
76
|
+
- **卡片瘦身 + 全屏编辑面**:卡片只剩「预览 + 机位名 + 打开导演台 + 预设条 + 生成参考图」;摆位与摆姿搬进全屏三栏面板(左栏场景与角色/机位列表、中央视口带视角切换与视锥、右栏场景参数、底部机位截图与场景描述)。
|
|
77
|
+
- **一个场景里多个角色**:每个角色各自成一张遮罩、按中心深度排序合成。合并进同一个距离场会把接壤处的轮廓融成一块——后排的人会像贴在前面那人身上的一个鼓包,前后关系丢失。
|
|
78
|
+
- **加角色立刻重新取景**:新角色排在右侧 1.2 m,不重新取景它会站到画外,用户会以为按钮没生效。这牵出更深的一处:环绕相机的水平注视点原先硬编码在原点,三个人并排时只拉远相机不够,画面中心仍盯着原点、第三人被裁。现在 `PoseCamera` 带可选 `targetX` / `targetZ`(缺省 0,姿势面板行为不变)。
|
|
79
|
+
- **老文档零迁移**:只有 `metadata.pose` 的节点按单角色舞台读出,不写盘、不改字节;写盘时 `stage` 与 `pose` 双写(`pose` 镜像 `actors[0].rig`),带三个角色的文档在旧版插件里仍是一张能用的姿势人偶;读盘以 `stage` 为准。
|
|
80
|
+
- **成品仍是普通图片**:机位截图导出 1280×1280 PNG 落成节点 `asset`,下游全链路零改动。
|
|
81
|
+
- **两条检查是从真机走查里回来的**:遮罩贴回时漏了 `fieldCell` 倍放大(人偶体块只有骨架的 1/2.4),以及上面那条水平注视点。二者都写进了 `scripts/smoke-pose-stage.mjs`(20 条)与真浏览器守卫 `scripts/verify-pose-panel.mjs`。
|
|
82
|
+
- **底栏从「18 个同权重图标」改成三档层级**:原来一排 17 个 40px 方块加 5 条竖线,每个都得悬停才知道是什么,读不出「从这里开始」。现在(1)左侧一个**实底 `+`** 收掉文本 / 画板 / 姿势 / 分镜 / 文件 / 配置六个建节点图标,点开是它们各自的菜单,`+` 在任何画布应用里都是「新建」;(2)5 条竖线换成留白的分组间隔——1px 线在 13 个格子上画出了一张表格,每格看起来同权;(3)右侧**「运行工作流」带文字**,箭头并进同一块药丸只开选项菜单——一排纯图标只能靠逐个悬停学会,而「把这张图跑成片」是画布存在的理由。(1)和(3)与弹簧引擎的边界是显式的:`+` 仍是 40px 方块、照常参与悬停放大,只是多了个实底类 `.dockPrimary`;带文字的主动作用 `data-dock-static` 退出引擎——引擎写的是内联 `width`,那会把文字药丸压到 40px 并裁掉标签。真机走查还捞到两个离线测不出的:`+` 菜单最初借 `.contextMenu` 又覆盖了它的 `transform`,弹出位置偏了 52.5px;分组间隔取 10px 时 900px 面板下「删除」掉到第二行,看起来像少了一个按钮——现在收到 6px,并在 `scripts/verify-canvas-layout.mjs` 补上**行数检查**(720px 及以上必须单行;反向注入把间隔调宽,860px 立刻变红)。
|
|
83
|
+
|
|
8
84
|
### 1.31.0 — 画布四件新事:Agent 改画布前先提案、连线说明用途、节点成组、原生姿势人偶
|
|
9
85
|
|
|
10
86
|
本版是 `v1.30.4` 之后累积 40 个提交的一次发出,含四块独立内容与两条社区 issue 的修复。完整说明见 [docs/releases/v1.31.0.md](./docs/releases/v1.31.0.md)。
|
package/README.md
CHANGED
|
@@ -83,6 +83,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
|
|
|
83
83
|
| **无限画布** | 把提示词、参考图和生成节点连成可迭代的创作流程。 |
|
|
84
84
|
| **视频节点与拼接** | 视频节点与图片节点同一套控制;多选后按画布位置拼成一条成片。 |
|
|
85
85
|
| **分镜节点** | 一列镜头各出一段视频,可接上一镜尾帧;成品就是普通视频节点,同样能拼接。 |
|
|
86
|
+
| **3D 导演台** | 一个场景摆多个角色与机位,时间轴打关键帧,导出视频或参考图。 |
|
|
86
87
|
| **时间线与身份锚定** | 成片可以在时间线里排序、裁剪、加转场再拼;钉住的角色/物品会跟着后续每一次生成。 |
|
|
87
88
|
| **电商套图** | 从商品参考图生成主图、卖点图、场景图等成套素材。 |
|
|
88
89
|
| **服饰穿戴** | 商品试穿与角色搭配;人物、服装、姿势来自内置图库,自己的模特库就在人物图库里,也可上传或 AI 生成。 |
|
|
@@ -103,9 +104,17 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
|
|
|
103
104
|
<details>
|
|
104
105
|
<summary><b>画布、文件节点与技能细节</b></summary>
|
|
105
106
|
|
|
106
|
-
-
|
|
107
|
-
-
|
|
107
|
+
- 支持图片、文本、视频、生成配置、文件、**导演台**与**分镜**节点;图片节点可标注、移除背景或拆分图层。
|
|
108
|
+
- **导演台**(原「姿势节点」):一个场景里摆多个角色、多台机位、天空与地面,视口是 three.js 真三维——前后遮挡成立(立方体摆在人前就真的挡住人),没有 WebGL 的机器自动退回 2D,不报错、不白屏。底部时间轴固定 30fps:播放 / 暂停 / 逐帧 / 循环、时长 2–15 秒、拖动 scrub、逐轨关键帧菱形与五种运动轨迹。顶栏「导出视频」逐帧渲染后交给宿主 ffmpeg 编成 mp4,落成一个普通视频节点并与导演台连线;「生成参考图」导出的就是视口里那一帧(1280×1280 PNG)。成品仍是普通图片 / 视频节点,下游生成与导出不需要知道「导演台」存在。老画布里的姿势节点按单角色舞台读出来,零迁移。
|
|
108
109
|
- **节点成组**:框选几个节点右键「成组」,之后拖任一个整组一起动;解散、改名、删成员都会自动收拾。框的位置由成员算出来,不存第二份坐标。
|
|
110
|
+
- **图层顺序**:置顶 / 置底 / 上移一层 / 下移一层,右键菜单、⌘K 目录、键位(`⌥]` / `⌥[`,加 `⌥⇧` 置顶置底)三个入口。顺序存在节点数组里、不新增 `z` 字段,老文档零迁移;多选时整组当刚体跨一位,不会把组内次序弄反。
|
|
111
|
+
- **锁定 / 隐藏**:`⌥⇧L` 锁定的卡片不再跟随拖动、也不会被删除或批量整理(仍可选中,否则没法解锁);`⌥⇧H` 隐藏的卡片从渲染、框选、`⌘A`、缩略图、`fitView` 一起摘掉,连线同步消失,底栏留一条「N 张卡片已隐藏 / 全部显示」把它叫回来。复制出来的卡片不带这两个标记。
|
|
112
|
+
- **全部功能目录(⌘K)与找节点(⌘F)**:一张可搜索的目录把六个分组、四十多个动作收在一起,中英文同义词都能搜,↑↓ 只在能点的行之间走;不可用的行不隐藏,压暗并写明原因。找节点同时搜标题、正文、提示词与模型名,结果行显示命中的那段原文,回车跳过去、选中它并居中。
|
|
113
|
+
- **画布体检与整理画布**:体检一次算全五类问题(环、残线、空配置、未就绪配置、孤立产物),按「阻断项在前」排好,每一条都能点过去;整理画布(`⌥⇧F`)把有向图排成从左到右的列,遇到环直接拒绝,没接线的卡片停在流程下方的停放带里,连按两次结果不变。
|
|
114
|
+
- **多选对齐**:选中两张以上时底栏上方出现对齐条(左/中/右、上/中/下、水平/垂直等距),只动选中、分组当刚体、结果取整并跑到不动点;不够两张、三张时按钮压暗并写出原因。
|
|
115
|
+
- **撤销说得出「这一步是什么」,历史面板能一次退几格**:撤销按钮的提示由 `history-model` 把两份快照折成一句话;按住 Shift / Option 点撤销或右键撤销,列出每一步并可直接跳回,跳回是一次文档替换,重做栈仍可逐步走回来。
|
|
116
|
+
- **套图(提示词组)**:一张配置卡上挂一组带标题的提示词(正面 / 侧面 / 背面…),一次提交各出一条,每条是独立任务、落成自己的占位卡与标题。它和「生成数量」是两件事:数量是同一条出 N 张,套图是 N 条各出一张。
|
|
117
|
+
- **首次打开画布**:空态只给内存草稿(状态条如实写「未保存」),不放一份用户没建过的画布;六张快捷卡里有一张「载入示例」,一次落一条提示词 → 配置卡的链,按生成就能出图。
|
|
109
118
|
- **连线说清用途**:连线可标首帧 / 尾帧 / 素材,视频插帧不再按数组顺序猜。标记只在画布上生效,老画布保持原样。
|
|
110
119
|
- **生成前自动连边**:图拖到配置节点旁边却没拉线时,提交生成那一刻会把近处的图补成连线(边缘距离在 1.5 个节点短边内,最多 4 张),补出来的线看得见、删得掉、一步就能撤销。
|
|
111
120
|
- **Agent 改画布先出提案**:对话里的 Agent 想增删节点、连线时,改动先出现在画布右上的提案条上,写明「接受之前画布不会有任何变化」;接受是增量的,你自己拖过的坐标、改过的标题都留着。
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# v1.32.0 — 姿势人偶升级成导演台:一个场景、多个角色、多台机位
|
|
2
|
+
|
|
3
|
+
> **版本说明**:本版把 `v1.31.0` 里的「原生姿势节点」升成「导演台」。节点类型没变(仍是 `type: 'image'` + metadata 活数据 + 导出 PNG),老画布零迁移。
|
|
4
|
+
|
|
5
|
+
## 之前是什么样
|
|
6
|
+
|
|
7
|
+
一个姿势节点就是**一个人**:17 个关节、11 个预设、一张 1024 PNG。想画两个人对话,只能放两个独立节点——它们各自有自己的相机、自己的地面、自己的光照,拼在一起像是两张贴图并排,而不是一个场面。
|
|
8
|
+
|
|
9
|
+
## 现在
|
|
10
|
+
|
|
11
|
+
一块卡片瘦成「预览 + 机位名 + 打开导演台 + 预设条 + 生成参考图」,摆位与摆姿搬进全屏面板:
|
|
12
|
+
|
|
13
|
+
- **左栏**:场景列表(机位与角色一起列,可搜索、可增删)。
|
|
14
|
+
- **中央视口**:导演视角 / 机位视角切换,拖动环绕,滚轮缩放,X/Y/Z 罗盘,机位视锥线框。
|
|
15
|
+
- **右栏**:场景缩放/平移/旋转、天空色、全景背景、角色标签、当前角色或机位的参数。
|
|
16
|
+
- **底部**:机位截图、一句话场景描述。
|
|
17
|
+
|
|
18
|
+
### 三个角色、三种姿势,一张画面
|
|
19
|
+
|
|
20
|
+
多角色不是把所有人的球体并进同一个距离场——距离场是**屏幕空间**的,合并之后两个人接壤处的轮廓会被 smooth-min 融成一块,后排的人像贴在前面那人身上的一个鼓包,前后关系彻底丢失。每个角色各自成一张遮罩、按中心深度排序、依次贴上去,遮挡才成立。
|
|
21
|
+
|
|
22
|
+
### 加了人就立刻重新取景
|
|
23
|
+
|
|
24
|
+
新角色排在已有角色右边 1.2 m。不重新取景的话它会站到画面外,用户看到的是一张没变化的图,只会以为按钮没生效,然后一直点,最后堆出五个看不见的人。
|
|
25
|
+
|
|
26
|
+
这条也牵出一个更深的问题:环绕相机原先只有 `targetY`,**水平注视点被硬编码在原点**。三个人并排时只把相机拉远是不够的——画面中心仍然盯着原点,第三人被裁在画外。现在 `PoseCamera` 带可选的 `targetX` / `targetZ`(缺省即 0,姿势面板的行为不变),取景会真的把画面中心挪到人群中间。
|
|
27
|
+
|
|
28
|
+
### 老文档零迁移
|
|
29
|
+
|
|
30
|
+
- 只有 `metadata.pose` 的老节点:按单角色舞台读出来,不写盘、不改字节。
|
|
31
|
+
- 写盘时 `stage` 与 `pose` 一起写,`pose` 镜像 `actors[0].rig`——一份带三个角色的文档在旧版插件里仍是一张能用的姿势人偶,而不是一张读不懂的图片。
|
|
32
|
+
- 读盘以 `stage` 为准:`pose` 没有能力表达其余两个角色。
|
|
33
|
+
|
|
34
|
+
### 成品仍是普通图片
|
|
35
|
+
|
|
36
|
+
机位截图导出一张 1280×1280 PNG,落成节点的 `asset`。下游的生成、标注、图库、导出都不必知道「导演台」存在。
|
|
37
|
+
|
|
38
|
+
## 底栏:从 18 个图标到三档层级
|
|
39
|
+
|
|
40
|
+
原来的底栏是一排 17 个 40px 方块,外加 5 条 1px 竖线。每个都是一个同权重的图标,只有悬停才显示名字——用户要找「新建」,得把整排读完。竖线还让每一格看起来像表格里的一个单元格。
|
|
41
|
+
|
|
42
|
+
现在只有三档:
|
|
43
|
+
|
|
44
|
+
1. **一个实底 `+`**(左)。文本、画板、姿势、分镜、文件、配置六种节点收进它的菜单。`+` 是「新建」的通用形状,不必再解释。
|
|
45
|
+
2. **一排低调的图标**(中)。工具、图片、模板库、技能库、时间线、背景、快捷键、撤销重做、删除。分组靠留白——1px 线画出来的是表格,不是分组。
|
|
46
|
+
3. **一个带文字的主动作**(右)。「运行工作流」说自己的名字,右侧箭头并进同一块药丸、只开选项菜单。在画布上它是最常用的一步,一排纯图标只能靠逐个悬停学会。
|
|
47
|
+
|
|
48
|
+
两处与弹簧引擎的边界是显式的:实底 `+` 仍是 40px 方块(照常被放大),带文字的主动作用 `data-dock-static` 退出引擎——引擎写的是内联 `width`,那会把文字药丸压回 40px 并裁掉标签。
|
|
49
|
+
|
|
50
|
+
## 这一版没做
|
|
51
|
+
|
|
52
|
+
- **多机位切换成片**:机位能加、能切、能各自取景,但还不能一次导出「每个机位一张」。
|
|
53
|
+
- **AI 搭场景**:底部那行场景描述存在节点上,还没有接到生成链——静默丢掉用户敲的字比留一个不触发的字段更糟,所以它先被完整保存。
|
|
54
|
+
- **全景球是真球面**:现在按水平旋转贴一条环绕带。完整球面反投影要逐像素求逆矩阵,代价远高于它带来的收益。
|
|
55
|
+
- **视口内直接拖角色站位**:站位在右栏用 X/Z 数字框改。
|
|
56
|
+
|
|
57
|
+
## 验证
|
|
58
|
+
|
|
59
|
+
- `scripts/smoke-pose-stage.mjs`(20 条):老文档兼容、双写镜像、加角色/机位不重叠、畸形缩放不塌成一点、取景跟人群中心、**每个角色的每个关节都投影在画面内**、提示词往返、站位参与变换。
|
|
60
|
+
- `scripts/verify-pose-panel.mjs`:真浏览器量 320×360 / 240×360 / 220×300 三档,钉住「打开导演台」按钮不被挤掉、机位名不与按钮重叠、矮卡片里预览收缩而不是把导出按钮顶出去、最后一枚预设可滚达。
|
|
61
|
+
- `pnpm test` 全绿(含 native-UI 契约与 z-index 契约)。
|
|
62
|
+
- `scripts/verify-canvas-layout.mjs`:五档面板宽度量底栏与缩放条/小地图的重叠与越界,并**数行数**——720px 及以上必须单行。这条是拿真机发现的:分组间隔取 10px 时,900px 面板下「删除」单独掉到第二行,看着像少了一个按钮,而重叠与越界两条都看不见它(那枚磁贴仍在画布内、不碰任何东西)。
|
|
63
|
+
|
|
64
|
+
其中两条检查是从真机走查里回来的:遮罩贴回时漏了 `fieldCell` 倍放大(人偶体块只有骨架的 1/2.4),以及上面那条水平注视点。
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
# v1.33.0 — 导演台换成真 3D + 时间轴;画布补上层级、锁定隐藏、套图、找节点、体检与目录
|
|
2
|
+
|
|
3
|
+
> **版本说明**:本版把 `v1.32.0` 的导演台从「一张静态构图」升成「一段能播的镜头」:视口换成 three.js 真三维,底部加时间轴与关键帧,顶栏加「导出视频」——导出的 mp4 是一个普通视频节点,下游零改动。同一版里画布也补齐了叠放顺序、锁定 / 隐藏、套图、找节点、体检、整理、对齐条、历史面板与全部功能目录。
|
|
4
|
+
|
|
5
|
+
## 之前是什么样
|
|
6
|
+
|
|
7
|
+
`v1.32.0` 的导演台已经能在一个场景里摆多个角色、多台机位,但它是**一张静态构图**:视口是手写的 2D 画家算法——把骨架投影到屏幕、用 metaball 球拼人形、逐球排序。两件事它做不到:
|
|
8
|
+
|
|
9
|
+
1. **遮挡**。画家算法只对互不重叠的凸体成立。一个立方体摆在人前面时,它挡不住人,只会被人盖住。
|
|
10
|
+
2. **时间**。没有时间轴,也就没有「从 0 秒走到 6 秒」这种镜头。
|
|
11
|
+
|
|
12
|
+
画布那一侧是另一类缺口:卡片的叠放顺序由「谁先被创建」决定,用户看不见也改不了;锁不住 Delete 的「锁定」不存在;一张配置卡只能挂一句话,想一次出三视图得建三张卡;画布大了只能缩到 10% 自己找;跑不起来的图要改一处、跑一次才知道下一处。
|
|
13
|
+
|
|
14
|
+
## 现在
|
|
15
|
+
|
|
16
|
+
### 真 3D
|
|
17
|
+
|
|
18
|
+
视口换成了 three.js 的深度缓冲。截图里的区别不是「更精致」,而是**能被挡住**:立方体摆在人偶前面,人偶只剩头肩。
|
|
19
|
+
|
|
20
|
+
- 人偶是**放样出来的人体**,不是关节球串。每一段(骨盆、腹胸、颈、头、大臂、小臂、大腿、小腿、手、脚)都是一串椭圆截面的放样面:胸腔左右宽、前后薄,小腿肚后厚前薄,大腿上粗下细。原来那版是「每个关节一颗球 + 每根骨一根等粗圆柱」——横截面永远是圆,于是躯干是一根管子、大臂是一根管子,远看是一个球关节木偶、近看是几根香肠叠在一起。
|
|
21
|
+
- 肩、肘、膝、胯、踝保留外露的小球。这是**刻意的造型**(木偶人偶本来就这样),也补上两段放样弯到极限时的缝。
|
|
22
|
+
- 头按 7 头身定尺寸:头高 0.204、头宽 0.15。这条走错过两次——第一版只把放样画到 `t=1`(= 颈到头的 0.100),得到一块 0.10 高、0.19 宽的**扁碟**;第二版撑到 `t=2.2` 又过头,成了 0.305 高,正面只显得「头大」,侧面是一颗向后歪的大鸡蛋(5.5 头身)。现在由 `H11` 断言守住 6.5–8.2 头身。
|
|
23
|
+
- 导演视角自由环绕(拖拽 / 滚轮 / 重置),机位视角透过 `cameraId` 那台机位看。
|
|
24
|
+
- 角色名标签用 canvas 纹理贴成始终面向相机的 sprite,受 `scene.labels` 开关控制。这条是 2D→3D 时漏掉的能力:2D 版一直画标签,3D 版不画,于是切过去之后画面上看不出谁是谁。
|
|
25
|
+
- **没有 WebGL 的机器自动退回 2D**,不报错、不白屏(老 GPU、远程桌面、策略禁用)。
|
|
26
|
+
- **木偶的样子主要来自材质与光,不是造型精度**。原来只有 `AmbientLight 1.15` + 一盏平行光、没有阴影——环境光开到 1.15 等于把形体全抹平,不管放样多准都会像一张剪贴画。现在环境光压到 0.22,加一盏半球光给上下渐变,主光开投影(`PCFSoftShadowMap`,阴影相机覆盖整个舞台),再补一盏冷色背光把剪影从背景里剥离;木身与关节分成两档颜色(`#d9b483` 浅木 / `#a7814f` 胡桃),浅木身配深关节才是木制人偶的辨认特征。2D 回退渲染器里那三个硬编码的 `0xc8/0xcc/0xd6` 一并改成同一个木色,否则没有 WebGL 的机器上是灰人、有 WebGL 的是木偶。
|
|
27
|
+
- 找过现成模型,**没有能换的**:唯一 CC0 且能直接下载的木偶只有 6 个网格、838 面,肘和膝都不能弯(换掉等于把 11 段姿势系统砍回刚体);拓扑最贴合的 kernelCAD 那个 CC0 木偶只有「Open in Studio」没有直链;three.js 的 `Xbot/Michelle/Soldier` 是 Mixamo 派生、不能随包分发;`boytchev/mannequin.js` 是 GPL-3.0,塞进 Apache-2.0 会让整个分发变成 GPL。
|
|
28
|
+
- **视口拖动/滚轮/重置一度全是死的**(2026-11-18 实机发现):面板把拖动写进自己的 `view` state,而那份 state **没有任何消费方**——3D 场景的 `orbit()` / `zoom()` / `resetView()` 三个方法都写好了,却一个调用方都没有。更隐蔽的是即使调用了也不会动:这三个方法只改 `orbitState`,而真正出帧的是 `render(stage)`,由面板的 effect 驱动,依赖里没有相机。现在 `StageViewRenderer` 增加了三个可选转发方法,场景在相机变化后自己重画一帧。`stage-preview-shot.mjs` 里补了一条**逐字节对比拖动前后画布**的断言——这条路径以前一条检查都没有,所以测试全绿而用户拖不动。
|
|
29
|
+
- 「生成参考图」也走 3D:视口里是 three 渲染的人形,导出却用 2D 画家算法画一遍的话,用户拿到的是一张和眼前完全不同的图。导出必须是「你看到的那一帧」,渲染不出来才退回 2D。
|
|
30
|
+
|
|
31
|
+
### 时间轴
|
|
32
|
+
|
|
33
|
+
底部一条时间轴:播放 / 暂停 / 逐帧 / 循环、时长 2–15 秒、拖动 scrub、逐轨关键帧菱形。
|
|
34
|
+
|
|
35
|
+
- **固定 30fps,时间以「秒」存**。帧号是渲染期派生量,不是存储格式——存帧号会在改时长时全部错位。
|
|
36
|
+
- **关键帧所有字段可选**(`rig?` / `position?` / `facing?` / `camera?`)。同一时刻「转身」和「摆姿势」是一条关键帧,不是两条。
|
|
37
|
+
- **整份时间轴存在 `stage.timeline` 里**,不分散到 actor / camera 上。删掉一个角色时轨道跟着消失,不会留下孤儿轨道。
|
|
38
|
+
- **运动轨迹在活动区间内覆盖位置关键帧**,而不是像牧野那样直接报 `motionPathsCannotCoexistWithPositionKeyframes`。轨迹段在轨道上画成琥珀色横条:一段区间用横条、一个时刻用菱形。
|
|
39
|
+
|
|
40
|
+
### 导出视频
|
|
41
|
+
|
|
42
|
+
顶栏「导出视频」逐帧渲染 → 逐帧上传 → 宿主用 ffmpeg 编成 mp4,落成一个普通视频节点并与导演台连线。
|
|
43
|
+
|
|
44
|
+
**编码不在浏览器里做。** 牧野用 WebCodecs,代价是它自己得给用户看一句「当前浏览器不支持此画幅的 H.264 编码」。这个插件的宿主本来就有 ffmpeg(`src/clip-compose.ts` 已在用),把编码放到宿主之后画幅不受编码器能力表限制、复用了拼接那条路已有的工具探测。代价是多一次逐帧上传(一帧 1–3MB,串行)——`stage-export.ts` 里写明了这个取舍,也写明了「中止时已上传的帧靠会话超时清理」这个已知缺口。
|
|
45
|
+
|
|
46
|
+
## 画布:叠放顺序、吸附线、锁定隐藏、套图、找节点、体检与目录
|
|
47
|
+
|
|
48
|
+
### 图层顺序:置顶 / 置底 / 上移一层 / 下移一层
|
|
49
|
+
|
|
50
|
+
这一版之前,画布上**没有层级这个概念**:节点的绘制顺序就是 `document.nodes` 的数组顺序,而那个顺序由「谁先被创建」决定,用户看不见也改不了。后果是两个,都是画布类工具里的常识性缺陷:
|
|
51
|
+
|
|
52
|
+
- 后来放上去的卡永远盖住先放的。想在一片图上写个字,字必须在图**之后**创建;否则它被压在图底下,框选也选不到,看起来像它不存在。
|
|
53
|
+
- 被盖住时画布只能描一条黄边说「这张被挡住了」(`geometry.ts` 的 `coveredNodes`),却不能告诉用户「把它拿到前面来」——因为拿不上来。
|
|
54
|
+
|
|
55
|
+
现在四个动作各有三个入口:右键菜单、⌘K 目录、键位(`⌥]` 上移一层 / `⌥[` 下移一层、加 `⇧` 置顶 / 置底,与 Figma 一致)。
|
|
56
|
+
|
|
57
|
+
**顺序存在数组里,不新增 `z` 字段。** 三个理由:① 老文档零迁移——数组顺序已经在磁盘上,加字段就要写迁移代码,而迁移一旦有缺口就是「用户的画布打开后遮挡关系全变」,这是最难被察觉的一类数据损坏;② 不会有「两个节点 z 相同」的并列态,任何时刻只有一条全序,置顶置底都是明确的,不需要再定 tie-break;③ 撤销栈里的一次层级调整就是一次普通的节点数组变化,不需要第二套快照。**末尾在最上面**,与 CSS 的 z-index 直觉、与 react-flow 的默认叠放一致。
|
|
58
|
+
|
|
59
|
+
**多选当刚体移动。** 选了三张卡做「上移一层」时,`layer-order.ts` 先把整组折成**一个槽位**,再让这个槽位跨过紧邻上面的那一张。逐个 `splice` 会把 a、b、c 变成 c、b、a(每次插到末尾),三张卡换了叠放次序而用户没有要求过——这种错只有在一张压着一张、又刚好有透明区域时看得出来。「整组折成槽位」之后,上移一层就是数组里一次相邻交换,正确性一眼可见。
|
|
60
|
+
|
|
61
|
+
**`coveredNodes` 跟着改了语义。** 它原来只按几何包含关系判定「谁盖住谁」,完全不看绘制顺序。层级可改之后这就是个真 bug:小卡画在大卡上面(数组里在后)明明看得见,却会被报成「被大卡完全盖住」;而用户按住「置顶」把它拿到最上层之后,提示仍然不消失——这条提示的全部价值就是告诉用户「谁压着谁、该把谁拿到前面」,指反了就是噪音。现在方向由数组下标唯一决定,同尺寸完全重合时也不再需要 id 兜底。
|
|
62
|
+
|
|
63
|
+
**关掉了 react-flow 的选中提权。** 它默认给选中的节点加内联 `z-index: 1000`,于是「置底」的那张卡一被点中就跳回最上层——用户看到的是「置底没生效」,刷新后又是对的。关掉之后叠放顺序只由数组顺序决定,`flowNodes` 也显式写下标为 `zIndex`(不靠 DOM 顺序:`onlyRenderVisibleElements` 之类的开关会重排节点元素)。代价是被压住的卡片在选中时仍可能被遮住一半——这正是用户按下「置底」时想要的结果,要编辑它就先置顶。
|
|
64
|
+
|
|
65
|
+
**真机截图捞回来的一个真问题:遮盖提示自己也被盖住了。** 那张「与「生成配置」完全重叠」的琥珀徽标原本挂在被盖住卡片的右下角——而那恰好是它最不能待的地方。「这张你看不见」这句话和那张看不见的卡一起被压在下面,以前只是靠着选中提权(拖动会选中被拖的那张)碰巧浮上来;提权一关,它就彻底消失,截图里只剩一圈也在下面的黄边。现在徽标由画布覆盖层按被盖住卡片的右下角绘制:它说的是画布层面的事实(谁压着谁),就该由画布这一层来说。坐标用世界坐标,跟着视口的平移缩放一起走,缩到 30% 时它仍在正确的位置。
|
|
66
|
+
|
|
67
|
+
### 拖动时的吸附参考线
|
|
68
|
+
|
|
69
|
+
吸附(`snapOffset`)一直都在,但它只改坐标、不留痕迹。卡片在离邻居 3px 时自己「跳」到贴边,用户看到的是一次无法解释的位移——他会以为是画布卡了一下,或者干脆把吸附关掉。
|
|
70
|
+
|
|
71
|
+
现在拖到对齐位时画一条红线,松手就消失。
|
|
72
|
+
|
|
73
|
+
**线与吸附分开算。** 吸附拿拖动原点和位移(`snapOffset(origin, others, dx, dy, threshold)`),线拿「已经落位之后」的位置(`snapGuides(landed, others)`)。写成一个函数会让「吸附算错了」和「线画错了」混在同一个返回值里,而它们的症状完全不同:前者卡在错的地方,后者卡在对的地方却画错线。
|
|
74
|
+
|
|
75
|
+
**容差是世界像素的半个像素。** 位置在拖动里被 `Math.round` 取整,所以「重合」在世界坐标里就是精确相等;留半个像素是为了吸收缩放带来的浮点误差,而不是给用户一个「差不多算对齐」的模糊带——那会让线在一堆不相干的卡片之间乱闪。真机验证过:差 1px 时不画线,差 0.5px 时画。
|
|
76
|
+
|
|
77
|
+
**同一条坐标上的多根线合并成一个区间。** 三张卡左边缘都在 x=100 时,画三条重叠的线段在视觉上是一条,但 DOM 里是三层;而用户拖过一片整齐的卡时这种情况是常态,一列排了十张就是三十层。
|
|
78
|
+
|
|
79
|
+
**只对着画面上的卡吸附与画线。** 与渲染、框选、`⌘A` 同一条纪律:对着藏起来的卡吸附,可见的那张会停在空处,而画面上没有任何东西解释它为什么停在那里;对着它画线则更糟——线上没有对应的卡。
|
|
80
|
+
|
|
81
|
+
**测试**:`smoke-canvas-geometry.mjs` 的 GG1–GG6(三条重合边各出一条线、超过半像素不画、横竖同时出现时顺序固定、无对齐不返回幽灵线、区间取并集)+ 契约组 3 条(渲染了、按吸附后的位置算、松手清空)+ 反向注入 4 条。
|
|
82
|
+
|
|
83
|
+
### 节点锁定 / 隐藏
|
|
84
|
+
|
|
85
|
+
上一版把叠放顺序交给用户之后,跟着来的第一件事就是两个更朴素的诉求:「这张我不想动」和「这张我现在不想看见」。
|
|
86
|
+
|
|
87
|
+
**锁定(`⌥⇧L`)拒绝四件事**:拖动、删除、批量删除、整理画布。锁不住 Delete 的锁等于没锁,而用户正因为相信它锁上了才敢把它留在那里。锁定的卡片仍然**可以选中**——不然就没法解锁——只是它不跟着走;批量拖动里有锁定的卡时,画布会说出跳过了几张,一次静默的「少拖了一张」在用户看来就是画布卡了。
|
|
88
|
+
|
|
89
|
+
**隐藏(`⌥⇧H`)把卡片从五个地方一起摘掉**:渲染、框选、`⌘A`、缩略图、`fitView`。这五处漏掉任何一处,症状都是「藏起来了但还是能选中」——而那种状态下按一次 Delete 就会删掉一张屏幕上根本没有的卡。**连线也必须跟着消失**:只过滤卡片会在画面上留下一条通往空气的线,它看起来像一根还没接完的连线,用户会试图去删它。
|
|
90
|
+
|
|
91
|
+
三个刻意的取舍:
|
|
92
|
+
|
|
93
|
+
1. **锁定按键按「这组里还有没锁的吗」决定方向**,混选时按下去是锁。一个真正的三态按钮(锁 / 解锁 / 部分)会让用户永远猜不准下一次按下去会发生什么。
|
|
94
|
+
2. **复制、粘贴、原地复制都清掉这两个标记**。复制一张锁住的卡,用户要的是「再来一份能动的」;照抄会让新卡一出生就拖不动。复制一张藏起来的卡更糟——粘贴完屏幕上什么都没有,看起来像粘贴失败。两者都是「对源卡的临时处置」,不是卡片内容。
|
|
95
|
+
3. **隐藏是单向门,所以必须有回来的入口**。藏起来的卡片既不在渲染里、也不在框选和 `⌘A` 里,画布上再也点不到它。两个入口:底栏那条「N 张卡片已隐藏 / 全部显示」;以及找节点(`⌘F`)——它刻意搜**全量**节点,结果行上标「已隐藏」,选中时自动把它叫回来。没有这两个入口,隐藏等于「删除,但还占着导出」。
|
|
96
|
+
|
|
97
|
+
**零迁移。** 两个标记都住在 `node.metadata` 里,老文档读出来就是「没锁、没藏」。`canvas-store` 的类型守卫按「缺项放行、类型错拒收」校验:校验器过严会让一份被外部工具写坏的文档再也存不下去。
|
|
98
|
+
|
|
99
|
+
**测试**:`smoke-canvas-node-flags.mjs` 16 条(严格 `true` 才算开、无变化时返回同一引用、顺序、`unlockedIds` 不修改入参、连线两端任意一端不可见即不画、复制走的是真实的 `cloneNodesWithCards` 而不只是 `withoutFlags` 本身)+ 契约组 9 条(一次 `mutate`、渲染与连线读同一份过滤结果、删除与拖动都过锁定、`⌥⇧` 认 `event.code`、底栏入口在、右键菜单两行在)+ 反向注入 7 条。
|
|
100
|
+
|
|
101
|
+
### 套图(提示词组)
|
|
102
|
+
|
|
103
|
+
一个配置卡上挂一组**带标题的提示词**,跑一次各出一张:正面 / 侧面 / 背面,或者一组电商图。它和已有的「生成数量」是两件事——`count` 是**同一条出 N 张**(求同,挑最好的一张),套图是 **N 条各出一张**(求异,一次出齐一套)。把两者合并会让填 3 想出三视图的人拿到三张一样的正面,所以套图住自己的字段 `node.metadata.promptSet`(上限 12 条),老文档零迁移。
|
|
104
|
+
|
|
105
|
+
- **入口在生成输入条**:参数排里的「生成数量」换成单张 / 套图 两态切换。切到套图时主输入框里已有的话带成第一条;切回单张时把第一条非空提示词写回主框,不丢字。
|
|
106
|
+
- **卡片上只显示只读徽标**「套图 · N 条」。编辑入口只在输入条一处——卡片上再多一个写入口,就是又一个「看起来能编辑、写入却没人读」的假入口。
|
|
107
|
+
- **每条独立任务**:提交时按套图跑,每条各自 `api.taskSubmit`、各自 taskId、各自占位卡、各自标题。回填按 taskId 配 asset,天然「一个任务一个占位」。
|
|
108
|
+
- **三条边界全在纯函数层**:空提示词条目丢弃(否则白跑一次)、标题截 24 字、超上限截断。写侧保留空条目(用户正在打字,保存瞬间消失会让光标跳走),读侧才丢。
|
|
109
|
+
|
|
110
|
+
**测试**:`smoke-canvas-prompt-set.mjs` 14 条 + 契约组 5 条(提交读草稿、每条一次 `taskSubmit` 且 `n: 1`、编辑器在 composer 而不在卡片上、多行编辑器不进参数排、locales 三块数量相等)+ 反向注入 3 条。
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
### 找节点(⌘F)、画布体检、整理画布
|
|
114
|
+
|
|
115
|
+
- **找节点**:一个搜索框同时搜标题、正文、提示词、模型名;中英文、全角空格、多词「都要命中」。同一张卡只出一条结果(字段按 标题 > 正文 > 提示词 > 模型 逐级退让),结果行显示的是**命中的那段原文**而不是标题——搜「樱花」命中一张叫「街景」的图时,只显示标题这一行就解释不了自己为什么在结果里。回车跳过去、选中它、并把它放进视野正中(视野计算走有单测的 `focusViewport`:0 尺寸视口、Infinity 输入、缩放夹取都在那里守住)。⌘F 原本会拉起浏览器的页内查找——在一个铺满画布的应用里,那个框永远找不到用户想找的**卡片**。
|
|
116
|
+
- **画布体检**:`canvas/graph-health.ts` 一次算全五类问题——环、残线、空配置、未就绪配置、孤立产物。环的判定直接复用执行器用的 `planLayers`(两份图论逻辑迟早分叉成「体检说能跑、按下却失败」);环只描**真正在环上**的节点,不含挂在环后面的下游;残线绝不因为它把某个节点算成「有上下游」。清单出现在「运行工作流」的选项菜单里,每条都可点,点了跳到那张卡并选中;阻断项永远排在提醒项前面。
|
|
117
|
+
- **整理画布(⌥⇧F)**:一张有向图排成从左到右的列。分层直接复用 `planLayers`——整理出来的第 N 列就是运行时第 N 层。**有环拒绝**(环上的节点没有「第几层」,照排会得到一张井然有序却跑不起来的图);**没接线的卡片不混进第一层**(落在流程下方两倍行距的停放带里,保持原有左右顺序);**原地整理**(锚点是当前包围盒左上角,视野不动);**幂等**(连按两次逐字节相同)。层内按用户原来的 `y` 排序而不是边的插入顺序。
|
|
118
|
+
|
|
119
|
+
### 全部功能目录(⌘K / 底栏放大镜)
|
|
120
|
+
|
|
121
|
+
画布的能力原来散在底栏 14 格、节点悬停条、右键菜单三处,每一处只在自己那类动作里给得全,于是「拼接视频」要先选中两段视频才看得见。现在一张 **47 行**、六个分组(添加 8 / 运行 4 / 编辑 23 / 视图 6 / 画布 4 / 帮助 2)的可搜索表把全场动作收在一起,中英文同义词都能搜(「接片」「排版」「ffmpeg」「storyboard」),↑↓ 只在能点的行之间走,回车执行。
|
|
122
|
+
|
|
123
|
+
**不可用的行不隐藏**,压暗并写明原因(「先选中至少两段视频」)——藏起来等于告诉用户「这个功能不存在」。每一行都由 `Record<CapabilityId, () => void>` 强制接上一段真代码,契约组比对目录与动作表两侧的 id,多一行少一行都红。目录**先关再执行**:留在屏幕上的遮罩会盖住它刚做的事。
|
|
124
|
+
|
|
125
|
+
### 多选对齐条
|
|
126
|
+
|
|
127
|
+
选中两张以上时,底栏上方出现一条 8 枚按钮的对齐条:左 / 水平居中 / 右 / 顶 / 垂直居中 / 底,加水平与垂直等距分布。规则全在 `canvas/align-model.ts`(21 条单测),钉住四条:
|
|
128
|
+
|
|
129
|
+
1. **只动选中**。没被圈中的卡一张都不挪——坐标、尺寸、数组顺序都不变。
|
|
130
|
+
2. **分组是刚体**。只选中组里一个成员时,整组按同一个整数 delta 平移,否则用户以为自己动了一张,实际把组拆了。
|
|
131
|
+
3. **跑到不动点**。宽度奇偶不同的卡居中时,半像素取整会让第二轮再挪一像素;第二遍按同一个按钮必须 `moved === 0`。
|
|
132
|
+
4. **结果全在整数格点上**。
|
|
133
|
+
|
|
134
|
+
两枚「等距」在只选中两张时压暗,并在 tooltip 里写出原因(「至少要选中三个节点」)。
|
|
135
|
+
|
|
136
|
+
**它不在 `bottom: 66px` 的原因**:第一版就是又一个绝对定位浮层,真浏览器布局守卫当场量到它在 860px 及以下压住缩放排 805–7625px²。现在拼接条与对齐条都是底栏那一行的成员、各自 `flex-basis: 100%` 独占一行,几何上不可能重叠。
|
|
137
|
+
|
|
138
|
+
**真机截图捞回来的第二条**:多选时底栏上方多出两条药丸,而生成输入条决定「翻到节点上方还是留在下方」时用的是硬编码 170px,于是它翻到节点下面、正好压在对齐条上——截图里八枚对齐按钮全被盖住,只露出左半句「对齐 2 个节点」。现在阈值加上**实测**的 `chromeHeight`(`ResizeObserver` 量底栏这一行最高的成员,因为两条药丸是条件渲染的)。
|
|
139
|
+
|
|
140
|
+
### 运行前说清哪张卡跑不了,运行后失败留在画布上
|
|
141
|
+
|
|
142
|
+
- **就绪扫描**:`canvas/readiness.ts` 把「缺什么」从卡片内的一枚徽标扩成一次全图扫描,与 `node-body.tsx` 读同一组事实(标注卡不算提示词、空 asset 不算参考图、`renderer: 'code'` 免模型渠道)。「运行工作流」旁边的箭头按钮现在写「2 个节点没准备好:缺提示词」,而不是等用户按下去、跑到一半才发现。
|
|
143
|
+
- **失败与被跳过是两种标记**:`canvas/run-marks.ts` 只用两种——实线红「这次失败」、虚线橙「被跳过,没跑」。只有 `completed` / `cycle` 不留痕;`cancelled` 也落痕,因为「按停之前就已经失败」的节点是真的坏了。新一轮开始时清空,单节点重试只摘自己那颗红标(下游仍没有产物,标记不能跟着清)。缩到 40% 时颜色会先糊掉,所以两种标记同时用线型和颜色区分。标记**不写进文档**:它是「刚刚这次运行」的结论,跟着导出和同步走反而不对。
|
|
144
|
+
|
|
145
|
+
### 撤销说得出「这一步是什么」,历史面板能一次退几格
|
|
146
|
+
|
|
147
|
+
- **撤销/重做按钮的 tooltip** 由 `canvas/history-model.ts`(23 条单测)把前后两份快照折成一句话:新增 / 删除 / 移动 / 编辑 / 连线 / 断线 / 分组 / 改标题 / 换背景,互相独立的两类合成「改了 N 项」。三条口径:删节点**连带**删掉的线不算第二次变化(否则 tooltip 永远说不出「撤销删除」);新节点自带的自动连线归给新增;只动视口不报成改了节点。「整理画布」不由纯函数产出——它和「多选手拖一批节点」在两份快照里是同一件事,猜错就是撒谎。接线侧每 160ms 防抖算一次:`document` 在拖动时每帧都换对象,不防抖等于每像素 `JSON.parse` 一次几十 KB 的快照。
|
|
148
|
+
- **历史面板**:按住 Shift / Option 点撤销、或右键撤销,弹出这张画布的全部历史:每一步一行(「移动 3 个节点」「删除图片节点」),点一行就退回那一步。当前状态也占一行(不可点);坏快照**截断不跳过**(`stepsBack` 是相对栈深的偏移,跳一格会让下面每行都退到错的地方);只动视口的一步不列出。回退 N 步是**一次**文档替换而不是循环 `undo()`——栈同步改、`document` state 不是,中间帧读到的 `documentRef` 还是旧的。重做栈逐条回填,退回去之后仍能一步步走回来。
|
|
149
|
+
- **悬停预览**:悬停某一行时,画布上这一步会动的那几张卡描一圈虚线(`outline`,不改几何,指针扫过一列行时画布不抖;预览不写文档,否则撤销栈里会多出几十条空步骤)。退回去之后选中这一步动过的卡,并与目标文档求交。Esc、点一行、关面板三个出口都清预览。
|
|
150
|
+
|
|
151
|
+
### ⌥ 系列快捷键在 macOS 上从来没生效过
|
|
152
|
+
|
|
153
|
+
真机实测(headless Chrome + CDP 派发原生键码)确认,按住 Option 时 `event.key` 是**该布局下的组合字符**:⌥F 给 `ƒ`、⌥A 给 `å`、⌥H 给 `˙`。所以 `altKey && key === 'f'` 永远不成立——「整理画布」的 ⌥⇧F 自上线起按了没反应且不报错,源码读起来却一切正常。
|
|
154
|
+
|
|
155
|
+
全部改按 `event.code`(物理键位)。同时补上一组对齐键位:⌥⌘← / → / ↑ / ↓ 四边对齐,⌥⌘H / V 水平、垂直居中,⌥⌘E 水平等距(垂直等距没有键位——写在表里而按不出来比不写更坏)。键位只在 `ShortcutHelp.tsx` 的 `CANVAS_SHORTCUTS` 写一份,多选对齐条的 tooltip 通过 `shortcutKeysFor` 反查;目录行尾的键位徽章也读同一份表——灰行不显示徽章,等于不承诺能用。
|
|
156
|
+
|
|
157
|
+
做徽章时揪出一个一直在撒谎的文案:`canvas.duplicate` 写的是「创建副本 (Ctrl+D)」,macOS 上按的是 ⌘D,而这半句括号也不参与反查,于是目录里那一行永远没有徽章。现在文案只留动作名,键位由 `labelWithKeys` 补;`canvas.paste` 同一类问题,快捷键表里这两条也补了 `action`。
|
|
158
|
+
|
|
159
|
+
### 首次打开画布不再自带一份「已保存的画布」
|
|
160
|
+
|
|
161
|
+
以前打开画布标签页时,只要画布库是空的就立刻 `canvasCreate` 落盘一份,并塞进一对示例节点。用户从没建过它,下拉里却多一份;更糟的是空态(那排快捷卡)因此永远渲染不出来——种子固定注入两个节点,`nodes.length === 0` 从未成立。
|
|
162
|
+
|
|
163
|
+
现在首屏与「+」给的都是**内存草稿**(状态条如实写「未保存」),只有用户真往里放了东西才创建画布;删掉最后一份画布同样回到空草稿。空态第六张卡「载入示例」一次落一条 提示词 → 配置卡 的链(列间距取整理画布同一档,两卡中心线严格对齐),选中配置卡并提示「按生成就能出图」;整件事是**一次** `mutate`,撤销按一次就回到空画布。
|
|
164
|
+
|
|
165
|
+
### 顺手修掉的四处
|
|
166
|
+
|
|
167
|
+
- **测试不再往用户真实的数据目录里写画布**:`~/.dsh/dsh-imagegen/canvas/` 与测试目录只差一个 `DSH_HOME`。2026-10-13 到 10-15 三天里这样攒下 1408 条残渣,用户的画布下拉从可用变成滚不完的列表。新增 `scripts/verify-test-isolation.mjs`:扫出所有会写画布的脚本,要求它们的 `DSH_HOME` 指向 `mkdtempSync()` 建出的目录;判据是「赋值成了什么」而不是「有没有赋值」。
|
|
168
|
+
- **两个被浏览器丢弃的 CSS 变量**:`--dsw-alias-border-secondary` 与 `--dsw-specific-sidebar-nav-item-hover` 在 DSH 里都不存在,整条 `border` / `background` 声明会被丢掉——按钮没边框、入口悬停毫无反馈。换成契约文档给的 `border-l2` 与 `interactive-bg-hover`。
|
|
169
|
+
- **预览构建的打包清单漏了 `three`**(裸包名与 `examples/jsm` 子路径要分别列):漏掉时预览页整块白屏,报的是 `three is not defined`,读起来像 3D 那一块的 bug。
|
|
170
|
+
- **一条只看得见第一处的守卫**:套图那条「编辑器不许进参数排」的检查原先只取文件里**第一个** `.composerControls` 块。反向注入把编辑器塞进第二个块时,检查读到的是没被改过的第一个,缺陷回来了而检查照样绿——是反向用例组自己报出 FALSE GREEN 才发现的。现在按标签配对切出所有参数排逐个检查(按「到第一个 `</div>` 为止」切不出来:注入的是单行 `<div>…</div>`)。这是这一轮里唯一一条「测试说通过、其实没验」的检查。
|
|
171
|
+
|
|
172
|
+
## 对标的是谁,跟了什么、没跟什么
|
|
173
|
+
|
|
174
|
+
调研对象是牧野工作台(muye.si)的 3D 导演台,实测记录在 [`docs/research/muye-director-desk.md`](../research/muye-director-desk.md):真 WebGL2、蒙皮 GLB、固定 30fps、五种运动轨迹、导出 PNG 与视频各自动建节点连线。
|
|
175
|
+
|
|
176
|
+
| 牧野 | 我们 |
|
|
177
|
+
| --- | --- |
|
|
178
|
+
| 真 3D 视口 | three.js,真深度缓冲 |
|
|
179
|
+
| 固定 30fps、关键帧落帧边界 | 同 |
|
|
180
|
+
| 双轨(角色 + 机位) | 同,`CanvasStageTrack.target: 'actor' \| 'camera'` |
|
|
181
|
+
| 五种轨迹 | 圆形 / 直线 / 矩形 / 铅笔(`free`) |
|
|
182
|
+
| 道具 Cube / Sphere / GLB | 同 |
|
|
183
|
+
| 导出视频落参考视频节点 | 同,`exportStageVideo` + 落节点连线 |
|
|
184
|
+
| 时长 0–5 秒 | **2–15 秒**(5 秒装不下完整运镜;15s × 30fps = 450 帧仍在 480 上限内) |
|
|
185
|
+
| WebCodecs 编码 | **宿主 ffmpeg**(见上) |
|
|
186
|
+
|
|
187
|
+
画布那一侧对标的是 LibTV / Figma Weave / ComfyUI 这条线,结论与验收门槛留在 [`docs/research/canvas-workflow-benchmark.md`](../research/canvas-workflow-benchmark.md):**先修保存与恢复,再做大图导航与交付复用**,不复刻竞品工具栏。这一版按它给出的优先级做了「定位与编辑响应」里能离线验的部分(找节点、体检、整理、目录),并把大图性能数字做成一个可复跑的手动基准 `scripts/benchmark-canvas-interaction.mjs`(需要先往一个真宿主里导入基准画布,脚本只量不写)。保存与恢复(P0)与图区块复用(P2)不在本版。
|
|
188
|
+
|
|
189
|
+
|
|
190
|
+
### 导演台
|
|
191
|
+
|
|
192
|
+
四层,全部可以重跑:
|
|
193
|
+
|
|
194
|
+
- `pnpm run test:stage` — 79 条离线断言:`smoke-pose-stage` 20、`smoke-stage-humanoid` 11(头部宽高比、头身比 6.5–8.2、胸廓宽厚比、骨盆底部收成锥、腰上两段同宽、关节球盖住管口、放样封口与法线朝外)、`smoke-stage-timeline` 27(时长裁剪、轨迹弧长、帧对齐、老文档兼容)、`smoke-stage-export` 11(帧序号、进度单调、取消在上传前生效、结果归一、单会话 UUID)、`smoke-stage-encode` 10(含真 ffmpeg 编码 6 帧 → 真 mp4、幂等性)。人形那组做过反向注入:把头改回扁碟 → H1 / H11 立刻红。
|
|
195
|
+
- `node scripts/verify-stage-3d.mjs` — **真浏览器 + 真 GPU**:视口不是纯色、移动角色画面会变、**立方体真的挡住人偶**、同一份 stage 导出两次逐像素一致、轨迹让角色在两帧之间移动。
|
|
196
|
+
- `node scripts/stage-preview-shot.mjs` — 拍全屏面板在浅色 / 深色 / 1440 / 1280 / 900 宽度下的截图,并且**断言视口 canvas 真的有 WebGL 上下文**。这一条不能省:3D 拿不到 WebGL 会自己退回 2D,不报警——一张「看起来还行」的截图完全可能是 2D 画的。
|
|
197
|
+
- 截图里捞回来并修掉的三个真问题:① 结尾那颗关键帧菱形被轨道的 `overflow-x: hidden` 裁成「◀」(`left: 100%` 加 `margin-left` 只把中心拉回,右半边仍探出去);② 轨迹条用 `brand-primary` 混色,而**这套主题的品牌色就是黑与白**(浅色 `#0f1115`、深色 `#f9fafb`),混出来是一条看不出含义的灰带——换成 `state-warn-primary`(两种主题下都是 `#f59e0b`);③ 首帧取景贴着几何包围球算,最边上那个角色名标签被视口切掉一半。
|
|
198
|
+
- 人形的三处硬伤也是从放大图里捞回来的:头是一块扁碟、肩线落在颈部那一段上导致手臂浮在身体旁边、骨盆底面是个平切圆盘(走路姿势下一眼就看见)。三处都改在剖面数据上,并由上面那 11 条几何断言守着。
|
|
199
|
+
|
|
200
|
+
### 画布(纯函数层)
|
|
201
|
+
|
|
202
|
+
- `smoke-canvas-geometry.mjs` 71 条、`smoke-canvas-layers.mjs` 12、`smoke-canvas-node-flags.mjs` 16、`smoke-canvas-prompt-set.mjs` 14、`smoke-canvas-node-search.mjs` 21、`smoke-canvas-health.mjs` 18、`smoke-canvas-align.mjs` 21、`smoke-canvas-history.mjs` 23、`smoke-canvas-example.mjs` 8,全部接入 `pnpm test`。
|
|
203
|
+
- `verify-canvas-layout.mjs`:五档面板宽度量底栏、缩放排、小地图与拼接条 / 对齐条 / 隐藏条之间的 12 个两两组合与越界,并**数行数**(720px 及以上必须单行)。
|
|
204
|
+
- `verify-ui-contracts.mjs`:目录两侧 id 对齐且先关再执行、一次 `mutate`、`moved === 0` 不写、键位只认 `event.code`、输入条阈值扣掉实测 `chromeHeight`、卡片上不得出现第二个提示词编辑入口等。
|
|
205
|
+
- `verify-negative.mjs` 现有 **252 条**反向用例(新增 `geometry` / `example` / `health` / `search` / `align` / `history` / `prompt-set` / `isolation` 八个零构建组),逐条实测变红。
|
|
206
|
+
|
|
207
|
+
## 已知边界
|
|
208
|
+
|
|
209
|
+
- **3D 视口不画辅助线**(关节标记、机位视锥)。这些在 2D 版是画上去的,在 3D 里是要在场景中生成的实体,尚未补。导出(`guides: false`)与预览(`guides: true`)在 3D 下看起来一样。
|
|
210
|
+
- **中止导出不清理已上传的帧**。协议里只有 `stageFrame` / `stageEncode`,没有「作废一次会话」;那些帧永远等不到最后一帧、也就永不触发编码,最终靠宿主会话超时。
|
|
211
|
+
- **动作不做骨骼动画插值**:关键帧之间对关节做线性插值,不是贝塞尔曲线。
|