WechatVibe README

The project's README from github.com/tswawa/WechatVibe. As one markdown file: README.md.

WechatVibe

WechatVibe

微信聊天情感分析客户端
意图识别 · 情绪感知 · 人物画像 · 群聊画像 · 好感度 · MBTI 聊天推测

最新版本 Windows 10/11 License: Apache-2.0

功能介绍 · 下载安装 · 首次使用 · 常见问题 · 数据与隐私 · 免责声明 · 交流与反馈

WechatVibe 只读读取本机已登录的 Windows 微信，分析聊天中的情绪和意图，并生成人物画像、好感度和 MBTI 推测。适合想回看聊天中的情绪变化、了解日常交流方式的用户。

API 模式下的消息情绪与意图识别

截图中的聊天和分析结果均为虚构演示数据。

功能介绍

消息情绪与意图

在聊天页点击「意图识别」，消息下方会显示情绪和意图两个短标签，例如「开心」「期待」「委屈」，或「分享」「邀约」「求安慰」「婉拒」。

人物画像

从聊天工具栏或左侧导航进入「人物画像」，在同一页面查看好感度、MBTI 倾向、互动风格和画像摘要。

人物画像：好感度、MBTI 倾向、互动风格和摘要

群聊画像

在群聊中进入画像页面，可以在「群整体」和具体成员之间切换。

群聊整体画像与成员选择

聊天记录与账号

软件只读读取本机已登录的微信，支持单聊、群聊、联系人和群头像。图片消息显示为 [图片]。

截图：选择要查看的会话

选择要加入聊天列表的会话

模型与设置

截图：模型设置与缓存管理

本地 Laya 下载与运行设备选择

API 服务地址、协议、模型与上下文设置

按本地和 API 模型来源分别管理分析缓存

下载安装

  1. 从 Releases 下载最新的 WechatVibe-版本号-windows-x64.zip。这是标准运行包，不含 Laya 模型。
  2. 解压后保留整个 win-unpacked 目录，双击其中的 WechatVibe.exe。
  3. 使用本地分析时，在「设置 → 本地部署」下载模型（独立的 WechatVibe-Laya-model-v1.zip），或选择已有的模型目录。只用 API 可以跳过这一步。

运行要求

项目 要求
系统 Windows 10/11 x64
微信 Windows 微信 4.x，已实测 4.1.15.13；不支持 3.x
本地 Laya 配置参考（只用 API 可以跳过）

模型约 3.22 亿参数，纯 CPU 即可运行，不需要独立显卡。下表为建议配置，低配设备尚未系统测试。

项目 建议配置
CPU 4 核及以上 x64 处理器；CPU 推理默认使用 4 线程
内存 8 GB 起步；同时运行微信和其他应用，建议 16 GB 及以上
GPU（可选） 支持 WebGPU 的显卡和较新的驱动，不兼容时使用 CPU；最低显存要求暂未确定
磁盘 至少预留 4 GB，用于应用、模型下载和安装；聊天缓存和更新备份另算
模型体积 模型包约 599 MB，解压后约 681 MB；文件体积不等于运行时的内存占用

首次加载和分析历史消息的速度取决于处理器、内存和聊天量。API 模式不需要下载 Laya，也不需要本地显卡，速度和上下文容量取决于所选的模型服务。

首次使用

  1. 登录微信：使用 Windows 微信 4.x 登录要分析的账号。
  2. 启动软件：双击 WechatVibe.exe。账号状态可在「设置 → 管理账号」查看，不用等聊天加载完就能使用界面。
  3. 选择模型：在「设置 → 通用设置」选择模型来源。本地模式下载或选择 Laya 模型；API 模式填写服务地址、API Key 和模型，确认上下文大小，测试连接后保存并启用。
  4. 添加会话：点击左侧搜索框旁的「＋」，或在「设置 → 信息列表」选择联系人或群聊。
  5. 查看分析：打开聊天，点击「意图识别」查看消息标签；进入「人物画像」查看画像，群聊还可以选择具体成员。

软件更新

在「设置 → 关于 → 当前版本」检查更新，发现新版本后点击「下载并安装」。下载的文件会先校验，安装完成后自动重启；账号数据、分析结果、画像和已下载的模型都会保留。安装失败会自动恢复旧版，更新成功后也可以回退到上一版（只保留最近一次）。Windows 设置了系统代理时，更新会沿用该代理连接 GitHub。

各版本的改动见更新日志。

从旧版本升级的注意事项
  • 已有的 API 画像：1.2.3 起 API 画像改用新规则。升级后先显示旧画像，在画像页点击「更新画像」后才按新规则重新分析。
  • 从内置模型的旧版升级：原来的 Laya 模型会保留，设置中显示为已就绪。
  • 1.2.1 首版从目录映射（Junction）启动：如果更新时提示「更新包或安装位置不可用」，请手动下载最新版，退出软件后覆盖原目录，保留 resources/client/.local 和 resources/client/.models。
  • 从 1.0.4 升级：旧更新器不支持现在的运行包，需要手动下载。完全退出旧版后，把新包 win-unpacked 里的文件覆盖到原软件目录，保留 resources/client/.local 和 resources/client/.models，不要先删除旧目录。

