智剧通（ZJT）文档中心 智剧通 - 资产管理（角色/场景/道具）
本文档抓取自官方文档中心（2026-10-10 快照），具体功能以实际产品为准。

资产管理（角色/场景/道具）

概述

资产管理模块用于管理短剧创作中的核心素材：角色、场景（地点）和道具。所有资产都归属于某个「世界」，支持在画布上创建节点或在分镜中关联使用。

资产类型

角色（Character）

字段说明
名称角色名称
年龄角色年龄
身份角色身份/职业
性格性格描述
行为习惯行为模式描述
其他信息补充描述
参考图角色参考图片
多套装扮不同装扮的参考图集
默认语音TTS 语音 ID

场景（Location）

字段说明
名称场景名称
父级场景所属上级场景（支持层级结构）
描述场景描述
参考图场景参考图片
多角度图不同角度的参考图集

道具（Props）

字段说明
名称道具名称
内容道具描述
其他信息补充描述
参考图道具参考图片

操作入口

侧边栏菜单

点击画布左侧的「添加素材」菜单，可以看到：

弹窗操作流程

  1. 选择世界：从下拉框选择目标世界
  2. 浏览资产：查看该世界下的所有资产卡片
  3. 搜索过滤：通过关键词搜索筛选资产
  4. 选择或创建：

创建资产

创建角色

填写以下信息：

创建场景

填写以下信息：

创建道具

填写以下信息：

资产节点

在画布上创建资产节点后，节点会显示：

节点用途

分镜关联

关联场景

在分镜编辑中，可以为每个分镜指定场景：

  1. 打开分镜组编辑弹窗
  2. 点击分镜的「场景」字段
  3. 从场景选择弹窗中选择
  4. 场景信息自动写入分镜数据

关联道具

在分镜编辑中，可以为分镜添加道具：

  1. 打开分镜组编辑弹窗或分镜详情
  2. 点击「添加道具」按钮
  3. 从道具选择弹窗中选择
  4. 道具信息添加到分镜的道具列表

关联角色

角色通过剧本解析自动关联：

编辑和删除

编辑资产

删除资产

数据结构

分镜中的资产引用

{
  db_location_id: 123,           // 场景 ID
  db_location_pic: "url",        // 场景参考图
  location_name: "客厅",         // 场景名称
  characters_present: "1,2,3",   // 出场角色 ID 列表
  props_present: [1, 2],         // 剧本解析的道具 ID
  props: [                       // 手动添加的道具
    { id: 1, name: "手机", reference_image: "url" }
  ]
}

API 接口

角色接口

方法路径说明
GET/api/characters获取角色列表
POST/api/characters创建角色
POST/api/characters/update更新角色
DELETE/api/characters/{id}删除角色

场景接口

方法路径说明
GET/api/locations获取场景列表
GET/api/locations/tree获取场景树结构
POST/api/locations创建场景
PUT/api/locations/{id}更新场景
DELETE/api/locations/{id}删除场景

道具接口

方法路径说明
GET/api/props获取道具列表
POST/api/props创建道具
PUT/api/props/{id}更新道具
DELETE/api/props/{id}删除道具

注意事项