3.2 KiB

Raw Permalink Blame History Unescape Escape

MagicWord 项目摘要

项目概述

MagicWord 是一款创新的隐私学习软件，旨在帮助用户通过打字练习的方式学习文档内容，同时避免引起他人注意。该软件外观类似于普通的Word文档编辑器，使用户能够在公共场所（如教室、图书馆、办公室）进行学习而不被察觉。

核心功能

文档打字伪装 - 在Word-like界面中打开文档，通过打字显示文档内容
多格式支持 - 支持 .txt, .docx, .pdf 格式文件
隐私保护 - 外观类似Word文档编辑器，有效隐藏学习行为
实时反馈 - 显示打字进度和准确率统计
附加功能 - 天气信息显示、每日名言展示

技术架构

编程语言: 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/               # 文档文件

开发成果

已完成功能

✅ 核心打字伪装功能
✅ 多格式文档支持
✅ 实时进度和准确率显示
✅ 天气和名言信息展示
✅ 配置管理系统
✅ 完整的测试套件
✅ 安装包制作指南

技术亮点

模块化设计 - 代码结构清晰，易于维护和扩展
跨格式支持 - 统一接口处理多种文档格式
错误处理 - 完善的异常处理机制
用户体验 - 直观的界面设计和流畅的操作体验

项目文件说明

README.md - 项目介绍和使用说明
USAGE.md - 详细使用指南
RELEASE_NOTES.md - 版本发布说明
CHANGELOG.md - 版本变更记录
PACKAGING_INSTRUCTIONS.md - 安装包制作指南
prepare_release.py - 发布准备脚本
requirements.txt - 项目依赖列表

运行方式

直接运行

进入 dist 目录
双击运行 MagicWord.exe

开发环境运行

安装依赖: pip install -r requirements.txt
运行程序: python -m src.main

打包分发

准备发布: python prepare_release.py
生成文件位于 dist_package/MagicWord_v0.1.0_Windows_x86.zip

未来发展方向

添加EPUB格式支持
实现打字速度统计和历史记录
增加更多个性化设置选项
添加云同步功能
开发移动端应用

总结

MagicWord 项目成功实现了预期的核心功能，提供了一个实用且有趣的隐私学习解决方案。通过精心设计的架构和完善的文档，该项目不仅满足了当前需求，还为未来的功能扩展奠定了坚实的基础。

3.2 KiB Raw Permalink Blame History Unescape Escape