把战略决策变成可计算、可复现、可优化的实验。
StrategyForge 是一款本地优先的多智能体战略推演工具。以一段种子材料（文本/文档）为输入，自动构建知识图谱、生成智能体人格，按"决策 → 数值计算 → 反馈 → 客观判胜负"闭环并行推演多轮，支持蒙特卡洛策略择优。以 Python 后端 + Tauri 桌面应用 形态交付，可打包为独立安装包离线运行。
| 模式 | 决策引擎 | 胜负判定 | 适用场景 |
|---|---|---|---|
| 量化模式 | 规则包驱动 + FSM + LLM 分层决策 | 阈值淘汰 / 加权综合判负 | 军事、商业、政治对抗 |
| 叙事模式 | LLM 自由推理 + 人格演化 | 收敛裁判 + 因果链收束 | 趋势探索、创意推演 |
私有/秘密事件通过 _is_event_visible_to() 可见性判定分发，非参与者不可见。信任度驱动情报延迟（最多 4 轮）与失真（最多 30%）。Kuzu 图谱事件存储 visibility 标签，报告和快照均过滤私有事件。
geo_strategy 通过 inherited_from 自动继承 7 个子域的 metrics / actions / effects，消除重复配置。
Phase 1: 本体生成 LLM 提取实体/关系类型定义
Phase 1.5: 量化加载 领域检测 → 规则包加载 → 种子指标 LLM 提取
Phase 2: GraphRAG jieba 分词 → 语义分块 → LanceDB 索引 → 图谱构建 → 情报整理
Phase 3: 智能体工厂 EntityRegistry 实体注册 → Agent Factory 人设生成
Phase 4: 并行模拟 每轮：FSM 分流 → 并发 LLM → 批量结算 → 算法模块链 → 人格反思
Phase 5: 报告生成 量化/叙事双模式，弧线事件采样 + 因果归因
1. FSM 分流：非命令态 agent 走确定性动作（0 LLM）
2. 并发 LLM：命令态 agent asyncio.gather 并行决策
3. 关系精判（Layer C）：首次开局 neutral 关系判定
4. resolve_round：批量计算 self / target / conditional / delay effects
5. 算法模块链：opinion_dynamics → ODE → physics → auto_effects
6. 声誉更新 + 情报传播（信任度驱动延迟/失真）
7. _should_reflect 闸门：条件满足 → LLM 生成 ≤20 字人格准则
build_registry()
│
┌─────────────┼─────────────┐
▼ ▼ ▼
Layer 1 Layer 2 Layer 3
(归一化) (分级判定) (交叉裁决)
│ │ │
▼ ▼ ▼
快速/分片路径 10 实体批量 哈希缓存
LLM 归一化 Parallel LLM 别名预合并
│ │ LLM 冗余检测
│ │ │
└──────┬──────┴──────┬──────┘
▼ ▼
SemanticMediator DomainAdapter
(7 大类基础类型) (YAML 配置注入)
- 快速路径（短文本）：单次 LLM 全量归一化，>15 实体自动拆批并行
- 分片路径（长文本）：滑动分片 → 保守归一化 → 代码内存合并（Jaccard 相似度）→ LLM 全局精修
- 10 实体一批并行 LLM
- 注入基础类型 + 域专属规则（DomainAdapter YAML）
- 失败批次自动拆为单实体重试
- LLM 不可用时回退基础类型兜底规则
- LLM 全局冗余检测：降级重叠实体，合并同义变体
- 代码层别名词典预合并减少 LLM 输入
- 可配置跳过（
skip_layer3: true）
| 基础类型 | 含义 |
|---|---|
| Agent | 独立决策主体（国家/企业/政权） |
| Subordinate | 附属参与者（官员/子公司/部门） |
| Resource | 资源/工具/物资 |
| Geography | 地理空间/城市/区域 |
| Contract | 合约/条约/协议 |
| Event | 事件/冲突/项目 |
| Concept | 抽象概念/政策/数据 |
内置 13 个适配器（data/domain_adapters/*.yaml）：geo_strategy business military politics novel narrative history ecology urban tech info_war business_narrative universal_neutral。每个 YAML 包含域元信息、参数阈值、基础类型映射、tier 规则、Layer 配置、LLM Prompt 片段、别名词典和白名单。新增领域只需新建 YAML，无需修改 Python 代码。
8 类方程：decay / logistic / fatigue_recovery / supply_consumption / pollution_spread / resource_depletion / competitive_logistic / cash_flow_dynamics。scipy RK45 自适应步长，降级 Euler 冻结态。
刚体力学（重力、阻尼）、空间哈希碰撞检测（N > 150 时 O(N)）、各向同性高斯扩散、径向冲击波。
Hegselmann-Krause 有界置信模型，每域可配 epsilon。
每域专用状态循环。支持历史趋势条件、虚拟空间度量、对手指标感知、FSM override。非命令态 agent 由 FSM 确定性驱动。
| 域 | 指标数 | 特性 |
|---|---|---|
| military | 5 | 空间战斗、distance_to_enemy FSM |
| business | 6 | 品牌竞争、供应链保护 |
| politics | 6 | 支持率竞争、立法博弈 |
| tech | 5 | tech_lead + talent_pool 双竞争 |
| info_war | 4 | public_trust + polarization 双竞争 |
| ecology | 6 | 碳排放、污染治理 |
| urban | 7 | 土地规划、交通设施 |
| geo_strategy | 28 | 7 域继承 + 跨域复合 + delay_effects |
支持用户通过 Web UI 上传自定义规则包 JSON。
StrategyForge 采用一阶反思机制：agent 的行为准则（personality rules）随推演进行动态演化，写入 system_prompt_extra 注入后续每轮决策。
共享 6 维度判定，任一满足即触发：
| 维度 | 条件 | 可配参数 |
|---|---|---|
| 环境剧变 | 单个变量变化 > 5 | env_drift_single |
| 环境累积 | 全部变量绝对变化和 > 12 | env_drift_cumulative |
| 关系变化 | 盟友/对手集合变动（R1 豁免） | — |
| 长期无反思 | 距上次反思 > 4 轮 | no_reflect_rounds |
| 内源自省 | 每 5 轮定期自省 | self_reflect_interval |
| 模式预警 | 同类事件累计 ≥ 8 | pattern_warn_count |
LLM 生成 ≤20 字新行为准则 → 追加到 system_prompt_extra → FIFO 保留上限条。已内置去重：字符集 Jaccard 相似度 > 0.7 的准则自动跳过。
回溯悔悟（_retrospect_regret）每 5 轮清理过时准则。冲动准则修正（_correct_impulse_rule）纠正矛盾准则。
蒙特卡洛多方案对比：
- 用户定义多个候选策略方案
- 每方案运行 N 次独立模拟（随机种子 + 温度抖动）
- 量化模式
RuleEngine.judge()客观判胜负 - 统计分析：成功率 / 胜率 / CI95 / 成本
- 帕累托前沿推荐最优方案
| 存储引擎 | 用途 |
|---|---|
| Kuzu (嵌入式图数据库) | 实体节点、关系边、事件序列、因果归因 |
| LanceDB (向量数据库) | 语义分块索引、事件记忆（含可见性） |
| SQLite | 会话持久化、日志、Token 统计、报告 |
- Python ≥ 3.11
- Node.js ≥ 20
- Rust 工具链（仅打包需要）
pip install -e .
python run.py
# 访问 http://localhost:5173详见 AGENTS.md 完整打包流程。
| 变量 | 默认值 | 说明 |
|---|---|---|
FORGE_PROVIDER |
lmstudio |
LLM 提供商 |
FORGE_LLM_BASE |
http://127.0.0.1:1234/v1 |
LLM API 地址 |
FORGE_LLM_MODEL |
— | LLM 模型名 |
FORGE_EMBED_MODEL |
text-embedding-embeddinggemma-300m-qat |
嵌入模型 |
FORGE_MAX_CONCURRENT |
2 |
并发 LLM 上限 |
FORGE_DEFAULT_ROUNDS |
10 |
默认推演轮数 |
FORGE_RETRIEVE_TOP_K |
5 |
语义检索返回数 |
FORGE_REPORT_MAX_TOKENS |
30000 |
报告输出上限 |
FORGE_RULE_DIR |
— | 规则包目录（打包时用） |
所有端点前缀 /api/forge。
| 端点 | 方法 | 说明 |
|---|---|---|
/upload |
POST | 上传源文档 |
/session |
POST | 创建会话 |
/sessions |
GET | 会话列表 |
/session/{id} |
GET / DELETE | 会话详情 / 删除 |
/session/{id}/start |
POST | 启动推演 |
/session/{id}/pause |
POST | 暂停推演 |
/session/{id}/resume |
POST | 恢复推演 |
/session/{id}/intervene |
POST | 用户干预注入 |
/session/{id}/pre-goal |
POST | 推演目标注入 |
/session/{id}/fsm-override |
POST | FSM 强制动作 |
/session/{id}/settings |
POST | 会话设置 |
/session/{id}/graph |
GET | 知识图谱数据 |
/session/{id}/timeline |
GET | 行动时序 |
/session/{id}/causal |
GET | 因果子图 |
/session/{id}/report |
GET | 推演报告 |
/session/{id}/logs |
GET | 推演日志 |
/session/{id}/tokens |
GET | Token 统计 |
/session/{id}/stream |
GET | SSE 事件流 |
/session/{id}/optimize |
POST | 策略优化 |
/session/{id}/optimize/result |
GET | 优化结果 |
/session/{id}/optimize/cancel |
POST | 取消优化 |
/domains |
GET | 可用领域列表 |
/rules/upload |
POST | 上传自定义规则包 |
/config/llm |
GET / POST | LLM 配置 |
/config/embedding |
GET / POST | 嵌入配置 |
/config/engine |
GET / POST | 引擎参数配置 |
/config/providers |
GET | 提供商列表 |
/config/list-models |
POST | 列出可用模型 |
/config/test-connection |
POST | 测试连接 |
src/strategy_forge/
├── core/ 配置、LLM 客户端、Token 计数、语义分块
├── storage/ 会话存储 (SQLite)、图谱存储 (Kuzu)
├── api/ FastAPI 路由 + SSE 事件流
├── engine/ 引擎核心
│ ├── orchestrator.py 五阶段流水线协调器
│ ├── simulator.py 模拟引擎（反思、事件分发、运算结算）
│ ├── entity_registry.py 实体注册中心 (L1/L2/L3 + SemanticMediator)
│ ├── domain_adapter.py 统一 YAML 领域适配器
│ ├── semantic_mediator.py 7 大类基础类型映射
│ ├── domain_detector.py 自动域探测
│ ├── agent_factory.py 智能体人设生成
│ ├── rule_engine.py 量化规则引擎
│ ├── reporter.py 报告生成
│ ├── optimizer.py 策略优化器
│ ├── preprocessor.py 语义分块 + 实体提取 + LanceDB
│ ├── graph_builder.py 图谱构建
│ ├── seed_extractor.py 种子指标提取
│ ├── strategic_reasoner.py 战略推理
│ ├── relation_polarity.py 关系极性映射
│ ├── narrative_actions.py 事件动作工具
│ ├── intel_sorter.py 情报整理
│ ├── narrative_sorter.py 叙事整理
│ ├── ontology.py 本体建模
│ └── models.py 数据模型
└── algorithms/ 算法模块
├── fsm_module.py 有限状态机
├── ode_module.py ODE 微分方程
├── opinion_dynamics.py 观点动力学
├── physics_module.py 物理引擎
└── pipeline_engine.py 算法链调度
data/
├── rule/ 规则包 rules.json（8 域）
├── domain_adapters/ 领域适配器 YAML（13 个域）
└── methodology.yaml 方法论配置
apps/strategy-forge/ Tauri 桌面应用（React + TypeScript + Vite）
tests/ 测试