Coopanion：AI 桌面宠物伙伴

项目简介

Coopanion 是一款跨平台桌面宠物应用，主角 Coo 住在屏幕底边，以气泡对话、语音输入和沿边行走陪伴使用者。它基于 Cortico 与 Electron 构建，支持 Windows、macOS 和 Linux。

应用界面与首次引导支持简体中文、繁体中文、英语、日语、韩语、法语、德语、西班牙语（拉美）、葡萄牙语（巴西）、意大利语和俄语，新安装跟随系统语言。

主要功能

• 多模型服务：支持 OpenAI、Anthropic、Gemini、xAI、OpenRouter、DeepSeek、Kimi、Qwen、MiniMax、智谱 GLM、豆包、百度千帆、StepFun，也可通过 ChatGPT 账号与套餐使用。
• 聊天与语音：按住说话键讲话，或直接打字，Coo 用气泡回答；语音通过 FunASR 或 Whisper 在本机识别。
• 记忆：Coo 记得聊过的内容和被戳、摸头的时刻；关于使用者的信息写在它的工作区 PARTNER.md 中，工作区改动会保留版本。
• 电脑操作：可以点击按钮、输入文字、切换窗口，执行前会先征求同意。
• 活动气泡：思考、阅读、搜索、写作或操作电脑时，会用动态图标显示状态。
• 形象与装扮：默认形象为 Coo，也可选完全动画的 DeepSeek Chan 鲸鱼少女，带八种厂商配色和三套服装；还能调整 Coo 的颜色、帽子、耳环、眼镜、颈饰、大小和行走频率。
• 闹钟：可以让 Coo 按本地时间或若干分钟后设置提醒。
• 扩展：从扩展市场安装 QQ 机器人、画室、小游戏等 World 扩展。
• OBS overlay：把 Coo 和气泡作为透明背景的 OBS 浏览器源使用。

安装与使用

运行需要 Windows 10/11（64 位）、macOS 13 或更高版本，或 64 位 Linux 桌面（X11，或 Wayland 下的 XWayland）；语音识别需要 glibc 2.32 或更高版本，例如 Ubuntu 22.04、Debian 12 及以后。安装不需要管理员权限。使用前需要准备某个模型服务的 API Key，或带套餐的 ChatGPT 账号。

Windows：可从最新 Release 下载安装包运行，或在 PowerShell 执行：

irm https://raw.githubusercontent.com/Pal-AI-Lab/Coopanion/main/installer/install.ps1 | iex

也提供免安装的 portable 压缩包，解压后运行 Coopanion.exe，数据留在文件夹内的 data 目录。portable 版不会自动更新。

macOS：从最新 Release 下载对应 Apple silicon 或 Intel 的 .dmg，打开后把 Coopanion 拖入 Applications。

Linux：Debian/Ubuntu 可安装 .deb，其他发行版可用 AppImage：

sudo apt install ./Coopanion-<version>-linux-x64.deb
chmod +x Coopanion-*.AppImage

启动后 Coo 会落到屏幕底部，并在托盘或菜单栏出现图标。首次引导会询问称呼、性格、行走频率、模型服务，以及是否下载语音模型（来自 ModelScope，FunASR 约 230 MB；部分应用语言下 Whisper 约 360 MB）。之后按住 Left Alt（Mac 为 Left Option）说“hello”并松开即可发送。

注意事项

• Windows 安装包未代码签名，可能触发“Windows 已保护你的电脑”，需要点击“更多信息”→“仍要运行”。macOS 应用也没有 Apple 开发者签名，首次打开需在“系统设置 → 隐私与安全性”中点击“仍要打开”。
• macOS 会根据功能请求麦克风、输入监控、屏幕与系统音频录制、辅助功能等权限；更改后需重启 Coopanion，系统更新版本后可能需要在权限列表中重新添加应用。
• 记忆版本功能在 Windows 构建中自带 git；macOS 和 Linux 需要自行安装 git。
• Linux 的桌宠是透明置顶窗口，需要桌面开启合成；托盘图标需要状态图标支持。电脑操作需要 xdotool 和 zenity，Wayland 下截图还需要 grim、spectacle、scrot 或 ImageMagick 之一。
• 模型服务按使用量向服务商计费；使用 ChatGPT 账号时，请求计入该账号套餐的用量限制。

---

本作品整理自 GitHub 开源项目 Pal-AI-Lab/Coopanion，原作者 @Pal-AI-Lab。中文介绍由 AI 根据项目 README 整理，以原仓库为准。