cyber-ex-resurrection

🫀 复活吧我的赛博前任

导入聊天截图 + 语音文件 → 克隆前任的人格与声音 → 通过微信/QQ/飞书/WhatsApp 复活 TA

---

⚠️ 法律风险提示

使用前请务必阅读：

本工具涉及个人隐私数据处理和 AI 人格克隆，使用不当可能触犯法律：

首次使用必须运行伦理确认：

python3 main.py consent          # 确认伦理条款
python3 main.py consent --show-legal  # 查看完整法律条文

---

📖 这是什么？

一个能让你的「电子前任」复活的 AI 工具。

你只需要准备：

1. 📸 你和 TA 的聊天截图（微信/QQ/短信都行）或导出文件
2. 🎤 TA 的语音消息（微信语音条、录音等）

它能做什么：

• 从截图/导出文件中读懂 TA 的说话风格、口头禅、性格
• 从语音中克隆 TA 的声音
• 让 TA 在微信/QQ/飞书/WhatsApp 上"复活"，像真人一样跟你聊天
• 有记忆：记住聊过的事，越聊越像 TA
• 一键销毁：随时安全删除所有本地数据

---

🖥️ 图形界面（推荐）

# macOS / Linux
./start.sh

# Windows
start.bat

# 或直接
python3 gui_app.py

GUI 功能：

• 📊 仪表盘 — 实时数据总览
• ⚖️ 伦理声明 — 可视化确认流程
• 📸 截图识别 — 多引擎选择 + 图片预览
• 📥 导入记录 — 支持多种格式 + 表格预览
• 🧹 数据清洗 — 选项配置 + 实时预览
• 🧠 人格预览 — 聊天记录 vs 人格模型对比
• 🎤 声音克隆 — 音频试听 + 训练进度
• 🚀 一键部署 — 步骤配置 + 进度追踪
• 🔥 数据销毁 — 扫描预览 + 安全销毁
• 📋 运行日志 — 实时日志 + 级别过滤

---

🚀 快速开始

第一步：安装 Python

Windows 用户：

1. 打开 https://www.python.org/downloads/
2. 点击 "Download Python 3.x.x"
3. 安装时勾选 "Add Python to PATH" ✅

Mac 用户：

brew install python3

第二步：安装依赖

cd skills/cyber-ex-resurrection
pip install -r requirements.txt

# 国内镜像加速
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

第三步：伦理确认（必须）

python3 main.py consent

首次使用会展示伦理声明和法律风险，你需要逐项确认才能继续。

第四步：配置 MIMO API

编辑 config.json，填入 MIMO API Key：

{
  "mimo": {
    "api_key": "sk-你的API-Key",
    "endpoint": "https://api.xiaomimimo.com/v1"
  }
}

获取 API Key：https://platform.xiaomimimo.com → 控制台 → API Keys

---

📸 使用方法

方法一：一键 Pipeline（推荐）

# 从截图开始
python3 main.py pipeline -s data/screenshots/ -v data/voices/

# 或从导出文件开始
python3 main.py pipeline -f data/wechat_export.txt -v data/voices/

# 然后聊天
python3 main.py chat

方法三：一键部署（CLI）

# 从截图到机器人，全自动
python3 deploy.py --input data/screenshots/ --voices data/voices/ --platform wechat

# 从导入文件开始
python3 deploy.py --import-file data/wechat.txt --voices data/voices/

# 仅清洗数据
python3 deploy.py --import-file data/wechat.txt --clean-only

方法四：分步执行

# 1. 提取对话（选择引擎）
python3 main.py ocr -i data/screenshots/ --engine mimo_omni
# 或导入已有记录
python3 main.py import -i data/wechat.txt

# 2. 智能清洗
python3 main.py clean

# 3. 构建人格
python3 main.py persona

# 4. 训练声音
python3 main.py voice -i data/voices/

# 5. 聊天
python3 main.py chat

方法三：启动微信机器人

python3 main.py bot -p wechat

---

🔍 OCR 引擎

python3 main.py ocr -i data/screenshots/ --engine paddleocr
python3 main.py ocr -i data/screenshots/ --engine multi

---

📥 导入格式

支持多种聊天记录格式：

python3 main.py import -i data/wechat.txt
python3 main.py import -i data/chat.csv
python3 main.py import -i data/backup.db
python3 main.py import -i data/chats/   # 整个目录

---

🧹 数据清洗

自动过滤：系统消息、广告、重复内容、无效对话、合并连续消息

python3 main.py clean                    # 默认清洗
python3 main.py clean --no-ads           # 保留广告
python3 main.py clean --keep-emoji-only  # 保留纯表情

---

🔥 一键数据销毁

python3 main.py destroy --scan   # 扫描本地数据（不删除）
python3 main.py destroy          # 安全销毁所有数据

