Commit Graph

62 Commits

  • feat(desktop): 新增 Electron 桌面端壳与自绘标题栏
    - 新增 desktop/ Electron 工程:启动后端并等待 /api/health,就绪后加载页面;打包模式从 extraResources 读取 UI/后端
    - 新增 DesktopTitleBar 组件,适配 frame:false 自绘标题栏,并修复桌面端 100vh 布局导致的外层滚动条
    - chat 页面右侧布局调整更接近原生微信;detection-result 调试输出仅在 dev 环境启用
    - .gitignore 忽略 desktop 构建产物/依赖,保留 .gitkeep 占位文件
    - README 补充 Windows 桌面端 EXE 打包(npm run dist)与产物路径说明
  • feat(api): 支持挂载 Nuxt 静态 UI 并统一桌面端运行参数
    - 若存在 WECHAT_TOOL_UI_DIR 或 frontend/.output/public,则在 / 挂载静态站点并支持 SPA 路由回退
    - API 根端点调整为 /api,避免与静态 UI 冲突
    - 新增 WECHAT_TOOL_DATA_DIR 输出目录约定,统一 databases/key store 等路径
    - host/port 支持通过 WECHAT_TOOL_HOST / WECHAT_TOOL_PORT 配置,并打印可访问地址
    - 新增 backend_entry.py 作为 PyInstaller 入口,减少动态导入识别问题
  • build(pyinstaller): 增加 build extra 并更新 uv.lock
    - pyproject.toml 新增 optional-dependencies: build(pyinstaller)
    - 移除多余的 pathlib 依赖(Python 3 内置)
    - 更新 uv.lock,锁定构建依赖
  • fix(chat): 群聊发送者解析支持 alias 并避免覆盖 sender_username
    - _split_group_sender_prefix 支持传入已知 sender(username/alias),弱特征场景避免误拆前缀
    
    - 群聊消息按需读取 contact.db 的 alias 辅助解析昵称:\n前缀(带缓存)
    
    - 仅在 sender 缺失时回填前缀,避免昵称覆盖 sender id
  • fix(chat): 合并转发记录的图片/表情解析与媒体兜底
    - 前端:recordItem XML 清理非法控制字符并转义裸 &,补齐 fromnewmsgid/cdnurlstring/aeskey 等字段
    - 前端:图片接口追加 server_id;表情接口透传 emoji_url/aes_key
    - 后端:/api/chat/media/image 支持 server_id,从 message_resource.db 反查 packed_info 资源 md5 并优先定位
    - 后端:/api/chat/media/emoji 支持 emoji_url/aes_key,本地缺失时安全下载并尝试 AES-CBC 解密识别
  • docs(readme): 补充实时模式说明与致谢
    - 更新项目简介/功能点:补充聊天记录实时更新(SSE)
    
    - 增加 echotrace 致谢并整理参考项目列表
  • feat(chat): 前端增加实时开关并自动刷新会话/消息
    - 聊天页新增实时开关,自动探测 realtime 可用性
    
    - 监听 /api/chat/realtime/stream,变更时触发增量同步并刷新会话/消息
    
    - useApi 增加 realtime 接口,sessions/messages 支持 source 参数
  • feat(chat): 支持聊天记录实时更新(WCDB + SSE)
    - 新增 WCDB realtime 连接管理与 DLL 依赖,并在 shutdown 释放资源
    
    - 新增实时状态/变更 SSE 与增量同步接口(单会话/全会话)
    
    - sessions/messages 支持 source=realtime,增强内容解码与 packed_info md5 提取
    
    - wheel 打包包含 WCDB.dll / wcdb_api.dll
  • chore(gitignore): 忽略本地参考仓库与工具/数据目录
    - 忽略 .ace-tool/ 工作目录
    
    - 忽略 WxDatDecrypt/、echotrace/、oh-my-wechat/、vue3-wechat-tool/、wechatDataBackup/、wx_key/ 等本地参考/数据目录
  • feat(chat): 合并转发聊天记录支持预览与弹窗查看
    - appmsg(type=19) 解析为 renderType=chatHistory,并透传 recordItem(recorditem 原文)
    - 修复 recorditem CDATA 内包含 <refermsg> 时误判为引用消息的问题
    
    - 列表/导出路径统一带上 recordItem,并避免已解析的 appmsg 被二次 XML 解析覆盖
    - 前端聊天页新增聊天记录卡片 + 弹窗,支持按条展示及图片/视频/引用内容预览
    - 会话列表与摘要统一显示为 [聊天记录]
  • feat(keys): 自动保存密钥并支持前端回填
    - 新增 output/account_keys.json 账号密钥存储(db_key / image_xor_key / image_aes_key)
    - 新增 /api/keys 查询已保存密钥;缺失时兜底从账号目录 _media_keys.json 读取图片密钥
    
    - 数据库解密成功后按账号写入 db_key;保存图片密钥时同步写入 store(失败静默不影响主流程)
    - 前端解密页进入图片密钥步骤自动回填;进入下一步/跳过时自动保存一次
  • improvement(chat): packed_info md5 提取优先匹配 .dat 文件名
    - packed_info 同时包含多个 32hex 时,优先从形如 xxx_t.dat/.t.dat 的文件名中提取 md5;无匹配再回退到原 32hex 众数策略
    
    - 对齐 echotrace 的选择思路,降低取错 md5 概率
  • fix(chat): 图片消息优先使用资源 md5 修复 _t.dat 缩略图不显示
    - 图片消息(local_type=3)优先使用 message_resource.db 的资源 md5,避免 XML md5 与本地 *_t.dat 基名不一致导致 /api/chat/media/image 404
    
    - 同步覆盖消息合并/导出/列表三处解析路径
    
    refs #12
  • fix(chat): 图片消息优先使用包含 file_id 的本地 URL
    - 当服务端返回本地 /api/chat/media/image URL 时,优先使用前端拼的本地 URL(携带 file_id),提高兜底命中率
  • fix(media): 聊天图片增加会话 attach 快速兜底定位
    - get_chat_image 在 hardlink 缺失/不完整时,按会话 attach 目录快速探测 *_t.dat/*_h.dat,避免默认 deep_scan=0 直接 404 造成破图
    
    - md5 参数非 32 位时自动按 file_id 处理,覆盖部分版本的图片标识
  • feat(chat): 前端增加消息类型筛选与按类型导出
    - 聊天页新增消息类型筛选下拉框(render_types)
    
    - 导出弹窗新增“消息类型(导出内容)”多选与快捷项,并明确离线媒体不影响消息条数
    
    - createChatExport 透传 message_types;图片本地 URL 可同时携带 md5+file_id
    
    - 增加 message-filter-select 样式
  • fix(chat): 修复导出 ZIP 写入冲突并支持按消息类型导出
    - 修复导出时 ZIP entry 写句柄冲突(messages 先写临时文件再写入 ZIP)\n- 新增 message_types 过滤,进度/统计按所选类型计数\n- manifest.json 记录 messageTypes,避免导出含义歧义
  • perf(media): 媒体缺失查询默认快速 404(支持 deep_scan)
    - image/video/video_thumb 增加 deep_scan 开关,默认避免昂贵递归扫描\n- video/video_thumb 增加常见路径快速探测,减少切换筛选时慢 404
  • feat(chat): 会话消息列表支持按类型筛选
    - /api/chat/messages 支持 render_types(逗号分隔,多类型)\n- 统一 renderType 归一化(如 redPacket -> redpacket),避免筛选命中问题
  • improvement(media): 提升图片/表情资源解密稳定性并自愈缓存
    - 增加图片有效性校验并优化 JPEG/WebP 识别,降低 XOR 解密误判
    - 图片资源按变体(b/h/c/t)与大小排序尝试多个候选,提高命中率
    - 发现损坏缓存文件时自动删除并重建(单张获取与批量解密均生效)
    - 表情本地解密失败时支持从 emoticon.db 安全回退下载,并支持 AES-CBC 解密
  • fix(chat): 解析 XML 的 cdn 链接时进行反转义
    - 新增 _normalize_xml_url 统一处理 &amp; 等转义字符
    - 图片/视频/表情消息的 cdn URL 解析统一规范化,避免误判为 file_id
  • fix(chat): 修复发送侧表情下载按钮对齐
    - 表情消息在发送方向使用反向布局,避免下载按钮位置错乱
    - 下载按钮间距随发送/接收方向切换(mr-2/ml-2)
  • docs(readme): 精简使用指南并补充搜索截图
    - 移除字段模板/表结构文档/会话加速/图片资源解密等说明
    - 增加聊天记录搜索截图并更新相关描述
  • improvement(chat): 会话列表改用 session_last_message 缓存表
    - 用 session.db::session_last_message 缓存会话最后一条消息预览,减少会话列表查询开销
    - 增加缓存表构建/状态接口,列表缺失时自动补建
    - 解密阶段支持自动构建,环境变量切换为 WECHAT_TOOL_BUILD_SESSION_LAST_MESSAGE
    - 移除 session_preview_index 实现
  • docs(readme): 补充索引与密钥使用说明
    - 增加 session_preview.db 会话列表加速说明与开关
    
    - 更新媒体密钥获取建议(wx_key)与相关使用提示
    
    - 补充搜索相关截图资源
  • feat(chat): 前端聊天页支持消息搜索与筛选
    - 新增搜索侧边栏:会话内/全局搜索、时间范围、发送者与类型筛选
    
    - 支持搜索结果高亮与上下文定位
    
    - 对接后端索引构建状态与错误提示
  • feat(chat): 增加消息搜索索引与会话预览索引
    - 新增 chat_search_index.db:提供索引状态/构建/发送者接口
    
    - 新增 session_preview.db:会话最新消息预览索引,支持指纹校验与过期重建
    
    - 解密完成后默认预构建会话预览索引(WECHAT_TOOL_BUILD_SESSION_PREVIEW=0 可关闭)
  • improvement(media): 移除进程提取密钥并优化媒体解密
    - 移除 pymem/yara-python 依赖,明确仅使用 wx_key 获取密钥
    
    - 删除 media_key_finder.py,简化媒体密钥与资源定位逻辑
    
    - 更新媒体接口/脚本与导出说明,避免误导进程提取能力
  • docs(readme): 补充导出界面截图
    - 在界面预览中增加导出弹窗截图
    - 更新聊天记录页面说明,标明已支持离线导出
  • feat(chat): 聊天页增加导出弹窗与进度展示
    - 导出弹窗支持范围/格式/时间范围/媒体开关/文件名等参数
    - 批量会话列表展示头像,提供 全部/群聊/单聊 tab 与搜索
    - 导出进度使用 SSE 实时更新(失败回退轮询),提供进度条展示
    - 支持任务取消与 ZIP 下载
    - 隐私模式下导出同步隐私策略,且 hover 不再保持模糊
  • feat(chat): 新增聊天记录离线导出接口
    - 支持批量范围(选中/全部/群聊/单聊)与时间筛选
    - 支持 json/txt 导出并打包为 zip,附带 manifest/report
    - 可选打包离线媒体与头像;隐私模式下隐藏字段并禁用媒体/头像
    - 提供任务查询/取消/下载与 SSE 进度事件流
    - 修复导出路径名清理的正则误伤
  • improvement(media): 聊天媒体支持 file_id 兜底定位
    - 图片/视频消息无 MD5 时,解析并下发 file_id,用于本地资源兜底定位与展示
    - 后端 chat_media/open_folder 支持 md5/file_id;视频优先可 Range 的文件响应,并在需要时解密落盘
    - 前端聊天页与 API 调用适配 file_id;补充媒体 URL 可用性判断
    - 解密页补充“获取密钥”提示,支持手动输入/保存密钥;README 同步说明;更新音频图标资源
  • improvement(media): 优化媒体密钥提取与解密体验
    - 微信进程 AES 密钥提取:支持多 PID/更多进程名,尝试启用 SeDebugPrivilege,并扩展扫描范围与可读页过滤提升成功率
    - AES key 内存匹配支持 16/32 位候选,校验覆盖 JPEG/PNG/GIF/WEBP/MP4 等常见资源头
    - 解密页新增 XOR/AES 密钥一键复制与反馈提示,并补充管理员运行提示
    - README 更新徽章与界面预览表格,新增/更新截图资源
  • improvement(chat): 优化会话时间显示并增强文件消息资源定位
    - 会话列表时间按 今天/昨天/星期/日期/跨年 格式化
    
    - 文件类消息在 msg/file 目录下按时间与多策略更稳健定位
  • feat(chat): 聊天页支持可选 username 路由
    - 将聊天页迁移为 pages/chat/[[username]].vue(/chat 与 /chat/:username)
    
    - 选中会话时同步 URL,支持路由直达指定会话
    
    - 文件消息卡片补充文件类型图标与 WeChat PC 标识资源
  • refactor(api): 简化主入口文件为路由集成
    - 将api.py从2600+行简化为25行
    - 使用模块化路由替代单文件实现
    - 提高代码可维护性和可扩展性
  • refactor(api): 重构为模块化路由架构
    - 新增routers目录,按功能划分路由模块
      - health.py: 健康检查端点
      - chat.py: 聊天会话与消息查询
      - media.py: 媒体资源解密
      - decrypt.py: 数据库解密
      - wechat_detection.py: 微信安装检测
      - chat_media.py: 聊天媒体资源访问
  • refactor(api): 提取辅助函数模块
    - 新增chat_helpers.py: 聊天相关辅助函数(1064行)
    - 新增media_helpers.py: 媒体处理辅助函数(1550行)
    - 新增path_fix.py: 路径修复与验证功能(205行)
  • improvement(chat): 表情消息支持一键下载并优化渲染
    useApi 增加 downloadChatEmoji,对接后端表情下载接口
    
    聊天页识别远程表情地址并提供下载入口;下载成功后切换为本地表情 URL
    
    修正文本混排表情的渲染结构并微调选中态颜色
  • feat(chat): 增强聊天媒体能力(表情下载/资源定位/会话预览)
    新增 /api/chat/media/emoji/download,支持将表情资源下载到本地 resource
    
    消息列表补充 emojiRemoteUrl,本地存在资源时优先返回本地 emojiUrl
    
    open_folder 行为增强:更智能定位 emoji/资源目录,并改进 Windows Explorer 打开方式
    
    会话列表预览改为使用 _load_latest_message_previews,提升 last message 准确性
    
    工具脚本移除对 WxDatDecrypt 的依赖,媒体密钥提取逻辑内置到 media_key_finder
    
    wheel 打包包含 VoipEngine.dll(Windows 解码依赖随包分发)
  • chore(assets): 补充图片资源并更新致谢
    - 新增 frontend/assets/images 下的微信风格图片资源
    
    - 补充 frontend/public/image.png
    
    - README 致谢加入 vue3-wechat-tool 项目链接
  • chore(tools): 添加解密与资源调试脚本
    - 增加解密/资源/表情/媒体定位等调试脚本,便于本地排查与验证
  • chore(deps): 为Windows专有依赖添加平台标记
    - pywin32/pymem 增加 sys_platform == 'win32' marker,避免非Windows环境安装失败
    
    - 同步更新 uv.lock
  • improvement(chat): 优化聊天消息渲染与微信风格资源
    - 转账/红包消息改为微信风格卡片展示,补充状态与金额展示
    
    - 语音/通话等消息补充图标与交互样式,提升一致性
    
    - 增加聊天页使用的静态资源与表情资源,并补充表情映射文件
  • feat(media): 添加图片资源解密与SSE进度
    - 后端新增图片解密密钥获取/保存接口(/api/media/keys)
    
    - 新增批量解密接口与输出结构:resource/{md5前2位}/{md5}.{ext}
    
    - 新增资源直读接口(/api/media/resource/{md5}),自动识别媒体类型返回
    
    - 新增SSE实时进度接口(/api/media/decrypt_all_stream),前端可实时展示进度
    
    - 前端解密页增加图片解密步骤与进度条/统计/失败说明,并对接相关API
    
    - README 补充图片资源解密使用说明
  • chore: 更新配置和其他小改动
    - 更新nuxt配置
    
    - 优化首页样式
    
    - 调整主程序和解密逻辑
    
    - 添加数据库分析脚本
  • docs: 重写README并更新截图
    - 移除所有emoji符号
    
    - 界面预览移至功能特性上方
    
    - 更新截图为PNG格式并移至前端公共目录
    
    - 添加聊天记录页面说明(注明为基础功能)
    
    - 添加oh-my-wechat到参考项目
  • improvement(decrypt): 优化解密结果页面
    - 主按钮改为查看聊天记录跳转到聊天页面
    
    - 更换为统一风格的聊天图标