赤霄 WhatsApp助手 使用说明

1. 产品简介

赤霄 WhatsApp助手 是一款 Windows 桌面应用，通过 WebView2 前端 + Node.js 桥接进程，同时控制多个 WhatsApp Web 会话，提供批量群发、账号养号、AI 自动回复、中继转发、文本/语音翻译等能力，并内置 20+ 维度的浏览器指纹反检测策略（Stealth Layer）。

2. 系统要求与安装

2.1 系统要求

2.2 安装步骤

1. 从官方发布渠道（GitHub Releases：CrimsonApex-Releases）下载对应架构的安装包：CrimsonApex-1.0.9-win32-Setup.exe（32 位）或 CrimsonApex-1.0.9-win64-Setup.exe（64 位）。
2. 右键以管理员身份运行安装包，按向导完成安装（可勾选创建桌面快捷方式）。
3. 若本机缺少 Node.js 或 WebView2，安装程序会自动静默安装捆绑的运行时，之后自动启动应用。
4. 安装完成后首次启动，进入「未激活」状态 —— 请先完成激活（见第 3 节）。

2.3 数据与卸载

• 运行时数据目录：%APPDATA%\CrimsonApex（账号会话 .data_runtime\acc_{账号ID}\、配置 config.json、知识库目录等）
• WebView2 缓存目录：%LOCALAPPDATA%\CrimsonApex.WebView2
• 卸载时上述两个目录会被一并清理；如需保留账号会话，请先备份。

3. 激活与许可

本软件采用网络激活授权机制：客户端向激活服务器请求授权，服务器签发 Ed25519 签名授权凭证，客户端本地验签后解锁全功能。未激活时所有功能完全锁定（仅可查看界面）。

3.1 激活流程

1. 点击标题栏右侧的 🔑 激活 按钮，打开「许可证激活管理」弹窗，查看当前许可状态。
2. 点击「🔍 查询本机机器码」，把显示的机器码复制发给运营方（激活按机器码绑定）。
3. 运营方在激活服务器核发授权后，客户端联网自动获取并本地验签解锁（也可在弹窗内按运营方指引完成绑定）。
4. 激活成功后标题栏显示「已激活」，全功能解锁。

3.2 许可状态说明

4. 快速上手（5 分钟）

1. 激活：标题栏 🔑 激活 → 提供机器码 → 激活成功后开始使用。
2. 登录第一个账号：点击侧边栏「＋ 登录新号」→ 用手机 WhatsApp 扫描二维码（第 6.1 节）。
3. （可选）配置 AI：⚙ 设置 → AI 引擎 → 填入供应商/模型/API Key → 🧪 测试连接 → 保存（第 11.2 节）。
4. （可选）配置代理：设置 → 代理库添加并测试代理 → 账号卡片「🌐 代理覆盖」绑定（第 11.6 节）。
5. 发起第一条群发：粘贴号码 → 填写文案 → 选择执行账号 → 点击「启动集群群发任务」（第 8 节）。

图 4-1 首次启动界面：左侧「已连通道」为空，点击「＋ 登录新号」开始绑定账号

5. 界面总览

图 5-1 主界面总览（群发任务执行中）

1. ① 标题栏：应用名、版本、⚙ 设置、🔑 激活、最小化/最大化/关闭（关闭时可选择最小化到托盘）。
2. ② 账号侧边栏：「已连通道」账号卡片列表，可展开查看该账号的中继转发与代理覆盖配置。
3. ③ 目标源与话术区：选择发送对象获取源（手动/地图/联系人/全部会话），填写文案，可选 AI 差异化改写。
4. ④ 任务执行报告：每行一个目标号码，实时显示执行账号、注册状态、发送结果；右上角可清空/导出 CSV。
5. ⑤ 日志监视器：进度条 + 实时日志；下方选择执行账号、任务模式（仅验证/发送消息）、启动/停止按钮。

6. 账号管理

6.1 扫码登录新号

