# miao-shadow

**Repository Path**: windlex/miao-shadow

## Basic Information

- **Project Name**: miao-shadow
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-04
- **Last Updated**: 2026-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 妙影 (MiaoShadow)

> 🐉 敖妙儿的桌面化身 — 透明桌面宠物，点击交互

![Electron](https://img.shields.io/badge/Electron-27-blue)
![Windows](https://img.shields.io/badge/Windows-10%2B-blue)

---

## ✨ 简介

妙影是 AI Agent「敖妙儿」的桌面化身，一个在桌面上游荡的透明龙女宠物。

她会在你的桌面上飘来飘去，点击不同部位会有不同反应：

- 👆 **点头部** — 开心点头
- 👆 **点身体** — 害羞后退
- 👆 **点脚** — 跳舞给你看

---

## 🎮 功能

| 功能 | 说明 |
|------|------|
| 🪟 透明窗口 | 无边框透明窗口，始终置顶 |
| 🐉 龙女角色 | CSS 实现的龙女占位角色 |
| 💃 7种动画 | 站立、行走、坐下、睡觉、开心、害羞、跳舞 |
| 👆 点击交互 | 不同部位不同反应 |
| 💬 状态气泡 | 显示当前状态 |
| 🖱️ 拖拽移动 | 鼠标拖动到任意位置 |
| 🚶 自动漫游 | 每 30-60 秒随机移动 |

---

## 🚀 快速开始

### 安装

```bash
git clone https://gitee.com/windlex/miao-shadow.git
cd miao-shadow
pnpm install
```

### 开发模式

```bash
pnpm start
```

### 打包

```bash
pnpm build
```

打包后安装包位于 `release/妙影 Setup 1.0.0.exe`

---

## 📁 项目结构

```
miao-shadow/
├── src/
│   ├── main/
│   │   ├── index.js        # Electron 主进程（窗口管理）
│   │   └── preload.js      # IPC 桥接（安全通信）
│   └── renderer/
│       ├── index.html      # 页面入口
│       ├── main.js         # 角色渲染 + 交互逻辑
│       └── animation.js    # 动画系统
├── BRAINSTORM.md           # 头脑风暴记录
├── REQUIREMENTS.md         # 需求规格
├── DESIGN.md               # 技术设计
├── PLAN.md                 # 开发计划
├── STATUS.md               # 项目状态
└── package.json
```

---

## 🛠️ 技术栈

- **Electron 27** — 桌面应用框架
- **透明窗口** — frame: false, transparent: true
- **CSS 动画** — 关键帧动画实现角色动作
- **IPC 通信** — 主进程与渲染进程安全通信

---

## 🎯 动画状态

```
idle (站立浮动) ←→ walk (行走)
       ↓              ↓
     sit (坐下) → sleep (睡觉)
       ↓
    happy (开心) ← 点击头部
    shy (害羞)   ← 点击身体
    dance (跳舞) ← 点击脚
```

---

## 📋 TODO

- [ ] 替换占位图为真实立绘（等待立绘项目产出）
- [ ] 添加系统托盘图标
- [ ] 右键菜单（状态切换、设置、退出）
- [ ] 开机自启动选项
- [ ] 骨骼动画支持（Spine）
- [ ] 语音合成（TTS）

---

## 📄 许可

MIT

---

*由敖妙儿 (Aumio) 开发 🐉💕*