🐱 小葵 · 桌宠（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. 打开任意网页（京东、淘宝、百度…），小葵就会出现在右下角

桌面版

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/ 提交到仓库）
• 浏览器扩展仅在本地浏览器运行，无需任何服务端