🔐 密语 CipherTalk

一款现代化的微信聊天记录查看与分析工具

在线说明文档

功能特性 • 快速开始 • 技术栈 • 贡献指南 • 许可证

开发者愿景

这不是一个只会读取聊天记录的工具。

我希望它能替人留住爱，提取证据，也守住每个人自己的数字人生。

1. 为思念留下可以触摸的温度

当亲人离世后，曾经的点点滴滴往往都留在逝者的手机里，手机也成了继续思念的唯一入口。我希望这款软件能把这些记录整理为真正属于家人的 数字资产: 一段反复叮嘱的文字，一条“儿子（闺女），爸（妈）想你了，啥时候回家呀，回来给你做你爱吃的！”的语音，一次平凡却再也无法重来的问候。

正如《寻梦环游记》中那句话所说：死亡不是生命的终点，遗忘才是。 愿技术能替你留住一点声音、一点温度，也留住一点未曾说完的爱。

2. 为不公保留足够有力的证据

当您遭遇不公、不平、不正，甚至被聊天中的恶意、羞辱、威胁反复消耗时，您不该只能忍受。我希望这款软件能帮您从海量记录中快速找出关键证据，把零散对话整理成清晰、完整、可追溯的 事实链，让每一句伤害都有据可查，让每一次压迫都有证可举。

人可以善良，但不该没有反击的凭据。

3. 让聊天记录真正回到用户手中

我也希望这款软件能帮助更多普通人重新掌握自己的 数字人生。聊天记录不该只是被困在某台设备里的碎片，它也可以是记忆的档案、关系的注脚、成长的年轮。

无论是回望过去、整理生活、备份重要信息，还是在关键时刻还原事实、保护自己，这些数据都应该真正属于用户，而不是在设备更换、账号异常或时间流逝中悄然消失。

YouTube 使用教程

💖 赞助支持

如果这个项目对你有帮助，欢迎通过爱发电支持我们的开发工作！

你的支持是我们持续更新的动力 ❤️

🚀 快速开始

📋 环境要求

• Node.js: 22.12.0 或更高版本
• 操作系统: Windows 10/11
• 内存: 建议 4GB 以上

📦 安装依赖

npm install

🔧 开发模式

启动开发服务器（支持热重载）：

npm run dev

📦 构建应用

构建生产版本：

# 构建完整安装包
npm run build

构建产物位于 release/ 目录。

📁 项目结构

