@q253595422/dsh-imagegen-video 1.29.0 → 1.30.2
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 +32 -1
- package/docs/releases/v1.29.0.md +43 -15
- package/docs/releases/v1.30.0.md +60 -0
- package/docs/releases/v1.30.1.md +67 -0
- package/docs/releases/v1.30.2.md +96 -0
- package/lib/client.js +688 -55
- package/lib/client.js.map +1 -1
- package/lib/index.js +222 -36
- package/lib/locale-tables-chunk.js +75 -0
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -5,13 +5,44 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
|
|
|
5
5
|
|
|
6
6
|
## Releases
|
|
7
7
|
|
|
8
|
-
### 1.
|
|
8
|
+
### 1.30.1 — 三个「已经实现但没有入口」的功能补上界面
|
|
9
|
+
|
|
10
|
+
- **画布整图导出 / 导入接上界面**:后端两条路由与 `buildCanvasBundle` / `parseCanvasBundle` 早就写好了,客户端一直是零引用。现在画布顶栏全屏按钮右侧两个入口。导出把文档连同每个图片资产的字节打成一个 JSON;片段是**引用而非拷贝**(捎上整段视频会让体积不可用),所以带片段的画布一定会产生 `unresolved`,提示按 `asset` / `video` 分开计数告诉用户换台机器后哪部分打不开。导入**总是创建新画布**、分配新 id,绝不覆盖已有画布。
|
|
11
|
+
- **两处实现细节**:导出在 `finally` 里 `revokeObjectURL`(几百 MB 的 blob 留在文档生命周期里是内存泄漏);导入**刻意不走 `seedDocument`**——那个函数会给空画布注入一对起点节点,对新画布是对的、对导入是错的,导出一张空画布应当收回一张空画布。
|
|
12
|
+
- **工作流三项开关接上界面**:底栏工作流按钮旁多一个箭头,可切换「复用上次产物」(默认开)、「强制重跑选中节点」(默认关)、「层内并发」(默认开)。三个默认值都等于升级前写死的行为,所以**直接点主按钮与旧版完全一致**——这也是没有采纳「把运行塞进菜单」的原因:那会让常用路径每次都多点一下,而默认值本来就保证了不会误关复用。
|
|
13
|
+
- **「复用」有两层,必须同时受控**:`runWorkflowPlan` 的 `reuse` 数组(节点级不提交)与 `runWorkflowNode` 的 `reuse` 布尔闸门(`hasProduce` 时短路成 cached)是两回事。此前调用点只写死了后者,只关前一层的话节点仍会被短路——用户看到开关关了,实际什么都没重跑。
|
|
14
|
+
- **补上「写错了也不会有任何测试变红」的那一层**:执行器层原本覆盖得不错,缺的是界面有没有把参数传下去。`smoke-workflow.mjs` 新增接线断言(默认值、两处 `reuse` 同受控、`maxParallel` 方向、重跑只交起点、`useCallback` 依赖),并补执行器两个真实边界:`maxParallel=2` 时同时在飞**恰好** 2 个(此前只测 1 与「不限」两个极端),以及 `0`/`-3`/`1.5`/`NaN` 一律按 1 处理(漏掉归一会让宽度变 0,一个节点都不派发,工作流静默挂住)。
|
|
15
|
+
- **`smoke.mjs` 真机断言**:在 jsdom 渲染的画布上确认两个按钮确实在顶栏、`accept` 正确、且没有被打上 `data-dock-item`(那是底栏瓦片的标记,布局守卫会逐个量宽度)。
|
|
16
|
+
- **反向用例实证**:把单节点闸门改回 `true`、把限流归一拆掉、把导出按钮文案改错,各自都让对应断言变红;还原后恢复绿色。
|
|
17
|
+
- **已知未覆盖**:导出/导入只验证到渲染与接线,真实的几百 MB 导出、跨机器导入、`unresolved` 长文案折行需一次真机走查;大画布导出期间只有按钮变灰,没有百分比进度。导入不做版本兼容转换。
|
|
18
|
+
|
|
19
|
+
### 1.30.0 — 模型能力改为内置基线表;修好聚合网关模型被误判为未知协议
|
|
20
|
+
|
|
21
|
+
- **新增 `src/model-baseline.ts`:一张内置的模型基线表**,把「哪些模型 id 属于哪个协议族、以及它是否还该被推荐」从代码分支里搬到数据表。此前每加一个族就要在 `describeModel` 的 if 链上加一段、每出一个新 id 都要改代码;现在弃用一个上游模型是**表里改一行**,与请求拼装逻辑分开评审、分开回溯。
|
|
22
|
+
- **不做远程拉取,这是刻意的**:能力目录全部内置,插件不发任何额外的网络请求。上游弃用时发一个小版本更新基线表即可,用户不需要联网同步,也不会有一次「目录接口挂了导致面板不可用」的故障面。代价是表会滞后于上游,所以**保留命名约定兜底**(见下条)。
|
|
23
|
+
- **修掉一个线上就存在的误判**:聚合网关按 `vendor/model` 寻址(`google/gemini-3-pro-image`),旧实现拿原始串直接比对,于是 OpenRouter 预设**落到 `unknown`**——面板随即把它当成「只能带 1 张参考图」而误报警告,engine 也退回通用 OpenAI 协议。现在查表前剥掉一层厂商前缀(只剥一层,`a/b/c` 不会塌成 `c`)。本仓库默认模型与全部预设跑一遍,**unknown 从 1 条降到 0 条**。
|
|
24
|
+
- **三层判定,顺序是重点**:① 基线表精确命中(唯一能报生命周期的层)→ ② 命名约定归族(保证上游新出的后缀不至于掉进 `unknown`)→ ③ 真的认不出才 `unknown`,仍走尽力而为的通用请求。表不需要追着上游每次发版更新。
|
|
25
|
+
- **新增模型生命周期提示,是提示不是拦截**:表里标了 `deprecated` / `removed` 的 id,会在模型选择器下方显示一行说明(有替代品时点名建议改用哪个),走真实主题的 `state-warn` / `state-error` token。**请求照发、不改写、不禁用**——用户可能挂在中转站上,那边仍在服务一个原厂已经下线的模型,硬拦会弄坏本来能跑的流程。三语齐备。
|
|
26
|
+
- **刻意不写自动关停日期**:本轮试图核对 OpenAI / Google 官方弃用页,三个入口从构建环境均不可达(403 与超时)。日期是整个页面里最容易变、又最无法在本机验证的一项,写错比不写更有害——要么劝退一个还能用的模型,要么承诺一个已经结束的支持。因此 `lifecycle` 只记录**已经发生**的状态,且每条都必须写明 `source`(测试强制),方便下一个人复核而不是照信。表里目前**没有一条被标为弃用**:没有可靠证据就不编。
|
|
27
|
+
- **测试**:新增 `scripts/smoke-model-baseline.mjs`(22 条),覆盖厂商前缀剥离、三层判定、生命周期映射与「不拦截请求」这条边界;接入 `pnpm test` 与 `test:negative` 新组 `baseline`。两条反向用例**实证能变红**:把前缀剥离退回原样、把默认生命周期改成 `deprecated`,各自让对应用例失败。smoke 另加一条真机断言——活跃模型不得出现生命周期提示(误报的代价是让用户习惯性忽略这一行)。
|
|
28
|
+
- **边界如实说明**:表里同一批 id 的族判定与能力标注是照现有协议实现填的,**没有对每个 id 逐一发起真实调用验证**;生命周期提示的正向分支目前没有真实数据可渲染,只能由纯函数测试覆盖。
|
|
29
|
+
|
|
30
|
+
### 1.29.0 — 插件改名「团团TV」;入口可被扫描器验证;侧栏适配 DSH 0.2.2
|
|
9
31
|
|
|
10
32
|
- **插件显示名定为「团团TV」**(英文界面 `TuanTuan TV`),包名 `@q253595422/dsh-imagegen-video` 不变——npm 包名不允许中文,改的是用户看到的那一层。声明方式是 `locale/zh.json` 与 `locale/en.json` 的 `meta.title`:宿主插件详情页从这个字段取标题,**此前没有声明,于是回退显示完整包名**,页面上就是 `@q253595422/dsh-imagegen-video`。
|
|
11
33
|
- **三语品牌文案统一**:`entry.label`(侧边栏入口)、`panel.title`(面板标题,原为 `VisioWork`)、`settings.title`(设置卡标题)、`config.disabledTitle`(停用提示)在 zh / en / ru 三语里改成同一个名字。此前三处各写各的,互不一致。
|
|
12
34
|
- **Agent 指导文案与 `/edit_image` 成功提示**同步改用新名;指导文案保留包名以免模型对不上实际安装的模块。
|
|
13
35
|
- **刻意不改**:设置分区名「生图配置 / Image settings / Настройки генерации」。它是位置名不是品牌名,后端 22 处错误提示与 3 条测试断言按它定位,改它得成批同步且不带来品牌收益。
|
|
14
36
|
- 新增 `smoke` 的 **D6** 守卫:两语 `meta.title` 必须存在且非空、中文必须是「团团TV」、英文不得回退成包名、且与界面里的 `panel.title` / `entry.label` 一致。**反向验证过**:删掉 `meta.title` 后 D6 变红。这个字段纯展示、没有运行时代码读它,漏写不会有别的检查报错。
|
|
37
|
+
- **插件图标入库**:`icon.png` 此前只在本机、没提交,`package.json` 也没有 `icon` 字段;现两样都有并进 `files`。
|
|
38
|
+
- **`main` / `exports["."]` 改指仓库根目录的 `index.js`。** 此前指向构建产物 `lib/index.js`——`lib/` 被 gitignore,只读源码树的扫描器拿到一个声明了却不存在的文件,读不到 `apply(ctx)`,`DSH_RUNTIME_APPLY_MISSING` 让收录扫描的 DeepSeek Harness Plugin 一项丢 5 分。现根目录是两行再导出(`export *` 加显式 `export { apply }`),`files` 同时装它与 `lib/`。**同一版本扫描器本地 77/100 → 85/100**,该项 15/20 → 20/20。
|
|
39
|
+
- **`verify-pack` 改按声明入口追问「是否被某条 `files` 条目自己覆盖」。** 此前只问「包里有没有」,而打包器总会无条件附带 `main` 指的文件,所以从 `files` 删掉 `index.js` 依旧全绿——这层兜底在 `main` 改名或换成严格读 `files` 的打包器时消失,入口静默消失的后果是「装上了、什么都没发生」。新增负向用例钉住。
|
|
40
|
+
- **侧栏入口与历史区适配 DSH 0.2.2(#35)**:新版本在侧栏列与 `sidebar.workspaces` 槽之间加了 `scrollRegion > scrollArea` 两层,插件仍按旧结构定位,导致入口不可见、点击被工作区行内动作抢走、历史区只占半截。`sidebarRoot()` 改为向上找「同时含全局 New Session 按钮」的最近祖先,`newSessionButton()` 排除工作区级行内动作,`markBlocks()` 只隐藏与 region 同级的 panel nav 而保留 history host;**手机端**点「会话 / 生图」后调宿主 `[data-sidebar-toggle]` 收起抽屉,不再被盖住。新增 smoke D3b。
|
|
41
|
+
- **修掉 rolldown 1.3 上的可复现性静默失效**:banner 从 `//#region <id>` 改成 `// <id>`,只匹配前者的正则一条都匹配不上,`node_modules` realpath 前缀进了产物,同源码在另一目录构建字节不同。旧正则只在 rolldown 1.1 上验证过,升级后是静默失效而非报错。现两种拼写都归一化,并限制前缀不含空白与冒号以免误伤普通注释。
|
|
42
|
+
- **没有版本变更的推送不再当成发布事件**:原闸门把「`package.json` 变了」当「要发布」,九条 dependabot PR 全会触发 Release 并因版本未升而让 `main` 变红。现提成独立 `preflight` job:tag 不存在→发;tag 指向本次提交→发;`replace_released_assets`→发并告警;**本次没改 `version`→跳过且不失败**;改了 `version` 撞上已发布号→失败(不许覆盖旧资产)。用 `github.event.before` 比对,merge / squash / 直推都适用。
|
|
43
|
+
- **新增 HOL 插件扫描器自检 workflow**(收录 PR 的建议项,缺它会在 registry trust score 扣 10%)。取官方模板,checkout 换成仓库统一 pin v7.0.1,权限仅 `contents: read` 且 checkout 不留凭据,action 固定 v1.2.806。它是 advisory:`min_score` 钉在收录门槛 75、`fail_on_severity: none`。
|
|
44
|
+
- **本版 `Publish to npm` 首次运行报红,是读取延迟不是发布失败**:`npm publish` 退出码 0,5 分钟轮询窗口内 registry 尚不可读(日志明确写了不是 auth failure),实际 3 分半后可见、`latest` 已指向 1.29.0,重跑后整条 run 转绿;npm 与 GitHub 资产 tgz 字节一致。
|
|
45
|
+
- 依赖升级:`tsdown` 0.23.7、`lightningcss` 1.33.0、`@types/node` 26.6.6、两个 `@deepseek-ai/dsh-client-*` 到 0.1.2-rc.1;actions checkout 7.0.1 / setup-node 7.1.0 / upload-artifact 7.0.2 / download-artifact 8.0.2 / pnpm-action-setup 6.1.1。
|
|
15
46
|
|
|
16
47
|
### 1.28.0 — 插件拆成 13 个可独立装卸的组件;画布整图导出/导入;Agent 读写画布结构
|
|
17
48
|
|
package/docs/releases/v1.29.0.md
CHANGED
|
@@ -1,27 +1,55 @@
|
|
|
1
|
-
# v1.29.0 — 插件改名「团团TV
|
|
1
|
+
# v1.29.0 — 插件改名「团团TV」;入口可被扫描器验证;侧栏适配 DSH 0.2.2
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
本版把插件在界面上显示的名字定为**「团团TV」**,同时修掉三件「装上但看起来没生效」的问题:插件清单声明的运行时入口在仓库里并不存在(第三方收录扫描器因此判它没有 `apply`)、侧栏入口与历史区在 DSH 0.2.2 上被新布局挤掉、以及没有版本变更的推送被当成发布事件让 `main` 变红。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
包名 `@q253595422/dsh-imagegen-video` 不变(npm 的包名不允许中文,也不该为了改显示名去动它),改的是用户看到的那一层。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## 显示名与品牌
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
- **插件详情页的标题此前是完整包名。** 原因不在包名写错了,而在标题来源:宿主读插件包 `locale/<语言>.json` 的 `meta.title`,**没有声明这个字段时回退到 manifest 的 `name`**。本仓库两个语言文件当时只声明了 `meta.description`,于是标题一路回退成完整包名。
|
|
10
|
+
- 现在 `locale/zh.json` 声明「团团TV」,`locale/en.json` 声明 `TuanTuan TV`,宿主按当前界面语言取对应值。
|
|
11
|
+
- **三语品牌文案统一**:`entry.label`(侧边栏入口)、`panel.title`(工作台面板标题,原为 `VisioWork`)、`settings.title`(设置卡标题)、`config.disabledTitle`(停用提示)在 zh / en / ru 里改成同一个名字。此前三处各写各的(`AI 生图`、`VisioWork`、`Image settings`),互不一致。
|
|
12
|
+
- **Agent 指导文案与 `/edit_image` 成功提示**同步改用新名;指导文案保留包名,以免模型对不上实际安装的模块。
|
|
13
|
+
- README 标题改为产品名,正文标注实际包名。
|
|
14
|
+
- **插件图标入库**:`icon.png` 此前只在本机、没有提交,`package.json` 也没有 `icon` 字段;现在两样都有,并进 `files`,详情页才拿得到图标。
|
|
15
|
+
- **刻意不改**:设置分区名「生图配置 / Image settings / Настройки генерации」。它是**位置名不是品牌名**——后端有 22 处错误提示写着「请打开设置 → 生图配置」,改它得成批同步那些提示与三条测试断言,而它本身不承担品牌职责。
|
|
10
16
|
|
|
11
|
-
##
|
|
17
|
+
## 包入口:声明的文件必须在仓库里,也必须真被 `files` 装走
|
|
12
18
|
|
|
13
|
-
|
|
14
|
-
- **界面内三语品牌文案统一**:`entry.label`(侧边栏入口)、`panel.title`(工作台面板标题,原为 `VisioWork`)、`settings.title`(设置卡标题)、`config.disabledTitle`(插件停用提示)在 zh / en / ru 三种语言里都换成同一个名字。
|
|
15
|
-
- **Agent 指导文案**:`IMAGEGEN_GUIDANCE` 里「本机已安装 dsh-imagegen 插件(DSH AI 生图)」改为「本机已安装团团TV(TuanTuan TV,包名 dsh-imagegen)」,保留包名是为了让模型仍能对上实际安装的模块。
|
|
16
|
-
- **`/edit_image` 成功提示**:由「可在 AI 生图面板查看结果」改为「可在团团TV 面板查看结果」。
|
|
17
|
-
- **README 标题**改为「团团TV(TuanTuan TV)」,正文标注实际包名。
|
|
19
|
+
两件相关的事,都是「清单说有、包里有」与「清单说有、磁盘上没有」的区别。
|
|
18
20
|
|
|
19
|
-
|
|
21
|
+
- **`main` / `exports["."]` 改指仓库根目录的 `index.js`。** 它们此前指向 `lib/index.js`,而 `lib/` 是构建产物、被 gitignore。只读源码树的地方——不先跑 `pnpm build` 的干净克隆、按清单检查入口的包扫描器——拿到的是一个声明了却不存在的文件:清单说有运行时入口,磁盘上没有,自然读不到 `apply(ctx)`。第三方收录扫描器正是这样判的,`DSH_RUNTIME_APPLY_MISSING` 让 DeepSeek Harness Plugin 一项丢 5 分。现在根目录 `index.js` 是两行再导出(`export *` 加一行显式 `export { apply }`),跟着仓库走;`files` 同时装 `index.js` 与 `lib/`,发布包里两半都在。**实测同一版本扫描器本地从 77/100 升到 85/100**,DeepSeek Harness Plugin 一项从 15/20 到 20/20,剩余 finding 只剩两条超 16 MB 的演示视频(不扣分)。
|
|
22
|
+
- **`verify-pack` 现在按声明入口逐个追问「这条入口是不是被某条 `files` 条目自己覆盖」。** 此前只问「包里有没有」,问不出来:npm 和 pnpm 总会把 `package.json`、README、LICENSE、`main` 指的文件无条件打进包,所以从 `files` 删掉 `"index.js"`,`verify-pack` 依旧全绿、103 entries、`index.js` 还在包里——靠的是打包器替 manifest 兜底。这层兜底在 `main` 改名、或换成严格读 `files` 的打包器时就消失,而入口静默消失的后果是「装上了、什么都没发生」。目录条目覆盖其下所有文件、文件条目覆盖自身、通配符按段顺序匹配;打包器无条件附带的几个文件按名字豁免。新增负向用例钉住它:从 `files` 删掉 `index.js`,check 必须以「entry points that `files` does not ship: main -> index.js」变红。
|
|
23
|
+
|
|
24
|
+
## 侧栏入口与历史区适配 DSH 0.2.2(#35)
|
|
25
|
+
|
|
26
|
+
DSH 0.2.2-rc.2 在侧栏列与 `sidebar.workspaces` 槽之间新增了 `scrollRegion > scrollArea` 两层结构,插件仍按旧结构定位,导致三处问题:侧栏入口不可见、点击被工作区行的行内动作抢走、历史区只占半截。
|
|
27
|
+
|
|
28
|
+
- `sidebarRoot()` 改为从 workspace 槽向上找「同时包含全局 New Session 按钮」的最近祖先;动作被隐藏时退化为与品牌锚点的最近共同祖先。
|
|
29
|
+
- `newSessionButton()` 排除 `[data-slot="sidebar.workspaces"]` 内的工作区级行内动作。
|
|
30
|
+
- `markBlocks()` 为嵌套容器补 `data-dsh-imagegen-sidebar-hide` 标记,只隐藏与 region 同级的 panel nav,保留 region 里的 history host。
|
|
31
|
+
- `panel.module.css` 新增嵌套分支的隐藏规则;生图态把 `[data-sidebar-scrollport]` 最后一行改为 `minmax(0, 1fr)`。
|
|
32
|
+
- **手机端抽屉遮挡**:窄屏检测到 `[data-sidebar-drawer="true"]` 打开时,点击「会话 / 生图」标签后调用宿主的 `[data-sidebar-toggle]` 收起抽屉,不再被抽屉盖住。
|
|
33
|
+
- `scripts/smoke.mjs` 新增 D3b 回归用例。
|
|
34
|
+
|
|
35
|
+
## 构建:可复现性在 rolldown 1.3 上曾静默失效
|
|
36
|
+
|
|
37
|
+
`tsdown` 升到 0.23.7 会解析到 rolldown 1.3,它把模块 banner 从 `//#region <id>` 改成了不带标记的 `// <id>`。`renderChunk` 里只匹配 `//#region` 的正则因此一条都匹配不上,`node_modules` 的 realpath 前缀原样进入产物——同一份源码在另一个目录构建出的字节不同,正是 `verify-reproducible.mjs` 抓到的「ROOT 8192f4ba / mirror b93c4594」那种不一致。**这条正则此前只在 1.1 上验证过,1.3 换格式后是静默失效而非报错**,所以升级依赖顺手把它修了。现在两种拼写都归一化;第二段正则把 `// ` 与 `node_modules/` 之间的前缀限制成不含空白与冒号的路径片段,避免误伤普通注释里出现的同一串路径(不加这个约束时实测会误伤)。
|
|
38
|
+
|
|
39
|
+
## 发布流程本身
|
|
40
|
+
|
|
41
|
+
- **没有版本变更的推送不再当成发布事件。** 原来的闸门把「`package.json` 变了」当成「要发布」,但依赖升级也改 `package.json`、action 升级也改 workflow 文件——九个 dependabot PR 全是这种情况。合并它们会触发 Release,版本仍是已发布的旧号、tag 指向旧提交,闸门必然报错,`main` 从此变红,而那次推送里根本没有新版本可发。现在「这次推送是不是发布」提成独立的 `preflight` job 用 `needs` 控制,判定顺序为:tag 不存在→发布;tag 正好指向本次提交→发布;`replace_released_assets=true`→发布并告警;**本次推送没改 `version` 字段→跳过且不失败**;改了 `version` 却撞上已发布号→失败(真错,不许覆盖旧资产)。第四条用 `github.event.before` 取推送前的版本比对,merge / squash / 直推都适用。
|
|
42
|
+
- **新增 HOL 插件扫描器自检 workflow。** 收录 PR 通过后扫描器建议把同一固定版本接进本仓库 CI(没有这条的条目会在 registry trust score 上扣 10%)。新文件取自官方模板,checkout 换成本仓库其他 workflow 的同一 pin(v7.0.1),权限只有 `contents: read`、checkout 不保留凭据,扫描器 action 固定到 v1.2.806(内部再固定 wheel 的 SHA-256 与 PyPI provenance)。它是 **advisory**:`min_score` 钉在收录门槛 75、`fail_on_severity: none`,真正的门禁在目录仓库那边。
|
|
43
|
+
- 依赖升级:`tsdown` 0.23.7、`lightningcss` 1.33.0、`@types/node` 26.6.6、`@deepseek-ai/dsh-client-connection` 与 `dsh-client-ui-renderer` 到 0.1.2-rc.1;actions 四处大版本(checkout 7.0.1、setup-node 7.1.0、upload-artifact 7.0.2、download-artifact 8.0.2、pnpm/action-setup 6.1.1)。
|
|
20
44
|
|
|
21
45
|
## 测试
|
|
22
46
|
|
|
23
|
-
新增 `smoke` 的 **D6
|
|
47
|
+
- 新增 `smoke` 的 **D6**:断言两语 `meta.title` 存在且非空、中文必须是「团团TV」、英文不得回退成包名、且与界面里的 `panel.title` / `entry.label` 一致。**反向验证过**:删掉 `meta.title` 后 D6 变红。这个字段纯展示、没有运行时代码读它,漏写不会有别的检查报错——只会在用户眼前悄悄变回一串包名。
|
|
48
|
+
- 新增 D3b(侧栏入口在 0.2.2 结构下可见、历史区高度正确)。
|
|
49
|
+
- `verify-pack` 的入口覆盖检查接入 `pnpm test` 与 `test:negative`,pack 组 6 条负向用例 6/6 变红。
|
|
50
|
+
- 本地:`typecheck`、`build`、`smoke`、`verify-tracked`、`verify-pack`(103 entries,含 `index.js`)、`verify-reproducible` 全绿;打出的 tgz 内两个语言文件已确认带上新的 `meta.title`。
|
|
24
51
|
|
|
25
|
-
|
|
52
|
+
**已在真实宿主验证**:
|
|
26
53
|
|
|
27
|
-
|
|
54
|
+
- 插件详情页的标题与图标。1.29.0 发布于 2026-11-12;2026-11-13 把这版 tgz 装进本机 DSH 桌面 profile 后,详情页标题显示「团团TV」、图标正常渲染,生图工作台顶栏与侧边栏入口同步改名;文生图/图生图/生视频三个模式标签、以及普通生图到带货图文这 8 个工作台标签都在位;宿主启动日志里没有一条与本插件相关的 warning(只有 `schedule` 的 StorageError 和 `rea-mcp` 重名这两条既有噪音)。
|
|
55
|
+
- 本版 Release 的 `Publish to npm` job 首次运行以 `failure` 结束,但那是**读取延迟不是发布失败**:`npm publish` 退出码为 0,随后 5 分钟的轮询窗口内 registry 尚未可读,日志里写明「published and npm exited 0… 不是 auth failure」。实际到 `17:02:09Z` 该版本已在 registry 可见(滞后 6 分 11 秒),`dist-tags.latest` 指向 `1.29.0`,重跑该 job 后整条 run 转绿。这次实测直接促成了随后的两处改动:轮询窗口从 5 分钟放宽到 10 分钟、`scripts/verify-pack.mjs` 的窗口地板从 240 秒抬到 600 秒(原先按 1.7.8 的 3 分 16 秒定的窗口必然会被下一次更长的滞后击穿)。这两处属于发布之后的基础设施修补,不在 1.29.0 的 tag 里。npm 与 GitHub 资产的两个 tgz **字节一致**(`sha256:b7825da09e94b7195659f41ae6acd28f1a974046dd6af1917882abb819fb18d0`)。
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# v1.30.0 — 模型能力改为内置基线表;修好聚合网关模型被误判为未知协议
|
|
2
|
+
|
|
3
|
+
本版做两件事:把「哪些模型 id 属于哪个协议族、它还该不该被推荐」从代码分支搬进**一张内置数据表**,并顺手修掉表一建立就暴露出来的一个线上误判——用聚合网关的用户,官方预设当时是被当成「未知协议」处理的。
|
|
4
|
+
|
|
5
|
+
## 为什么是内置表,而不是远程拉取
|
|
6
|
+
|
|
7
|
+
能力目录全部内置,插件**不为它发任何网络请求**。上游弃用一个模型时,发一个小版本更新基线表即可:用户不需要联网同步,也不会多出一个「目录接口挂了导致面板不可用」的故障面。
|
|
8
|
+
|
|
9
|
+
代价是表会滞后于上游,所以判定留了三层(见下),新出的 id 不会因为表里没写就被当成不认识。
|
|
10
|
+
|
|
11
|
+
## 结构
|
|
12
|
+
|
|
13
|
+
- **新增 `src/model-baseline.ts`。** 此前每加一个协议族都要在 `describeModel` 的 if 链上添一段、每出一个新模型 id 都要改代码,而这两件事与「请求怎么拼」本来无关。现在表里一行一个 id,弃用与请求逻辑分开评审、分开回溯。
|
|
14
|
+
- **`ModelFamily` 的联合类型定义搬到这个文件**,`model-catalog.ts` 改为再导出,避免出现两份会各自漂移的声明。
|
|
15
|
+
|
|
16
|
+
## 修掉的误判
|
|
17
|
+
|
|
18
|
+
聚合网关按 `vendor/model` 寻址(`google/gemini-3-pro-image`、`openai/gpt-image-2.5`)。旧实现拿原始串直接比对,于是**本仓库自带的 OpenRouter 预设落到 `unknown`**:
|
|
19
|
+
|
|
20
|
+
- 面板把它当成「只能带 1 张参考图」,一有第二张就警告会丢图;
|
|
21
|
+
- engine 退回通用 OpenAI 协议,该族真正的请求形态没被用上。
|
|
22
|
+
|
|
23
|
+
现在查表前剥掉一层厂商前缀。**只剥一层**:`a/b/c` 得到 `b/c`,`image-01` 这类本来没有前缀的 id 不受影响,`/gpt-image-2` 这种首字符就是分隔符的也不会被吃掉。把本仓库的默认模型列表与全部渠道预设过一遍,**unknown 从 1 条降到 0 条**。
|
|
24
|
+
|
|
25
|
+
## 三层判定,顺序是重点
|
|
26
|
+
|
|
27
|
+
1. **基线表精确命中**——唯一能报生命周期的层,因为它有可追溯的来源。
|
|
28
|
+
2. **命名约定归族**——表里没写、但族名对得上(`gpt-image-2.7-sunburst`、`seedream-6.0`)的 id 照常归族。上游出后缀比任何人维护表都快,这一层保证表不需要逐版追新。
|
|
29
|
+
3. **真的认不出才 `unknown`**,仍走尽力而为的通用请求,不拒绝。
|
|
30
|
+
|
|
31
|
+
## 生命周期提示:是提示,不是拦截
|
|
32
|
+
|
|
33
|
+
表里标了 `deprecated` / `removed` 的 id,会在模型选择器下方显示一行说明;有替代品时点名建议改用哪个。用主题里真实存在的 `state-warn` / `state-error` token(`--dsw-alias-state-warn-primary`、`--dsw-alias-state-error-primary`),三语齐备。
|
|
34
|
+
|
|
35
|
+
**请求照发、不改写、不禁用。** 用户可能挂在中转站上,那边仍在服务一个原厂已经下线的模型;把这个流程硬拦下来,等于弄坏一件本来能跑的事。这条边界在测试里单独钉了一条。
|
|
36
|
+
|
|
37
|
+
## 刻意不写自动关停日期
|
|
38
|
+
|
|
39
|
+
本轮本想连关停日期一起内置(`gpt-image-1`、`gpt-image-1.5`、`gemini-2.5-flash-image` 等),实际去核对时 **OpenAI 与 Google 的官方弃用页从构建环境三个入口都拿不到**:`developers.openai.com` 与 `platform.openai.com` 返回 403(`x-vercel-mitigated: deny`),`ai.google.dev` 连接超时;换普通搜索结果,返回的全是 SEO 站,没有一条能追到原始记录。
|
|
40
|
+
|
|
41
|
+
日期是整页里最容易变、又最无法在本机验证的一项。写错比不写更有害:要么劝退一个还能用的模型,要么承诺一个已经结束的支持。所以:
|
|
42
|
+
|
|
43
|
+
- `lifecycle` 只记录**已经发生**的状态,不记录「计划中的日期」;
|
|
44
|
+
- 每条非 `active` 记录都必须写明 `source`,测试强制检查,方便下一个人复核而不是照信;
|
|
45
|
+
- **目前表里没有任何一条被标为弃用**——没有可靠证据就不编。
|
|
46
|
+
|
|
47
|
+
机制就位、数据等证据,这是本版有意留下的状态。
|
|
48
|
+
|
|
49
|
+
## 测试
|
|
50
|
+
|
|
51
|
+
- 新增 `scripts/smoke-model-baseline.mjs`(22 条):厂商前缀剥离(含只剥一层、空段、大小写)、三层判定、基线表自身的一致性(无重复 id、全小写、非 active 必有 `source`)、生命周期到文案 key 的四种映射、以及「弃用不拦截请求」这条边界。
|
|
52
|
+
- 接入 `pnpm test`,并在 `test:negative` 里新增 `baseline` 组。
|
|
53
|
+
- **两条反向用例实证能变红**:把前缀剥离退回 `return id`、把默认生命周期改成 `deprecated`,各自让对应用例失败。跑出 `2/2 defects turn the check red`。
|
|
54
|
+
- `smoke` 另加一条真机(jsdom 渲染真实面板)断言:**活跃模型不得出现生命周期提示**。误报的代价是让用户习惯性忽略这一行,等它哪天说真话时已经没人看。
|
|
55
|
+
|
|
56
|
+
## 边界如实说明
|
|
57
|
+
|
|
58
|
+
- 表里的族判定与能力标注是照着现有协议实现填的,**没有对每个 id 逐一发起真实调用验证**。
|
|
59
|
+
- 生命周期提示的**正向分支目前没有真实数据可渲染**,只有纯函数层(`lifecycleNoticeKey`)测到;面板那条渲染分支在表里出现第一条弃用记录之前不会被执行。这是本版已知的未覆盖点,写在这里而不是留给人去发现。
|
|
60
|
+
- `video-model-catalog.ts` 是视频侧独立的一张表,本版**没有合并**它:视频族的能力维度(模式、分辨率、是否需要参考图)与图像侧不同,强行合成一张会让两边都长出用不到的字段。合并与否留到确实需要共享判定时再定。
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# v1.30.1 — 三个「已经实现但没有入口」的功能补上界面
|
|
2
|
+
|
|
3
|
+
本版不加新能力,只把此前写完却没人能点到的三处接到界面上,并补上它们一直缺的测试。三个功能各自的逻辑早就在仓库里,缺的是入口和「关掉之后真的失效」的证据。
|
|
4
|
+
|
|
5
|
+
## 1. 画布整图导出 / 导入
|
|
6
|
+
|
|
7
|
+
后端两条路由(`/canvas/bundle/export`、`/canvas/bundle/import`)和 `buildCanvasBundle` / `parseCanvasBundle` 早就写好了,但客户端**零引用**——整个功能从外面看不到。
|
|
8
|
+
|
|
9
|
+
现在画布顶栏、全屏按钮右侧两个入口:
|
|
10
|
+
|
|
11
|
+
- **导出**:把画布文档连同每个图片资产的字节打成一个 JSON 文件下载。片段(视频)是**引用而非拷贝**——一个包捎上整段视频会把体积推到不可用的量级。所以带片段的画布导出时一定会产生 `unresolved`,这不是失败:文档和全部静图都是完整的,提示只是告诉用户**换台机器后哪一部分打不开**,并且按 `kind` 分开计数——`asset` 是图片字节缺失,`video` 是片段没进包,两者对用户的意义不同。
|
|
12
|
+
- **导入**:**总是创建新画布**、分配新 id,绝不覆盖已有画布。导出者很可能就是导入者,让他能把自己的原画布冲掉不是「方便」是危险。
|
|
13
|
+
|
|
14
|
+
两处实现细节值得记下:
|
|
15
|
+
|
|
16
|
+
- 导出用 `Blob` + `createObjectURL`,并在 `finally` 里 `revokeObjectURL`。几百 MB 的 blob 留在文档生命周期里是实打实的内存泄漏。
|
|
17
|
+
- 导入**刻意不走 `seedDocument`**。那个函数会给节点为空的画布注入一对 text + config 起点节点——对新画布是对的,对导入是错的:导出一张空画布应当收回一张空画布,而不是被悄悄塞进两个用户没放过的节点。
|
|
18
|
+
- 导入后必须自己把新画布插进 `projects`。导入路由不返回项目列表,不插的话下拉里没有它,而 `document.id` 已指向它,`currentProject` 查不到会让收藏/删除按钮落在错误状态。
|
|
19
|
+
|
|
20
|
+
## 2. 工作流:续跑、强制重跑、层内并发
|
|
21
|
+
|
|
22
|
+
执行器三项能力全都有(`reuse`、`rerun`、`maxParallel`),但调用点把单节点那层的 `reuse` 写死成 `true`,另外两项根本没传。
|
|
23
|
+
|
|
24
|
+
现在底栏工作流按钮旁边多一个箭头,打开三个开关:
|
|
25
|
+
|
|
26
|
+
- **复用上次产物**(默认开)——关掉时全链重新提交,按节点数计费。
|
|
27
|
+
- **强制重跑选中节点**(默认关)——闭包由执行器自己算,界面只交出起点。
|
|
28
|
+
- **层内并发**(默认开)——关掉时传 `maxParallel: 1`。
|
|
29
|
+
|
|
30
|
+
三个默认值都等于升级前写死的行为,所以**直接点主按钮与旧版完全一致**。这是我没有采纳「把运行塞进菜单」的原因:那会让常用路径每次都多点一下,换来的只是「先看见复用是开着的」,而默认值本来就保证了这一点。
|
|
31
|
+
|
|
32
|
+
> **「复用」有两层,必须同时受控。** `runWorkflowPlan` 的 `reuse` 数组(节点级不提交、记 cached)与 `runWorkflowNode` 的 `reuse` 布尔闸门(`hasProduce` 时短路成 cached)是两回事。只关前一层的话,节点仍会在后一层被短路:用户看到开关关了,实际什么都没重跑。
|
|
33
|
+
|
|
34
|
+
## 3. 测试:补上「写错了也不会有任何测试变红」的那一层
|
|
35
|
+
|
|
36
|
+
这是本版真正花时间的地方。
|
|
37
|
+
|
|
38
|
+
执行器层原本覆盖得不错,缺的是**界面到底有没有把参数传下去**。这类故障不会让任何执行器测试变红——开关照常可点、执行器照常正确,只是值停在了半路。
|
|
39
|
+
|
|
40
|
+
新增两处:
|
|
41
|
+
|
|
42
|
+
- **`smoke-workflow.mjs`** 补执行器两个真实边界:`maxParallel=2` 时同时在飞的数量**恰好**是 2(此前只测了 1 和「不限」两个极端,而 2、3 才是用户真会填的值);`0`、`-3`、`1.5`、`NaN` 一律按 1 处理(漏掉归一会让限流宽度变成 0,一个节点都不派发,整条工作流静默挂住)。
|
|
43
|
+
- 同一文件新增接线断言:三个开关的默认值、两处 `reuse` 同受控、`maxParallel` 方向、重跑只交起点、`useCallback` 依赖数组含三个 state。
|
|
44
|
+
- **`smoke.mjs`** 在真实 jsdom 渲染的画布上断言两个按钮确实在顶栏、`accept` 正确、且没有被打上 `data-dock-item`(那个属性是底栏瓦片的标记,布局守卫会逐个量宽度)。
|
|
45
|
+
|
|
46
|
+
反向验证:把单节点闸门改回字面量 `true`、把归一拆掉、把导出按钮的文案改错,各自都让对应断言变红;还原后恢复绿色。
|
|
47
|
+
|
|
48
|
+
## 真机走查(1.30.1 部署到 uireview 后实测)
|
|
49
|
+
|
|
50
|
+
导出/导入不是只验到接线,做完了一次完整往返:
|
|
51
|
+
|
|
52
|
+
- 源画布 16 个节点、4 个图片节点、3 个真实资产(1.7MB + 1.8MB + 76KB)。导出 **538ms**、**4.78MB**,包结构 `format / version / exportedAt / title / document / assets / unresolved` 齐全,正确报出 1 条 `{kind:'video', reason:'clip-not-bundled'}`——画布里有 7 个视频节点,包只带了那 1 条没成片的引用。
|
|
53
|
+
- 导入 **99ms**,新 id、16 个节点、`unresolved` 原样透传,画布列表 +1。逐字段比对源与新画布:**`JSON.stringify` 完全相等**,3 个资产的 `assetId` 与字节数一字不差。
|
|
54
|
+
- 走界面按钮(`<input type=file>`)再跑一遍:文件选择器触发、解析、导入、新画布插入都正常,提示文案是「已导入为「未命名画布」 有 1 个片段引用了原机器上的视频,这里打不开。」
|
|
55
|
+
|
|
56
|
+
顺带确认了两件原本只是「应该如此」的事:
|
|
57
|
+
|
|
58
|
+
- **导入不覆盖**:源画布 id 与新画布 id 不同,导入后列表只增不减。
|
|
59
|
+
- **空资产不被伪造**:源画布那个 `assetId` 为空的图片节点(图片描述技能的产物),导入后仍是空,没有被塞进一个假资产。
|
|
60
|
+
|
|
61
|
+
工作流三个开关在真机上也逐个看过了:菜单三项齐全、默认值对(复用开 / 重跑关 / 并发开)、禁用态文案正确、长提示文案不被压扁。
|
|
62
|
+
|
|
63
|
+
## 边界如实说明
|
|
64
|
+
|
|
65
|
+
- 大画布导出期间界面只有按钮变灰,没有百分比。几百 MB 的极端体积没有实测过。
|
|
66
|
+
- 导入不做版本兼容转换:包的 `version` 高于当前插件时由 `parseCanvasBundle` 拒绝,没有「尽力读一下」的路径。
|
|
67
|
+
- 导入时若已有同名画布,两份会并列存在(导入总是新建),没有「重命名并覆盖」的选项。
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# v1.30.2 — 支持只收单一分辨率档位的视频模型(MiniMax-H3 / Nbility)
|
|
2
|
+
|
|
3
|
+
Nbility 网关上的 `MiniMax-H3` 只有一个可用档位:**768P**。720P 和 1080P 都会被上游 400 拒绝:
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
MiniMax-H3 supports only 768P at normalizeRequest
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
而插件此前把 `MiniMax-H3` 归进通用的 `openai-video` 族,只提供 `480P / 720P / 1080P` 三档、默认 720P——**每一个请求都注定失败**,且报错发生在提交之后,用户看到的是一次「提交被拒」而不是「这个模型不接受这档分辨率」。
|
|
10
|
+
|
|
11
|
+
本版修的就是这件事,同时把「分辨率档位散落在四处、各写一份」这个结构性原因一并消掉。
|
|
12
|
+
|
|
13
|
+
## 1. 档位类型加上 768P
|
|
14
|
+
|
|
15
|
+
`VideoResolution` 原本是 `'480P' | '720P' | '1080P'`。它不是营销话术的集合,而是**线上实际会发出去的字符串**,所以有模型只认 768P 时,类型就必须能说出 768P:
|
|
16
|
+
|
|
17
|
+
```ts
|
|
18
|
+
export type VideoResolution = '480P' | '720P' | '768P' | '1080P'
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
`RESOLUTION_RANK` 同步插入(`480P < 720P < 768P < 1080P`)。位置不是随手放的:`normalizeVideoResolution` 的降级语义是「取不超过请求档位的最高支持档」,768P 排在这里,1080P 的请求才会落到 768P(而不是掉到 720P),480P 的请求才会升到 768P,而 768P 本身原样保留。
|
|
22
|
+
|
|
23
|
+
## 2. MiniMax-H3 单独特化,但仍走通用族的线上格式
|
|
24
|
+
|
|
25
|
+
family **没有**新增。实测 `POST https://api.nbility.ai/v1/videos` 接受的就是通用形状,网关自己把 `size` 归一化成 resolution、`seconds` 归一化成 duration、`aspect_ratio` 归一化成 ratio,回读也是这三个字段。所以 `submitBody` 一个字都不用改。
|
|
26
|
+
|
|
27
|
+
窄化的是**能力**,写在 `describeVideoModel` 里、`isLikelyVideoModelId` 之前:
|
|
28
|
+
|
|
29
|
+
- `resolutions: ['768P']` — 唯一能成功的档位。
|
|
30
|
+
- `modes: ['text']` — 参考图只接受公网 HTTPS URL(`Reference media requires a public HTTPS URL; uploads and Base64 are not supported`),而本插件只会发 data URL。与其让图生视频在线上被拒,不如面板上就不提供这个模式。
|
|
31
|
+
- `aspectRatios` 六档 — 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 实测全部被接受。
|
|
32
|
+
|
|
33
|
+
时长沿用默认的 5 / 10 秒:上游真实范围是 1..15 的整数,两个档位都在内。同网关的 `doubao-seedance-2-0` 不受这个分支影响,仍走 seedance 族(实测它走的是**同一个** `/v1/videos`,但 768P 反而报 `unsupported Seedance resolution`——两个模型的能力刚好相反,这正是不能把它们合并成一个分支的原因)。
|
|
34
|
+
|
|
35
|
+
## 3. 四处内联的三档白名单收成一处
|
|
36
|
+
|
|
37
|
+
原来 `'480P' || '720P' || '1080P' ? … : '720P'` 这句话在四个地方各写一遍:
|
|
38
|
+
|
|
39
|
+
| 位置 | 改法 |
|
|
40
|
+
| --- | --- |
|
|
41
|
+
| `routes.ts` 的 `parseVideoRequest` | `parseVideoResolution(body.resolution)` |
|
|
42
|
+
| `routes.ts` 的 code-render probe | 同上(原先只认 480P/1080P,其余一律当 720P,会和面板显示不符) |
|
|
43
|
+
| `agent-video-tools.ts` 的工具入参 | 同上 + 参数说明改成「以所选模型接受的档位为准」 |
|
|
44
|
+
| `client/CanvasWorkspace.tsx` 的 fallback 列表 | `[...VIDEO_RESOLUTIONS]` |
|
|
45
|
+
|
|
46
|
+
新增 `parseVideoResolution(value, fallback = '720P')` 与 `resolutionRank()`,后者让 `video-director.ts` 里两份私有的 `['480P','720P','1080P']` 排序数组消失——规划器判断「只能降档不能升档」时用的就是目录里那份顺序,两处不会再各自漂移。
|
|
47
|
+
|
|
48
|
+
`VideoPanel.tsx:39` 那个 `RESOLUTIONS` 常量是死代码(全仓零引用),删除。
|
|
49
|
+
|
|
50
|
+
## 4. 分镜板的分辨率下拉框跟随模型
|
|
51
|
+
|
|
52
|
+
`storyboard-board.tsx` 原先硬编码三个 `<option>`,不看模型。现在从 `describeVideoModel(board.model)` 派生,模型未设置时给出全部档位。
|
|
53
|
+
|
|
54
|
+
一个取舍写在这里:**画布已有的、但模型不支持的档位不删掉,而是保留成一个选项**。用户打开一张旧画布时,把它文档里的值悄悄改写掉,比显示一个走不通的旧值更糟——前者不可见,后者看得见。
|
|
55
|
+
|
|
56
|
+
## 5. 本地渲染(code-render)给 768P 真实短边
|
|
57
|
+
|
|
58
|
+
`dimensionsFor` 原本 `480P → 480`、`1080P → 1080`、其余 → 720。768P 会落进 720 分支,probe 上报的像素数就和面板标签不一致。现在补上 768。
|
|
59
|
+
|
|
60
|
+
## 测试
|
|
61
|
+
|
|
62
|
+
`scripts/smoke-video.mjs` 新增 **V1l**,全部走离线假上游:
|
|
63
|
+
|
|
64
|
+
- 目录断言:`MiniMax-H3` 的 family 仍是 `openai-video`、`resolutions` 恰为 `['768P']`、`modes` 恰为 `['text']`、六档画幅;同时确认 `doubao-seedance-2-0` 仍归 seedance、通用模型 `kling-v2-master` 仍保留三档(特化没有外溢)。
|
|
65
|
+
- 归一化断言:1080P / 480P / 未知词都落到 768P,768P 原样保留。
|
|
66
|
+
- 解析与排序:`parseVideoResolution` 的大小写、空白、缺省与未知词行为;`resolutionRank('720P') < resolutionRank('768P') < resolutionRank('1080P')`。
|
|
67
|
+
- 端到端:发一个 1080P 请求,断言线上 body 是 `size: '768P'`(而非 `resolution`)、`seconds` 是字符串 `'5'`、`aspect_ratio` 正确、text 模式不带 `image`、轮询用网关返回的 `task_…` id。
|
|
68
|
+
|
|
69
|
+
38 项全绿(含此前 35 项):V1l 覆盖 768P 特化与端到端提交,V1m 覆盖 200 + HTML 的错误解释。
|
|
70
|
+
|
|
71
|
+
## 真机验证(Nbility 网关,api.nbility.ai)
|
|
72
|
+
|
|
73
|
+
- 提交 `MiniMax-H3` / 768P / 5 秒 / 16:9 → `queued`,轮询 `in_progress`(progress 0/33/99)→ `completed`,顶层 `url` 指向 COS 上的 mp4。5 秒片子约 3 分钟。
|
|
74
|
+
- 720P、1080P、以及 `size: "720P"` 的扁平写法,全部被上游 400 拒绝,报错原文记录在注释与测试里。
|
|
75
|
+
- 参考图 data URI 被拒;公网 HTTPS URL 可(本版因此不提供图片模式)。
|
|
76
|
+
|
|
77
|
+
## 6. 200 + HTML 不再被当成接口响应
|
|
78
|
+
|
|
79
|
+
真机部署时发现一个跟本次需求直接相关的坑:渠道里 `apiUrl` 写成 `https://api.nbility.ai`(少了 `/v1`)时,上游返回 **200** 和它自己的首页 HTML。插件原本把非 JSON 的响应体截 300 字符塞进错误消息,用户看到的是:
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
submit failed: <!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> …
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
现在识别出 HTML 就换成能指向原因的话:
|
|
86
|
+
|
|
87
|
+
> 返回的是网页而不是接口响应,通常是渠道的 API 地址少了路径(例如末尾缺 /v1)
|
|
88
|
+
|
|
89
|
+
这不是只为一个网关打的补丁:任何把站点根地址填进「API 地址」的渠道都会撞上同一件事,而「渠道地址少一段路径」恰恰是用户最难自己看出来的配置错误。新增 **V1m** 覆盖:假上游对提交回 200 + HTML,断言消息点名了原因、且不含任何 markup。
|
|
90
|
+
|
|
91
|
+
## 边界如实说明
|
|
92
|
+
|
|
93
|
+
- 768P 是**上游唯一可用的档位**,不是「推荐档位」。面板上它会是 MiniMax-H3 唯一可点的按钮。
|
|
94
|
+
- 参考图只支持公网 HTTPS URL,而插件没有上传通道(`/v1/files`、`/v1/uploads`、`/v1/assets` 均不存在),所以图生 / 首尾帧 / 参考生三种模式对 MiniMax-H3 完全不可用。要支持,得先有一条把本地图变成公网 URL 的链路,本版没做。
|
|
95
|
+
- 取消(`REMOTE_CANCEL`)仍是 unsupported:网关没有实测的取消端点,插件不伪造一个。
|
|
96
|
+
- `doubao-seedance-2-0` 在同一网关上走同一个 `/v1/videos`,但插件会按 seedance 族发 `content[]` 到 `/contents/generations/tasks`——该路径在此网关上一律 `Invalid URL`。也就是说**这个模型在这个网关下仍未接通**,本版没有修它(不在本次需求范围内,且需要单独验证 Seedance 在那个网关上的真实形状)。
|