CapriChooms/CapriCore

项目介绍

CapriCore 打包了 Capri——一个基于 OpenClaw 的 Windows 桌面角色伙伴。它把聊天助手和带动画形象的桌面角色结合在一起，对话可以跑在内置的本地 Qwen3.5 模型、导入的 Hugging Face GGUF 模型、Lemonade 这类本地 OpenAI 兼容服务，或云端 API（目前为 BETA）上。对话、记忆和可选的本地文档知识库在各模式间共用，切换推理后端不会清空聊天。

伙伴还提供可选的本地语音识别和语音合成、交流风格、表情动画与姿态、托盘模式，以及需授权才能使用的桌面操作，覆盖应用、文件、Spotify、Discord 和网页搜索。工具和图像能力取决于所选模型和授予的权限，电脑控制被明确标为 BETA。

在 Windows 上安装

目标平台是 Windows 10 22H2 或 Windows 11 x64。首次安装走安装向导，会为每个安装实例配置 Node/npm/Ollama 运行时和所选模型，不需要全局安装 Node 或 Python。

1. 从 v1.0.4 发布页下载并运行 CapriSetup-1.0.4.exe，或解压源码包后双击 Install Capri.cmd。
2. 在向导中选择本地模型、Hugging Face 模型，或 API 模式。API 模式会跳过本地对话模型的下载，默认启动时也不加载。
3. 完成向导后再打开 Capri.exe。同一个向导可以用现有安装目录修补缺失的运行时或依赖。

从早期私有渠道升级的用户应直接把 1.0.4 安装到原目录，不要先卸载；本地数据、已下载模型和设置会保留，后续更新检查切换到公开仓库。安装与修复细节见向导说明。

从源码运行

手动开发需要 Windows、Node.js 24.22.1（或更新的 24.x）、npm 和 Ollama，安装后重新打开 PowerShell。在包含 package.json 的目录中执行：

node --version
npm --version
npm ci
npm run doctor
npm run setup
npm run models:pull
npm run desktop

node --version 应显示 v24.22.1 或更新的 24.x。npm ci 按 lockfile 安装依赖；如果启动时报 Cannot find module 或 ERR_MODULE_NOT_FOUND，在同一目录重跑 npm ci。npm run setup 只记录硬件配置、不下载模型，npm run models:pull 只下载选定的文本模型和记忆嵌入模型。预留数 GB 磁盘空间，运行 npm stop 可释放受管资源。更多说明见安装与修复文档。

硬件与推理方式

最低要求 8 GiB 系统内存。内置 Qwen3.5 模型覆盖 0.8B 到 9B，另有 BETA 的 Ministral 3 3B 和 Gemma 4 E2B；项目给出了 32K 上下文下的内存/显存规划表，以及可选语音组件的单独估算。GPU 卸载取决于已安装的 Ollama 后端和驱动，CPU 推理和部分卸载更慢、更吃内存。16 GiB 内存加 16 GiB 显存并不能保证 9B 模型在 Windows、语音和其他程序同时运行下依然舒适。

使用云端 API 时，在「设置 → External AI provider」中选择预设或自定义 OpenAI 兼容端点。预设包括 OpenRouter、DeepSeek、Google Gemini、Hugging Face Inference Providers 和本地 Lemonade 服务；云端需要提供商签发的密钥和模型 ID，本机回环服务除非要求认证否则密钥留空。消息、相关记忆、已启用的工具结果，以及开启视觉后选中的屏幕图像会发送给提供商，费用和数据策略由提供商决定。

Hugging Face 支持接收受管 Ollama 运行时能够运行的 GGUF 量化文件；任意 Transformers 或 Safetensors 仓库不保证兼容，视觉还需要匹配的模型和投影文件。

使用约束与隐私

• 安装包未签名；发布者签名和更广泛的干净机器验证仍列为待完成工作，Windows SmartScreen 可能弹出警告。
• 每次启动时语音默认关闭。GPU 版 Chatterbox 需要 NVIDIA CUDA，或 Windows 11 上部分 AMD ROCm 显卡的实验性支持；CPU 版 Qwen3-TTS（BETA）预计额外占用 4–8 GiB 内存，速度可能慢于实时。
• 默认情况下 Capri 对自己的安装目录（含代码和配置）有读写权限，可在设置中撤销；其他文件夹、麦克风和屏幕访问需要分别授权。
• 对话历史、附件和普通记忆以本地方式存储但未完全加密，另有单独密码保护的私有记忆。API 密钥按 Windows 账户加密，诊断导出保存在本地，除非主动上传。
• 仅用 API、不含本地模型和语音的全新安装预计约 3 GiB 下载和 8 GiB 可用磁盘空间。
• 项目代码为 GPL-3.0-only；角色美术、语音、模型权重和第三方包各有独立条款。摄像头功能尚未实现。

HotRepo 点评

HotRepo 在 2026-11-14 的 JavaScript 新项目榜记录到 CapriCore，当时 103 Star、9 Fork，一个一小时的窗口内新增 3 Star；尚未记录到全语言日榜名次。这个信号很薄，说明不了采用情况。更有信息量的是技术层面：README 罕见地把内存/显存预算、模型兼容边界、安装包未签名，以及哪些数据会发给云端提供商都写清楚了。真正值得盯的是分发方式——安装器和预编译程序与公开源码的对应关系没有说明，打算长期使用的人应先依据文档中的约束和未签名构建做判断，再决定是否在一台机器上正式使用。