wxauto

# 微信自动化

通过本地 HTTP 服务操作微信，支持消息收发、监听、好友管理等功能。

## 前置要求

1. **安装 wxautox4**：
   
   ```bash
   pip install wxautox4
   ```
   
   > 注意：需windows系统，python3.9,3.10,3.11,3.12 64位，其他python版本暂不支持
   
2. **激活 wxautox4**：

   ```bash
   wxautox4 -a your-activation-code
   ```

   > 获取：https://docs.wxauto.org/plus

3. **部署 API 服务**：

   - 克隆项目：https://github.com/cluic/wxauto-restful-api
   - 配置 `config.yaml`
   - 启动服务：`python run.py`

## 服务配置

- 认证：Bearer Token（见 `config.yaml` 的 `auth.token`，默认值为 `token`）
- 服务状态文件：`~/.wxautox/service_status.json`（服务启动时自动生成，请查看该文件获取服务信息）

### 自动配置检测

服务启动后会自动将运行信息写入 `~/.wxautox/service_status.json`。wxapi.py 脚本会：
1. 自动读取此文件获取连接配置
2. 验证服务是否真的在运行（通过 API 健康检查）
3. 如果服务未运行，自动启动服务（需要服务目录存在）

服务目录搜索顺序：
- `../wxauto-restful-api`（相对于 skill 目录）
- `~/wxauto-restful-api`
- `WXAPI_SERVICE_DIR` 环境变量指定的路径

### 手动配置方式（可选）

如果需要覆盖自动配置，优先级从高到低：

1. **命令行参数**
   ```powershell
   python wxapi.py --base-url "http://localhost:9000" --token "my-token" send "好友" "消息"
   ```

2. **环境变量**
   
   ```powershell
   $env:WXAPI_BASE_URL = "http://localhost:9000"
   $env:WXAPI_TOKEN = "my-token"
   # 或者
   $env:WXAPI_PORT = "9000"
   $env:WXAPI_SERVICE_DIR = "/path/to/wxauto-restful-api"
   ```

3. **service_status.json** - 自动检测（推荐）

4. **config.yaml** - 服务目录下的配置文件

5. **默认值** - `http://localhost:8000`, token 为 `token`

## 启动服务

首次使用前需要启动服务：

```powershell
# 进入服务目录
cd /path/to/wxauto-restful-api
```

# 启动服务
```
python run.py
```

或后台启动（Windows）：

```powershell
Start-Process python -ArgumentList "run.py" -WorkingDirectory "C:\path\to\wxauto-restful-api" -WindowStyle Hidden
```

如果服务已运行，脚本会自动连接；如果服务未运行且配置了服务目录，脚本会自...