个人微信接入 CyberStrikeAI（扫码绑定）

做渗透测试、漏洞研判的时候，遇到过这种场景：

• 人在外面，只有手机，服务器上的 CyberStrikeAI 却懒得开浏览器；
• 钉钉 / 飞书 / 企业微信都配好了，但日常沟通还是个人微信；
• 机器人回调要公网、要备案，家里 NAS 或小内网部署总差点意思。

这一次，CyberStrikeAI 在钉钉、飞书、企业微信之外，新增了个人微信（iLink）机器人接入；同时把系统设置 · 机器人相关的前端界面做了一轮体验优化。

下面按「能做什么 → 怎么配 → 界面改了什么」说清楚。

一、个人微信机器人：能做什么？

和已有的钉钉、飞书、企业微信机器人一样，微信侧的核心目标不变：

在手机里发文字，就能驱动 CyberStrikeAI 的 AI Agent 做授权范围内的安全测试与分析。

具体能力包括：

与企业微信的区别一句话概括：

• 企业微信：HTTP 回调 + 主动发消息 API，需要公网可达与后台配置；
• 个人微信：Web 端扫码绑定，绑定后自动写配置并拉起长连接，不用折腾回调 URL。

二、半分钟完成绑定（Web 端可视化）

路径：登录 CyberStrikeAI → 系统设置 → 机器人设置 → 微信 / iLink。

步骤 1：生成二维码

点击 「生成二维码并绑定」。页面会显示加载动画，并展示绑定二维码；若图片无法显示，也可通过备用链接在手机微信中打开。

步骤 2：微信扫码确认

用手机微信扫描二维码，在手机上完成确认。界面顶部状态会从 「未绑定」→「绑定中…」，并展示三步进度：生成二维码 → 微信扫码 → 确认绑定。

步骤 3：完成绑定（部分账号需配对码）

• 多数账号扫码确认后即可完成；
• 若手机提示需要输入配对数字，在页面下方输入框填写并提交，系统会继续轮询直至绑定成功。

绑定成功后：

• 状态徽章变为 「已连接」；
• bot_token、ilink_bot_id 等写入 config.yaml；
• 机器人长连接自动启动，一般无需再整进程重启。

高级用户可展开 「高级设置」，按需调整 API Base URL、Bot Type、Bot Agent 等（默认值对大多数场景已够用）。

三、绑定之后，在微信里怎么用？

向绑定的微信账号（或 iLink 提供的对话入口）直接发文本即可。

常用命令速查

除命令外，任意自然语言都会交给 AI，例如：「对 example.com 做授权范围内的信息收集」「帮我梳理这份漏洞报告的风险等级」等——与 Web 控制台同一套能力，只是交付渠道换成了微信。

合规提醒：请仅在已获得书面授权的目标与环境上使用。CyberStrikeAI 面向授权安全测试场景设计，请勿用于未授权访问或任何违法用途。

四、技术实现

若你关心「为什么内网也能用」，核心机制如下：

1. iLink 协议：通过 https://ilinkai.weixin.qq.com（可配置）与微信侧通信；
2. 长轮询 getUpdates：后台 goroutine 持续拉取消息，断线后按 5s～60s 指数退避自动重连；
3. 扫码绑定 API：/api/robot/wechat/qrcode 生成会话，/qrcode/status 轮询状态，绑定成功由 ApplyWechatRobotBinding 持久化并触发 RestartRobotConnections；
4. 消息回复：收到文本后走统一 HandleMessage，经 Agent 处理后再 SendTextMessage 回传。

这意味着：你不需要像企业微信那样配置 Token、EncodingAESKey 和公网回调地址，个人微信场景的部署门槛明显更低。

五、前端界面优化：设置页与仪表盘

本次除了微信机器人，还对 Web 前端做了一轮「能感知到」的体验打磨。

1. 机器人设置 · 微信专区

• 独立卡片布局：微信配置与钉钉 / 飞书 / 企业微信分区展示，信息层次更清晰；
• 实时状态徽章：未绑定 / 绑定中 / 已连接，一眼可知当前状态；
• 绑定流程可视化：三步进度条 + 二维码边框动效 + 加载 Spinner；
• 绑定成功页：成功图标与 Bot ID 展示，支持「重新绑定」；
• 国际化：中英文界面同步支持（data-i18n + wechat-robot.js）。

2. 配置热生效

在「机器人设置」或相关配置修改并 「应用配置」 后，钉钉 / 飞书 / 微信 长连接会通过 RestartRobotConnections自动重连，多数情况下不必重启整个 CyberStrikeAI 进程——改完就能测，迭代更顺手。

3. 系统仪表盘

• 智能刷新：已有数据时后台静默更新，避免整页闪成「…」占位；
• 自动轮询：每 60 秒刷新，标签页隐藏时暂停，回到页面立即补拉；
• 数据过期提示：超过 5 分钟未更新时，「上次更新」徽章变灰并提示，减少「以为是最新数据」的误判；
• 并行拉取：任务、漏洞、HITL 待审批、C2、WebShell 等多路指标一次聚合，打开仪表盘即可纵览全局。

这些改动不改变核心能力，但让日常运维与状态感知更省心——尤其是你同时开着 Web 控制台和手机机器人的时候。

六、与企业微信 / 钉钉 / 飞书如何搭配？

CyberStrikeAI 的机器人矩阵现在是：

你可以按团队习惯只开一种，也可以多平台并存——会话数据在 Web 端统一可见，便于在电脑前复盘、在手机边跟进。

七、快速排错

更完整的机器人说明见项目文档：docs/robot.md（企业微信 / 钉钉 / 飞书章节）；微信 iLink 以 Web 设置页引导为准。

项目地址：GitHub - https://github.com/Ed1s0nZ/CyberStrikeAI