WorkBuddy支持通过QQ消息远程触发本地脚本，具体路径包括：一、配置go-cqhttp Webhook监听QQ消息；二、绑定关键词到本地脚本执行；三、利用QQ快捷指令免输入触发；四、通过匹配命名规则的QQ文件隐式触发；五、启用HMAC-SHA256签名验证防误触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望使用QQ消息远程触发本地电脑上的脚本，WorkBuddy 提供了跨即时通讯工具的自动化响应能力。以下是实现该功能的具体操作路径：
一、配置WorkBuddy监听QQ消息通道
WorkBuddy 支持通过模拟QQ客户端消息接收机制或对接QQ机器人协议（如酷Q已停用后迁移至go-cqhttp）来捕获指定关键词消息。需确保本地运行环境具备消息监听权限及脚本执行上下文。
1、下载并安装 go-cqhttp Windows 版本，按官方文档完成 QQ 账号登录与 HTTP API 服务启动。
2、在 WorkBuddy 的“连接源”设置中，选择“自定义 HTTP Webhook”，填入 go-cqhttp 的 http://127.0.0.1:5700/ 地址。
3、启用“消息事件订阅”，勾选“群消息”与“私聊消息”，并设置过滤关键词如【run_backup】或【exec_clean】。
4、保存配置后，在 WorkBuddy 日志面板确认出现“Connected to QQ webhook”提示。
二、绑定关键词到本地脚本执行动作
WorkBuddy 允许将接收到的特定QQ消息内容映射为预设的本地命令行调用，无需二次开发即可绑定脚本路径与参数。
1、进入“动作管理”界面，点击“新增动作”，类型选择“运行本地程序”。
2、在“触发关键词”栏输入 !sync_docs，注意开头感叹号为必需前缀。
3、在“程序路径”中填写完整绝对路径，例如：C:\scripts\sync.bat。
4、勾选“以管理员权限运行”（若脚本需访问系统目录或注册表）。
5、点击“测试触发”，在QQ中向机器人发送 !sync_docs，观察WorkBuddy控制台是否显示“Executing C:\scripts\sync.bat”。
三、使用QQ快捷指令免输入关键词触发
通过QQ内置的“快捷指令”功能可绕过手动打字，直接点击按钮向WorkBuddy推送预置指令，提升操作隐蔽性与效率。
1、在QQ群设置中进入“群应用” → “添加应用” → 搜索并启用“群待办”或“自定义菜单”（需管理员权限）。
2、新建一个菜单项，名称设为“紧急备份”，跳转链接设为：http://127.0.0.1:8080/workbuddy/trigger?cmd=backup_now（该地址需已在WorkBuddy中配置对应HTTP端点）。
3、在WorkBuddy的“Webhook端点”中新增 /trigger 路由，绑定动作“执行 backup_now 对应脚本”。
4、保存后，群成员点击“紧急备份”按钮，即自动触发本地 backup.bat 运行。
四、通过QQ文件传输通道隐式触发脚本
WorkBuddy 可监控指定QQ账号接收的文件名特征，当接收到符合命名规则的空文件或标记文件时，自动执行关联脚本，实现零文字交互。
1、在“事件源”中启用“QQ文件接收监听”，设置监控目录为 go-cqhttp 的 download 文件夹路径。
2、设定文件名匹配规则：例如正则表达式 ^EXEC_.*\.trigger$。
3、创建一个空白文本文件，重命名为 EXEC_CLEANUP.trigger，并通过QQ发送给已登录的bot账号。
4、WorkBuddy 检测到该文件后，立即调用绑定的 cleanup.ps1 脚本，执行磁盘清理任务。
五、启用QQ消息加签验证防止误触发
为避免他人伪造QQ消息触发敏感脚本，WorkBuddy 支持对入站消息进行签名比对，仅放行携带有效HMAC-SHA256签名的消息。
1、在WorkBuddy“安全设置”中开启“消息签名验证”，生成一对密钥，将公钥部分填入 go-cqhttp 插件配置的 sign_key 字段。
2、所有发往WorkBuddy的QQ消息必须由可信客户端预先计算签名，格式为：【SIGN:xxx】+原始指令。
3、发送测试消息：【SIGN:a1b2c3d4】!reboot_server，确保WorkBuddy日志显示“Signature verified”而非“Invalid signature”。
4、未带有效签名的 !reboot_server 消息将被直接丢弃，且不记录于操作日志。