密语 CipherTalk/
├── 📂 src/                          # React 前端源码
│   ├── 📂 components/              # 可复用组件
│   │   ├── ai/                     # AI 相关组件
│   │   ├── Sidebar.tsx             # 侧边栏
│   │   ├── TitleBar.tsx            # 标题栏
│   │   ├── ChatBackground.tsx      # 聊天背景
│   │   ├── MessageContent.tsx      # 消息渲染
│   │   ├── ImagePreview.tsx        # 图片预览
│   │   ├── DateRangePicker.tsx     # 日期范围选择
│   │   └── ...                     # 其他公共组件
│   ├── 📂 pages/                   # 页面组件
│   │   ├── ChatPage.tsx            # 聊天页面
│   │   ├── ChatHistoryPage.tsx     # 聊天历史
│   │   ├── AnalyticsPage.tsx       # 数据分析
│   │   ├── GroupAnalyticsPage.tsx  # 群聊分析
│   │   ├── AnnualReportPage.tsx    # 年度报告
│   │   ├── SettingsPage.tsx        # 设置
│   │   ├── DataManagementPage.tsx  # 数据管理
│   │   ├── ExportPage.tsx          # 数据导出
│   │   ├── HomePage.tsx            # 首页/导入
│   │   ├── McpPage.tsx             # MCP 配置
│   │   ├── OpenApiPage.tsx         # HTTP API
│   │   ├── LockScreen.tsx          # 锁屏
│   │   ├── AISummaryWindow.tsx     # AI 摘要窗口
│   │   ├── ActivationPage.tsx      # 激活
│   │   ├── SplashPage.tsx          # 启动页
│   │   └── ...                     # 其他窗口页面
│   ├── 📂 stores/                  # Zustand 状态管理
│   ├── 📂 services/                # 前端 IPC 服务层
│   ├── 📂 types/                   # TypeScript 类型定义
│   ├── 📂 utils/                   # 工具函数
│   ├── 📂 hooks/                   # 自定义 Hooks
│   └── 📂 styles/                  # 全局样式
│
├── 📂 electron/                    # Electron 主进程
│   ├── main.ts                     # 主进程入口
│   ├── preload.ts                  # 预加载脚本
│   ├── mcp.ts                      # MCP 服务入口
│   ├── 📂 main/                    # 主进程核心
│   │   ├── startup.ts              # 启动流程
│   │   ├── context.ts              # 上下文管理
│   │   ├── protocols.ts            # 自定义协议
│   │   ├── 📂 ipc/                 # IPC 处理器
│   │   │   ├── chatHandlers.ts     # 聊天相关
│   │   │   ├── aiHandlers.ts       # AI 相关
│   │   │   ├── dataHandlers.ts     # 数据导入导出
│   │   │   ├── mediaHandlers.ts    # 媒体文件
│   │   │   ├── accountHandlers.ts  # 微信账号
│   │   │   ├── wxKeyHandlers.ts    # 数据库密钥
│   │   │   ├── wcdbHandlers.ts     # WCDB 解密
│   │   │   ├── configHandlers.ts   # 配置
│   │   │   ├── windowHandlers.ts   # 窗口管理
│   │   │   ├── appUpdateHandlers.ts# 更新
│   │   │   ├── authHandlers.ts     # 授权认证
│   │   │   └── ...                 # 其他 IPC
│   │   └── 📂 windows/             # 窗口管理
│   ├── 📂 services/                # 后端核心服务
│   │   ├── 📂 ai/                  # AI 服务
│   │   │   ├── aiService.ts        # AI 服务主入口
│   │   │   ├── aiDatabase.ts       # AI 数据库
│   │   │   ├── sessionQAJobService.ts  # 会话 QA 任务
│   │   │   ├── proxyService.ts     # AI 代理服务
│   │   │   └── 📂 providers/       # 模型供应商
│   │   │       ├── base.ts         # 基础接口
│   │   │       ├── openai.ts       # OpenAI
│   │   │       ├── deepseek.ts     # DeepSeek
│   │   │       ├── gemini.ts       # Gemini
│   │   │       ├── qwen.ts         # 通义千问
│   │   │       ├── doubao.ts       # 豆包
│   │   │       ├── kimi.ts         # Kimi
│   │   │       ├── zhipu.ts        # 智谱
│   │   │       ├── minimax.ts      # MiniMax
│   │   │       ├── tencent.ts      # 腾讯混元
│   │   │       ├── xiaomi.ts       # 小米
│   │   │       ├── xai.ts          # xAI
│   │   │       ├── siliconflow.ts  # SiliconFlow
│   │   │       ├── ollama.ts       # Ollama 本地
│   │   │       └── custom.ts       # 自定义 API
│   │   ├── 📂 ai-agent/            # AI 智能体
│   │   │   ├── 📂 qa/              # 问答引擎
│   │   │   │   ├── sessionQaAgent.ts   # Agent 主执行器
│   │   │   │   ├── agentDecision.ts    # 自主决策逻辑
│   │   │   │   ├── orchestrator.ts     # 编排器
│   │   │   │   ├── nativeTools.ts      # 原生工具
│   │   │   │   ├── evidence.ts         # 证据管理
│   │   │   │   ├── 📂 prompts/         # Agent 提示词
│   │   │   │   │   ├── decision.ts     # 决策 prompt
│   │   │   │   │   └── answer.ts       # 回答 prompt
│   │   │   │   ├── 📂 intent/          # 意图识别
│   │   │   │   ├── 📂 tools/           # 工具函数
│   │   │   │   ├── 📂 data/            # 数据层
│   │   │   │   └── 📂 utils/           # 工具集
│   │   │   └── 📂 analyzer/        # 会话分析器
│   │   │       ├── blockSlicer.ts      # 分块
│   │   │       ├── factExtractor.ts    # 事实提取
│   │   │       ├── evidenceResolver.ts # 证据解析
│   │   │       ├── resultMerger.ts     # 结果合并
│   │   │       ├── summaryRenderer.ts  # 摘要渲染
│   │   │       └── transcriptCache.ts  # 缓存
│   │   ├── 📂 mcp/                 # MCP 服务
│   │   │   ├── server.ts           # MCP 服务器
│   │   │   ├── bootstrap.ts        # 启动引导
│   │   │   ├── dispatcher.ts       # 指令分发
│   │   │   ├── presentation.ts     # 展示层
│   │   │   ├── readService.ts      # 读取服务
│   │   │   ├── proxyService.ts     # 代理服务
│   │   │   ├── runtime.ts          # 运行时
│   │   │   ├── service.ts          # 服务管理
│   │   │   ├── tools.ts            # 工具注册
│   │   │   ├── result.ts           # 结果处理
│   │   │   └── types.ts            # 类型定义
│   │   ├── 📂 memory/              # 记忆系统
│   │   │   ├── memoryBuildService.ts   # 记忆构建
│   │   │   ├── memoryDatabase.ts   # 记忆数据库
│   │   │   ├── memoryProfileService.ts # 用户画像
│   │   │   ├── evidenceService.ts  # 证据服务
│   │   │   └── memorySchema.ts     # 数据模型
│   │   ├── 📂 retrieval/           # 检索系统
│   │   │   ├── retrievalEngine.ts  # 检索引擎
│   │   │   ├── rerankerService.ts  # 重排序
│   │   │   ├── retrievalEvaluator.ts # 评估
│   │   │   ├── retrievalTypes.ts   # 类型定义
│   │   │   └── rrf.ts              # RRF 融合
│   │   ├── 📂 search/              # 搜索服务
│   │   │   ├── chatSearchIndexService.ts # 搜索索引
│   │   │   ├── embeddingModelService.ts  # 嵌入模型
│   │   │   ├── embeddingRuntimeService.ts# 嵌入运行时
│   │   │   ├── onlineEmbeddingService.ts # 在线嵌入
│   │   │   └── ...
│   │   ├── 📂 vector/              # 向量存储
│   │   │   ├── sqliteVec0VectorStore.ts # SQLite 向量
│   │   │   └── vectorStore.ts      # 向量存储接口
│   │   ├── chatService.ts          # 聊天服务
│   │   ├── decryptService.ts       # 解密服务
│   │   ├── database.ts             # 数据库
│   │   ├── exportService.ts        # 导出服务
│   │   ├── cacheService.ts         # 缓存
│   │   ├── skillManagerService.ts  # 技能管理
│   │   ├── mcpClientService.ts     # MCP 客户端
│   │   ├── wasmService.ts          # WASM 运行时
│   │   ├── analyticsService.ts     # 数据分析
│   │   ├── groupAnalyticsService.ts# 群聊分析
│   │   ├── annualReportService.ts  # 年度报告
│   │   ├── voiceTranscribeService.ts # 语音转文字
│   │   ├── videoService.ts         # 视频处理
│   │   ├── snsService.ts           # 朋友圈
│   │   ├── httpApiService.ts       # HTTP API
│   │   ├── config.ts               # 配置管理
│   │   ├── logService.ts           # 日志
│   │   ├── appUpdateService.ts     # 应用更新
│   │   ├── activationService.ts    # 激活管理
│   │   └── ...                     # 其他服务
│   ├── imageSearchWorker.ts        # 图片搜索 Worker
│   ├── sessionQaWorker.ts          # QA Worker
│   ├── sessionMemoryBuildWorker.ts # 记忆构建 Worker
│   ├── sessionVectorIndexWorker.ts # 向量索引 Worker
│   ├── transcribeWorker.ts         # 语音转录 Worker
│   └── 📂 workers/                 # 本地 Worker
│
├── 📂 skills/                      # MCP 技能包
│   └── 📂 ct-mcp-copilot/         # CipherTalk Copilot
│
├── 📂 resources/                   # 原生库依赖
│   ├── 📂 macos/                   # macOS .dylib
│   └── wedecrypt/                  # 解密原生模块
│
├── 📂 public/                      # 静态资源
│   └── wechat-emojis/              # 微信表情
│
├── 📂 scripts/                     # 构建与发布脚本
│
├── 📂 evaluation/                  # 评测
│   └── 📂 retrieval/               # 检索效果评测
│
├── 📂 contexts/                    # Cursor/IDE 上下文
│
├── 📂 .github/                     # GitHub 配置
│   └── 📂 workflows/               # CI/CD 工作流
│
├── package.json
├── electron-builder.yml
└── vite.config.ts

🤝 贡献指南

我们欢迎所有形式的贡献！无论是报告 Bug、提出新功能建议，还是提交代码改进。

📄 许可证

本项目采用 CC BY-NC-SA 4.0 许可证
（知识共享 署名-非商业性使用-相同方式共享 4.0 国际许可协议）

❌ 严格禁止

• 销售本软件或其修改版本
• 用于任何商业服务或产品
• 通过本软件获取商业利益

查看 LICENSE 文件了解完整协议内容。

⚠️ 免责声明

重要提示

• 本项目仅供学习和研究使用
• 请遵守相关法律法规和用户协议
• 使用本项目产生的任何后果由用户自行承担
• 请勿将本项目用于任何非法用途

📞 联系方式

🙏 致谢

感谢所有为开源社区做出贡献的开发者们！

特别感谢：

• WeFlow - 提供了部分功能参考
• 所有贡献者 - 感谢每一位为本项目做出贡献的开发者

📈 Star History

一鲸落，万物生 · 愿每一段对话都被温柔以待 ❤️ by the CipherTalk Team