适用版本：v1.3.0 ｜ 售后微信：17800105531 本手册面向零基础用户：每一步都写了「怎么做 → 预期看到什么 → 没看到怎么办」。 请从第一章开始按顺序做，不要跳步。
操作：从官网下载 wx-Assistant-Setup.exe（文件名带版本号，如 wx-Assistant-Setup-1.3.0.exe）。
预期看到：浏览器下载完成，得到一个约 30 MB 的安装程序文件。
没看到怎么办：下载被浏览器拦截 → 选「保留」；杀毒软件提示 → 选「允许」（本软件为正规安装程序，带数字签名信息）。
操作：双击 wx-Assistant-Setup-1.3.0.exe。Windows 弹出权限确认时点「是」（安装需要管理员权限）。
预期看到：安装向导（中文界面）→ 一路点「下一步」→ 「安装」→ 「完成」。安装位置默认即可，无需改动。
没看到怎么办：向导提示「wx-Assistant 已安装」→ 这是升级安装，直接继续即可，原有配置与授权全部保留；双击无反应 → 右键文件选「以管理员身份运行」。
操作：安装完成后桌面会出现 wx-Assistant 图标，双击它（安装向导最后一步勾了「立即启动」的话已自动启动，跳过此步）。
预期看到： - 屏幕右下角托盘区出现一个绿色圆点图标（运行中）； - 浏览器自动打开管理控制台页面； - 第一次启动时程序自动生成配置文件（内部 token 随机生成），并自动为这台电脑领取 7 天全功能试用，无需注册。
没看到怎么办： - 托盘没有图标 → 看任务栏右下角有没有被折叠（点小箭头展开）； - 提示「wx-Assistant 已在运行」→ 说明已经有一套在跑，程序已帮你打开了它的管理页面（或见右下角托盘图标），无需重复启动； - 仍不行 → 截图发售后微信。
操作：浏览器自动打开的控制台页面上有首启向导（三步：填密钥 → 选人设 → 试跑）。在第一步粘贴你的 DeepSeek API Key（一串以 sk- 开头的字母数字），点保存。
（DeepSeek 密钥在 https://platform.deepseek.com 注册后创建；其它兼容 OpenAI 接口的服务商在「设置」页改地址与模型名即可。）
预期看到：「api_key 已保存，连通正常 ✅」。
没看到怎么办：提示「已保存，但连通失败」→ 核对密钥前后无多余空格、服务商后台确认余额，在「设置」页重新保存再试。
新机器第一次启动时，程序会自动为这台电脑领取 7 天全功能试用授权，不需要你做任何操作。
预期看到：「激活 / 续费」页显示「试用版，剩 N 天」。
注意：试用每台电脑只发一次。重装系统或重装软件后再领，会提示「该机器码已使用过试用」（错误码 409）——这是正常防护，不是故障。如果这台电脑买过正式授权，程序会自动检测并恢复历史授权，无需联系客服。
操作：控制台「激活 / 续费」页 → 选套餐点「扫码支付」→ 浏览器弹出收款页 → 微信扫码付款 → 付款成功后回到控制台等一分钟，授权自动生效（无需重启软件）。
预期看到：付款后约 1 分钟内，「激活 / 续费」页与体检「授权」项显示新套餐和新的到期日。
没看到怎么办：超过 2 分钟未生效 → 托盘右键「停止全部」后重新双击桌面图标（会重新拉取授权）；仍未生效 → 把订单截图发售后微信，人工补发。
| 套餐 | 价格 | 说明 |
|---|---|---|
| 个人版 | ¥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% 抵扣首年合同款。
到期后机器人会拒绝启动并在控制台明示，续费即可恢复，已产生的配置和数据不受影响。
托盘圆点图标是日常控制中心，右键弹出菜单：
| 菜单 | 作用 |
|---|---|
| 打开控制台 | 浏览器打开管理页（体检/启停/设置/客户/人设·知识库） |
| 暂停机器人 | 机器人停止自动回复（不动微信窗口，配置全保留）；图标变黄色 |
| 恢复机器人 | 取消暂停，恢复自动接待；图标变回绿色 |
| 停止全部 | 停掉机器人后台进程（微信不受影响）；图标变红色 |
| 退出 | 停止全部并退出主程序 |
红线：第一次试跑必须用小号（另一个微信号），不要用主力号。
操作：托盘右键「停止全部」；用记事本打开安装目录下的 config.yaml（默认在 C:\Program Files\wx-Assistant\；保存时若 Windows 提示权限，点「是」即可），把 demo_mode: false 改为 demo_mode: true 保存；再双击桌面图标启动。
预期看到：托盘变绿（启动成功）。
操作：启动后微信弹二维码 → 小号扫码；然后用另一个号（或文件传输助手）给小号发一条消息，如「在吗」「你们几点上班」。
预期看到：控制台「日志」页能看到：收到消息 → 命中知识库/AI → 生成回复（演示模式下只记录不真发）。
没看到怎么办：没任何反应 → 确认消息发给了登录的那个微信；控制台亮「转人工提醒」→ 你发的词命中了转人工关键词（如"人工"），换个词试。
操作：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 次会暂停并亮红（防止异常刷屏），人工排查后点「重置看门狗」 |
send_interval_sec 是账号安全底线，调小会显著增加风控风险。普通用户请用安装向导（第二章），无需读本附录。绿色版给无法运行安装程序的环境备用。
wx-Assistant-v1.3.0.zip，解压到任意目录（如 D:\wx-Assistant\）；wx-Assistant.exe（exe 和旁边的文件夹是一套，不要单独拖走 exe）；绿色版与安装版不要同时运行（同一台电脑只跑一套）；从绿色版换安装版（或反过来）前，先在托盘右键「退出」。
exe 形态日常操作全部走托盘菜单与控制台。config.yaml 常用段速查（改完托盘「停止全部」再启动生效）：
| 配置项 | 作用 |
|---|---|
llm.api_key |
大模型密钥（优先用控制台设置页改） |
agent.demo_mode |
演示模式（true 只记录不真发） |
agent.whitelist / blacklist |
接待范围 |
gate.send_interval_sec |
发送间隔（≥5 勿调小） |
端口无需手动配置：软件启动时自动选择可用通道，与电脑上其它程序互不打扰。
| # | 现象 | 原因 | 解决 |
|---|---|---|---|
| 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 ｜ 附：升级抵扣、退款条款详见《客户使用协议》
售后微信：17800105531 ｜ wx-Assistant v1.3.0