Skip to content
资产字段 AI 填写

资产字段 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 字段。