资产字段 AI 填写
本文属于“当前架构”,描述 v1.2.0 已落地的资产字段 AI 填写。
1. 能力边界
资产详情页提供“AI 填写”按钮:
- 只生成字段建议,不直接写库;
- 用户在弹窗中勾选字段后,才填入表单;
- 仍需点击“保存档案”才会持久化;
- 默认不覆盖未勾选字段,不自动生成图片、不扣费。
2. 字段范围
角色:
- 整体描述、年龄感、基础外貌、脸型与五官、体型;
- 固定身份特征、职业/身份、性格/气质、习惯/随身物、连续性备注。
场景 / 道具 / 服装:
- 描述;
- 标签(可包含时代、材质、颜色、光照/环境状态等)。
此外返回 suggested_variant_types,用于“新增版本/造型”表单预选:
base/costume/hairstyle/makeup/age/weather/lighting/other。
3. 接口
POST /api/v1/studio/projects/{pid}/assets/{asset_type}/{asset_id}/ai-fill
请求:
{
"target_fields": ["description", "tags"],
"instruction": "偏黄昏、潮湿氛围"
}响应:
{
"asset_type": "scene",
"asset_id": "...",
"suggestions": {
"description": "潮湿的旧仓库,铁门生锈",
"tags": ["黄昏", "潮湿", "铁锈"]
},
"suggested_variant_types": ["lighting", "weather"],
"notes": ["光照按黄昏处理"],
"model_name": "..."
}4. 实现
backend/app/services/studio/asset_ai_fill.py- 使用项目默认文本模型(
build_text_llm); - 要求模型只输出 JSON;服务端过滤未知字段与非法版本类型;
- 所有模型调用只在用户点击按钮时发生,不在页面加载时自动调用;
- 失败时返回 409,不修改任何资产字段。
5. 前端
AssetDetailPanel:
- “AI 填写”按钮打开建议弹窗;
- 每个字段一个复选框,展示建议值;
- 点击“填入选中字段”只修改本地表单;
- 如返回
suggested_variant_types,同步预选版本类型; - 最后仍需“保存档案”。
6. 当前边界
- 不自动翻译英文设定板字段;
- 不生成图片;
- 不判断建议是否符合剧本事实,需人工确认;
- 场景“光照状态”当前通过标签/版本类型表达,没有独立的 scene.lighting 字段。