这是一个使用纯 Python + PySide6 框架编写的单机桌面历史模拟小游戏（原基于 Vue + ElementWeb 版本重构而成）。
玩家可以通过设定初始朝代、皇帝与年号，开始一局波澜壮阔的王朝史诗模拟。在不断的年度步进中，游戏将模拟皇帝的执政生涯、后宫繁衍、爵位承袭、天灾人祸以及大势演变，直至国祚终结。
请确保已安装 Python 3.8+ 环境，并在项目根目录下执行以下命令安装依赖并运行：
pip install -r requirements.txt
python main.py项目整体结构采用模块化的 Mixin 混入设计，将主窗口界面绘制与不同的业务逻辑合理拆分：
| 路径 | 职责与核心类/混入 |
|---|---|
| main.py | 启动入口 |
| dynasty/app.py | 主窗口 UI 框架与界面刷新控制类 DynastyApp |
| dynasty/models.py | 人物数据模型 Person（管理寿命、爵位、状态与繁衍） |
| dynasty/state.py | 局内全局状态管理器 GameStateMixin |
| dynasty/resources.py | 汉字姓名、庙号、谥号、爵位等词库 ResourcesMixin |
| dynasty/styles.py | QSS 古风墨底金边主题样式类 StylesMixin |
| dynasty/fortune_chart.py | 国运曲线图绘制组件与弹窗 FortuneChartDialog |
| dynasty/lineage_chart.py | 人物详情中的男系世系关系拓扑图 LineageChartPanel |
| dynasty/mixins/naming.py | 姓名随机生成、年号改元、去重追踪逻辑 NamingMixin |
| dynasty/mixins/titles.py | 宗室爵位分封、降等袭爵与绝嗣管理 TitlesMixin |
| dynasty/mixins/family.py | 宗室繁衍、生老病死、孤儿过继机制 FamilyMixin |
| dynasty/mixins/succession.py | 皇位嫡长子继承、代位继承、兄终弟及、旁支过继算法 SuccessionMixin |
| dynasty/mixins/events.py | 历史大事件生成与动态反馈逻辑 EventsMixin |
| dynasty/mixins/emperor.py | 皇帝在位生命周期、余寿计算、庙谥评定与尊号生成 EmperorMixin |
| dynasty/mixins/dynasty_logic.py | 王朝建立、大势计算、国运起伏与崩盘判定 DynastyLogicMixin |
| dynasty/mixins/exam.py | 三年一科开科取士、恩科与科场案、进士候铨释褐 ExamMixin |
| dynasty/mixins/party.py | 朋党党争：立党招纳、交章倾轧、党狱清算、同年京察阉党 PartyMixin |
| dynasty/mixins/dimensions.py | 国势四维（民力/吏治/军备/财赋）漂移与事件条件化 DimensionsMixin |
| dynasty/mixins/finance.py | 国库度支：岁入岁出、宗禄军饷、亏空连锁与矿监税使 FinanceMixin |
| dynasty/mixins/rebellion.py | 流寇义军：蜂起、坐大、会剿、受抚与破京终局 RebellionMixin |
| dynasty/mixins/foreign.py | 外患：草原一统、入寇攻防、倭警与朝贡 ForeignMixin |
| dynasty/mixins/harem.py | 后妃外戚：册后纳妃、太后摄政、外戚之祸与新君清算 HaremMixin |
| dynasty/mixins/persistence.py | 存档读档（JSON 快照、引用保序）与倍速入口 PersistenceMixin |
详细说明文档请参阅： docs/modules/README.md
-
明制宗藩系统（世袭罔替）
- 亲王（如「秦王」）、郡王嫡长子袭爵世袭罔替，永不降等；余子降一等分封。
- 郡王以下依次为镇国将军、辅国将军、奉国将军、镇国中尉、辅国中尉、奉国中尉，至奉国中尉后世代不再降，全体成年宗室皆可繁衍。
- 封国无后时，触发绝嗣判定，支持收继侄嗣以延续香火；再无则除国。
-
完整皇位继承机制
- 严格遵循古典继承顺序：嫡长子继承 -> 嫡长孙代位 -> 诸子兄终弟及 -> 旁支宗室过继。
- 拥有完善的储君/世子代位继承和多代宗亲过继逻辑。
-
庙号与谥号系统
- 模拟历史评议机制，根据皇帝在位期间的整个国运轨迹（登基点、峰值点、谷值点、终局点）、在位年数和治国手腕进行功过综合评分。
- 盛世中兴得褒谥（如太宗、成祖），守成得中谥，昏庸亡国则获恶谥（如哀宗、炀帝），并匹配唐代风味的复杂谥号。
-
可视化国运图表与世系拓扑
- 支持逐年记录国运值并渲染折线图，直观标记历代帝王在位区间与改元时刻。
- 提供节点树状图以交互方式展示复杂宗亲家族树，双击人物即可追溯其三代世系。
-
科举取士系统（进士入仕）
- 三年一科开科取士，殿试产生三鼎甲与登科录；新君即位或开恩科，主上暗弱或发科场案。
- 新科进士进入候铨池，真实流入官员体系：二甲以上外授知府（系具体府名，如「兖州府知府」）、一甲擢翰林詹事，沿既有升迁链可至巡抚总督乃至拜相入阁。
- 「科举」Tab 翻阅历科金榜与登科录，追溯每位进士的仕途去向；朝臣详情可见科举出身（如「壬戌科状元」）。
-
明中叶地方官制（两京一十三省）
- 政区下至府一级、府皆专名：京师（北直隶）、南京（南直隶）与山东、山西、河南、陕西、四川、湖广、浙江、江西、福建、广东、广西、云南、贵州，共领 136 府。
- 两京直隶不设藩臬，京府（顺天府/应天府）置府尹；十三省各设布政使、按察使；蓟辽、宣大、三边、两广、川湖贵五总督例兼右副都御史。
- 巡抚、藩臬、府尹、知府共 182 席自动演化（考绩升迁、贬谪外放、贪墨善政民变），升迁链：知府 → 府尹/按察使 → 布政使 → 巡抚 → 总督。
-
朋党党争系统（党同伐异）
- 开国班底为潜邸旧人，科第渐盛后声气相求，浙党、齐党、东林之目渐起：无党官员趋附入党，党魁以朝堂势大者为之，势力按「官权 × 材具」累计。
- 党争自动演化：交章弹劾逐对方大员（劾罢）、优势党兴诏狱连削数籍、新君临朝清算前朝权党、帝察党盛罢魁裁抑——主明则党戢，主暗则党炽。
- 党争深化：科第同年与座主门生为结党之渊源（同科进士从同年、门生从座主）；京察六年一典——主明则计典澄清，主暗则优势党借察倾轧异己；权宦在位而主暗，或拥一党为奥援而成阉党，权宦败则其党俱散。
- 「朋党」Tab 翻阅各党概况（党风/党魁/人数/势力/立党之年，附阉者标注），点党名查看成员名录与党争始末。
-
国势四维与条件事件（V1.50）
- 国运之外另立民力 / 吏治 / 军备 / 财赋四维（各 0–100，六十中平）：灾荒伤民力、贪墨党争伤吏治、边警弛备伤军备、度支盈缩定财赋，四维再以小系数牵动国运，逐年快照入国运轨迹。
- 年度事件由均匀随机改为条件化加权抽取：盛世之庆须四维皆高，末世之象（人相食、流民聚啸、妖教惑众）须民力凋敝；
河患→流民、邪教→搜剿等事件连锁点燃。 - 「国祚」Tab 新增国势四维进度条与国库度支行，天下大势随最坏之维补注（「……，民力凋敝、武备废弛」）。
-
财赋系统（国库度支）
- 岁入随民力吏治浮动；岁出含官俸、军饷与按爵等计的宗室岁禄——宗口蕃衍则度支日蹙（明中叶宗禄之实）；边警剿饷为临时军费入账。
- 亏空连锁：连续亏空则额赋外加派（民力受损），库竭则边镇欠饷（军备受损）；存银充盈而民力不裕则发帑赈济。
- 矿监税使之祸：库竭而权宦用事，中使四出开矿征税——国库稍纾而民力吏治两伤，存银回盈或权宦失势则诏罢。
-
流寇义军系统（民变亡国）
- 民力凋敝则饥民揭竿：渠帅优先取自老于候选的落第进士（黄巢之目），或草泽枭雄；旗号「均田免赋」诸种。
- 兵势消长：民困则附者日众；官军会剿逐年攻防（军备四维与最优总兵定胜负，剿饷入当年度支），胜则斩获、败则丧师费饷；民力稍复而贼势已衰可受抚散众。
- 兵势养成大患而国运蹇促，竟有流贼破京之局——「以流贼亡国」的独立终局。
- 外患系统（草原·倭寇·朝贡）
- 草原诸部离散/雄桀一统循环：可汗名号随机生成，衰世则虏得并力；入寇三档结算——御之塞外 / 寻常钞掠 / 大举入犯（主暗或伴京师戒严）。
- 虏势滔天、边备尽弛而国运蹇促，竟有胡骑破关之局——「以边衅亡国」的独立终局；承平日久海防浸弛则倭警渐起，武备复修则平。
- 国势盛则诸蕃朝贡络绎（高丽/安南/琉球诸国 flavor）；「国祚」Tab 危局栏实时呈现北虏兵势与倭警。
- 后妃外戚与帝德（V1.50）
- 新君临朝册后纳妃（女名词库生成，姓氏避国姓），皇后之父例封承恩公；前朝皇后进为太后。
- 太后摄政：帝冲年践祚则垂帘听政；外戚之祸：主暗则后族浸盛、交通中官、威福自专；新君清算：簿录前朝外戚第宅奴婢放归田里。
- 帝德消长：治国手腕不再登基定终身——幼帝二十岁亲政按帝师（掌院学士/詹事）贤庸结算 ±；声色高位相寻则深居禁中怠政堕落（权宦易炽、吏治愈弛）。
- 存档读档与倍速（V1.50)
- 一键存档/读档：整局状态（人物世系、朝廷地方武备内臣、科举朋党、四维财赋流寇外患后妃、史册纪事）JSON 快照，引用保序、骰值不重掷，随时续玩；默认存
./saves/。 - 自动运行倍速（1×/2×/4×/8×）：按宗室规模自适应步进间隔，长局不再久候。
- 多样终局
- 王朝不止一种死法：国运衰竭（天命）、宗室绝嗣、流贼破京（民变）、胡骑破关（边衅）——亡国缘由入天下大势终笔。
- 官员志节与人物纪事（V1.60）
- 文官新增野心 / 清望两维（1–9，随转任转移）：权臣须才高（能力 ≥8）而志又在焉（野心 ≥7）；贪墨系于清望而非能力代偿；谥号并衡名节——文正等极品不与贪墨之人。
- 夺情：重臣丁忧而朝局倚之，诏夺情墨绖视事，言官交章论劾——张居正式戏剧内生涌现。
- 贪墨、善政、辅政、和亲、驸马诸纪事绑定具体人物（
subject/subject_role落库），史馆检索有据可查。
- 女性宗室与嫡庶承统（V1.60）
- 宗室男女皆育：帝女公主、亲王女郡主、郡王女县主（美名封号，如「长乐公主」），公主下嫁驸马都尉、郡主县主适仪宾。
- 帝系子女记生母，皇后所出为嫡——储君与兄终弟及皆循「嫡长 → 代位」，名实相副的嫡长子继承。
- 公主和亲：虏势方张而边备不修，朝议和亲（帝女亲者先），岁币输纳、边烽稍息；可汗亡则约绝。
- 宗室政治与宗禄困境（V1.60）
- 宗室不再是平行世界：主暗则贤王入朝辅政（国运吏治双补），庸王骄纵不法累三罚而废为庶人；封国挂靠政区（秦王之国于陕西），与两京十三省互文。
- 宗禄软约束：宗禄占岁入之比 ≥25% 生育减半、≥40% 仅帝与亲郡王可育——明中叶「宗禄几近度支之半」之局由是内生，不再全凭硬性人口上限。
- 国库联动：库竭加权流寇蜂起与加派民怨；欠饷既久、军备复弛则戍卒哗变。
- 状态权威表与批量模拟（V1.60）
- 全部可变状态收进一张权威表（
STATE_FIELD_DEFAULTS）：开局、亡国重开、读档缺省迁移三处共用，「三处同步」的人工清单不复存在。 - 存档升级 v2 且旧档自动迁移（缺字段补默认值，骰值不重掷）；冒烟测试新增「存→读→再存逐字段一致」硬校验。
tools/batch_sim.py批量模拟回归工具：--games N --seed S --csv，输出国祚分布、四种死法占比、宗禄占比峰值等——调参不再靠挂机目测。
- 风味化史笔（V1.70）
- 编年史骨架补全：帝崩（享年分壮盛/冲龄/寿考三体，缀庙谥）、新君即位（储承/皇子/兄终弟及/代位皇孙/旁支入继五体 + 建元取义 + 冲龄之注）、册立储君（初立/更立/皇太孙）、皇子诞生（嫡庶生母有据）/夭折、亲王就藩之国、王府袭封（过继书「嗣」）与除国——帝系终始不再缺页。
- 「史臣曰」：每帝盖棺一篇在位总评（由功绩评定标签组合成文），亡国另有整朝终论（享国年数/历帝世数/亡国缘由），入编年末笔。
- 灾异·祥瑞感应（
mixins/omen.py）：德政则凤凰见、嘉禾生、黄河清，失德则日食、彗星扫文昌、六月霜（借灾异讽时政，《五行志》玩法）——灾异牵动国运四维；谶谣民风先于祸而作（流寇坐大、国运垂尽、倭警、虏势滔天各有其谣）。 - 年度事件槽位化：事件文案钩住真实实体——
{名臣}/{尚书}/{巡抚}/{知府}/{亲王}/{党}/{渠帅}/{府}/{省}逐年解析为当朝人物与政区，编年史真正「活」起来；新增御史直谏、治河嘉奖、开中盐法、亲王来朝、献俘阙下等人物化事件。 - 文案变体池：拜相、首辅卒（暴卒/薨于位/恤典）、权臣、加衔特进、册后、权宦批红、东厂缉事、边镇殉国/失利/出塞、锦衣卫缉事、流寇蜂起/抚剿/破京、草原一统/入寇三档/破关、倭警消长、朝贡——高频纪事不再复读。
- 纪时干支：纪事时间统一「洪武三年·庚戌」（开局年甲子，与科份干支同法），主横幅加岁次。
- 裸数值雅化：天寿缀「圣躬康豫/时有违和/圣体不豫」，治国手腕折九品（上上～下下），春秋以汉字书之；国势四维加史官评语与趋势箭头（「62 · 平 → 小民各安其业」）。
- 年号释义：改元/建元附取义（「改元武平，取『武』武功、『平』治平之义」）；人物详情弹窗加一句考语（材略雄伟/清操绝俗/才高而行检不饬……按材具·志节·名节合观）。
- 二期增补：天下大势一句改词池化（国运档 × 帝王能力分支各 2–3 变体，怠政另缀「深居禁中」笔）；纪事表分类着色（灾异朱/丧仪灰/军功金/贺典青，主表与结束弹窗同款）；大凶灾异置「天变」旗标、次年改元祈福概率上浮；财赋/科举登科/地方（卒于任·乞骸骨·民变）/后妃（太后崩·垂帘·外戚）变体池补齐。
- 全部词池与成句助手集中
dynasty/flavor.py（词池 + 槽位解析 + 史笔函数），纯数据无状态。
- 功臣封爵（V1.80）
- 明制功臣三等世爵：国公/侯/伯以军功授之（开国大封、边功即封、岁考递晋、身后追封四途），爵号一朝不重、在世各有定员。
- 开国世袭、新封流爵：开朝大封功臣 12 员（公 3 侯 5 伯 4）赐铁券世袭罔替，主者身故则子袭爵——袭爵子弟入武册冠带闲住，遇都督/总兵缺起复就任；后世战功新封者为流爵，止其身。
- 削夺与恤典：罪废夺爵（罢/劾罢/削职/降/谪贬），赐死伏诛亦夺；无爵而卒军功茂者追封（战殁加厚）。
- 勋禄之累：公侯伯岁禄按等入度支（闲住亦承），世爵承袭则岁增，与宗禄并为国用之患；武备页增「勋臣世爵」表与花名册爵位列，详情弹窗见封爵沿革。
- 风味化二期：年记之外的风味（V1.90 三期·四期）
- 人物厚度（三期）：官员入仕掷性情（文/武/内三池，互斥不同取；圆滑易附党、耿直耻于朋比——轻挂钩党争）；声望极端者得绰号（权臣「刘棉花」、庸相「三旨相公」、救时宰相之目）；朝堂/地方/武备三表顶部形势行一句总述；度支史笔一行（岁入岁出帑藏五档之评）；终局名臣列传一传一句史臣按语；人物详情弹窗生平纪略（天下纪事按名检索 + 党争纪事按时序合并）；国运图灾异朱点/嘉祥金点标记。
- 皇帝性习（四期）：登基掷一至二条（工诗善书/精骑射/好神仙/喜营造/耽于逸乐/恭俭/好货/猜忌/仁柔/好学，互斥不同取），轻挂钩怠政阈值、矿监税使触发、岁出省费、亲政增益与「豹房」之目；宫中岁时另出性习之笔（建醮、校猎、御制颁赐、减膳撤乐……纯风味）；危局下求言诏（一帝一诏），大凶灾异之岁罪己诏（引诏书一语入编年，与改元祈福同源）。
- 妃嫔位号与宠衰（四期）：诸妃授位号（贵妃/淑妃/贤妃……，一朝不重号）、宠遇逐年消长；宠冠六宫者晋位，皇子生母母以子贵，另有妒争、失宠之笔；椒房面板四格扩五格（增妃嫔格，以宠为序）。
- 帝陵与实录（四期）：帝崩营陵赐名（长陵/献陵式，一朝不重名；山陵之费 20 万两入度支，亡国之君无所葬），历代帝王列表增陵寝列、点击行开实录弹窗——庙谥并释（「文」经纬天地之类谥法释义）、性习、年号沿革、国运始末峰谷、「史臣曰」原文与在位纪略。
- 文教与民生（四期）：每科殿试策问按当朝局势选题（边饷/河工/理财/吏治/朋党/礼乐——问什么，正见当朝什么最痛），登科录卷首展示；国祚页民生一行：京师米价四档 + 民谚（丰/平/苦/乱各有所谣）。
- 更多风味小件（四期）：权宦得「九千岁」「立皇帝」之目，名将得「铁面都督」、败将得「长腿将军」之讥，清官得「某青天」、贪吏得「某剥皮」；官员入仕授表字、致仕自号（某居士/某山人）；勋臣丹书铁券注免死之数（削爵则书「券虽在而法不可贷」）；大兴土木纪事营建有名（
{宫}槽位，耽于逸乐之主专属「豹房」）。
- 风味化三期：界面与仪式（V1.95，年记之外）
- 定鼎序幕：新开局一现「开基定鼎」——太祖出身掷定（布衣/将门/世吏/豪强，谓之「本朝故事」）、起兵之地、国号年号各缀取义、追尊立庙、群臣上尊号、大封功臣赐铁券，四段一页，朱印「定鼎」点题。
- 国史凡例（终局第四签）：亡国后新朝修《某书》——本纪 N 卷、志目因事开列（食货必书，河渠/五行/选举/兵/宗藩按一朝实况）、表目（宰辅年表/宗室世表/功臣世表）、列传 N 卷即名臣列传之数，总卷数成句（「凡四十九卷，藏之名山，垂示后昆」）。
- 交游一行：朝臣/地方官详情弹窗书同年（同科及第诸人）、座主/门生（知贡举之谊）、党籍、后族姻亲，政敌由党争纪事互见而得、缀一句史评式相讥——人物之间有了「人缘」。
- 考绩四等：朝堂/地方/武备/内臣四表与详情弹窗的政绩/军功/贤否裸数（「+18」）改卓异/称职/平常/下考四等史笔，裸数转入悬浮。
- 登科录金榜式：金榜横批黄绫底墨字，榜文表黄绫表头，一甲三行加粗衬金绫——「杏榜题名」之式。
- 舆图：国祚页「查看舆图」——两京一十三省示意方格图：流寇所在省插朱旗书渠帅、近岁灾异兵燹朱框、北疆虏警沙尘、沿海倭警沙晕，悬停一省观近年之事；边情总述一行在顶。
- 国势随色：主题随国运四档微移——隆平朱暖纸温、中平如常、衰世朱沉、危世朱黯如凝血而纸面泛灰（匾额描边同步），氛围随国祚沉浮。
- 开始页取义行：国号/年号另换即释一字之义（「国号取『明』重明照世之义 · 年号取『太』至大之义」）。
- 玩家决策层：题本批红式抉择（京察党案发落、义军剿抚、宗禄裁减、开海禁海）， 低勤政时批红旁落司礼监。
- 系统深化：藩王之乱（靖难/削藩）、公主和亲（联外患）、权臣篡位（禅让改朝）、 文教系统（修书/文字狱/书院讲学与立党联动）、四维历史曲线入国运图。
- 体验：自动存档滚存、史馆全局检索（人名/官职/纪事跨表查询）。
- V0.10：创建项目，使用前端技术栈搭建初步模型。
- V0.11：修复基础 Bug，在界面增加前任皇帝列表展示。
- V0.12：增加朝代、皇帝姓名、年号的随机抽取系统，并在游戏结束时完整展示皇帝列表。
- V0.13：初步实装谥号机制，对逝世皇帝进行简单的功过认定。
- V0.14：重构单体结构，优化代码逻辑。
- V0.15：优化图表展示，引入可视化折线图。
- V0.16：删除占用较多资源的动态 HP 逻辑，重新设计数值曲线。
- V0.17：添加事件系统框架并调整了皇帝寿命参数。
- 放弃了原有的 Vue + Element 架构，将项目使用 Python 与 PySide6 桌面 GUI 框架进行纯原生重写。
- 逻辑行为与前期积累的 V0.18 保持一致，保证性能和稳定性，并按功能细化分拆为模块包。
- 新增：添加自动运行模式（通过定时器 QTimer 步进运行），用户可一键开启或停止挂机。
- 新增：游戏结束弹窗中增加“王朝纪事”选项卡，完整展示本朝大事件历程。
- 优化：重构百家姓与名讳词库，支持生成单字名与双字名，使其更加贴合古代历史背景。
- 优化：全面汉化与雅化 UI 文案，如“寿命”改为“天寿”，“能力”改为“治国手腕”等。
- 优化：重构庙谥系统。根据皇帝一生治国评分动态分发谥法与庙号，杜绝不合理的恶谥发生。
- 优化：实装防重复机制。通过局内历史跟踪，保证同朝之内的皇帝名、年号、庙谥绝对不会出现重复。
- 优化：大幅扩充大事件库，加入黄河决堤、藩镇割据、科举开科等极具代入感的历史事件。
- 新增：引入
Person人物实体，开始全面模拟庞大的皇室宗亲子嗣。 - 新增：实现包含嫡长子继承、代位继承、兄终弟及、旁系过继在内的完整皇位继承算法。
- 新增：主界面加入「皇室宗亲」Tab 页，展示父系完整的层级世系。
- 新增：双击宗亲列表可弹出可视化世系树（QTreeWidget 嵌套节点），直观掌握皇族繁衍。
- 新增：实装唐代九等爵承袭规则（如亲王称「某王」，嫡长子袭爵，其余降等分封）。
- 新增：新增「宗藩」UI 选项卡，展示本局游戏内的所有受封封国、各封国国主承袭脉络。
- 优化：提升了非皇帝宗室成员的生育繁衍能力，加入了因绝嗣导致的降等袭爵与过继算法。
- 优化：重构后宫命名和称号分配算法，增强历史厚重感。
- 优化：将原单体
main.py的臃肿代码正式剥离拆入dynasty/目录下，并建立mixins/逻辑混入层。
- 新增：重做图表系统，引入
FortuneChartDialog（国运折线图），在“王朝信息”页中支持点击“查看国运图”展示历代皇帝在位折线，并标注重要改元节点（▲）。 - 新增：在人物详情中添加
LineageChartPanel组件，利用 QPainter 动态绘制选中人物中心五代的男系亲属拓扑树（支持双击卡片连环跳转）。 - 优化：优化 QSS 皮肤，统一采用沉稳的墨底金边视觉风格，提高文字对比度。
- 优化：采用真实的古代皇帝寿命概率分布模型，重塑寿命与继位余寿的掷取逻辑，解决幼帝高天寿或老帝瞬崩等不真实数值。
- 优化：全局锁定数据展示文本与表格。
- 优化：开始游戏界面中的“朝代”、“皇帝”、“年号”文本框设为只读，字辈选择下拉框改为不可编辑，只能通过专属“刷新”按钮随机摇取，防止游戏开始前的数据手误篡改。
- 优化：将主界面的历代帝王表、天下纪事表，以及游戏结束弹出对话框中的所有数据表格，均设置为禁用编辑触发器（
NoEditTriggers），彻底杜绝了用户双击单元格后文字被手误修改的问题。
- 新增：游戏结束弹窗改为双按钮——重新开始（重置回开始页）、翻阅国史（或点 X 关闭，留在主界面查阅本局史料）。
- 新增：翻阅国史模式——关闭结束弹窗后，主界面下方「自动运行」换为「重新开始」，可继续翻阅本局数据，再随时重开新局。
- 优化：庙号、谥号与命名生成逻辑，强化谥号选取标准与历史质感。
- 重做：袭爵制度由唐制九等爵改为明制宗藩八等——亲王、郡王、镇国将军、辅国将军、奉国将军、镇国中尉、辅国中尉、奉国中尉。
- 新增：世袭罔替——亲王/郡王嫡长子（含代位、过继）袭同封同爵，永不降等；余子降一等；将军中尉诸子皆降一等，至奉国中尉世代不降。
- 新增：全体成年宗室可育——生育率按爵位递减（亲王 > 郡王 > 将军 > 中尉），配合软/硬人口上限与裁剪阈值控制宗室规模。
- 优化：谥号规格随爵而异——亲王一字谥（秦愍王）、郡王双字谥（永兴恭定王）、将军中尉无谥；亲王嫡长称「王世子」、郡王嫡长称「王长子」。
- 优化：将军中尉无封号，「国别」栏自动归入所属王府支系。
- 新增：国势四维系统——民力/吏治/军备/财赋各归其位，四维牵动国运并以门槛解锁条件事件（盛世之庆/末世之象）与事件连锁（河患→流民、邪教→搜剿）；抽取由均匀随机改为条件化加权。
- 新增：财赋系统——岁入岁出、按爵等计的宗室岁禄、亏空连锁（加派/欠饷）、发粟赈济与矿监税使之祸；国库存银折算财赋维。
- 新增：流寇义军系统——民力凋敝则饥民揭竿（渠帅或为落第老儒），会剿攻防、受抚散众，兵势滔天而国运蹇促则流贼破京。
- 新增：外患系统——草原诸部离散/雄桀一统循环、入寇三档结算、倭警消长、诸蕃朝贡；虏势滔天边备尽弛则胡骑破关。
- 新增：多样终局——天命/绝嗣/民变/边衅四种亡国缘由，入天下大势终笔。
- 新增：后妃外戚系统——册后纳妃、太后摄政、外戚推恩与外戚之祸、新君清算；帝系本纪表增「皇后」行。
- 新增：帝德消长——幼帝教育（帝师贤庸定亲政手腕 ±）与怠政堕落（声色高位→深居禁中→能力递堕、权宦易炽）。
- 新增：党争深化——科第同年网络与座主门生为结党渊源（官员
exam_year落库）、京察六年一典（主明澄清/主暗倾轧）、阉党（权宦拥党为奥援，权宦败则俱散）。 - 新增：存档读档与倍速——整局 JSON 快照（引用保序、骰值不重掷），一键存读档；自动运行 1×/2×/4×/8× 倍速。
- 优化：国祚 Tab 增「国势四维·国库度支」与「危局·流寇边患」栏；今上 Tab 增后妃外戚行；修复
gamestart不重置ongame的潜在缺陷；补齐女名词库。
- 新增：朋党系统——文官依科第年谊、地缘乡党与政见声气结党；开局为潜邸旧人，立党自中叶渐起（并存至多四党，一朝党名不重）。
- 新增：党争演化——士人趋附入党（次线性声势，人杰不趋炎各择其主）、党魁以朝堂势大者为之；交章弹劾逐对方大员、优势党兴大狱连削数籍、新君清算前朝权党、帝察党盛罢魁裁抑；主明则党戢、主暗则党炽。
- 新增：「朋党」Tab——各党概览（党风/党魁/人数/势力/立党之年），点党名看成员名录（跨朝堂/地方，可点开个人详情）与党争始末纪事表。
- 优化：党籍随官员跨「朝堂↔地方」转任转移（贬谪不脱党）；朋党页与朝廷页刷新同节流策略。
- 重做：地方政区改为明中叶格局——两京（京师/南直隶）一十三省，共领 136 府；政区层级下至府，删除知县一级。
- 重做：知府必系具体府名——每府一席（如「兖州府知府」「琼州府知府」），京府（顺天府/应天府）置府尹（正三品）；两京直隶不设藩臬。
- 重做：总督增至五员——蓟辽、宣大、三边、两广、川湖贵，例兼右副都御史。
- 调整：升迁链改为「知府 → 府尹/按察使 → 布政使 → 巡抚 → 总督」；进士释褐外放仅授知府（二甲以上）。
- 新增：科第渐盛——补缺招募的文官回溯「散进士」科第出身（登科录外的 bulk 进士）：开国数十年荐举辟召为主，其后十之八九出科第；出身者初仕年对齐真实科年（如「壬子科三甲第六十八名」）。
- 优化：地方民情事发概率按职级分层（列郡知府远低于藩臬），避免百余府纪事刷屏。
- 优化：地方官详情/历任弹窗与朝堂履历合并处，官职名均带府名（如「擢山东兖州府知府为陕西按察使」）。
- 新增：三年一科开科取士——礼部尚书知贡举，殿试产生三鼎甲（状元/榜眼/探花）与登科录；科份以干支命名（如「壬戌科」）。
- 新增：恩科与科场案——新君即位或诏开恩科以示庆成；主上暗弱时科场舞弊或发，主考下狱削籍。
- 新增：进士候铨与释褐入仕——新科进士进入候铨池，知县/知府出缺优先释褐进士，翰林/詹事等清华清要之职优先科第擢用；进士沿升迁链可至封疆拜相（翰林 → 侍郎 → 尚书 → 入阁 / 知县 → 巡抚 → 总督）。
- 新增：「科举」Tab 页——本科盛况信息条、历科会试表（点击翻阅登科录弹窗）、候铨进士表；朝臣与地方官详情弹窗显示科举出身。
- 优化：修复朝臣/地方官初仕年回溯在「年龄撑不起最低资历」时仕途年数不达标的潜在缺陷。
- 新增：编年史骨架补全——帝崩（三体享年 + 庙谥）、新君即位（五体继统名分 + 建元取义 + 冲龄之注）、册立储君（初立/更立/皇太孙）、皇子诞生（嫡庶生母）与夭折、 亲王就藩之国、王府袭封（过继书「嗣」）与除国；帝系终始在编年不再缺页。
- 新增：「史臣曰」——每帝盖棺一篇在位总评（功绩标签组合成文），亡国另有 整朝终论（享国/历帝/缘由），入编年末笔。
- 新增：灾异·祥瑞感应（
mixins/omen.py）——盛世凤凰嘉禾黄河清，衰世日食彗星 六月霜（借灾异讽时政），牵动国运四维；谶谣民风先于祸而作（流寇/垂尽/倭警/虏 势各有所谣，一朝不重谣）。 - 新增：年度事件槽位化——事件钩真实实体（
{名臣}/{尚书}/{巡抚}/{知府}/ {亲王}/{党}/{渠帅}/{府}/{省}逐年解析为当朝人物政区），并新增御史直谏、治河嘉奖、 开中盐法、亲王来朝、献俘阙下等人物化事件。 - 新增：文案变体池——拜相/首辅卒（暴卒·薨于位·恤典·里第）/权臣/加衔特进/ 册后/权宦批红/东厂缉事/边镇殉国失利出塞/锦衣卫缉事/流寇蜂起抚剿破京/草原一统 入寇破关/倭警消长/朝贡，高频纪事不再复读（AST 定位整调用重写，零 CJK 依赖）。
- 新增：纪时干支——纪事时间统一「洪武三年·庚戌」（开局甲子，与科份干支同法）， 主横幅加岁次；年号释义——改元/建元附取义。
- 新增：裸数值雅化——天寿缀圣躬康豫/时有违和/圣体不豫，治国手腕折九品， 春秋汉字书之；四维加史官评语与趋势箭头；人物详情弹窗加一句考语。
- 重构：风味词池集中
dynasty/flavor.py（词池 + 槽位解析 + 史笔成句，纯数据），mixins/omen.py专司天人感应年度结算；新增状态字段入权威表（储位/四维快照/已传谣）。 - 二期：大势句词池化 + 纪事表分类着色（灾朱/丧灰/军金/贺青） + 大凶灾异「天变」 旗标联动改元（chance_bonus） + 财赋/科举/地方/后妃变体池补齐 + 「建元」撞词加「」。
- 修复：无魁之党（党魁先去、党后解散）解散时党魁末账未以「党散」闭账的
边界缺陷（
_seal_leader_ledger兜底，随机轨迹约五成概率踩中）。
- 新增：官员志节系统——文官野心/清望两维（1–9）：权臣须才高而志又在焉（野心 ≥7）； 贪墨系于清望（不再以能力代偿）；谥号并衡名节（文正等极品不与清望有亏者）； 党争趋附并看志节（野心热中易趋附、清望极高者孤介自守）。
- 新增：夺情——重臣（阁臣/尚书，能力 ≥7）丁忧而朝局倚之，诏夺情墨绖视事， 言官交章论劾、吏治微伤（张居正式戏剧内生涌现）。
- 新增：女性宗室实体化——宗室男女皆育：帝女公主、亲王女郡主、郡王女县主 （美名封号「长乐公主」之属），公主下嫁驸马都尉、郡主县主适仪宾；女封岁禄入国库度支。
- 新增：嫡庶承统——帝系子女记生母（皇后所出为嫡），储君与兄终弟及皆循 「嫡长 → 代位」，名实相副的嫡长子继承。
- 新增：公主和亲——虏势方张而边备不修，朝议和亲（帝女亲者先，不得已用宗女封公主）： 虏势稍戢、入寇递减、岁币年年输纳；约系于可汗其人，可汗亡则约绝。
- 新增：宗室政治——主暗则贤王（能力 ≥7 亲王）入朝辅政（国运吏治双补，帝明还国）； 庸王骄纵不法、累三罚废为庶人；封国挂靠政区（秦王之国于陕西），宗藩 Tab 见就国之省。
- 新增：宗禄软约束与国库联动——宗禄占岁入之比 ≥25% 生育减半、≥40% 仅帝与亲郡王可育 （宗禄困境内生为经济约束）；库竭加权流寇蜂起与加派民怨；欠饷兵变（戍卒鼓噪索饷）。
- 新增：人物绑定纪事——贪墨、善政、夺情、辅政、和亲、驸马诸纪事绑定具体人物
（
subject/subject_role落库），供史馆检索取材。 - 重构：状态权威表——全部可变状态收进
STATE_FIELD_DEFAULTS一张表， 开局/亡国重开/读档缺省迁移三处共用，根除「三处同步」人工清单（历史上漏一字即生僵尸王朝）。 - 重构：存档 v2 与旧档迁移——v1 存档读入自动补新字段默认值（不重掷骰值）； 冒烟测试新增「存→读→再存逐字段一致」硬校验。
- 新增：批量模拟回归工具
tools/batch_sim.py——无头跑 N 局，输出国祚分布、 四种死法占比、宗禄占比峰值等（--games/--seed/--csv），调参回归不再挂机目测。 - 优化：宗亲录纳入女性宗室（公主/郡主/县主/宗女，附婚配）；文本书写与断言健壮化 （短祚未立党、读档后三年内亡国等尾部情形不再误报）。
- 新增：功臣封爵系统（
mixins/nobility.py）——明制武臣世爵三等：国公/侯/伯 以军功授之，爵号一朝不重（封号池：国公古国名、侯伯军功美名地名），在世各有定员 （公 3 侯 6 伯 10），满员俟缺。 - 新增：授爵四途——开国大封（初代武将论秩崇武略，公 3 侯 5 伯 4，一桩大典总叙）、 边功即封（出塞大捷军功 ≥6 者可即封伯）、岁考递晋（伯 merit ≥15 晋侯、侯 ≥22 晋公， 无爵宿将武略 ≥7 且 merit ≥8 者岁考新封为伯；晋爵另锡新号）、身后追封（无爵而卒 merit 达标者追封，战殁加厚，罪废不封）。
- 新增：开国世袭、新封流爵——开国功臣之爵世袭罔替：主者身故（任上/闲住/战殁）
则子袭爵，袭爵子弟入武册冠带闲住（承父姓另取名、武略 +1、
person_ids贯父子为一门）， 遇左都督/总兵缺起复就任（勋臣掌五府故事）；后世战功新封者为流爵，止其身。 - 新增：削夺——罢/劾罢/削职/降/谪贬皆坐罪夺爵，赐死伏诛亦夺；封爵账
（
military_jue_history）录授晋/承袭/追封/削夺之始末，旧档读入自动补默认值。 - 新增：勋臣爵禄——公 4.0/侯 1.2/伯 0.8 万两岁禄入国库度支（闲住亦承， 明制勋臣世代食俸），与宗禄并为度支之累。
- 新增：武备页「勋臣世爵」表（爵位/姓名/官职/授爵/状态/世袭）与花名册 爵位列；「历代勋臣录」弹窗按爵位分世系罗列历代封爵全账（同一爵号 之历次承袭贯为一门，组头标始封之年与历世之数，姓名可点看详情，已故者亦然）； 武臣详情弹窗增爵位（注明世袭罔替/流爵）、授爵年与「封爵沿革」小表。
- 优化：军功既纪而后论爵（
gamemin_military内_military_jue_check岁考 置于军功结算之后、三孤加衔之前）。 - 新增：爵谥并载——勋臣卒则爵谥并书：封爵账身后闭账并谥入账； 勋臣之谥从优（美谥常谥给之，次等不与）；袭爵纪事作明史笔「魏国公某某卒， 谥武宁，子某某袭爵」、流爵卒补书谥纪事；武臣详情弹窗已故者爵位显示 爵谥合称（「魏国武宁公」，明制中山武宁王之式）。
- 新增：官员性情（
flavor.roll_personality，文/武/内三池掷定，互斥不同取） 与绰号（拜相/权成时授：「刘棉花」「三旨相公」「救时宰相」「苏模棱」）； 圆滑易附党、耿直耻于朋比（入党概率 ±），耿直易为怨府——性情轻挂钩党争。 - 新增：三表形势行（朝堂/地方/武备 tab 顶部一句总述）、度支史笔一行 （岁入岁出帑藏五档之评）、终局名臣列传按语（一传一句史评）、 详情弹窗生平纪略（天下纪事+党争纪事按时序合并）、国运图灾异/嘉祥标记。
- 新增：皇帝性习——登基掷一至二条（工诗善书/精骑射/好神仙/喜营造/
耽于逸乐/恭俭/好货/猜忌/仁柔/好学，互斥不同取），轻挂钩怠政阈值（耽于逸乐）、
矿监税使触发（好货）、岁出省浮费 4%（恭俭）、亲政增益（好学）与「豹房」之目
（
{宫}槽位）；宫中岁时性习之笔（建醮/校猎/御制颁赐/减膳撤乐，纯风味）。 - 新增：诏敕层——大凶灾异之岁帝下罪己诏（引诏书一语入编年， 与「天变」改元祈福同源，国运 +1）；国运濒危（≤35）下求言诏（一帝一诏）。
- 新增：妃嫔位号与宠衰——诸妃授位号（
state.consorts位号账， 一朝不重号）、宠遇逐年消长；宠极则晋位、皇子生母母以子贵， 另有妒争、失宠之笔（纯风味）；椒房面板四格扩五格（增妃嫔格，以宠为序）。 - 新增：帝陵与实录——帝崩营陵赐名（
fl.MAUSOLEUM_POOL一朝不重名； 山陵之费 20 万两入度支，亡国之君书「国亡，无所葬」），崩纪缀「葬于某陵」， 帝王列表增陵寝列并点击开实录弹窗：庙谥并释（谥法/庙号逐字释义： 「文」经纬天地、「厉」杀戮无辜）、性习、年号沿革、国运始末峰谷、 「史臣曰」原文与在位纪略。 - 新增：殿试策问——每科按当朝局势掷题（四维最耗处先问：边饷/河工/ 理财/吏治，党盛问朋党，承平问礼乐），登科录卷首展示。
- 新增：民生一行——国祚页度支史笔之侧：京师米价（民力为主四档）+ 民谚（丰/平/苦/乱四档民谣）。
- 新增：绰号扩展——权宦得「九千岁」「立皇帝」「内相」之目；名将大捷得 「铁面都督」、败军失律得「长腿将军」之讥；清官立德政碑得「某青天」、 贪墨案发得「钱痨」「某剥皮」之讥。
- 新增：表字与别号——朝臣/地方/武臣/进士入仕授表字（五详情弹窗与 列传共书）；致仕/病免/终养者四成自号（「某居士」「某山人」）。
- 新增：丹书铁券——授爵即授券（世券免二至三死、流券一死止其身， 承袭随爵递传），削爵夺券并书「券虽在而法不可贷」。
- 新增：回归脚本
tools/test_flavor4.py——四期风味十项逐条断言 （性习/位号/绰号/帝陵/表字/策问/诏敕/铁券/民生/宫殿）与存档迁移校验。
- 新增：定鼎序幕——新开局一现「开基定鼎」一页：太祖出身掷定（布衣/将门/
世吏/豪强，谓之「本朝故事」）、起兵之地、国号年号各缀取义、追尊立庙、
群臣上尊号、大封功臣赐铁券（
fl.founding_prologue_paragraphs；字段founding_origin/origin_text/region入权威表，旧档自动补空，读档不弹）。 - 新增：国史凡例（终局第四签）——亡国后新朝修《某书》：本纪 N 卷、
志目因事开列（食货必书，河渠/五行/选举/兵/宗藩按一朝实况）、表目
（宰辅年表/宗室世表/功臣世表）、列传 N 卷即名臣列传之数，总卷数成句
（
fl.guoshi_fanli_text；_populate_shifan）。 - 新增：交游一行——朝臣/地方官详情弹窗书同年、座主/知贡举门生、
党籍、后族姻亲，政敌由党争纪事人物账互见而得并缀一句相讥
（
_jiaoyou_label+fl.jiaoyou_jibe）。 - 新增：考绩四等——四表与四弹窗的政绩/军功/贤否裸数改
卓异/称职/平常/下考（
fl.kaoji_band/kaoji_detail_text），裸数转入悬浮； 表头「政绩」改「考绩」。 - 新增：登科录金榜式——金榜横批（
jinbang_banner黄绫底）+ 榜文表（jinbang_table黄绫表头），一甲三行加粗衬金绫底。 - 新增：舆图（
dynasty/map_chart.py）——国祚页「查看舆图」：两京 一十三省示意方格图，流寇朱旗书渠帅、近岁灾异朱框、北疆虏警沙尘、 沿海倭警沙晕，悬停一省观近年之事（collect_signals扫纪事尾段与流寇账）。 - 新增：国势随色——
styles.THEME_BANDS四档（隆/平/衰/危）， 强调色与纸面随国运微移、匾额描边同步；update_ui档内不重施。 - 新增：开始页取义行——国号/年号另换即释一字之义
（
fl.GUOHAO_GLOSS+guohao_meaning）。 - 新增：回归脚本
tools/test_flavor5.py（五期十项 + 存档迁移）与 截图脚本tools/shot_flavor5.py（取义行/序幕/舆图/金榜/凡例/主题两档）。