# wechat-auto-reply

**Repository Path**: hippoDocker/wechat-auto-reply

## Basic Information

- **Project Name**: wechat-auto-reply
- **Description**: 本地微信自动回复程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-16
- **Last Updated**: 2026-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微信自动回复（本地版，MCP + 图形化客户端）

这是一个 **Windows 本地运行** 的微信自动回复系统，支持：

- 指定联系人监听与自动回复（按联系人单独配置）
- 每个联系人独立系统提示词、记忆条数、冷却时间
- OpenAI 兼容大模型接口（自动补全 `/chat/completions`）
- MCP Server 能力暴露（供 AI 应用调用）
- 图形化客户端（本地 Web UI）统一管理配置与状态
- 真实微信模式（UIA4）与 mock 模式双通道

## 项目结构

- `src/wechat_local_mcp/`：核心代码
- `src/wechat_local_mcp/ui.py`：前端页面模板
- `src/wechat_local_mcp/api.py`：HTTP API
- `src/wechat_local_mcp/service.py`：自动回复主流程
- `src/wechat_local_mcp/wechat_adapter.py`：微信适配层（mock / wxauto / uia4）
- `desktop_entry.py`：EXE 启动入口（UI / MCP）
- `build-exe.ps1`：单文件 EXE 打包脚本

## 核心功能

### 1) 联系人规则

- 按联系人配置 `enabled / auto_reply_enabled / memory_enabled`
- 配置 `memory_message_limit`、`bootstrap_history_limit`
- 首次自动回复前可抓取最近 N 条历史消息作为上下文

### 2) 自动回复链路

- 监听到入站消息后写入本地 SQLite
- 按联系人规则拼接系统提示词 + 历史对话
- 调用大模型生成回复并发送
- 支持回复延迟与冷却时间，避免刷屏

### 3) 真实微信模式（UIA4）

- 自动检测微信进程、窗口、登录状态
- 可自动拉起微信窗口并前置
- 联系人切换采用严格匹配，避免误命中“搜一搜/网络结果”

### 4) MCP 能力

- 联系人规则管理
- 消息发送
- 运行状态查询
- 与本地 UI 共享同一套配置与数据

## 运行方式

### 1) 安装依赖

```powershell
python -m pip install -e .
```

### 2) 启动本地 UI/API

```powershell
python -m wechat_local_mcp.main --mode api --host 127.0.0.1 --port 8787
```

访问：`http://127.0.0.1:8787`

### 3) 启动 MCP

```powershell
python -m wechat_local_mcp.main --mode mcp
```

## 打包 EXE

```powershell
.\build-exe.ps1
```

输出：`dist/WeChatLocalMCP.exe`

## 数据与日志

- 数据库：`%USERPROFILE%\.wechat-local-mcp\data\app.db`
- 日志：`%USERPROFILE%\.wechat-local-mcp\logs\app.log`

## 注意事项

- 本项目仅建议在你可控环境中使用，避免对不知情联系人进行自动化回复。
- 真实发送联调建议先用“文件传输助手”验证再扩展到真实联系人。