常见问题

一直显示「当前微信账号未就绪」
  • 确认使用的是 Windows 微信 4.x（不支持 3.x）。使用旧版微信时，请先更新微信并重新登录，再启动 WechatVibe。
  • 微信数据存放在自定义位置时，在「设置 → 通用设置 → 聊天记录路径」手动选择 xwechat_files 或账号目录。
  • 仍然无法解决时，运行下面的启动诊断工具，再到 Issues 反馈。
启动时提示「本地服务未就绪」或无法打开

下载 WechatVibe-diagnose.bat，放到 WechatVibe.exe 所在目录后双击运行。它会检查文件、运行环境和启动错误并生成报告；不启动应用或模型，不读取聊天数据库和 API Key，也不会自动上传。详见启动诊断说明。

升级后人物画像还是旧的

旧的 API 画像会先保留显示。在画像页点击「更新画像」，才会按新规则重新分析；重建期间会标明正在显示旧画像。

开发

后端按应用服务、微信只读适配器、Node 推理适配器和 SQLite 存储拆分，模块职责、依赖边界和回归命令见后端架构说明。

源码运行

需要 Node.js 24.11.1、Python 3.14 和 npm。在 PowerShell 中执行：

git clone https://github.com/tswawa/WechatVibe.git
cd WechatVibe
npm ci
py -3.14 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --no-deps -r python-requirements.lock.txt
npm start

需要本地 Laya 时，可在首次启动前执行 npm run setup:models，或进入应用后下载；仅使用 API 时可跳过模型下载。源码方式下载模型约 681 MB，下载后校验 SHA-256。下载器保留 .part 文件供断点续传，网络失败最多尝试三次；完整文件通过大小和 SHA-256 校验后才替换旧文件，强制下载失败不会删除已有模型。默认目录为 .models/laya，可通过 LAYA_MODEL_DIR 或 --dir 指定。Python 安装时请按锁文件安装并保留 --no-deps。

应用内“下载模型”使用 GitHub 上的独立模型 ZIP，安装到 resources/client/.local/models/laya。当前桌面下载中断后需要重新下载；上述断点续传功能适用于 npm run setup:models，两者使用不同的下载入口。

npm ci 完成后会运行 Electron 官方安装器补全桌面运行时；若跳过了安装脚本，启动或构建前执行 npm run setup:electron。

Python 脚本优先使用 WECHATVIBE_PYTHON 指定的解释器，其次使用当前虚拟环境，再使用项目 .venv，避免测试或构建误用系统 Python。便携构建仍要求 Python 3.14 和 Node 24.11.1，可用 --python-exe / --node-exe 显式指定。npm run start:service -- --no-open 可单独启动 bridge；npm start 会启动桌面客户端。CPU/GPU 切换位于「设置 → 通用设置」。

本地验证 
npm test                 # 类型检查 + Node + 桌面/更新脚本 + Python 回归
npm run test:model       # 真实加载本地 ONNX，执行中文推理（需先下载模型）
npm run test:recovery    # 桌面、服务恢复、账号存储和启动器测试
npm run build:portable   # 构建包含模型和运行环境的便携版
构建运行版

完成上述依赖和模型安装后，在同一个 PowerShell 窗口运行：

$env:PATH = "$PWD\.venv\Scripts;$env:PATH"
npm run build:portable

构建命令会打印本次独立的产物目录：.local/portable-builds/build-*/release/win-unpacked/WechatVibe.exe。整个 win-unpacked 目录构成本地运行版，包含模型和运行环境。公开发行采用无模型标准包 + 独立 Laya 模型包；scripts/build-windows-release.py 默认生成不含模型的标准 ZIP。

修改词库

当前词库包含 40 个情绪、547 个意图细项、98 个表达方式和 80 个人际需求。同义意图共用 215 个简短显示词，表达方式与人际需求两组词表生成 7,840 个组合。

源文件为 scripts/analysis-catalog-source.json、scripts/intent-display-source.json 和 scripts/social-intent-source.json。修改时保留既有 ID，然后执行：

npm run catalog:generate

数据与隐私

使用时请注意：

免责声明

WechatVibe 面向技术学习、研究及个人聊天复盘。使用前请确认数据来源和使用方式符合适用法律、微信服务协议及相关第三方服务条款。

WechatVibe 为独立项目，与腾讯、微信没有官方隶属、合作或背书关系。相关名称、商标及第三方组件的权利归各自权利人所有。

许可

