部队家庭档案[支持1.2.x-1.4.x][原创]

v1.0.0 支持游戏本体 1.2.x - 1.3.x - 1.4.x 版本（战帆DLC可用）
作者：昭旭

◆MOD名称
部队家庭档案 [TroopFamilyArchives]

◆MOD介绍
已测试：1.4.7（战帆DLC可用）
其他1.2.x，1.3.x，1.4.x版本基本可用，欢迎玩家反馈兼容情况。
一个人测试的范围实在有限，有些情况没测试到可以反馈并说明情况，紧急情况可能紧急更新
问题反馈邮箱：mtanblamod@qq.com（描述问题+日志即可）
Mod依赖四前置，自带MCM设置菜单，所有选项均可游戏内调整。
档案随游戏存档一同保存：读档自动恢复，无需额外文件；可安全加载旧存档，旧档里的兵会从你载入之时起陆续建档补录。

◆近期更新内容
v1.1.0（当前版本）
- 修复：彻底解决「错误检测：发现某些可能是错误的数据」弹窗与读档后近卫消失——自定义兵种全部改为引擎加载期注册（XML 预定义），存档引用天然有效，不再被引擎当作损坏数据清理
- 修复：晋升贴身护卫部分bug修复
- 修复：第二次读档后部分兵种漂移成别的文化、档案与部队人数对不上——跨会话缓存残留清理
- 修复：战斗负伤的士兵被计为阵亡——现在阵亡只算真阵亡，伤员单独计入伤员
- 修复：士兵档案显示的阶级比实际高一阶——统一按游戏内实际阶位显示
- 修复：自定义高阶兵种建档年龄偏大——建档年龄封顶 35 岁
- 修复：读档后晋升的同伴换脸
- 优化：花名册「在役」筛选更精确

◆核心玩法
一、花名册：一人一档，追到底
打开方式：战役大地图按 Alt + F，或点大地图时间控件左侧的圆形档案按钮（可在MCM关闭，改回用热键）。
四个页签：
- 花名册：全军名录，一人一行
- 军务：本年度待你裁决的一应事务（详见下文「年度军务」）
- 部队家庭：所有随军户的户籍档案与家庭记事
- 家族部队：被调去你名下部队、商队、驻军的人
十三列全部可点击排序：姓名 / 性别 / 年龄 / 兵种 / 军功 / 状态 / 役龄 / 战次 / 出身 / 入伍地 / 隶属 / 文化 / 婚姻。
筛选：全部 / 在役 / 伤员 / 阵亡 / 被俘 / 失踪 / 征调 / 退役 / 逃散 / 遣散；另有「部队 / 驻军」查看范围切换，以及姓名搜索框与分页（每页可翻）。
士兵详情页：点开任意一人可见其个人条目（兵种阶位、归属、役龄、战次含受伤被俘次数、出身、入伍地、文化、婚姻），以及：
- 履历：逐年自动记述，何时入伍、何时升阶、何时负伤被俘、如何归队、最终如何离开
- 列传：按其姓名风格自动撰写的一篇小传（中式纪传 / 西式吟游 / 日式军记）
- 墓志铭：阵亡者可为其撰写碑文（此举只是留个念想，不是必做项）
- 导出此兵：把这一人誊写成一份独立的文书面页（见「纸面文书」）

二、状态：十种去处

状态	含义	怎么判定
在役	随主力出征	主力在册且实际在队
伤员	养伤中	战斗后被判定为受伤，留队休养
阵亡	战殁	入死亡名录，待发抚恤
被俘	陷在敌手	被俘名单内，可能有去有回
失踪	下落不明	战斗中被判定减员但未能确认结局者
征调	调往他处	进了你的驻军 / 商队 / 同伴部队，仍在上报
退役	归乡落籍	到龄携眷返乡，成为当地军户
逃散	脱队而去	留名录，可被追回
遣散	你主动解散	你亲手送走的，同样记账
晋升	擢为军官	脱离兵籍，档案封存，可在封存名录里查

