# kimi-weiChat

**Repository Path**: zhushizhang/kimi-weiChat

## Basic Information

- **Project Name**: kimi-weiChat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kimi WeChat RPA Controller

基于 AI + RPA 技术的电脑端微信自动化控制工具。

## 🎯 核心功能

- 🔍 **搜索用户** - 在微信对话框中搜索指定用户
- 🎯 **定位用户** - 精确定位并选择目标用户
- 📜 **读取聊天记录** - 上下滑动读取历史聊天记录
- 💬 **主动@发送消息** - @用户并发送消息

## 🏗️ 项目架构

```
kimi-weixinChat/
├── src/
│   ├── core/           # 核心控制模块
│   ├── vision/         # 视觉识别模块 (OCR/图像识别)
│   ├── controller/     # RPA 控制模块 (鼠标/键盘)
│   ├── wechat/         # 微信专用操作封装
│   └── utils/          # 工具函数
├── config/             # 配置文件
├── tests/              # 测试用例
├── docs/               # 文档
└── assets/             # 资源文件 (截图模板等)
```

## 🛠️ 技术方案

| 模块 | 技术选型 | 说明 |
|------|----------|------|
| 视觉识别 | PaddleOCR / EasyOCR | 识别微信界面文字 |
| 图像定位 | OpenCV + 模板匹配 | 定位按钮、头像等 |
| RPA 控制 | pyautogui / applescript | 模拟鼠标键盘操作 |
| AI 调度 | 自定义 Agent | 任务分解与决策 |

## 🚀 快速开始

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

# AI Agent 自然语言控制（推荐！）
python demo_agent.py "给张三发消息说晚上好"

# 或进入交互模式
python -m src.main interactive
```

### 🤖 AI Agent 自然语言控制

```bash
# 给好友发消息
python -m src.main agent "给张三发消息说晚上好"

# 在群聊中 @用户
python -m src.main agent "在工作群@李四说收到"

# 查看聊天记录
python -m src.main agent "查看最近10条消息"

# 搜索用户
python -m src.main agent "搜索文件传输助手"
```

## ⚠️ 注意事项

- 仅支持 macOS 系统（使用 AppleScript）
- 需要开启微信桌面端辅助功能权限
- 仅供学习研究使用

## 📋 功能清单

| 功能 | 状态 | 说明 |
|------|------|------|
| 微信窗口激活 | ✅ | AppleScript 控制 |
| 搜索用户 | ✅ | Cmd+F 快捷键 |
| 打开聊天窗口 | ✅ | 方向键+回车选择 |
| 发送文本消息 | ✅ | 剪贴板粘贴 |
| 读取聊天记录 | ✅ | PaddleOCR + 滚动 |
| @用户 | ✅ | 群聊 @功能 |
| @所有人 | ✅ | 群主/管理员权限 |
| **AI Agent** | ✅ | 自然语言控制 |

## 📝 使用文档

- [快速开始](docs/QUICKSTART.md) - 安装和使用指南
- [技术方案](docs/TECHNICAL_DESIGN.md) - 架构设计和技术选型