alpha-gou/设定管理员

设定管理员

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

核心原则

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

{
  "力量体系": { "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 结构

{
  "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           # 聚合文件

---

🚨 异常处理

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