外交数据与实现对接
状态:设计预留,外交设计 v1.0(2026-10-07)。新增规则尚未作为已实现玩法发布;费用、期限与评分为首轮测试参数。
所属系统:外交系统总览。
现有基础与新增范围
现有状态依据2026年10月7日“梳理政治系统资源与实现”讨论中的代码梳理:影响力支付、威望存续、派系计算、官职与行政财政控制、占领转治理已有基础;正统外交、完整派系行为与政变闭环尚未完成。这里将其作为对接基线,不把本设计中的规则标为已实现。
| 现有模块 | 本设计对接 | 新增工作 |
|---|---|---|
| PoliticsManager 与 PoliticalState | 复用影响力、威望、统治者和持久标记。 | 统一外交增减接口与外交威望保底;派生朝廷权威。 |
| FactionsManager 与人物政治数据 | 复用权势、派系实力、政治立场和忠诚。 | 拥立承诺、摄政权限、政治事件结果;不直接把派系评分当资源扣除。 |
| GovernanceManager | 复用官署权限、实际控制、财政明细和治理接管。 | 条约转移与宣称范围校验;收益条款接入一次性月度分账。 |
| 政策系统 | 读取已生效政策和权限。 | 宫府一体代理诏令接入;招安令可降低费用,但有资源文件不代表已有功能。 |
| GameWorld 与 GameActionQueue | 外交写入从perform_action进入现有队列。 | 捕获稳定ID与参数副本;执行时复验,和约统一提交。 |
最小数据对象
朝廷记录:正统ID、朝廷势力ID、控制者、权威构成、主局势及持续月数。宣称:来源、授予者、持有人、范围、权利类型、期限与争议状态。条约:当事方、条款、起止日、同意版本和履约记录。争端:主事者、双方目标、成员表态、阶段及截止日。战争:来源争端、阵营、冻结基准、贡献和占领记录。
条款效果按一次性与持续性分开:即时效果只在成功提交时执行一次,持续效果每月按条约ID与结算月记账。读档不得重复转钱、授官或触发投票;无效对象产生可解释的待处理状态,不能默默换成当前选中对象。
场景与执行
可视界面及协调节点优先使用.tscn场景,理由和条款使用可配置资源;只将纯数据和规则计算放在脚本。设计建议新增外交协调场景与四类面板,不要求所有规则各建一个节点。
日月结算与外交行动串行提交状态,等待采用协作式await,不暂停场景树。大规模AI评估读取快照,可在线程计算;工作线程不得访问场景树。最终提交保持短小,长批次在安全检查点分帧。战争和约的跨模块原子提交是P0必需项。