三、出身：十一种来历
应征入伍 / 俘虏归降 / 族亲投军 / 军户子弟 / 军户后代 / 随军眷属 / 随军子女 / 归队 / 背景入伍 / 军户调兵·乡兵 / 军户调兵·家兵。
同一个村落招来的兵有概率同姓不同家，不是每次抽姓都从全表随机 —— 一个村子里本来就该有好几户同姓。

四、名字：中西日三套命名体系
全局命名风格可选中式 / 西式 / 日式，另有两种混风：
- 中西混合：帝国文化定居点走中式，其余走西式
- 中日混合：按文化对半分配，同一文化的定居点内绝不混用两种命名方式
名字池按性别、文化、阶层（平民贱名 / 平民常名 / 贵族名）分层抽取；中式支持常见复姓
自定义名字池：编辑 ModuleData/Names/tfa_names.json 即可增删姓名用字，改完重进游戏生效。

五、随军家属
- 接眷立户：役龄满三年的士兵可在年度军务里申请接眷；入伍时即已婚的新兵按MCM比例入伍即接眷。数量有上限 —— 随军户数不超过你部队编制的一定比例（默认25%），超出的先记为「已婚（未立户）」，年结再议。
- 不许近亲：同姓不婚，配偶姓氏必定不同。
- 生儿育女：立户后会生育，家里孩子在营中长大；年满十八授甲入伍，出身记为「军户后代」，父子两代同在一营。
- 家属参战三档（MCM切换）：
  - 非战：只做数据记录，永远不上战场
  - 后备：平时不入队留营，战事临头按判定临时顶上去，战后自动撤回随军家营 —— 死伤照实记录
  - 常备：立户即随队出征，会升级也会死（从其他档切过来时，营中家眷留营待召，何时随队由你决定）
- 婚姻变故：阵亡者留下的遗孀可能改嫁，营中有合适人选时由你裁定。
- 户籍档案里可查户号、立户年月、随军年数、父母名讳；家庭记事逐年记下这一户的生养嫁娶。

六、军务
每年岁首汇总，服役达标的会被列为候选人并弹窗告知，是否通过由你逐人定夺，不会自动落定。军务页里逐项处理：
- 可接眷名单：役龄够了，批准即立户
- 可晋升名单：见下节
- 退役安置：到龄者准其退役，发放安置银，携家口落籍为军户
- 婚约与改嫁：营中定亲、遗孀续弦，由你点头
- 待发抚恤：阵亡者的抚恤银，按日薪、役龄、军功折算
- 花名册校阅：一键核对在册与实数，自动补录错位档案（升阶的人会改录旧档，不新建空档）

七、晋升
门槛（二者得一，MCM可调）：役龄3年 + 参战10次 + 五阶以上，或 军功（击杀数）达20 —— 后者不看阶位，能打的卒子不必熬年头。
达标后在弹出窗口里先择去向：
- 晋升为军官 → 再选其一：
  - 赐姓入籍：赐予你家族的姓氏，从此是新入家族的人 —— 只改姓，不动本名，你照样认得出他是谁
  - 只擢同伴：不加姓氏，直接擢为同伴，另给一笔赏金
- 晋升为贴身护卫：按其兵种转任你的贴身护卫（步兵 / 弓手 / 骑兵 / 骑射手四种，八项战斗技能拉满）
  - 贴身护卫默认不占百科全书版面（MCM可开回来，改动即时生效不用重启）
- 同伴上限加成：晋升出来的同伴多了会顶到上限，可在MCM里追加配额（默认关闭 = 与原版一致）

八、退役与军户
- 士兵年满六十岁（MCM可调）在年度军务里退役，领一笔安置银，携家眷回到原籍或指定定居点落籍为军户。
- 军户子弟：退役满一年且子弟年满十六，城镇征兵时会优先从其名下征发子弟入营，继承父辈的户籍；累计服役满八年的老兵之家晋为「军功户」，其子弟走贵族线路入伍。
- 背景军户：新兵入伍时若未婚有父母、或已婚未接眷，其老家当天即立户 —— 这类军户按定居点规模生成，城镇 / 城堡 / 村庄都有。
- 军户调兵：在村庄 / 城堡 / 城镇菜单里点这一项，打开独立的调兵界面，查看本地练兵成果、待调清单与本镇军户名册，把乡兵、家兵调入你的队伍。

