中国国家发展模拟器

一款从 1949 年开始、以月为最小推进单位的国家经营模拟游戏。项目优先建设完全独立于界面的确定性模拟核心，再通过 Web Worker 接入 React 管理界面。无界面核心已包含国民经济账户、人口家庭、企业所有制、中央地方财政，以及货币银行与国际收支账户。

维护或扩展项目前，请先阅读 程序维护与扩展指南。该文档包含模块边界、状态迁移、月度管线、国策与事件扩展、科技工业联动、测试校准以及 AI 代理执行清单。若使用 AI 助手继续新增板块、国策或事件，请同时阅读 AI开发指南，其中包含任务类型速查、分阶段流程和可粘贴提示词模板。

开发命令

npm run typecheck
npm test
npm run simulate:korean-catch-up
npm run simulate:taiwan-route
npm run data:audit
npm run calibrate -- outputs/calibration-errors.csv
npm run calibrate:auto
npm run uncertainty -- historical 1949 12 1949 2026
npm run audit -- outputs/final-audit.json
npm run build
npm run test:static

historical-data-registry.json 统一登记历史校准序列的发布者、来源地址、统计口径、单位、价格基准和分时期可信度。npm run data:audit 会在不访问网络的情况下检查来源引用、指标唯一性、年份覆盖和校准分组；人工复核日期保存在注册表元数据中。校准报告把 1949、1957、1978、2000、2020 年作为拟合组，把 1965、1990、2010 年作为留出验证组，2026 年单列为基于最近完整年度数据的预测基准，避免用拟合点通过率代替模型外验证。

npm run uncertainty 会以多个连续种子运行同一无界面路线，报告实际 GDP、人均 GDP、人口、通胀、债务、科技和评分的 P10/P50/P90 区间。npm run calibrate:auto 使用固定网格和有界坐标搜索诊断系统性口径偏差，只用拟合组寻找候选，并单独评估留出验证组；若留出损失上升，候选会被明确拒绝。该工具不会自动改写历史目标、容差或模拟配置。

纯静态部署

项目保留原有 Sites/Cloudflare Worker 构建，同时提供完全独立的纯静态产物：

npm run build:static

构建完成后，将 dist-static/ 整个目录上传到 Cloudflare Pages、GitHub Pages、Netlify、对象存储或 Nginx 即可。该目录包含 index.html、SPA 回退用的 404.html、.nojekyll、浏览器模拟 Worker、样式、脚本和社交分享图片，不包含服务端入口。站点需要部署在域名根路径；游戏进度继续保存在访问者浏览器的 IndexedDB 中。

# 同时生成并核对首页、回退页、资源引用和模拟 Worker
npm run test:static

普通 npm run build 仍生成现有 Sites 部署所需的 Worker 产物，不会被静态部署路线替换。

模拟逻辑位于 src/simulation，浏览器 Worker 位于 src/worker。所有数值参数集中放入 src/data/config，React 组件不得直接计算经济指标。

经济产出同时受到供给能力和需求实现的约束。居民消费、投资、政府公共服务支出和出口构成总需求，上一月已经实现的内外需求会渐进影响下一月各产业产能利用率，再进入产业增加值和 GDP；出口不会直接重复计入 GDP。出口能力由科技树节点、教育吸收能力、十一类工业结构、基础设施、开放度、双边关系、贸易协定、制裁和外交路线共同决定。社会保障支出通过转移收入和降低居民预防性储蓄提高消费倾向与内需，同时承担财政支出、储蓄下降和潜在通胀代价，不作为无成本的 GDP 加成。

国民经济账户把农业、十一类工业、市场服务和公共服务归并为 14 类产品，逐月编制供给使用表。每类产品记录国内总产出、进口、出口、中间需求、居民消费、资本形成、政府消费和存货变化；供给与使用逐项守恒。生产法 GDP 由增加值汇总，收入法拆分劳动报酬、固定资本消耗、生产税净额和营业盈余，支出法拆分最终消费、资本形成、政府消费和净出口，三种口径经过显式统计调和后必须一致。中间品短缺不会同月反复计算，而是形成投入可得率，在达到严重短缺门槛后约束下一月生产。配置参考国家统计局历年投入产出表并集中保存在 input-output.json。

部门市场动态在同一套 14 类产品上维护相对价格、实际库存和目标库存，并汇总 CPI、PPI、GDP 平减指数、名义与实际工资指数、劳动收入份额和产出缺口。库存变化是年度化流量，进入库存存量前只累计十二分之一；短缺通过相对价格和投入可得率传导，实物商品库存超过目标较大幅度后才滞后抑制生产，服务业不会被错误当作可储存商品。参数集中在 market-dynamics.json，史实路线仍通过全部校准锚点。

详细人口账户把总人口展开为 18 个五岁年龄组并分别记录男女数量，每月结算出生