Kalcode/spaceprojectsim

来源：https://github.com/Kalcode/spaceprojectsim

🚀 太空计划

一个自运行的太空经济模拟器，采用 Rust + Bevy 构建。

数百艘自主飞船在活跃的太阳系经济中交易、采矿、运输货物、承接合同、耗尽燃料，偶尔还会破产——市场自行定价，派系征税和补贴，人口在不满意时迁移，废弃的空间站会逐渐腐朽。这一切都运行在一个原生二进制文件中，无需运行时依赖。

许可证：MIT
Rust (https://www.rust-lang.org/)
Bevy 0.18 (https://bevyengine.org/)
平台支持
单二进制文件
进展状态

太空计划——内太阳系实时飞船轨迹

这是什么？

太空计划是一个代理驱动的经济模拟，包裹在原生 3D 客户端中。没有预设的故事情节，也没有玩家目标——你是一名观察者（以及上帝模式的管理员），观看经济自行运转。

每艘飞船都是一个自主代理，拥有自己的信用点、船员、燃料、货舱，以及一个决定下一步行动的 GOAP 规划器：追逐最高利润的贸易路线、接受运输合同、寻找船厂进行改装，或者在船员士气崩溃前停靠休息。

设施运行生产配方，会退化并自我修复，可以升级，破产时会被废弃。派系征收税款和发布补贴。人口消耗食物、产生劳动力，当情绪崩溃时会打包离开。市场通过覆盖模型和短缺紧急倍数对一切商品定价——没有任何固定价格。

该项目最初是一个 Elixir/Phoenix 原型，后来用 Rust 重写，因为 BEAM 调度器在 Windows 游戏电脑上表现不佳。引擎（sim_core）是纯同步、无 IO 的 Rust 代码；Bevy 客户端将其作为库直接嵌入，因此模拟和渲染器共享同一个 ECS 世界，零编组开销。

当前规模： 约 485 个活跃代理（282 艘飞船 · 93 个设施 · 27 个人口 · 8 个派系 · 60 个天体），在 125 毫秒预算内，p50 单次 tick 约 10–20 毫秒。架构设计目标是推至 10 万以上。

🌌 关于未来方向的说明

它本身不会去任何地方——而这正是重点所在。

这最初是一个有趣的想法：从头构建一个实际上能够自我模拟的太空经济，而不是伪装它。它远超我最初的预期，主要是在深夜与 Claude 的结对编程中完成。但我并不假装它是一个有路线图的游戏，也没有积极推动它走向“可发布状态”。

我以 MIT 许可证发布它，因为它的骨架确实不错，我宁愿有人用它做点什么，也不愿让它躺在私有仓库里。所以：fork 它、拆解它、重命名它、在上面搭建一个游戏、剥离经济引擎并在别处完全使用它。 去做我未完成的事。

PR 和 Issue 是欢迎的，我会查看，但无法承诺节奏。如果你想把它带向真正的方向，请看 CONTRIBUTING.md——里面有一个专门为你写的“你可以发展的方向”章节。

截图

标题画面——开始新宇宙或加载存档。
系统总览——太阳系及邻近星系的轨道环。
采矿群——翻滚的小行星、冶炼厂和飞船轨迹。
外层空间——以星云为背景的遥远小行星带和空间站。
实时检查器——派系账本、关系矩阵、完整合同面板。
事件流——市场危机、对接、交付，逐 tick 显示。

模拟内容

关于深入细节——tick 阶段顺序、AI 栈、经济反馈循环、运行时所有权——请参见 docs/ARCHITECTURE.md，其中包含所有内容的 mermaid 图。

快速开始

你需要 Rust 工具链 (https://rustup.rs/)（stable）。然后：

make run
# 等同于：cargo run -p client_bevy

这将启动 Bevy 应用进入主菜单。Start 打开一个新宇宙（命名它，或使用默认名称）；Load Game 列出二进制文件所在目录下的所有存档。存档以 .db 格式存储在二进制文件旁边——默认是 sim.db。

其他入口点：

一个二进制文件，一个进程。 client_bevy 就是全部——模拟在进程内运行。无头模式启动 HTTP/WebSocket 服务器（来自 sim_server 库 crate）供脚本和 CI 使用；没有独立的服务器二进制文件需要运行。

控制方式

每个面板实时读取 ECS 世界——检查器实际上是一个具有完整组件访问权限的实时调试器。点击一艘飞船可以看到它的信用点、船员、燃料、当前目标、配置、路线记忆以及最近几条 AI 命令。

架构

五个 crate 位于一个 Cargo 工作区中：

sim_core        纯模拟逻辑——hecs ECS、GOAP 规划器、经济、合同。无异步、无 IO、无框架。易于测试。
sim_db          SQLite 持久化（sqlx）——连接池、种子数据、ECS 加载器、持久化工作线程、迁移。
sim_server      库 crate——HTTP/WebSocket 处理器 + 引擎应用辅助。驱动无头模式；由客户端嵌入。
sim_protocol    WebSocket 线缆类型（仅无头模式 / CI 使用）。
client_bevy     二进制文件。Bevy 0.18 + egui。将 sim_core 作为 Bevy 资源嵌入；渲染器直接查询 hecs 世界。

三条规则确保诚实性：

1. sim_core 从不导入 tokio、sqlx 或 axum。 只有纯逻辑，因此整个模拟可以在没有异步的情况下进行推理和单元测试。
2. tick 期间 hecs 是真相来源。 tick 循环持有独占可变访问——没有每代理锁。
3. 跨实体效果通过命令缓冲区（SimCommand）实现。 一个阶段读取世界状态并写入命令；下一个阶段应用它们。确定性的，没有阶段内写入冲突。

完整的 tick 阶段顺序、所有权模型和反馈循环在 docs/ARCHITECTURE.md 中以图表形式展示。

原始的 Godot 客户端作为一致性参考存在于历史中，但它不再是前端——转向嵌入式 Bevy 客户端完全消除了套接字边界，并且每个新功能现在都在 client_bevy 中实现。

构建与打包

Makefile 封装了 cargo + rustup + codesign + 打包：

make build                 # 发布二进制文件（主机目标）
make build-mac             # arm64 macOS（也可用：build-mac-intel、build-mac-universal）
make build-win             # Windows MSVC（在 Windows 主机上运行）
make build-linux           # Linux（最好在 Linux 主机上）
make package-mac           # .app bundle + ad-hoc 签名 + Info.plist
make dmg                   # macOS .dmg
make package-win           # Windows .zip
make package-linux         # Linux .tar.gz

根目录 Cargo.toml 中的工作区版本是唯一真相来源——二进制文件通过 env!("CARGO_PKG_VERSION") 读取它，并且 Makefile 通过 grep 解析相同字段以用于 Info.plist 和存档名称，因此打包版本永远不会有偏差。

技术栈

• Rust (https://www.rust-lang.org/)（2021 版次）——整个项目
• Bevy 0.18 (https://bevyengine.org/)——渲染器、ECS 驱动的主循环、自定义 WGSL 着色器（程序化行星、太阳日冕、星云、星空）
• hecs (https://github.com/Ralith/hecs)——模拟自身的 ECS（有意与 Bevy 的 ECS 分离）
• egui (https://github.com/emilk/egui)（通过 bevy_egui）——所有检查器面板
• bevy_hanabi (https://github.com/djeedai/bevy_hanabi)——GPU 粒子轨迹和爆炸
• sqlx (https://github.com/launchbadge/sqlx) + SQLite——持久化，打包后无运行时依赖
• axum (https://github.com/tokio-rs/axum) + tokio——无头 HTTP/WebSocket 框架

贡献

欢迎贡献——请参见 CONTRIBUTING.md 了解开发设置、保持代码库整洁的约定，以及如果希望将这个项目带向真正方向的具体发展方向的列表。任何 PR 前最快的检查：

make verify   # 构建 + ~250 个测试 + clippy，严格模式

许可证

MIT © 2026 Kalcode (David Clausen)。你可以随意使用它。

为乐趣而构建，采用 Rust & Bevy · 由 Kalcode & Claude 制作 · 在伊利诺伊州用 ❤️ 打造