技术概览
欢迎来到文言文学习助手的技术文档。本文档面向开发者，介绍项目的技术架构和实现细节。
技术栈
| 类别 | 技术 | 版本 |
|---|---|---|
| 前端框架 | Next.js | 14.x |
| UI 框架 | React | 18.x |
| 桌面框架 | Electron | 最新 |
| 语言 | TypeScript | 5.x |
| 样式 | CSS Modules | - |
| 状态管理 | Zustand | 5.x |
| 测试框架 | Vitest | 1.x |
| 构建工具 | electron-builder | - |
架构概览
┌─────────────────────────────────────────────────────┐
│ Electron │
│ ┌───────────────────────────────────────────────┐ │
│ │ Main Process │ │
│ │ - 窗口管理 │ │
│ │ - 文件系统访问 │ │
│ │ - 系统集成 │ │
│ └───────────────────────────────────────────────┘ │
│ ↕ IPC │
│ ┌───────────────────────────────────────────────┐ │
│ │ Renderer Process │ │
│ │ ┌─────────────────────────────────────────┐ │ │
│ │ │ Next.js App │ │ │
│ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │
│ │ │ │ Pages │ │Components│ │Services │ │ │ │
│ │ │ └─────────┘ └─────────┘ └─���───────┘ │ │ │
│ │ │ ↕ │ │ │
│ │ │ ┌─────────────────────────────────┐ │ │ │
│ │ │ │ Zustand Store │ │ │ │
│ │ │ └─────────────────────────────────┘ │ │ │
│ │ └─────────────────────────────────────────┘ │ │
│ └───────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘核心模块
数据存储 (storage.ts)
负责所有数据的持久化，使用 LocalStorage 存储 JSON 数据。
AI 服务 (ai.ts)
封装 AI API 调用，支持多种 AI 服务商。
出题引擎 (examGenerator.ts)
根据义项库数据自动生成练习题。
思维导图 (mindmap.ts)
思维导图的数据管理和渲染。
Word 导出 (wordExport.ts)
使用 docx.js 生成 Word 文档。
数据流
用户操作 → React 组件 → Service 层 → Storage 层 → LocalStorage
↓
Zustand Store (状态管理)
↓
UI 更新