🧮 TerryMath

TerryMath 是一款结合了优雅 UI 设计与 AI 智能分析的数学计算训练软件。它旨在通过系统化的出题引擎、智能的错题管理以及多维度的 AI 能力评估，帮助学生高效提升计算速度与准确率。

✨ 核心特性 (Features)

🎯 智能练习引擎 (Practice Engine)：支持多题型、自定义难度以及灵活的出题规则（test_generation_rules.py），提供流畅的答题体验。
🤖 AI 驱动能力分析 (AI-Powered Analysis)：内置 AI 分析器与数据看板（ai_manager.py, math_analyzer.py），深度挖掘历史答题数据，并自动生成多维度能力雷达图（test_radar.py），精准定位知识薄弱点。
📚 错题收录与定向加练 (Mistake Tracker)：全自动的错题收集机制。专属的错题加练模块（mistake_page.py）帮助用户进行针对性强化，告别低效重复。
📊 全景数据追踪 (Data Management)：强大的本地数据管理器（data_manager.py），完整记录每一次会话与历史轨迹（history_page.py），让进步清晰可见。
🎨 极简美学设计 (Minimalist UI)：基于 PyQt6 深度定制的 UI 主题与组件（ui_theme.py），抛弃传统刷题软件的枯燥感，提供拟物与现代交融的精致视觉体验。

📁 核心目录结构 (Project Structure)

TerryMath/
├── main.py                  # 应用程序主入口
├── ui_theme.py              # 全局 UI 主题与样式配置
├── data_manager.py          # 本地数据管理器 (JSON读写与持久化)
├── ai_manager.py            # AI 服务集成与调度模块
├── math_core.py             # 数学基础核心逻辑
├── math_analyzer.py         # 答题数据深度分析器
├── practice_engine.py       # 动态出题与练习引擎
├── session_manager.py       # 练习会话状态管理
├── 页面模块 (Pages)/
│   ├── quiz_page.py         # 核心答题页面
│   ├── history_page.py      # 历史记录看板
│   ├── mistake_page.py      # 错题回顾与加练页面
│   └── settings_page.py     # 软件全局设置页面
├── userdata/                # 用户本地数据存储 (Git Ignore)
│   ├── history/             # 会话历史 JSON 存档
│   ├── mistakes.json        # 错题本数据
│   └── app_settings.json    # 用户配置数据
└── docs/                    # 开发文档 (DATA_SCHEMA.md 等)

🚀 快速开始 (Quick Start)

1. 环境准备

请确保您的计算机上已安装 Python 3.x。

2. 安装依赖

克隆本项目后，在项目根目录运行以下命令安装必要的依赖库（主要为 PyQt6 及相关 AI 接口库）：

pip install -r requirements.txt

(注：请确保在此之前已生成并配置好您的 requirements.txt)

3. 运行程序

直接通过 Python 启动主程序：

python main.py

🛠 数据架构 (Data Schema)

本项目采用高度模块化的 JSON 本地存储方案以保证轻量与跨平台性。

数据结构定义及升级指南请参考：[DATA_SCHEMA.md]
AI 导出与解析格式标准详见：[AI_EXPORT_FORMAT.md]

💡 开发构想

TerryMath 不仅仅是一个随机出题器，它的核心在于 “反馈” 与 “分析”。通过将 AI 技术引入基础的数学训练中，它试图模仿一位经验丰富的导师，不仅能指出哪里算错了，还能分析出“为什么错”以及“接下来该练什么”。同时，在界面的打磨上，力求为使用者提供沉浸、专注且不失设计感的交互体验。

Terry Math

档案说明