1. 点击侧边栏头部「＋ 登录新号」。
2. 弹出扫码窗口：可选「🌐 登录代理」（使用系统网络 / 强制直连 / 代理库条目）——扫码与后续使用必须同一网络出口，若需代理请先选好。
3. 手机打开 WhatsApp → 「设置 → 已关联设备 → 关联设备」→ 扫描屏幕二维码。
4. 扫码成功后弹窗自动关闭，账号卡片出现在侧边栏并开始同步（状态「在线」）。

图 6-1 绑定扫码窗口：二维码由本地渲染，登录代理与后续使用保持同一出口

6.2 账号卡片与操作

每个账号对应一张卡片，点击卡片可选中/展开（绿色高亮 + 展开配置区），卡片显示：

6.3 查看窗口（界面一览）

「🖥 查看窗口」是每个账号的 WhatsApp 会话浏览界面（独立窗口，操作体验与 WhatsApp Web 一致），也是该账号所有 AI 能力的操作入口：

图 6-2 查看窗口：账号会话浏览界面（真实截图）

• 💬 聊天浏览：查看/搜索会话、收发消息与媒体，体验与 WhatsApp Web 一致；
• 🤖 AI 托管面板：窗口右上角进入，按账号配置 AI 接管（开关 / 意图评级 / 关键词过滤 / 专属提示词，详见 7.2）；
• [译] 消息翻译：hover 消息气泡出现 [译] 按钮，文本 / 语音一键翻译（详见 6.4）；
• ⚠ 转人工处理：AI 冻结的对话在此由人工接管回复。

6.4 查看窗口：消息翻译（文本 / 语音）

在「🖥 查看窗口」的聊天界面中，hover 收到的消息气泡会出现 [译] 按钮，一键完成翻译，支持跨语言客服场景：

图 6-3 查看窗口消息翻译（真实截图）：hover 消息气泡出现 [译]，点击出译文；语音消息可「发译文」或「语音发译文」

• 文本消息：点击 [译]，气泡内直接显示目标语言译文。翻译由全局 AI 引擎完成（temp=0 确定性输出，译文走独立缓存与熔断统计，不影响 AI 回复链路）；消息疑似已是目标语言时自动跳过，不消耗 API；相同文本只翻译一次（LRU 缓存）。
• 语音消息：点击 [译]，自动完成「语音转写（STT）→ 翻译」，可选择 「发译文」（以文本回复对方）或 「语音发译文」（用 edge-tts 免费合成目标语言语音后发出）；同一条语音只转写一次（有缓存），超长语音（默认 ≥600s）自动拒绝不消耗 API，转写任务全局串行排队。
• 发送侧：查看窗口输入条支持把拟发送的内容翻译成目标语言后再发送（可带语音合成），让回复始终与对方语言对齐。
• 配置入口：翻译开关与目标语言 → ⚙ 设置 → AI 引擎（「查看窗口消息翻译」「翻译目标语言」，默认中文）；语音转写 → ⚙ 设置 → 语音翻译（STT 提供商 / 模型 / Key / 端点，Key 独立于 AI Key）。

7. 三种工作模式

每个账号在任何时刻只能处于一种模式：养号（主动）、AI 自动回复（被动）、中继（被动）。三种模式互斥——启用一种会自动禁用其他模式（前端与后端双重实施）。

7.1 养号 Farming（主动模式）

一句话回答「开启养号之后到底在做什么」：不是不间断互聊，而是按"轮"间歇运行、刻意不规律的自动化行为循环——每轮从互聊（60%）/ 改状态（15%）/ 读消息（15%）/ 看联系人（10%）中给每个账号随机分配一个行为，模拟真实活跃用户。只要 ≥2 个账号在线、没有群发任务在跑，程序会无限循环地跑下去（机器 24 小时开着就一直有动作），但每个账号并非每轮都在发消息。

一轮养号的完整流程

