sufeng

🌟 赛博女友 (Cyber Girlfriend)

微信 AI “赛博女友”聊天机器人 — 上传聊天记录，创建专属 AI 人格，在微信上像真人一样聊天。

📸 效果预览

微信上的她:
┌──────────────────────────┐
│ 小美 💕                   │
│                          │
│ 你: 今天好累啊            │
│ 她: 呜呜辛苦啦🥺           │
│     快回家我给你点了奶茶！  │
│ 你: 周末去哪玩            │
│ 她: 我想去新开的猫咖!!     │
│     你必须陪我去🐱         │
└──────────────────────────┘

管理后台 (浏览器打开):
┌──────────────────────────┐
│ 🌟 赛博女友 管理后台      │
│ [📊仪表盘] [👤人设] [💬监控] [⚙️设置] │
│                          │
│ 活跃人设: 小美 ✨         │
│ 今日消息: 42              │
│ 活跃对话: 3               │
└──────────────────────────┘

🏗️ 项目结构

cyber-girlfriend/
├── backend/               # Python 后端 (FastAPI)
│   ├── models/            # OOP 领域模型
│   ├── services/          # 业务逻辑 (人格引擎)
│   ├── repositories/      # 数据存取
│   └── routers/           # API 路由
├── web/                   # 前端页面
├── chatgpt-on-wechat/     # 微信接入框架
│   └── plugins/cyber_girlfriend/  # 自定义插件
├── data/                  # 数据目录
├── start.bat              # 一键启动
└── README.md

🚀 快速开始

1. 环境要求

2. 安装

# 进入项目目录
cd cyber-girlfriend

# 安装 Python 依赖
pip install -r requirements.txt

# Clone chatgpt-on-wechat
git clone https://github.com/zhayujie/chatgpt-on-wechat.git
cd chatgpt-on-wechat
pip install -r requirements.txt
cd ..

3. 配置

在管理后台「设置」页面配置 DeepSeek API Key，或设置环境变量：

set DEEPSEEK_API_KEY=sk-your-api-key-here

4. 启动

# 方式1: 双击 start.bat
start.bat

# 方式2: 命令行启动
cd backend
python main.py

打开浏览器访问 http://localhost:8888 进入管理后台。

📖 使用教程

Step 1: 导出聊天记录

使用 PyWxDump 导出微信聊天记录：

  1. 下载 PyWxDump
  2. 打开微信 PC 版 (3.9.x)
  3. 运行 PyWxDump，选择目标联系人
  4. 导出为 CSV 格式

Step 2: 创建 AI 人设

  1. 打开管理后台 → 「人设管理」标签
  2. 点击「从聊天记录创建」
  3. 上传刚导出的 CSV 文件
  4. 输入她的名字（要和聊天记录中显示的一致）
  5. 点击「分析并创建人设」
  6. AI 会自动分析她的说话风格，生成 System Prompt
  7. 检查生成的人设，可以手动调整

Step 3: 启动微信 AI 回复

  1. 确保微信 PC 已登录
  2. 在 chatgpt-on-wechat 目录下配置 config.json
  3. 启动 chatgpt-on-wechat
  4. 用另一个微信给你的机器人发消息
  5. 她就会用人设的风格自动回复！

Step 4: 实时监控

在管理后台的「对话监控」标签页，可以实时看到所有对话。

🎭 人格克隆原理

聊天记录 → 解析清洗 → AI风格分析 → 5层System Prompt → LLM生成回复

5 层 System Prompt 结构：

  1. 身份层：她是谁，和用户什么关系
  2. 人格层：OCEAN 大五人格评分
  3. 风格层：口头禅、表情偏好、回复长度
  4. 示例层：10 条真实对话作为 Few-Shot 参考
  5. 约束层：行为规则（不承认是 AI、保持角色等）

🧩 OOP 设计模式

模式 应用
策略模式 LLM 适配器（切换模型不改代码）
仓库模式 数据存取（换数据库不影响业务）
观察者模式 WebSocket 实时推送
工厂模式 从聊天记录创建 Persona

⚠️ 重要提醒

  1. 封号风险：使用非官方微信自动化有封号风险，强烈建议用小号测试
  2. 版本锁定：微信必须是 3.9.11.25，关闭自动更新
  3. 隐私合规：使用他人聊天记录需对方知情同意
  4. 仅 Windows：基于 Windows 微信 PC 客户端

📚 参考项目

🆘 常见问题

Q: 启动后访问不了管理后台？ A: 检查是否在 backend/ 目录下运行，端口 8888 是否被占用。

Q: 上传聊天记录后找不到目标人物？ A: 检查「聊天记录中的名字」是否和 CSV 文件里显示的名字完全一致。

Q: chatgpt-on-wechat 启动失败？ A: 确认微信版本是 3.9.11.25，且微信 PC 端已登录。

Q: AI 回复不像本人？ A: 在管理后台编辑 System Prompt，增加更多 Few-Shot 示例（真实的聊天记录片段）。

🤖 Built with Claude Code 仅供学习和个人使用