MiniCPM Desk Pet

在代码行间穿梭时，是否希望有一个懂你节奏的伙伴？MiniCPM Desk Pet 是一款本地优先的 AI 桌面宠物应用。它不仅能作为你的聊天伴侣，更能智能感知你在使用 Cursor、Claude Code、Codex 等编程工具时的状态，通过丰富的表情和动作与你互动。

无需联网推理，所有对话均在本地完成，保护隐私的同时提供即时的陪伴感。

核心亮点：懂代码，更懂你

1. 实时感知工作状态

• 智能联动：自动检测主流 Coding Agent（如 Cursor, Claude Code, Codex）的活动状态。
• 动态反馈：根据你是正在思考、编码、完成任务还是休息，桌宠会展示不同的表情和动作（如思考状、忙碌状、庆祝状等），让编程过程更具沉浸感。

2. 纯本地运行，隐私无忧

• 离线聊天：模型下载完成后，所有对话均在本地电脑上进行，无需依赖远程 API，响应速度快且数据不出域。
• 轻量部署：仅需约 2 GB 磁盘空间，默认搭载 MiniCPM5-1B-GGUF 模型，在 Apple Silicon 和现代 Windows 设备上流畅运行。

3. 个性化人格系统

• 内置角色：默认提供可爱的 Neko 风格人格。
• 自由导入：支持在设置中切换或导入自定义的角色适配器（Adapter），打造独一无二的桌宠性格和语气。

4. 零配置上手

• 一键引导：首次启动自动完成环境检查、模型下载（支持 Hugging Face/ModelScope 智能选源）及模型预热。
• 悬浮交互：通过悬浮气泡随时唤起聊天，快捷键控制，不打断工作流。

快速开始指南

1. 系统要求

• macOS: 14.0+，Apple Silicon (M1/M2/M3/M4)，约 2 GB 空间。
• Windows: x64 架构，需支持 Vulkan，约 2 GB 空间。
• 网络: 首次启动需联网下载模型（也可手动选择本地 .gguf 文件）。

2. 安装步骤

macOS:

1. 从 Releases 页面下载最新 MiniCPM Desk Pet-*-arm64.dmg。
2. 打开 DMG，将应用拖入 Applications 文件夹。
3. 若被拦截，右键点击应用选择“打开”，或终端执行 xattr -cr /Applications/MiniCPM\ Desk\ Pet.app 移除隔离标记。

Windows:

1. 从 Releases 页面下载最新 .exe 安装程序。
2. 运行安装向导，按提示完成安装。

3. 首次启动

应用将自动引导你完成：
环境检查 → 模型下载 → 模型预热 → 开始使用

常用操作与快捷键

• 唤起/关闭聊天气泡: Cmd/Ctrl + Shift + M
• 显示/隐藏思考模式: Cmd/Ctrl + Shift + T
• 关闭气泡: Esc (当输入框聚焦时)

功能详解

1. 和本地桌宠聊天

点击悬浮气泡即可开始对话。无论是询问代码问题、闲聊解闷，还是寻求灵感，MiniCPM 都能即时响应。

2. 模型与人格管理

在 Settings -> MiniCPM 中，你可以：

• 重新下载默认模型或加载本地 .gguf 文件。
• 切换或导入人格适配器（Character Adapter）。
• 重启本地模型运行环境以释放内存或应用新配置。

3. 工作状态反应

桌宠会常驻在工作区旁，默默观察你的编码进程：

• Thinking: 当你暂停输入或 Agent 正在推理时。
• Working: 当检测到代码生成或文件修改活动时。
• Done: 任务完成时的庆祝动画。
• Idle/Rest: 长时间无操作时的休息状态。

路线图与已知限制

• 未来计划:
  • 扩展 Linux 平台支持。
  • 增加更多预设人格（如极客、导师、助手等）。
  • 优化下载体验与诊断工具。
  • 为长时间 Coding 会话提供更丰富的旁白互动。
• 已知限制:
  • 目前主要验证平台为 macOS Apple Silicon；Windows 版本欢迎反馈问题。
  • 回复速度受芯片性能、内存压力及模型复杂度影响。
  • Coding Agent 状态识别依赖各工具的集成接口，不同版本可能存在差异。

MiniCPM Desk Pet 不仅仅是一个桌面装饰，它是你编程旅程中的智能伙伴。它将强大的本地小模型（MiniCPM5-1B）与有趣的交互设计结合，让枯燥的代码世界变得生动温暖。

无论你是 macOS 用户还是 Windows 开发者，只需几分钟安装，就能拥有这个懂代码、有性格、保护隐私的 AI 小伙伴。立即下载，让你的桌面“活”起来！