NoCannoBB

外观

用 NoCannoBB 打造一个「会读你微信记录」的 AI 助手 ​

一套从零到一的实战教程：把「读取你自己设备上的微信数据库」写成 Python， 封装成 MCP，再用一个 Skill 让 AI 用自然语言驱动它，模型推理走 NoCannoBB。

学完你会得到一条完整、可复用的链路：

 你自己的微信本地库（加密）
   └─(第1章) 取密钥 + SQLCipher-4 解密 ──▶ 明文库
        └─(第2章) db_reader 只读查询 ──▶ 结构化的消息/联系人
             └─(第3章) MCP Server 暴露固定只读工具
                  └─(第4章) Skill 把自然语言路由到 MCP 工具
                       └─(第5章) NoCannoBB 提供模型推理，跑起来

四个角色各司其职，这也是这套教程真正想教会你的东西：

角色职责
Python 文件真正读取数据库（解密、查询、解压、脱敏）
MCP把 Python 能力以「固定工具」的形式暴露给任意 AI 客户端
Skill决定什么时候调用哪个工具、如何解释结果
NoCannoBB提供模型推理接口（base_url / api_key），让 Skill 有大脑

适用范围与前提 ​

  • 仅用于解密你自己设备上、你自己账号的个人数据。 本教程默认你在本人电脑上、 对本人微信操作，用途是个人数据检索与备份。
  • 已在 微信 4.1.12.55 / Windows 11 上实测跑通整条链路；macOS 版解密/读库核心 与 Windows 共用，密钥捕获部分见 code/wechat_mac/README-mac.md。
  • 需要 Python 3.10+。

章节 ​

  1. 00 · 架构与原理 —— 微信 4.x 怎么加密，我们怎么拆
  2. 01 · 取密钥与解密 —— 从进程内存 + Weixin.dll 取密钥，SQLCipher-4 解密
  3. 02 · 只读读库层 —— db_reader 读消息、联系人，标识符校验与参数化
  4. 03 · 封装为 MCP —— 把只读函数做成 MCP Server
  5. 04 · NoCannoBB Skill —— 用 Skill 编排，路由自然语言
  6. 05 · 跑起来与安全边界 —— 客户端配置、临时文件清理、红线

参考代码 ​

code/ 目录是本教程配套的、实测通过的完整实现：

code/
├── wechat_win/        # Windows：取密钥 + 解密 + 读库 + CLI（第 1~2 章讲解）
├── wechat_mac/        # macOS：lldb 捕获密钥，解密/读库与 Windows 共用
├── wechat_mcp/        # 只读 MCP Server（第 3 章新增）
│   ├── server.py
│   └── requirements.txt
└── skill/wechat-local/
    └── SKILL.md       # NoCannoBB / Claude Skill（第 4 章新增）

各章会带你把这些文件从头写一遍并理解为什么这么写，而不是复制即用。