collapsey/xiaokui-pet

README 摘要

🐱 小葵 · 桌宠（XiaoKui Desktop Pet） 一只黏人、贪吃、爱撒娇的玳瑁小猫咪「小葵」，可以出现在 Windows 桌面 、 浏览器网页 和 DeepSeek Harness 界面 里。 ✨ 特性 - 透明无边框猫咪动画（真实 GIF，14 种动作） - 拖拽移动 / 滚轮缩放 - 互动：喂食 🍖、玩耍 🎾、睡觉 💤、巡逻 🐾（以浏览器/桌面边界往返） - 萌宠时钟 ⏰（专注倒计时 + 全屏霸屏提醒） - 喵份证 📋、收起圆球 ⚪ - 属性养成：心情 / 饱腹 / 能量 / 亲密度（每小时衰减、localStorage/本地持久化） - 自动气泡（饿了/求玩）、饱腹过满自动拉粑粑 📦 组成部分 目录 说明 desktop/ Windows 桌面版 （Python + PyQt5，PyInstaller 打包 exe） browser-extension/ 浏览器扩展 （Chrome/Edge，小葵悬浮在任意网页上） dsh-plugin/ DeepSeek Harness 客户端插件 （聊天界面里的猫咪，TypeScript + React） docs/ 使用说明 🚀 快速开始 浏览器扩展（最简单） 1. 打开 chrome://extensions （或 edge://extensions ），开启 开发者模式 2. 点「加载已解压的扩展程序」，选择 browser-extension/ 目录 3. 打开任意网页（京东、淘宝、百度…），小葵就会出现在右下角 桌面版 首次运行会在 desktop/config/ 生成 ai config.json ，填入你的 DeepSeek API Key 即可启用聊天。 DSH 插件 dsh-plugin/ 是 DeepSeek Harness 的 client 插件（ @deepseek-ai/dsh-client-ui-xiaokui ），按 harness 的 client-plugin 流程构建挂载。 📜 素材 猫咪动画 GIF 为本地素材，已压缩（单个 2 4MB），位于各组件 assets/ 或 catstar/ 目录。 ⚠️ 说明 - 桌面版 AI 聊天需要 DeepSeek API Key（请勿把含 Key 的 config/ 提交到仓库） - 浏览器扩展仅在本地浏览器运行，无需任何服务端

分类