# ChuTi

**Repository Path**: wwddssff/chu-ti

## Basic Information

- **Project Name**: ChuTi
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-29
- **Last Updated**: 2025-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ChuTiJingTai (出题静态) - AI辅助学习平台

![Blazor](https://img.shields.io/badge/Blazor-WebAssembly-blue?logo=blazor)
![.NET](https://img.shields.io/badge/.NET-8.0-purple?logo=dotnet)
![AntDesign](https://img.shields.io/badge/UI-Ant%20Design-1890ff?logo=antdesign)
![License](https://img.shields.io/badge/license-MIT-green)

一个基于Blazor WebAssembly的AI辅助学习平台，专为小学生家长设计，支持智能试卷生成、儿童档案管理、本地数据存储等功能。

## 📸 项目截图

*(可添加项目截图展示)*

## ✨ 项目特色

### 🔒 隐私优先
- **本地存储**: 所有数据存储在用户本地浏览器，绝不上传云端
- **离线可用**: 核心功能支持离线使用，保护用户隐私
- **无跟踪**: 不收集任何用户行为数据

### 🤖 AI智能生成
- **多AI支持**: 集成阿里百炼、DeepSeek、OpenAI等多个AI服务商
- **个性化定制**: 根据孩子年级、学期、阶段智能调整题目难度
- **丰富题型**: 支持数学应用题、语文拼音、阅读理解、作文练习等

### 💻 现代化技术
- **Blazor WebAssembly**: 采用最新的.NET 8.0和Blazor技术栈
- **响应式设计**: 完美适配PC、平板、手机等多种设备
- **PWA支持**: 可安装为桌面应用，提供原生应用体验

## 🚀 核心功能

### 📊 仪表盘
- **数据概览**: 孩子档案数、试卷数、API状态等关键指标
- **快速操作**: 一键生成试卷、添加孩子档案等常用功能
- **最近动态**: 显示最近生成的试卷和操作记录

### 👶 孩子档案管理
- **档案创建**: 录入孩子姓名、年级、学期、学习阶段
- **信息编辑**: 支持档案信息的修改和更新
- **批量管理**: 支持多个孩子档案的管理

### 📝 智能试卷生成
- **五大题型**:
  - 🧮 数学应用题：贴近生活的实际应用场景
  - 🔤 语文拼音练习：拼音标注和汉字练习
  - 📖 阅读理解：培养理解和分析能力
  - ✍️ 作文练习：主题作文和看图写话
  - 🎯 综合练习：跨学科综合题目

- **智能参数**:
  - 难度等级：简单、中等、困难
  - 题目数量：5-20题可选
  - 自定义要求：特殊需求定制

### 📋 试卷管理
- **卡片展示**: 直观的试卷信息展示
- **多维筛选**: 按孩子、题型、时间等维度筛选
- **丰富操作**: 查看、答题、打印、分享、删除等功能

### ⚙️ 系统设置
- **AI配置**: 支持多种AI服务商的API配置
- **连接测试**: 实时验证API连接状态
- **数据管理**: 数据导出、清空等维护功能

### 📊 系统日志
- **多级别记录**: Info、Warning、Error、Debug四种级别
- **实时监控**: 系统运行状态实时监控
- **日志导出**: 支持日志数据的导出和分析

## 🏗️ 技术架构

### 前端技术栈
```
Blazor WebAssembly (.NET 8.0)
├── Ant Design Blazor (UI组件库)
├── Blazored.LocalStorage (本地存储)
├── System.Text.Json (JSON序列化)
└── Microsoft.AspNetCore.Components.WebAssembly
```

### 架构设计
- **MVC模式**: 模型-视图-控制器分离
- **服务层**: 业务逻辑与UI完全分离
- **依赖注入**: 使用.NET Core内置DI容器
- **组件化**: 高度复用的UI组件设计

### 数据存储
```
IndexedDB (浏览器本地存储)
├── children (孩子档案)
├── api_config (AI配置)
├── exam_papers (试卷数据)
└── logs (系统日志)
```

## 📦 安装与运行

### 环境要求
- **.NET 8.0 SDK** - [下载地址](https://dotnet.microsoft.com/download/dotnet/8.0)
- **Visual Studio 2022** (推荐) 或 **VS Code**
- **现代浏览器** - 支持WebAssembly (Chrome, Firefox, Edge, Safari)

### 克隆项目
```bash
git clone https://github.com/your-username/ChuTiJingTai.git
cd ChuTiJingTai
```

### 安装依赖
```bash
dotnet restore
```

### 开发运行
```bash
dotnet run
```
访问 `https://localhost:7000` 或 `http://localhost:5000`

### 生产构建
```bash
dotnet publish -c Release -o publish
```

### 部署
生成的文件在 `publish` 目录中，可部署到任何静态文件服务器：
- **Nginx**
- **Apache**
- **GitHub Pages**
- **Vercel**
- **Netlify**

## 🎯 使用指南

### 1. 首次配置
1. 打开应用后，先进入"系统设置"页面
2. 配置AI服务商信息（API密钥等）
3. 测试API连接确保配置正确

### 2. 添加孩子档案
1. 进入"孩子档案管理"页面
2. 点击"添加孩子"按钮
3. 填写孩子信息（姓名、年级、学期、阶段）

### 3. 生成试卷
1. 进入"生成试卷"页面
2. 选择孩子档案和试卷类型
3. 设置难度等级和题目数量
4. 点击"生成试卷"按钮

### 4. 管理试卷
1. 在"试卷管理"页面查看所有试卷
2. 支持查看、答题、打印、分享等操作
3. 可按孩子和题型进行筛选

## 🛠️ 开发指南

### 项目结构
```
ChuTiJingTai/
├── Components/          # 可复用组件
├── Data/               # 数据相关
├── Layout/             # 布局组件
│   ├── MainLayout.razor
│   └── NavMenu.razor
├── Models/             # 数据模型
│   ├── ChildProfile.cs
│   ├── ExamPaper.cs
│   ├── ApiConfig.cs
│   └── LogEntry.cs
├── Pages/              # 页面组件
│   ├── Home.razor
│   ├── Children.razor
│   ├── ExamGenerate.razor
│   ├── ExamList.razor
│   ├── Settings.razor
│   └── Logs.razor
├── Services/           # 服务层
│   ├── ILocalStorageService.cs
│   ├── LocalStorageService.cs
│   ├── ILogService.cs
│   ├── LogService.cs
│   ├── IExamService.cs
│   └── ExamService.cs
├── wwwroot/            # 静态资源
└── Program.cs          # 应用入口
```

### 添加新功能
1. **数据模型**: 在 `Models` 目录添加相关模型
2. **服务接口**: 在 `Services` 目录定义和实现服务
3. **页面组件**: 在 `Pages` 目录创建新页面
4. **依赖注入**: 在 `Program.cs` 中注册服务

### 自定义AI服务商
实现 `IExamService` 接口：
```csharp
public class CustomAIService : IExamService
{
    public async Task<ExamPaper> GenerateExamAsync(ExamGenerationRequest request)
    {
        // 实现自定义AI调用逻辑
    }
}
```

## 🔧 项目开发历程

### 编译问题解决
项目在开发过程中遇到了44个编译错误和7个警告，通过系统性的修复方法成功解决：

#### 主要修复内容
- **组件类型推断**: 为AntDesign组件添加明确的泛型类型参数
- **命名空间冲突**: 使用别名解决系统命名空间冲突
- **语法规范**: 统一Blazor语法规范，修正组件属性使用
- **代码质量**: 清理冗余代码，优化组件结构

#### 最终成果
- ✅ **0个编译错误**
- ✅ **0个编译警告**
- ✅ **完美编译状态**

## 📈 性能优化

### 加载性能
- **组件懒加载**: 按需加载页面组件
- **资源压缩**: 静态资源自动压缩
- **缓存策略**: 合理的浏览器缓存配置

### 运行性能
- **异步操作**: 所有IO操作都是异步的
- **状态管理**: 高效的组件状态管理
- **内存优化**: 避免内存泄漏和不必要的对象创建

## 🔐 安全考虑

### 数据安全
- **本地存储**: 所有敏感数据仅存储在用户本地
- **API密钥**: 加密存储AI服务商的API密钥
- **隐私保护**: 不收集或上传任何用户数据

### 代码安全
- **输入验证**: 所有用户输入都经过严格验证
- **错误处理**: 完善的异常处理机制
- **安全头**: 设置适当的HTTP安全头

## 🤝 贡献指南

### 如何贡献
1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开Pull Request

### 代码规范
- 遵循C#和Blazor编码规范
- 使用有意义的变量和方法名
- 添加必要的注释和文档
- 确保所有测试通过

## 📝 版本历史

### v1.0.0 (2024-12-19)
- ✨ 初始版本发布
- 🎯 完整的AI试卷生成功能
- 👶 孩子档案管理系统
- 📊 系统监控和日志
- 🔧 多AI服务商支持
- 📱 响应式设计

## 🔮 未来规划

### 短期目标 (1-3个月)
- [ ] **错题本功能**: 收集和分析错题，生成针对性练习
- [ ] **学习报告**: 生成详细的学习进度和能力分析
- [ ] **多媒体支持**: 支持图片、音频等多媒体题目
- [ ] **打印优化**: 优化试卷打印格式和样式

### 中期目标 (3-6个月)
- [ ] **PWA增强**: 完整的离线应用体验
- [ ] **云端同步**: 可选的云端数据备份和同步
- [ ] **家长社区**: 经验分享和交流平台
- [ ] **移动端优化**: 原生移动应用支持

### 长期目标 (6-12个月)
- [ ] **本地AI模型**: 部署轻量级本地AI模型
- [ ] **智能分析**: 基于大数据的学习能力分析
- [ ] **多语言支持**: 国际化和本地化
- [ ] **教师版本**: 面向教师的专业版本

## 🙏 致谢

感谢以下开源项目和服务：
- [Blazor WebAssembly](https://blazor.net) - 现代化的Web应用框架
- [Ant Design Blazor](https://antblazor.com) - 优秀的UI组件库
- [Blazored.LocalStorage](https://github.com/Blazored/LocalStorage) - 本地存储解决方案

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 联系方式

- **项目主页**: https://github.com/your-username/ChuTiJingTai
- **问题反馈**: https://github.com/your-username/ChuTiJingTai/issues
- **邮箱**: your-email@example.com

---

<div align="center">

**🌟 如果这个项目对您有帮助，请给我们一个Star！ 🌟**

Made with ❤️ by Claude AI Assistant

</div>