1. 等待：轮与轮之间随机等待 配置间隔 × 50%~150%（默认 300s → 实际 2.5~7.5 分钟随机不等），且每轮有 30% 概率整轮跳过——刻意制造"不规律活跃"，避免固定节奏被判定为自动化。
2. 分配行为：为队列中每个在线账号随机分配一个行为（权重：互聊 60% / 改状态 15% / 读消息 15% / 看联系人 10%）——单个账号约六成的轮次才轮到互聊，其余轮次执行"更像真人的"其他动作。
3. 执行独立行为：
   • 改状态：把个人签名更新为随机文案（如"忙碌中 / Busy"等），同一账号至少 30 分钟冷却；
   • 读消息：随机选 1~3 个聊天标记已读（只读不回复）；
   • 看联系人：随机查看 1~2 个联系人的资料。
4. 互聊（仅对分配到互聊的账号）：按公平两两配对（圆桌轮转，每账号每轮恰好参与一次、奇数时一人轮空）。每个配对：A 发一条（发送前模拟打字 + 按设置的高斯延迟随机等待）→ 等 3~8 秒 → B 回一条；配对之间再等 5~10 秒。一轮里每个配对只交换这一轮，不是持续对话。
5. 续排：一轮结束自动排下一轮，循环往复。

互聊消息从哪来

• AI 生成优先（配置了 AI 引擎时）：B 的回复按「你是一个普通微信用户，正在和朋友闲聊，自然口语 15~40 字，不要提及你是 AI」的提示词生成，语言跟随「养号对聊使用语言」；
• 静态短语库兜底：AI 未配置或生成失败时，自动回退内置日常寒暄短语（中文/英文各 20 条，如"在干嘛呢 / How are you?"）——绝不会把 AI 的失败结果或对方原文当回复发出（避免"回声"机械特征）；
• 养号消息计入该账号「累计发送」统计。

什么时候暂停 / 停止

• 群发任务执行中：本轮跳过，任务结束自动恢复；
• 账号离线连续 3 轮：自动移出养号队列并停止该账号养号（重新上线后需手动开启）；
• 队列少于 2 个账号：调度定时器清除（只开启 1 个账号不会启动，必须 ≥2 个才开始调度）；
• 手动停止：账号卡片点「🛑 停止养号」。

7.2 AI 自动回复（被动模式）

• 机制：账号收到消息 → 经启发式预过滤（纯表情/≤4 字确认语不烧 API）→ LLM 生成回复；AI 可自主决定不回复（__NO_REPLY__ 门控）。
• 聊天接管意图评级：每条入站消息按上下文评级为 7 类意图之一——IGNORE（广告/骚扰/发错人）、CHITCHAT（闲聊）、INFO（业务咨询）、INTERESTED（询价/高意向）、BUYING（明确购买）、AFTER_SALE（售后/投诉）、ESCALATE（辱骂/敏感/无法判断）。两段式实现：广告词启发式零成本拦截 → LLM 结构化分类（temp=0，携带对话历史"根据上下文评级"）；评级驱动回复话术路由（如 INTERESTED 主动引导成交、AFTER_SALE 先安抚再给方案、CHITCHAT 自然回应不推销）；评级开关在查看窗口 🤖 AI 面板按账号配置，账号卡片显示的「AI 接待用户数」即按意图评级去重统计；评级失败自动降级为未分类并照常回复，绝不影响回复链路。
• 群聊策略：仅在被 @ 或引用本号消息时才回复。
• 语音消息：配置 STT 后可转写为文字再回复。
• 人味化：阅读延时随消息长度缩放、打字延时随回复长度缩放（配合「模拟打字」），同一对话冷却默认 30s，间隔超 30 分钟视为新对话。
• 每账号独立配置：在查看窗口右上角 🤖 面板里设置该账号的接管开关、意图评级开关、关键词过滤、专属 System Prompt。
• 知识注入：回复时自动注入「事实卡」并按需检索「知识文件」，让 AI 知道你的业务与话术规矩（设置 → 知识库）。
• 标签同步（列表分组，需手动配置）：开启意图评级后，可将评级结果同步为 WhatsApp 标签，聊天列表按意图分组，直接在 WhatsApp 里查看/管理。配置方法：① 先在 WhatsApp 中创建标签 AI-高意向 / AI-购买 / AI-咨询 / AI-售后 / AI-转人工（对应 INTERESTED / BUYING / INFO / AFTER_SALE / ESCALATE）；② 应用探测到标签后自动把会话移入对应分组。仅标签变化时移动（幂等），闲聊/广告类不操作、不会清掉你自建的其它标签；未建标签或建错名 → 状态提示缺失（AI 接管照常工作）；删除 AI 标签即自动关闭分组；该能力仅 WhatsApp Business 账号支持。
• 转人工：连续失败或触发保底策略时，对话冻结并进入「转人工待处理」面板（标题栏 ⚠ 角标），由人工接管。

