@q253595422/dsh-imagegen-video 1.19.1 → 1.21.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,48 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
5
5
 
6
6
  ## Releases
7
7
 
8
+ ### 1.21.0 — 画布底部工具条自适应,Agent 生成结果可直接内嵌
9
+
10
+ - **画布底部浮层不再互相压盖,窄了就换行。** 任务工具条、缩放条、缩略图原来是三个各自绝对定位的图层,
11
+ 彼此不知道对方尺寸:三栏布局下画布只有约 1000px,711px 的任务工具条与 236px 的缩放条横向重叠约 107px,
12
+ 压住缩放条最左侧四个按钮;面板 560px 时工具条还会溢出左边。这类重叠取决于**面板**宽度而不是窗口宽度,
13
+ `@media` 测不到,jsdom 也没有排版引擎,测试一直是绿的。现在三者合并成一个换行 flex 行,宽度不够时
14
+ 任务工具条换行而不是盖上去;工具条自身也会在面板比它窄时折行(实测窄于约 690px 折成 2 行、83px 高)。
15
+ - **画布给底部浮层留出真实高度。** 浮层浮在画布之上不占布局空间,`fitView` / 新建节点 / 种子节点
16
+ 算的都是被遮挡的几何中心。现在用 `ResizeObserver` 实测「视口底 − 任务工具条顶」并三处减掉;
17
+ 不用浮层总高是因为缩略图在左侧、不挡中间,按总高留会白扔 150px。
18
+ - **Agent 生成结果输出落盘绝对路径,支持在回复正文内嵌图片。** 工具结果新增 `files` 与 `embed_id`,
19
+ 提交时带 `agentTool` 标记区分 Agent 生成与面板生成。不新增 UI 注入。
20
+ - **修复 `files[]` 永远是空数组。** 没有任何地方给 `embedId` 赋值,结果回来时短路成 `files: []`。
21
+ 现在两条路径都先建 id 再 append,且只在 store 确实列出该条目时才回显——写盘被丢弃时不给不存在的路径。
22
+ - **顶栏新增画布全屏控件。** 走真实 Fullscreen API,任何途径退出全屏都会回写到按钮状态;
23
+ 模板库抽屉改挂载到画布根节点,避免在全屏元素之下被盖住。
24
+ - **验证**:`tsc` 0 错、`pnpm build` 与 `pnpm test` 全套通过;新增真浏览器布局守卫
25
+ `verify-canvas-layout.mjs`(五档面板宽度零重叠 + fixture 双向核对),反向验证注回旧布局后实测
26
+ 重叠从 0 变成 2644px² 并变红。
27
+
28
+ ### 1.20.0 — 接入 snapgen.ai 视频模型
29
+
30
+ - **新增 snapgen.ai 视频协议族。** 渠道预设新增 `snapgen.ai`,支持 `grok-1.5-lite`、`grok-video`、
31
+ `grok-lower`、`muse-ai-video`、`vela-ai-video` 五个模型。该服务不是 OpenAI 兼容接口:提交是
32
+ multipart 加自研反爬守卫头 `x-guard-id`,返回历史 uuid 而不是任务 id,状态接口 `GET /history/{uuid}`
33
+ 用数字状态(1 生成中 / 2 完成 / 3 失败),成片地址在 `generated_video[0].video_url`。这四条都在
34
+ `src/snapgen-engine.ts` 里单独实现,`video-engine.ts` 只负责编排。
35
+ - **密钥填 refresh_token,Access Token 自动续期。** Access Token 只有约 10 分钟有效期,过期时上游
36
+ 返回的是 HTTP 403 `TOKEN_EXPIRED` 而不是 401,所以引擎按 JWT `exp` 提前续期,并在收到带 TOKEN
37
+ 字样的 403 时强制刷新后重试一次。密钥栏接受原始 refresh_token、`{"refresh_token":"…","cdp_port":9333}`
38
+ 形式的 JSON,或一枚仍在有效期内的 access_token。
39
+ - **每次提交现场换取一次性 Cloudflare Turnstile token。** 上游强制校验,token 一次性且绑定 site key,
40
+ 无法缓存或本地计算,因此通过本机 CDP Chrome(默认端口 9333,无头亦可)在真实 snapgen.ai 页面上换取。
41
+ - **按模型区分能力。** 时长与比例词表按模型收窄后渲染:`grok-*` 为 6/10/15 秒,`muse-ai-video` 固定
42
+ 10 秒,`vela-ai-video` 固定 5 秒;五个模型都支持文生视频,`muse`/`vela` 另有图生视频。视频面板与画布
43
+ 的时长、比例、分辨率选项改为读目录数据,不再写死 `[5, 10]`。
44
+ - **只有视频模型的渠道可以保存了。** 以前渠道至少需要一个图片模型标识才能保存,只接视频的 snapgen
45
+ 渠道因此存不下来;校验与「已就绪」判定改为图片或视频模型任一非空即可。
46
+ - **验证**:`tsc` 0 错;离线冒烟新增两组断言(守卫字节与实测值逐字节对齐、提交前失败不触网),
47
+ `smoke-video.mjs` 33 项全过;通过插件本体对 api.snapgen.ai 实跑成功出片:文生视频 10 秒 4.3 MB、
48
+ 图生视频 10 秒 7.7 MB,均为 h264 + aac 的有效 MP4。
49
+
8
50
  ### 1.19.1 — 修正历史提示词换行展示位置
