跳到主要内容
返回开发者精选

MiniCPM Desk Pet

作者：OpenBMB模型：MiniCPM5-1B

MiniCPM Desk Pet 是一个本地优先（local-first）的桌面宠物应用。它把 MiniCPM 小模型直接跑在你自己的电脑上，让桌面上多一个能聊天、会陪你写代码的小伙伴 —— 下载安装、跟随首次启动引导完成设置，就能开始使用，日常聊天不依赖任何远程推理服务。

GitHub

MiniCPM Desk Pet 是一个本地优先（local-first）的桌面宠物应用。它把 MiniCPM 小模型直接跑在你自己的电脑上，让桌面上多一个能聊天、会陪你写代码的小伙伴 —— 下载安装、跟随首次启动引导完成设置，就能开始使用，日常聊天不依赖任何远程推理服务。

三个特点：

  • 本地运行：模型在本机推理，聊天内容不上传云端，隐私可控、可离线使用
  • 轻量小巧：默认使用 MiniCPM5-1B 模型，约 2 GB 磁盘空间即可运行
  • 陪你工作：能根据 coding agent 的状态做出思考、工作、完成等不同反应

一、快速开始​

系统要求​

系统类型推荐配置
macOS14.0+，Apple Silicon (M1/M2/M3/M4)，约 2 GB 磁盘空间
Windowsx64，需 Vulkan 支持，约 2 GB 磁盘空间

macOS Apple Silicon 是当前主要验证平台；Windows 已提供安装包，欢迎反馈问题。

安装步骤​

macOS

  1. 前往 Releases 下载最新 MiniCPM Desk Pet-*-arm64.dmg。
  2. 打开 DMG，将 MiniCPM Desk Pet 拖入 Applications。
  3. 启动应用，按引导完成设置。 如果 macOS 阻止首次打开，可以右键应用选择「打开」。必要时也可以在终端移除隔离标记：
Bash
xattr -cr /Applications/MiniCPM\ Desk\ Pet.app

Windows

  1. 前往 Releases 下载最新 .exe 安装程序。
  2. 运行安装向导，按提示完成安装。
  3. 启动应用，按引导完成设置。

首次启动​

MiniCPM Desk Pet 内置完整的首次启动流程，跟着走完即可：

环境检查 → 模型下载 → 模型预热 → 开始使用

默认模型是 MiniCPM5-1B-GGUF。你可以让应用自动下载，也可以选择已有的本地 .gguf 文件（适合已经下载过模型的情况）。

二、核心功能​

装好之后，MiniCPM Desk Pet 主要能陪你做这几件事。每个功能都包含它是什么、以及怎么用。

桌面上的本地聊天伙伴​

随时用快捷键唤出悬浮聊天气泡，直接和 MiniCPM 对话 —— 问问题、写点东西、闲聊都可以。因为模型跑在本地，聊天内容不会离开你的电脑，适合对隐私敏感或需要离线使用的场景。

图片展示的是MiniCPM Desk Pet的界面。背景为清澈的蓝色水域，画面右侧有一个像素风格的紫色猫咪形象，猫咪张着嘴巴，眼睛闪烁着星星。左侧有一个白色对话框，内有文字介绍，内容为“你好，我是MiniCPM系列模型，由面壁智能和OpenBMB开源社区开发。详细信息请访问https://github.com/OpenBMB/”。该图片与文档中介绍MiniCPM Desk Pet核心功能的部分相关，直观呈现了桌宠的外观及部分功能介绍。

常用快捷键（macOS 为 Cmd，Windows 为 Ctrl）：

快捷键作用
Cmd/Ctrl+Shift+M打开或关闭 MiniCPM 聊天气泡
Cmd/Ctrl+Shift+T显示或隐藏思考模式
Esc输入框聚焦时关闭气泡

写代码时的状态陪伴​

把桌宠放在工作区旁边，它会随着 coding agent 的运行状态切换神态：正在思考、正在工作、任务完成、等待你关注、休息等。长时间敲代码时，多一个有反应的小伙伴陪着你。

