tswawa / WechatVibe

# 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 聊天推测。
- **分别保存**：群整体和每个成员各自积累结果，切换时显示对应对象的画像。
### 助手仓库与聊天助手
左侧「助手仓库」管理已启用的助手。在聊天工具栏点击「聊天助手」，会在主窗口右侧打开固定宽度面板，可以结合当前会话询问交流建议、整理聊天内容或拟写回复。回答和草稿不会自动发送到微信。
- **导入助手**：点击「新建助手」，从 GitHub 地址、本地 `SKILL.md`、技能目录或 ZIP 导入。读取预览后可编辑名称、说明、欢迎语和提示词；需要只读适配的资料由用户确认后导入。
- **编辑与技能**：已有助手可以继续编辑，选择或移除所用技能。取消编辑不会改变其他助手的共享资料；重复导入同来源、同版本会复用已有助手，保留其编辑和对话。
- **保存与恢复**：对话、草稿和已生成结果按微信账号、会话、助手分别保存。切换聊天或重开面板显示对应记录；失败可重试，停止时保留已经生成的内容。
- **重置助手对话**：在输入框发送 `/reset`，只重置当前助手在当前会话中的对话，不清除微信记录、消息分析或人物画像。
- **模型要求**：使用设置中保存的生成式 API 或 Ollama 兼容接口，模型需要支持工具调用。本地 Laya 负责消息与画像分析，不用于生成助手回答；聊天分析仍可保持本地模式。
- **只读能力**：助手仅能读取本轮提供的当前会话资料和选用的技能文本，不能发送微信消息、执行命令、修改文件或访问其他会话资料。导入包内的脚本和外部工具能力不会执行。
详细用法见助手仓库与聊天助手。
### 聊天记录与账号
软件只读读取本机已登录的微信，支持单聊、群聊、联系人和群头像。图片消息显示为 `[图片]`。
- **按需添加会话**：首次进入只读取会话目录，不加载全部聊天。点击左侧搜索框旁的「＋」，或在「设置 → 信息列表」添加要查看的会话；移出列表不会删除缓存或画像。
- **批量管理**：管理会话时，已添加的项排在前面。勾选后点击「移除所选」，每次最多移除 1000 个会话，只改变列表选择，保留聊天、画像和助手记录。
- **历史记录**：分页查看更早的消息，可按关键词或日期查找，并定位到上下文。
- **聊天记录路径**：自动找不到微信数据时，可在「设置 → 通用设置 → 聊天记录路径」选择 `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 可以跳过这一步。
###