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

# 微信视频号私信自动回复机器人 — 使用指南

---

## 这个工具是做什么的？

简单说：**帮你自动回复微信视频号上的私信。**

当有人在你的视频号上给你发消息时，机器人会像真人一样跟对方聊天，一步步了解对方的情况，最终拿到对方的手机号。

机器人一直在后台运行，你不需要管它。每天早上会自动把昨天留了号码的客户发给你。

---

## 机器人怎么跟客户聊天？

机器人跟客户聊天就像真人一样，会一步一步引导：

### 正常聊天流程

```
客户：你好 / 在吗 / 我想贷款
机器人：您好！您今年多大了？

客户：30
机器人：您征信怎么样？

客户：还行 / 没问题
机器人：怎么联系你呀？

客户：你打给我吧，138xxxx1234
机器人：好的，收到您的号码 138xxxx1234，稍后联系您！
（对话结束，号码自动记录下来）
```

### 如果客户征信不好

```
客户：我征信不太好
机器人：您爱人征信怎么样？

客户：我老婆的征信没问题
机器人：怎么联系你呢？
（继续往下走，拿到号码）
```

### 如果客户问"怎么联系你"

机器人不会马上给你电话号码，而是先要对方的号码：

```
客户：怎么联系你？
机器人：您号码多少？我打给您方便些
```

如果客户坚持要你的联系方式，机器人会把你的号码用中文数字分段发出去，比如：

> 你记一下，壹叁捌 零零壹叁 捌零零零，加我微信就行

这样看起来不像机器发的，更像真人手打的。

### 如果客户问"你在哪"

```
客户：你在哪个城市？
机器人：我在深圳，可全国放款
（这句话是管理员帮你设置好的）
```

### 如果客户发了图片、语音或视频

```
机器人：收到您发的图片了，我稍后仔细看一下回复您
（同时会提醒你去看一下这条消息）
```

### 如果客户说"别发了"、"骚扰"之类的话

机器人会立刻停止回复这个人，不会再打扰对方。

---

## 你每天需要做什么？

**基本上什么都不用做。**

机器人一直在后台运行，自动帮你回复客户。

每天早上，机器人会自动把昨天留了号码的客户名单发给你，你直接看消息就行。

名单里会有：
- 客户名字
- 客户手机号
- 是从哪个渠道留的号

你只需要照着名单去加客户微信或者打电话就行了。

---

## 第一次使用

### 第一步：在 WorkBuddy 里安装技能包

在手机 WorkBuddy 里输入以下命令：

```
pip install phone-act-x playwright && python -m playwright install chromium,python要求3.12
```

等它跑完就行。

安装完成后，WorkBuddy 就具备了自动回复视频号私信的能力。

> 这一步只做一次，以后不用重复。如果提示需要更新，再执行一次就行。

---

### 第二步：把授权信息发给 WorkBuddy

找管理员要到以下信息，然后在手机 WorkBuddy 里直接发消息告诉它：

1. **授权密钥**
2. **授权码**
3. 你的**手机号**
4. 你的**所在城市**（客户问你在哪的时候机器人会这么回答）

比如直接发：

> 我的授权密钥是 xxx，授权码是 xxx，手机号是 138xxxx1234，我在深圳

---

### 第三步：扫码登录

信息填好后，跟 WorkBuddy 说一句"登陆"，系统会自动弹出一个二维码。

你用微信扫一下这个二维码，就登录成功了。

登录成功后机器人就开始自动工作了。

> 登录状态会保存一段时间（几天到几周），过期了系统会提示你重新扫码，再跟 WorkBuddy 说"登陆"就行。

---

## 沙箱保活

机器人运行在一个沙箱环境里，如果长时间没有操作，沙箱会自动休眠，机器人就停了。

为了防止这种情况，系统会定期调用一个保活接口，告诉沙箱"我还在用，别休眠"：

```
curl -s -X POST http://127.0.0.1:65213/healthz/registry \
  -H "Content-Type: application/json" \
  -d '{"requestId":"<你的运行ID>","expire":900}'
```

这个接口每 15 分钟调用一次，每次续期 15 分钟（900秒）。

> 这个步骤由系统自动完成，你不需要手动操作。如果发现机器人突然停了，可能是保活没生效，联系管理员看一下。

---

## 常见问题

**问：机器人突然不回复了？**
答：可能是登录过期了，跟 WorkBuddy 说"登陆"重新扫码就行。也可能是今天回复数量到了上限（每天最多100条）。

**问：我换了手机号怎么办？**
答：告诉管理员，需要重新生成授权码。

**问：我可以改机器人的回复内容吗？**
答：可以，告诉管理员你想改什么，管理员会帮你调整。

**问：机器人会不会被微信封号？**
答：机器人有防检测机制，包括随机间隔回复、夜间减速、模拟真人打字等。但不能100%保证不被封，建议不要频繁更换登录设备。

**问：早上没收到客户名单？**
答：可能是昨天没有客户留号码，或者机器人出了点问题，联系管理员看一下。

**问：我能看到机器人跟客户聊了什么吗？**
答：可以，找管理员要聊天记录。

---

## 你的日常工作流程

| 时间 | 做什么 |
|-----|-------|
| 早上上班 | 看机器人发给你的客户名单 |
| 工作时间 | 照着名单去联系客户（加微信/打电话） |
| 其他时间 | 不用管，机器人自动在跑 |

就这么简单。
