深色模式
安装指南
CrossPilot 支持 Windows、macOS、Linux 三大平台。前往 下载页 获取对应安装包。
系统要求
| 平台 | 最低版本 | 说明 |
|---|---|---|
| Windows | 10 (1809+) | x64；已自带 WebView2 |
| macOS | 12 Monterey | Apple Silicon + Intel |
| Linux | Ubuntu 22.04 / Fedora 38 等 | 需 WebKitGTK 4.1 |
| 磁盘 | 约 200 MB | 含 MCP sidecar |
| 网络 | 首次激活需联网 | 之后核心功能可离线；同步数据需联网 |
Windows
- 下载
.exe安装程序 - 双击运行，按提示完成安装
- 数据目录在
%APPDATA%\com.agilefr.crosspilot\
WebView2 运行时
Windows 10 (1803+) 和 Windows 11 已自带 WebView2。如果启动失败，请从 微软官网 手动安装。
关于"未知发布者"警告
CrossPilot 暂未加 EV 代码签名，首次运行可能弹 SmartScreen 警告。点 更多信息 → 仍要运行 即可。
macOS
- 下载
.dmg文件 - 双击挂载，把
CrossPilot.app拖到Applications - 首次打开如遇 Gatekeeper「已损坏，无法打开」提示，在终端执行：
bash
xattr -dr com.apple.quarantine /Applications/CrossPilot.app数据目录在 ~/Library/Application Support/com.agilefr.crosspilot/。
Linux
Debian / Ubuntu (.deb)
bash
sudo apt install ./CrossPilot_<版本>_amd64.deb
# 依赖（首次安装可能需要）
sudo apt install libwebkit2gtk-4.1-0 libsoup-3.0-0通用 (AppImage)
bash
chmod +x CrossPilot_<版本>_amd64.AppImage
./CrossPilot_<版本>_amd64.AppImage数据目录在 ~/.local/share/com.agilefr.crosspilot/。
关于 MCP sidecar
crosspilot-mcp 可执行文件跟主程序一起打进安装包里（Tauri externalBin 机制），无需单独下载。它是 stdio MCP 服务的纯代理，接入 AI 客户端时由主程序调起，详见 MCP 能力网关。
数据目录一览
| 平台 | 路径 |
|---|---|
| Windows | %APPDATA%\com.agilefr.crosspilot\ |
| macOS | ~/Library/Application Support/com.agilefr.crosspilot/ |
| Linux | ~/.local/share/com.agilefr.crosspilot/ |
本地 SQLite 数据库、加密后的凭据、日志都在这里。卸载前想保留数据请先备份，见 数据备份与恢复。
升级与卸载
- 升级：CrossPilot 内置自动更新，见 自动更新；也可直接下载新版覆盖安装
- 卸载：按系统标准方式卸载；数据目录不会自动删除，需手动清理