wx-Assistant 使用手册（v1.3.0）

> 适用版本：v1.3.0 ｜ 售后微信：17800105531

> 本手册面向零基础用户：每一步都写了「怎么做 → 预期看到什么 → 没看到怎么办」。

> 请从第一章开始按顺序做，不要跳步。

---

一、环境准备

1.1 电脑要求

• Windows 10 / 11（64 位）
• 能上网（激活、在线校验与支付时需要）
• 已安装 PC 版微信（从微信官网 weixin.qq.com 下载安装；本软件**不附带、不修改**微信）
• **无需安装 Python**：安装包自带全部运行环境，装完即用

1.2 网络说明

• 首次启动会联网领取 7 天试用授权；日常运行中软件**每 24 小时**自动与授权服务器核对一次授权状态；
• 偶尔断网不影响使用：断网宽限 **72 小时**，期间一切功能照常；连续 72 小时都联不上授权服务器，软件才会暂停并提示联网；
• 授权状态可在控制台「体检」页随时查看（套餐 / 到期日）。

---

二、安装（安装向导，共四步）

第 1 步：下载安装程序

操作：从官网下载 wx-Assistant-Setup.exe（文件名带版本号，如 wx-Assistant-Setup-1.3.0.exe）。

预期看到：浏览器下载完成，得到一个约 30 MB 的安装程序文件。

没看到怎么办：下载被浏览器拦截 → 选「保留」；杀毒软件提示 → 选「允许」（本软件为正规安装程序，带数字签名信息）。

第 2 步：双击安装

操作：双击 wx-Assistant-Setup-1.3.0.exe。Windows 弹出权限确认时点「是」（安装需要管理员权限）。

预期看到：安装向导（中文界面）→ 一路点「下一步」→ 「安装」→ 「完成」。安装位置默认即可，无需改动。

没看到怎么办：向导提示「wx-Assistant 已安装」→ 这是升级安装，直接继续即可，原有配置与授权全部保留；双击无反应 → 右键文件选「以管理员身份运行」。

第 3 步：启动

操作：安装完成后桌面会出现 wx-Assistant 图标，双击它（安装向导最后一步勾了「立即启动」的话已自动启动，跳过此步）。

预期看到：

• 屏幕右下角托盘区出现一个**绿色圆点图标**（运行中）；
• 浏览器自动打开管理控制台页面；
• 第一次启动时程序自动生成配置文件（内部 token 随机生成），并自动为这台电脑领取 **7 天全功能试用**，无需注册。

没看到怎么办：

• 托盘没有图标 → 看任务栏右下角有没有被折叠（点小箭头展开）；
• 提示「wx-Assistant 已在运行」→ 说明已经有一套在跑，程序已帮你打开了它的管理页面（或见右下角托盘图标），无需重复启动；
• 仍不行 → 截图发售后微信。

第 4 步：按首启向导填入 AI 密钥（api_key）

操作：浏览器自动打开的控制台页面上有首启向导（三步：填密钥 → 选人设 → 试跑）。在第一步粘贴你的 DeepSeek API Key（一串以 sk- 开头的字母数字），点保存。

（DeepSeek 密钥在 https://platform.deepseek.com 注册后创建；其它兼容 OpenAI 接口的服务商在「设置」页改地址与模型名即可。）

预期看到：「api_key 已保存，连通正常 ✅」。

没看到怎么办：提示「已保存，但连通失败」→ 核对密钥前后无多余空格、服务商后台确认余额，在「设置」页重新保存再试。

---

三、激活与套餐

3.1 首次启动自动领 7 天试用

新机器第一次启动时，程序会自动为这台电脑领取 7 天全功能试用授权，不需要你做任何操作。

预期看到：「激活 / 续费」页显示「试用版，剩 N 天」。

注意：试用每台电脑只发一次。重装系统或重装软件后再领，会提示「该机器码已使用过试用」（错误码 409）——这是正常防护，不是故障。如果这台电脑买过正式授权，程序会自动检测并恢复历史授权，无需联系客服。

3.2 购买 / 续费（扫码自助）

操作：控制台「激活 / 续费」页 → 选套餐点「扫码支付」→ 浏览器弹出收款页 → 微信扫码付款 → 付款成功后回到控制台等一分钟，授权自动生效（无需重启软件）。

预期看到：付款后约 1 分钟内，「激活 / 续费」页与体检「授权」项显示新套餐和新的到期日。

没看到怎么办：超过 2 分钟未生效 → 托盘右键「停止全部」后重新双击桌面图标（会重新拉取授权）；仍未生效 → 把订单截图发售后微信，人工补发。

3.3 套餐与价格（与官网首页一致）

| 套餐 | 价格 | 说明 |

|------|------|------|

| 个人版 | ¥99/月 ｜ ¥269/季 ｜ ¥899/年 | 1 个接待坐席；知识库 ≤100 条；模板人设；看门狗 |

