Metadata-Version: 2.4
Name: phone-act-x
Version: 1.3.1
Summary: 微信视频号私信自动回复 — 规则引擎 + 无头浏览器自动化
Author: phone-act
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: headless
Requires-Dist: playwright>=1.40.0; extra == "headless"

# phone-act-x

微信视频号私信自动回复 — 贷款业务场景

## 安装

```bash
pip install phone-act-x
```

无头浏览器模式额外依赖：
```bash
pip install playwright
python -m playwright install chromium
```

## 使用

### 规则引擎

```python
from phone_act import process

result = process("征信不好")
print(result["reply"])  # 您爱人征信怎么样？
```

### 无头浏览器自动化

```python
from phone_act.headless import login, VideoChannelBot

# 首次：扫码登录
login()

# 启动自动回复
bot = VideoChannelBot()
bot.start()
bot.run_forever()  # 每30s检查新私信，自动回复
```

### CLI

```bash
phone-act "征信不好"              # 测试规则匹配
phone-act-headless --login        # 扫码登录
phone-act-headless                # 启动轮询
```

## 对话流

```
客户: "你好"       → bot: "您今年多大了？"
客户: "35"         → bot: "您征信怎么样？"
客户: "征信不太好"  → bot: "您爱人征信怎么样？"
客户: "也没问题"    → bot: "怎么联系你？"
客户: "138xxxx"    → bot: "好的，收到，稍后联系您！" → 停止
```

## 特性

- 同义词归一化（"征信不太好"→"征信不好"）
- 对话流状态机，自动追问到拿号码
- 万能回复模板，随机换问法
- 30s轮询 + 随机抖动防封号
- 手机号检测自动停止
