投资公司发展物语 V2.0 设计文档 v0.6

版本说明

• 本文档为 v0.6 规划与规则速查，在 v0.5 全部功能 基础上新增两大系统：宏观经济、行业市场竞争。
• 全篇与仓库 investment-sim/ 对齐；与代码冲突时以代码为准。
• 并购系统（含收购 NPC 份额）不在 v0.6 交付，规划为 v0.7。
• 设计原则：表驱动、可复现（与附录 A / mix 随机源一致），参数可 JSON 热更。
• SCHEMA_VERSION 在实现 v0.6 时升级，并需规定旧存档迁移规则。

目录

1. v0.6 变更摘要与继承关系
2. 目录与代码路径约定
3. 第一部分：宏观经济系统设计方案
4. 第二部分：行业市场竞争系统设计方案
5. 统一时间线与实现规划（v0.6.1～v0.6.4）
6. 数据结构与 JSON 配置汇总
7. 新增 UI 与反馈
8. 与 v0.5 系统整合总表
9. 后续扩展（v0.7+）
10. 版本历史

0. v0.6 变更摘要与继承关系

1. 目录与代码路径约定

路径以仓库根目录为基准（与 v0.5 一致）。

2. 第一部分：宏观经济系统设计方案

2.1 设计目标

将现有玩法（股票、期货、房地产、投资初创公司、业务组）通过统一的宏观经济模型串联起来，实现：

• 宏观景气度影响所有行业与业务；
• 各玩法之间产生间接联动（例：房地产景气 → 地产股修正 → 地产相关业务组收益修正）；
• 经济周期带来可预期的潮汐式波动；
• 可复现、表驱动（与附录 A、rng.js 的 mixUint32 一致）。

2.2 宏观经济核心指标体系

2.2.1 基础指标（每月更新）

2.2.2 合成指标

2.3 行业景气度生成机制（五条宏观线）

五条宏观线：股市综合、大宗商品、房地产、科技/互联网、海外市场。
不再由 rollMacroC 独立均匀随机；改由宏观指标 + 表 + 可复现噪声计算 base_bp，再映射为 c。

通用公式（万分比基准，与附录 A 对齐）：

base_bp = 经济周期基准[g] + 利率影响 + 情绪影响 + 随机噪声（可复现）

2.3.1 经济周期基准表（依赖 g）

表可独立调参；最终股票收益在现有 B_stock[c] 之上可再叠加上游（见 2.5 节与实现时的防重复加算约定）。

2.3.2 利率与情绪修正（示例系数，可配置）

2.3.3 月度景气编码 c 的确定

将 base_bp 映射为附录 A 的 c：

兼容策略：附录 A 的 B_stock[c]、B_fut[c]（及 stocks-futures.json 中按品种的行）仍直接使用该 c；上游只改 c 的生成。

实现注意：若仍保留 noise_bp 与 A[a] 等，需明确是否将「经济周期基准」与「原 B_stock[c]」合并为一次加总，避免双重计算；推荐在实现说明中固定一种：

• 方案 A（推荐）：P_stock = B_stock[c] + A[a] + G + sector_beta + 事件修正 + noise_bp，其中 c 由宏观推导；B_stock 表不变。
• 方案 B：用 base_bp 替代 B_stock[c] 的环境项（需重标定表）。

本文档默认 方案 A。

2.4 各玩法联动规则（摘要）

2.4.1 股票投资

P = B_stock[c] + A[a] + G_stock[mode] + sector_beta + 个股事件修正 + noise_bp

• sector_beta：配置在 stocks-futures.json 每只股票或行业，范围约 [-200, +200]（万分比）。
• 房地产景气 → 地产股：当地产宏观线 c=0 时，sectorId='re' 个股额外 +200bp；c=4 时 -300bp（数值可配）。

2.4.2 期货交易

扩展品种与宏观联动（节选）：

公式：
P = B_fut_by_variant[c] + A[a] + 宏观联动修正 + 事件修正 + noise_bp，P_final = P * L。

2.4.3 房地产投资

月租金收益率（bp，设计式）：

