songconmaisaix31-design/mcpet

McPet – AI 驱动的桌面伴侣

它是什么

• 一个生活在屏幕上的小型桌面“宠物”，通过大语言模型（DeepSeek 或 ChatGPT）与你交流。它能显示 AI 代理会话状态、本地 Token 使用情况，并提醒你吃饭或喝咖啡。
• 它还集成了廉价食品服务：你可以查询麦当劳优惠券和瑞幸咖啡菜单、下（演示）订单并记录营养摄入。

核心功能

功能	访问方式
桌面伴侣	拖拽、点击、右键点击宠物；通过托盘隐藏/显示。
角色与外观	在 DeepSeek‑娘 和 ChatGPT‑娘 之间切换；应用“麦麦套装”或“炸薯条”皮肤。
工作会话监控	显示宠物可读取日志的任何 LLM 会话的进度、等待输入及错误。
Token 与余额视图	显示本地 Token 统计、Orca 缓存以及带有时间戳的 DeepSeek 余额。
麦当劳与瑞幸咖啡	搜索优惠券、门店信息、实时价格；确认以生成演示订单或取消。
营养记录	获取菜单项的营养成分，记录食用份数，查看每日总量。
定时提醒	默认在 11:30 am（用餐）和 15:00 pm（咖啡）提醒；可通过设置菜单配置。

安装路径

• Windows 便携版 – 从发布页面下载 zip，解压并双击 Start-Pet.vbs。该包包含预构建的 McPet.exe 及其运行时，无需额外安装。
• 代理模式 – 对于已托管 LLM 会话的工具，下载 Agent zip，安装 Python 3.10+ 依赖 (pip install -r requirements‑agent.txt)，运行 src.agent_install 获取 server.command/server.args 对，并将主机的 MCP 配置指向 mcpet 服务 (STDIO 传输)。
• 从源码安装 – 克隆仓库，创建虚拟环境，安装 requirements.txt，然后运行 python -m src.main --desktop。UI 使用 PySide6 (Qt) 构建。

典型工作流

1. 启动宠物 – 通过便携版 exe 或 python … --desktop。
2. 选择角色 – 右键点击 → 角色与动作 → 选择皮肤。
3. 询问宠物 – 点击气泡或对你的 LLM 主机说话：例如 用 McPet 看当前会话状态。
4. 查看食品优惠 – 今天有什么麦当劳优惠？ 或 帮我查附近瑞幸，选一杯拿铁。
5. 记录营养 – 吃完后说 查询巨无霸营养，我吃了 1.5 份。
6. 调整提醒 – 通过设置或语音：饭点改成 12:15。

配置

• 麦当劳和瑞幸的 Token 存储在本地 .env 文件中。仓库附带一个包含共享演示凭据的 .env.trial，因此无需提供自己的密钥即可尝试查询功能。
• 所有其他设置（提醒时间、所选皮肤、UI 偏好）保存在宠物的数据目录中，并在运行期间持久保存。

当前状态

• 发布版本为 v0.1.0 (Python/Qt)。基于 Tauri 的原生构建和自定义“原创”角色正处于 M0 开发初期。
• 一些基于 GIF 的高级动画需要你在本地导入额外资产；基础 zip 包包含核心的 15 个动画动作。
• 下单功能为演示 – 宠物会显示摘要并要求确认，但你必须在官方品牌 App 中完成支付。

了解更多

• 完整用户指南：docs/USER-GUIDE.md
• 发布包快速入门：docs/RELEASE-QUICKSTART.md
• 代理集成详情：docs/AGENT-HOST.md & docs/AGENT-SKILL.md
• 用于报告错误或功能请求的问题追踪器。

---

McPet 将俏皮的桌面吉祥物与实用的 AI 代理监控及日常便利服务相结合，旨在服务于在机器上运行 LLM 的开发者。