prop-extractor
✓Verified·Scanned 2/18/2026
从剧本中提取关键道具(武器、信物、法宝等),生成道具风格卡。当需要提取道具、建立道具库、生成道具描述时使用。
from clawhub.ai·vc7ef0f1·27.1 KB·0 installs
Scanned from 1.0.0 at c7ef0f1 · Transparency log ↗
$ vett add clawhub.ai/hexiaochun/prop-extractor
道具提取器
从剧本中提取关键道具,生成道具风格卡,确保道具跨镜头视觉一致。
核心原则
- 关键道具优先:只提取剧情相关的重要道具,忽略普通背景物品
- 归属明确:每个道具必须明确归属角色或场景
- PropKey 唯一:每个道具必须有唯一 Key,供镜头表引用
输入要求
必填
- 剧本正文:包含道具描写、使用场景
- STYLE_BASE:风格锚点
可选
- 角色卡列表:用于关联道具归属
- 道具参考图:用于锁定外形细节
道具分类
| 类型 | 说明 | 示例 |
|---|---|---|
| 武器 | 攻击/防御用具 | 剑、刀、弓、盾 |
| 信物 | 情感/身份象征 | 玉佩、戒指、信笺 |
| 法宝 | 特殊能力物品 | 仙丹、符咒、法器 |
| 容器 | 装载物品的器具 | 酒壶、药瓶、宝箱 |
| 日用 | 日常使用物品 | 书籍、乐器、工具 |
| 线索 | 推动剧情的物品 | 地图、密信、证据 |
提取流程
步骤 1:扫描剧本道具
识别剧本中出现的道具:
- 台词提及的物品
- 动作描述中的物品
- 镜头描述中的特写物品
- 系统奖励/获得的物品
步骤 2:筛选关键道具
保留符合以下条件的道具:
- 多次出现
- 推动剧情
- 角色标志性物品
- 有特写镜头
- 有情感意义
步骤 3:分析道具信息
对每个道具提取:
- 名称
- 类型
- 归属角色
- 外观描述
- 剧情意义
- 使用场景
步骤 4:生成道具风格卡
按标准格式输出。
输出格式
道具风格卡
## {道具名} (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- 都市-合同prop_cbpk_qiangnao- 赛博朋克-枪脑接口
道具类型模板
武器类
## 青锋剑 (PropKey: prop_jl_qingfengjian)
- **PropKey:**prop_jl_qingfengjian
- **道具名:**青锋剑
- **类型:**武器
- **归属角色:**@jl_chenfeng
### 外观描述
- 材质:寒铁锻造,剑身泛青光
- 颜色:青蓝色剑身,银白剑锋
- 尺寸:三尺三寸,标准长剑
- 装饰:剑柄缠白色丝带,剑穗飘逸
- 特效:出鞘时剑身隐有青光流转
### 剧情意义
- 陈风的本命兵器
- 师门传承信物
- 实力象征
### 使用场景
- 1-1 妖兽谷战斗
- 2-5 剑道比试
- 3-2 斩杀妖王
### 道具提示词
2.5D国风动画,青绿山水色调,细腻工笔材质,青锋剑,寒铁锻造,青蓝色剑身,银白剑锋,三尺三寸长剑,剑柄缠白色丝带,剑穗飘逸,剑身青光流转,白色背景,物品特写,居中构图,高清细节,无人物
信物类
## 鸳鸯玉佩 (PropKey: prop_jl_yuanyangpei)
- **PropKey:**prop_jl_yuanyangpei
- **道具名:**鸳鸯玉佩
- **类型:**信物
- **归属角色:**@jl_chenfeng / @jl_ningyu(一对)
### 外观描述
- 材质:羊脂白玉,温润细腻
- 颜色:乳白色,微泛暖光
- 尺寸:成人拇指大小,可握于掌心
- 装饰:雕刻鸳鸯图案,一雄一雌
- 特效:双玉靠近时微微发光
### 剧情意义
- 定情信物
- 身份凭证
- 情感羁绊象征
### 使用场景
- 1-8 定情赠玉
- 3-1 凭玉相认
- 5-5 生死诀别
### 道具提示词
2.5D国风动画,青绿山水色调,细腻工笔材质,鸳鸯玉佩,羊脂白玉,温润细腻,乳白色微泛暖光,拇指大小,雕刻鸳鸯图案,精致古朴,白色背景,物品特写,居中构图,高清细节,无人物
法宝类
## 聚气丹 (PropKey: prop_jl_juqidan)
- **PropKey:**prop_jl_juqidan
- **道具名:**聚气丹
- **类型:**法宝
- **归属角色:**无归属/消耗品
### 外观描述
- 材质:灵药炼制,表面光滑
- 颜色:琥珀色,半透明,内有流光
- 尺寸:龙眼大小,圆润饱满
- 装饰:无
- 特效:服用时化作光点融入体内
### 剧情意义
- 修炼资源
- 系统奖励常见物品
- 实力提升途径
### 使用场景
- 1-2 首次获得
- 2-1 批量服用
- 3-3 交易货币
### 道具提示词
2.5D国风动画,青绿山水色调,细腻工笔材质,聚气丹,灵药丹丸,琥珀色半透明,龙眼大小,圆润饱满,内有流光流转,白色背景,物品特写,居中构图,高清细节,无人物
线索类
## 藏宝图 (PropKey: prop_jl_cangbaotu)
- **PropKey:**prop_jl_cangbaotu
- **道具名:**藏宝图
- **类型:**线索
- **归属角色:**@jl_chenfeng
### 外观描述
- 材质:泛黄羊皮纸,边缘破损
- 颜色:暗黄底色,墨色图案
- 尺寸:展开约一尺见方
- 装饰:红色标记点,神秘符文
- 特效:特定条件下符文发光
### 剧情意义
- 主线剧情关键道具
- 引出新地图
- 宝藏位置线索
### 使用场景
- 1-5 意外获得
- 2-2 研究解读
- 4-1 找到宝藏
### 道具提示词
2.5D国风动画,青绿山水色调,细腻工笔材质,藏宝图,泛黄羊皮纸,边缘破损,暗黄底色,墨色山川图案,红色标记点,神秘符文,古朴沧桑,白色背景,物品特写,居中构图,高清细节,无人物
输出汇总格式
# 道具资产清单
## 项目信息
- 项目名:{项目名}
- STYLE_BASE_ID:{风格ID}
- 道具总数:{数量}
## 武器类
{武器道具卡1}
{武器道具卡2}
...
## 信物类
{信物道具卡1}
...
## 法宝类
{法宝道具卡1}
...
## 其他道具
{其他道具卡}
...
## 道具索引
| 道具名 | PropKey | 类型 | 归属角色 | 出现场次 |
|--------|---------|------|----------|----------|
| 青锋剑 | prop_jl_qingfengjian | 武器 | @jl_chenfeng | 1-1,2-5,3-2 |
| 鸳鸯玉佩 | prop_jl_yuanyangpei | 信物 | @jl_chenfeng | 1-8,3-1,5-5 |
| ... | ... | ... | ... | ... |
质量检查
生成后必须自检:
- 是否所有道具都有唯一 PropKey?
- 外观描述是否足够具体可视化?
- 归属角色是否使用正确的角色 ID?
- 剧情意义是否明确?
- 道具提示词是否可直接用于生图?
HTML 展示输出
必须输出
完成道具提取和图片生成后,必须生成 HTML 展示页面。
模板位置
assets/templates/gallery.html
输出文件命名
{项目名}_道具展示.html
保存到与资产清单相同的目录。
占位符替换
| 占位符 | 替换内容 | 示例 |
|---|---|---|
{{PROJECT_NAME}} | 项目名称 | 剑来 |
{{TOTAL_COUNT}} | 道具总数 | 10 |
{{STYLE_BASE}} | 风格基准名称 | 国风仙侠 |
{{GALLERY_SECTIONS}} | 分组HTML(见下方格式) | - |
{{PROP_DATA_JSON}} | 道具数据JSON对象 | - |
{{GENERATED_TIME}} | 生成时间 | 2026-02-02 |
分组 HTML 格式
<section class="gallery-section">
<div class="gallery-section-header">
<h2 class="gallery-section-title">信物类</h2>
<span class="gallery-section-count">3件</span>
</div>
<div class="gallery-grid">
<div class="gallery-card" onclick="openLightbox('prop_jl_jinhuangliyu')">
<div class="gallery-card-image">
<img src="{图片URL}" alt="金黄鲤鱼">
<span class="gallery-card-tag token">信物</span>
</div>
<div class="gallery-card-info">
<h3 class="gallery-card-name">金黄鲤鱼</h3>
<p class="gallery-card-id">prop_jl_jinhuangliyu</p>
<p class="gallery-card-owner">归属:@jl_jinyishaonian</p>
</div>
</div>
<!-- 更多道具卡片 -->
</div>
</section>
道具类型对应 CSS 类
| 类型 | CSS类 |
|---|---|
| 武器 | weapon |
| 信物 | token |
| 法宝 | magic |
| 日用 | daily |
| 线索 | clue |
道具数据 JSON 格式
{
"prop_jl_jinhuangliyu": {
"name": "金黄鲤鱼",
"id": "prop_jl_jinhuangliyu",
"type": "信物/线索",
"owner": "@jl_jinyishaonian",
"image": "{图片URL}",
"appearance": "通体金黄,鳞片闪亮如镀金,巴掌大小...",
"meaning": "引出锦衣少年与陈平安的交集,暗示身份不凡",
"scenes": "1-4【闪回】, 1-4"
},
// 更多道具...
}
生成后操作
- 保存 HTML 文件
- 使用
open {文件路径}命令在浏览器中打开展示
额外资源
- 道具描述规则:format-rules.md
- HTML模板:gallery.html