Karma Box (macOS)

Karma Box 是 Karma One 的 macOS 桌面伴侣应用，它让 AI 能够直接与你的 Mac 系统交互——截屏、管理文件、读写剪贴板、操控日历、发送邮件，甚至通过语音唤醒。这不只是一个聊天窗口，而是一个真正的桌面 AI 助手。

什么是 Karma Box

Karma Box 是安装在 macOS 上的本地服务，它在你的 AI 分身和 Mac 系统之间架起了一座桥梁。通过 Karma Box，AI 可以：

• 直接操作你的 Mac（截图、文件管理、剪贴板等）
• 控制系统应用（日历、邮件、Safari、Finder）
• 运行本地命令和脚本
• 使用语音与你交互
• 部署和运行本地 AI 模型（参见 主权AI）

Karma One App ←→ Karma Box (macOS) ←→ Mac 系统
                      │
                      ├─ 系统工具（40+）
                      ├─ 应用控制
                      ├─ 本地 AI 模型
                      └─ Claude Code 集成

小贴士：Karma Box 不会在后台持续运行大量进程，只有在 AI 需要调用桌面工具时才会激活对应功能。

系统级工具

Karma Box 提供了超过 40 个系统级工具，覆盖 macOS 的方方面面。

截图工具

| 工具 | 功能 | 示例指令 | |------|------|----------| | 全屏截图 | 捕获整个屏幕 | "截个屏" | | 窗口截图 | 捕获指定窗口 | "截一下当前窗口" | | 区域截图 | 捕获选定区域 | "截取屏幕左半部分" |

截图支持延迟拍摄，可以在截图前等待指定秒数。

剪贴板

AI 可以读写 macOS 剪贴板：

你：把刚才那段总结复制到剪贴板
AI：已将内容复制到剪贴板，你可以直接粘贴使用。

你：剪贴板里现在是什么内容？
AI：剪贴板当前内容是：[显示剪贴板内容]

语音合成（TTS）

AI 可以直接通过 Mac 的扬声器朗读文字：

• 支持多种语音（包括中文 Ting-Ting、英文 Samantha 等）
• 可调节语速
• 适合听取长文本摘要或外语练习

系统通知

AI 可以发送 macOS 原生通知：

你：10 分钟后提醒我喝水
AI：好的，10 分钟后我会通过系统通知提醒你。

[10 分钟后]
macOS 通知：该喝水了！

日历管理

| 操作 | 说明 | |------|------| | 查看日程 | 获取指定日期范围的所有事件 | | 创建事件 | 新建日历事件，支持设置地点、备注、提醒 | | 删除事件 | 通过标题和时间删除指定事件 | | 列出日历 | 查看所有可用日历 |

你：看看我明天有什么安排
AI：明天你的日程如下：
    09:00-10:00  团队周会（会议室A）
    14:00-15:00  客户电话
    16:30-17:00  1对1 面谈

你：帮我在明天下午 2 点前加一个 30 分钟的准备时间
AI：已创建事件「客户电话准备」，13:30-14:00，并设置了 5 分钟提醒。

小贴士：AI 可以同时查看你的日程安排和创建新事件，非常适合用来安排不冲突的会议时间。

文件管理

通过 Finder 集成实现文件操作：

| 操作 | 说明 | |------|------| | 浏览目录 | 列出文件夹内容（名称、路径、类型、大小、修改时间） | | 文件信息 | 获取文件详细信息 | | 移动文件 | 将文件移到新位置 | | 复制文件 | 复制文件到指定目录 | | 创建文件夹 | 新建文件夹 |

你：帮我把桌面上所有 PDF 文件移动到"文档/报告"文件夹
AI：已找到桌面上 5 个 PDF 文件，全部移动到"文档/报告"文件夹。

邮件管理

直接操作 Mail.app：

| 操作 | 说明 | |------|------| | 查看邮件 | 列出指定邮箱中的邮件 | | 读取邮件 | 读取指定邮件的完整内容 | | 搜索邮件 | 按主题或发件人搜索 | | 发送邮件 | 撰写并发送（支持多收件人、抄送、密送、附件） | | 管理邮件 | 标记已读/未读、删除、移动 |

你：有没有新邮件？
AI：你有 3 封未读邮件：
    1. 张经理 - 项目进度更新
    2. HR - 年假审批通知
    3. Newsletter - 每周技术摘要

你：帮我回复张经理，告诉他进度正常，预计下周五完成
AI：好的，我已起草回复邮件。确认发送吗？

注意：发送邮件会立即执行，AI 在发送前会向你确认内容和收件人。

Safari 浏览器控制

| 操作 | 说明 | |------|------| | 打开网页 | 在 Safari 中打开 URL | | 列出标签页 | 查看所有打开的标签页 | | 读取内容 | 提取当前页面的文字内容 | | 执行脚本 | 在页面中运行 JavaScript | | 关闭标签页 | 关闭指定标签页 |

注意：使用 Safari 控制功能前，需要在 Safari 中开启「允许来自 Apple Events 的 JavaScript」：Safari → 设置 → 高级 → 勾选「在菜单栏中显示开发菜单」→ 开发 → 勾选「允许 Apple Events 的 JavaScript」。

Claude Code 集成

Karma Box 深度集成了 Claude Code，让 AI 可以直接在你的 Mac 上编写和运行代码。这是 Karma One 最强大的开发者功能之一。

功能

• 在终端中执行任意命令
• 读写本地文件和项目代码
• 运行开发工具（Node.js、Python、Docker 等）
• 管理 Git 仓库
• 调试和测试代码
• 搭建和启动项目