安全流程：文件覆写（零填充）→ 删除，确保不可恢复。

---

🧠 记忆系统

---

💬 支持的平台

---

📁 项目结构

skills/cyber-ex-resurrection/
├── main.py               # 主入口
├── config.json           # 配置文件
├── requirements.txt      # 依赖
├── ethics.py             # ⚖️ 伦理声明 & 同意验证
├── data_destroy.py       # 🔥 一键数据销毁
├── ocr_extract.py        # 截图 OCR（MIMO Omni）
├── ocr_engines.py        # 🔍 多引擎 OCR（Paddle/Easy/MIMO）
├── importers.py          # 📥 多格式导入
├── data_cleaner.py       # 🧹 智能数据清洗
├── chat_parser.py        # 对话解析
├── persona_builder.py    # 人格建模
├── voice_clone.py        # 声音克隆
├── voice_tts.py          # 语音合成
├── chat_engine.py        # 对话引擎
├── memory.py             # 记忆系统
├── pipeline.py           # 统一管线
└── bots/                 # IM 机器人

---

📝 更新日志

v1.2.4 (2026-05-22)

• 🐛 Bug 修复（9项）:
  • memory.py: 修复 Counter import 位置导致的潜在 NameError
  • importers.py: 修复 _normalize_role 过度匹配（"i" 子串命中 Lisa/Kevin 等名字）
  • voice_clone.py: 修复音频格式转换静默失败（pydub 缺失时非 wav 文件被当 wav 用）
  • ocr_engines.py: 修复 asyncio.run() 在已有事件循环中崩溃
  • importers.py: 修复 _import_backup SQL 注入风险（表名/列名白名单校验）
  • persona_builder.py: 修复步骤编号跳跃，改为连续 Step 1-5
  • persona_builder.py: 简化 max_lines 配置为 max_chat_lines（默认 500）
  • voice_tts.py: import hashlib 移到文件顶部
  • chat_engine.py: _call_mimo 增加空列表防御和 system prompt 自动补全

v1.2.3 (2026-05-21)

• 🧠 多维度人格建模：性格特征、价值观、兴趣爱好、说话习惯、情感模式、社交风格六大维度
• 📚 RAG 知识库：聊天记录向量化，TF-IDF + 余弦相似度检索，上下文增强生成
• 💖 情感分析引擎：8 种情绪检测（开心/难过/生气/惊讶/害怕/厌恶/爱/调皮），情感轨迹追踪
• 🗄️ 四层记忆架构：滑动窗口 + 关键事件 + 持久记忆 + 向量记忆(RAG)
• 🎯 用户偏好记忆：自动提取喜欢/不喜欢/习惯/重要日期
• 🔍 语义检索：基于 RAG 的历史对话检索，提升上下文理解
• 🎭 情感化回复：根据检测到的情绪自动调整回复语气

v1.2.0 (2026-05-21)

• 🖥️ 跨平台 GUI：PyQt6 图形界面，支持 Windows/macOS/Linux，暗色主题
• 🚀 一键部署 CLI：deploy.py 命令行全自动，无需手动输入多个命令
• 📊 仪表盘：实时数据统计、快速操作入口、Pipeline 进度追踪
• ⚖️ 可视化伦理确认：GUI 确认流程 + 法律条文展示
• 📸 OCR 预览：多引擎选择、图片预览、结果表格
• 🧠 人格对比预览：聊天记录 vs 人格模型左右分栏对比
• 🎤 声音试听：音频预览播放 + 训练进度可视化
• 🔥 数据销毁增强：扫描预览、选择性/全量销毁、安全覆写
• 📋 日志系统：实时日志流、级别过滤、文件导出、RotatingFileHandler
• ⚡ 启动脚本：start.sh (macOS/Linux) / start.bat (Windows) 一键启动

v1.1.1 (2026-05-21)

• ⚖️ 伦理合规：强制伦理声明、使用前同意确认、法律条文参考
• 🔥 一键数据销毁：安全覆写删除所有本地数据
• 🔍 多引擎 OCR：PaddleOCR + EasyOCR + MIMO Omni
• 📥 多格式导入：txt/csv/html/微信导出/手机备份
• 🧹 智能数据清洗：自动过滤系统消息、广告、重复内容

v1.1.0 (2026-05-21)

• 🧠 人格建模升级：n-gram + few-shot
• 💾 三层记忆架构
• 🔄 Pipeline 一键执行
• 💬 有状态对话引擎

v1.0.0 (2026-05-21)

• 🎉 首次发布

---

👤 作者

AARONCXXX 📧 [email protected]

📄 许可证

MIT License

---

🫀 「如果记忆有声音，那就让 TA 继续说话。」