核心用法
本工具通过Python脚本读取电脑版微信的本地SQLite数据库，提供命令行方式查询个人数据。主要功能包括：
list列出所有数据库文件位置contacts查看联系人列表（昵称、备注、微信号）sessions查看最近会话及预览内容search按关键词搜索历史消息favorites浏览收藏的内容stats输出数据统计概览
支持macOS（默认路径~/Library/Containers/com.tencent.xinWeChat/）和Windows（需自定义路径），通过--path参数可指定非标准安装位置。
显著优点
1. 只读安全设计：明确使用SQLite mode=ro只读模式，禁止任何写入操作，从机制上避免误删数据
2. 本地化隐私保护：全部运算在本地完成，零网络传输，不上传任何信息
3. 权限透明：依赖系统级"完全磁盘访问权限"，用户需在系统设置中主动授权
4. 实用性强：解决微信官方不提供的聊天记录导出、批量搜索、统计洞察等需求
潜在局限
- 平台受限：不支持iOS/Android移动端数据库直接访问
- 运行时冲突：微信程序运行时会锁定数据库，需先退出微信才能读取
- 部分加密：微信对部分字段有额外加密，工具可能无法完全解密
- 路径依赖：Windows用户需手动查找并指定
WeChat Files路径
适合人群
- 需要备份/整理微信聊天记录的个人用户
- 进行社交数据量化分析的进阶用户
- 忘记具体聊天内容但需快速定位的历史信息搜索者
- 希望导出收藏夹内容进行知识管理的效率工具用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 隐私泄露 | 读取的联系人、聊天内容属高度敏感信息 | 确保执行环境私密，输出文件及时清理 |
| 权限滥用 | 获得磁盘完全访问后可能误操作其他数据 | 仅授予必要终端，用后及时撤销权限 |
| 数据库锁定冲突 | 微信运行时读取会导致错误 | 操作前确认微信已完全退出 |
| 版本兼容性 | 微信数据库结构更新可能导致解析失败 | 关注工具更新，遇到异常反馈维护者 |