refactor: 删除 tkinter app_gui.py, 完全切到 Web UI 作为唯一入口

## 决策背景

用户反馈 "windows GUI 太难看了, 还是完全用 webUI 吧, 用户可以选择"。

tkinter app_gui.py (PR #107 引入, 929 行) 的问题:
- 中文字体下渲染糊 ("WeChat Decrypt 工具箱" 标题模糊)
- 90 年代 Windows 控件风格, 不暗色不现代
- 只能跑 Windows, 不跨平台
- 没法远程访问
- 跟 Web UI 维护两套, 重复

Web UI (monitor_web.py) 已经完全对齐功能:
- 8 个工具按钮 (3 tab 分组: 个人微信 / 企微 / 工具)
- 终止按钮 + 实时日志推送
- 导出筛选模态框 (会话搜索/复选/格式选择, close #112)
- 跟实时消息监听共享 SSE 通道
- Lucide SVG icon 统一风格 (无 emoji)
- 暗色主题 + design tokens + 玻璃质感顶栏

## 改动

### 删除
- \`app_gui.py\` (929 行 tkinter GUI)

### monitor_web.py
拆 \`main()\` → \`_start_monitor_if_ready()\` + 精简的 \`main()\`:

之前: keys 不存在 → \`sys.exit(1)\` 直接挂

现在: keys 不存在 → 跳过监听线程启动, 仅起 Web UI 服务。
用户从工具箱点 "① 提取密钥 + 解密数据库" 跑完后重启进程, 监听自动激活。
这样 exe 用户第一次双击时不会报错挂掉, 而是看到 Web UI 工具箱可以
直接用。

新启动流程: \`_start_monitor_if_ready\` 检查 keys 文件 / session.db
密钥 / session.db 路径都 OK 才启 monitor_thread, 任一不满足都给友好
提示但不退出。

### WeChatDecrypt.spec
- 入口 \`app_gui.py\` → \`monitor_web.py\`
- datas 清单补全 (加 export_all_chats / chat_export_helpers /
  batch_decrypt_images / transcribe_chat 等之前漏的)
- hiddenimports 显式列 Crypto / zstandard / pilk (避免 PyInstaller
  漏 detect)

### build.bat
- 删 30 行重复的 --add-data 清单 (跟 .spec 漂移风险)
- 改成 \`pyinstaller --noconfirm WeChatDecrypt.spec\`
- 单一 source of truth 是 .spec
- 完成提示从 "GUI 启动" 改成 "双击 → 浏览器开 Web UI"

### EXE_USAGE.md
完全重写为 Web UI 视角:
- 快速开始: 双击 exe → 浏览器自动打开
- 工具箱 3 tab 各自能力详解
- 导出筛选模态框使用说明
- 任务终止说明
- 输出目录布局
- 远程访问说明
- 结尾解释为什么去掉了 tkinter

### README.md
- 三平台 quick-start 里 "Windows GUI / EXE" → "Windows Web UI / EXE"
- 文件清单: \`app_gui.py\` 那行 → \`monitor_web.py\` (新身份: Web UI
  总入口)
- 技术细节里 "GUI 工具箱" 章节重写: 强调 Web UI 优势 (筛选模态框 /
  终止按钮 / 跨平台 / 远程访问 / 跟监听共存) + 末尾 1 句历史说明
  解释 tkinter 已删除

## 实测

- python monitor_web.py: keys 在 → 正常启动监听 + Web UI
- python monitor_web.py: 假装 keys 不在 → 跳过监听, Web UI 仍能开,
  用户从工具箱点 "① 提取密钥" 后重启即激活
- 测试 185/185 通过

## 没改 (留 follow-up)

- 实际打包 .spec 验证 (需要 Win 跑 pyinstaller, 没在 CI 跑)
- monitor_web 启动后**自动**检测 keys 文件 mtime 变化重启监听, 不需要
  用户手动重启进程 (现在的设计是"重启进程才激活")
This commit is contained in:
ylytdeng
2026-05-17 19:22:47 +08:00
parent 273fe65a07
commit e826b1a565
6 changed files with 213 additions and 1107 deletions

View File

@@ -1,46 +1,21 @@
@echo off
chcp 65001 >nul
echo ========================================
echo WeChatDecrypt 打包脚本
echo WeChatDecrypt 打包脚本 (Web UI 版)
echo ========================================
echo.
:: 检查 pyinstaller
REM 检查 pyinstaller
where pyinstaller >nul 2>&1
if errorlevel 1 (
echo [!] 未找到 pyinstaller正在安装...
echo [!] 未找到 pyinstaller, 正在安装...
pip install pyinstaller
)
echo [*] 开始打包...
echo [*] 调用 PyInstaller (走 WeChatDecrypt.spec, 不重复维护文件清单)...
echo.
pyinstaller --noconfirm --onefile --console --name "WeChatDecrypt" ^
--add-data "main.py;." ^
--add-data "config.py;." ^
--add-data "decrypt_db.py;." ^
--add-data "export_messages.py;." ^
--add-data "voice_to_mp3.py;." ^
--add-data "find_all_keys.py;." ^
--add-data "find_all_keys_windows.py;." ^
--add-data "find_all_keys_linux.py;." ^
--add-data "find_wxwork_keys.py;." ^
--add-data "decrypt_wxwork_db.py;." ^
--add-data "export_wxwork_messages.py;." ^
--add-data "wxwork_crypto.py;." ^
--add-data "key_scan_common.py;." ^
--add-data "key_utils.py;." ^
--add-data "decode_image.py;." ^
--add-data "find_image_key.py;." ^
--add-data "find_image_key_monitor.py;." ^
--add-data "decrypt_sns.py;." ^
--add-data "export_sns.py;." ^
--add-data "monitor.py;." ^
--add-data "monitor_web.py;." ^
--add-data "mcp_server.py;." ^
--add-data "config.example.json;." ^
--collect-all pilk ^
app_gui.py
pyinstaller --noconfirm WeChatDecrypt.spec
if errorlevel 1 (
echo.
@@ -51,9 +26,12 @@ if errorlevel 1 (
echo.
echo ========================================
echo 打包完成
echo 打包完成!
echo 输出: dist\WeChatDecrypt.exe
for %%F in (dist\WeChatDecrypt.exe) do echo 大小: %%~zF bytes
echo.
echo 使用: 双击 WeChatDecrypt.exe
echo ^→ 自动启动浏览器到 http://localhost:5678 (Web UI)
echo ========================================
echo.
pause