# pywz

**Repository Path**: testing-category/pywz

## Basic Information

- **Project Name**: pywz
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 LevelUp AI Coach 
> "Gamify Your Growth, AI Your Potential."

**LevelUp AI Coach** 是一个基于 **React 19 + Vite** 构建的沉浸式、游戏化考研备考助手。它不仅仅是一个番茄钟，更是一个运行在浏览器中的“伪软件”(PWA)，结合了 **DeepSeek R1 / Gemini / OpenAI** 等大模型能力，充当您的全天候私人考研教练。

本项目专为考研党设计，采用赛博朋克风格，支持 **桌面/移动端双端适配**，提供极致的专注体验与智能化的进度管理。

---

## ✨ 核心特性 (Key Features)

### 🎮 1. 游戏化专注系统 (Gamified Flow)
* **沉浸式计时器**：支持 `专注 (Focus)`、`休息 (Break)`、`无限加时 (Overtime)` 三种模式。
* **RPG 经验值升级**：每专注 1 分钟获得 1 点 XP，实时计算等级 (Lv.1 -> Lv.Max)，配备动态环形进度条。
* **黄金加时模式 (Golden Overtime)**：专注目标达成后可进入“加时模式”，触发全屏**金色粒子特效**，突破自我极限。
* **禅模式 (Zen Mode)**：一键隐藏所有复杂 UI，仅保留极简计时与 AI 生成的**动态励志语录**（自动屏蔽“解析”等无关文字）。

### 🤖 2. AI 智能导师 (AI Coach Integration)
* **多模型支持**：内置对接 **SiliconFlow (硅基流动)**、**DeepSeek 官方**、**Google Gemini**、**豆包**、**Kimi**、**阿里云** 等主流 API。
* **深度思考模式 (Deep Thinking)**：支持切换 AI 回复模式，开启后获取更深度的逻辑分析（ DeepSeek-R1 等推理模型）。
* **全息档案记忆**：AI 拥有“长短期记忆”，自动读取你最近 30 天的学习日志、科目进度和背景档案，提供个性化复盘。
* **每日自动复盘**：每天首次启动，AI 会隐式触发昨日常规复盘，分析战况并给予建议。
* **智能进度融合**：输入简单的打卡日志（如“做了660题”），AI 自动将其融合进对应的学科进度描述中。
* **多模态视觉分析**：支持上传题目或笔记图片，调用 Vision 模型（如 Gemini Pro Vision / DeepSeek-VL）进行分析讲解。

### 🛠️ 3. 硬核技术体验 (Technical Experience)
* **PWA 渐进式应用**：通过 `vite-plugin-pwa` 实现，可安装到桌面/手机，拥有独立图标和启动屏，支持离线加载。
* **防杀后台机制**：
    * **Web Worker 计时器**：利用 Worker 线程保持高精度计时，不受主线程阻塞影响。
    * **PiP 悬浮窗保活**：利用 HTML5 Canvas + Video 画中画模式 (Picture-in-Picture) 在后台持续渲染计时状态，防止浏览器休眠。
    * **Wake Lock API**：移动端专注期间自动保持屏幕常亮。
* **本地数据优先**：所有数据（历史记录、设置、API Key）均存储在浏览器 `LocalStorage`，安全隐私，无后端依赖。

### 📊 4. 数据与可视化 (Data & Stats)
* **学科进度看板**：英语、政治、数学、专业课(408) 四大维度进度追踪。
* **历史热力图**：查看每日投入时长，支持按日期回溯详细日志。
* **数据导入/导出**：支持导出完整 JSON 备份（含等级、配置、历史记录），随时迁移数据。

---

## 🛠️ 技术栈 (Tech Stack)

* **Core**: [React 19](https://react.dev/)
* **Build Tool**: [Vite 6](https://vitejs.dev/)
* **Language**: [TypeScript](https://www.typescriptlang.org/)
* **Styling**: [Tailwind CSS](https://tailwindcss.com/)
* **Icons**: [Lucide React](https://lucide.dev/)
* **PWA**: vite-plugin-pwa, Service Workers
* **AI Integration**: Fetch API (Stream Mode/SSE)

---

## ⚡ 快速开始 (Quick Start)

### 1. 环境准备
确保您的环境已安装 Node.js (推荐 v18+)。

### 2. 安装依赖

~~~bash
# 克隆仓库
git clone https://github.com/your-username/level-up.git

# 进入目录
cd level-up

# 安装依赖
npm install
# 或者
yarn install
~~~

### 3. 启动开发服务器

~~~bash
npm run dev
~~~

浏览器访问 `http://localhost:3000` 即可开始使用。

### 4. 构建生产版本

~~~bash
npm run build
~~~

---

## ⚙️ 配置说明 (Configuration)

### AI 模型配置
点击界面右上角的 **设置 (Settings)** 图标：
1. **API Provider**: 选择服务商（如 DeepSeek, SiliconFlow, Google 等）。
2. **API Key**: 输入对应服务商的 API Key（存储在本地，不会上传服务器）。
3. **Model**: 手动输入模型名称（如 `deepseek-ai/DeepSeek-R1`）或点击“获取列表”自动拉取。
4. **自定义 Persona**: 可定制 AI 导师的人设提示词。

### PWA 安装
* **Chrome/Edge**: 点击地址栏右侧的“安装应用”图标。
* **iOS Safari**: 点击分享按钮 -> "添加到主屏幕"。

---

## 📂 项目结构 (Project Structure)

~~~text
level-up/
├── index.html              # 入口 HTML (含 Splash Screen)
├── src/
│   ├── App.tsx             # 主应用逻辑 (包含所有核心组件)
│   ├── index.tsx           # React 挂载点
│   └── ...
├── public/
│   ├── manifest.json       # PWA 配置
│   ├── service-worker.js   # 缓存与离线逻辑
│   ├── icon_final.svg      # 应用图标
│   └── ...
├── vite.config.ts          # Vite 配置
├── tailwind.config.js      # Tailwind 配置
└── package.json            # 依赖管理
~~~

---

## 🤝 贡献与协议 (Contributing & License)

欢迎提交 Issue 或 Pull Request 来改进这个项目！

本项目基于 MIT License 开源。