@q253595422/dsh-imagegen-video 1.24.0 → 1.27.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 CHANGED
@@ -5,6 +5,30 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
5
5
 
6
6
  ## Releases
7
7
 
8
+ ### 1.27.0 — 千问生图 API;大图预览可按住拖动(一并发布 1.25.0 / 1.26.0)
9
+
10
+ - **v1.24.0 之后的第一个发布版本。** 1.25.0(react-flow 画布引擎)与 1.26.0(画布布局对齐 LibTV)此前只推了代码、没有 tag 与 Release,它们的改动随本版一起发出,条目保留在下面各自的小节里。
11
+ - **渠道协议新增「千问生图 API」(#32)**,文生图与图生图都支持。走 DashScope 异步任务链路:提交拿 `task_id` 再轮询,上限 240 秒、超时抛 `upstream-timeout`;进行中/完成/失败三张状态词表(失败含 `cancelled`/`canceled`),词表外的状态直接报 `upstream-invalid`,不当成「还在跑」无限等待。比例按文档档位发送,**21:9 无对应档位按 16:9 发**;清晰度映射 `megapixels`,**上游上限 2MP,2k/4k 都取最高档**。图生图上传参考图原始字节;空 Key 不发空 `Bearer ` 头。渠道支持模型检测,文案补齐 zh/en/ru。
12
+ - **修复配置校验拒绝 `google-native`。** `src/index.ts` 的 schemastery `protocol` 联合漏了类型里早已存在的 `google-native`,实测旧 schema 报 `expected "auto" | "images" | "chat-completions" but got "google-native"`。#32 顺带修掉的独立缺陷。
13
+ - **修复大图预览放大后无法拖动(#31)。** 以前放大后只能拉滚动条,现在按住鼠标左键直接拖画面平移:pointer 事件 + `setPointerCapture`,反向写 `scrollLeft`/`scrollTop`,移动距离与鼠标一致;光标 `grab` → 拖动中 `grabbing` → 松手复原。拖动后紧跟的那一次 click 由浮层捕获阶段的一次性抑制器吞掉,不会误关预览,随后的普通点击照常关闭。只接管鼠标主键,触摸交浏览器,内容不溢出不拦按下;图片禁用原生拖拽。
14
+ - 测试:新增 `smoke-qwen-draw.mjs`(桩 fetch、零网络,断言请求体深度相等、`21:9→16:9`、`4k→2MP`、上传原始字节)接入 `test` 与 `test:negative`;`verify-ui-contracts` 新增 11 条预览拖拽不变量与 1 条真实 `getComputedStyle` 测量。#31 在打包产物解包部署后的真实实例上复验(200% 下拖 200×80,scrollLeft 547.5→347.5、scrollTop 296→216,拖后 click 不关、普通 click 正常关)。千问协议未用真实 Key 发起过请求,线上返回未验证。
15
+
16
+ ### 1.26.0 — 画布布局对齐 LibTV:悬浮顶栏、左下工具排、分组 dock、空态快捷卡
17
+
18
+ - **顶栏改悬浮细栏。** 不再占布局高度,画布铺满整个区域;顶栏玻璃浮在其上(项目下拉/重命名/收藏/全屏/保存状态原样保留)。中心点语义不变:chromeHeight 只量底部 dock。
19
+ - **左下工具排铺平。** 网格吸附、显示连线从缩放菜单里独立成按钮(`aria-pressed` + 高亮,状态一眼可见),与小地图/适应/缩放%并排;缩放菜单保留预设与自定义。
20
+ - **dock 按 LibTV 节奏分六组**:工具|建节点|库|运行|编辑|删除,组间发丝分隔;tile 命中区 34→40px(弹簧基准同步),hover 标签照旧。全部动作一个不删。
21
+ - **空态快捷卡。** 无节点的画布居中「开始你的创作」+ 一排五卡(图片/视频/文本/分镜/文件),点卡=现有创建动作落在画布中心;视频走现有 video picker。有节点后卡片退场。文案补齐 zh/en/ru。
22
+ - 配色仍跟随宿主主题、插件外框不动(用户拍板);窄屏顶栏换行不溢出。测试:smoke 新增空态驱动检查(空文档→五卡→点卡建节点→卡片退场)与配套反向用例;canvas-layout fixture 同步新分隔位与左下排;#27 弹簧边界同步 40–50px。
23
+ - 真机走查修掉两个手势缺陷:框选不再把空态快捷卡当空白(pointerdown 的 preventDefault+指针捕获曾抢走卡片 click);`.node` 外壳恢复 pointer-events:auto(react-flow wrapper 的 none 可继承,曾让卡片本体收不到真指针、拖拽死掉)。各配契约不变式与反向用例。
24
+
25
+ ### 1.25.0 — 无限画布换用 react-flow 引擎;LibTV 式缩放菜单与视图开关
26
+
27
+ - **画布渲染与视口交给 @xyflow/react v12(受控视图),现有功能全部保留。** `CanvasDocument` v2 仍是唯一真源:宿主校验、revision 乐观锁、自动保存、撤销重做留在文档层,用户磁盘数据零破坏。节点拖动(边缘对齐吸附、标注卡随行、重叠提示)、四角 resize、选择、连线、捏合缩放、框选保留自定义引擎,手势与快捷键一个不丢。
28
+ - **无损适配层。** 新增 `canvas-flow-adapter`(节点/连线/视口双向 round-trip,metadata 全字段与「无/空 metadata」区别保住)与 `canvas-flow-context`(模块级稳定节点外壳)。连线持久化仍存 `{fromNodeId,toNodeId}`,workflow/compose/storyboard 纯函数契约不动。react-flow 样式构建时内联,跨目录可复现构建字节一致。
29
+ - **LibTV 式 chrome。** 缩放百分比点开预设菜单:放大/缩小/适应、50–800% 预设、自定义输入(上限 500%→800%);视图开关:对齐吸附、显示连线(隐藏持久边,进行中预览不受影响)。文案补齐 zh/en/ru。
30
+ - 测试契约同步:smoke 沙箱补 react-flow 所需桩(测量 ResizeObserver/DOMMatrix/navigator),boxOf 改读 wrapper transform;verify-ui-contracts 新增 adapter round-trip 与视口有限值守卫;反向锚点迁移并新增四条用例。真机逐项走查缩放菜单、草图重绘、标注引线、重叠徽标、视频节点工具条与拼接条。
31
+
8
32
  ### 1.24.0 — Google 原生渠道协议;URL 型模板图不再 404
9
33
 
10
34
  - **渠道「接口协议」新增 Google 原生(#28)。** 用 Google API Key 直连 Generative Language `:generateContent`:`x-goog-api-key` 鉴权,参考图最多 5 张走 `inlineData`,比例/清晰度嵌套在 `generationConfig.imageConfig`,auto 省略;body 不带 `n`,多张由并行单图请求满足;响应跳过 `thought` 部分、兼容 `inline_data`、缺 mimeType 按字节嗅探,空结果报 `blockReason`。配置地址带 `/models`、`:generateContent`、`/interactions` 后缀时自动剥回基址。GIF 请求在网络调用前拒绝,不静默降级成静图计费。
package/README.md CHANGED
@@ -148,6 +148,11 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
148
148
 
149
149
  把人物、服装和姿势三类参考素材拼成一次编辑请求,先看预览再提交;素材可以来自内置图库、自己的模特库,也可以现场上传或让 AI 生成。
150
150
 
151
+ <div align="center">
152
+ <img src="docs/images/outfit-panel.png" alt="服饰穿戴面板:左侧配人物、服装与姿势,右侧显示生成结果" width="100%" />
153
+ <p><em>面板总览(角色搭配):左侧配素材,右侧出结果;顶部写明容量规则——人物 1 张、服装最多 4 张、姿势 1 张,超出模型容量时自动压成编号拼图一起发送,不丢弃、也不会少发。</em></p>
154
+ </div>
155
+
151
156
  - **两种模式**。「商品试穿」保留真实商品图的版型、颜色、图案与材质,人物与至少一张服装图为必选;「角色搭配」把参考服装设计穿到人物身上,三类素材任选其一以上,也可以混合自己的图片。
152
157
  - **素材来自内置图库**。人物、服装、姿势各有独立图库,选图器支持按名称或标签搜索、按分类与来源筛选,姿势还能按视角筛选;服装条目带多视角,姿势可选深度图(仅作视觉参考,不是 ControlNet 控制)。默认不显示 18+ 素材,需要时手动打开。
153
158
  - **模特库就是人物图库的一部分**。自己上传的人物和 AI 生成的人像都存进同一个模特库,并作为「我的模特」出现在人物图库列表最前面,用来源筛选器就能只看它们;选中即用,不需要再对着另一个独立面板挑。添加照片与「AI 生成模特」都在人物图库顶部完成,生成用当前选中的渠道和模型。
@@ -155,6 +160,19 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
155
160
  - **图库索引锁定到固定提交**。索引与图片都按 Git blob 校验,来源站不可达时会换镜像重试,并用图片魔数确认拿到的确实是图片;更新失败时继续使用已有离线索引,并在面板上说明原因。
156
161
  - **提交前预览**。点「准备参考图预览」只下载与排版参考图、不调用模型,右侧给出**实际会发送**的图片与完整提示词;点「确认生成」才提交。任何一次编辑、换渠道或换模型都会让预览失效,需要重新准备。
157
162
 
163
+ <div align="center">
164
+ <img src="docs/images/outfit-gallery-garment.png" alt="服装图库:搜索、分类与来源筛选,底部标注素材版权与离线导入" width="100%" />
165
+ <p><em>服装图库:按名称或标签搜索,按分类、来源筛选,18+ 素材默认隐藏;底部明示素材版权归来源原作者、部分不允许商用,已有本地图库的填目录路径即可离线导入。</em></p>
166
+ <img src="docs/images/outfit-gallery-model.png" alt="人物图库:我的模特排在最前,支持上传照片与 AI 生成模特" width="100%" />
167
+ <p><em>人物图库与「我的模特」:上传的照片和 AI 生成的人像存进同一个模特库,排在列表最前面,选中即用;添加照片与 AI 生成模特都在图库顶部完成。</em></p>
168
+ <img src="docs/images/outfit-gallery-pose.png" alt="姿势图库:线稿姿势,支持分类、来源与视角筛选" width="100%" />
169
+ <p><em>姿势图库:线稿姿势参考,支持分类、来源、视角三重筛选;不选则沿用人物原图的姿势,选了也只作视觉参考。</em></p>
170
+ <img src="docs/images/outfit-tryon-result.png" alt="商品试穿生成结果:商品组合穿到指定模特身上,左侧历史记录可回看" width="100%" />
171
+ <p><em>生成结果(商品试穿):商品组合穿到指定模特身上,版型与材质保留自商品图;每次生成进入左侧历史记录,随时回看、复用配方再改一版。</em></p>
172
+ <img src="docs/images/outfit-history-recall.png" alt="历史回看:点左侧试穿记录,右侧展示当次完整提示词与成片" width="100%" />
173
+ <p><em>历史回看:点左侧任一试穿记录,右侧还原当次提交的完整提示词——编号参考图各借用什么用途、场景与尺寸清晰度——以及成片,照着改一版再提交即可。</em></p>
174
+ </div>
175
+
158
176
  <details>
159
177
  <summary><b>参考图上限、拼图与离线使用</b></summary>
160
178
 
@@ -337,6 +355,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
337
355
 
338
356
  - 通用渠道默认自动判断 Images API 与 Chat Completions;也可在设置中手动指定。
339
357
  - One-API、New API、LiteLLM 等只暴露 `/chat/completions` 的网关,可填写完整接口地址并选择对应模型。
358
+ - 千问生图 API(自建 ComfyUI HTTP 封装):协议选「千问生图 API」,填服务根地址(如 `http://127.0.0.1:8787`)与 API Key。插件调用 `GET /api/models` 检测模型,`POST /api/draw` 提交异步任务并轮询 `GET /api/jobs/{id}`,再从 `/api/images/…` 拉回结果;图生图先 `POST /api/upload` 逐张上传参考图(最多 5 张),单张用 `image_id`、多张用 `image_ids` 提交;服务端若关闭鉴权(首页显示「无需鉴权」),渠道密钥可以留空。
340
359
  - API 密钥保存在 DSH 宿主设置中;未被自动识别的兼容模型可手动添加。
341
360
  - 不同服务商的图生图、尺寸与返回格式可能不同,请确认所选模型实际支持的能力。
342
361
 
@@ -0,0 +1,71 @@
1
+ # v1.11.0 · 画布跑整条链路,而不是一个节点
2
+
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
+
5
+ 这一版之前,画布只能「选中一个节点、点一次生成」。一条三段的链路要点三次,
6
+ 中间还要等前一段出结果才能点下一段;其中任何一次忘了点,下游就永远等着。
7
+
8
+ 1.11 把这件事交给执行器:**给一个起点,剩下的按依赖顺序自己跑完**。
9
+
10
+ > **这一版的 Release 是事后补发的。** 当时打包校验在「缺发布说明」处中止了整次
11
+ > 任务,tag、GitHub Release 与 npm 都没有产生;功能本身随后随 v1.13.0 到达用户
12
+ > (1.12.0 与 v1.13.0 在同一次推送里,Release 只按推送末端发了一次)。
13
+ >
14
+ > 下面的归档**不是当初那次 CI 构建的产物**(那次根本没跑成)。它是在补发时从本版
15
+ > 的提交 `3f7df02` 的树上重新构建、打包并由 `verify-pack.mjs` 校验过的,`SHA256SUMS`
16
+ > 对应这一份字节。安装行为与当时的代码一致,但它没有经过那一次发布流水线的验证。
17
+ > 这一个版本也**没有发布到 npm**。
18
+
19
+ ## 从哪开始,往下跑多少
20
+
21
+ - **起点是选中节点。** 画布底部的「运行工作流」从当前选区往下走,只跑它的下游
22
+ 闭包——旁边的分支不动。
23
+ - **没选中时补完这块画布。** 起点取「还没有产出、或上次失败」的图片与视频节点,
24
+ 等于「把该跑的补完」。全部都有结果时不提交任何东西,而是提示「选中要重跑的
25
+ 起点再运行」,而不是假装跑了一轮。
26
+ - **已经有结果的节点直接复用。** 重跑一条链路不会为已经产出的节点再付一次费用。
27
+
28
+ ## 顺序由依赖决定
29
+
30
+ 分层的规则是纯函数(`src/client/workflow-graph.ts`):同一层里的节点互不依赖,
31
+ 一起提交;下一层要等上一层的结论。链越宽跑得越快,链越长也不会出现「下游先跑、
32
+ 拿到空输入」这种假失败。
33
+
34
+ **环在提交前就被拒绝。** 自环也算环——一个节点连到自己,意味着它要等自己的产物。
35
+ 检测到环时**一个节点都不提交**:跑一半再报错,用户要自己判断哪些结果是这次生成的。
36
+
37
+ ## 失败只停它自己的下游
38
+
39
+ 这条是刻意与「一错全停」不同的。一个节点失败,它下游拿不到输入,继续跑只会产生
40
+ 一串看起来像系统坏了的错误,所以那些节点**不提交**;但图上与它无依赖关系的分支
41
+ 照常跑完。
42
+
43
+ 结果因此有三种,而不是「成功 / 失败」两种:
44
+
45
+ | 状态 | 含义 |
46
+ | --- | --- |
47
+ | `completed` | 全部有结论(含复用与跳过) |
48
+ | `partial` | 有节点失败,但至少有一条独立分支真的产出了结果 |
49
+ | `failed` | 有节点失败,且没有任何独立分支产出 |
50
+
51
+ 「跳过」不算产出:提示词、配置这类不发起调用的节点算有结论,但不能拿来证明
52
+ 「这次跑出了东西」。
53
+
54
+ ## 进度与中止
55
+
56
+ 运行卡片报告当前层与已完成节点数。**中止在层与层之间生效**——已经提交出去的
57
+ 生成任务会继续跑完(那是收不回的),只是不再提交新的一层。
58
+
59
+ ## 检查
60
+
61
+ - 排程规则(`planLayers` / `planWorkflow` / `downstreamClosure`)是纯函数,
62
+ `scripts/smoke-workflow.mjs` 离线覆盖分层、环、空计划与重复连线。
63
+ - 执行器(`src/client/workflow-runner.ts`)不依赖引擎:它只负责顺序,生成仍然
64
+ 走画布原有的「提交 → 轮询回填」链路,所以不会出现第二套并发与重试逻辑。
65
+ - `pnpm test:workflow` 可单独跑,不需要网络。
66
+
67
+ ## 已知边界
68
+
69
+ - **不设并发上限。** 真正的上限在生成队列(视频是 1),执行器不再加一层限流。
70
+ 层很宽时,任务会一起排进队列,按队列的规矩一个一个走。
71
+ - **只有「往下」。** 这一版只跑下游闭包,不支持从叶子往回补算上游。
@@ -1,5 +1,17 @@
1
1
  # 1.12.0 — 一条片子该有的三件事:剪、接、认人
2
2
 
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
+
5
+ > **这一版的 Release 是事后补发的。** 当时 `package.json` 的版本号在这个提交里
6
+ > 从 1.11.0 升到 1.12.0,但同一批推送里还带着把它升到 1.13.0 的另一个提交;GitHub
7
+ > 只按一次推送的**末端提交**触发发布,于是 `release.yml` 看到的是 1.13.0,打了
8
+ > `v1.13.0` 的 tag,1.12.0 从未被流水线看见——这一次推送里它一条 workflow 记录都没有。
9
+ >
10
+ > 下面的归档不是当初那次 CI 构建的产物(那次不存在)。它是在补发时从本版的提交
11
+ > `a0b6b9a` 的树上重新构建、打包并由 `verify-pack.mjs` 校验过的,`SHA256SUMS` 对应
12
+ > 这一份字节。安装行为与当时的代码一致,但它没有经过发布流水线的验证。
13
+ > 这一个版本也**没有发布到 npm**;功能本身随后随 v1.13.0 到达用户。
14
+
3
15
  这一版补的是「已经能逐镜生成之后」还缺的三层:把成片排成时间线、让同一个人
4
16
  在每一镜里都还是他、以及一套可改的转场。三件事共用同一个原则——**成品仍然是
5
17
  普通视频节点**,没有第二套工程文件,也没有第二种节点类型。
@@ -0,0 +1,74 @@
1
+ # v1.23.0 · 服饰穿戴:商品试穿与角色搭配;生图支持 GIF 动图
2
+
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
+
5
+ 这一版加了两件互不相干的事:**「服饰穿戴」面板支持两种搭配模式**,以及**生图可以
6
+ 出 GIF 动图**。
7
+
8
+ > **这一版的 Release 是事后补发的。** 当时打包校验在「缺发布说明」处中止了整次
9
+ > 任务,tag、GitHub Release 与 npm 都没有产生;功能本身随后随 v1.23.1 到达用户。
10
+ >
11
+ > 下面的归档**不是当初那次 CI 构建的产物**(那次根本没跑成)。它是在补发时从本版
12
+ > 的提交 `28b18cf` 的树上重新构建、打包并由 `verify-pack.mjs` 校验过的,`SHA256SUMS`
13
+ > 对应这一份字节。安装行为与当时的代码一致,但它没有经过那一次发布流水线的验证。
14
+ > 这一个版本也**没有发布到 npm**。
15
+
16
+ ## 服饰穿戴:两种模式
17
+
18
+ - **商品试穿**:拿真实商品图当服装参考,保留版型、颜色、图案与材质。人物与至少
19
+ 一张服装图是必选。
20
+ - **角色搭配**:把参考服装设计穿到人物身上。人物、服装、姿势三类素材任选其一以上,
21
+ 也可以和自己的图混着用。
22
+
23
+ ## 素材从哪里来
24
+
25
+ 人物、服装、姿势各有一套内置图库。选图器支持按名称或标签搜索,按分类与来源筛选,
26
+ 姿势还能按视角筛选;服装条目带多视角可切换,姿势可选深度图。18+ 素材默认不显示,
27
+ 需要时手动打开。
28
+
29
+ 图库可以**完全离线使用**:把 `anhao/ai-pose-gallery-zh` 克隆到本地后填目录路径即可
30
+ 导入整份图库;其余情况索引与图片按需缓存到 `~/.dsh/dsh-imagegen/outfit/`,选中后读的
31
+ 是本地副本,第三方站点失效也不会中途失败。
32
+
33
+ 索引与图片都按 Git blob 校验,站点不可达时换镜像重试,并用图片魔数确认拿到的确实
34
+ 是图片;更新失败时继续使用已有离线索引,并在面板上说明原因。
35
+
36
+ ## 提交前先看预览
37
+
38
+ 点「准备参考图预览」**只下载与排版参考图、不调用模型**,右侧给出实际会发送的图片与
39
+ 完整提示词;确认后才调模型。
40
+
41
+ 任何编辑、换渠道或换模型都会让预览失效,需要重新准备——避免「看到的」和「发出去的」
42
+ 不是同一份。
43
+
44
+ **参考素材超过渠道容量时压成一张编号拼图。** 一部分模型只收一张参考图,以前多出来的
45
+ 会被静默丢掉;现在把全部素材排进一张带「图 N 用途」标注的拼图,提示词同步改成按格子
46
+ 编号指代,预览里也说明这次发的是一张拼图。拼图按原比例留白,不裁切服装或姿势。
47
+
48
+ ## 草稿自动保存
49
+
50
+ 模式、素材、场景、比例、清晰度与所选模型都留在本机,编辑停顿约 0.35 秒即写入,
51
+ 下次打开接着改。
52
+
53
+ ## GIF 动图
54
+
55
+ - **支持 `gpt-image-2.6` 生成 GIF。** 面板新增「静图 / GIF 动图」切换,选了 GIF 才
56
+ 出现帧数与每帧时长;请求按 `output_format: 'gif'` 整形,帧数夹在 2–16、每帧不短于
57
+ 20ms,超出的按上限收窄而不是发出去被上游拒绝。
58
+ - **不支持的模型与渠道在发请求前就拒绝。** GIF 请求先过能力闸再分派协议:模型不支持、
59
+ 或渠道协议是 `chat-completions`(该请求体根本没有 `output_format` 字段,模型再新也
60
+ 只会出静图)时立即报错,不会静默降级成一张静图却照常计费。订阅渠道同样明确拒绝。
61
+ - **帧数与时长只有一个真值。** 面板上的时长提示、提交的参数、引擎的夹紧用的是同一个
62
+ 函数:清空输入框按「未设置」回落默认值,而不是一处按默认、一处按下限。
63
+ - **GIF 期间不能切到不支持的形态。** 「图生图」与「对比」置灰并说明原因;生成数量
64
+ 固定为 1 并注明理由,因为 GIF 受上游像素预算限制只能出单张。
65
+ - **动图在结果板、历史、画廊与画布里都按动图处理。** mime 按字节魔数判定
66
+ (GIF87a/GIF89a),下载扩展名、历史标记与画廊落盘都认 gif,预览用浏览器原生播放,
67
+ 不会只显示第一帧。
68
+
69
+ ## 已知边界
70
+
71
+ - **参考图片的权利归各来源原作者所有**,不适用本插件的代码许可证;使用时请遵守原站
72
+ 条款,部分素材不允许商用。面板底部显示当前素材的来源说明与原始链接。
73
+ - 这一版不改变「草稿读失败」本身的发生概率。**它留下的那个交互缺陷在 v1.23.1 才修**:
74
+ 草稿读取失败时整张表单被永久禁用,用户看到的是「角色搭配点了没反应」。
@@ -0,0 +1,46 @@
1
+ # v1.25.0 · 无限画布换用 react-flow 引擎;LibTV 式缩放菜单与视图开关
2
+
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
+
5
+ ## 画布引擎:@xyflow/react
6
+
7
+ 无限画布的渲染与视口交给 react-flow v12(受控视图),对齐 LibTV 一类产品的底层
8
+ 引擎;**现有功能全部保留**,用户磁盘上的画布数据零破坏。
9
+
10
+ - **唯一真源不变**:`CanvasDocument` v2 仍是文档层真源,宿主校验、revision 乐观锁、
11
+ 自动保存、撤销重做(60 步、视口不入历史)全部留在文档层,react-flow 只做受控视图。
12
+ - **混合架构**:react-flow 负责节点渲染、视口 transform、拖拽平移与滚轮缩放;
13
+ 节点拖动(边缘对齐吸附、标注卡随行、重叠提示)、四角 resize、选择、连线、
14
+ 捏合缩放、框选保留自定义引擎——既有手势与快捷键一个不丢。
15
+ - **无损适配层**:新增 `canvas-flow-adapter`(节点/连线/视口双向 round-trip,
16
+ metadata 全字段保留,「无 metadata」与「空 metadata」的区别保住)与
17
+ `canvas-flow-context`(模块级稳定节点外壳,探针与事件路由照旧)。连线持久化
18
+ 仍存 `{fromNodeId,toNodeId}`,workflow/compose/storyboard 的纯函数契约不动。
19
+ - **构建**:react-flow 及其依赖内联进 bundle,样式构建时经 lightningcss 内联注入;
20
+ 跨目录可复现构建字节一致。
21
+
22
+ ## LibTV 式 chrome
23
+
24
+ - **缩放预设菜单**:点缩放百分比打开——放大/缩小/适应全部内容、50%/100%/200%/
25
+ 400%/800% 预设、自定义百分比输入;缩放上限 500% → 800%。
26
+ - **视图开关**:对齐吸附(默认开,关掉后拖动不再吸附节点边缘)、显示连线
27
+ (隐藏持久边,进行中的连线预览与技能运行边不受影响)。
28
+ - 菜单文案补齐 zh/en/ru 三套。
29
+
30
+ ## 检查
31
+
32
+ - `pnpm run typecheck`、`pnpm build`:exit 0。
33
+ - `smoke.mjs` 107/107、`smoke-canvas-video.mjs` 17/17、`verify-canvas-layout`
34
+ (5 档面板宽度 chrome 无重叠)、`verify-ui-contracts`(含新增 adapter round-trip
35
+ 与视口有限值守卫两条正向检查)全绿。
36
+ - 反向验证:contracts 组 48 条(含新增 adapter 丢字段、视口守卫失效、tab stop
37
+ 锚点迁移、wheel 检查锚定 stage 四条)RED as expected。
38
+ - 真机(DSH profile uireview):用户现有 18 节点画布无损打开;缩放预设/自定义/
39
+ 吸附与连线开关、草图缩放重绘、标注框+引线层序、重叠徽标、视频上传与片段历史
40
+ 节点、视频悬浮工具条、shift 多选拼接条逐项实测;探针画布已删除;零控制台报错。
41
+
42
+ ## 已知边界
43
+
44
+ - 浅色主题节点填充对比 1.00:1、深色 1.44:1/3.19:1 是有意契约 pin,本轮未改。
45
+ - LibTV 的 TV Director agent 视图、Skill 市场、风格广场、角色造型室、积分体系
46
+ 属另一条产品线,不在本轮范围。
@@ -0,0 +1,20 @@
1
+ # v1.26.0 — 画布布局对齐 LibTV
2
+
3
+ 真机对比 LibTV 画布后,把画布内部 chrome 的布局骨架对齐过去;配色仍跟随宿主主题,插件外框(顶部功能 tab、宿主侧栏历史)按拍板保留不动。
4
+
5
+ ## 改动
6
+
7
+ - **悬浮顶栏**:顶栏不再占布局高度,画布铺满整个区域;玻璃细栏浮在画布上方,项目下拉、双击重命名、收藏、删除、全屏、保存状态原样保留。新节点落点语义不变(中心点只扣底部 dock)。
8
+ - **左下工具排**:网格吸附、显示连线两个开关从缩放菜单铺平为独立按钮,`aria-pressed` 暴露状态、高亮可见;与小地图、适应屏幕、缩放百分比并排成 LibTV 式左下一排。缩放菜单保留 50–800% 预设与自定义输入。
9
+ - **分组 dock**:17 个动作按「工具|建节点|库|运行|编辑|删除」六组重排,组间发丝分隔;tile 命中区 40px,hover 出标签。动作一个不删。
10
+ - **空态快捷卡**:画布无节点时居中提示 + 一排五张快捷卡(图片生成/视频生成/文本/分镜/文件),点一下即用现有创建动作在画布中心建节点;视频卡走现有视频选择器。一旦有节点,卡片退场。zh/en/ru 三语。
11
+ - 窄屏(≤760px)顶栏换行、选择器与标题收窄,不横向溢出。
12
+ - **真机走查修掉两个手势缺陷**:① 框选分支把空态快捷卡当空白,pointerdown 的 preventDefault+指针捕获抢走卡片 click——框选现在排除 `data-canvas-no-zoom` 面;② react-flow 在三开关全 false 时给节点 wrapper 设 pointer-events:none 且可继承,卡片本体收不到真指针、拖拽死掉——`.node` 外壳恢复 auto(交互子元素各自阻断冒泡,编辑/按钮不受影响)。两条都配了契约不变式与反向用例。
13
+
14
+ ## 验证
15
+
16
+ - `pnpm run typecheck`、`pnpm build`、`verify-reproducible` 绿。
17
+ - `smoke.mjs` 全绿,含新增空态驱动检查:空文档渲染五卡 → 点文本卡建节点 → 卡片退场 → 恢复 fixture。
18
+ - `verify-canvas-layout.mjs`:997/860/720/560/420px 面板宽度下 dock/zoom/minimap 零重叠、全部在画布内。
19
+ - `verify-ui-contracts.mjs`:双主题契约不变(浅色节点/画布 1:1 保留),z 表 topbar 层级照旧。
20
+ - 反向:新增「空态失去快捷卡」用例 RED as expected;其余组全量复跑。
@@ -0,0 +1,42 @@
1
+ # v1.27.0 — 千问生图 API;大图预览可按住拖动
2
+
3
+ 本版是 **v1.24.0 之后的第一个发布版本**,把已合入 main 但一直没发出去的三批改动一起放出:1.25.0 的 react-flow 画布引擎、1.26.0 的画布布局对齐 LibTV,以及本次的千问生图协议与预览拖拽修复。1.25.0 / 1.26.0 没有各自的 tag 与 Release,它们的完整改动见 [v1.25.0](./v1.25.0.md) 与 [v1.26.0](./v1.26.0.md),都包含在本版的安装包里。
4
+
5
+ ## 本次新增
6
+
7
+ ### 千问生图 API 协议(#32)
8
+
9
+ 渠道「接口协议」新增 **千问生图 API**,支持文生图与图生图:
10
+
11
+ - 走 DashScope 的异步任务链路:提交任务拿 `task_id`,再轮询任务接口取结果,轮询上限 240 秒,超时抛 `upstream-timeout` 而不是一直挂着。
12
+ - 任务状态分三类识别:进行中(`queued` / `pending` / `running` / `processing` / `in_progress`)、完成(`done` / `completed` / `succeeded` / `success`)、失败(`failed` / `failure` / `error` / `cancelled` / `canceled`);出现词表之外的状态直接报 `upstream-invalid`,不当成「还在跑」无限等下去。
13
+ - 比例按 API 文档档位发送;面板的 **21:9 没有对应档位,按最接近的 16:9 发送**。清晰度映射到 `megapixels`,**上游上限 2MP,所以 2k 与 4k 都取最高档**。
14
+ - 图生图上传参考图的原始字节,不做二次转码。
15
+ - API Key 为空时不发送空的 `Bearer ` 头。
16
+ - 渠道支持模型检测;协议选项与提示文案补齐 zh/en/ru。
17
+
18
+ ### 修复:配置里的 Google 原生协议被 schema 拒绝
19
+
20
+ `src/index.ts` 的 schemastery `protocol` 联合只列了 `auto` / `images` / `chat-completions`,漏掉了类型里早已存在的 `google-native`。用真实 schemastery 实测:旧 schema 对 `protocol=google-native` 报 `expected "auto" | "images" | "chat-completions" but got "google-native"`,新 schema 通过。这是 #32 顺带修掉的一个独立缺陷,与千问协议无关。
21
+
22
+ ### 修复:大图预览放大后无法拖动(#31)
23
+
24
+ 生成成功的图片点开大图、放大之后,以前只能拉旁边的滚动条才能看到画面其余部分。现在**按住鼠标左键直接拖动画面**即可平移:
25
+
26
+ - 用 pointer 事件接管,`setPointerCapture` 保证指针移出图片也不丢拖动;反向写 `scrollLeft` / `scrollTop`,移动距离与鼠标一致。
27
+ - 光标在可平移时是 `grab`,拖动中变 `grabbing`,松手复原。
28
+ - **拖动之后紧跟的那一次 click 不会误关预览**:抑制器挂在浮层的捕获阶段且只吞一次,随后的普通点击照常关闭。
29
+ - 只接管鼠标主键;触摸交给浏览器原生滚动,内容没有溢出时不拦按下。图片本身禁用原生拖拽,避免拖出幽灵图。
30
+
31
+ ## 一并发布的前两批
32
+
33
+ - **1.25.0 — 无限画布换用 react-flow 引擎**:`@xyflow/react` v12 做受控视图,`CanvasDocument` v2 仍是唯一真源,磁盘数据零破坏;节点拖动/吸附、四角 resize、连线、捏合缩放、框选与快捷键全部保留;新增无损适配层与 LibTV 式缩放菜单、视图开关。
34
+ - **1.26.0 — 画布布局对齐 LibTV**:悬浮顶栏、左下工具排、六组分隔 dock、空态五张快捷卡;并修掉真机走查发现的两个手势缺陷(框选抢走快捷卡 click、react-flow wrapper 的 `pointer-events:none` 继承导致卡片拖不动)。
35
+
36
+ ## 验证
37
+
38
+ - `pnpm run typecheck`、`pnpm run build`、`pnpm test` 全绿,含 `UI CONTRACTS VERIFIED` 与全部反向用例。
39
+ - 新增 `smoke-qwen-draw.mjs`:桩 fetch、零网络,断言请求体深度相等、`21:9→16:9`、`4k→2MP`、参考图上传原始字节;接入 `pnpm test` 与 `test:negative`(`1/1 defects turn the check red`)。
40
+ - #31 在**打包产物解包部署后的真实实例**上复验:200% 缩放下内容 2190×1185 对视口 1095×593,拖动 200×80 后 `scrollLeft` 547.5→347.5、`scrollTop` 296→216(与拖动距离精确相等);拖动中 `data-dragging` 存在且光标 `grabbing`,松手清除;拖后 click 浮层不关,随后普通 click 正常关闭。
41
+ - 千问协议在真实设置界面确认可选:设置 → 生图配置 → 添加自定义渠道 → 接口协议下拉中的「千问生图 API」,选中后表单正常切换。
42
+ - **未用真实 API Key 发起过千问生图请求**,线上计费链路的实际返回未经验证;引擎层由零网络桩覆盖。