| 专业版 | ¥299/月 ｜ ¥2,999/年 | 3 个坐席；知识库 ≤1000 条；MCP 对外开放；优先工单 |

> 知识库代建（小微版 ¥1,980/次；企业版 ¥6,000-10,000）与 DSH 企业版（¥9,800/套起，或 ¥1,299/月）为预约制服务：打开官网首页 →「服务预约」区块提交需求 → 24 小时内有人联系你。月付客户 12 个月内升级企业版，已付月费 100% 抵扣首年合同款。

到期后机器人会拒绝启动并在控制台明示，续费即可恢复，已产生的配置和数据不受影响。

---

四、托盘主程序（日常使用入口）

托盘圆点图标是日常控制中心，右键弹出菜单：

| 菜单 | 作用 |

|------|------|

| 打开控制台 | 浏览器打开管理页（体检/启停/设置/客户/人设·知识库） |

| 暂停机器人 | 机器人停止自动回复（不动微信窗口，配置全保留）；图标变黄色 |

| 恢复机器人 | 取消暂停，恢复自动接待；图标变回绿色 |

| 停止全部 | 停掉机器人后台进程（微信不受影响）；图标变红色 |

| 退出 | 停止全部并退出主程序 |

• **绿色** = 运行中；**黄色** = 已暂停；**红色** = 已停止（或机器人进程异常退出，会弹气泡提醒）。
• 机器人崩溃**不会无限自动重启**：控制台的看门狗会拉起意外退出的机器人，连续崩溃 3 次会暂停并亮红，等人工排查。
• 授权异常（作废 / 宽限期用尽）时程序会弹窗并停止机器人，联系列售后核实即可恢复。
• 重复双击桌面图标不会启动第二套：程序会直接帮你打开已运行那套的管理页面（或气泡提示「已在运行」）。这是保护，不是故障。

---

五、试跑三步（第一次接入微信）

> 红线：第一次试跑必须用小号（另一个微信号），不要用主力号。

第 1 步：打开演示模式（只打印不真发）

操作：托盘右键「停止全部」；用记事本打开安装目录下的 config.yaml（默认在 C:\Program Files\wx-Assistant\；保存时若 Windows 提示权限，点「是」即可），把 demo_mode: false 改为 demo_mode: true 保存；再双击桌面图标启动。

预期看到：托盘变绿（启动成功）。

第 2 步：小号扫码登录 + 发测试消息

操作：启动后微信弹二维码 → 小号扫码；然后用另一个号（或文件传输助手）给小号发一条消息，如「在吗」「你们几点上班」。

预期看到：控制台「日志」页能看到：收到消息 → 命中知识库/AI → 生成回复（演示模式下只记录不真发）。

没看到怎么办：没任何反应 → 确认消息发给了登录的那个微信；控制台亮「转人工提醒」→ 你发的词命中了转人工关键词（如"人工"），换个词试。

第 3 步：确认正常后正式启用

操作：config.yaml 改回 demo_mode: false，托盘「停止全部」后重新双击桌面图标。给小号发消息验证真实回复到达。

预期看到：对方微信收到自动回复（默认随机延迟 3~8 秒，属正常拟人节奏）。

没看到怎么办：回复没到达 → 控制台「日志」页看发送记录和错误；提示敏感词拦截 → 你发的词含"转账/付款"等（闸门故意不回这类词，安全设计，见第七章）。

---

六、功能清单（控制台里都有入口）

| 功能 | 在哪 | 说明 |

|------|------|------|

| 自动接待 | 启动后自动运行 | 新客户消息自动回复；回复前随机延迟 3-8 秒（reply_delay_sec 可调） |

| 知识库 | 「人设 · 知识库」页 | kb/faq.yaml 写问答对；kb/docs/ 放 .txt/.md/.docx/.pdf 产品资料。命中知识库的问题优先按资料回答（回复末尾可附来源）；知识库测试窗可直接验证命中率 |

| 人设切换 | 「人设 · 知识库」页 | 内置店小二/个人助理/分身代聊等 5 套模板，一键套用后逐字段改；改完保存即时生效 |

| 敏感词闸门 | config.yaml gate 段 | 含「转账、付款、卡号、密码、验证码」等词的提问故意不自动回复，防止 AI 误答涉钱信息 |

| 转人工 | config.yaml escalate_keywords | 客户提「人工/投诉/退款/经理」等 → 本轮不自动回 + 控制台亮提醒，人工回复后自动让回 |

| 回复分段 | config.yaml agent 段 | 超 150 字自动按句子拆 2-3 段发送，更像真人 |

| 看门狗 | 控制台「启停」页 | 机器人进程意外退出会自动拉起；连续崩溃 3 次会暂停并亮红（防止异常刷屏），人工排查后点「重置看门狗」 |

---

七、安全红线（重要，请完整读一遍）

