公司行动账本（原始股本口径）

语言：简体中文 · English

simulate_execution_adjusted_nav 可以接收可选的 CorporateAction 事件。传入 None 时，功能关闭，原有价格收益口径和结果结构保持不变。 传入空列表也算启用功能，因此仍要求原始价格。此时 actions 为空，holdings 仍按日记录持仓。

事件契约

• 每个事件都必须满足 available_date <= record_date < ex_date。
• 现金分配必须提供 cash_pay_date，送股必须提供 stock_tradable_date，结算日期不能早于 ex_date。
• record_date、ex_date 以及落在模拟区间内的结算日期，必须是执行日历中的交易日。available_date 会校验为有效日期，但不会检查它是否属于该日历。
• 只要提供 corporate_actions，price_basis 就必须是 "raw"，即使事件列表为空也一样。
• 事件 ID 不能重复。证券代码和事件 ID 必须是非空且已规范化的字符串。分配数量和预扣比例必须是有限值，并符合允许范围。
• 事件可以派发现金、额外股份，或两者兼有。小数股会保留，不会折算成现金。
• 权益按记录日收盘时的持仓计算，包含当日成交后的变化。现金权益在除权日记为应收款，到支付日才转为可用现金。送股权益按原始价格估值，到指定的可交易日才加入持仓并可卖出。
• 公司行动在当日订单执行前处理。除权日，受影响证券尚未完成的订单会被取消。
• 记录日持仓只从本次模拟区间内的收盘持仓捕获。记录日早于模拟起始日时，不会导入模拟开始前的持仓，也不会据此生成权益。
• 每个事件可以指定统一预扣比例。默认值为零，表示不模拟预扣。这是显式的研究假设，不代表历史持有期税费复现。
• 公司行动未结清期间缺少有效原始价格时，模拟会报错，不会继续计算。

启用后，结果会增加 actions 和 holdings 两类回执。actions 记录模拟中发生的记录、除权、现金支付和送股解禁阶段。 holdings 按日记录持仓与应收权益。逐日结果还包含 cash_receivable 和 stock_receivable_value，汇总结果列出核算约定。 账本不会推算复权价格、零碎股折现款或缺失的结算日期。

适用范围

这是一项使用合成夹具测试的公开核算机制，不代表历史公司行动数据完整，也不提供历史券商费用、板块专属数量规则或实盘能力。调用方负责核实和规范化输入事件。私有研究应在调用前保存规范化输入的 hash。

事件输入可能包含后续修订，或同一除权日对应多个报告期。此类冲突应先由独立来源核实，再用于研究。