内容
<div align="center">
<img src="./site/og.png" alt="FROX — 你的语音指令掌控 Mac" width="640" />
# FROX
**你的语音指令掌控 Mac.**
一个免费、开源、以语音为优先的人工智能指令中心，适用于 macOS。与它对话，它可以控制您的整个电脑 — 应用程序、文件、浏览器、消息 — 并且具有权限控制，确保您始终在控制之中。
[**官网**](https://frox-orpin.vercel.app) · [**下载**](https://github.com/mmalteras/frox/releases/latest) · macOS (Apple Silicon) · Windows 即将推出
 
</div>
---
## 什么是 FROX？
FROX 是您 Mac 的真正代理 — 而不是聊天机器人。您说出指令（中文或英文），它会实际执行：
- **语音优先** — 通过语音唤醒，也可以通过拍手或全局热键唤醒；在不到一秒的时间内响应。
- **控制整个 Mac** — 原生电脑使用：它可以看到屏幕，移动光标，运行 shell，驱动 Chrome，并控制 Mail 和 Calendar。
- **您来批准** — 机械权限控制（允许 / 询问 / 拒绝，如 Claude Code）。高风险操作会暂停，等待您点击或说出“是”。它不能伪造自己的批准。
- **记住您** — 持久的第二大脑（偏好、项目、笔记）+ 语义搜索您的 Obsidian 仓库，每天晚上进行“梦境”巩固所学内容。
- **远程手机控制** — 通过二维码配对，从任何地方通过端到端加密链接控制 FROX。
- **连接器** — 通用 MCP 客户端：连接 WhatsApp、Telegram、Slack、Gmail、Calendar、Notion、Supabase、Monday、Linear、GitHub、Stripe…… 每个都成为 FROX 可以通过语音执行的操作。
### 范围 — 从代码到整个公司
部署软件 · 运行业务（收件箱、日历、发票、CRM）· 研究和决策 · 填写表单和提交请求 · 自动化您的日常工作（“每天早上 7 点，简报我”）· 控制没有任何 API 的应用程序。
## 安装
**从最新版本** [下载应用](https://github.com/mmalteras/frox/releases/latest)（`.dmg`，Apple Silicon），将 **FROX** 拖到“应用程序”文件夹并打开它。
> 应用尚未经过 notarization，因此第一次 macOS 会发出警告。右键 **FROX → 打开 → 打开**。
> 首次使用时，请在系统设置中授予 **麦克风**、**屏幕录制** 和 **辅助功能** 权限（系统设置 → 隐私和安全）— 这些功能支持语音、屏幕视觉和电脑控制。
### 从源码构建
需要 [Rust](https://rustup.rs)、Node 20+ 和 [pnpm](https://pnpm.io)。
```bash
pnpm install
pnpm tauri build # → src-tauri/target/release/bundle/macos/FROX.app
```
## 配置
FROX 是 **自带密钥** — 没有捆绑任何内容，也没有 FROX 服务器。打开应用中的 **⚙︎ 设置** 并粘贴您自己的密钥：
- **Anthropic** （大脑）— 必需。
- **ElevenLabs** （中文/英文语音 + STT）— 语音功能必需。
- 可选：Soniox（更快的 STT）、Pinecone（语义记忆 + Obsidian RAG）、Picovoice（“Jarvis”唤醒词）、Slack token。
您的密钥和记忆仅存储在您的 Mac 上。
## 技术细节
Tauri 2（Rust shell）· Next.js 16 独立服务器作为 Node 侧车 · 原始 Anthropic SDK，支持原生电脑使用、提示缓存和流式处理 · MCP 连接器 · 具有端到端加密的零信任 WebSocket 中继，用于手机控制。
## 路线图
- [x] macOS (Apple Silicon)
- [ ] **Windows** — 进行中（UI、大脑、权限、连接器和远程控制已经跨平台；macOS 原生控制层正在移植）。
## 免责声明
FROX 是一个独立、免费、开源的项目，在 MIT 许可下发布给社区。它 **与 Anthropic、OpenAI、Apple、Google 或任何其他公司无关，不受其赞助或认可**。“Claude”、“GPT”、“macOS” 和所有其他产品名称、徽标和品牌均为其各自所有者的财产，仅用于识别。
软件按“原样”提供，不提供任何形式的保证。您在自己的机器上使用它，并使用自己的 API 密钥；您对如何使用它以及 API 提供商收取的任何费用负责。在法律允许的最大范围内，作者不对因使用该软件而产生的任何损害负责。
## 许可
[MIT](./LICENSE) © Menachem
## 联系方式
由一个人构建。欢迎提供反馈、想法、错误或投诉 — **mmalt770@gmail.com**。
