家族姓氏传承[支持1.2.x-1.4.x，1.5x][原创]

v1.6.3.3支持游戏本体 1.2.x -1.3.x -1.4.x 版本（战帆DLC可用）
v1.5.0（适配1.5.x的测试版）：仅支持游戏本体 1.5.x（Steam Beta 测试分支），功能停留在 v1.6.2
作者：昭旭

◆MOD名称
家族姓氏传承 [FamilyName]

◆MOD介绍
1.1.0以后版本Mod依赖四前置，是一款为新生儿自动继承姓氏的功能型Mod。附带家庭关系标签、家族编年史（v1.6.0新增）等功能。
已测试：1.2.12（玩家反馈），1.3.15，1.4.7，1.4.8（战帆DLC可用）
其他1.2.x，1.3.x，1.4.x版本基本可用，欢迎玩家反馈兼容情况。
因为只会对刚出生的婴儿进行重命名，已存在的角色不受影响，因此可以安全加载旧存档。
本Mod自带MCM设置菜单，所有选项均可游戏内实时调整。
mod先稳定在1.6.0了，后续更新也是先修复bug，加入新功能不会像最近一样太频繁，避免造成使用上的不便。

◆近期更新内容
v1.6.3.3（当前版本）
- 修复：编年史完全不记录——判断是否已进入战役地图时，用了一个 本体里并不存在的类型名，导致整个编年史模块每帧都跳过初始化。现改用本体官方的地图状态接口判定，并加了自动兜底
- 新增：后宫板块内新增「区分妻妾」——多出来的同房伴侣标为「妾」，正妻仍为「妻」；只标与你有过共同子女的伴侣，没生过孩子的不标
v1.6.3.2
- 新增：复姓中式风格复姓识别，收录常见复姓，自动识别
  也可在 ModuleData/Names/复姓表.json 自行增删
- 优化：批量改名改为「只换姓氏、保留本名」——原名科林、父亲卡拉多格，
  改后为「科林·卡拉多格」；溯源到的最初祖先本人不改名
- 优化：批量改名改为 MCM 按钮「执行改名 / 执行还原」，点一次执行一次
v1.6.3.1
- 新增：新增了后宫玩法的关系标签，在MCM中选择是否有后宫即可开启对应状态的标签
- 修复：编年史界面无法滑动
- 修复：读档/回主菜单后停止记录
- 修复：取名顺序轮转（改为真随机+查重）

◆传承逻辑
检测全局新生儿并为其重命名，姓氏可取自父亲或母亲（MCM中设置）。

命名模式（玩家家族）
玩家家族的命名模式由MCM中的“命名风格”下拉菜单决定：

中式命名（选择“中式”）
- 从父亲/母亲名字中提取【最后一个字段的首字符】作为姓氏
- 从【中式名字池】中随机选取一个“名”
- 组合方式：姓氏 + 名（无分隔符）
- 示例："沃斯坦"→"沃伟" | "国王·沃斯坦"→"沃杰"

西式命名（选择“西式”）
- 从父亲/母亲名字中提取【最后一个字段】作为姓氏
- 从【西式名字池】中随机选取一个“名”
- 组合方式：名 · 姓氏（有分隔符）
- 示例："康纳·沃斯坦"→"威廉·沃斯坦"

日式命名（选择“日式”）
- 从父亲/母亲名字中按以下规则提取姓氏：
  - 字段数 = 0 → 从内置日式姓氏池中随机取一个姓氏
  - 字段数 > 0 → 取【第一段】作为姓氏
- 从【日式名字池】中随机选取一个“名”
- 组合方式：姓氏 + 空格 + 名（中间加空格）
- 示例："织田 信长"→"织田 健太" | "（织田）信长"→"信长 翔"

命名模式（NPC家族）
NPC家族的命名模式由MCM中的“命名风格”下拉菜单决定：

西式命名（默认）
- 姓氏取自父亲/母亲，按西式规则提取（最后一个字段）
- 名字取自对应文化的名字池（帝国/瓦兰迪亚/斯特吉亚/阿塞莱/库赛特/巴旦尼亚/诺德）
- 组合方式：名 · 姓氏

中式命名
- 姓氏取自父亲/母亲，按中式规则提取（最后一个字段的首字符）
- 名字取自【NPC共享中式名字池】（所有NPC文化共用）
- 组合方式：姓氏 + 名（无分隔符）

日式命名
- 姓氏取自父亲/母亲，按日式规则提取（第一段）
- 名字取自【NPC共享日式名字池】（所有NPC文化共用）
- 组合方式：姓氏 + 空格 + 名