图片展示的是MiniCPM桌面角色的形象，为像素风格的猫型角色。其身体主体为白色，带有蓝色和紫色的装饰，头顶有紫色条纹，眼睛为蓝色，身体两侧有类似翅膀的结构，尾巴呈��弯曲状。该图片位于文档介绍MiniCPM桌面角色部分，直观呈现了应用内置的neko风格人格适配器的形象，与上下文提到的在「Settings→MiniCPM」中可切换适配器的内容相呼应。 思考中

图片展示的是MiniCPM桌面角色的形象。角色为一只拟人化的猫，头戴紫色头带，身穿白色服装，胸前有蓝色装饰，手持一台带有蓝色标志的笔记本电脑。背景为纯绿色。该图片位于文档介绍MiniCPM桌面角色功能的上下文部分，直观呈现了应用内置的neko风格人格适配器的形象，与上下文提到的“应用内置neko风格人格适配器”等内容相呼应。 工作中

图片展示的是MiniCPM桌面角色的形象。它是一只像素风格的猫，身体为白色，带有紫色条纹，胸前有蓝色圆形装饰，四肢和尾巴末端也是紫色。猫眼为蓝色，表情可爱。背景为鲜亮的绿色，周围有紫色和黄色的星星点缀。此图位于文档介绍MiniCPM核心功能中“思考中”部分，直观呈现了桌面角色的形象，与上下文介绍的桌面角色相关。 任务完成

可定制人格的桌面角色​

应用内置 neko 风格人格适配器。你可以在「Settings → MiniCPM」中切换适配器，也可以导入自己的适配器，让桌宠的说话风格更符合你的喜好。

这张图是MiniCPM桌面宠物应用的“人格LORA”设置界面，对应文档中“可定制人格的桌面角色”相关内容。界面包含当前LORA选项，已选中默认的Base选项，下方有Neko选项（标注“NEKO”），说明可切换桌宠人格，旁白固定走Base模型；界面下方还有“Upload LoRA”“打开存储目录”“刷新”三个操作按钮，用于实现适配器的导入、管理等定制功能，符合文档中可切换或导入人格适配器的功能描述。

模型管理​

在「Settings → MiniCPM」设置页，你可以：

  • 下载默认模型或选择本地模型文件
  • 重新运行首次启动引导
  • 管理角色 / 人格适配器
  • 在需要时重启本地模型运行环境

这张图片是MiniCPM Desk Pet的「Settings→MiniCPM」设置页面，核心展示模型管理相关设置：红框标注的模型区域内，当前选用的模型为MiniCPM5 0.9B，对应的文件路径为/Users/sal/Downloads/MiniCP5-0.9B-08_0.gguf，还设有“Show in folder”与“更换”的操作按钮，页面右上角显示“运行中”状态，同时页面还呈现了行为设置相关选项，如桌宠旁白开关、默认思考模式开关，以及人格LoRA设置选项，体现了该设置页可完成模型选择、人格相关配置的功能。

三、已知限制​

回复速度会受到芯片、内存压力和模型选择的影响。 Coding Agent 状态反应依赖各工具自身的集成方式，不同版本之间可能存在差异。

四、开发者与致谢​

开发者说明：开发环境、打包流程和仓库结构见 docs/development.md。

路线图：

扩展 Linux 验证 · 增加更多人格预设 · 优化模型下载提示、重试和诊断体验 · 缩短首次启动耗时、减小应用体积 · 为长时间 coding 会话提供更丰富的桌宠旁白。

致谢：

桌宠 UI 基于 rullerzhou-afk/clawd-on-desk。完整归属信息见 NOTICE.md。 模型权重来自 OpenBMB MiniCPM 模型家族，并在使用时单独下载。 内置 neko 人格使用 NekoQA-30K 数据集作为微调数据。

项目信息

基于模型
MiniCPM5-1B
作者
OpenBMB