GOD 智能体社会控制室
为语言智能体社会提供可回放、可问询、可干预的本地控制台。
这个 Agent 能做什么，适合哪些场景？
GOD 是一个面向语言智能体社会模拟的本地优先控制室，名称取自 Govern、Observe、Direct。它由 React/Vite 浏览器控制室、本地 FastAPI 服务、像素城镇世界、回放存储和通过本地 WebSocket 连接的进程外智能体运行时组成。操作者可以逐步查看实时或已录制的回放，向单个居民、群组或全体居民提问，并把指令注入下一步。实验将地图、智能体、场景上下文和步骤计划组合在一起；回放则是实验运行后的可查看结果。项目还提供实验、地图和智能体包的 ZIP 导入导出，以及无需安装或 API 密钥即可浏览的 GitHub Pages 回放。
运行 ./scripts/god.sh start 会启动完整本地栈，并在首次运行时打开浏览器设置向导。向导接收 OpenAI 兼容端点的 API key、base URL 和模型名，随后可选择内置实验或创建自定义社会；选定实验写入 .god/current_experiment.json。控制室通过 Live API 获取更新，向进程外 Agent Runtime 发送提示，运行时返回行动，像素城镇将每步画面写入 Replay Store。操作者可使用回放步进、跳转和自动播放，并在地图内通过 /ask、/intervene 及 @Name #id 补全发送针对性指令；也可导入或导出 Experiment、Map 和 Agent 包。
- 研究人员在语言智能体社会运行过程中，需要逐步审阅居民行动，并测试一条下一步干预指令的影响。
- 教学或演示人员希望在浏览器中展示已录制的城镇模拟，而不要求观众安装软件或提供模型 API 密钥。
- 实验设计者需要通过设置向导生成场景、编辑居民资料和步骤计划，再发布为当前实验。
- 地图作者需要将 Tiled JSON 地图、PNG tileset 和 `Collisions` 图层封装到 `agentsociety/custom/maps/<map_id>/`，供向导自动发现。
- 本地运行者需要在模型、端口或实验配置变更后，用统一脚本重启、查看状态、跟踪日志或清空当前实验的运行状态。
这个 Agent 有哪些优点和局限？
- 将回放控制、定向问询、下一步干预和居民列表整合到同一张地图优先的操作界面。
- 本地优先运行：控制室、后端、运行时桥接、实验文件和回放存储均在本机，只有所选模型端点是外部服务。
- 支持 OpenAI 兼容 API，而不是限定某个单一模型服务商。
- 实验、地图和智能体包可 ZIP 导入导出，并提供可直接浏览的公开回放。
- 地图包自动发现且可验证，支持 Tiled JSON、PNG tileset 和 `Collisions` 图层。
- 要运行可交互模拟，仍需自行提供 OpenAI 兼容端点、API key、base URL 和模型名。
- 项目明确说明其用于检查语言智能体社会，并不主张模拟具有社会现实性。
- 当前仅支持一个活跃实验，`.god/current_experiment.json` 不提供多实验并行编排。
- 可插拔智能体运行时、多实验控制组与重复实验、跨运行评估仍列为未完成路线图。
- 运行状态包含本地 SQLite 回放库、日志和智能体快照，且不属于 ExperimentPack，迁移或复现时需另行处理。
如何安装或部署这个 Agent？
需要 Git、Python 3.11+、Node.js，以及一个 OpenAI 兼容模型端点。执行：git clone https://github.com/XiaoLuoLYG/GOD.gitcd GOD./scripts/god.sh start
Windows PowerShell 使用：./scripts/god.cmd start。首次启动会安装依赖并打开浏览器设置向导；填入 API key、base URL 和模型名，选择或创建实验后即可启动。
如何使用这个 Agent？
启动后，在浏览器设置向导中配置模型并选择 god_town、pku_trump_visit 或自定义实验。控制室 URL 的形式为 http://127.0.0.1:5174/pixel-replay/god_town/1。在控制室中按步骤暂停、跳转或自动播放回放；使用 /ask 向居民、群组或全镇提问，使用 /intervene 将指令注入下一步。常用运维命令包括 ./scripts/god.sh configure、restart、new-run、status、stop、tail 和 open。
这个 Agent 与同类方案有什么区别？
GOD 并非替代 AgentSociety 或 JiuwenClaw：项目捆绑了两者的精简上游检出，分别作为大规模生成式智能体模拟框架和进程外智能体运行时基础。GOD 的定位是其上的本地操作与回放界面，重点在控制、观察和干预单次实验。