castmap 0.0.1

商业沙盘推演引擎 (Business strategy wargaming engine) — placeholder release for name reservation. Real release coming Phase 1.

CastMap (推演图 / 演局)

One sentence: 商业沙盘推演引擎 — 给真公司, 把所有可能的剧本投射成一张可看的地图, 在沙盘上推一遍, 再决定走哪条路。

Status: Phase 0 (Architecture RFC + 关键决策对齐), 实施未启动 Started: 2026-05-23 Naming origin: cast (推演 / 演员阵容 / 投射) + map (地图) — 模仿 pinrule "两个简单常用英文真词" 模式, 经 10 轮 100+ 候选筛选 (见 docs/research/00-naming-history.md)

---

真目标

继承 MiroFish "种子文档 → 知识图谱 → 多 Agent 推演 → 报告" 闭环, 但定位升级为商业战略沙盘推演 + 决策辅助。客户是公司战略 / 投行 / 咨询 — 给的不是模糊预测, 是带审计链的可比较战略路径。

真客户故事

"你的战略不是一条预测线, 是一张 CastMap — 一百个剧本一次铺开看, 在沙盘上推一遍, 再决定走哪条路。"

三档运行参数 (按客户预算 / 时间)

档位	回合	Actor	Token 硬顶	墙钟目标
fast	8	20	1.2M	15-25 min
standard (默认)	14	24	3.5M	45-90 min
deep	24	40	8M	2-4 h

真目录结构

castmap/
├── README.md                         # 本文件
├── docs/
│   ├── architecture_rfc.md           # 主架构 RFC (Phase 0 交付)
│   ├── decisions/                    # 关键决策对齐文档
│   │   ├── 0001-oasis-true-delete.md
│   │   ├── 0002-calibration-day-1.md
│   │   ├── 0003-interactive-replay.md
│   │   └── 0004-industry-templates-product-line.md
│   └── research/                     # 前置研究归档 (10 个 sub-agent 跑出来的真证据)
│       ├── 00-naming-history.md      # 10 轮命名真过程
│       ├── 01-concordia-snowglobe.md # Game Master 架构对标
│       ├── 02-nexus-agentsociety.md  # 多 Agent 协作架构
│       ├── 03-hormuz-socioverse.md   # 参数化 + 用户对齐
│       ├── 04-oasis-yulan-phoring.md # 同路线项目深挖
│       ├── 05-decision-rationale.md  # LLM 决策可信度
│       ├── 06-stance-graph.md        # 事实图谱 → 立场图谱
│       └── 07-vitality.md            # 治 LLM 客气病
└── (后续 backend/ + frontend/ 等待 Phase 1)

真核心设计原则 (跟 MiroFish 的关键差异)

1. OASIS 真整包删除 — 自写轻量 L1 voice channel (5-7 动作 + Reddit hot score 5 行公式 + persona 强制 4:4:2 立场比 + 强制少数派 + 温度 ≥1.0)。详见 decisions/0001。
2. calibration 是 day-1 设计, 不是 milestone — market_model + calibration_engine 真同体, 不校准的 KPI 数字客户拿了就拍板 = 假仪表盘。详见 decisions/0002。
3. interactive replay 是产品核心, 不是 deep 档独享 — 暂停 + fork + replay 是从"看戏"到"决策辅助"的真分水岭。详见 decisions/0003。
4. 行业模板独立 product line — industry_template/ 第一版深度做电商 + agency 两套, generic 兜底; 真知识产权护城河。详见 decisions/0004。

真开源借鉴 (借而不依赖)

借鉴	来源	用法
Game Master + Components + Grounded Variables	Concordia (Google DeepMind)	架构骨, 自重写不依赖包
想定 → 推演 → 注入 → 复盘 四阶段 + advisor 旁挂	Snow Globe (IQTLabs)	流程魂 + 提示词模板
多角色多轮辩论 + 投票升级	Nexus	内部决策模板
Agent Group + Cognition-Needs-Emotion 三层心智	AgentSociety (清华)	长 horizon 性格连续性
三层混乱度 + SSE 流式推演	Hormuz	UI 体验
IPF 采样 + 真实分布对齐	SocioVerse (复旦)	calibration 的真做法
ODD 三段式漏斗 + AI Social Researcher	YuLan-OneSim (人大)	场景生成 + 报告自审
共识引擎 additive-only 验证	Phoring	多模型共识
L1 舆论信道 5-7 动作精简	OASIS (camel-ai)	仅借算法, 不依赖框架

真不做的

• 不做 1M agent 论文级规模 (商业客户用不到)
• 不做"开放式无目标仿真" (商业兵棋要有 Critical Questions)
• 不做"LLM 自评" (循环论证), 改双 model 跨厂商 judge + 第三方真数据对标
• 不做 SHAP/LIME 数值 ML 可解释 (对 LLM 决策不适用), 改 Counterfactual Sensitivity + Citation-Evidence Matrix

真下一步

Phase 0 交付:

• 命名 (CastMap, 10 轮筛选)
• 7 路前置研究归档
• architecture_rfc.md 主架构 RFC
• 4 个关键决策对齐文档

Phase 1 实施 (按多 Agent 协作 80x 速度, 估 2-3 周 vs 传统 12 周):

• M0 契约与骨架 (schema + 空引擎)
• M1 准备链 (gamebook + brief + stance graph)
• M2 推演内核 (decision_engine + market_model + calibration)
• M3 报告 + L1 voice (薄)
• M4 产品硬化 (UI + budget + interactive replay)
• M5 deep 档 + 校准

---

真精神 (按用户 pinrule):

• long-term-fundamental: 深挖根因, 不打补丁
• loud-failure-with-evidence: 完成必附测试证据
• no-testset-no-future-leakage: calibration 数据严格隔离
• chinese-plain-no-jargon: 中文沟通, 技术专名首次出现配解释