项目采用 Apache-2.0。Laya、模型与第三方依赖的来源及许可见 THIRD_PARTY_NOTICES.md。

演示头像使用 Lisa Wischofsky 的 Adventurer 插画，经 DiceBear 组合并调整配色，采用 CC BY 4.0；该素材许可独立于项目代码许可。

致谢

感谢为本项目提交代码和反馈问题的朋友
  • 感谢 china-luo 在 Issue #1 中反馈 Windows 微信 4.1.15.13 的聊天记录读取异常，并提出对非字符串消息类型进行兼容转换的建议。
  • 感谢 Li Xiang 反馈微信数据库密钥不完整、反复读取的问题，并提供排查信息，帮助定位读取兼容性问题。
  • 感谢 luo785859020（小闹一起） 通过 PR #3 和 PR #4 改进源码模型下载、Python 环境选择与验证流程，并完成后端职责分层。
  • 感谢 morticuke 在 Issue #5 中提供 Windows MIME 映射异常的排查过程和修复建议。
  • 感谢 Dl1447（Geekline） 通过 PR #12 修复选中首个会话后无法继续添加会话的问题。
  • 感谢 silicon-sbt 通过 PR #13 改进 API 消息标签的批量结果对应。
  • 感谢 Ch1cken-1145（Ch1cken_#） 通过 PR #16 加入手动设置微信聊天记录路径的功能。
  • 感谢 LianYu-Ya 在 Issue #14 中反馈自部署模型批量标签格式错误、只返回一条的问题。

赞助

因为本项目的特殊性，永久不接受任何形式的赞助。

合作说明

如需使用、修改或再分发本项目，请以本仓库的 Apache-2.0 许可证为准；第三方组件遵循各自的许可证。本说明不改变开源许可证已授予的权利。

第三方基于本项目独立开发、分发或运营的衍生版本，由相应开发者或运营者自行负责维护、服务支持及其对外承诺。使用本项目源码不代表与本项目或维护者建立合作关系，也不代表相关衍生版本获得本项目的认可、担保或背书。未经明确授权，不得以本项目或维护者名义对外开展合作或作出承诺。

交流与反馈

WechatVibe (tswawa/WechatVibe)

Searching Database…

268 ·GitHub
WechatVibe
Что это?WechatVibe — десктопное приложение для Windows, которое в режиме «только чтение» анализирует ваши открытые чаты WeChat, размечая эмоции и намерения, и строит профили личности, профили групп, оценки близости и MBTI-выводы по переписке — используя либо локальную ONNX-модель Laya, либо LLM через API.
Это облачный сервис или то, что работает на моём ПК?Это отдельное десктопное приложение для Windows, которое читает локальную базу WeChat прямо на вашей машине; по умолчанию ничего о ваших чатах не хранится удалённо.
Как установить и начать им пользоваться?Скачайте WechatVibe- -windows-x64.zip из Releases, распакуйте, сохранив всю папку win-unpacked, запустите WechatVibe.exe, затем выберите источник модели (скачать локальную модель Laya или настроить API) и добавьте чаты, которые хотите анализировать.
Какая версия WeChat ему нужна?Требуется клиент WeChat для Windows версии 4.x (проверено на 4.1.15.13); WeChat 3.x не поддерживается.
MBTI-догадка появляется сразу?Нет — MBTI-вывод по переписке для человека открывается только после минимум 100 валидных проанализированных сообщений, измерения со слишком малым количеством данных показываются как неопределённые, а функции экспорта чатов у приложения нет.
Что видно в профиле человека помимо MBTI?На странице профиля человека также показываются оценка и уровень близости, радарная диаграмма стиля общения по шести осям (выразительность, юмор, спокойствие, инициатива в темах, заботливая поддержка, близость) и часто обсуждаемые темы — всё постепенно обновляется по мере поступления новых сообщений.
Можно анализировать и групповые чаты?Да — профили групповых чатов показывают общую статистику группы (участники, число сообщений, стиль взаимодействия, частые слова, сводка), а также профили отдельных участников, которые можно искать или листать постранично.
Какие API-провайдеры можно подключить вместо локальной модели?WechatVibe может подключаться к Anthropic, OpenAI-совместимым Responses/Chat Completions, Gemini или эндпоинтам, совместимым с Ollama, — достаточно указать Base URL, API-ключ и размер контекста.
What are similar projects?openwhispr, qiaomu-clipper, starnet, CodePilot, open-codesign, get-it, Minke, wechat-ai-memory
Which topics is it in?emotion-recognition, data-privacy, sentiment-analysis, local-ai, onnx, offline-first, wechat, windows-app, openai-compatible, nlp, ollama, electron
Creator
tswawa
Size
4.2 MB
Stars
268
Updated
CommitOct 11Releasev1.3.5Oct 11
Age
24d
Commits · 90 Days