跳转至

版本发布

每个版本都在 GitHub 上打标签，核心库发布到 PyPI：

本站的 API 参考由公开仓库的 main 分支生成。

v0.2.0 — 2026-09-25

SocioVerse2 的首个公开版本。 发布说明 · PyPI 0.2.0 · SocioVerse-ABM v0.2.0 · 技术报告

包含什么

  • 运行时（socioverse）：固定人群（持久 id）在持续变化的环境中逐步行动，每一步为 每个 agent 在 DuckDB 里记录一行面板数据。干预（定时事件与定向广播）在指定步触发； 反事实分支精确重放父版本分叉前的步骤，只为分叉后的步骤付费。
  • 工作流 skill（Claude Code）：/sv-init、/sv-build-model、/sv-build-environment、 /sv-build-population、/sv-run、/sv-report、/sv-iterate，以及 /sv-lit 和 /sv-paper。Codex CLI 镜像（AGENTS.md、.codex/skills/）随附发布，属于实验性。
  • 本地研究仪表盘（dashboard/）：总览、环境、人群、数据、实验、文献、论文等页， 带版本与分支历史。
  • 参考研究：从零构建的模板（opinion_diffusion、campus_dining_choice）、真实数据 案例（germany_auto_market、consumer_confidence_us_backtest、hisim_roe）、对外部 ConsumerSim 管线的包装（consumer_confidence），以及对 SocioVerse-ABM 中 11 个经典 ABM 与 芝加哥隔离模型的包装。
  • 离线演示（scripts/demo_offline.py）：不用 API key 完整跑通一个研究；加 --llm openai 即可在任何 OpenAI 兼容端点上跑同一个研究。

快速上手

git clone https://github.com/sii-research/SocioVerse2.git
cd SocioVerse2
pip install -e ".[dev,viz]"
pytest -q
python scripts/demo_offline.py

详见安装。

需要知道的几点

  • pip install socioverse2 只安装核心库。工作流 skill、仪表盘和参考研究需要 git clone 获得。
  • 工作流 skill 需要一个有自己登录凭据的编程智能体（Claude Code，或实验性的 Codex CLI 路径）。SV_LLM_* key 只驱动模拟中的 agent，见 工作流 skill 由什么驱动。
  • 运行库（trajectory/、*.duckdb）不进仓库。参考研究带着产物和渲染好的报告； 想查询某个研究，先把它跑一遍。
  • hisim_roe 与 consumer_confidence_us_backtest 是导入型参考研究（标记为不可重跑）： 它们的序列分别来自技术报告和固定版本的 ConsumerSim 公开数据。
  • 本手册记录的药品集采案例不在开源仓库中。

v0.2.0 之后，main 上的改动

  • DecisionModel 的文档把调用方式写清楚了：decide_batch 一次接收整步；从零构建的 研究为每个 agent 各发一次 LLM 调用、并发执行；遗留适配器保留被包装引擎自己的调用方式。
  • /sv-init 派生研究时，会把标题、研究问题、假设和指标说明改写成你提问所用的语言， /sv-report 也用这个语言撰写报告。
  • /sv-run 只依据运行实际记录下来的内容报告 LLM 回退次数。
  • README 补上了 PyPI 徽章与安装说明。