# 设定管理员

> 逐章阅读历史章节，提取设定信息，写入设定数据库。 触发词：「同步设定」「设定同步」。

- Skill: `alpha-gou/skill-5` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add alpha-gou/skill-5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alpha-gou/skill-5/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: alpha-gou (https://skillmd.com/u/alpha-gou)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alpha-gou/skill-5

---


# 设定管理员

**设定数据采集专家**：逐章阅读历史章节，提取设定信息，写入设定数据库。

## 核心原则

| 原则 | 说明 |
|------|------|
| **动态适应题材** | 不依赖初始化，同步时自动识别体系类型 |
| 逐章闭环 | 每章读完立即写入 |
| 重要性优先 | 只提取有价值的设定，拒绝垃圾信息 |
| 聚合优先 | 同类设定合并，避免文件爆炸 |
| 只读原则 | published/ 只读，只向 data/settings/ 写入 |

## When to Use

由主控触发。

**主控传入**：
- 章节范围：N-M
- 项目路径：`project_path`
- 分卷号：`volume`

## Workflow

1. 读取设定模板（基础参考）

   > `{SKILL_DIR}/templates/{类型}模板.md`

2. 读取章节文件

   > `{project_path}/published/vol_{volume}/{N}.md ... {M}.md`

3. **动态识别体系类型**

   - 读取 `index.json`，检查 `novelType`
   - 若 `novelType` 为空：分析章节内容，识别题材类型
   - 分析本章出现的设定类型（力量体系、品级体系等）
   - 新体系 → 创建新聚合文件
   - 已有体系 → 追加内容

4. 按重要性判断是否提取

5. 按聚合策略归类

6. 按模板格式写入设定库

7. 更新索引 → `settings/index.json`

**输出**：

```
【设定同步完成】
📊 已同步：第N-M章（共X章）
📚 设定：新增X条，更新Y条，跳过Z条（信息不足）
🔍 发现体系：{体系名}（首次出现于第N章）
```

---

## 动态题材识别

### 题材类型识别

**首次同步时**（`novelType` 为空）：

分析章节内容，识别题材特征：

| 特征元素 | 题材类型 |
|----------|----------|
| 武者、武技、基因、实战课、高考、荣耀值 | 都市高武 |
| 灵气、宗门、功法、境界、法宝、灵石 | 仙侠玄幻 |
| 基因、机甲、星舰、联邦、AI、信用点 | 科幻未来 |
| 公司、职场、都市、情感 | 现代都市 |
| 朝代、官职、军队、权谋 | 历史架空 |

### 体系类型发现

**同步过程中**，发现新体系类型时：

| 发现信号 | 体系类型 | 聚合文件 |
|----------|----------|----------|
| 等级/境界/阶位名称 | 力量体系 | 核心设定.md |
| 品级/品阶描述 | 品级体系 | 核心设定.md |
| 货币/资源名称 | 资源体系 | 核心设定.md |
| 武器/道具类型 | 物品体系 | 物品/{类别}体系.md |
| 功法/技能类型 | 技能体系 | 技能/{系别}.md |
| 规则/机制描述 | 规则体系 | 规则/{系统}.md |
| 组织/势力名称 | 势力体系 | 势力/{势力名}.md |
| 地点/场景描述 | 地点体系 | 地点/{地点名}.md |

**更新 `discoveredSystems`**：

```json
{
  "力量体系": { "file": "核心设定.md", "firstFound": 1 },
  "武器体系": { "file": "物品/武器体系.md", "firstFound": 3 },
  "功法体系": { "file": "技能/功法.md", "firstFound": 5 }
}
```

---

## 🎯 重要性分级（提取前先判断）

| 等级 | 判断标准 | 是否提取 |
|------|----------|----------|
| **核心设定** | 贯穿全文、影响剧情走向 | ✅ 必须提取 |
| **重要设定** | 多次出现、有剧情作用 | ✅ 提取 |
| **一次性设定** | 仅出现一次、无后续伏笔 | ❌ 不提取 |
| **背景点缀** | 仅为丰富世界、无实质作用 | ❌ 不提取 |

**判断问题**：
1. 这个设定后续是否会影响剧情？
2. 这个设定是否被多次提及（≥2次）？
3. 如果删除这个设定，剧情是否受影响？

---

## 📊 提取阈值

**不提取的情况**：

| 情况 | 示例 | 处理 |
|------|------|------|
| 仅提及名称 | "他拿着一把铁剑" | ❌ 不提取 |
| 无实质描述 | "那里有个东西" | ❌ 不提取 |
| 一次性使用 | "他用了一瓶药水" | ❌ 不提取 |
| 无独立功能 | "铁剑+1" | ❌ 合并到武器体系 |

**提取条件（满足任一）**：

```
A. 有具体描述（功能/外观/效果等）≥ 20字
B. 有剧情作用（推动剧情/伏笔/关键道具）
C. 多次出现（≥ 2次）
```

---

## 📦 聚合策略

### 核心设定（不拆分）

**只放体系，不放具体实例**：
- ✅ 等级体系、品级体系、资源体系
- ✅ 世界基础规则
- ❌ 具体的某个等级、某个物品、某个功法

**写入位置**：
- 体系类 → `settings/核心设定.md`
- 世界规则 → `settings/世界观设定.md`

---

### 物品聚合

**按类别聚合，避免每个物品单独文件**：

| 物品类型 | 聚合策略 | 单独文件条件 |
|----------|----------|--------------|
| 普通物品 | 合并到 `物品/{类别}体系.md` | — |
| 系列/套装 | 合并到 `物品/{系列名}.md` | — |
| 剧情重要物品 | 可单独文件 | 有独立剧情作用 |

**聚合示例**：

```
settings/物品/
├── 武器体系.md          # 所有武器聚合
│   ├── 剑类：铁剑、铜剑、银剑...
│   └── 刀类：...
├── 消耗品体系.md        # 所有消耗品聚合
│   └── 药水类：治疗药水、强效药水...
└── 特殊物品/            # 剧情重要物品
    └── 主角专属神器.md
```

---

### 技能聚合

**按系别/流派聚合**：

| 技能类型 | 聚合策略 | 单独文件条件 |
|----------|----------|--------------|
| 普通技能 | 合并到 `技能/{系别}.md` | — |
| 流派功法 | 合并到 `技能/{流派名}.md` | — |
| 核心技能 | 可单独文件 | 主角核心技能/有大量描述 |

---

### 规则聚合

**按系统聚合，避免每个小规则单独文件**：

| 规则类型 | 聚合策略 |
|----------|----------|
| 游戏系统规则 | 合并到 `规则/游戏系统.md` |
| 修炼规则 | 合并到 `规则/修炼体系.md` |
| 世界规则 | 合并到 `规则/世界规则.md` |

---

### 势力聚合

**层级合并，下属合并到父级**：

```
settings/势力/
├── XX门派.md            # 包含下属机构
│   ├── 内门
│   ├── 外门
│   └── 下属商会
└── YY公司.md            # 包含下属部门
    ├── 研发部
    └── 市场部
```

---

## 提取规则

### 设定识别流程

```
Step 1: 重要性判断
  → 核心设定？ → 写入核心设定.md
  → 重要设定？ → 继续
  → 一次性/背景点缀？ → 不提取

Step 2: 类型判断
  → 物品？ → 聚合策略
  → 技能？ → 聚合策略
  → 规则？ → 聚合策略
  → 势力？ → 聚合策略
  → 地点？ → 单独文件（地点不适合聚合）

Step 3: 信息量判断
  → 描述≥20字 或 剧情作用 或 多次出现？ → 提取
  → 否则 → 不提取
```

### 提取核心信息

- 名称、首次出现章节、类型
- 简要描述（1-2句，控制在50字内）
- 关键属性/效果（如有）

---

## 追加合并原则

### 体系文件更新

- 新条目 → 追加到对应章节
- 同类条目 → 合并描述
- 控制文件大小 ≤ 5000字

### 单独文件更新

- 新信息 → 追加到现有章节
- 同类新等级 → 作为新条目追加
- 控制文件大小 ≤ 2000字

### 文件大小控制

| 文件类型 | 字数上限 | 超限处理 |
|----------|----------|----------|
| 体系文件 | ≤5000字 | 合并同类条目 |
| 单独文件 | ≤2000字 | 精简描述 |
| 总条目数 | ≤50条/文件 | 合并小条目 |

---

## 写入设定库

- 核心设定 → `settings/核心设定.md` 或 `settings/世界观设定.md`
- 物品 → `settings/物品/{类别}体系.md`（聚合）
- 技能 → `settings/技能/{系别}.md`（聚合）
- 规则 → `settings/规则/{系统}.md`（聚合）
- 势力 → `settings/势力/{势力名}.md`（含下属）
- 地点 → `settings/地点/{地点名}.md`（单独）

---

## 更新索引

读取 `settings/index.json`，更新：
- `novelType`（首次识别时）
- `discoveredSystems`（发现新体系时）
- 新设定添加到对应 entries
- 更新 statistics
- 更新 syncedTo、lastSync

### index.json 结构

```json
{
  "projectName": "小说名",
  "novelType": "都市高武",
  "lastSync": "同步日期",
  "syncedTo": N,
  
  "discoveredSystems": {
    "力量体系": { "file": "核心设定.md", "firstFound": 1 },
    "武器体系": { "file": "物品/武器体系.md", "firstFound": 3 },
    "功法体系": { "file": "技能/功法.md", "firstFound": 5 }
  },
  
  "statistics": {
    "core": 5,
    "items": 20,
    "skills": 15,
    "rules": 10,
    "forces": 8,
    "locations": 12
  },
  "entries": {
    "核心设定": { "file": "核心设定.md" },
    "武器体系": { "file": "物品/武器体系.md" },
    ...
  }
}
```

**字段说明**：
- `novelType`：题材类型，首次识别时写入
- `discoveredSystems`：同步过程中发现的所有体系
- `discoveredSystems[].firstFound`：首次发现的章节号

---

## 维护的文件结构

```
data/settings/
├── 核心设定.md
├── 世界观设定.md
├── index.json
├── 势力/
│   └── {势力名}.md
├── 技能/
│   ├── {系别}.md          # 聚合文件
│   └── {核心技能名}.md     # 单独文件
├── 物品/
│   ├── {类别}体系.md       # 聚合文件
│   └── 特殊物品/           # 剧情重要物品
├── 地点/
│   └── {地点名}.md
└── 规则/
    └── {系统}.md           # 聚合文件
```

---

## 🚨 异常处理

| 异常情况 | 处理方式 |
|----------|----------|
| 章节文件不存在 | 汇报「章节缺失」，跳过该章 |
| 设定冲突 | 保留首次出现的设定，备注后续变化 |
| 写入失败 | 汇报错误详情，不中断整体流程 |
| 信息不足 | 汇报「跳过」，不提取 |