图 7-1 查看窗口的 AI 托管面板（真实截图）：按账号配置 AI 接管开关、意图评级、关键词过滤与专属提示词

7.3 中继 Relay（被动模式）

• 机制：账号收到消息 → 自动转发到指定目标号码（带发送者标识）；对方回复该转发消息时，自动路由回原始发送者，形成闭环。
• 配置：在账号卡片展开区的「🔄 本号专属中继闭环转发设置」中开启，并选择目标号码（下拉联系人列表或手动输入完整号码含国码）。
• 与全局设置的关系：中继不依赖全局 AI/风控设置；依赖该账号在线与代理/网络连通。

8. 群发任务

8.1 目标源与话术

发送对象获取源（三选一）

内容形态（三选一）

8.2 执行报告与导出

任务列表每行一个目标号码，实时更新四列：

• 底部统计：已发送成功数、过滤未注册数；
• 💾 导出 CSV：导出本次任务报告（名称/电话/是否注册）到本地文件；
• 🗑️ 清空：清空任务列表（有确认）。

8.3 启动任务

1. 添加目标号码到任务列表（任一来源）。
2. 选择执行账号（点击「选择执行账号」勾选；养号中的账号会被自动剔除）。
3. 选择任务模式：仅验证（只检测号码是否注册 WhatsApp）或 发送消息（向号码发送指定内容）。
4. 点击「启动集群群发任务 / 启动验证」；执行中可「紧急停止」。

9. Google 地图采集

在地图数据源下点击「🔍 执行新的地图检索」，应用会打开一个独立的 Google Maps 采集窗口（无边框窗口加载 Google Maps 网站，自动注入采集脚本）。在窗口内搜索行业+地区关键词（如 Spa in Singapore），点击右下角绿色「开始检索」按钮，脚本自动滚动加载全部结果卡片，并逐个进入商家详情页提取公开电话。

图 9-1 独立地图采集窗口（形态示意）：左侧为搜索结果卡片，右侧为地图；右下角绿色「开始检索」悬浮按钮与进度提示由采集脚本注入（真实窗口为无边框全屏 Google Maps 页面）

• 工作流程：搜索 → 自动滚动加载（按钮显示「加载 N 条」）→ 逐家进入详情页提取电话（按钮显示「提取中 X/N」，进度提示显示当前商家名）→ 全部完成后回到搜索页，结果回传主界面并增量合并；
• 多次留痕：每次采集结果按号码去重后增量合并到全局池，主界面显示「累积导入待验证总数」；
• 清空数据池：🗑️ 一键清空（有确认，清空后不可恢复）；
• 自动验证：地图数据作为任务输入时，群发/验证任务会同步执行号码存活验证；
• 网络：采集窗口走系统代理检测（无需配置地图 API Key —— 新版为页面脚本采集，无 Key 依赖）。

10. 联系人导入

选择目标源为「账号本身的既有聊天对象」或「本账号全部会话」后，点击「💬 获取已缓存联系人 / 获取全部会话」，弹出联系人选择窗口：