9
51
 
10
52
  - **左侧边栏历史卡片恢复 2 行截断。** 修复之前误将左侧卡片提示词取消截断导致长文本撑高卡片、
package/README.md CHANGED
@@ -188,6 +188,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
188
188
  | 火山 Seedance(方舟) | `doubao-seedance-2-0-260128`、`doubao-seedance-2-0-fast-260128`、`doubao-seedance-1-0-pro-250528` | 方舟原生任务协议:提交 `POST /contents/generations/tasks`,轮询 `GET /contents/generations/tasks/{id}`,成片在 `content.video_url`。提示词与参考图放在 `content` 数组里(参考图带 `role`:`first_frame` / `last_frame` / `reference_image`),比例字段是 `ratio`,分辨率小写。时长:2.x 为 4–15 秒、1.0 为 2–12 秒。分辨率:2.0 支持 480p/720p/1080p/4k,`fast` / `mini` 只到 720p;1.0 为 480p/720p/1080p。1.0 不支持 `reference_image` 角色,`1.0 pro fast` 也不支持尾帧,面板会把这两种模式从该型号上收起来。 |
189
189
  | 算力萌 comemoe | `wan2.2-t2v`、`zhimeng-h3-local` | `wan2.2-t2v` 仅文生视频;`zhimeng-h3-local` 支持图生视频。比例只接受 16:9 / 9:16 / 1:1;5 秒片子实测约 9 分钟。 |
190
190
  | xAI Grok | `grok-imagine-video-1.5`、`grok-imagine-video-1.5-lite` | 提交 `POST /videos/generations`(注意不是 `/videos`),轮询 `GET /videos/{id}`,取 `video.url` 与 `video.duration`。 |
191
+ | snapgen.ai | `grok-1.5-lite`、`grok-video`、`grok-lower`、`muse-ai-video`、`vela-ai-video` | 非 OpenAI 兼容:`multipart` 提交 + 反爬守卫头 `x-guard-id`,返回历史 `uuid` 而不是任务 id,`GET /history/{uuid}` 用**数字状态** 1 生成中 / 2 完成 / 3 失败,成片在 `generated_video[0].video_url`(预签名,未鉴权即可下载)。每次提交要一枚一次性 Cloudflare Turnstile token,由本机 CDP Chrome 现场换取。详见下文。 |
191
192
  | 通用视频 | 其他视频模型 id | 按 OpenAI 兼容视频端点尽力适配;未识别的协议族会明确报错,不会静默发出错误请求。 |
192
193
 
