本地 · 私有 · 你自己的数据

把散落在聊天里的
这些年
重新收进一座书斋。

你不必写一行代码。把几份"规范文档"交给 AI,再说一句话——它便替你解密整段微信往事、归整所有下载过的文件、提炼出多年沉淀的思想,长成一座端口 3456 的本地档案馆。

0
条消息已解密
0
个会话可浏览
0
份文件已归类
0
条 AI 洞察
碎片,正被一页页收拢成册
缘起 · WHY

这些年的话,都在聊天软件里。 七十三万条消息、几千份文件,是被你亲手存下、却再也找不回的时间。 它们本该是一座档案馆, 却散成了无人翻阅的缓存与气泡。 于是有了这件事:让 AI 替你解密归整提炼, 把它们一页页收拢,长成一座真正属于你的书斋

全程本地完成 · 原始数据一字不动 · 不上传任何一个字节
书斋四壁 · WHAT

一个真正属于你的「第二大脑」

解密、归整、提炼,全部在本地完成——不上传任何数据,原始聊天记录与文件一字不动。四面墙,围成一座可全文检索的私人档案馆。

💬 第一壁 · 往事

一键重读全部聊天

解密全部微信聊天记录,按人物 / 群组浏览。真实气泡、按天分隔、会话内全文检索——像在用微信本体,却是离线的、可被搜索的往事。

decrypt · browse · search
🗂️ 第二壁 · 卷宗

文件全格式直渲

归整所有从聊天里下载过的文件,按一级分类归档、自动去重。左侧 VS Code 风格文件树,右侧直接内部渲染:图片 / 视频 / 语音 / PDF / Word / Excel / PPT / Markdown / 代码 / 网页 / 压缩包 / 数据库结构——无需打开任何外部程序。

tree · preview · dedup
🧠 第三壁 · 沉淀

AI 洞察与综述

从所有聊天里提炼技术、哲理、学业上有价值的内容,按人物 / 群组归类;再自动写成顶级富文本主题总结,把多年散落的思想沉淀成可随时回看的文档。

extract · synthesize
🌙 第四壁 · 气韵

午夜书斋审美

暖调深色、衬线标题、金玉点缀、纸感颗粒——以 frontend-design 能力反复打磨,不是千篇一律的 AI 通用风,而是一座值得深夜独坐的书斋。

frontend-design
杠杆 · HOW

它不是"写"出来的,是"长"出来的

真正的杠杆不在代码,而在几份规范文档。你把它们交给 AI,再说一句话,它便照规格把整套项目建起来——这正是这座书斋自己被造出来的方式。

01
输入

规范文档包

AGENTS · SPEC(12篇) · SKILLS · RUNBOOK

02
一句话

/goal + 咒语

强制 AI 先读文档再动手

03
AI 自动

按 Spec 逐层实现

解密 · 解析 · 归档 · 提炼 · 建站

04
产出

:3456 网站

十三板块开箱即用

📦 "杠杆文档"就在 replication/ 文件夹里

AGENTS.md(项目宪法)· docs/spec/(12 篇详细规格,从数据源到前端)· docs/SKILLS.md(必用能力)· docs/RUNBOOK.md(逐步手册)· docs/PROMPT.md(咒语)。
咒语的核心设计:要求 AI 先逐篇精读全部 Spec 文档,再严格按规格执行——不是"猜着做",而是"照图施工"。

引路 · 面向零基础

从零开始:点亮你的午夜书斋

完全不会写代码?没关系。这份引路假设你是纯粹的新手,从安装工具开始,一步步带你搭好这座私人档案馆。
每一步都有能直接复制的命令小白解释;卡住了就对照检查。

DECRYPTING · 从运行中的进程内存取密钥,只对副本操作
阿青a3f9 7c1e b4d2 88ff 0a6c e5..."那篇论文我放云盘了,记得看 figure 3"
林深9d04 2b7a ff31 6e08 c4a1 1b..."凌晨三点想通了那个递归,附草稿.pdf"
导师群5e88 0fa3 d619 4c2b 7e90 aa..."下学期生理学实验排在周四,资料已上传"
自己c102 6b4f 8e2d 19aa 33c7 5f..."先把比赛 demo 跑通,再回头补前端"
0

