# wechat-notify

**Repository Path**: yuz_cn/wechat-notify

## Basic Information

- **Project Name**: wechat-notify
- **Description**: 微信来消息提醒 · Windows 桌面横幅提醒工具（微信4.x新消息→顶部横幅，支持消息内容/发件人/群聊分类显示）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微信来消息提醒 · 使用说明

> 收到微信新消息时，在屏幕顶部弹出类似手机的横幅提示，**直接显示发件人昵称和消息内容**。
> 当前版本：**v3.1**（仓库内全版本源码归档：v2.0 ~ v3.1）

## 快速开始

| 方式 | 操作 |
|---|---|
| **独立程序（推荐）** | 下载 `微信提醒 v3.1.exe`（见 Releases），双击运行，后台无窗口 |
| **密钥提取工具** | 首次使用需先运行 `微信密钥提取工具.exe` 提取本机微信数据库密钥 |
| **Python 源码** | `pythonw wechat_notify.py`（需 Python 3.13+，`pip install pycryptodome zstandard pystray pillow`） |

启动后收到微信新消息，屏幕顶部弹出粉色横幅：
- **左键点击** → 打开/呼出微信
- **右键点击** → 立即关闭横幅
- 横幅可按住任意位置拖动（全局拖动）

## 功能特性（v3.x）

- **消息内容显示**：发件人昵称 + 消息具体内容
- **群聊/私聊分类**：`小薛 在 xxx群 里发了一条消息` / `冬季 给你发送了一条消息`
- **多类型识别**：图片 / 语音(带时长) / 视频 / 表情 / 位置 / 文件 / 链接 / 撤回
- **转账/红包识别**：`[转账 210.00元]` / `[红包]` / `[转账] 付款给 xx`
- **长消息截断**：超长内容按像素精确截断为一行 + `…`，不裁切昵称
- **免打扰时段**：指定时间段不弹窗不响铃
- **横幅自定义**：位置 / 配色 / 圆角 / 显示时长
- **开机自启动**（可选，无控制台窗口）

## 工作原理

Windows 版微信 4.x 消息数据库加密存储，本工具通过监控数据库 **WAL 文件**实时变化检测新消息，
并对加密库进行本地解密后读取消息内容：

1. 用密钥提取工具获取本机主密钥（`%APPDATA%\微信提醒\wx_key_<账号>.txt`）
2. PBKDF2-HMAC-SHA512 派生每库密钥 → AES-256-CBC 逐页解密
3. 读取消息表获取最新消息（昵称 / 内容 / 类型 / 群聊信息）

**参考致谢**（解密方案来源）：
- GitHub [dapingzui/wechat-decrypt](https://github.com/dapingzui/wechat-decrypt)（纯 Python 解密方案）
- 吾爱破解 M0r14rtykk：《微信4.0 数据库密钥的获取》《微信4.0 消息数据解析》（WAL + zstd 压缩原理）

**项目开发**：本工具由 YikZ 与 **豆包 AI 助手** 协作开发（需求设计、监控/解密/横幅全链路实现与持续迭代）。

## 配置项

图形化设置界面（托盘右键 → 设置）：基础设置 / 美化设置 / 高级设置 / 关于。

运行日志：`%APPDATA%\微信提醒\微信提醒.log`

## 常见问题

- **点了 exe 没反应？** 它后台运行无窗口，属于正常。发一条微信消息测试是否弹横幅。
- **换账号了？** 重新运行密钥提取工具提取新账号密钥（密钥与账号绑定）。
- **收到消息没有横幅？** 检查 `%APPDATA%\微信提醒\config.json` 是否启用，或查看日志定位。
- **exe 被杀毒误报？** 加密/解密行为可能触发启发式查杀，加白名单即可。

## 声明

- 本工具仅供学习交流，**禁止商业用途**
- 版权纠纷使用者自负
- 与腾讯公司无任何关联