图 10-1 联系人导入：跨账号汇总去重，支持搜索、全选，导入后写入任务列表

• 按姓名跨账号去重（同一用户出现在多个账号通讯录只显示一行）；全部会话模式自动排除群聊、状态/频道、无法解析的 LID 会话；
• 支持按名称/号码/来源账号搜索过滤；勾选后点击「📥 导入选中」写入任务列表。

11. 设置指南（逐项说明）

点击标题栏 ⚙ 打开「全局高级核心配置中心」，共 6 个标签页：🤖 AI 引擎、📚 知识库、🎙 语音翻译、🛡 风控养号、🗂 代理库、🔄 系统。修改后点击底部「保存并应用配置」生效。

11.1 功能 ↔ 设置 关联表

11.2 🤖 AI 引擎

图 11-1 设置 → AI 引擎：全局 AI 配置（供应商 / 模型 / Key / 端点 / Temp / 冷却 / 翻译）

11.3 📚 知识库

• ① 事实卡（Fact Sheet）：建议必填。填写「我们是谁 / 主营产品 / 价格策略 / 服务流程 / 禁区清单（AI 绝不能说的话）」，每次 AI 回复都会注入，让 AI 有业务人设。以 > 开头的行是说明文字，不会注入。
• ② 知识文件：可选进阶。把产品详情/FAQ 写成 Markdown 文件放入知识库目录（如 products.md），AI 按消息内容自动检索最相关段落（按 ## 标题 分块）。
• 知识库目录（高级）：默认 %APPDATA%\CrimsonApex\knowledge，一般不用改。

11.4 🎙 语音翻译（STT / TTS）

11.5 🛡 风控养号

图 11-2 设置 → 风控养号：行为模糊化参数（轮询 / 打字 / 高斯延迟 / 养号频率与语言）

11.6 🗂 代理库与网络策略（VPN / 直连）

这是网络与风控的关键配置。原则：未配置代理的账号默认走本机系统网络（即本机开没开 VPN/系统代理，WhatsApp 流量就怎么走）。每个账号有三种选择：

图 11-3 设置 → 代理库：集中配置命名代理并测试验证（显示出口 IP 与延迟），账号卡片下拉引用

代理库使用步骤

1. 「➕ 添加代理」：填写名称、协议（HTTP/SOCKS5）、地址、端口、用户名、密码（住宅代理常态需要认证）。
2. 点条目右侧 🧪 测试：验证连通性并缓存出口 IP 与延迟（请求本身走代理，天然 fail-closed）。
3. 到目标账号卡片展开区「🌐 代理覆盖」下拉中选择该代理；也可选「强制直连（绕过系统代理）」。
4. 账号离线时卡片显示代理配置状态；在线时显示实际出口 IP。

11.7 🔄 系统

11.8 推荐配置模板

AI 引擎  ：DeepSeek + deepseek-chat + Temp 0.7 + 冷却 30s + 查看窗口翻译开启
知识库  ：填写事实卡（业务定位 / 价格策略 / 禁区清单）
语音    ：Groq Whisper（免费起步）+ TTS 自动（按目标语言·女声）
风控养号：随机轮询 + 模拟打字开 + 高斯延迟 15~45s + 养号频率 300s + 养号语言 English
代理    ：1~2 个账号 → 直连/系统 VPN；多账号 → 每账号独立住宅代理（先 🧪 测试再绑定）

12. 常见问题 FAQ

Q：点击关闭按钮，应用还在后台运行？

是的。关闭时会弹出选择：「最小化到托盘」（应用继续在后台运行养号/自动回复）或「退出应用」。托盘图标可随时恢复窗口。

图 12-1 关闭选项：最小化到托盘（后台继续运行）或彻底退出

13. 合规与风控提示

附录 B · 功能配置速查表

从「我要用某个功能」出发，列出每个功能必须配置什么、在哪里配置、推荐值（详细逐项说明见第 11 节）。

附录 A · 术语表