Initial TrueGrowth source import

openspec/changes/update-kling-capability-version-routing/proposal.md

@@ -0,0 +1,71 @@
+# Change: 调整 Kling 视频能力路由为“能力模型 + 执行版本”
+
+## Why
+
+当前 Kling 标准视频链路和 Suno 已经采用的“能力入口 / 执行版本”模式不一致：
+
+- 运行时发现更接近能力标识，例如 `kling_video`
+- 实际提交接口要求通过请求体 `model_name` 传入执行版本
+- Kling 标准视频仍需要按 action 建模版本合法性，即使当前 `text2video` 与 `image2video` 已共享同一组主版本
+- 当前实现仍主要把 `kling-v1-6` 这类版本字符串当作直接调用模型，导致发现层、路由层和执行层的语义混在一起
+
+这会带来几个具体问题：
+
+- 发现到 `kling_video` 时，运行时无法稳定映射到正确的执行版本
+- `text2video` 与 `image2video` 的版本约束只能散落在 adapter 条件分支中
+- 老的版本型模型 ID 与新的能力型模型 ID 并存时，默认路由和参数表单容易失真
+- `kling-video-o1`、`kling-video-o1-edit` 这类特例模型与标准 Kling 视频能力共用识别规则，后续扩展风险高
+
+## What Changes
+
+- 将标准 Kling 视频能力明确建模为能力模型 `kling_video`
+- 将真正执行版本明确建模为请求字段 `model_name`
+- 为标准 Kling 视频 binding 增加版本字段元数据，包括：
+  - `versionField`
+  - `defaultVersion`
+  - `versionOptions`
+  - `versionOptionsByAction`
+- 保留 `text2video / image2video` 的 action 分流，但把版本合法性和默认值绑定到 action
+- 保持对历史版本型模型 ID 的兼容，例如：
+  - `kling-v1-5`
+  - `kling-v1-6`
+- 显式将 `kling-video-o1` 与 `kling-video-o1-edit` 排除在标准 Kling 视频能力路由之外
+
+## Scope
+
+### In Scope
+
+- 标准 Kling 视频能力 `kling_video` 的路由与执行建模
+- `model_name` 版本参数的运行时解析与默认值策略
+- `text2video` 与 `image2video` 的版本约束建模
+- 旧版本型模型 ID 到新能力型路由的兼容策略
+- 最小必要的参数暴露，用于选择标准 Kling 执行版本
+
+### Out Of Scope
+
+- 本次不接入 `kling_effects`
+- 本次不接入 `kling_extend`
+- 本次不接入 `kling_lip_sync`
+- 本次不接入 `kling_virtual_try_on`
+- 本次不将 `kling-video-o1` 与 `kling-video-o1-edit` 迁入这套标准 Kling 视频能力模型
+- 本次不一次性为 Kling 全量高级字段设计完整可视化表单，例如复杂 `camera_control` 编辑器
+
+## Impact
+
+- Affected specs:
+  - `provider-protocol-routing`
+- Affected code:
+  - `packages/drawnix/src/services/provider-routing/*`
+  - `packages/drawnix/src/services/model-adapters/kling-adapter.ts`
+  - `packages/drawnix/src/services/model-adapters/registry.ts`
+  - `packages/drawnix/src/services/video-binding-utils.ts`
+  - `packages/drawnix/src/constants/model-config.ts`
+  - `packages/drawnix/src/constants/video-model-config.ts`
+  - `packages/drawnix/src/components/ttd-dialog/ai-video-generation.tsx`
+  - `packages/drawnix/src/components/ai-input-bar/*`
+
+## Relationship To Existing Changes
+
+- 本变更建立在 `add-provider-protocol-routing` 的协议绑定架构之上
+- 本变更复用 `add-audio-generation-suno-routing` 已采用的“能力标识不等于执行版本”设计原则
+- 本变更不改变标准 Kling 接口的 submit / poll URL，而是调整运行时如何解释能力模型与版本字段