simulacra

类型化世界状态

列式表是唯一的真相源。agent、模块与提供者读取视图并产出效果；由一个解析器统一应用。

事件溯源

每次观察、决策、LLM 调用、效果与失败都是一条只追加的事件，带着自己的种子路径。回放就是一次折叠。同一场景、同一种子、同一摘要值。

录制的 LLM 调用

真实模型的输出逐字节录制与回放，审计重新分析时不再花费 token。

失败即数据

解析失败、被拒动作、截断输出、预算耗尽与熔断都是事件，每份结果里都有计数，从不静默兜底。

批量决策提供者

在同一人口里混用 LLM、规则、mock、代理模型、原型与缓存提供者；经 TopoSim 式的格元或 APS 式的自适应原型路由；每个提供者自己的审计数字都进入指标。

审计 harness

TRAILS 式的设计与表示扰动轴、带种子谱系的复制、Mann–Whitney U、Holm 校正、Cohen's d、bootstrap 区间、总变差距离、Wasserstein-1、Cliff's delta，以及对主张的证据等级。

三条命令

用确定性的 mock 提供者运行回音室示例：

bash

bun run simulacra run examples/echo_chamber/scenario.yaml --seed 7 --provider mock --out runs/echo

在人格格式、措辞框架与记忆表示三个方向上审计囚徒困境示例：

bash

bun run simulacra audit examples/prisoners_dilemma/audit.yaml --replications 5 --provider mock --out audits/pd

打开 GUI 查看刚刚产出的运行与审计：

bash

bun run simulacra serve --data .

换成真实模型：设好 SIMULACRA_LLM_API_KEY，去掉 --provider mock。任何 OpenAI 兼容端点都可以。默认是 DeepSeek，预设里关掉了思考，好让结构化回答装进不大的 token 预算；mlx-lm 与 LM Studio 的预设也只差一个参数。先跑一次 bun run simulacra doctor --llm，确认端点支持结构化输出、并发与缓存 token 上报。

两个示例都自带对 deepseek-v4-flash 的录制。加 --llm-mode replay 可以离线对着这些录制跑，加 --llm-mode record 则录制自己的。

simulacra能被审计的社会模拟

类型化世界状态

事件溯源

录制的 LLM 调用

失败即数据

批量决策提供者

审计 harness

三条命令

数字

在浏览器里

接下来

simulacra能被审计的社会模拟

类型化世界状态

事件溯源

录制的 LLM 调用

失败即数据

批量决策提供者

审计 harness

三条命令 ​

数字 ​

在浏览器里 ​

接下来 ​

三条命令

数字

在浏览器里

接下来