孤儿继承
对于检测不到父亲或母亲的新生儿（如部分剧本Mod直接生成的幼儿），Mod会自动继承该孩子所属家族领袖的姓氏。
- 玩家家族孤儿：由MCM“玩家家族 → 孤儿跟随族长姓氏”控制（默认关闭）
- NPC家族孤儿：由MCM“NPC家族 → 孤儿跟随族长姓氏”控制（默认开启）

称号保留（v1.3.0新增）
玩家/NPC家族可独立控制是否保留父母名字中被成对符号（「」、『』、【】、( )、"" 等）包裹的内容作为称号。
- 开启后，称号将放置在最终名字最前面，保留原符号
- 头衔类称号（如国王、King）仍会被自动去除，不受此开关影响

关系标签（v1.4.0新增）
以家族现任族长为锚点，自动为成员推导亲属称谓并显示在名字上，玩家/NPC家族可独立开关，读档/开新档自动重建。
- 玩家家族默认〈〉括号、NPC家族默认[]括号，括号符号可在MCM自定义（两族允许相同）
- NPC家族除族长本人外标签统一带“族长”前缀（表示称谓以现任族长为锚点）；族长本人仍只标“族长”
- 活人标签直接写入名字；已死亡角色由Harmony在百科页面动态显示，不改写存档数据
- 玩家本人永不挂标签；开关标签时游戏内公屏提示（未进战局时静默处理）
标签展示
- 玩家：〈族长〉 〈父〉 〈母〉 〈妻〉 〈夫〉 〈长子〉 〈次子〉 〈三女〉 〈兄〉 〈孪生弟〉 〈姐〉 〈孙〉 〈孙女〉  …
- NPC：[族长]  [族长父]  [族长母]  [族长妻]  [族长夫]  [族长长子]  [族长次子]  …
- 排行：长 / 次 / 三…十按出生顺序排；孪生加“孪生”前缀（如〈孪生弟〉、[族长孪孙女]）

家族编年史（v1.6.0新增）
为玩家家族立传修史：自动记录家族兴衰、事业进退与沙场武勋，可在游戏内随时翻阅，也可导出为文白相间的编年史册。
一、游戏内翻阅：Alt + H
- 在大地图界面按 Alt + H 即可呼出「家族编年史」面板，再按 Alt+H 或 ESC 关闭
- 面板采用原生界面美化（金边卷轴风），条目按时间倒序排列，重大事件以金色突出
- 面板底部两个按钮：「排列」切换新/旧在前，「导出史册」生成局外史册文件（详见下节）
- 面板仅在战役大地图状态响应热键，菜单/战斗/对话中不会误触
二、记录保存与导出
- 编年史记录随游戏存档一同保存：读档自动恢复，无需额外文件，也不会因清理文件夹而丢失
- 在面板点「导出史册」，可在 Modules/FamilyName/Chronicles/ 目录生成一份卷轴风 HTML（文件名带导出时间戳，不覆盖既有导出），用浏览器打开即是一册可读、可备份、可转载的家族史
- 王朝续卷：玩家角色薨逝、继承人接位后，编年史以新族长视角继续书写，世代相承不辍
三、记录内容（三条史线）
- 家族线：开局立传、子女降生（含承父姓/承母姓等承姓信息）、成员婚娶、成员死亡（含死因）、玩家薨逝、继承人接位、族长传承
- 事业线：效忠/脱离王国、自立为王、封地得失（城镇/城堡/村庄，标注是否攻陷所得）、家族等级晋升
- 武勋线：沙场首胜、每五十胜、俘获敌方族长级领主（国王/族长）、大型战役（双方总兵力达阈值且玩家获胜，记录双方统帅、兵力与胜负）、玩家兵败（记录对手、双方兵力与败因）
- 更替：玩家角色死亡记“薨逝”，继承人接位后以新族长视角继续编年
四、三种文案风格（MCM随时切换）
- 中式笔法（默认）：编年体史官风，仿《春秋》《资治通鉴》，半文言简练典雅
- 西式笔法：中世纪编年史风，叙事性强，带封建/骑士色彩，以"主历X载"开头
- 日式笔法：军记物语风，仿《平家物语》，物语化叙事，佛教无常观，以"时值X"开头，死者加"如露消逝"
- 游戏内面板按当前风格即时渲染；已落笔的旧条目保留原文，新记录按新风格书写
五、MCM“编年史”设置组
- 编年史总开关（默认开）
- 家族线 / 事业线 / 武勋线 三条史线分开关
- 大型战役兵力阈值（默认 2200，双方总兵力达到即记）
- 文案风格下拉（中式笔法 / 西式笔法 / 日式笔法）
- 大事件公屏播报开关（默认开）

◆注意事项
前置
本Mod需要四前置。

