# BounceChat

**Repository Path**: cnt-code/bounce-chat

## Basic Information

- **Project Name**: BounceChat
- **Description**: BounceChat 是一个独特的桌面伴侣应用，它不只是一个静态桌宠，而是一个遵循物理规律、会在屏幕上真实弹跳并能与其他窗口碰撞、还能用AI陪你聊天的小家伙。项目用Python+PyQt5 实现了物理引擎，通过WindowsAPI实时检测应用窗口并发生碰撞，接入大模型后能以“弹跳小伙伴”的身份与你对话，界面采用半透明气泡输入框，支持鼠标拖拽抛掷、方向键控制等交互，让枯燥的屏幕多一个会动会聊天的伙伴
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: project
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 2
- **Created**: 2026-02-19
- **Last Updated**: 2026-02-21

## Categories & Tags

**Categories**: ai

**Tags**: AI, Windows, Python

## README

# BounceChat | 会弹跳的AI智能桌面小球

<div align="center">
  <h3>🏀 你桌面上那个会弹跳、会聊天的小家伙</h3>
  <p><i>点一下，它就陪你玩；不点它，它就自己玩</i></p>
</div>

![](show/3.png)

---

## 它是什么？

**BounceChat 不是一个普通的桌宠。**

它不是那种趴在屏幕角落一动不动的贴纸，也不是每隔半小时跳出来烦你的弹窗。

它是一个**真正会动**的小家伙——遵循物理规律，受重力影响，有摩擦力，会碰撞反弹。你把它丢出去，它真的会滚；你把它扔向浏览器窗口，它真的会弹开。

而且，**它会说话**。

![](show/5.png)

---

## 它能干什么？

### 🏀 **像真球一样弹跳**
- 受重力影响自然下落
- 撞到屏幕边缘会反弹
- 速度太慢时会停在地面（就像真球一样）
- 拖动后松开，它会按你抛出的方向继续滚动

### 🪟 **跟你的窗口玩游戏**
- 自动识别桌面上打开的窗口（浏览器、文件夹、应用）
- 撞到窗口边缘会弹开
- 窗口移动了？它也知道

### 💬 **陪你聊天**
- 点击小球，它会弹出气泡
- 输入框出现，你可以打字
- 接入大模型，它会以“弹跳小伙伴”的身份回复你
- 回复很短（≤20字），不啰嗦，刚刚好

### 🎮 **怎么玩都行**
| 操作 | 会发生什么 |
|------|-----------|
| 点击小球 | 弹出聊天气泡 + 输入框 |
| 按住小球拖动 | 把它扔到任何地方 |
| 松开鼠标 | 它会按你扔的方向滚出去 |
| 按方向键 | 给它一个推力（需要先选中它） |
| 输入文字按回车 | 它会回复你 |

![](show/4.png)
---

## 为什么要有它？

说实话，**没什么必须的理由**。

它不是生产力工具，不能帮你写代码，不能帮你做PPT。

但它可以让你的桌面**不那么无聊**。

工作累了？把小球拖起来扔两下，看它弹来弹去。
想摸鱼了？跟它聊两句，它会告诉你“今天很开心”。
不想理它？它就自己在角落里弹跳，不吵不闹。

**一个不会烦你的陪伴，刚刚好。**

![](./show/1.png)
---

## 两分钟跑起来

```bash
# 把它请到你电脑上
git clone git clone https://gitee.com/cnt-code/bounce-chat.git

cd bouncechat 的位置

# 装点东西
pip install -r requirements.txt

# 让它跑起来
python main.py
```

没了。

哦对，需要配个API密钥（不然它不会说话），在 `chat.py` 填一下空空就好（目前代码里面接入的模型是模力方舟的DeepSeek-3.1，想要换其他模型自己改就好）

**[模力方舟模型广场](https://moark.com/serverless-api)**

每日免费一百次

---

## 谁适合玩这个？

- **觉得桌面太死板的人**——让它活起来
- **写代码写累了想摸鱼的人**——扔两下小球解压
- **好奇AI还能这么玩的人**——桌面级AI陪伴新姿势
- **想学 PyQt5 但不想看枯燥教程的人**——代码在这，自己看

---

## 它用什么做的？

- **Python** + **PyQt5** —— 让它能跑在桌面上
- **Windows API** —— 让它看得见你的窗口
- **模力方舟API** —— 让它会说话
- **HTML/CSS/JS** —— 让气泡好看点

代码都在这里，想看细节自己翻。

---

## 几句实话

- 它不是商业产品，是一个**写着玩但写着写着就认真了**的项目
- 可能会有小bug，但应该不影响玩
- 如果你觉得有意思，**给个 Star** 就行
- 如果你想改点啥，**随便提 PR**

![](show/2.png)

---

## 最后

<div align="center">
  <p>你的桌面，是不是缺一个会弹跳的小伙伴？</p>
  <p>👇</p>
  <p><b>BounceChat</b></p>
  <p><i>点一下，陪你玩；不点它，自己玩</i></p>
  <br>
  <p>⭐ <b>Star</b> 一下，养个桌面小伙伴 ⭐</p>
</div>