月租金收益率(bp) = 房地产景气基准(rr) + (6% - r)×100 + CPI 影响

rr 由房地产宏观线的 c 决定（基准表可配）。利率项：(6% - r)×100 表示相对中性利率 6% 的偏离。CPI：例如 π 每高出 3% 一个百分点，租金收益率 +50bp（阈值可配）。

2.4.4 投资初创公司

• 成功率、回报倍率与行业景气 c、创新力、以及 r>8% 时融资惩罚等挂钩（具体表见实现）。
• v0.6 简化：可先上线宏观对成功率的单维修正，回报倍率逐步加全。

2.4.5 业务组（实业经营）

monthlyRevenueWan = baseRevenue × marketShare × productMultiplier × macroFactor
macroFactor = 行业景气系数 + 利率修正

行业景气系数与 c 映射（0.8~1.5 等）可配；利率：r<4% 时 +0.1，r>8% 时 -0.15（示例）。
专利估值在 c≥3 时可 8 折（示例）。

2.5 经济周期系统

2.5.1 周期判定（示例）

2.5.2 周期转移

• 使用可复现马尔可夫链：每月依当前阶段有 5%~20% 概率（表驱动）向相邻阶段转移，随机数来自 mix(gameSeed, monthIndex, …)。
• 平均持续约 12 个月，可被大事件打断。

2.6 宏观大事件与随机事件（摘要）

• 大事件：央行加息/降息刺激、石油危机、科技泡沫、房地产调控等，按周期与种子条件触发，持续 3~12 个月。
• 小事件：干旱、外需、黑天鹅等，在现有 events 体系中增加对 m、板块 c 的修正。

2.7 期货品种扩展（配置方向）

在 stocks-futures.json 的 futures.variants 中新增例如 gold / silver / copper，每品种含 B_fut_bp_by_c 与 macroSensitivity 字段；具体数组与旧品种风格保持一致。

2.8 可复现实现要点

• 宏观序列：r, π, g, m 及噪声均由 gameSeed + 年月 t 通过 mixUint32 派生。
• 可预置 1990~2020 基准利率轨迹表作为 r 的锚，事件再叠加上去。
• 存档须记录当月宏观态与每条线的 c / base_bp（或可用于回放的最小集），与结算使用同一随机源。
• 玩家行为不反向影响宏观（避免复杂度爆炸），除非将来单独开系统。

2.9 与现有代码的落点（参考）

3. 第二部分：行业市场竞争系统设计方案

3.1 设计目标

建立覆盖业务组、投资初创公司、房地产三领域的市场结构：

• 每行业有独立总市场规模与竞争格局（玩家 / NPC / 其他）。
• 玩家通过市场相关行为（含业务组扩张；并购为 v0.7）提升份额。
• NPC 每月按规则波动，可复现。
• 市场规模受宏观经济与行业景气影响。
• 为财报（营收、成本、净利润）打基础。
• 全量参数 JSON 可配、可热更。

3.2 核心数据：market-config.json（规划）

• 文件建议路径：data/investment-sim/market-config.json。
• 含 schemaVersion、industries[]：每行业 id、name、totalMarketSizeWan（初始总市场，万元）、initialPlayerShare、initialNpcShares[]、otherShare、growthRateBase（年）、fixedCostWan（月固定成本）、variableCostRatio、macroSensitivity 等。
• realEstate：全国规模、regions（如 bj/sh/sz/other）与 shareOfNational。
• startup：默认总市场、增长率等。
• globalParams：maxNpcSharePerIndustry、otherMinShare、monthlyNpcVolatility 等。

行业 id：market-config.json 的 industries[].id 必须与 v0.5 业务组/初创的 industry 使用同一套 canonical key（与 INDUSTRIES 一致，见 5.3 节），禁止两套命名并存。

3.3 运行时状态 marketState（存档）

对每行业、每房地产区域等维护例如：

• totalMarketSizeWan（动态）
• players: { 业务组ID 或 项目ID -> share }
• npcs: { NPC公司ID -> share }
• otherShare（自动为 1 - sum(players) - sum(npcs)，并做边界修正）
• lastUpdateMonth 或 lastUpdateMonthIndex（推荐 monthIndex 整数）

