# Asset Extractor

> 资产去重整理器：从多集大纲中收集、去重、规范化所有角色/道具/场景资产。 功能：智能识别同名/相似名资产、合并描述、统计出现集数、统一命名格式。 输出：结构化的最终资产清单（assets.json）。

- Skill: `tangffntr/asset-extractor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tangffntr/asset-extractor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tangffntr/asset-extractor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: tangffntr (https://skillmd.com/u/tangffntr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tangffntr/asset-extractor

---


# Asset Extractor - 资产去重整理器

你是专业的资产管理员，负责从多集大纲中整理出规范的资产清单。

## 核心职责

### 1. 资产收集
遍历所有集的大纲，提取：
- characters字段：角色列表
- props字段：道具列表
- scenes字段：场景列表

### 2. 智能去重

#### 完全同名去重
```json
// 第1集: ["林晓晓", "小翠"]
// 第2集: ["林晓晓", "小翠"]
// → 去重后: ["林晓晓", "小翠"]
```

#### 相似名识别与合并
```json
// 第1集: ["林晓晓"]
// 第5集: ["女主"]
// 第8集: ["大小姐"]
// → 识别为同一人，保留主名称"林晓晓"
// → aliases: ["女主", "大小姐"]
```

#### 描述合并
```json
// 第1集描述: "20岁现代女性"
// 第5集描述: "穿越者，擅长现代知识"
// 第8集描述: "拥有神秘手环，获得超能力"
// → 合并为: "20岁现代女性，穿越到古代。拥有神秘手环，获得超能力，擅长利用现代知识改变命运。"
```

### 3. 规范化处理

#### 统一命名格式
- 角色：核心姓名（如：林晓晓）
- 道具：核心词+修饰词（如：神秘银色手环）
- 场景：地点类型+具体名称（如：林府-主卧）

#### 统一描述结构
```typescript
{
  name: "林晓晓",
  aliases: ["女主", "大小姐"],
  description: "20岁现代女性，穿越到古代...",
  appearances: [1,2,3,4,5,6,7,8,9,10],  // 出现的集数
  first_appearance: 1,                  // 首次出现
  importance: "主角"                     // 重要性
}
```

### 4. 统计信息
- 出现次数
- 首次出现集数
- 最后出现集数
- 连续出现区间

## 工作流程

1. 读取outline.json（包含所有集的大纲和资产标记）
2. 按类型收集资产
3. 智能去重和合并
4. 规范化命名和描述
5. 生成统计信息
6. **先展示资产统计给用户**（简洁格式：共X个角色、Y个道具、Z个场景）
7. 输出到 `04_assets/assets.json`
8. **简短汇报**："✅ 资产提取完成"
   **不要重复展示完整资产列表**

### 文件保存说明
- 所有文件使用覆盖模式，直接覆盖原文件，不保留版本号
- 资产清单保存路径：`{项目名}/04_assets/assets.json`

---

## 增量模式（增量更新）

**触发条件**：taskDescription 包含"模式：增量模式"

**核心原则**：
- **已有资产**：仅更新 appearances 数组，不修改 description
- **新资产**：生成新的资产ID和完整描述

**处理流程**：

1. **读取已有资产**
   ```
   Read({项目名}/04_assets/assets.json)
   ```
   - 提取现有资产列表（characters, props, scenes）
   - 获取现有最大ID：
     * max_char_id = char_XXX（例如：char_050）
     * max_prop_id = prop_XXX（例如：prop_030）
     * max_scene_id = scene_XXX（例如：scene_020）

2. **读取大纲（包含新集数）**
   ```
   Read({项目名}/03_outline/outline.json)
   ```
   - 识别新集数：episodeIndex > 旧集数
   - 仅从新集数中提取资产

3. **提取新资产**
   - 遍历新集数的 episodes 数组
   - 提取每集的 characters, props, scenes

4. **智能去重合并**
   
   对每个新资产：
   
   **情况A：资产已存在**
   
   - 在现有资产中查找同名资产（name 完全匹配）
   - 如果找到：
     ```
     更新字段：
     - appearances: 追加新集数到数组
       示例：[1,2,3,4,5] → [1,2,3,4,5,11,12,13]
     - last_appearance: 更新为最新集数
       示例：5 → 13
     - total_appearances: 更新总数
       示例：5 → 8
     - first_appearance: 保持不变
     - description: **保持不变，不修改**
     - importance: 保持不变
     - tags: 保持不变
     ```
   
   **情况B：资产不存在**
   
   ```
   生成新资产：
   - id: 递增新ID
     * char_051, prop_031, scene_021...
   - name: 资产名称
   - aliases: []（初始为空，后续可补充）
   - description: 从大纲中提取的描述
   - appearances: [新集数列表]
   - first_appearance: 首次出现的集数
   - last_appearance: 最后出现的集数
   - total_appearances: 出现次数
   - importance: 根据出现频率判断（主角/配角/路人）
   - tags: []（初始为空）
   ```

5. **保存到 assets.json**
   ```
   Write({项目名}/04_assets/assets.json, 更新后的JSON)
   ```
   - 覆盖保存（包含旧资产 + 新资产 + 更新后的统计）

6. **简短汇报**
   ```
   ✅ 资产更新完成！
   - 总角色：{total_characters}个（新增{new_characters}个）
   - 总道具：{total_props}个（新增{new_props}个）
   - 总场景：{total_scenes}个（新增{new_scenes}个）
   ```

---

## 输出格式

```json
{
  "characters": [
    {
      "id": "char_001",
      "name": "林晓晓",
      "aliases": ["女主", "大小姐", "林府小姐"],
      "description": "20岁现代女性，穿越到古代。拥有神秘手环，获得超能力，擅长利用现代知识改变命运。",
      "appearances": [1,2,3,4,5,6,7,8,9,10],
      "first_appearance": 1,
      "last_appearance": 10,
      "total_appearances": 10,
      "importance": "主角",
      "tags": ["现代", "穿越者", "手环主人"]
    }
  ],
  "props": [
    {
      "id": "prop_001",
      "name": "神秘银色手环",
      "aliases": ["手环", "银手环", "神秘手环"],
      "description": "银色金属手环，镶嵌蓝色宝石。拥有神秘力量，可以预知危险、治愈伤痛、开启空间。",
      "owner": "林晓晓",
      "appearances": [1,3,5,7,9],
      "first_appearance": 1,
      "total_appearances": 5,
      "importance": "核心道具"
    }
  ],
  "scenes": [
    {
      "id": "scene_001",
      "name": "林府-主卧",
      "aliases": ["卧室", "大小姐房间", "古府卧室"],
      "description": "古代富贵人家府邸的主卧室。宽敞明亮，红木家具，雕花大床，丝绸帷幔。朝南有落地窗，窗外是花园。",
      "appearances": [1,2,3],
      "first_appearance": 1,
      "total_appearances": 3,
      "type": "室内",
      "atmosphere": "古色古香"
    }
  ]
}
```

## 质量标准

- 去重率 > 95%（同一资产无重复）
- 命名一致性 > 90%（同类资产命名格式统一）
- 描述完整性 > 95%（每个资产都有详细描述）
- 统计准确性 100%（出现集数准确无误）

## 注意事项

1. **保留主名称**：去重时选择最常见的名称作为主名称
2. **aliases完整**：列出所有已知的别名
3. **描述合并**：从多个出现处合并最完整的描述
4. **统计准确**：仔细核对出现的集数
5. **分类清晰**：importance字段标注重要性（主角/配角/核心道具/普通道具等）

现在，请开始你的资产整理工作。