知微 · Zhiwei
让每段对话，成为有用的记忆。
知微是一个面向个人自部署的开源微信对话记忆工具。Windows 客户端只读解析本机微信数据，服务端帮助你浏览消息、整理记忆，并通过 MCP 将授权内容提供给自己选择的 AI 工具。本项目与腾讯或微信官方无关联，也不会代替用户发送微信消息。
官方网站 · 在线演示 · 部署与使用 · 开发指南 · 数据与隐私 · 版本下载
在线演示只包含虚构数据，不提供注册、客户端上传或真实微信接入。开源版 v1.0.0 是独立版本，与此前私有版本的版本号不对应；已有部署请先备份、在隔离环境验证迁移，不要直接覆盖。
主要功能
- 本地解析与同步：在 Windows 本机读取微信聊天记录；同步群聊和通讯录好友私聊，支持近期消息优先、历史补传与失败重试。
- 多媒体与链接：支持图片、视频、语音、文件和分享链接的解析与展示；媒体内容可同步到服务端，实际可用性受微信版本及本机文件状态影响。
- 会话与记忆：在服务端检索、浏览消息，选择监听对象，配置自己的模型生成总结、关系记忆及个人画像。
- 多模态分析：根据模型能力处理图片、视频画面、音频和文件正文。音频需要支持对应输入的模型；分析会将相关内容发送至所配置的模型服务。
- MCP 接入：创建只读或全部权限的 Key，并限制会话授权范围；外部 AI 可以查询消息及可用的媒体内容。
- 个人部署：服务端支持 Docker Compose；Windows 客户端支持系统托盘和开机启动。
快速开始
准备 Docker 和 Docker Compose，以及已登录 Windows 微信的 Windows 10/11 x64 电脑。需要自动分析时，自行准备兼容的模型服务。
git clone https://github.com/w89588/zhiwei.git
cd zhiwei
python tools/init_server_env.py
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
打开 http://127.0.0.1:8787/，使用 .env 中生成的管理员账号和密码登录并修改密码；创建普通用户及客户端凭据后，从 Releases 下载 Windows 客户端，填写服务端地址并选择微信账号。跨设备访问、局域网设置、图片密钥和故障排查详见 部署与使用指南。
数据边界
服务端存储和消息批次使用加密，但服务端持有主密钥并需要解密内容以提供查询和模型分析，并非服务端无法解密的端到端加密。客户端会在本机生成解密缓存。HTTP 连接不加密凭据，应只在可信网络中使用；公网建议 HTTPS。AI 服务会收到所选的聊天和媒体内容。详见 数据与隐私说明。
文档
| 文档 | 内容 |
|---|---|
| 部署与使用 | 环境要求、首次部署、客户端、模型与 MCP |
| 开发指南 | 仓库结构、本地运行、测试、构建和发布 |
| 数据与隐私 | 加密、密钥、备份、媒体和模型边界 |
| 演示站设计 | 静态示例、运行方式及无写入边界 |
| 历史技术文档 | 旧版本部署与备份资料；版本号和链接仅供参考 |
| 发行说明 | v1.0.0 与兼容性说明 |
| 贡献指南 | 提交问题和变更 |
许可与致谢
本项目采用 MIT License。你可以使用、修改和发布派生作品；分发本软件或其重要部分时须保留原版权声明和许可声明。第三方组件及其许可见 NOTICE.txt 和对应许可证文件。