你：帮我在桌面创建一个 Python 项目

AI：好的，我来帮你设置：
    1. 创建项目目录
    2. 初始化虚拟环境
    3. 创建 main.py 和 requirements.txt
    4. 初始化 Git 仓库

    项目已创建在 ~/Desktop/my-project/

通过 Claude Code 集成，你的 AI 分身真正具备了软件工程师级别的编码能力，可以从零搭建项目、修复 Bug、编写测试，甚至进行代码审查。

相机和屏幕录制

相机拍照

• 使用 Mac 内置摄像头拍摄照片
• 支持设置预热时间（避免画面模糊）
• 照片保存到指定路径

屏幕录制

• 录制屏幕操作，可选择录制的显示器
• 可设置录制时长
• 适合录制操作教程或问题复现

安装和配置

系统要求

• macOS 12 (Monterey) 或更高版本
• Apple Silicon (M1/M2/M3/M4) 或 Intel Mac
• 至少 8GB RAM（运行本地模型需要 16GB+）

安装步骤

1. 从 Karma One 应用内的「设备连接」页面下载 Karma Box 安装包
2. 打开 .dmg 文件，将 Karma Box 拖入「应用程序」文件夹
3. 首次启动时，macOS 可能提示「来自未识别的开发者」，进入「系统设置」→「安全性」点击「仍要打开」
4. Karma Box 启动后，使用 Karma One 账号登录
5. 登录成功后，Karma Box 自动连接到你的 Karma One 账号

权限设置

Karma Box 需要以下 macOS 权限才能正常工作：

| 权限 | 用途 | 设置路径 | |------|------|----------| | 辅助功能 | 系统自动化操作 | 系统设置 → 隐私与安全性 → 辅助功能 | | 屏幕录制 | 截图和录屏 | 系统设置 → 隐私与安全性 → 屏幕录制 | | 完全磁盘访问 | 文件管理 | 系统设置 → 隐私与安全性 → 完全磁盘访问 | | 日历 | 日程管理 | 系统设置 → 隐私与安全性 → 日历 | | 摄像头 | 拍照和视频 | 系统设置 → 隐私与安全性 → 摄像头 | | 麦克风 | 语音输入 | 系统设置 → 隐私与安全性 → 麦克风 | | 定位服务 | 获取位置 | 系统设置 → 隐私与安全性 → 定位服务 |

小贴士：建议在首次设置时一次性授予所有权限，避免使用过程中被频繁打断。

语音唤醒

Karma Box 支持语音唤醒，让你不用动手就能与 AI 对话。

语音唤醒 (Voice Wake)

• 开启后，Karma Box 持续监听唤醒词
• 检测到唤醒词后自动激活 AI 对话
• 适合免提操作场景

持续对话模式 (Talk Mode)

• 开启后进入连续语音对话状态
• 你说话 → AI 听取 → AI 回复 → 继续等待你说话
• 无需手动触发，实现自然对话体验

| 模式 | 触发方式 | 适用场景 | |------|----------|----------| | 语音唤醒 | 说出唤醒词 | 日常免提使用 | | 持续对话 | 手动开启 | 长时间语音交互 |

系统信息获取

AI 可以获取你的 Mac 的完整系统信息：

你：我的电脑是什么配置？

AI：你的 Mac 系统信息：
    型号：MacBook Pro (M2 Pro)
    系统：macOS 14.2
    内存：16 GB
    存储：512 GB (剩余 234 GB)
    CPU：Apple M2 Pro (12核)

40+ 系统工具完整列表

| 类别 | 工具 | |------|------| | 系统操作 | 执行 Shell 命令、AppleScript 自动化、系统信息、系统通知 | | 截图与录屏 | 全屏截图、窗口截图、区域截图、屏幕录制 | | 剪贴板 | 读取剪贴板、写入剪贴板 | | 语音 | 文字转语音（TTS）、语音唤醒、持续对话模式 | | 文件管理 | 浏览目录、文件信息、移动文件、复制文件、创建文件夹 | | 日历 | 列出日历、查看事件、创建事件、删除事件 | | 邮件 | 列出邮件、读取邮件、搜索邮件、发送邮件、标记/删除/移动邮件 | | Safari | 打开网页、列出标签页、读取页面内容、执行 JavaScript、关闭标签页 | | 应用控制 | 打开应用、打开 URL | | 摄像头 | 拍照、录制视频 | | 定位 | 获取当前地理位置 | | 进程管理 | 启动后台进程、查看进程列表、读取输出、写入输入、终止进程、清理已完成进程 | | 定时任务 | 创建 Cron 定时任务、列出任务、删除任务、启用/禁用任务、一次性延迟任务 | | 节点管理 | 列出设备节点、远程调用设备能力 |

常见问题

Q：Karma Box 是否需要一直运行？ 是的，Karma Box 需要在后台运行才能响应 AI 的桌面操作请求。但它占用的资源非常少，不会影响你的正常使用。

Q：没有 Mac 可以使用 Karma One 吗？ 当然可以。Karma Box 是可选的扩展，Karma One 的核心功能（对话、分身、知识库等）在 iOS、Android 和 Web 端都可以使用。Karma Box 提供的是额外的桌面操作能力。

Q：Karma Box 会不会误操作我的文件？ AI 在执行文件操作（移动、删除等）前会向你确认。此外，你可以在权限设置中限制 Karma Box 的访问范围。

Q：支持 Windows 或 Linux 吗？ 目前 Karma Box 仅支持 macOS。Windows 和 Linux 版本在规划中。