GOD 智能体社会控制室
为语言智能体社会提供可回放、可问询、可干预的本地控制台。
按维度查看评分与理由
证据显示：README 明确说明本地优先，模型端点唯一外部服务；SECURITY.md 提供漏洞报告流程；测试中验证了路径逃逸防护。扣分：未发现权限最小化设计（如沙箱），用户确认机制仅体现在设置向导，外部效果（如网络请求）未明确限制，回滚仅提供 new-run 命令，依赖安全未提供锁文件或漏洞扫描。
证据显示：README 与代码结构一致，测试覆盖关键模块，错误处理在测试中有体现。扣分：依赖可用性未验证（如外部服务），失败消息在文档中未充分说明。
证据显示：面向研究人员和开发者，提供多种场景和地图，能力边界在 README 中说明，触发方式明确（命令和 UI），环境适配良好（跨平台）。扣分：未提供详细的场景配置指南，能力边界未完全覆盖所有功能。
证据显示：信息架构清晰，安装说明详细，命名稳定，示例丰富，已知限制在 Roadmap 中列出，Apache-2.0 许可证，版本记录和变更日志存在，维护责任明确。扣分：无已知限制的专门文档，版本记录未包含所有细节。
证据显示：输出为可用的控制室界面，边际价值高（提供实时控制），成本效益合理（本地运行）。扣分：未提供性能基准或成本分析。
证据显示：README 中的声明与代码和测试一致，测试覆盖多个模块，事实与推断在文档中区分（如声明为原型）。扣分：部分声明（如“无代码设置”）未完全验证，测试未覆盖所有功能。
- 未发现权限最小化设计，建议审查代码中的文件访问和网络权限。
- 依赖安全未提供锁文件或漏洞扫描，建议检查依赖版本。
- 外部效果（如网络请求）未明确限制，建议确认模型端点配置。
这个 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.git
cd GOD
./scripts/god.sh startWindows 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 的定位是其上的本地操作与回放界面，重点在控制、观察和干预单次实验。
常见问题
使用 GOD 需要付费吗？
哪些数据会离开本机？
不配置 API key 能否体验？
如何重置一次失败或陈旧的运行？
./scripts/god.sh new-run，它会清除当前实验的本地运行状态并重新开始。