Jarvis 文档

面向个人开发者的本地优先 AI 工作台与编码会话操作系统

安装桌面端从源码运行启动编码会话排障

这是一张任务地图：先把 Jarvis 跑起来，再连接模型、启动一个可观察的编码 Agent，并学会在重启、阻塞或环境异常时恢复。

先完成一个结果

普通用户

安装、连接模型、启动一个 Agent

贡献者

克隆仓库、运行本地栈、检查状态

运维者

让服务器、移动端和发布流程保持可控

Agent / 自动化

找到稳定契约并回报进展

常见工作流

01启动本地开发实例安装依赖、启动后端、打开 Web UI，并确认健康检查。02配置模型提供商添加模型密钥，同时避免把私有配置写入仓库。03启动编码运行时从 Jarvis UI 启动 Claude Code、Codex 或 OpenCode。04恢复和管理会话回放工作、检查阻塞状态，并在多个视图之间切换。05阅读摘要胶囊让主聊天了解活跃工作，而不被终端输出淹没。06安全重启使用健康检查、reload 和恢复路径处理本地实例。07部署无头 Linux 后端在服务器上选择 Docker 或 systemd，生成 API key，并用 SSH 转发完成首次访问。08理解本地边界确认数据路径、隧道、模型提供商密钥和隐私边界。09安装或更新桌面端找到稳定下载入口，并理解桌面发布轨道。

本地优先系统图

桌面端 / Web UI聊天、会话列表、终端详情

FastAPI 后端SSE、REST、运行时编排

SQLite 会话库聊天历史、编码会话状态

编码运行时Claude Code、Codex、OpenCode

可选能力移动端隧道、KB、更新器、诊断

参考入口

配置参考 REST API SSE 事件 MCP 工作会话工具运行时矩阵 CLI 术语表模型网络排障