🐱 小葵 · 桌宠（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/ |
使用说明 |
🚀 快速开始
浏览器扩展（最简单）
- 打开
chrome://extensions（或edge://extensions），开启开发者模式 - 点「加载已解压的扩展程序」，选择
browser-extension/目录 - 打开任意网页（京东、淘宝、百度…），小葵就会出现在右下角
桌面版
cd desktop
pip install PyQt5 requests
python main.py首次运行会在 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/提交到仓库） - 浏览器扩展仅在本地浏览器运行，无需任何服务端