{"repo": "chenxuanhao520-wq/wxauto", "files": {"docs/deployment/WINDOWS_DEPLOYMENT.md": {"3bcabd4b4acc4b404770fba825c1729da2521415": {"t": 1785746610.88514, "n": 5313, "h": "f963e91627709172", "c": "# Windows 系统部署指南\n\n完整的Windows部署和运行指南。\n\n---\n\n## 🚀 一键启动（推荐）\n\n### 方式1：使用批处理脚本（最简单）⭐⭐⭐⭐⭐\n\n```\n双击运行：quick_start.bat\n\n系统会自动：\n1. 检查Python环境\n2. 创建虚拟环境\n3. 安装依赖\n4. 初始化数据库\n5. 配置向导\n6. 启动系统\n```\n\n**适合**：所有用户，尤其是不熟悉命令行的\n\n---\n\n### 方式2：分步安装（更可控）\n\n#### 步骤1：安装\n\n```\n双击：setup.bat\n```\n\n完成后会：\n- ✅ 创建虚拟环境\n- ✅ 安装依赖\n- ✅ 初始化数据库\n- ✅ 添加示例知识库\n\n#### 步骤2：配置\n\n```\n双击：config_wizard.bat\n```\n\n按提示配置：\n- 大模型API Key\n- 运行模式\n- 白名单群聊\n- 多维表格（可选）\n\n#### 步骤3：运行\n\n```\n双击：start.bat\n```\n\n系统启动！\n\n---\n\n### 方式3：打包为EXE（无需Python环境）\n\n**适合**：没有Python环境的Windows电脑\n\n#### 在开发机上打包\n\n```\n双击：build_exe.bat\n```\n\n等待打包完成（5-10分钟）\n\n#### 部署到目标电脑\n\n1. 复制整个 `dist\\WeChatCustomerService\\` 目录\n2. 在目标电脑上双击 `WeChatCustomerService.exe`\n3. 完成！\n\n---\n\n## 📋 所有批处理脚本\n\n| 脚本 | 用途 | 适用场景 |\n|------|------|----------|\n| **quick_start.bat** | 一键启动向导 | 首次使用 |\n| **setup.bat** | 安装依赖 | 首次部署 |\n| **config_wizard.bat** | 配置向导 | 配置API Key |\n| **start.bat** | 启动系统 | 日常启动 |\n| **stop.bat** | 停止系统 | 停止运行 |\n| **test.bat** | 运行测试 | 健康检查 |\n| **install_multimodal.bat** | 安装多模态 | 语音图片支持 |\n| **build_exe.bat** | 打包exe | 无Python部署 |\n\n---\n\n## 🎯 三种部署方案\n\n### 方案A：开发/测试环境\n\n**步骤**：\n```\n1. 双击 setup.bat\n2. 双击 config_wizard.bat\n3. 设置测试模式：\n   set USE_FAKE_ADAPTER=true\n4. 双击 start.bat\n```\n\n**无需**：\n- ❌ 真实微信\n- ❌ wxauto\n- ❌ Windows专机\n\n**适合**：开发、测试、演示\n\n---\n\n### 方案B：生产环境（Python）\n\n**步骤**：\n```\n1. 准备Windows专机\n2. 安装并登录PC微信\n3. 双击 setup.bat\n4. 双击 config_wizard.bat\n5. 配置真实模式：\n   set USE_FAKE_ADAPTER=false\n6. 配置大模型API Key\n7. 双击 start.bat\n```\n\n**需要**：\n- ✅ Windows系统\n- ✅ PC微信（保持前台）\n- ✅ Python 3.10+\n\n**适合**：正式运营，有Python环境\n\n---\n\n### 方案C：生产环境（EXE）\n\n**步骤**：\n```\n在开发机：\n1. 双击 build_exe.bat（打包）\n2. 复制 dist\\WeChatCustomerService\\ 到U盘\n\n在生产机：\n1. 复制文件夹到 C:\\WeChatBot\\\n2. 安装并登录PC微信\n3. 创建 .env 文件配置API Key\n4. 双击 WeChatCustomerService.exe\n```\n\n**需要**：\n- ✅ Windows系统\n- ✅ PC微信\n- ❌ 无需Python环境\n\n**适合**：客户部署，无技术背景\n\n---\n\n## ⚙️ 环境变量配置\n\n### 方式1：使用.env文件（推荐）\n\n运行 `config_wizard.bat` 会自动创建 `.env` 文件\n\n或手动创建：\n```\n# .env\nUSE_FAKE_ADAPTER=false\nDEEPSEEK_API_KEY=sk-your-key-here\n```\n\n### 方式2：系统环境变量\n\n```\nWin+R → sysdm.cpl → 高级 → 环境变量\n\n添加：\n  变量名：DEEPSEEK_API_KEY\n  变量值：sk-your-key-here\n```\n\n### 方式3：临时设置\n\n```cmd\nset DEEPSEEK_API_KEY=sk-your-key\nset USE_FAKE_ADAPTER=false\nstart.bat\n```\n\n**优先级**：临时设置 > .env文件 > 系统环境变量\n\n---\n\n## 🔧 常用命令\n\n### 启动系统\n\n```cmd\n:: 方式1：双击\nstart.bat\n\n:: 方式2：命令行\nstart.bat\n\n:: 方式3：直接运行Python\nvenv\\Scripts\\activate\npython main.py\n```\n\n### 停止系统\n\n```cmd\n:: 方式1：双击\nstop.bat\n\n:: 方式2：Ctrl+C（在运行窗口）\n\n:: 方式3：任务管理器结束Python进程\n```\n\n### 测试系统\n\n```cmd\n:: 运行所有测试\ntest.bat\n\n:: 或单独测试\nvenv\\Scripts\\activate\npython -m pytest tests/ -v\npython ops_tools.py health\n```\n\n### 查看日志\n\n```cmd\n:: 实时查看\ntype logs\\app.log\n\n:: 或使用文本编辑器打开\nnotepad logs\\app.log\n```\n\n---\n\n## 🐛 常见问题\n\n### Q1: 双击bat文件一闪而过\n\n**原因**：脚本执行出错\n\n**解决**：\n```cmd\n:: 在命令提示符中运行，查看错误\ncmd\ncd C:\\path\\to\\project\nsetup.bat\n```\n\n### Q2: setup.bat 报错\"找不到Python\"\n\n**原因**：Python未安装或未添加到PATH\n\n**解决**：\n```\n1. 下载Python：https://www.python.org/downloads/\n2. 安装时勾选\"Add Python to PATH\"\n3. 重启命令提示符\n4. 运行：python --version\n```\n\n### Q3: pip install 速度慢\n\n**解决**：使用国内镜像（脚本已包含）\n\n```cmd\npip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name\n```\n\n### Q4: wxauto 初始化失败\n\n**原因**：PC微信未运行或版本不兼容\n\n**解决**：\n```\n1. 确保PC微信已登录并保持前台\n2. 使用最新版本PC微信\n3. 以管理员权限运行\n4. 或先用测试模式：set USE_FAKE_ADAPTER=true\n```\n\n### Q5: 打包exe失败\n\n**原因**：依赖冲突或文件锁定\n\n**解决**：\n```cmd\n:: 1. 清理缓存\nrd /s /q build dist\ndel main.spec\n\n:: 2. 重新打包\nbuild_exe.bat\n```\n\n---\n\n## 🔐 Windows服务化（长期运行）\n\n### 使用NSSM（推荐）\n\n#### 1. 下载NSSM\n\nhttps://nssm.cc/download\n\n解压到：`C:\\nssm\\`\n\n#### 2. 安装服务\n\n```cmd\n:: 以管理员身份运行\ncd C:\\nssm\\win64\n\n:: 安装服务\nnssm install WeChatBot \"C:\\path\\to\\venv\\Scripts\\python.exe\" \"C:\\path\\to\\main.py\"\n\n:: 设置工作目录\nnssm set WeChatBot AppDirectory \"C:\\path\\to\\project\"\n\n:: 设置环境变量\nnssm set WeChatBot AppEnvironmentExtra \"USE_FAKE_ADAPTER=false\" \"DEEPSEEK_API_KEY=sk-xxxxx\"\n\n:: 设置日志\nnssm set WeChatBot AppStdout \"C:\\path\\to\\logs\\service.log\"\nnssm set WeChatBot AppStderr \"C:\\path\\to\\logs\\service_error.log\"\n\n:: 设置启动类型\nnssm set WeChatBot Start SERVICE_AUTO_START\n```\n\n#### 3. 管理服务\n\n```cmd\n:: 启动\nnssm start WeChatBot\n\n:: 停止\nnssm stop WeChatBot\n\n:: 重启\nnssm restart WeChatBot\n\n:: 查看状态\nnssm status WeChatBot\n\n:: 卸载\nnssm remove WeChatBot confirm\n```\n\n---\n\n## 📊 性能优化\n\n### Windows专机建议配置\n\n**最低配置**：\n- CPU：2核\n- 内存：4GB\n- 硬盘：20GB\n- 系统：Windows 10/11\n\n**推荐配置**：\n- CPU：4核\n- 内存：8GB\n- 硬盘：50GB SSD\n- 系统：Windows 11\n\n### 如果安装多模态支持\n\n**额外需求**：\n- 内存：+2GB（PaddleOCR模型）\n- 硬盘：+2GB（模型文件）\n\n---\n\n## 📝 部署检查清单\n\n### 首次部署\n\n- [ ] Python 3.10+ 已安装\n- [ ] 运行 setup.bat\n- [ ] 运行 config_wizard.bat\n- [ ] 配置至少一个大模型API Key\n- [ ] 运行 test.bat 检查\n- [ ] 启动 start.bat\n\n### 生产部署\n\n- [ ] Windows专机准备\n- [ ] PC微信已安装并登录\n- [ ] 微信保持前台运行\n- [ ] 网络连接稳定\n- [ ] 配置白名单群聊\n- [ ] 配置NSSM服务（可选）\n- [ ] 设置开机自启动\n\n### 多模态支持\n\n- [ ] 运行 install_multimodal.bat\n- [ ] PaddleOCR 安装成功\n- [ ] FunASR 安装成功（可选）\n- [ ] 测试语音识别\n- [ ] 测试图片识别\n\n---\n\n## 🎯 快速开始\n\n### 新手（5分钟）\n\n```\n1. 双击：quick_start.bat\n2. 按提示操作\n3. 完成！\n```\n\n### 有经验用户（3分钟）\n\n```cmd\nsetup.bat\nconfig_wizard.bat\nstart.bat\n```\n\n### 命令行用户\n\n```cmd\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\npython -c \"from storage.db import Database; db=Database('data/data.db'); db.init_database()\"\nset DEEPSEEK_API_KEY=sk-xxxxx\npython main.py\n```\n\n---\n\n## 📞 技术支持\n\n**如遇问题**：\n1. 查看 `logs\\app.log`\n2. 运行 `test.bat` 诊断\n3. 查看对应文档\n\n**文档索引**：\n- 安装问题 → `INSTALLATION.md`\n- 配置问题 → `START_HERE.md`\n- 功能使用 → `FINAL_GUIDE.md`\n\n---\n\n**现在就开始：双击 `quick_start.bat`！** 🚀\n\n**最后更新**：2025-10-16\n\n"}, "941b7b10b3a1e9a5f19035a0dc969d21adf3d1e7": {"t": 1785766272.6155746, "n": 5313, "h": "f963e91627709172", "c": "# Windows 系统部署指南\n\n完整的Windows部署和运行指南。\n\n---\n\n## 🚀 一键启动（推荐）\n\n### 方式1：使用批处理脚本（最简单）⭐⭐⭐⭐⭐\n\n```\n双击运行：quick_start.bat\n\n系统会自动：\n1. 检查Python环境\n2. 创建虚拟环境\n3. 安装依赖\n4. 初始化数据库\n5. 配置向导\n6. 启动系统\n```\n\n**适合**：所有用户，尤其是不熟悉命令行的\n\n---\n\n### 方式2：分步安装（更可控）\n\n#### 步骤1：安装\n\n```\n双击：setup.bat\n```\n\n完成后会：\n- ✅ 创建虚拟环境\n- ✅ 安装依赖\n- ✅ 初始化数据库\n- ✅ 添加示例知识库\n\n#### 步骤2：配置\n\n```\n双击：config_wizard.bat\n```\n\n按提示配置：\n- 大模型API Key\n- 运行模式\n- 白名单群聊\n- 多维表格（可选）\n\n#### 步骤3：运行\n\n```\n双击：start.bat\n```\n\n系统启动！\n\n---\n\n### 方式3：打包为EXE（无需Python环境）\n\n**适合**：没有Python环境的Windows电脑\n\n#### 在开发机上打包\n\n```\n双击：build_exe.bat\n```\n\n等待打包完成（5-10分钟）\n\n#### 部署到目标电脑\n\n1. 复制整个 `dist\\WeChatCustomerService\\` 目录\n2. 在目标电脑上双击 `WeChatCustomerService.exe`\n3. 完成！\n\n---\n\n## 📋 所有批处理脚本\n\n| 脚本 | 用途 | 适用场景 |\n|------|------|----------|\n| **quick_start.bat** | 一键启动向导 | 首次使用 |\n| **setup.bat** | 安装依赖 | 首次部署 |\n| **config_wizard.bat** | 配置向导 | 配置API Key |\n| **start.bat** | 启动系统 | 日常启动 |\n| **stop.bat** | 停止系统 | 停止运行 |\n| **test.bat** | 运行测试 | 健康检查 |\n| **install_multimodal.bat** | 安装多模态 | 语音图片支持 |\n| **build_exe.bat** | 打包exe | 无Python部署 |\n\n---\n\n## 🎯 三种部署方案\n\n### 方案A：开发/测试环境\n\n**步骤**：\n```\n1. 双击 setup.bat\n2. 双击 config_wizard.bat\n3. 设置测试模式：\n   set USE_FAKE_ADAPTER=true\n4. 双击 start.bat\n```\n\n**无需**：\n- ❌ 真实微信\n- ❌ wxauto\n- ❌ Windows专机\n\n**适合**：开发、测试、演示\n\n---\n\n### 方案B：生产环境（Python）\n\n**步骤**：\n```\n1. 准备Windows专机\n2. 安装并登录PC微信\n3. 双击 setup.bat\n4. 双击 config_wizard.bat\n5. 配置真实模式：\n   set USE_FAKE_ADAPTER=false\n6. 配置大模型API Key\n7. 双击 start.bat\n```\n\n**需要**：\n- ✅ Windows系统\n- ✅ PC微信（保持前台）\n- ✅ Python 3.10+\n\n**适合**：正式运营，有Python环境\n\n---\n\n### 方案C：生产环境（EXE）\n\n**步骤**：\n```\n在开发机：\n1. 双击 build_exe.bat（打包）\n2. 复制 dist\\WeChatCustomerService\\ 到U盘\n\n在生产机：\n1. 复制文件夹到 C:\\WeChatBot\\\n2. 安装并登录PC微信\n3. 创建 .env 文件配置API Key\n4. 双击 WeChatCustomerService.exe\n```\n\n**需要**：\n- ✅ Windows系统\n- ✅ PC微信\n- ❌ 无需Python环境\n\n**适合**：客户部署，无技术背景\n\n---\n\n## ⚙️ 环境变量配置\n\n### 方式1：使用.env文件（推荐）\n\n运行 `config_wizard.bat` 会自动创建 `.env` 文件\n\n或手动创建：\n```\n# .env\nUSE_FAKE_ADAPTER=false\nDEEPSEEK_API_KEY=sk-your-key-here\n```\n\n### 方式2：系统环境变量\n\n```\nWin+R → sysdm.cpl → 高级 → 环境变量\n\n添加：\n  变量名：DEEPSEEK_API_KEY\n  变量值：sk-your-key-here\n```\n\n### 方式3：临时设置\n\n```cmd\nset DEEPSEEK_API_KEY=sk-your-key\nset USE_FAKE_ADAPTER=false\nstart.bat\n```\n\n**优先级**：临时设置 > .env文件 > 系统环境变量\n\n---\n\n## 🔧 常用命令\n\n### 启动系统\n\n```cmd\n:: 方式1：双击\nstart.bat\n\n:: 方式2：命令行\nstart.bat\n\n:: 方式3：直接运行Python\nvenv\\Scripts\\activate\npython main.py\n```\n\n### 停止系统\n\n```cmd\n:: 方式1：双击\nstop.bat\n\n:: 方式2：Ctrl+C（在运行窗口）\n\n:: 方式3：任务管理器结束Python进程\n```\n\n### 测试系统\n\n```cmd\n:: 运行所有测试\ntest.bat\n\n:: 或单独测试\nvenv\\Scripts\\activate\npython -m pytest tests/ -v\npython ops_tools.py health\n```\n\n### 查看日志\n\n```cmd\n:: 实时查看\ntype logs\\app.log\n\n:: 或使用文本编辑器打开\nnotepad logs\\app.log\n```\n\n---\n\n## 🐛 常见问题\n\n### Q1: 双击bat文件一闪而过\n\n**原因**：脚本执行出错\n\n**解决**：\n```cmd\n:: 在命令提示符中运行，查看错误\ncmd\ncd C:\\path\\to\\project\nsetup.bat\n```\n\n### Q2: setup.bat 报错\"找不到Python\"\n\n**原因**：Python未安装或未添加到PATH\n\n**解决**：\n```\n1. 下载Python：https://www.python.org/downloads/\n2. 安装时勾选\"Add Python to PATH\"\n3. 重启命令提示符\n4. 运行：python --version\n```\n\n### Q3: pip install 速度慢\n\n**解决**：使用国内镜像（脚本已包含）\n\n```cmd\npip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name\n```\n\n### Q4: wxauto 初始化失败\n\n**原因**：PC微信未运行或版本不兼容\n\n**解决**：\n```\n1. 确保PC微信已登录并保持前台\n2. 使用最新版本PC微信\n3. 以管理员权限运行\n4. 或先用测试模式：set USE_FAKE_ADAPTER=true\n```\n\n### Q5: 打包exe失败\n\n**原因**：依赖冲突或文件锁定\n\n**解决**：\n```cmd\n:: 1. 清理缓存\nrd /s /q build dist\ndel main.spec\n\n:: 2. 重新打包\nbuild_exe.bat\n```\n\n---\n\n## 🔐 Windows服务化（长期运行）\n\n### 使用NSSM（推荐）\n\n#### 1. 下载NSSM\n\nhttps://nssm.cc/download\n\n解压到：`C:\\nssm\\`\n\n#### 2. 安装服务\n\n```cmd\n:: 以管理员身份运行\ncd C:\\nssm\\win64\n\n:: 安装服务\nnssm install WeChatBot \"C:\\path\\to\\venv\\Scripts\\python.exe\" \"C:\\path\\to\\main.py\"\n\n:: 设置工作目录\nnssm set WeChatBot AppDirectory \"C:\\path\\to\\project\"\n\n:: 设置环境变量\nnssm set WeChatBot AppEnvironmentExtra \"USE_FAKE_ADAPTER=false\" \"DEEPSEEK_API_KEY=sk-xxxxx\"\n\n:: 设置日志\nnssm set WeChatBot AppStdout \"C:\\path\\to\\logs\\service.log\"\nnssm set WeChatBot AppStderr \"C:\\path\\to\\logs\\service_error.log\"\n\n:: 设置启动类型\nnssm set WeChatBot Start SERVICE_AUTO_START\n```\n\n#### 3. 管理服务\n\n```cmd\n:: 启动\nnssm start WeChatBot\n\n:: 停止\nnssm stop WeChatBot\n\n:: 重启\nnssm restart WeChatBot\n\n:: 查看状态\nnssm status WeChatBot\n\n:: 卸载\nnssm remove WeChatBot confirm\n```\n\n---\n\n## 📊 性能优化\n\n### Windows专机建议配置\n\n**最低配置**：\n- CPU：2核\n- 内存：4GB\n- 硬盘：20GB\n- 系统：Windows 10/11\n\n**推荐配置**：\n- CPU：4核\n- 内存：8GB\n- 硬盘：50GB SSD\n- 系统：Windows 11\n\n### 如果安装多模态支持\n\n**额外需求**：\n- 内存：+2GB（PaddleOCR模型）\n- 硬盘：+2GB（模型文件）\n\n---\n\n## 📝 部署检查清单\n\n### 首次部署\n\n- [ ] Python 3.10+ 已安装\n- [ ] 运行 setup.bat\n- [ ] 运行 config_wizard.bat\n- [ ] 配置至少一个大模型API Key\n- [ ] 运行 test.bat 检查\n- [ ] 启动 start.bat\n\n### 生产部署\n\n- [ ] Windows专机准备\n- [ ] PC微信已安装并登录\n- [ ] 微信保持前台运行\n- [ ] 网络连接稳定\n- [ ] 配置白名单群聊\n- [ ] 配置NSSM服务（可选）\n- [ ] 设置开机自启动\n\n### 多模态支持\n\n- [ ] 运行 install_multimodal.bat\n- [ ] PaddleOCR 安装成功\n- [ ] FunASR 安装成功（可选）\n- [ ] 测试语音识别\n- [ ] 测试图片识别\n\n---\n\n## 🎯 快速开始\n\n### 新手（5分钟）\n\n```\n1. 双击：quick_start.bat\n2. 按提示操作\n3. 完成！\n```\n\n### 有经验用户（3分钟）\n\n```cmd\nsetup.bat\nconfig_wizard.bat\nstart.bat\n```\n\n### 命令行用户\n\n```cmd\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\npython -c \"from storage.db import Database; db=Database('data/data.db'); db.init_database()\"\nset DEEPSEEK_API_KEY=sk-xxxxx\npython main.py\n```\n\n---\n\n## 📞 技术支持\n\n**如遇问题**：\n1. 查看 `logs\\app.log`\n2. 运行 `test.bat` 诊断\n3. 查看对应文档\n\n**文档索引**：\n- 安装问题 → `INSTALLATION.md`\n- 配置问题 → `START_HERE.md`\n- 功能使用 → `FINAL_GUIDE.md`\n\n---\n\n**现在就开始：双击 `quick_start.bat`！** 🚀\n\n**最后更新**：2025-10-16\n\n"}}}}