准备环境:安装 Node.js 和 Claude Code

书斋需要两样基础工具:Node.js(运行网站的引擎)和 Claude Code(AI 编程助手,帮你自动完成一切)。

需要安装的东西

  • Node.js 24+ — 去 nodejs.org 下载 LTS 版本,双击安装,一路"下一步"即可。
  • Claude Code(命令行版) — Anthropic 出品的 AI 编程工具。

小白解释:Node.js 是让你电脑能运行 JavaScript 程序的东西(网站就是 JS 写的)。Claude Code 是一个"住在终端里的 AI 程序员"——你说一句话,它替你写代码、跑命令、建项目。

安装 Claude Code(打开命令提示符或 PowerShell,粘贴下面命令):

terminal
npm install -g @anthropic-ai/claude-code

怎么打开终端? Windows:按 Win + R,输入 powershell,回车。macOS:按 Cmd + 空格,搜 "Terminal",回车。

1

安装「凯杰」开源的 skills 技能包

这座书斋的"超能力"——多 agent 并行、frontend-design 审美、Workflow 编排——来自一套开源 skills 技能包。先把它装进 Claude Code,AI 才会用那些高级能力。

📘 安装教程(必看)

「凯杰」已经整理了一份完整的 Claude Code 安装 + Skills 安装配置图文教程,从零开始照着做即可:

📎 凯杰 · Claude Code + Skills 安装配置教程(飞书文档)→

小白解释:「skills / 技能包」就像给 AI 装的"增强插件"。装好后 AI 编程时会自动调用这些能力——让前端设计更漂亮、大规模数据处理更稳。不装也能跑,但效果会差不少。

如果飞书教程里的 skills 安装命令没正常工作,可手动安装:

terminal — 安装 skills
npx skills add anthropic/superpowers   # 安装 superpowers 技能包
2

新建一个文件夹,放入规范文件

在电脑上建一个空文件夹(如 D:\ChatFiles),把本项目 replication/ 里的文档复制进去。AI 会读它们当"施工图纸"。

你的新文件夹结构
D:\ChatFiles\
└─ replication\
   ├─ AGENTS.md          # 项目宪法(AI 必读)
   ├─ README.md          # 导航目录
   ├─ global.css         # 设计基座
   └─ docs\
      ├─ PROMPT.md       # ← 待会儿复制里面的"咒语"
      ├─ RUNBOOK.md      # 逐步执行手册
      ├─ SKILLS.md       # 用到的 AI 能力说明
      └─ spec\           # ← 完整技术规格,AI 照这建

小白解释:这几份 .md 文件就是"蓝图"。AI 会读完它们,自动按规格把整个项目从头建起来。你不需要读懂它们——交给 AI 就行。

怎么建文件夹? 打开"文件资源管理器" → 导航到想放的位置(比如 D 盘根目录)→ 右键空白处 → 新建文件夹 → 命名为 ChatFiles。然后把下载好的 replication 文件夹整个拖进去。

3

打开 Claude Code,进入项目文件夹

打开终端,输入 claude 启动 Claude Code,让它"进入"你建的文件夹。

terminal — 启动 Claude Code
cd D:\ChatFiles     # 进入你的项目文件夹
claude               # 启动 Claude Code

小白解释:cd = "change directory / 切换目录"。意思是告诉电脑"我要在这个文件夹里工作"。
怎么拿路径?文件资源管理器打开文件夹 → 点顶部地址栏 → 全选复制 → 粘贴到 cd 后面。

第一次用 Claude Code?

它会提示你登录 Anthropic 账号(需要绑定付费方式)。按屏幕提示完成即可。进入后看到输入框——你在这里"说话",AI 就替你写代码和执行命令。

4

确保微信保持登录运行

在发送咒语之前,必须确认微信(和/或 QQ)正在运行且已登录。因为解密密钥要从正在运行的进程内存中提取。

