总览

Jarvis 是给个人开发者使用的 AI 工作台。它默认聚焦两件事：稳定聊天，以及对 Claude Code、Codex、OpenCode 等编码 Agent 会话的编排和观察。

它不是通用托管 Agent 平台。默认形态是本地优先：Python 后端、Web UI、SQLite 本地状态库，以及连接外部 CLI 的运行时适配器。

两条核心工作流

持久聊天

主聊天是控制面。消息通过 SSE 流式返回，历史会持久化，刷新或重连后可以继续使用。

编码会话

编码会话是由 Jarvis 启动或发现、并由运行时承载的工作会话。你可以检查终端输出、回放时间线，并在它需要决策时回复。

长任务为什么仍然可用

Jarvis 把面向人的主聊天和嘈杂的运行时细节分开：

• 主聊天收到摘要胶囊和关键工作会话汇报，而不是完整终端流。
• 工作会话可以通过 MCP 工具汇报进度、提出问题或声明阻塞。
• 会话详情页保留终端、快照和事件历史，用于深入检查。

这个分层让你可以同时监督多个会话，而不把主聊天变成终端日志归档。

本地架构

1. 后端在本机运行，提供 API 并服务前端静态产物。
2. 浏览器或桌面壳打开本地 Jarvis 端口。
3. SQLite 保存聊天历史、编码会话状态和本地元数据。
4. 运行时适配器启动或发现 Claude Code、Codex、OpenCode 会话。
5. 会话事件回流到 Jarvis，UI 展示进展、阻塞和可回放历史。

先配置什么

Jarvis 本身只需要本地后端配置即可启动。要使用编码会话，还需要至少一个运行时 CLI 已安装并在同一台机器上完成登录。

文档组织方式

• 开始：本地启动、首次运行、第一次编码会话。
• 核心概念：Session OS、运行时模型、上下文管理。
• 使用指南：管理会话、派发任务、排障。
• 参考：API、配置、协议和运行时能力。

推荐阅读顺序

1. 快速开始：先跑起一个本地实例。
2. 第一次编码会话：从 UI 启动一个运行时。
3. 再阅读概念和参考页，理解为什么 Jarvis 按这种方式工作。

如果你的第一台 Jarvis 跑在没有桌面浏览器的 Linux 服务器上，先读 无头 Linux 后端，再回到编码会话和运行时文档。