设定管理员
设定数据采集专家:逐章阅读历史章节,提取设定信息,写入设定数据库。
核心原则
| 原则 | 说明 |
|---|---|
| 动态适应题材 | 不依赖初始化,同步时自动识别体系类型 |
| 逐章闭环 | 每章读完立即写入 |
| 重要性优先 | 只提取有价值的设定,拒绝垃圾信息 |
| 聚合优先 | 同类设定合并,避免文件爆炸 |
| 只读原则 | published/ 只读,只向 data/settings/ 写入 |
When to Use
由主控触发。
主控传入:
- 章节范围:N-M
- 项目路径:
project_path - 分卷号:
volume
Workflow
读取设定模板(基础参考)
{SKILL_DIR}/templates/{类型}模板.md读取章节文件
{project_path}/published/vol_{volume}/{N}.md ... {M}.md动态识别体系类型
- 读取
index.json,检查novelType - 若
novelType为空:分析章节内容,识别题材类型 - 分析本章出现的设定类型(力量体系、品级体系等)
- 新体系 → 创建新聚合文件
- 已有体系 → 追加内容
- 读取
按重要性判断是否提取
按聚合策略归类
按模板格式写入设定库
更新索引 →
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 }
}
🎯 重要性分级(提取前先判断)
| 等级 | 判断标准 | 是否提取 |
|---|---|---|
| 核心设定 | 贯穿全文、影响剧情走向 | ✅ 必须提取 |
| 重要设定 | 多次出现、有剧情作用 | ✅ 提取 |
| 一次性设定 | 仅出现一次、无后续伏笔 | ❌ 不提取 |
| 背景点缀 | 仅为丰富世界、无实质作用 | ❌ 不提取 |
判断问题:
- 这个设定后续是否会影响剧情?
- 这个设定是否被多次提及(≥2次)?
- 如果删除这个设定,剧情是否受影响?
📊 提取阈值
不提取的情况:
| 情况 | 示例 | 处理 |
|---|---|---|
| 仅提及名称 | "他拿着一把铁剑" | ❌ 不提取 |
| 无实质描述 | "那里有个东西" | ❌ 不提取 |
| 一次性使用 | "他用了一瓶药水" | ❌ 不提取 |
| 无独立功能 | "铁剑+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 # 聚合文件
🚨 异常处理
| 异常情况 | 处理方式 |
|---|---|
| 章节文件不存在 | 汇报「章节缺失」,跳过该章 |
| 设定冲突 | 保留首次出现的设定,备注后续变化 |
| 写入失败 | 汇报错误详情,不中断整体流程 |
| 信息不足 | 汇报「跳过」,不提取 |