Metadata-Version: 2.4
Name: castmap
Version: 0.0.1
Summary: 商业沙盘推演引擎 (Business strategy wargaming engine) — placeholder release for name reservation. Real release coming Phase 1.
Author-email: jhz <boxgugu1211@gmail.com>
License: MIT
Keywords: wargaming,business-strategy,multi-agent,simulation
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 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 交付:
- [x] 命名 (CastMap, 10 轮筛选)
- [x] 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: 中文沟通, 技术专名首次出现配解释
