xAI 媒体发现补充逐型号参数契约
- Dominant language
- TypeScript
- Stars
- 2.7k
- Forks
- 395
- Avg merge
- 21h 48m
- Merged PRs (30d)
- 776
Description
## 问题
xAI 媒体模型发现目前依据类型化端点返回的 `input_modalities` / `output_modalities` 判断图片或视频能力:
- `apps/desktop/src/main/maker-host/model-discovery/xai-media.ts` 负责发现并投影型号。
- `apps/desktop/src/main/cindy-proxy-media/video/providers/xai.ts` 为发现到的视频型号提供统一的时长、分辨率、画幅和单图输入参数面。
类型字段可以证明输入输出类别,但不能单独证明未来型号继续接受完全相同的可选参数和值域。如果 xAI 后续新增参数契约不同的型号,客户端可能展示该型号,但在付费请求时被上游拒绝,或按不同语义执行。
## 为什么独立处理
当前媒体 Models API 快照未提供逐型号的时长、分辨率、画幅等完整参数元数据。补齐这层需要选择权威能力来源、定义逐型号能力结构,并让目录投影和执行 provider 共同消费;它不应作为单个下载生命周期修复顺手扩张。
## 用户影响
在 xAI 发布参数契约不同的新媒体型号后,用户可能看到一个类型匹配但部分选项无法兑现的型号,直到客户端补充对应能力声明。
## 验收标准
- 为 xAI 图片和视频型号取得可核验的逐型号参数契约,来源可以是官方能力字段、稳定的 provider manifest 或有界能力探测。
- 目录只公开当前客户端能够完整兑现的生成/编辑输入与参数组合。
- 视频 provider 按 alias 暴露真实的时长、分辨率、画幅、参考图等能力,并省略不支持的请求字段。
- 新型号参数面不同、能力信息缺失和能力热更新均有回归测试;任何不确定型号 fail closed,不发起付费请求。
Contributor guide
Research direction
Start with apps/desktop/src/main/maker-host/model-discovery/xai-media.ts and apps/desktop/src/main/cindy-proxy-media/video/providers/xai.ts to trace discovery and provider capability handling. Define a verifiable per-model contract, then add regression coverage for differing or missing capabilities and hot updates. Done means unsupported combinations are hidden or omitted and uncertain models fail closed without paid requests.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- ai, api
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100