兼容性
- v1.6.0：支持游戏本体 1.2.x，1.3.x，1.4.x 版本；支持 战帆DLC（NavalDLC）
- v1.4.1：仅声明兼容 1.5.x；1.5.x 目前为 Beta，且暂不含家族编年史功能，如遇异常请反馈
- 编年史不修改游戏原有角色/势力/封地数据，仅在存档中附加编年史记录；可安全加载旧存档（旧家族自载入之时起开始立传）

关于v1.4.1的测试说明
v1.4.1 是单独适配游戏 1.5.x 测试分支的版本，即使1.5.x调整相关API也不会直接崩溃，最坏情况仅标签写名失败并写入日志。功能集与 v1.4.0 相同（暂不含v1.6.0编年史）。

安装方法
将对应版本的 FamilyName 文件夹放入 Modules/ 目录，在启动器中勾选 FamilyName 即可。

日志文件
Mod运行日志位于：Modules/FamilyName/logs/FamilyNameMod.log
可通过MCM设置日志强度为"调试"获取详细信息。

编年史记录与导出
编年史记录随游戏存档保存，读档自动恢复；在面板点「导出史册」可在 Modules/FamilyName/Chronicles/ 目录生成卷轴风 HTML（浏览器打开阅读）。删除已导出的 HTML 不影响记录本身，记录仍在存档中。

自定义名字池
Mod支持自定义名字池，位于 ModuleData/Names/ 目录下：
- names.json —— 外置名字池文件（可自行编辑）
- 使用说明.txt —— 详细的自定义使用教程

◆命名规则速查表

父亲名字	中式姓氏核心	西式姓氏核心	日式姓氏核心	玩家·中式	玩家·西式	玩家·日式	NPC·西式
沃斯坦	沃	沃斯坦	沃斯坦	沃伟	威廉·沃斯坦	沃斯坦 健太	奥古斯都·沃斯坦
领主·沃斯坦	沃	沃斯坦	沃斯坦	沃杰	罗伯特·沃斯坦	沃斯坦 翔	提比略·沃斯坦
领主·戴·沃斯坦	沃	沃斯坦	戴	沃涛	亨利·沃斯坦	戴 大辅	奥古斯都·沃斯坦
领主·沃斯坦·戴	戴	戴	沃斯坦	戴明	威廉·戴	沃斯坦 直人	提比略·戴
国王·威廉	威	威廉	威廉	威华	理查·威廉	威廉 和也	奥古斯都·威廉
康纳·沃斯坦	沃	沃斯坦	康纳	沃强	威廉·沃斯坦	康纳 隆	提比略·沃斯坦
织田 信长	信	信长	织田	信浩	亨利·信长	织田 健太	提比略·信长
（织田）信长	信	信长	信长	（织田）信然	（织田）威廉·信长	（织田）信长 翔	（织田）奥古斯都·信长
【织田信长】	-	-	-	【织田信长】志	【织田信长】亨利	【织田信长】鷲見	【织田信长】奥古斯都
〔带关系标签〕
〈长子〉沃斯坦	沃	沃斯坦	沃斯坦	沃伟	威廉·沃斯坦	沃斯坦 健太	奥古斯都·沃斯坦
[族长]康纳·沃斯坦	沃	沃斯坦	康纳	沃强	威廉·沃斯坦	康纳 隆	提比略·沃斯坦
[族长长子]领主·戴·沃斯坦	沃	沃斯坦	戴	沃涛	亨利·沃斯坦	戴 大辅	奥古斯都·沃斯坦
〈妻〉（织田）信长	信	信长	信长	（织田）信然	（织田）威廉·信长	（织田）信长 翔	（织田）奥古斯都·信长

