# Caravel — 本地优先的多 AI 编码 Agent 工作台

[English](https://caravel-site.pages.dev/en/index.md) · [简体中文](https://caravel-site.pages.dev/index.md)

> Caravel 将多个 AI 编码 Agent、项目与任务组织到一个桌面工作台中，统一派发任务、跟踪进度、处理授权和审查代码。

## Caravel 是什么？

Caravel 面向同时维护多个项目、并行使用 AI 编码 Agent 的开发者，支持 macOS（Apple Silicon / Intel）与 Windows x64。用户继续使用自己的 Agent、模型账号和 IDE，由 Caravel 管理任务、持续对话和代码验收。

## 支持哪些 Agent？

支持 Claude Code、Codex、OpenCode、pi、Grok、TRAE 和 Antigravity。可在设置中安装或升级 Agent；具体功能取决于 Agent 及其安装版本。TRAE 需要 CLI 2.0 与企业版旗舰版账号。Caravel 不替代 Agent 运行时、模型服务或代码编辑器。

## 平台、安装与使用前提

- macOS 提供 Apple Silicon / Intel 通用安装包；Windows 提供 x64 安装包。两个平台均包含全部功能模块。
- macOS 与 Windows x64 均支持应用内签名更新；旧 Windows 客户端需先安装支持自动更新的版本，也可以使用最新安装包手动更新。
- 准备本地项目、Git 和可用的 Agent / 模型账号；Windows 还需要 Git for Windows 与 Node.js。
- 在 Caravel 设置中安装或升级 Agent，完成登录与模型配置后再派发任务。模型订阅或 API 费用由对应服务收取。
- 从[官方最新发行版](https://github.com/yy36295238/caravel-releases/releases/latest)下载：macOS 打开通用 DMG 并拖入「应用程序」，Windows 运行 x64 安装程序。
- 安装包尚未完成系统代码签名，macOS 应用尚未公证；这与应用内更新包签名不同。首次启动被系统阻止时，核实下载来源后参考[安装帮助](https://caravel-site.pages.dev/zh-CN/#install-help)。

## 可以完成哪些工作？

- 在同一个工作台管理多个 Agent、项目和并行任务，跟进对话、执行进度和授权请求。
- 选择原工作区、隔离副本或独立分支运行任务，查看 Diff 后决定交付、继续修改或放弃。
- 创建定时提醒、脚本或 Agent 任务，回看运行记录。
- 保存提示词和技能，将成功对话提炼为包含人工确认步骤的可复用工作流。
- 浏览与编辑文件、审查代码、查询数据库、管理待办与收件箱，制作个人小应用。
- 通过洞察与复盘了解任务效率、模型成本和结果。
- 可选接入飞书，在手机上跟进任务、继续对话、处理授权和验收，无需配置公网地址。

## 典型使用流程

1. 安装 Agent，选择项目、Agent 和模型，描述任务目标。
2. 跟踪任务进度，处理授权请求或需要判断的问题。
3. 查看代码改动，决定如何交付。
4. 保存有效提示词和工作流，或将重复工作交给定时器。

## 本地优先是否意味着完全离线？

任务、会话、工作区和个人知识由本机管理。调用在线模型、安装依赖或使用飞书等外部服务时仍需联网，遵循对应服务规则；本地优先不代表所有操作离线。

## 网页演示是否运行真实 Agent？

[网页演示](https://caravel-site.pages.dev/demo/?lang=zh-CN)复用真实产品界面，任务执行、模型回复、Git 改动、数据库结果和统计均为示例或模拟数据。不调用 Agent、不连接数据库、不读写访客磁盘。业务数据刷新后恢复，界面偏好会保存；桌面能力需安装应用。

## 官方来源

- [中文官网与常见问题](https://caravel-site.pages.dev/)
- [中文功能说明](https://raw.githubusercontent.com/yy36295238/caravel-releases/main/docs/product-overview.md)
- [英文功能说明](https://raw.githubusercontent.com/yy36295238/caravel-releases/main/docs/product-overview.en.md)
- [文档目录](https://caravel-site.pages.dev/llms.txt)
- [版本记录与安装包](https://github.com/yy36295238/caravel-releases/releases)
