INSTALL.md

安装和部署指南

系统要求

• Python 3.8 或更高版本
• Windows 7/10/11、macOS 10.14+、Linux (Ubuntu 18.04+)
• 至少 100MB 可用磁盘空间

安装依赖

步骤1：安装Python依赖库

pip install -r requirements.txt

或者手动安装：

pip install markdown==3.5.1
pip install pygments==2.17.2
pip install networkx==3.2.1
pip install pillow==10.1.0
pip install matplotlib==3.8.2

步骤2：运行程序

python gui.py

构建可执行文件

自动构建（推荐）

python build.py

按提示输入 y 开始构建。

手动构建

如果自动构建失败，可以使用以下命令手动构建：

Windows:

pyinstaller --name=SmartNotes --windowed --onefile --clean --noconfirm gui.py

macOS/Linux:

pyinstaller --name=SmartNotes --onefile --clean --noconfirm gui.py

构建完成后，可执行文件位于 dist 目录中。

常见问题

Q: 提示缺少模块怎么办？

A: 确保已安装所有依赖库：

pip install markdown pygments networkx pillow matplotlib

Q: 打包失败怎么办？

A:

1. 确保PyInstaller已安装：pip install pyinstaller
2. 尝试手动打包命令
3. 检查Python版本是否为3.8+

Q: 程序无法启动？

A:

1. 检查是否安装了所有依赖
2. 尝试在命令行运行查看错误信息
3. 确保Python版本兼容

数据存储位置

程序数据存储在用户目录下：

• Windows: C:\Users\用户名\.smart_notes
• macOS: /Users/用户名/.smart_notes
• Linux: /home/用户名/.smart_notes

卸载

1. 删除程序文件
2. 删除数据目录 .smart_notes
3. 卸载Python依赖（可选）

技术支持

如遇问题，请查看：

• README.md 文档
• 项目GitHub Issues页面