安装
桌面版适合日常使用；从源码运行适合开发和调试。两种方式连接的是同一套守护进程。
下载
在 GitHub 的 Releases 页面 下载最新版本，这是获取安装包的首选方式。下面的按钮会自动取到最新版本的直接下载地址，并按你的系统标出推荐项：
正在获取最新版本…
每次发布的安装包都由发布流程从同一个标签构建，并在对应系统上启动过一次，SHA256SUMS.txt 列出了每个文件的校验和。
- macOS：应用是 ad-hoc 签名，没有 Apple 公证。拖进“应用程序”后，第一次请右键选择“打开”，或运行
xattr -dr com.apple.quarantine "/Applications/Rna Agent.app"。 - Windows（预览）：解压后运行
Rna Agent.exe。没有代码签名，首次运行 SmartScreen 会询问。后台服务在应用打开期间运行，暂不支持应用内更新。 - Linux（预览）：解压后运行
./"Rna Agent"。在限制非特权用户命名空间的发行版（Ubuntu 24.04 及以后）上，用--no-sandbox启动，或把chrome-sandbox设为 root 所有、权限4755。
系统要求
- 桌面版：macOS（Apple 芯片和 Intel）已支持；Windows x64 与 Linux x64 是预览版。
- 从源码运行需要 Node.js 22.19.0 或更高版本。Linux 可以运行 CLI 和守护进程，
systemd --user托管尚未在真实机器上验收。 - 一个模型服务的地址和密钥。记忆可以选内置的本地记忆，不需要任何外部服务；要用 OpenViking 语义记忆，需要另外用 Docker 部署它，见 记忆。
桌面版
安装应用
把下载的 DMG 中的 Rna Agent.app 拖进“应用程序”，然后打开（Windows 与 Linux 见上文）。应用自带 Node.js、npm、守护进程和网页资源，不需要另外安装 Node。
首次启动
应用会先寻找你已经安装过的 Rna 后台服务（local.rna-agent.* LaunchAgent），核对身份后直接连接，原有项目和会话都会出现。
没有现成服务时，应用在 ~/Library/Application Support/Rna Agent 下建立私有数据目录，用一个空闲的本机端口启动服务。端口记在同目录的 desktop-connection.json 里，不会占用开发用的 4317 端口。
关闭窗口不会停止后台工作，点 Dock 图标可以重新打开。退出应用只会停止应用自己启动的服务；连接的是外部服务时，退出不会影响它。
签名
当前安装包是 ad-hoc 签名，还没有 Developer ID 签名和 Apple 公证，应用只会检查发布记录里是否有新版本，不会自动下载安装，更新用命令行完成（见 更新与恢复）。首次打开时 macOS 可能要求你在“隐私与安全性”中确认。
从桌面版使用 CLI
应用菜单里可以复制 CLI 启动命令。复制的命令连到同一个服务，不需要再配置一遍模型密钥：
RNA_DESKTOP_DATA="$HOME/Library/Application Support/Rna Agent" "/Applications/Rna Agent.app/Contents/Resources/app/runtime/bin/rna" chat --workspace "$PWD"命令开头的 RNA_DESKTOP_DATA 指向桌面版的数据目录，让 CLI 找到同一个服务。
从源码运行
启动守护进程
cd prototypes/control-center
./rna start./rna 启动器会优先使用工作区内准备好的 Node 22，否则用 PATH 里的 Node，不改动系统环境。也可以用 RNA_AGENT_NODE=/绝对路径/node 指定。
构建工作台
守护进程只提供 web/dist 里的构建产物。第一次使用或改了界面源码后构建一次，刷新页面即可，无需重启守护进程：
cd prototypes/control-center/web
npm ci && npm run build没有构建时，API 和 CLI 照常可用，页面会显示构建说明。
打开工作台
浏览器访问 http://127.0.0.1:4317。默认只监听 127.0.0.1，面向本机单用户，不要直接暴露到公网。
让它在后台常驻
./rna start 是前台进程。要在关闭终端后继续工作，交给系统的用户级服务管理器：
./rna service start # macOS LaunchAgent / Linux systemd --user
./rna service status更多选项见 后台服务与长期运行。