• **只登小号**：本软件操作的是你扫码登录的那个微信。自动化存在账号风控风险，**不要用主力个人号/公司号**登录测试与运行。
• **发送间隔 ≥5 秒勿调小**：`send_interval_sec` 是账号安全底线，调小会显著增加风控风险。
• **本软件不修改微信、不碰协议**：所有操作均为界面层自动化（模拟真人点击/输入），帐号安全最终取决于使用频率与方式——请保持正常客服频率，勿用于群发/营销刷屏。
• 涉钱信息（转账/付款/卡号/密码/验证码）一律不自动回复，人工确认。
• 数据全部保存在本机（聊天流水/客户资料不上传云端）；请自行做好本机数据备份。
• **同一台电脑只跑一套**：重复双击桌面图标会自动打开已运行那套的管理页面——这是保护，防止两套互相干扰。
• 售后微信：**17800105531**（工单/授权/定制服务）。

---

八、卸载与重装

• **卸载**：Windows「设置 → 应用」里找到 wx-Assistant 点卸载即可。
• **你的数据不会丢**：授权凭证、配置、聊天记录、知识库等用户数据保存在系统用户目录（不受卸载影响）。**重装后授权和配置自动恢复，无需重新购买、无需重新扫码设置**（除微信需重新登录外）。
• **升级**：直接运行新版安装程序覆盖安装即可，配置、授权、数据全部保留。

---

附录 A：绿色版（zip 免安装）用法

> 普通用户请用安装向导（第二章），无需读本附录。绿色版给无法运行安装程序的环境备用。

• 下载 `wx-Assistant-v1.3.0.zip`，解压到任意目录（如 `D:\wx-Assistant\`）；
• 双击其中的 `wx-Assistant.exe`（exe 和旁边的文件夹是一套，不要单独拖走 exe）；
• 其后步骤与安装版相同：托盘图标 → 浏览器自动打开控制台 → 首启向导填密钥。

绿色版与安装版不要同时运行（同一台电脑只跑一套）；从绿色版换安装版（或反过来）前，先在托盘右键「退出」。

附录 B：高级说明

exe 形态日常操作全部走托盘菜单与控制台。config.yaml 常用段速查（改完托盘「停止全部」再启动生效）：

| 配置项 | 作用 |

|--------|------|

| llm.api_key | 大模型密钥（优先用控制台设置页改） |

| agent.demo_mode | 演示模式（true 只记录不真发） |

| agent.whitelist / blacklist | 接待范围 |

| gate.send_interval_sec | 发送间隔（≥5 勿调小） |

> 端口无需手动配置：软件启动时自动选择可用通道，与电脑上其它程序互不打扰。

---

附录 C：常见故障表

| # | 现象 | 原因 | 解决 |

|---|------|------|------|

| 1 | 提示「wx-Assistant 已在运行」 | 已有一套在运行，程序自动打开其管理页面 | 无需处理：已运行实例的托盘图标在右下角，右键可操作；确实要重启就托盘右键「退出」后再双击桌面图标 |

| 2 | 微信掉线 / 回复停了 | PC 微信被登出（手机端踢下线/更新/断网） | 控制台「启停」页重启机器人重新扫码；确认手机微信没把 PC 端挤下线 |

| 3 | 日志报 api_key 401 / 403 | 密钥填错或欠费 | 控制台「设置」页核对 api_key 无多余空格；到服务商后台确认余额 |

| 4 | 提示「授权校验未通过（expired）」 | 套餐到期 | 「激活 / 续费」页扫码续费；付款约 1 分钟自动恢复 |

| 5 | 提示「该机器码已使用过试用（409）」 | 试用每台电脑只发一次 | 正常防护。若买过正式授权会自动恢复；新购请走激活页 |

| 6 | 自己发消息机器人不回 | 你的微信号在白名单/黑名单里 | 白名单（whitelist）=只接待名单内；黑名单（blacklist）=永不回复。config.yaml agent 段调整后托盘「停止全部」再重开 |

| 7 | 群聊消息全不回 | 默认排除群聊（exclude_groups: true） | 设计如此；要接群改为 false（建议先小群试跑） |

| 8 | 托盘图标一直红色 | 机器人进程没起来 | 控制台「体检」页看失败项；微信未登录先登录；缺 api_key 先填 |

| 9 | 弹窗「连续 72 小时未能验证授权」 | 长期断网，宽限期用尽 | 联网后重新双击桌面图标即恢复；本地授权未过期时不受影响 |

| 10 | 支付后授权迟迟不生效 | 轮询未触发或网络慢 | 等满 1 分钟；托盘「停止全部」后重开（会重新拉授权）；仍不行持订单截图找售后 |

| 11 | 控制台体检「微信 UIA」不通过 | 微信版本过新/过旧或没登录 | 登录微信后重新体检；多次失败把微信版本号发售后微信 |

---

*wx-Assistant v1.3.0 ｜ 附：升级抵扣、退款条款详见《客户使用协议》*