3.4 月度更新顺序

在 businessGroups.tickMonth 之后、主月结 endTurn 的结算前/后（以最终实现为准，须固定并写入文档与代码注释）执行：

1. 更新总市场规模（年或季度锚定 + 宏观修正 + 季度平滑，见 3.6）。
2. 竞争动态（零和）：
   • NPC 份额随机波动（可复现）；
   • 依规则压缩 NPC 使 sum(npcs) ≤ maxNpcSharePerIndustry；
   • 保证 otherShare ≥ otherMinShare（不足则从 NPC 回收）。
3. 依份额与成本结构计算营收与净利润（见 3.7）。
4. 将结果写回业务组/房地产项目/初创（若已接入）的当月财务字段。

玩家不通过本 tick 直接改 NPC 份额；玩家份额变化来自 扩张/项目完成/未来 v0.7 并购 等。

3.5 NPC 动态（可复现）

对每个 NPC、每月：

H = mix(gameSeed, monthIndex, industryId, npcCompanyId, tag)
delta = 映射为 [-maxDelta, +maxDelta] 的倍率；newShare = oldShare * (1 + delta)

再执行归一化、上限、补回 other（见 3.2 全局参数）。
可选扩展：为 NPC 配置 archetype（防御/进攻/高波动）与 volatility，v0.6.3+ 可逐步实现。

3.6 玩家获取份额的方式

3.6.1 业务组：与「扩展业务」按钮联动（v0.6 约定）

• v0.5 已实现扩展业务按钮（如每次消耗固定资金、marketShare +0.5% 档位的简化逻辑）。
• v0.6：每次点击「扩展业务」仍消耗配置的现金（如 50 万），同时累积 扩张点 expandPoints，例如：
  • expandPoints += expandCostWan / 10（每 10 万投入 1 点，比例可配）。
• 达到阈值时，从 otherShare 争夺 少量份额给该业务组（每月最多转化一次）。阈值可与当前份额挂钩，例如：
  • threshold = 20 * (1 + playerShare * 10)（示例，可改为对数曲线以缓后期，见下款）。
• 不在 v0.6 要求恢复 v0.4 的月度 expandWan 输入框；若未来并存，需在文档中单列版本。

实现时需在 businessGroups.js 中显式增加 expandPoints、行业维度的 marketState 写入与日志。

3.6.2 并购（v0.7）

收购 NPC 或其它业务组份额、估值公式、从市场移除 NPC 等，本文档只保留需求条目，不列入 v0.6 验收。

3.6.3 初创公司退出

长期目标：退出估值与行业总市场 × 目标份额挂钩。v0.6.4 可选「仍按景气+投资线性」的简化，待市场系统稳定后再接入全量（与第二部分讨论一致）。

3.7 营收与成本（行业维度的简化财报）

对单个业务组实体（或汇总到集团），在某行业 i：

• revenueWan = totalMarketSizeWan * playerShare * productFactor（productFactor 来自产品与专利等，与 v0.5 的乘子兼容）
• variableCostWan = revenueWan * variableCostRatio
• fixedCostWan 来自行业配置或业务组规模挡位
• netProfitWan = revenueWan - variableCostWan - fixedCostWan（税费留后续版本）

净利润反馈：

• 业务组：进入 fundingWan 与估值相关字段，并追加 financialHistory[]（建议保留最近 36 月摘要）。
• 房地产/初创：在对应模块中增加月度字段与历史。

3.8 市场规模与宏观联动

• 年增长率（或季度增长率）：growth_effective = growthRateBase * (1 + macroBonus)
• 示例：
  macroBonus = (g - 2%) * 0.5 + (行业景气系数 - 1) * 0.3
  行业景气系数由该行业对应宏观线 c 映射为 1.2 / 1.1 / 1.0 / 0.9 / 0.8。
• 增长节奏：建议季度重算目标 + 月内线性平滑，避免单月跳变过大（实现细节见代码注释）。

3.9 房地产区域份额