⚠️ 安全须知(跑之前必读)

  • 微信必须保持打开并登录——全程别退出,密钥在进程内存里。
  • 绝不删除/移动/改写任何原始聊天记录与文件——只对副本操作。
  • 只解密你自己的本地数据,不上传任何内容到外部。
  • 如果微信数据被你迁移过(从 C 盘到 D 盘),AI 会自动全盘搜索找到真实位置。
5

/goal + 咒语,一键启动

复制 下方的咒语(把 {{占位符}} 换成你自己的值),在 Claude Code 输入框里输入 /goal 后粘贴整段,回车发送。

claude code — 输入框
/goal <在这里粘贴下方"咒语"整段,记得把 {{占位符}} 改成自己的>

需要替换的占位符:
· {{项目目录}} → 你刚才建的文件夹路径,如 D:\ChatFiles
· {{你的身份}} → 你是谁,如 "华科基医强基 2501"
· {{一级分类}} → 你想怎么分类文件,如 "学业/工作/生活/项目"

小白解释:/goal 是 Claude Code 的"大任务模式"指令——告诉 AI "接下来是一个大工程,请自主完成"。AI 会自己规划、写代码、跑命令,你坐着看就行。

6

选模型、备好额度,等它跑完

这是个大工程(解密 + 解析数十万条消息 + 几百个 agent 并行提炼 + 建站),需要较强模型。两种主流方案:

Claude Code

推荐
≈ $200
额度(按用量计费)
  • 开启 Opus 4.8 · XHigh 推理
  • 多 agent 编排最稳、质量最高
  • 一次 /goal 基本能跑通全流程

Codex / Cursor

≈ 8–12h
约 ChatGPT Pro 3 个 5h 额度
  • 新建项目,再用 /goal 指令
  • 耗时更长,适合已有 Pro/团队额度
  • 跑完后同样得到 :3456 网站

小白解释:「XHigh / 高推理」= 让 AI 思考更久、答案更精准,但消耗更多额度。这个项目包含解密、归档、AI 提炼等复杂步骤,值得用最高档

⏱️ 预计等多久?

取决于你的聊天数据量。实测 73 万条消息 + 5900 个文件的规模,Claude Code XHigh 大约 2–4 小时。期间你可以做别的事,AI 自主运行。中途断开可用 /resume 继续。

7

启动网站,开始浏览你的第二大脑

AI 跑完后,文件夹里已有完整代码和处理好的数据。执行一条命令即可启动:

terminal
npm run dev   # 启动 → ChatFiles running at http://127.0.0.1:3456

浏览器打开 http://127.0.0.1:3456,十三个板块开箱即用。

🎉 完成后你会看到

概览 — 统计仪表盘,一眼看到会话数、消息总量、归档文件数
聊天 — 按人物/群组浏览全部解密后的微信聊天,支持全文搜索
文件 — VS Code 风格文件树 + 全格式内部预览(图片/视频/文档/代码…)
洞察 — AI 从聊天中提炼出的有价值内容,按主题分类
学业 / 媒体 / 知识 / AI… — 以及更多专题板块

常见问题

Q: AI 跑到一半报错了怎么办?

大多数情况下输入 /resume 即可从断点继续。如果是环境问题(Node 版本不够/微信没登录),修复后重新 /goal 粘贴咒语。

Q: 我的微信数据被迁移到了 D 盘,AI 能找到吗?

能。AI 会自动全盘搜索 xwechat_files 目录——这正是规范文档里规定的第一步("戳穿迁移陷阱")。不需要你手动指定路径。

Q: QQ 聊天记录能解密吗?

QQ 的附件(图片/视频/文件)可以正常归档(明文)。但 QQ 聊天正文加密格式更特殊,目前属于"已知边界"——如实记录,不绕过。

Q: 数据会上传到外部吗?

绝对不会。全部处理在本地完成。唯一可能的网络请求是你自己配置的 AI 接入(用来提炼洞察),且密钥只存浏览器内存,不写入磁盘。

Q: 不想用 Claude Code,能用其他 AI 吗?

可以,规范文档本身是通用的。Cursor、Codex、Windsurf 等支持 agent 模式的工具都能用。只是 Claude Code + skills 技能包的组合效果最好、测试最充分。

咒语 · 第 5 步要粘贴的内容

