用于观察 AI 居民独立工作、通信和委托的本地实验台。当前是可运行的模块化原型。
需要 Python 3.11 或更新版本;当前版本只使用标准库,无需安装依赖。
在本项目目录运行:
python3 -m atlantis serve --port 8765打开 http://127.0.0.1:8765 。新建实验,再点击“启动实验”;后台控制器持续调度,关闭浏览器不会停止实验。使用 Ctrl+C 停止服务,重启后未结束的实验保持暂停。
命令行也能运行和检查:
python3 -m atlantis run --mode demo --agents 2
python3 -m atlantis run --mode live --agents 1 --max-calls 8
python3 -m atlantis list
python3 -m atlantis inspect RUN_ID
python3 -m unittest discover -s tests -v修改前端时另运行 node --test tests/test_web.cjs(需要 Node.js 22 或更新版本),验证费用汇总、动作结果和行为摘要。
运行数据保存在 .atlantis/city.db,已排除在 Git 之外。使用 python3 -m atlantis --db OTHER_PATH serve 可以隔离数据。
| 方式 | 作用 | 能证明什么 |
|---|---|---|
| demo | 本地脚本安排一次协作与结算 | 验证模块接口和完整流程 |
| live | 真实模型根据相同规则自主决策 | 观察这次运行的行为和交付;需要独立重复实验才能比较效果 |
真实模型通过 .env 或环境变量配置 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。当前适配器使用现有网关的 Messages 流式协议。配置只在服务端读取,页面和居民观察中没有密钥。.env 已在 .gitignore 中。
原型第一种工作是对公开数字列表产生 count、sum、min、max 的 JSON 成果。工作工具仅支持有限的统计计算;没有任意代码执行、外部收款或任意文件访问。
首个代码修复候选任务包见 benchmarks/csv_ledger_v1/README.md,本地工作单见 docs/issues/001-csv-repair-task.md。包内包含需求、初始项目、公开测试、独立用例与参考修复;尚未接入居民运行工具。运行 python3 -B benchmarks/csv_ledger_v1/verify.py 可验证材料及评分器。
顶层只有三个模块,分别对应用户、系统和个体:
| 模块 | 职责 |
|---|---|
| Client(客户端) | 用户配置、启停、观察和比较运行 |
| City(城市) | 系统管理规则、通信、任务、账户和成果,并负责调度、执行、评测和存储 |
| Resident(居民) | 个体根据获准观察调用模型,返回自主决定的行动意图 |
Client 向 City 提交操作并读取结果。City 调用 Resident 的决策接口,再按规则处理返回的意图。群聊、私聊、委托和资金变化都经过 City。
三个模块的当前代码对应关系见 design.md 第 3 节。接口与失败行为见 docs/contracts.md。临时实现选择见 docs/implementation.md。详细规则中的待讨论部分继续保留草案状态。
- 支持 1 或 2 名居民、公共群、私聊、付费委托、成果、付款和独立评分。
- 原型按每次模型或工具尝试 1 credit 扣除内部费用;这是可配置的临时计价。托管与调用预留不会重复花费。
- 调用次数、单次输出和观察大小有上限。真实供应商货币费用尚未核实,显示“待确认”;调用次数上限不等于货币预算上限。
- 演示的合作是预先编排的。真实模式没有预设领导、分工或合作要求。
- 进程中断时,已发出但结果未知的调用会保留预留并阻止自动重放;当前需要人工核查。没有自动对账和异常调用恢复界面。
- 尚未实现通用超时、返工与退款策略;主任务评分失败时保留任务及托管资金供检查。M1 的完整费用核实和 M3 的对照实验尚未完成。
代码已提交并推送到 GitHub 仓库。仓库包含模块 Issue 模板、PR 模板和自动测试工作流。
每项工作按 Issue → 分支 → PR → 自动测试 → 合并推进。Issue 说明行为、接口和验收条件;PR 展示具体修改,自动测试检查回归。
本次架构文档整理的本地工作单见 docs/issues/client-city-resident.md,可作为第一次完整开发流程的练习。