故障排查
小部件一直显示「正在分析当前客户」
Section titled “小部件一直显示「正在分析当前客户」”这通常表示页面已经提交了操作,但后端程序没有在运行或没有消费请求。
按顺序检查:
- 终端里的
python3 main.py是否仍在运行; - 是否提示「尚未登录」;
- 是否连接到了正确的 Chrome 调试端口。
如果未登录:
python3 main.py --loginpython3 main.py新版小部件如果 15 秒内没有收到后端响应,会直接提示后端没有响应。
小部件没有出现
Section titled “小部件没有出现”- 确认已经运行
python3 main.py,且终端没有报错; - 刷新目标页面;
- 确认页面域名在
channel.widget_hosts中; - 如果页面在登录跳转中,完成登录后会自动重新注入。
提示「未检测到打开的客户」
Section titled “提示「未检测到打开的客户」”先在左侧点开一个客户会话,再点「分析当前客户」。程序需要当前会话才能读取消息。
读取不到会话消息
Section titled “读取不到会话消息”- 确认消息区已经加载完成;
- 切换一次会话再切回来;
- 检查页面是否改版导致选择器失效;
- 查看终端日志中的具体错误。
无法定位输入框或发送按钮
Section titled “无法定位输入框或发送按钮”页面结构可能已经变化。可以尝试:
- 刷新页面;
- 在
config.yaml中覆盖对应平台的 selectors; - 升级到最新公开构建。
Zoho 回复框没有打开
Section titled “Zoho 回复框没有打开”先手动点一次「回复」按钮,确认回复编辑器出现,再点「插入回复」。 如果仍然失败,检查页面是否处于草稿或独立 compose 视图。
Chrome 连接失败
Section titled “Chrome 连接失败”- 确认 Google Chrome 已安装,路径与
config.yaml一致; - 确认调试端口没有被其他程序占用;
- 关闭残留 Chrome 进程后重启程序;
- 查看终端是否出现
ECONNREFUSED或Target page, context or browser has been closed。
运行:
python3 main.py --license-status常见原因:
- 未登录;
- 授权过期;
- 设备被解绑;
- 管理员禁用账号。
提交问题前建议准备
Section titled “提交问题前建议准备”- 终端最后 50 行日志;
- 出问题的平台和页面;
- 是否开启自动接待或自动发送;
- 最近是否升级过客户端或浏览器。