Rna Agent
使用指南

CLI 参考

rna 命令与工作台连着同一个守护进程。常用命令按用途分组。

CLI 默认连接 127.0.0.1:4317,用 RNA_AGENT_PORT 选择其他端口。./rna help 给出常用命令,./rna help all 列出全部命令,./rna help chat 只看交互聊天。

帮助、用法提示和错误信息跟随界面语言:界面设为英文时输出英文;设为中文,或守护进程没有运行时,输出中文。

守护进程与服务

./rna start                     # 前台启动守护进程
./rna service start             # 交给 LaunchAgent / systemd --user
./rna service status
./rna service restart --native  # 应用配置变化或切回原生托管
./rna service stop
./rna service uninstall         # 只移除服务定义,保留所有数据
./rna doctor PROJECT_ID         # 检查后台服务、模型配置、记忆连接和近 7 天的使用与进化状态
./rna status                    # 守护进程版本与状态

项目

./rna projects
./rna project-new "名称" "目的和验收期待" --workspace /absolute/path
./rna project-open /absolute/path
./rna project PROJECT_ID
./rna project-init PROJECT_ID   # 重试初始化
./rna permissions PROJECT_ID
./rna permissions-set PROJECT_ID --workspace write --background read
./rna sources PROJECT_ID        # 目录观察来源(只读)
./rna source PROJECT_ID workspace pause   # 只暂停变化采集,聊天和日程继续
./rna files PROJECT_ID [相对目录]
./rna file PROJECT_ID 相对/文件路径
./rna preview PROJECT_ID start 相对/index.html

会话

./rna sessions
./rna new "标题" --project PROJECT_ID
./rna chat SESSION_ID
./rna chat --workspace "$PWD"   # 打开或复用该目录的项目与会话
./rna run SESSION_ID "读取项目入口并解释结构" --jsonl --timeout 300
./rna watch SESSION_ID --jsonl
./rna interrupt SESSION_ID
./rna retry SESSION_ID          # 重试最后一次失败的真实轮次

chat、watch、run 通过 SSE 订阅,不轮询。run 只等待自己提交的那一轮;失败、停止或超时以非零状态退出。超时和退出订阅都不会停止守护进程里的工作,需要停止时用 interrupt。

断线后自动重连,退避从 300 ms 增加到最多 10 秒,恢复订阅不会重新提交消息或重放工具。

其他会话命令:history、send、steer、followup、withdraw、pause、resume、status、events、budget、attach、export、compact、plan、commands。stop 和 reset 是全局急停与解除,解除后需要显式恢复暂停的工作。

Agent 向你提问(选择题、确认)时,可以在终端里回答:

./rna questions SESSION_ID
./rna answer SESSION_ID INTERACTION_ID --answers-file answers.json
./rna cancel-question SESSION_ID INTERACTION_ID

结果不明确、需要人工核对的工具调用用 recovery SESSION_ID 查看,核对后用 recovery SESSION_ID resolve CALL_KEY completed|not-executed|abandoned "说明" 记录。核对本身不会重放任何操作。

会话内命令

在 chat 里输入 /help 看全部命令,Tab 补全。常用的有:

/status               当前轮次、模型、队列与恢复状态
/model                列出模型;/model <供应商ID> <模型ID> [推理档位] 切换
/steer <文字>         在下一个安全边界影响当前一轮
/followup <文字>      排到下一轮
/withdraw MESSAGE_ID  撤回还在队列中的消息
/attach <路径>        添加附件,随下一条消息发送
/attachments /detach <序号> /send   管理待发附件
/initiative on|off|mute|unmute|quiet|resume
/background           查看后台行动;pause|resume|stop|steer|retry 控制指定行动
/goal [文字]          查看或更新项目关注
/feedback <文字>      保存项目反馈
/inbox                收件箱
/versions             项目版本
/project /sources     当前项目与目录观察
/mode plan|build      只读计划模式或执行模式
/compact              整理较早上下文
/permission [read|write|execute]
/export <ZIP路径>     导出脱敏聊天记录
/pause /resume /retry
/recovery             查看待核对的操作
/stop                 停止当前一轮
/quit                 只退出 CLI,会话和后台工作继续

连续粘贴的多行会按顺序提交。在交互式终端里打字时,主动消息会等你停顿,并保留当前草稿。

模型与联网

./rna config                    # 脱敏后的配置
./rna providers                 # 模型目录
./rna provider-add --file /path/to/provider.json
./rna provider-test PROVIDER_ID
./rna provider-auth start PROVIDER_ID --method browser --wait   # ChatGPT 订阅登录
./rna model-default PROVIDER_ID MODEL_ID high
./rna model-set SESSION_ID PROVIDER_ID MODEL_ID high
./rna web-config --enabled true --provider firecrawl
./rna web-test

web-config 选择搜索服务(fastcrw、firecrawl、tavily、brave、zhipu、bocha),密钥不接受命令行明文,用环境变量名或设置界面。换服务时改用新服务的地址,原来的密钥不会带过去。详见 配置与环境变量。

主动协作与后台工作

./rna initiative PROJECT_ID on|off|mute|unmute|quiet|resume
./rna frequency PROJECT_ID active|balanced|quiet
./rna background PROJECT_ID
./rna background PROJECT_ID pause ACTION_ID
./rna background PROJECT_ID steer ACTION_ID --text '优先核对官方来源'
./rna schedule PROJECT_ID list
./rna mind PROJECT_ID           # 项目心智:经验、议程、承诺、笔记

mute 暂停主动发言和定时任务,quiet 暂停主动发言 30 分钟,resume 解除。含义见 主动协作。

进化与判断

./rna versions PROJECT_ID
./rna version PROJECT_ID VERSION_ID
./rna evolution failures PROJECT_ID
./rna judge status              # JEV 配置、耗时、用量
./rna judge calibration --window 7d

能力

./rna capabilities
./rna project-capabilities PROJECT_ID
./rna capability-inspect PROJECT_ID /absolute/install.json
./rna capability-install PROJECT_ID /absolute/install.json
./rna capability-assign PROJECT_ID /absolute/assign.json
./rna capability-remove PROJECT_ID /absolute/remove.json
./rna marketplace search "关键词" --provider skills-sh --limit 5

记忆、维护与恢复

./rna memory-config --backend embedded
./rna memory PROJECT_ID health|initialize|list|browse|search|read|write
./rna maintenance status
./rna maintenance backup
./rna recovery status
./rna endurance start --keep-awake

memory-config 的参数见 记忆,维护与恢复见 更新与恢复。

本页内容