跳到主要内容
AI教程

Capri 教程：为 Windows 桌面设置赛博朋克 AI 智能体

了解如何在 Windows 上下载并配置 Capri，连接 Claude Code、Codex、Antigravity 或其他助手，执行桌面和编码任务，管理审批，并安全限制其访问文件和项目的权限。

AI我搜编辑部阅读约 8 分钟
Capri 教程：为 Windows 桌面设置赛博朋克 AI 智能体

什么是 Capri？

Capri 是一款采用赛博朋克风格的 Windows AI 智能代理。它提供原生桌面界面，以及面向 Claude Code、Codex 和 Antigravity 等 AI 助手的代理层。你无需只通过终端操作，只需用自然语言描述目标，Capri 就会将请求转交给你选择的助手，协调工具并报告结果。

Capri 可以处理文件、项目文件夹、代码、Shell 命令、应用程序以及与网页相关的任务。它既适合开发者，也适合希望在桌面上使用通用助手的用户。

该应用目前支持 Windows 10 或更高版本。macOS 和 Linux 支持已列入计划，但目前尚未提供。

主要功能

  • 多种 AI 引擎：通过自定义适配器使用 Claude Code、Codex、Antigravity 或其他助手。
  • 原生桌面界面：通过图形应用操作，无需仅依赖终端工作流。
  • 文件和项目操作：让 Capri 查找、读取、整理、编辑或分析文件和文件夹。
  • 代理工作流：Capri 可以规划任务、使用工具、检查结果并解释执行情况。
  • 代码辅助：使用你偏好的引擎编写、重构、调试和运行代码。
  • 自动化：将重复性事务转化为自然语言请求。
  • 审批控制：在敏感操作执行前查看并批准或拒绝这些操作。
  • 赛博朋克界面：使用深色、霓虹风格的桌面体验。

在 Windows 上安装 Capri

1. 下载发行版本

打开最新的 Capri 发行版本，并选择一个可用的 Windows 软件包：

  • Capri-Setup.exe：使用安装程序进行常规安装，并创建开始菜单快捷方式。
  • Capri-Portable.zip：如果你希望无需安装、直接从文件夹运行 Capri，请使用便携版。

2. 启动应用

对于安装程序版本，运行 Capri-Setup.exe，完成安装向导，然后从开始菜单打开 Capri。对于便携版，将 Capri-Portable.zip 解压到文件夹中，并从该文件夹运行应用。

由于 Capri 是较新的应用，Windows SmartScreen 可能会显示警告。如果你从代码仓库的官方 Releases 页面下载了文件，请选择更多信息，然后选择仍要运行。

3. 连接 AI 助手

首次启动时，Capri 会询问你想使用哪个助手。选择可用的引擎，然后登录账户或提供所需的 API 密钥。Capri 开箱即支持 Claude Code、Codex 和 Antigravity。其他助手可以通过自定义适配器连接。

你选择的引擎决定了处理请求的 AI 系统，而 Capri 则提供桌面界面、请求路由、工具和审批工作流。

运行你的第一个任务

用自然语言描述目标

从一个具体请求开始，说明你希望 Capri 完成什么。例如：

整理我的下载文件夹，并按类型归类所有内容。

Capri 可以扫描文件夹、提出计划，并在你批准后移动文件。首次测试时，请使用不包含不可替代数据的文件夹。

尝试编码任务

Capri 可以使用已连接的引擎检查项目、定位问题、修改代码并运行检查。你可以这样请求：

找出这个项目中的错误，解释原因，修复它，并运行现有检查。

当任务涉及修改文件或执行命令时，请在批准前查看拟执行的操作。

处理文档

你还可以让 Capri 处理多个文件并生成合并结果：

将此文件夹中的每个 PDF 总结到一份文档中。

助手可以读取文件并撰写汇总内容，但具体取决于 Capri 可用的权限和访问范围。

Capri 如何处理请求

  1. 描述目标：用自然语言提出请求。
  2. 路由请求：Capri 将请求发送给你选择的 AI 引擎。
  3. 规划工作：引擎确定所需的步骤和工具。
  4. 请求批准：Capri 让你有机会批准敏感操作。
  5. 执行并报告：Capri 使用相关工具并报告结果。

工具层可以处理文件和项目、Shell 与应用程序，以及与网页相关的任务。审批环节旨在确保当某项操作可能改变系统或数据时，你仍能参与其中。

选择和切换引擎

Capri 直接支持 Claude Code、Codex 和 Antigravity。README 还介绍了通过自定义适配器支持其他助手。请选择最适合当前任务的引擎，并在其他助手更适用时进行切换。

例如，你可以使用一个引擎执行编码工作流，使用另一个引擎处理常规桌面任务。具体的登录或 API 密钥流程取决于你连接的助手提供商。

配置权限和界面

README 提供了以下示例配置：

engine: claude-code        # claude-code | codex | antigravity | custom

permissions:
  mode: ask                # 执行前询问 | 自动 | 只读
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

engine 设置用于选择已连接的助手。权限模式可配置为执行前询问、自动运行或使用只读访问权限。allowed_folders 列表限制 Capri 可以访问的位置，界面配置则选择赛博朋克主题。

在熟悉应用期间，请使用限制性设置。先从 mode: ask 开始，并且只允许任务所必需的文件夹。

高级用法与自动化技巧

明确界定任务范围

好的请求应明确位置、预期结果和限制条件。不要要求 Capri 整理所有内容，而应指定一个文件夹，并说明应如何对项目进行分组。这样更容易审核拟定的计划。

谨慎自动化重复性事务

Capri 旨在将重复性事务简化为一句话。项目中的示例包括设置并启动新的 Web 应用，或请求定期备份 Documents 文件夹。启用持续工作流之前，请审核生成的操作，并确认目标位置和文件均正确。

路线图另行列出了计划中的任务调度器，因此不要假设发布版本的应用当前已提供所有调度功能。

在需要时使用自定义适配器

如果你偏好的助手不属于内置引擎之一，项目说明可以通过自定义适配器连接其他助手。在规划自定义集成之前，请查看当前版本的文档和仓库问题，了解实现细节。

安全建议

  • 批准前审核操作：特别注意文件删除、移动、覆盖以及 Shell 命令。
  • 限制文件夹访问：只授予 Capri 当前任务所需目录的访问权限。
  • 维护备份：执行大型或自动化操作前，请备份重要数据。
  • 保护凭据：切勿分享 API 密钥、账户令牌或其他身份验证信息。
  • 查看服务商政策：请求由你连接的 AI 助手处理，并受该服务商的条款和隐私政策约束。

Capri 的设计允许你审核操作，但任何桌面自动化工具都不是完全没有风险。请将批准提示视为安全边界，而不是麻烦。

故障排除与支持

如果 Windows 阻止应用运行，请确认你是从项目的官方 Releases 页面下载的，然后再使用 SmartScreen 绕过选项。如果助手无法连接，请检查所选引擎、登录状态以及 API 密钥或账户凭据。

如需提出功能请求或报告问题，请使用仓库的问题跟踪器。项目路线图包括 macOS 和 Linux 版本、插件系统、移动端 companion 应用，以及社区赛博朋克主题画廊。

结语

Capri 将 Windows 桌面界面与你已经在使用的 AI 助手结合起来。下载安装程序或便携版后，连接一个引擎，描述任务，并在允许 Capri 操作你的文件、项目和应用之前审核拟定的操作。先从有限权限和简单请求开始，然后逐步扩展到编程工作流以及经过仔细审核的自动化任务。