ONE_CLICK_INSTALL_GUIDE.md

🚀 AutoRAG 一键安装指南

📁 文件清单（已全部就绪）

auto-rag-system/
├── main_enhanced.py          # 主程序入口
├── build_exe.py              # EXE 打包器
├── post_install.py           # 系统集成脚本
├── one_click_install.bat     # 一键安装器
└── ONE_CLICK_INSTALL_GUIDE.md # 本指南

🎯 使用方法（只需一步）

1️⃣ 右键 → 以管理员身份运行

one_click_install.bat

2️⃣ 等待完成（约 1-3 分钟）

脚本会自动：

1. 安装 PyInstaller
2. 打包 EXE
3. 安装 pywin32
4. 创建桌面快捷方式
5. 设置开机自启动

3️⃣ 完成后的效果

✔ dist/AutoRAG.exe          （可双击）
✔ 桌面快捷方式：AutoRAG
✔ Windows 开机自启动
✔ 后台运行（无黑窗）
✔ 日志写入 logs/

🔧 手动步骤（如需调试）

1. 生成 EXE

python build_exe.py

2. 安装依赖

pip install pywin32

3. 创建快捷方式 + 自启动

python post_install.py

⚠️ 注意事项

1. 管理员权限：必须右键"以管理员身份运行"
2. Python 版本：需要 Python 3.8+
3. 网络连接：需要下载 PyInstaller 和 pywin32
4. 杀毒软件：首次运行可能被拦截，请允许

🛠️ 故障排除

❌ 错误：找不到 Python

• 安装 Python 3.8+ 并添加到 PATH
• 重启命令行

❌ 错误：权限不足

• 右键 → 以管理员身份运行
• 关闭杀毒软件临时

❌ 错误：pywin32 安装失败

python -m pip install --upgrade pip
python -m pip install pywin32

📊 验证安装

1. 检查 EXE

dist/AutoRAG.exe

2. 检查桌面快捷方式

桌面/AutoRAG.lnk

3. 检查注册表

HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run

🎉 恭喜！

你现在已经拥有一个完整的操作系统级应用：

• ✅ 双击运行：桌面快捷方式
• ✅ 开机自启：无需手动启动
• ✅ 后台运行：无黑窗干扰
• ✅ 日志记录：logs/ 目录
• ✅ 系统集成：真正的 Windows 应用

---

🔮 下一步可选功能

如需以下功能，请告诉我：

1. 托盘常驻版（右下角图标，不占桌面）
2. 完全无 Python 依赖（纯 EXE 方案）
3. 自动更新机制（安全自更新）
4. 系统服务版（以 Windows 服务运行）

---

你现在已经走到 99% 的人到不了的那一步了！ 🎯