README_ZH.md
August 27, 2026 · View on GitHub
BootAgent 是一个本地桌面工作台,用来统一管理 AI 编程 Agent。它把检测、安装、模型服务配置和日常维护放进一条清晰的流程,不必再手动修改多个工具各自的配置文件。
核心能力
- 检测、安装、更新并启动支持的 CLI 和桌面 Agent。启动 CLI Agent 使用的终端可在“设置”中选择,默认沿用系统自带终端。
- 环境总览仍直接提供配置和启动操作;每个已安装 Agent 卡片会把自身支持的低频操作收进“更多”菜单。npm 管理的 CLI Agent 可在其中更新或卸载;卸载只移除程序,Profile、Provider、配置文件和对话都会保留。
- 可从 Codex 与 ChatGPT Desktop 的 Agent 行把现有对话迁入 BootAgent 的
bootagentProvider 分桶;此操作按设计不创建历史备份。 - 连接内置或自定义模型服务(Provider),选择模型,并按 Agent 实际协议检查连接。
- 保存可复用的配置模版(Profile)。在某个 Agent 的配置页选择要用的模版,模型也可以在同一页直接改。
- 把 Profile 上的思考深度(
off、low、medium、high、max)写入每个自身配置格式有对应位置的 Agent,并按各自接受的取值做换算。没有文档化深度设置的 Agent 保持原样,不会被塞进自造的字段。 - 按需准备 Node.js、uv,以及 Aider 所需的托管 Python 运行时。
- 长时间安装任务在任务中心持续可见,并且可以取消。
- 提供本地 API 格式转换和可选的开机自启动;两者默认关闭,启用格式转换时会询问是否同时开机自启动。
- 导入和导出 Provider、Profile 以及选中的 MCP 服务器;默认不导出 API Key 和 MCP 秘密,也支持密码加密或明确确认后的明文导出。
- 从已初始化的 Claude Code、Codex、OpenCode、Kilo CLI 和 Hermes 中发现 MCP 服务器,并在 MCP Registry 页面选择同步目标。扫描在后台进行,编辑必须显式应用并只写入本机。
- 在工具市场发现 Skills、MCP 服务器、插件、独立 AI 产品、提示词集合和工作流模板。每个来源都有内置快照,可用的公开数据源可以单独在线刷新,某一个来源失败不会清空整个目录。
- 市场条目可以同时属于多个工具类型;类型多选只保留同时满足全部所选类型的条目,再与来源、使用场景和 API Key 条件组合筛选。
- 可以让已安装的 Codex 或 Claude Code CLI 根据用户需求筛选市场工具。上下文只包含用户输入和公开目录元数据,推荐进程没有安装或写文件工具;展示前还会把返回 ID 与当前目录逐项核对。
- 成功的工具推荐会保存在本机,记录需求、使用的 Agent、目录版本和结果快照;可重新查看、删除或清空,绝不会作为遥测上传。
- 创建备份、原子写入,并将凭据保存在本机私有存储中。Profile、Provider、MCP、Agent 配置目标和 Skill 分别保留最近 3 个历史版本;备份统一放在
~/.bootagent/backup,可在“设置”中修改每个目标的保留数量。 - 检查 BootAgent 更新,并通过内置更新器安装发行包。开启国内镜像设置时,更新检查和下载使用 Gitee 镜像;否则使用 GitHub。
支持的 Agent
| CLI Agent | 桌面 Agent |
|---|---|
| Codex · Claude Code | DSH Desktop · Claude Desktop(macOS/Windows) |
| Kilo CLI · Aider · OpenCode | ChatGPT Desktop(macOS/Windows) |
| Hermes Agent · OpenClaw | WorkBuddy · WorkBuddy AI(macOS/Windows) |
| Kimi Code · DeepSeek Harness | ZCode(macOS/Windows) |
DSH Desktop 排在桌面 Agent 列表首位。它由 anywhere-labs 发布,而不是 DeepSeek,所以下载行会标注它是第三方应用;旁边的 DeepSeek 标识表示它驱动的模型,不代表发布方。
BootAgent 可在 macOS 和 Windows 上检测并启动 Claude Desktop,但仍需用户自行安装。配置写入后,BootAgent 会引导用户前往官方下载页面。BootAgent 会为 Anthropic 兼容直连端点写入并选择一个自有的 3P Profile;它不会下载 Claude Desktop、代理请求,也不提供恢复到 1P 的操作。所选模型 ID 必须包含 claude(不区分大小写)。
内置 JieKou.AI、PPIO、Novita、DeepSeek 和 Moonshot,顺序如此;也可以在模型服务页面添加任意 OpenAI 兼容或 Anthropic 兼容服务。BootAgent 会按 Agent 真正使用的协议探测;如果端点只支持另一种 API,会在写入配置前拒绝它。
DeepSeek Harness 除了走通用的 OpenAI 兼容端点,也可以直接激活到 DeepSeek 自己的官方线路——该线路由它出厂配置本身定义。
MCP Registry 只管理用户级配置并保存在本机,支持 Claude Code、Codex、OpenCode、Kilo CLI 和 Hermes 的 stdio、HTTP、SSE 服务器。用户可以单独选择同步目标并显式应用;清空所有同步目标只会从 Agent 配置中移除服务器,仍保留在 Registry 中。点击删除后,会先从 Agent 配置中移除,应用成功后才从 Registry 中删除。MCP 导出按服务器选择且不携带 Agent 绑定,导入其他机器后可重新选择本机同步目标。
下载
从 GitHub Releases 下载最新的 macOS、Windows 或 Linux 包。Linux 发行包为 amd64 和 arm64 提供 deb、rpm、AppImage 以及 OTA zip。发行包附带 SHA-256 校验文件。macOS 发行包使用 Developer ID 签名并经过公证;由于 Wails 仍处于 Alpha,当前发布渠道仍为 technical-preview-unsigned。
BootAgent 不重新分发 Agent 包,也不捆绑 Node.js、Git、WebView 或 API Key。缺少前置条件时,应用会给出明确错误和官方安装指引。
从源码构建
需要 Go、Node.js、pnpm 11.21.0,以及目标平台的 WebView 依赖。Linux 构建使用 GTK4 和 WebKitGTK 6.0,不支持 GTK3。
git clone https://github.com/MaimoryLab/BootAgent.git
cd BootAgent
cd frontend && pnpm install --frozen-lockfile && pnpm run build && cd ..
go run -tags wails ./cmd/bootagent-desktop
日常开发可安装 Task 后运行 task dev。常用检查:
go test ./...
go test -race ./...
go vet ./...
cd frontend && pnpm run test && pnpm run build
项目链接
- AI Agent Kit:从零配置 Agent 环境
- 文档:规范与架构决策
- 公开站仓库
- Issues 与功能请求
Star History
赞助
BootAgent 以 Apache License 2.0 发布,第三方归属见 NOTICE。