九、失踪追踪
失踪与逃散的人不会凭一句「下落不明」就算完。
- 被俘者先等三天，期满未归才转失踪并进入搜索；先搜索你脚下这片区域，此后每年统一查一次
- 被你遣散、或调去家族部队的人，只要查得到去向就不封档，离队超过一年仍无下落的才彻底记失踪

十、战后战报
每场战斗结束自动结算伤亡，弹出阵亡 / 伤员 / 被俘 / 失踪四页名单（MCM可关，关了也照样记账）。
同时对阵亡者登记抚恤，并把这批减员从待判定遣散里扣掉 —— 战场上没的人不会被记成你亲手解散的。

十一、纸面文书
- 导出此兵：花名册详情页一键把这一人誊写成一份独立的 HTML 文书，含条目表格、完整履历、列传、其所属家庭的户籍摘录。
- 版式三选一，也可设成「自动」按该兵本人所处的文化择版：中式宣纸 / 西式羊皮 / 日式和纸。
- 阵亡者导出恒为讣告版，不受主题设置影响。
- 文件生成在 Modules/TroopFamilyArchives/Exports/，文件名带兵名与时间戳，不覆盖既有导出；浏览器双击即开，可备份可转载。

十二、彩蛋
设置了一些彩蛋事件，多年后回士兵招募地也许会触发

◆注意事项
前置
本Mod需要四前置（Harmony、MCM 等）。战帆DLC（NavalDLC）可用。

兼容性
- 支持游戏本体 1.2.x，1.3.x，1.4.x；支持 战帆DLC
- 可安全加载旧存档：档案数据随存档走，旧档里已有的兵会从载入之后陆续补录建档
- 与《家族姓氏传承》（FamilyName）联用时会自动探测：赐姓按你本人姓名的风格拼接（西式带「·」、日式带空格、中式单字段），两边观感一致。
- 若与其他改动大地图界面 / ESC 行为的Mod冲突，可在MCM关掉地图圆钮，只用 Alt+F

安装方法
将 TroopFamilyArchives 文件夹放入 Modules/ 目录，在启动器中勾选 TroopFamilyArchives 即可。

日志文件
Mod运行日志位于：Modules/TroopFamilyArchives/logs/tfa_日期.log（按日切分）。
可在MCM把日志档位调到「调试」以获取详细信息；日常游玩建议留「基础」，不想落盘就选「无」。

导出文件
文书导出目录：Modules/TroopFamilyArchives/Exports/（自动生成）。删除已导出的文件不影响档案本身，记录仍在存档里。

自定义名字池
ModuleData/Names/tfa_names.json —— 可直接编辑的姓名用字文件（含男女名、单字名、复姓表等）。改坏了Mod会自动回退内置池，不会因此崩溃。

◆更新内容
v1.0.0（首次发布）
- 建档：花名册系统 —— 一人一档，十三列可排序，十种状态、十一种出身全程追踪
- 界面：四大页签（花名册 / 军务 / 部队家庭 / 家族部队），Alt+F 热键与大地图圆钮双入口
- 生平：自动履历（逐年记事的真实事件流）、自动列传（中西日三种笔法，可手写覆盖）、阵亡墓志铭
- 家属：随军户体系 —— 接眷立户、生儿育女、子女成年授甲入伍、遗孀改嫁、非战/后备/常备三档参战模式
- 晋升：年度军务 —— 老兵可擢为同伴、赐姓入籍或转任贴身护卫（自创兵种，按文化生成，甲马照抄精锐）
- 军户：退役安置与落籍、军户子弟承籍入伍、军功户走贵族线、定居点背景军户、菜单「军户调兵」
- 追踪：失踪与逃散的后台追踪暗线（真实处境记录，归队时讲述与经历一致）
- 战报：战后四页伤亡名单、阵亡抚恤登记、战役后校阅对账
- 文书：单兵 HTML 文书导出，宣纸 / 羊皮 / 和纸三套版式，阵亡者讣告版
- 其它：中西日三套命名体系与两种混风、可自定义名字池、完整的MCM设置（四组，全部即时生效）

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