◆过往更新内容
v1.6.3
- 新增：MCM 新增「为家族既存成员继承名字」
- 新增：MCM 新增「为NPC家族溯源命名」
- 优化：以上两个开关都支持「取消勾选即还原」
- 优化：新开档「立传」改为等玩家自己取好家族名之后再落笔，不再把系统生成的默认家族名写进史册第一条
- 新增：家族更名记为一则史事——之后每次给家族改名都会新增一条记录（如「是岁，甲家易号曰乙，承先启后，家声不坠」），史册按时间留下家族的每一个名字，不再回头改写第一条
- 新增：家族领袖（玩家角色）改名同样记为一则史事
- 修复：中文输入法引号写的绰号无法识别、也无法移除
- 修复：操控女角色时，已结婚的丈夫被错标为「前夫」
v1.6.2
- 新增：外置名字扩容池 names.expand.json（男 11120 / 女 4943，合计 16063 条，只含「名」不含姓氏）
- 优化：names.json 明确定为玩家自留池，Mod 只读不写，升级不被覆盖；加载顺序改为「内置保底池 → names.json 覆盖 → names.expand.json 追加去重」
- 优化：名字文件容错，任一文件缺失或写错只跳过该文件，其余名字来源照常生效
- 新增：编年史导出三套版式——西式·羊皮长卷 / 中式·宣纸册页 / 日式·和纸军记，版式由「命名风格」自动决定
- 优化：移除「家族编年史 → 文案风格」设置项，文风与导出版式统一跟随「命名风格」，切换后立即重渲染，导出文件名带版式与时间戳
- 修复：日志强度设置长期失效（"无"和"基础"过滤都不生效，全量落盘是掉帧主因）；新增重复日志节流 + 8MB 轮转
- 修复：新生儿检测由每 10 帧全量遍历降为约 1 秒一次；主菜单不再逐帧写空日志
- 修复：与第三方头衔 Mod 共存时姓名被反复叠加；百科姓名每次打开都变长；改名失败仍被标记"已处理"
- 修复：新开档把系统默认家族名固化进史册第一条（改为等家族名弹窗落定后再立传）；切换命名风格后旧条目不刷新
- 优化：地图圆钮刷新降为每 30 帧一次；数据绑定只在状态变化时通知；控件查找失败后退避重试
v1.5.0测试版
- 新增：集成1.6.2的功能
v1.6.1.1
- 修复：修复加载存档会导致编年史重载的情况
v1.6.1
- 新增：战役地图家族编年史按钮
- 补充：补充部分数量较少的名字池
- 修复：修复偶现加载存档会导致重命名的情况
v1.4.2测试版
- 新增：集成1.6.1的功能
v1.6.0
- 新增：[家族编年史]系统——自动为玩家家族立传修史，三条史线全程记录
  - 家族线：开局立传、子女降生（含承姓信息）、婚娶、死亡（含死因）、玩家薨逝、继承人接位、族长传承
  - 事业线：效忠/脱离/自立为王、封地得失（城镇/城堡/村庄，含攻陷所得）、家族等级晋升
  - 武勋线：首胜、每五十胜、俘获族长级领主、大型战役（默认双方总兵力≥2200且玩家获胜，MCM可调）、玩家兵败（含对手、双方兵力与败因）
  - 王朝更替：玩家死亡记薨逝，继承人接位后续卷不辍
- 新增：游戏内 Alt+H 编年史面板
- 新增：编年史记录随游戏存档保存（读档自动恢复，无需额外文件）；面板「导出史册」可生成卷轴风 HTML 至 Modules/FamilyName/Chronicles/，文件名带时间戳、不覆盖既有导出
- 新增：三种文案风格——中式笔法（编年体史官风，默认）/ 西式笔法（中世纪编年史风）/ 日式笔法（军记物语风）
- 新增：MCM“编年史”设置组共7项
v1.4.1（适配1.5.x的测试版）
- 适配：单独面向游戏 1.5.x（Steam Beta 测试分支），前置依赖版本声明改为 v1.5.*
- 说明：功能集与 v1.4.0 相同；1.5.x 为Beta，本版未经正式环境实测，欢迎反馈
v1.4.0
- 新增：[家族关系标签]系统——以现任族长为锚点自动推导亲属称谓并显示在名字上
- 新增：MCM“关系标签”设置组共4项——启用玩家家族关系标签、启用NPC家族关系标签、玩家家族标签括号、NPC家族标签括号
- 优化：新生儿命名模型的正则全部静态预编译、反射成员缓存为只读字段，消除每帧反射开销
- 优化：移除每10帧无条件写日志的磁盘开销；标签词去重排序；减少家族成员重复枚举
- 优化：游戏初始化完成时清空已处理英雄缓存，避免开新档沿用旧档状态
v1.3.0
- 更新：新增[日式命名风格]，玩家/NPC家族均可独立选择
  - 新增：称号保留功能（玩家/NPC家族各自独立开关）
- 新增：NPC共享中式/日式名字池（所有NPC文化共用）
- 优化：完善外置名字池JSON结构，支持 player_japanese / npc_japanese 等新键名
- 优化：适配1.2.x，1.3.x，1.4.x版本
v1.2.0
- 优化：适配1.3.x版本
v1.1.1
- 新增：NPC家族设置中增加"孤儿跟随族长姓氏"选项（默认开启）
- 新增：孤儿继承场景专属公屏播报文案
- 修复：处理了生成的无父母新生儿未被命名的问题
- 优化：提高了对剧本Mod和极端存档情况的兼容性
v1.1.0
- 新增MCM设置菜单：游戏内直接调整所有Mod选项
- 优化命名规则：玩家家族由MCM开关直接控制中式/西式
v1.0.0
- 首次正式发布
- 支持玩家家族中式/西式两种命名方式
- 支持NPC家族西式命名
- 内置8个文化 + 中式 + 西式名字池
- 支持外置 names.json 自定义名字池
- 自动移除头衔
- 每小时自动检测新生儿

*总体评价	给总体评价评分
*点评	Smilies 登录