193
194
  - **生成模式**:文生视频、图生视频(单张参考图)、首尾帧(首帧+尾帧插值)、参考图(多张风格/主体参考);不同模型支持的模式不同,面板只会给出该模型支持的选项。
@@ -204,6 +205,37 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
204
205
 
205
206
  </details>
206
207
 
208
+ #### snapgen.ai 视频(需要本机 Chrome)
209
+
210
+ 预置渠道里选 **snapgen.ai** 即可带出五个视频模型。这条链路和别的渠道有三处不一样,配置时要注意:
211
+
212
+ **1. 密钥填 refresh_token,不是 access_token。** snapgen 的 access_token 只有十分钟寿命,过期后接口返回的是 `403 TOKEN_EXPIRED` 而不是 401。渠道密钥可以填三样东西之一:
213
+
214
+ - 直接填 `refresh_token`(形如 `"邮箱".xxxx.yyyy`)——最简单;
215
+ - 或者填 JSON:`{"refresh_token":"…","cdp_port":9333}`,其中 `cdp_port` 指定去哪个 CDP 端口换 Turnstile;
216
+ - 或者填一个还没过期的 `access_token`(JWT,`eyJ…` 开头),只在它过期前能用。
217
+
218
+ 宿主每次提交前都会用 refresh_token 换新 token,所以刷新失效时只需更新这一个字段。
219
+
220
+ **2. 提交前要一枚 Turnstile token,只能由真浏览器换来。** snapgen 不接受没有 `turnstile_token` 的提交(`400 TURNSTILE_REQUIRED`),也不接受复用的 token。插件会在提交时连上本机带调试端口的 Chrome,在 snapgen.ai 页面里现场渲染并执行一次 Turnstile 组件,把拿到的 token 塞进这次 `multipart` 请求。所以:
221
+
222
+ - 需要本机有一个开了 `--remote-debugging-port` 的 Chrome(默认 9333),并且有(或能自动打开)一个 snapgen.ai 标签页;无头模式同样可用。
223
+ - 换不到 token 时提交会直接报 `snapgen-turnstile`,不会发一个注定被拒的请求。
224
+ - 这一步与登录状态无关,用的是站点公开的 Turnstile sitekey。
225
+
226
+ **3. 参数与模式按模型收窄。** 面板会按所选模型给出该模型真正接受的比例/分辨率/时长:
227
+
228
+ | 模型 | 模式 | 比例 | 分辨率 | 时长 | 额度 |
229
+ | --- | --- | --- | --- | --- | --- |
230
+ | `grok-1.5-lite` | 文生视频 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4(线上映射成 landscape / portrait / square / 3:2 / 2:3) | 480p / 720p / 1080p | 6 / 10 / 15 秒 | 免费账号每天 5 条;1080p 需要付费套餐 |
231
+ | `grok-video`、`grok-lower` | 文生视频 | 同上 | 480p / 720p / 1080p(`grok-video` 另有 4k) | 6 / 10 / 15 秒 | 免费账号不可用(`main_limit 0/0`) |
232
+ | `muse-ai-video` | 文生 / 图生视频 | landscape / portrait / square | — | 固定 10 秒 | 每天 100 条 |
233
+ | `vela-ai-video` | 文生 / 图生视频 | landscape / portrait / square | — | 固定 5 秒 | 每天 10 条,但服务端长期维护中,实测常返回 `HIGH_TRAFFIC_ERROR` |
234
+
235
+ 超出套餐或额度时返回的是 `snapgen-premium` / `snapgen-quota` / `snapgen-credit`,面板与 Agent 会原样转述上游文案(例如「Daily limit reached (main_limit: 5/5)」)。
236
+
237
+ 代码落点:`src/snapgen-engine.ts`(守卫头、Turnstile、`multipart` 提交、数字状态轮询、token 刷新)与 `src/video-engine.ts` 的 `snapgen` 分支。
238
+
207
239
  #### 代码生成路径(不调生图/生视频模型)
208
240
 
