# TypeWell

**Repository Path**: cnt-code/type-well

## Basic Information

- **Project Name**: TypeWell
- **Description**: TypeWell 是一款具有人体工学关怀的智能键盘分析工具，接入模力方舟平台提供的模型。它实时追踪按键习惯，通过热力图可视化手指使用频率，分析左右手平衡，识别最累的手指。AI教练会基于你的数据，生成个性化姿势优化建议和休息提醒。专注模式下，星系粒子带你沉浸放松。TypeWell不只记录敲击，更关心敲击背后的你。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: project
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-22
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 交互, 人工智能, Python, JavaScript, 系统

## README

# TypeWell | 智能键盘健康教练

<div align="center">

![TypeWell](https://img.shields.io/badge/TypeWell-键盘健康教练-blue)
![Python](https://img.shields.io/badge/Python-3.8+-green)
![PyQt6](https://img.shields.io/badge/PyQt6-6.4.0-orange)
![AI](https://img.shields.io/badge/AI-模力方舟-purple)

<h3>你的双手，值得被温柔以待</h3>


</div>

---

## 🌟 为什么需要TypeWell？

**每天敲击键盘上万次，你可曾想过——**

你的左手是否承担了太多？无名指是否已经疲惫？小指是否在默默忍受？

TypeWell 不只是又一个键盘统计工具。它是一位**温柔的键盘健康教练**，用AI分析你的打字习惯，发现潜在的劳损风险，给出温暖的优化建议。

> ✨ *由模力方舟提供AI服务支持*

---

## 🎯 三大核心功能

### 🔥 页面一：键盘热力图 · 实时监测

**一眼看清你的手指压力分布**

每个按键的颜色都在**实时变化**，反映使用频率：

| 颜色 | 频率 | 含义 |
|------|------|------|
| 🔵 蓝色 | 低频 | 较少使用的键 |
| 🟡 黄色 | 中频 | 正常使用区域 |
| 🔴 红色 | 高频 | 过度使用的键 |

**实时统计面板**：
- **总敲击次数**：今日累计按键
- **最热按键**：使用频率最高的键
- **左右平衡**：左右手使用比例
- **最累手指**：负荷最大的手指
- **使用次数**：该手指敲击次数

**手指排行榜**：点击按钮查看每根手指的详细排名，谁是今天最辛苦的"员工"一目了然。

![main](show/main.jpg)

---

### 🤖 页面二：AI键位分析 · 智能教练

**不止是数据，更是深度洞察**

基于你的使用数据，AI教练（模力方舟支持）会生成：

**分析维度**：
- 📊 **使用模式分析**：识别你的打字习惯和特点
- ⚠️ **风险预警**：发现潜在的劳损风险
- 💡 **个性化建议**：姿势优化、休息提醒、指法练习
- 📈 **长期追踪**：习惯改变效果评估

**特色体验**：**流式输出**，实时展示AI的推理过程，让你看到分析是怎么一步步得出的。

![ai](show/AI.jpg)
---

### 🌌 页面三：专注星系 · 沉浸放松

**让双手在星空下休息**

当需要休息时，一键进入**专注星系模式**：

🌟 **星系粒子动画**：每个粒子都随着你的呼吸节奏缓慢移动，形成一个动态的星系。

![星系粒子动画](show/star.jpg)

---


## 🚀 快速开始

### 环境要求
- Python 3.8+
- Windows

### 一键安装
```bash
# 克隆仓库
git clone https://gitee.com/cnt-code/type-well.git
cd type-well

# 安装依赖
pip install -r requirements.txt

# 启动应用
python main.py
```

**Windows用户**：直接双击 `start.bat` 即可

---

## 🎮 使用指南

| 页面 | 功能 | 操作方式 |
|------|------|----------|
| **键盘热力图** | 实时监测按键频率 | 自动运行，无需操作 |
| **AI键位分析** | 获取个性化建议 | 点击"AI键位分析"按钮 |
| **专注星系** | 沉浸式放松 | 点击"专注模式"按钮 |

**页面切换**：通过按钮在三个页面间自由跳转

---

## 🛠️ 技术架构

| 组件 | 技术 | 作用 |
|------|------|------|
| GUI框架 | PyQt6 | 窗口管理和Web视图 |
| 键盘监听 | keyboard库 | 捕获全局按键 |
| 数据库 | SQLite | 持久化存储 |
| AI服务 | 模力方舟API | 智能分析 |
| 前端渲染 | HTML/CSS/JS | 界面展示 |
| 动画效果 | Canvas | 星系粒子渲染 |

---

## 💡 为什么选择 TypeWell？

| 对比维度 | 普通统计工具 | **TypeWell** |
|----------|------------|--------------|
| **热力图** | 静态显示 | 动态渐变 + 实时更新 |
| **手指分析** | ❌ 无 | ✅ 细化到每根手指 |
| **AI个性化建议** | ❌ 无 | ✅ 流式推理 + 深度分析 |
| **专注放松模式** | ❌ 无 | ✅ 粒子星系 + 动画 |
| **排行榜** | ❌ 无 | ✅ 详细手指排名 |
| **左右手平衡** | 粗略统计 | ✅ 精确计算 |

---

## 🤝 参与贡献

欢迎一起让 TypeWell 变得更好！

1. **提建议**：开 Issue 讨论新功能
2. **修Bug**：提 PR 修复问题
3. **分享**：推荐给需要的朋友

---

## 🙏 致谢

- 感谢 [模力方舟 (Gitee AI)](https://moark.com/serverless-api) 提供低成本模型API服务
- 感谢每一个愿意温柔对待双手的你

---

<div align="center">
  
**你的双手，值得被看见，被关怀，被温柔以待。**

**Type Well, Live Well.**

⭐️ 如果 TypeWell 对你有帮助，欢迎点个 Star！

</div>