由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名
Atlas 5分钟快速开始
Atlas是编码代理的源代码控制系统，让你能够并行运行多个AI编码代理，跟踪它们的更改，并在一处查询它们的工作记录。
环境要求
支持的操作系统
运行环境
所需工具
编译和运行Rust项目
操作步骤
克隆并编译项目
从GitHub获取Atlas代码并编译可执行文件
git clone https://github.com/pacifio/atlas.gitcd atlascargo build --release预期结果：：编译完成后会在target/release/目录下生成atlas可执行文件
首次编译可能需要几分钟时间，取决于你的网络和机器性能
运行Atlas
启动Atlas应用程序
cargo run --release预期结果：：Atlas应用程序窗口打开，显示主界面
或者直接运行编译好的二进制文件：./target/release/atlas
创建或打开项目
在Atlas中打开一个代码项目
mkdir test-project && cd test-project && git initecho '# Test Project' > README.md && git add . && git commit -m 'Initial commit'atlas .预期结果：：Atlas界面显示新打开的项目，左侧有项目结构
也可以在Atlas界面中通过'Open Project'按钮打开现有项目
验证Atlas运行成功
确认Atlas已正确安装并能正常运行
快速提示
Atlas默认本地运行，不需要账户即可开始使用
使用@符号可以在对话中引用文件、文件夹或笔记
所有会话记录都保存在.atlas/sessions.db中，包括提示词和工具调用
可以同时运行多个AI编码代理，如Claude Code和Codex
知识库文件放在.atlas/knowledge/目录中，所有代理都能访问
常见问题
cargo build失败，提示缺少Rust工具链
运行rustup install stable安装最新稳定版Rust
应用程序无法打开，显示图形界面错误
确保系统安装了必要的图形库（Linux需要libgtk-3-dev）
打开项目时提示Git仓库未找到
确保目标文件夹已初始化为Git仓库（运行git init）
编译时间过长
使用cargo build --release -j4限制并行编译数量，或使用cargo build --release --features=smaller-binary减小编译大小
下一步
探索多代理功能
尝试运行不同的AI编码代理（如Claude Code和Codex）并比较它们的工作方式
查看检查点功能
进行几次代码提交，然后查看Atlas如何将提交链接回原始会话
设置知识库
在.atlas/knowledge/目录中添加Markdown笔记，让所有代理都能访问
尝试@提及功能
在对话中使用@符号引用文件、文件夹或之前的会话
加入社区
加入Discord社区获取帮助和分享经验：https://discord.gg/GmnFggaPfP
相关项目推荐
rustdesk/rustdesk
一款专为自建远程访问需求设计的开源远程桌面应用程序，可作为TeamViewer的替代方案。
rust-lang/rust
让每个人都能构建可靠高效的软件
tauri-apps/tauri
通过 Web 前端构建更小、更快、更安全的桌面与移动应用程序
denoland/deno
面向 JavaScript 与 TypeScript 的现代化运行时
oven-sh/bun
极速全能的JavaScript运行时、打包工具、测试运行器和包管理器——集于一身。
ruvnet/RuView
π RuView：WiFi DensePose 将商用 WiFi 信号转化为实时人体姿态估计、生命体征监测与存在检测——全程无需任何视频像素。