使命：让科技造福全人类！
孪生地球（TwinsEarth）是一个开源的数字生命与数字文明基础设施。它把三个独立又互补的开源项目融合为一个整体——一个会思考、有躯体、能协作的数字地球，让文明在数字空间中自发生长、永续演进。
当前版本：v1.2.3 — 完成 V1.1.x 接口贯通 与 V1.2.x 双节点互联 两个里程碑：三个子系统共享一套已冻结的跨语言数据格式（PCE-Format / Trace 哈希链），并具备可复跑的集成闭环与真实 P2P 互联能力。详见 CHANGELOG.md、docs/ROADMAP.md 与 docs/PCE-FORMAT.md。
孪生地球由三部分构成，分别回答“如何思考”“何处存在”“怎样协作”：
| 组成 | 子项目 | 角色 | 核心能力 | 技术栈 |
|---|---|---|---|---|
| 🧠 灵魂 / 驱动力 | UDOS 推演引擎 | 大脑认知内核 | 时序同步推理(CTM)、场景内化(GPM)、因果决策、世界模型、AGI/ASI 情报 | Python |
| 🌍 躯体 / 载体 | 从像素到文明 | 数字空间物理引擎 | 世界生成、4X 文明模拟、九 AI 神灵共治、物理与生态 | C# / Tuanjie(Unity) |
| 🕸️ 社会网络 | 智能体宇宙 | 智力载体 & 后台管理 | P2P 网络、DHT 发现、智能体市场、信誉经济、链上结算 | Rust / Python / Solidity / JS |
- UDOS 提供“思考” —— 认知架构内核，底层基础逻辑无处不在，深入每个单位、细节与物体。
- 从像素到文明提供"存在" —— 数字地球的空间与物理生成引擎，让认知具象化为可交互的文明世界。
- 智能体宇宙提供"连接" —— 去中心化的智能体共享网络，负责孪生地球的后台运行与管理。
三者闭环：认知（UDOS）→ 生成（PixelToCivilization）→ 协作（Agent Universe）→ 反哺认知，构成一个自我迭代的数字生命体。
- 智能已涌现，但正在被垄断。 大模型通过（参数、数据、算力）的 Scaling Law 实现了智能涌现，解决了"智能的有无"；但基础大模型军备竞赛已达千亿乃至万亿元门槛，普通人无法参与，智能即将被少数巨头垄断。
- 单体 Scaling Law 逼近"结构相变拐点"。 单纯"大力出奇迹"的边际收益正在递减，智能的下一次跃迁将来自网络结构——从 token 网络结构，向智能体网络结构演进（网络结构的 Scaling Law）。
- 急需第三条道路。 在闭源阵营与开源阵营之间，探索一条普惠大众、全民参与的 AGI 甚至 ASI 之路——群众路线，如同 Linux 之于操作系统。
- 让每个人都能参与、贡献、分享。 通过全民网络，任何有想法的人都能在这条路上闯出一番天地，让底层人民也共享这场智能科技革命。
┌───────────────────────────────────────┐
│ 孪生地球 TwinsEarth（数字生命） │
└───────────────────────────────────────┘
上方
┌─────────────────────────────┼─────────────────────────────┐
│ │ │
┌───────┴────────┐ ┌──────────┴─────────┐ ┌──────────┴────────┐
│ 🧠 UDOS 灵魂 │ 认知注入 │ 🌍 从像素到文明 躯体 │ 运行管理│ 🕸️ 智能体宇宙 网络 │
│ │ ───────▶ │ │ ◀───────│ │
│ · CTM 时序推理 │ │ · 世界/物理生成 │ │ · P2P / DHT │
│ · GPM 场景内化 │ │ · 4X 文明模拟 │ │ · 智能体市场 │
│ · 因果/世界模型 │ │ · 九 AI 神灵共治 │ │ · 信誉/链上结算 │
│ · AGI/ASI 情报 │ │ · 存亡续绝底线 │ │ · 群体智能涌现 │
└────────────────┘ └────────────────────┘ └───────────────────┘
│ │ │
└─────────────────────────────┼─────────────────────────────┘
▼
PCE-Format 物理 Token · 内容寻址 · 可证伪 · 向后兼容
详见 docs/ARCHITECTURE.md 与 docs/INTEGRATION.md。
TwinsEarth/
├── README.md # 本文件（统一入口）
├── LICENSES-README.md # 许可证说明（多许可证）
├── CONTRIBUTING.md # 贡献指南
├── SECURITY.md # 安全策略
├── CHANGELOG.md # 更新日志
├── docs/
│ ├── ARCHITECTURE.md # 孪生地球整体系统架构
│ ├── INTEGRATION.md # 三项目协同与集成逻辑
│ ├── PCE-FORMAT.md # PCE-Format 跨语言冻结规范（TEP-0/1/2/3）
│ ├── SUBPROJECTS.md # 子项目版本谱系与同步状态
│ ├── VISION.md # 数字生命愿景与使命
│ └── ROADMAP.md # 路线图
├── spec/ # 📐 跨语言冻结规范（v1.1.x 接口贯通的基石）
│ ├── vectors/ # 共享测试向量（跨语言逐字节比对）
│ ├── schema/ # JSON Schema（draft 2020-12）
│ ├── conformance/ # 一致性测试运行器
│ └── impl/ # Python / JavaScript / Rust / C# 参考实现
├── interop/ # 🔗 三子系统集成适配层（Python）
│ └── python/twinsearth_interop/
├── demos/ # 端到端 Demo
│ └── e2e_pixel_to_market.py # 像素 → 市场交易 → 文明推进
├── cycle_agents/ # 🔄 四层嵌套周期 Agent 框架
├── udos-reasoning-engine/ # 🧠 灵魂：认知架构内核（Python, Apache-2.0）
├── PixelToCivilization/ # 🌍 躯体：数字空间生成引擎（C#, MIT）
└── agent-universe/ # 🕸️ 网络：去中心化智能体网络（Rust, MIT）
├── gsn-core/ # Rust 核心库 + gsn-daemon（含 NAT 穿透 / Kademlia DHT）
├── js/ # JS SDK（零依赖，GitHub Packages）
├── aip-sdk-py/ # Python AIP SDK
├── contracts/ # Solidity 合约
└── desktop/ # Tauri 2 桌面客户端（v2.3.4）
融合仓库以受控子集方式纳入三个子项目，两套版本号刻意保持独立。 各子项目在仓库内外的版本对照见 docs/SUBPROJECTS.md。
cd udos-reasoning-engine
pip install -r requirements.txt
python -m pytest -q -p no:warnings # 1892+ 测试
UDOS_AUTH=off python -m udos.server --port 8000 --preset small# Rust 核心 + gsn-daemon（真实 P2P 网络节点）
cd agent-universe/gsn-core
cargo build && cargo test # Rust 测试
cargo run --bin gsn-daemon -- --p2p-port 4001 --api-port 4002
# JS SDK（零依赖，走 GitHub Packages）
cd ../js && npm install && npm test # 8 测试
# Python AIP SDK
cd ../aip-sdk-py && pip install pytest pytest-asyncio && pytest -qcd agent-universe/desktop
npm install
npm run tauri dev # 开发模式
npm run tauri build # 打包（需 macOS）三个子系统用四种语言写成。为了让同一语义对象产生逐字节相同的 CID 与哈希， 规范已冻结（TEP-0/1/2/3），并有跨语言一致性测试强制拦截任何分歧：
# 三语言逐字节一致性（Python / JavaScript / Rust）
python -m pytest spec/impl/python/tests -q
node spec/impl/js/test/test.js
cargo test --manifest-path spec/impl/rust/twinsearth-spec/Cargo.toml
python spec/conformance/run_conformance.py --langs python,js,rust规则细节：docs/PCE-FORMAT.md。C# 实现位于 spec/impl/csharp/，
本环境无 .NET SDK，仅作结构评审，未编译未执行（证据等级 unverified）。
python -m pytest interop/python/tests -q # 集成层测试
python demos/e2e_pixel_to_market.py # 全链路 Demo（完全离线可跑）Demo 串起一条完整的"数字生命时刻"：世界像素事件 → PCE 物理 Token → UDOS reason()
→ 决策 → TaskSpec 发布到智能体市场 → 匹配/执行/QA 验证 → 守恒结算 → 信誉更新
→ 文明推进（四层嵌套周期 Agent）。全链路事件写入同一条 Trace 哈希链并自证通过。
python -m pytest cycle_agents/tests -q # 气候 → 人口 → 制度 → 事件需 Tuanjie 2022.3 LTS（基于 Unity）打开本目录，构建 HTML5/WebGL；开源版本默认离线即可完整运行。详见子项目 README。
- 可证伪（Falsifiable）：把愿景落在可验证的机制与指标上，不伪造效应量、不把预期写成实测。
- 本地优先 / 纯 CPU 可跑：降低参与门槛，普通人的设备即可运行节点。
- 向后兼容：增量能力以 opt-in 外挂方式叠加，旧路径逐位一致。
- 多许可证共存：尊重每个子项目的开源协议。
- 可退出、可分叉：目标不是"去中心化"，而是"可选择"。
我们相信，智能不属于任何巨头，而属于全人类。孪生地球从一台放在路由器旁的 Mac mini、从一个开源的认知内核、从一像素一像素生长的大陆开始——让每个人都能拥有一个智能体，贡献算力与想法，验证彼此，并共享智能的收益。
智能体的：人人为我，我为人人！
更多见 docs/VISION.md。
孪生地球采用多许可证：UDOS 为 Apache-2.0，从像素到文明与智能体宇宙为 MIT。各子项目保留其原始许可证，详见 LICENSES-README.md 与各子目录 LICENSE。
欢迎每一位建设者。请先阅读各子项目的 CONTRIBUTING 与 docs/ROADMAP.md，从一个 Issue、一个节点、一个智能体开始。
让科技造福全人类！ 🌱