prop-extractor

# 道具提取器

从剧本中提取关键道具，生成道具风格卡，确保道具跨镜头视觉一致。

## 核心原则

- **关键道具优先**：只提取剧情相关的重要道具，忽略普通背景物品
- **归属明确**：每个道具必须明确归属角色或场景
- **PropKey 唯一**：每个道具必须有唯一 Key，供镜头表引用

## 输入要求

### 必填
- **剧本正文**：包含道具描写、使用场景
- **STYLE_BASE**：风格锚点

### 可选
- **角色卡列表**：用于关联道具归属
- **道具参考图**：用于锁定外形细节

## 道具分类

| 类型 | 说明 | 示例 |
|------|------|------|
| 武器 | 攻击/防御用具 | 剑、刀、弓、盾 |
| 信物 | 情感/身份象征 | 玉佩、戒指、信笺 |
| 法宝 | 特殊能力物品 | 仙丹、符咒、法器 |
| 容器 | 装载物品的器具 | 酒壶、药瓶、宝箱 |
| 日用 | 日常使用物品 | 书籍、乐器、工具 |
| 线索 | 推动剧情的物品 | 地图、密信、证据 |

## 提取流程

### 步骤 1：扫描剧本道具

识别剧本中出现的道具：
- 台词提及的物品
- 动作描述中的物品
- 镜头描述中的特写物品
- 系统奖励/获得的物品

### 步骤 2：筛选关键道具

保留符合以下条件的道具：
- 多次出现
- 推动剧情
- 角色标志性物品
- 有特写镜头
- 有情感意义

### 步骤 3：分析道具信息

对每个道具提取：
- 名称
- 类型
- 归属角色
- 外观描述
- 剧情意义
- 使用场景

### 步骤 4：生成道具风格卡

按标准格式输出。

## 输出格式

### 道具风格卡

```text
## {道具名} (PropKey: {prop_key})

- **PropKey：**prop_{项目}_{道具拼音}
- **道具名：**{道具名称}
- **类型：**{武器/信物/法宝/容器/日用/线索}
- **归属角色：**@{角色ID}（或"无归属/公共道具"）

### 外观描述
- 材质：{金属/玉石/木质/布料等}
- 颜色：{主色/配色/发光效果}
- 尺寸：{具体尺寸或相对大小}
- 装饰：{纹样/雕刻/镶嵌}
- 特效：{发光/飘动/雾气等}

### 剧情意义
- {意义1：如"身份象征"}
- {意义2：如"情感寄托"}
- {意义3：如"关键线索"}

### 使用场景
- {场景1：如"1-1 妖兽谷战斗"}
- {场景2：如"2-3 赠送信物"}

### 道具提示词（供图像生成）
{STYLE_BASE}，{道具完整描述}，白色背景，物品特写，居中构图，高清细节，无人物
```

## PropKey 命名规范

### 格式
```
prop_{项目缩写}_{道具拼音或英文}
```

### 示例
- `prop_jl_qingfengjian` - 剑来-青锋剑
- `prop_jl_yupei` - 剑来-玉佩
- `prop_dushi_hetong` - 都市-合同
- `...