209
241
  画布合成栏里有一个「生成方式」下拉,两个选项:**模型生成**(默认,就是上面那整条链路)和**代码生成**。它**按任务选**,不写进设置、不做全局开关;同一个画布上这一张用模型、下一张用代码都行。
@@ -297,7 +329,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
297
329
  <img src="docs/images/wechat-group-qr.png" alt="微信群「龙虾吹水🦞群」的加群二维码" width="360" />
298
330
  </div>
299
331
 
300
- > 二维码 7 天内有效(2026 年 11 月 1 日前)。过期或人数已满时,请改到
332
+ > 二维码 7 天内有效(2026 年 11 月 8 日前)。过期或人数已满时,请改到
301
333
  > [Issues](https://github.com/q253595422/dsh-imagegen-video/issues) 提问题,
302
334
  > 并提醒维护者换一张新码。安全敏感的问题不要发在群里,也不要贴 API 密钥。
303
335
 
@@ -0,0 +1,57 @@
1
+ # v1.20.0 · 接入 snapgen.ai 视频模型
2
+
3
+ 本版新增 snapgen.ai 视频协议族,把 Grok / Muse / Vela 系列视频模型接进插件;同时把视频时长与画面比例的选项改成由模型目录驱动,并解除“渠道必须至少有一个图片模型”的限制。
4
+
5
+ ## 主要更新
6
+
7
+ - **新增 `snapgen.ai` 渠道预设**,支持 `grok-1.5-lite`、`grok-video`、`grok-lower`、`muse-ai-video`、`vela-ai-video`:
8
+ - 该服务不是 OpenAI 兼容接口,`src/snapgen-engine.ts` 单独实现四条差异:multipart 提交 + 自研反爬守卫头
9
+ `x-guard-id`;返回历史 uuid 而不是任务 id;`GET /history/{uuid}` 用数字状态(1 生成中 / 2 完成 / 3 失败);
10
+ 成片地址在 `generated_video[0].video_url`(预签名,未鉴权即可下载)。`video-engine.ts` 只做编排。
11
+ - 密钥栏填 **refresh_token**:Access Token 只有约 10 分钟有效期,且过期返回的是 HTTP 403 `TOKEN_EXPIRED`
12
+ 而不是 401,所以引擎按 JWT `exp` 提前续期,并在收到带 TOKEN 字样的 403 时强制刷新后重试一次。
13
+ 接受原始 refresh_token、`{"refresh_token":"…","cdp_port":9333}` 形式的 JSON,或仍在有效期内的 access_token。
14
+ - 每次提交都需要一枚一次性 Cloudflare Turnstile token(绑定 site key,无法缓存或本地计算),
15
+ 由本机 CDP Chrome 在真实 snapgen.ai 页面上现场换取:默认端口 9333,无头 Chrome 亦可。
16
+ 换不到时错误码为 `snapgen-turnstile`。
17
+ - **按模型收窄时长与比例词表**:`grok-*` 为 6/10/15 秒,`muse-ai-video` 固定 10 秒,`vela-ai-video` 固定 5 秒;
18
+ 比例在 `grok-*` 上映射为 landscape / portrait / square / 3:2 / 2:3,在 `muse`/`vela` 上只有前三种。
19
+ 视频面板与画布作曲家的时长、比例、分辨率下拉都改为读 `describeVideoModel()` 的目录数据,
20
+ 不再写死 `[5, 10]` 与 `['16:9','9:16','1:1']`。
21
+ - **只有视频模型的渠道可以保存**:以前 `validateChannelDraft` 要求至少一个图片模型标识,只接视频的渠道存不下来;
22
+ 现在图片或视频模型任一非空即可,侧栏的就绪状态与模型计数也一并按两者合计。
23
+ - **预设列表显示并可搜索视频模型**:预设行原来只展示图片模型别名,snapgen 这类纯视频预设会显示为空白;
24
+ 现在搜索与行内说明都包含视频模型别名。
25
+ - **修复浏览器布局守卫的假失败**:`verify-video-layout.mjs` 用 1520px 宽的窗口描述问题,却从未设置视口,
26
+ 无头 Chrome 默认 756×469 会命中样式表自己的 `@media (max-width: 760px)` 断点,把生成行折成一列后
27
+ 报出并不存在的“37% 太窄”。现在用 `Emulation.setDeviceMetricsOverride` 固定视口,守卫测得 97% 通过。
28
+ - **修复对比任务并发断言在负载下抖动**:模拟上游的重叠窗口只有 50ms,整套测试并行跑时会退化成串行,
29
+ 报 `maxGenerationRequests===1`。窗口放宽到 300ms,断言仍是“两条请求在上游重叠”。
30
+
31
+ ## 验证
32
+
33
+ - `tsc --noEmit` 0 错,`pnpm build` 通过。
34
+ - 离线冒烟新增两组断言:守卫字节与线上实测值逐字节对齐(含 `/api` 前缀参与签名的证明),
35
+ 以及空密钥 / 不支持的生成模式在触网前就失败并留下诊断记录。`smoke-video.mjs` 33 项全过。
36
+ - 通过插件本体的 `generateVideo()` 对 api.snapgen.ai 实跑出片:
37
+ 文生视频 `muse-ai-video` 10 秒 4.3 MB、图生视频 10 秒 7.7 MB,`ffprobe` 均为 h264 + aac 的有效 MP4。
38
+
39
+ ## 已知限制
40
+
41
+ - `vela-ai-video` 提交会被接受,但服务端当前稳定返回 `HIGH_TRAFFIC_ERROR`(页面也标为维护中),插件如实透传该错误。
42
+ - `grok-video` 与 `grok-lower` 需要付费套餐,免费账号上游返回 `DAILY_LIMIT_EXCEEDED`(错误码 `snapgen-quota`)。
43
+ - grok 系列是否接受参考图(`files` 字段)尚未实测:免费额度只有每天 5 条,当日额度已用尽。
44
+
45
+ ## 安装
46
+
47
+ 从 DSH 插件市场安装:
48
+
49
+ ```bash
50
+ dsh plugin --profile web add @q253595422/dsh-imagegen-video@1.20.0
51
+ ```
52
+
53
+ 本地安装发布产物:
54
+
55
+ ```bash
56
+ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.20.0.tgz
57
+ ```
@@ -0,0 +1,60 @@
1
+ # v1.21.0 · 画布底部工具条自适应,Agent 生成结果可直接内嵌
2
+
3
+ 本版修掉无限画布底部三件浮层(任务工具条、缩放条、缩略图)互相压盖的问题,让窄面板下换行避让而不是叠在一起;
4
+ 同时给 Agent 的图片工具补上落盘路径输出,模型可以在回复正文里直接内嵌生成结果。
5
+
6
+ ## 主要更新
7
+
8
+ - **画布底部浮层不再互相压盖,窄了就换行。** 任务工具条、缩放条、缩略图原来是三个各自绝对定位的图层
9
+ (`left: 50%` / `left: 14px` / `left: 14px; bottom: 62px`),彼此不知道对方尺寸。在三栏布局下画布实际只拿到约 1000px,
10
+ 711px 的任务工具条与 236px 的缩放条横向重叠约 107px,压住缩放条最左侧的「选择 / 平移 / 添加图片 / 添加文本」四个按钮;
11
+ 面板窄到 560px 时工具条还会溢出左边被裁掉。这类重叠取决于**面板**宽度而不是窗口宽度,所以 `@media` 断点测不到,
12
+ jsdom 也没有排版引擎,整套测试一直是绿的。
13
+ 现在三者合并成一个 `.canvasChrome` 换行 flex 行:宽度够时同排,不够时任务工具条换到第二行而不是盖上去;
14
+ 任务工具条自身也会在面板比它窄时把 17 个按钮折行。侧列固定靠左,任务工具条用 `margin-inline: auto` 居中,
15
+ 换行后它独占的一行同样居中。
16
+ - **画布给底部浮层留出真实高度,「适应全部内容」不再把节点放到工具条后面。** 底部浮层浮在画布之上、不占布局空间,
17
+ 所以 `fitView` / 新建节点 / 新画布种子节点算的都是被遮挡的几何中心。现在用 `ResizeObserver` 实测
18
+ `视口底 − 任务工具条顶` 的差值(不是浮层总高:缩略图在左侧、不挡中间,按总高留会白扔 150px),
19
+ 三处都减掉它。之所以实测而不是写常量,是因为折行、以及 Hover 时弹簧动画都会改变这个高度。
20
+ - **Agent 生成结果输出落盘绝对路径,支持在回复正文内嵌图片。** `generate_image` / `edit_image` 的工具结果新增
21
+ `files`(当前生成图的绝对路径)与 `embed_id`;`generate_image` 与 `edit_image` 提交时带 `agentTool` 标记,
22
+ 用来把 Agent 生成与面板手动生成区分开。最终回复在最前面用 Markdown 图片语法内嵌、说明文字在后。
23
+ 不新增任何 UI 注入,官方工具卡与工作步骤展示保持原样。
24
+ - **修复 `files[]` 永远是空数组。** 上一条最初只读取 `task.result.embedId`,但没有任何地方给它赋值:
25
+ 生成路径在 `history.append()` 里内联构造历史 id,结果回来时没有这个字段,`taskResult()` 直接短路成 `files: []`。
26
+ 现在两条路径(模型生成与代码渲染)都先建好 id、再交给 append,并且只在 store 确实列出了该条目时才回显 `embedId`
27
+ ——写盘被静默丢弃时不会给出磁盘上并不存在的路径。
28
+ - **白给一个画布全屏控件。** 顶栏新增全屏按钮,走真实 Fullscreen API;从任何途径退出全屏(Esc、浏览器自身控件)
29
+ 都会回写到按钮状态。模板库抽屉改为挂载到画布根节点——挂到 `<body>` 的 portal 在全屏元素之下会被盖住。
30
+
31
+ ## 验证
32
+
33
+ - `tsc --noEmit` 0 错,`pnpm build` 通过,`pnpm test` 全套通过。
34
+ - 新增真浏览器布局守卫 `scripts/verify-canvas-layout.mjs`:在 997 / 860 / 720 / 560 / 420px 五档面板宽度下断言
35
+ 三件浮层两两零重叠、且都在画布内;fixture 用到的每个类名都先与组件和样式表双向核对,防止 fixture 过期后仍然假绿。
36
+ - 反向验证(`pnpm run test:negative`)新增一例:把旧的三件绝对定位注回仓库副本,守卫必须变红
37
+ (实测重叠从 0 变成 2644px²)。
38
+ - Agent 侧的 `files[]` 修复有针对性断言:C9 的历史 sink 改成与真实 store 一致的行为,断言回显的 id
39
+ 与每张生成图各一条绝对 `.png` 路径——旧写法下这个断言必然失败。
40
+
41
+ ## 已知限制
42
+
43
+ - 三栏布局(画布约 997px)下,任务工具条只能在左侧 236px 侧列之外的剩余空间里居中,视觉上比窗口正中偏右约 124px。
44
+ 这是「不压住缩放按钮」的取舍;要严格居中就得放弃避让。
45
+ - 面板窄于约 690px 时任务工具条会折成两行(实测 560px 与 420px 都是 2 行、83px 高)。能点、不重叠,
46
+ 但底部被占的高度从 43px 变成 83px。更窄的面板不会继续增加行数,只会有更多按钮留在第二行。
47
+
48
+ ## 安装
49
+
50
+ 从 DSH 插件市场安装:
51
+
52
+ ```bash
53
+ dsh plugin --profile web add @q253595422/dsh-imagegen-video@1.21.0
54
+ ```
55
+
56
+ 本地安装发布产物:
57
+
58
+ ```bash
59
+ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.21.0.tgz
60
+ ```