第 15 篇完成了策略晋升门禁。通过门禁不等于可以真实交易它只表示这个候选策略有资格进入更慢、更保守的纸面模拟盘观察。第 16 篇先不做复杂撮合也不接券商接口只做一件事把模拟盘账户账本写清楚。为什么从账本开始模拟盘的第一层可信度来自账本。如果买入后现金没有扣对卖出后持仓没有减对手续费没有算进成本后面的权益曲线、风控、调仓提醒都会建立在错误状态上。这里先把几个常见名词说清楚名词在模拟盘里的含义账本记录现金、持仓、成交和盈亏的账户状态成交一笔订单被接受后形成的账户变更平均成本当前持仓每股摊薄后的成本买入手续费也会影响它已实现盈亏卖出后真正落到账户里的盈亏未实现盈亏当前持仓按最新价估算出来的浮动盈亏账户状态第 16 章新增app/paper_ledger.py核心对象很少dataclass(frozenTrue) class PaperAccountState: cash: float positions: dict[str, PaperPositionState] field(default_factorydict)持仓只保留当前需要的字段代码、股数、平均成本和已实现盈亏。这里没有数据库也没有异步任务是一个纯函数账本便于测试和复用。执行买卖下单入口是apply_paper_order()。它会复用第 4 篇的 A 股交易规则买卖股数按 100 股一手处理买入检查现金卖出检查可用持仓并使用同一套手续费估算函数。execution apply_paper_order( account, trade_datedate(2026, 1, 8), symbol000001.SZ, sidebuy, price10.0, shares1234, )这个订单会被规范成 1200 股。账本返回PaperExecution其中既包含本次成交也包含成交后的新账户状态。市值和权益账本还提供两个小函数account_market_value(account, last_prices) account_total_equity(account, last_prices)它们暂时只用最新价估算持仓市值。后续第 17 篇会把这些值组织成更完整的账户快照。当前主线联动运行当前主线仓库提供了一条从第 16 篇跑到第 20 篇的模拟盘示例git clone https://github.com/ax2/zi-quant-platform.git cd zi-quant-platform uv sync --extra dev uv run python -m scripts.chapter_examples paper-flow第 16 篇对应的是账本成交部分这次示例从 100000 现金开始买入000001.SZ6400 股成交金额 79744.00费用 24.72成交后现金剩 20231.28。这个截图比单独贴测试结果更有用因为它展示了买入订单如何真实改变账户状态。本章更新与代码仓库本章更新内容新增app/paper_ledger.py。实现模拟盘账户、持仓、成交执行结果和买卖更新逻辑。复用 A 股交易规则和手续费估算。新增tests/test_paper_ledger.py覆盖买入、现金不足、卖出、无持仓卖出和权益计算。在当前主线补充scripts.chapter_examples paper-flow联动示例可真实运行第 16-20 篇模拟盘链路。补充账本、成交、平均成本、已实现盈亏和未实现盈亏等常见名词。代码仓库https://github.com/ax2/zi-quant-platform本章代码git clone https://github.com/ax2/zi-quant-platform.git cd zi-quant-platform git checkout chapter-16 uv sync --extra dev uv run pytest tests/test_paper_ledger.py第 16 章提交为936cb5ctag 为chapter-16。本篇小结模拟盘不是先做界面也不是先做提醒。第 16 篇把账户现金、持仓、成交和权益计算写成了可测试的账本函数。下一篇会在账本之上生成账户快照让模拟盘状态可以被展示、风控和复盘。