第3章 本地优先架构与 Web 访问安全机制
### 本地优先与安全性 第 3 章:本地优先与安全性
Jean 在数据存储位置、本地保留内容以及 Web 访问安全机制方面有着明确的架构考量。
Jean 坚持将工作状态保持在本地设备附近。这并不意味着数据绝不会离开电脑。当你使用后端服务时,所选的后端仍会与上游服务进行通信。Jean 改变的是控制层的位置,以及让你有多少工作流处于自己的掌控之下。
默认本地优先
Jean 将核心状态保存在运行应用的设备上:
- 项目和工作区(worktrees) - 聊天会话和已归档的会话 - 偏好设置和快捷键绑定 - 保存的上下文摘要和恢复数据 - 本地自动化配置,如 jean.json
此外,Jean 直接利用你已配置好的 CLI 身份验证,而不是为日常使用创建独立的托管账户模型。
Jean 存储的内容
应用会持久化以下信息:
- 项目元数据 - 工作区元数据 - 聊天消息和会话状态 - Prompt、模型、后端和提供方的选择 - 归档状态、标签和会话摘要 - 偏好设置,如字体、主题、快捷键和 Web 访问设置
当你将项目自动化配置保存到仓库根目录时,它会在那里写入 jean.json 文件。
凭证与提供方
Jean 支持以下身份验证方式:
- 直接通过 Claude CLI 身份验证 - Codex CLI 身份验证 - OpenCode 身份验证 - Cursor Agent 身份验证 - PI CLI 身份验证 - Command Code CLI 身份验证 - Grok CLI 身份验证 - Kimi Code CLI 身份验证 - GitHub CLI 身份验证 - 可选的自定义 Claude CLI 提供方配置文件
提供方配置文件以 Claude CLI 设置文件的形式存储。这让 Jean 能够通过备用端点路由 Claude CLI 请求,而不必将 Jean 本身变成凭证管理系统。
安全默认值
部分默认设置偏向保守:
- 内置 HTTP 服务器默认关闭 - 启用后,默认仅绑定 localhost,除非你手动开放绑定主机 - Web 访问默认强制要求基于 Token 的访问 - 新的 MCP 服务器发现功能会尊重你明确禁用的服务器
关于 Web 访问
如果你将 Jean 绑定到 0.0.0.0 或其他非回环(non-loopback)主机,请将其视为暴露在网络上的一般的开发工具。保持开启 Token 保护。建议优先使用 Tailscale(或 WireGuard / SSH 隧道 / 带有 TLS 的反向代理),而不是直接暴露公网端口。
浏览器模式的作用
每个 Jean 实例——无论是桌面版还是 jean-server——都可以通过嵌入式 HTTP 服务器提供前端服务,并通过 WebSocket 保持状态同步。
这在以下场景中非常有用:
- 在其他机器上无头运行 Jean - 通过浏览器打开相同的工作区 - 在离开桌面应用的情况下检查长时间运行的任务 - 将原生桌面应用连接到远程 Jean 实例(标题栏服务器图标 → 添加远程)
恢复与清理
Jean 对本地状态具有面向恢复的行为机制:
- 已归档的项目项可以恢复 - 孤立的会话数据可以被清理 - 崩溃或紧急数据可以被恢复 - 更新检查和安装通过桌面应用处理
延伸阅读
- Web 访问与无头模式 - 归档、恢复与更新 - 后端、模型与 MCP - Jean 工作原理:理解从项目到工作区再到会话的流程,以及 Jean 如何将所有内容串联起来。 - 安装与设置:安装 Jean,连接首选后端,并完成首次运行设置。