You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# MagicWord 项目摘要
## 项目概述
MagicWord 是一款创新的隐私学习软件, 旨在帮助用户通过打字练习的方式学习文档内容, 同时避免引起他人注意。该软件外观类似于普通的Word文档编辑器, 使用户能够在公共场所( 如教室、图书馆、办公室) 进行学习而不被察觉。
## 核心功能
1. ** 文档打字伪装** - 在Word-like界面中打开文档, 通过打字显示文档内容
2. ** 多格式支持** - 支持 .txt, .docx, .pdf 格式文件
3. ** 隐私保护** - 外观类似Word文档编辑器, 有效隐藏学习行为
4. ** 实时反馈** - 显示打字进度和准确率统计
5. ** 附加功能** - 天气信息显示、每日名言展示
## 技术架构
- **编程语言**: Python 3.13
- **GUI框架**: PyQt5
- **打包工具**: PyInstaller
- **文档处理**: python-docx, PyPDF2
- **网络请求**: requests, beautifulsoup4
- **图像处理**: Pillow
- **编码检测**: chardet
## 项目结构
```
├── src/ # 源代码目录
│ ├── main.py # 程序入口点
│ ├── main_window.py # 主窗口实现
│ ├── file_manager/ # 文件管理模块
│ ├── input_handler/ # 输入处理模块
│ ├── services/ # 网络服务模块
│ ├── settings/ # 配置管理模块
│ ├── ui/ # 用户界面组件
│ └── utils/ # 工具函数
├── resources/ # 资源文件
├── dist/ # 打包后的可执行文件
├── dist_package/ # 分发包
├── tests/ # 测试代码
└── docs/ # 文档文件
```
## 开发成果
### 已完成功能
1. ✅ 核心打字伪装功能
2. ✅ 多格式文档支持
3. ✅ 实时进度和准确率显示
4. ✅ 天气和名言信息展示
5. ✅ 配置管理系统
6. ✅ 完整的测试套件
7. ✅ 安装包制作指南
### 技术亮点
1. ** 模块化设计** - 代码结构清晰,易于维护和扩展
2. ** 跨格式支持** - 统一接口处理多种文档格式
3. ** 错误处理** - 完善的异常处理机制
4. ** 用户体验** - 直观的界面设计和流畅的操作体验
## 项目文件说明
- `README.md` - 项目介绍和使用说明
- `USAGE.md` - 详细使用指南
- `RELEASE_NOTES.md` - 版本发布说明
- `CHANGELOG.md` - 版本变更记录
- `PACKAGING_INSTRUCTIONS.md` - 安装包制作指南
- `prepare_release.py` - 发布准备脚本
- `requirements.txt` - 项目依赖列表
## 运行方式
### 直接运行
1. 进入 `dist` 目录
2. 双击运行 `MagicWord.exe`
### 开发环境运行
1. 安装依赖: `pip install -r requirements.txt`
2. 运行程序: `python -m src.main`
## 打包分发
1. 准备发布: `python prepare_release.py`
2. 生成文件位于 `dist_package/MagicWord_v0.1.0_Windows_x86.zip`
## 未来发展方向
1. 添加EPUB格式支持
2. 实现打字速度统计和历史记录
3. 增加更多个性化设置选项
4. 添加云同步功能
5. 开发移动端应用
## 总结
MagicWord 项目成功实现了预期的核心功能,提供了一个实用且有趣的隐私学习解决方案。通过精心设计的架构和完善的文档,该项目不仅满足了当前需求,还为未来的功能扩展奠定了坚实的基础。