WechatVibe

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

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

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

• 本地模型：使用 Laya 多语言 ONNX 模型，在本机完成分析。
• API 模式：可接入 Anthropic、Responses、Chat Completions、Gemini 或 Ollama 兼容接口。
• 微信数据读取：基于 wechatauto-replica 的本地数据库接口，只读获取当前登录账号的会话和消息。

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

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

• 结合上下文：参考近期聊天和已保存的人物画像来判断，不只看单句；纯标点消息也能分析。
• 本地与 API 一致：两种模式显示方式相同。API 模式的每个标签不超过四个字，使用支持流式返回的接口时会边分析边显示。
• 人物情绪与群聊氛围：单聊顶部显示聊天对象当前的情绪状态，群聊顶部显示整体氛围。
• 随时开关：关闭标签后再打开，会恢复已有结果。

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

• 好感度：单聊显示好感度数值和等级，随新消息持续更新。
• MBTI 聊天推测：按 E/I、S/N、T/F、J/P 四个维度显示倾向。该人物已分析的有效文本满 100 条后解锁，依据不足的维度显示为未确定。
• 互动风格：六维雷达图，包括表达活力、幽默表达、情绪平和、话题主动、关怀支持和亲近表达。
• 常聊内容：根据实际分析过的文本展示高频词。
• 统一计分：API 模式按上下文容量整批判断聊天，好感度、MBTI、雷达和摘要使用与本地 Laya 相同的累计和打分规则。
• 保存与续算：再次进入时先显示上次的结果，新消息在原有基础上继续分析，切换聊天或重启软件都不会重新分析全部历史；分析中可查看进度和速率。

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

• 群整体：参与人数、消息数量、分析进度、六维互动风格、常见词和群聊摘要。
• 成员画像：搜索或翻页选择成员，查看该成员的互动风格、摘要和 MBTI 聊天推测。
• 分别保存：群整体和每个成员各自积累结果，切换时显示对应对象的画像。

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

• 按需添加会话：首次进入只读取会话目录，不加载全部聊天。点击左侧搜索框旁的「＋」，或在「设置 → 信息列表」添加要查看的会话；移出列表不会删除缓存或画像。
• 历史记录：分页查看更早的消息，可按关键词或日期查找，并定位到上下文。
• 聊天记录路径：自动找不到微信数据时，可在「设置 → 通用设置 → 聊天记录路径」选择 xwechat_files 或账号目录，也可以恢复自动发现。选择目录后仍需微信登录并通过账号校验。
• 多账号：每个微信账号使用独立的数据库，再次登录时复用原有记录。
• 清除账号：在账号管理中清除某个账号在 WechatVibe 里的聊天副本、分析和画像，不影响微信本身的聊天记录。清除当前账号后软件会退出。

• 模型来源：默认使用本地 Laya，也可以接入 API。填写 Base URL、API Key 和上下文大小后，可获取模型列表、测试连接并启用。
• 上下文容量：API 画像按模型的上下文容量自动分批，装得下就一次处理。完整的画像判断至少需要 12288 tokens 上下文，不足时会提示。
• 分来源保存：本地和各个 API 模型的结果分开保存，可在设置中分别查看和清除缓存。
• 运行设置：浅色/深色主题、界面缩放，以及 CPU/GPU 切换；GPU 不可用时可回退到 CPU。

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

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

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

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

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

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

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

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

npm run catalog:generate

• 本地模式（默认）：使用本地 Laya 在本机推理，本地服务只监听回环地址。
• API 模式（需手动开启）：消息分析会把当前这批聊天文本和简短的画像参考发送给你配置的模型服务；人物画像会按上下文容量发送所选会话的历史文本，由模型判断后，再由程序计算好感度、MBTI、互动风格和摘要。
• 保存方式：聊天副本按微信账号保存，分析结果和画像再按模型来源分开。

使用时请注意：

• 只读取自己有权访问的账号和聊天，不用于获取他人的私人记录。
• 清除账号只删除 WechatVibe 保存的数据，不删除微信原始聊天。
• 软件只分析和展示，不自动发送微信消息，也不提供聊天记录导出功能。
• 不要把聊天数据库、解密密钥、账号缓存或带私人内容的日志上传到仓库、Issue 或交流群。
• 反馈问题前先检查截图和日志，移除不想公开的姓名、账号和对话。

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

• 功能与使用边界：本项目不提供微信聊天记录导出功能，本地缓存用于应用内查看与分析。项目不提倡通过导出、传播、交易或再利用聊天记录侵犯用户隐私、数据权益或微信相关合法权益，也不为此类用途提供支持。
• 数据授权：仅处理本人合法持有、有权访问和分析的聊天记录。能在设备上看到记录，不代表可以任意公开、传播或用于其他目的；涉及他人信息时，应尊重其隐私和合法权益。不得用于盗取账号、未经授权的监控、跟踪、骚扰或其他违法侵权活动。
• 分析边界：意图、情绪、好感度和 MBTI 均为模型推测，可能遗漏语境或产生错误。结果不等于对方真实想法，不构成心理诊断、人格定性或官方测评，不应作为作出重大个人决定的唯一依据。
• 第三方服务：启用 API 后，所选聊天片段和画像摘要会按功能需要发送至你配置的服务商。请自行了解其计费、数据保存与隐私政策；项目无法替第三方承诺数据安全、服务稳定性或分析准确率。
• 运行风险：微信版本、操作系统、权限和第三方组件变化可能影响读取与运行。请保留重要数据备份；项目不保证持续兼容、数据绝不丢失，也不承诺“零风险”或“不会封号”。
• 许可与担保：本项目依据 Apache-2.0 许可证“按现状”提供。除适用法律要求或另有书面约定外，维护者及贡献者不提供任何明示或默示担保，包括适销性、特定用途适用性及不侵权担保；不承诺分析结果准确、运行持续稳定或适合任何特定使用场景。
• 使用者责任：使用者应自行判断本项目是否适合其用途，并负责取得账号、聊天数据及第三方服务所需的授权。由使用者自行决定的数据处理方式、服务配置、结果使用，以及自行或委托第三方实施的修改、部署与运营，由相应使用者、开发者或运营者承担其行为及承诺所对应的责任。
• 责任限制：在适用法律允许的最大范围内，且除另有书面约定外，维护者及贡献者不对因使用或无法使用本项目而产生的直接、间接、附带、特殊或后果性损失承担责任，包括数据丢失、账号受限、业务中断及其他损失。担保与责任限制的具体范围以 Apache-2.0 许可证第 7 至第 9 条为准。

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

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

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

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

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

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

• 问题反馈：GitHub Issues
• QQ 交流群：921170374
• 作者：tswawa