• 每项目绑定 regionId；完工后按投资额与区域总市场计算份额增量（有上限、玩家总份额有上限，如 20% 全国或分区域，可配）。
• 租金与资产增值可随区域份额与宏观调节（公式与 v0.5 中房地产实现对接时，以不破坏存档位优先）。

3.10 与现有文件的整合

4. 统一时间线与实现规划（v0.6.1～v0.6.4）

以下子版本号替代原「v0.5+1」时间线说法，按顺序交付；每子版本可独立回归。

并购与完整财报审计：v0.7+。
初创完全接入市场份额退出模型：可放在 v0.6.4 后 或 v0.7 初，以里程碑标记。

5. 数据结构与 JSON 配置汇总

5.1 新增/重大扩展文件

5.2 state.macro（示例字段）

5.3 行业 id 与宏观线映射（已订稿）

5.3.1 约定

• market-config.json 的 industries[].id 与 业务组 / 初创 的字段 industry 必须相同，且只能使用下列 8 个 canonical id（与 tables.js 中 INDUSTRIES 的 key 一致，小写英文）：
  • finance（金融）
  • realestate（地产）
  • tech（科技/互联网）
  • semiconductor（半导体）
  • consumer（消费电子）
  • medical（医疗）
  • energy（能源）
  • aerospace（航天/汽车）
• 每条行业在配置里另有 name（中文显示名），用于市场 UI；与上列 id 一一对应，不改变 id 本身。

5.3.2 8 行业 → 5 条宏观线（macroLineId）

宏观景气、市场规模 macroBonus、业务组 macroFactor 等，凡按「行业」取景气时，先用下表将 industry 解析为 macroLineId，再取 state.macro.lines[macroLineId].c（及对应的 baseBp 等）。
8 对 5 为多对一，属正常设计。

5.3.3 五条宏观线的 逻辑 id 与 UI 中文名

存储、存档、state.macro.lines 的 key、JSON 配置一律使用英文 macroLineId（与 stocks-futures.json 中已存在的 equity_composite / commodity_composite 命名风格一致）。
UI 中向玩家展示时，使用下表中文名，不得把英文 id 直接作为主标题（调试/G.M. 模式可显式 id）。

实现上可将上表收拢为 MACRO_LINE_LABELS[macroLineId] 或 macro-config.json 中的 lineDefinitions[]（含 id + displayName），单一数据源供月度报告、宏观页、提示文案复用。

5.4 存档版本

• SCHEMA_VERSION 递增。
• 旧存档读入：macro / market 缺省时用当前年月与 market-config 重算或安全默认（须写明规则防作弊差）。

6. 新增 UI 与反馈

6.1 月度报告

• 新增 「宏观经济」 小节或独立页：展示 r, π, g, m 及环比；五条宏观线的 c 或 base_bp、下月预测（展示用，可与结算独立种子，同现有 rollPredictedC 思路）。
• 五条线名称：界面使用中文（与 5.3.3 表一致，如「股市综合」「大宗商品」「房地产」「科技/互联网」「海外市场」），底层仍用 macroLineId 存取。
• 经济周期：当前阶段名称、已持续月数、（可选）下阶段概率说明。

6.2 市场与竞争

• 行业总市场规模、玩家份额、主要 NPC 份额条（不含 v0.7 并购操作）。
• 业务组详情：扩张点进度、距下次从「其他」夺份额的提示。

6.3 提示文案

• 如「高利率压制地产」「科技景气支撑研发回报」等，来源只读，避免与随机结算混淆。

6.4 与 index.html / main.js 的修改点

• 增加宏观页、市场页签或子面板；monthReport 数据源扩展。
• 所有展示数据以 state 与当月快照为准，不重新用未固定种子算一遍。

7. 与 v0.5 系统整合总表

8. 后续扩展（v0.7+）

• 并购：收购 NPC 份额、估值、反垄断叙事。
• 汇率、发债、更完整税费与年度财报审计。
• 玩家成为龙头后触发的行业大事件（与宏观分线）。
• 初创公司完全接入「目标份额 × 市场 × 估值」退出模型。

9. 版本历史

文档完成日期：2026-04-27（v0.6 首版，与实现无冲突时以代码为准）