【免费下载链接】cloudroom-coreOpen-source, self-hostable Rust runtime that runs Claude Code, Codex, and Pi in the cloud.项目地址https://gitcode.com/gh_mirrors/cl/cloudroom-core点击查看免费下载cloudroom-core 是一个开源、可自托管的 Rust 运行时让 Claude Code、Codex、Pi 等 AI 编程 Agent 运行在你自己的 Linux 机器上并持久保存它们的对话历史。本文将带你从零开始搭建环境、构建二进制、跑通cargo test与 Python E2E 测试套件最后了解如何以 Apache 2.0 许可证参与这个开源项目。 先认识仓库目录结构一眼看懂打开仓库你会看到清晰的三层结构目录职责src/Rust 核心API、运行时适配、会话管理、存储、可观测性tests/集成测试与 Python E2E 测试脚本docs/架构、部署、API 与存储等开发文档install/一键安装脚本与 systemd 服务配置几个值得先看的文件src/main.rs服务入口同时提供preview、secret、thread等 CLI 子命令src/api/mod.rsHTTP API 层src/runtime/mod.rsAgent 进程驱动src/runtime/claude.rs、src/runtime/codex.rs、src/runtime/pi.rs 分别对接各家 CLIsrc/session/mod.rs会话状态、队列与恢复逻辑docs/setup.md官方部署指南Ubuntu 24.04项目约定是「一个 Rust 包、一个服务应用集成全部走 API」见 AGENTS.md。️ 一键搭建开发环境环境需求很轻Rust 1.89Cargo.toml 中声明rust-version 1.89GitNode.js 24部分 harness 依赖需系统级安装到/usr/local/bin或/usr/bin不能只装在 nvm 里你想运行的Agent CLICodex、Pi 等克隆仓库git clone https://gitcode.com/gh_mirrors/cl/cloudroom-core cd cloudroom-core 构建二进制cargo build 快速上手两条核心命令来自 README.mdcargo build --locked --release cargo test --locked --all-targets小贴士始终保留--locked参数它强制使用 Cargo.lock 锁定的依赖版本避免依赖悄悄漂移导致构建不一致——这也是本项目 CI 的硬性要求。构建完成后优化产物位于target/release/cloudroom部署时会被安装到/usr/local/lib/cloudroom/cloudroom由 systemd 服务拉起细节见 docs/setup.md 与 install/cloudroom.service。✅ 跑通 cargo test理解测试分层项目的测试体系分为Rust 集成测试和Python E2E 测试两层。Rust 集成测试cargo test --all-targetscargo test --locked --all-targets会执行 tests/ 下的 Rust 测试。它们用「fixture 假 CLI」替代真实 Agent确定性极强测试文件覆盖内容tests/journal.rs持久日志未确认记录重启后仍能恢复tests/adapters.rsCodex / Pi 协议适配使用 tests/core_fixture.py、tests/pi_fixture.py 作为模拟 CLItests/runtime.rs运行时进程驱动与 stdio 边界tests/terminal.rs、tests/storage.rs终端与磁盘保护逻辑Python E2E 测试真实 HTTP 模拟网站tests/里还有一组 Python 脚本启动真实的 Rust 服务进行端到端验证tests/core_e2e.py核心 E2E用 tests/fake_api.py 模拟 Cloudroom 网站--fixture模式可在不产生真实推理的情况下检查 HTTP 与诊断只把选中账户的auth.json复制到一次性 Codex home绝不改动已有数据库和服务tests/core_fixture.py确定性的 Rust HTTP / Codex 协议检查无需推理和数据库tests/pi_e2e.py、tests/cursor_http.py针对 Pi / Cursor 的协议测试涉及真实推理的脚本需要已安装的 CLI 和有效凭证tests/storage_e2e.py磁盘安全测试只能以 root 身份在一次性 Linux VM 上运行sudo python3 tests/storage_e2e.py --disposable --mixed切勿在客户主机上执行官方验证清单摘自 docs/harnesses.mdpython3 tests/core_fixture.py python3 tests/pi_http.py python3 tests/cursor_http.py python3 tests/pi_e2e.py python3 tests/core_e2e.py --fixture⚠️注意本地测试全部通过只说明功能正常不代表部署就绪——Linux cgroup 磁盘保护和真实 PostgreSQL 上传有各自独立的验证路径见 tests/storage_e2e.py 的文档说明。 参与贡献三步验证 Apache 2.0提交改动前AGENTS.md 要求依次通过三道关卡cargo fmt --check cargo clippy --locked --all-targets -- -D warnings cargo test --locked --all-targets参与建议大改动先开 Issue 讨论再提交 Pull Request见 README.md保持约定一个 Rust 包、一个服务凭证与内部笔记只放在被忽略的文件里安全相关设计可参考 adr/0001-accept-privileged-core-service.md了解「有特权的 core 服务 无特权的 agent 用户」这一核心权衡项目为 pre-release 状态以Apache 2.0许可发布见 LICENSE更多深入阅读docs/api.md全部端点与错误码、docs/session-lifecycle.md会话恢复语义、docs/observability.md诊断、docs/storage.md磁盘策略。 现在你已经掌握了 cloudroom-core 的构建与测试全流程可以开始探索源码、修复问题并提交你的第一个 PR 了。赞分享【免费下载链接】cloudroom-coreOpen-source, self-hostable Rust runtime that runs Claude Code, Codex, and Pi in the cloud.项目地址https://gitcode.com/gh_mirrors/cl/cloudroom-core点击查看免费下载相关推荐composer/semver 与其他版本库对比为什么它是PHP开发者的首选composer/semver 与其他版本库对比为什么它是PHP开发者的首选 在PHP开发的世界中版本管理是一个看似简单却极其重要的环节。无论是依赖管理、ALangAlpha开发者入门从源码跑起来到跑通测试的完整贡献指南LangAlpha开发者入门从源码跑起来到跑通测试的完整贡献指南 本文为 LangAlpha 开发者入门 指南带你完成开源项目 LangAlphaClauKotatsu贡献者指南从入门到精通的开源参与完整流程想要成为Kotatsu开源漫画阅读器社区的一员吗 这篇终极指南将带你了解从代码提交到功能开发的完整流程帮助你快速融入这个活跃的开源项目Kotatsu是移动开发上一篇bruno-query 深度解析为 Bruno 响应体打造带深层导航、过滤与映射的 get 查询器下一篇MallChat抹茶颠覆传统电商的即时聊天系统完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