复刻咒语

{{占位符}} 换成你自己的值,整段复制,用 /goal 发送。
这段咒语的核心设计:强制 AI 先精读全部规范文档再动手,确保严格按 Spec 执行。
完整版与分阶段版见 replication/docs/PROMPT.md

replication / docs / PROMPT.md — Mega-Prompt
ultracode 我要复刻「午夜书斋 / ChatFiles」——一个纯本地的"第二大脑"网站,深度系统地把我自己微信(和 QQ)里的全部聊天记录与有价值文件解密、整理出来。项目目录在 "{{项目目录}}"。

【最重要 · 你必须先做这一步】
在动手之前,你 MUST 逐篇精读本项目的规范文档包,并严格遵照执行:
1. 先读 replication/AGENTS.md(项目宪法 — 安全红线、架构规范、工作流、必用 skills)
2. 再读 replication/docs/SKILLS.md(用到的能力 — ultracode/frontend-design/Workflow 编排等)
3. 然后逐篇读 replication/docs/spec/ 下的全部规格文档(共 12 篇):
   - 00_overview.md — 总览、板块定义、成功标准
   - 01_architecture.md — 七层架构、完整文件树、≤300行规范
   - 02_data-sources.md — 数据在哪、迁移陷阱、枚举方法
   - 03_decryption.md — 解密方法(派生密钥内存扫描)
   - 04_parsing.md — 解析进 wechat.db 三表
   - 05_archiving.md — 归档文件(去重、分类、只复制)
   - 06_insights.md — AI 提炼(多 agent 扇出)
   - 07_server-api.md — 服务端 API
   - 08_frontend.md — 前端设计系统与板块
   - 09_ai-assistant.md — AI 助手接入
   - 10_data-products-and-boundaries.md — 产出物与已知边界
   - 11_conventions.md — 代码/命名/提交约定
4. 辅助:replication/docs/RUNBOOK.md(逐步手册)

你在实现每一个环节时,MUST 回到对应的 spec 文档核对细节。不可凭记忆或猜测。

【目标】
React + TypeScript + Express,端口 3456,实现 Spec 定义的全部 13 板块:
- 成果组:概览 · 聊天 · 文件 · 洞察 · 学业 · 媒体
- 配置组:总结 · 线索 · 聊天整理 · 数据库 · 候选 · 知识 · AI

核心能力(详见各 spec):
1. 文件板块 → 见 05_archiving.md(一级分类如 {{一级分类}})
2. 聊天板块 → 见 03_decryption.md + 04_parsing.md
3. 洞察板块 → 见 06_insights.md(多 agent 扇出)
4. AI 助手 → 见 09_ai-assistant.md
5. 前端体验 → 见 08_frontend.md(懒加载/独立滚动/导航分组)

我的身份:{{身份,如 华科基医强基 2501}}
学业站点:{{学业站点,没有可删}}

【硬约束 · 全部来自 AGENTS.md,一字不差遵守】
- 禁止删除/移动/改写原始文件;只读原始、只对副本解密、只复制归档。不上传。
- 审美 MUST 结合 frontend-design skill,锚定「午夜书斋」设计系统。
- 架构 MUST 遵守 AGENTS.md §4(≤300 行、一文件一职责、设计令牌集中…)。
- 遵守 PADC 工作流,每完成一阶段 commit。边界如实记录。

【执行方式】
先深度勘探现状,把关键发现告诉我。遇决策点用 AskUserQuestion 问我。大规模提炼用 ultracode 多 agent 扇出。全程严格参照 spec 文档执行。
典籍 · 深入

规范文档全集

这些就是 AI 严格参照的"施工图纸"。想看懂每个细节、或手动复刻,点开对应篇章。

核心文档

Spec 规格文档(12 篇)

安全红线

  • 只解密你自己的、你拥有的本地数据——个人数据归档用途,勿用于他人 / 未授权设备。
  • 绝不删除、移动、改写原始聊天记录与文件;只对副本操作。
  • 不上传:全部在本地完成,数据库与密钥不出本机。
  • 解不了的边界(如 QQ 正文)如实记录,不绕过任何安全限制。