文档概览
欢迎查阅 Warpai 官方技术文档 —— 专为多 Agent 深度协同打造的本地优先、高隐私原生终端工作空间。
Warpai 将独立的 CLI Agent 会话提升为第一公民工作单元。针对代码工程，Warpai 提供严格的 Git Worktree 并发编码模式，支持在物理隔离的分支中并行开发不同功能并执行自动化对等评审；针对泛行业与非 Coding 场景，重磅提供 Project 全向协同模式，打破单一指挥链，让所有 Agent 自由互通消息与任务，在科研论文、视觉设计、量化金融、专利法务等场景中高效攻坚。
快速导航
| 分类 | 文档章节 | 内容概述 |
|---|---|---|
| 快速入门 | 安装指南 | macOS、Windows 与 Linux 桌面端安装包及安装说明、系统安全性信任说明，以及 Linux SSH 远程伴侣配置。 |
| 快速上手 (5分钟) | 5 分钟极速指引：启动你的第一个 Agent、快速熟悉工作空间布局与额度监控。 | |
| 核心架构 | 核心概念与安全保障 | 深入解析守护式 PTY 交付、VT100 内存屏幕观察器、Git Worktree 物理隔离与 Project 全向协同模式。 |
| 全景功能矩阵与市面体系对比 | 横向深度对比传统终端、Agent 编辑器、传统 IDE、ADE 新秀、多智能体框架、桌面 AI 与原版 Warp，详述 7 大系统架构差异与 Warpai 核心优势。 | |
| 使用指南 | 使用指南总览 | 面向日常开发、代码审阅、多任务并行的顶层工作流指引。 |
| Project 模式实战手册 | 重点扶持非 Coding 场景：打破层级、全员互通消息与任务，涵盖科研论文、视觉设计、金融量化等 6+ 场景实战教程。 | |
| Worktree 模式完全手册 | 面向 Git 代码仓库的大规模并行开发：物理工作树隔离、多分支并行编码、Coordinator 统筹与自动化对等评审。 | |
| 多智能体协同架构 | Worktree 并发编码模式与 Project 泛行业全向网状协同双架构原理与机制。 | |
| 终端与命令块深入 | 命令块交互、智能命令补全、垂直标签页、内置轻量 Vim 编辑器与实时 Markdown 预览。 | |
| 远程接入 | OpenSSH Server 安装与配置 | 在 Linux、macOS 和 Windows 上安装并启用 OpenSSH Server，将 Windows SSH 登录 Shell 切换为 PowerShell，安装 Companion 并配置远端 MCP。 |
| Windows WSL 安装与配置 | 启用 WSL 2、安装发行版、在 Warpai 中接入，安装 WSL Companion，并在客户机内部配置各 Agent 的 MCP。 | |
| Agent 生态 | 20+ 款 CLI Agent 配置 | Claude Code、Codex、Gemini、Antigravity、Cursor 等 20+ 款 Agent CLI 的安装与认证完整手册。 |
| 原生 MCP 协同工具体系 | 38+ 项内置 MCP 本地协议工具（warpai-local-com）接口参考。 |
|
| 配置与帮助 | 配置项与外观主题 | settings.toml 参数详解、外观主题切换、快捷键绑定与长任务防止休眠（Keep-Awake）。 |
| 故障排查与常见问题 | 环境自检清单、常见终端报错排查、SSH 连通性与权限问题诊断。 |
核心设计哲学
- 本地优先与纯粹隐私：零遥测埋点、零云端账号壁垒、不锁定专有闭源模型。你的代码、Shell 命令与 Agent 交互内容均保留在本地受控环境中，绝不在未经许可的情况下外传。
- 开放无界的 Agent 生态：不强推任何内置单一模型订阅。直接复用你熟悉的 CLI Agent 工具（Claude Code、Codex、Cursor、Gemini 等），沿用现有 API 密钥与授权。
- 双架构驱动规模化协同：严肃的代码工程借助物理隔离的 Git Worktree 独立开发不同功能；跨领域的泛行业协作通过 Project 模式打破层级、全员互通消息与任务，构筑多智能体并行交付的坚实基石。