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 的关键差异)
- OASIS 真整包删除 — 自写轻量 L1 voice channel (5-7 动作 + Reddit hot score 5 行公式 + persona 强制 4:4:2 立场比 + 强制少数派 + 温度 ≥1.0)。详见
decisions/0001。 - calibration 是 day-1 设计, 不是 milestone —
market_model+calibration_engine真同体, 不校准的 KPI 数字客户拿了就拍板 = 假仪表盘。详见decisions/0002。 - interactive replay 是产品核心, 不是 deep 档独享 — 暂停 + fork + replay 是从"看戏"到"决策辅助"的真分水岭。详见
decisions/0003。 - 行业模板独立 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: 中文沟通, 技术专名首次出现配解释
Metadata
Release files for castmap 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| castmap-0.0.1.tar.gz | 5.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| castmap-0.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.3 kB
Release files / castmap-0.0.1.tar.gz
| Download URL | castmap-0.0.1.tar.gz |
|---|---|
| Size | 5.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
982a2026e900adf18d87557b4a789e1989d1f593912e303f7122ee1c9a3ad50b
|
|
BLAKE2b-256 checksum How to use checksums |
b3bdc27cc61705412a0ce3b433e2d8b6a4d791194e4f94a124b1c7102149ad03
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / castmap-0.0.1-py3-none-any.whl
| Download URL | castmap-0.0.1-py3-none-any.whl |
|---|---|
| Size | 5.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
11b2ed6dbfe74508f75b9f993507ccc30a6671070531721aabb3788f54c5675b
|
|
BLAKE2b-256 checksum How to use checksums |
1aab2879aed0731f796dc3967bd654588f4795a1bf5fb807c3c20109539c77fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|