部署轨道

Jarvis 通过多条独立轨道触达用户。每条轨道都有不同触发方式、验证点、回滚方式和影响面。

轨道总览

轨道	发布内容	主要用户	上线方式	第一验证
本地或自托管服务	FastAPI 后端和构建后的 Web 前端	开发者、自托管用户	拉取或部署源码，构建后重启或 reload	健康检查返回预期版本
公开 Web 与文档	公开页面、移动 Web 入口、`/doc` 文档	浏览器访问用户	站点构建和托管平台部署	站点测试通过，关键路由可加载
远程访问隧道	认证后的本地 Jarvis 反向访问	手机和远程客户端	用户在本地实例启用远程访问	API、SSE、WebSocket 能到达本地后端
安装包与更新器	桌面安装包、移动包、updater metadata	已安装 App 用户	维护者批准的 release workflow 上传产物	新安装和更新检查通过

适合从源码运行或维护私有实例。后端提供 API，也可以服务构建后的前端。

./restart.sh
curl http://127.0.0.1:8888/api/v1/health

回滚通常是手动的：回到已知可用 commit 或 revert 坏变更，重建受影响前端，重启并再次验证健康状态。

如果目标是没有桌面浏览器的 Linux 服务器，先走无头 Linux 后端；它把 Docker、裸机 systemd、SSH 端口转发、API 密钥和远程访问首次绑定放在同一条路径里。

公开站点和文档是静态部署，通常比安装包更容易回滚，因为托管平台保留部署历史。

文档变更本地验证：

cd services/docs-site
npm run check

公开站点集成验证：

cd services/jarvis-site
npm run build
npm test

远程访问让手机或浏览器访问用户本机 Jarvis，而不要求开放公网入站端口。排障时要同时检查本地后端、隧道、认证和客户端状态。

安装包发布影响更大。源码有变化时必须走版本同步、候选构建、验收和最终发布流程。单端恢复不能替代源码热修。