后台服务与长期运行

让守护进程脱离终端和窗口运行，以及如何观察它是否真的一直在工作。

结构

用户级服务管理器（LaunchAgent / systemd --user）
  └─ 监督进程（含耐久观测）
       └─ 守护进程：项目协调器、前台会话
            └─ Rna SDK：模型请求、工具批次、MCP 看护进程

./rna service start
./rna service status
./rna service stop
./rna service uninstall

service start 安装并启动当前用户的服务，不需要管理员权限。关闭终端和聊天窗口不会停止工作。停止会写入持久的停止意图，后台工作被取消并限时关闭，不会被重启策略重新拉起。卸载只移除服务定义，项目、会话、记忆配置和证据都保留。

需要让服务同时托管本机的依赖（例如 Docker 兼容的 OpenViking relay）时，用 ./rna service restart --helper-descriptor PATH（可重复），--without-helpers 明确清空。用内置的本地记忆时不需要。

如果工作区在“文稿”目录下，而 Node 的后台访问尚未获准，原生服务可能卡在启动前。这时可以明确选择会话模式：

./rna service start --session
./rna service restart --native   # 权限获准后切回原生托管

会话模式下守护进程仍独立于窗口，出故障也会被监督进程恢复；但监督进程本身退出、注销或重启电脑后不会自动恢复。安装器不会修改隐私设置。

设置页保存的凭据文件可以被后台服务直接使用。如果提供商只引用 shell 环境变量，需要让后台服务的环境也能读到它；安装器不会把 shell 里的密钥复制进 plist。

./rna endurance start               # 按实际历史选择观察窗口
./rna endurance start --hours 120 --keep-awake
./rna endurance status
./rna endurance stop

观测每 5 秒检查一次服务，每分钟保留一条摘要，故障和实例变化立即记录。重启、休眠空档和时钟跳变都不算作连续健康。

--keep-awake 只在本次观测期间运行 caffeinate -i -s，防止空闲睡眠和接通电源时的系统睡眠，显示器仍可睡眠，不修改全局电源设置。合盖、主动睡眠、断电、注销或断网时，仍不能保证连续工作。

短时间的观测通过，不代表跨日的持续协作已经验收。观测报告把真实工作、空档和重启分开记录。