boos
5.7 KiB
5.7 KiB
BoosAPI Desktop 是什么
BoosAPI Desktop 是一款运行在你本机的 AI 桌面工作台。它默认接入 BoosAPI（https://api.boos.lat）作为服务商，开箱即用，同时也能连接任意 OpenAI 兼容端点。对话、密钥与文件都保存在本地。
功能特性
对话与模型
- 多服务商对话 —— 连接 BoosAPI、OpenAI、Claude、Gemini、DeepSeek、Qwen 以及任意 OpenAI 兼容端点，支持自定义 Base URL、API Path、请求头和代理规则。
- 服务商快速导入 —— 通过
boosapi://服务商链接和 CC Switch 配置导入，在用户确认后把服务商资料带入应用。 - 模型管理 —— 同步远程模型列表、管理分组、测试延迟，并配置能力标签、上下文长度、采样默认值、推理档位和模型级
extra_body。 - 对话工作流 —— 流式回复、思考块、消息多版本、对话分支、标题生成状态、长对话压缩和多模型并行回答。
AI Agent
- Agent 模式 —— 让模型在受控桌面工作流中读取/编辑文件、执行命令并分析代码。
- 权限控制 —— 可选择标准审核、自动接受编辑或完全访问模式，同时保留工作目录沙箱检查。
- 审批与成本面板 —— 实时查看工具调用、记住允许决策，并跟踪每个 Agent 会话的 token 与成本。
内容渲染
- Markdown 与数学公式 —— 在流式对话中渲染 Markdown、代码高亮、表格、任务列表和 LaTeX 公式。
- 代码、图表与 Artifact —— 内置 Monaco 代码块、Mermaid、D2 图表和 Artifact 面板，用于代码、笔记、报告和预览。
- HTML 片段渲染 —— 安全预览模型生成的 HTML 片段，并包含流式渲染稳定性修复。
搜索与知识
- 联网搜索 —— 接入 Tavily、智谱 WebSearch、Bocha 等搜索服务，支持引用来源和搜索查询生成。
- 本地知识库 —— 用 sqlite-vec 索引私有文档，配置检索/重排选项并查看检索反馈。
- 上下文管理 —— 把文件、搜索结果、知识片段、记忆和工具输出附加到对话上下文。
工具与扩展
- MCP 协议 —— 运行 stdio、SSE 或 StreamableHTTP 传输的 Model Context Protocol 服务器。
- 内置工具 —— 直接使用 fetch、文件搜索等内置 MCP 工具，无需额外安装独立服务器。
- 工具循环上限 —— 可配置 MCP 工具调用最大循环次数，并更好地恢复中断或卡住的工具会话。
API 网关
- 本地网关 —— 从桌面应用暴露 OpenAI Chat Completions、OpenAI Responses、Claude 原生和 Gemini 原生接口。
- 访问与观测 —— 本地管理网关密钥、SSL/TLS 证书、请求日志和用量统计。
- 客户端模板 —— 提供 Claude Code、Codex CLI、OpenCode、Gemini CLI 和自定义客户端的配置模板。
数据导入与备份
- 第三方导入 —— 导入 ChatGPT 官方导出、Cherry Studio 备份和 Kelivo 备份，带预览统计、警告和重复处理。
- 服务商与文件迁移 —— Cherry Studio/Kelivo 导入可选择迁移关联服务商、API Key 和文件附件。
- 备份 —— 通过本地目录、WebDAV 或 S3 兼容存储进行备份与恢复。
桌面体验与安全
- 本地加密 —— 应用状态位于
~/.boosapi/，用户文件位于~/Documents/BoosAPI Desktop/，API Key 使用 AES-256 和本地主密钥保护。 - 桌面集成 —— 支持托盘、窗口置顶、全局快捷键、开机自启、代理设置和自动更新检查。
- 11 种界面语言 —— 可在简体中文、繁体中文、英语、日语、韩语、法语、德语、西班牙语、俄语、印地语和阿拉伯语之间切换。
平台支持
| 平台 | 架构 |
|---|---|
| macOS | Apple Silicon (arm64)、Intel (x86_64) |
| Windows 10/11 | x86_64、arm64 |
| Linux | x86_64 (AppImage/deb/rpm)、arm64 (AppImage/deb/rpm) |
快速开始
前往 Releases 页面下载适合你平台的安装包。首次启动时 BoosAPI 已预置为默认服务商 —— 在设置中填入你的密钥即可开始对话。
从源码构建
# 前端依赖
pnpm install
# 构建内置渲染包（仅首次）
pnpm --dir libs/stream-monaco install && pnpm --dir libs/stream-monaco build
pnpm --dir libs/markstream-vue install && pnpm --dir libs/markstream-vue run build:parser
pnpm --dir libs/markstream-vue/packages/markstream-react build
# 开发运行 / 打包
pnpm tauri dev
pnpm tauri build
需要 Rust (stable)、Node 20+、pnpm，Linux 下还需 Tauri 系统依赖（webkit2gtk-4.1、libsoup-3.0）。
常见问题
macOS 提示"已损坏"或"无法验证开发者"
应用未经 Apple 签名，macOS 可能弹出提示。移除隔离属性即可：
sudo xattr -dr com.apple.quarantine "/Applications/BoosAPI Desktop.app"
随后在 「系统设置 → 隐私与安全性」 点击 「仍要打开」。
许可证
BoosAPI Desktop 是 AQBot 的 fork，经作者授权使用并重新许可，内含 MIT 许可的 open-agent-sdk。详见 LICENSE。