chujianyun Hermes QQ Installer
这个技能用于把 Hermes Agent 的 main 正式代码 补成支持 QQ platform 的版本。
适用场景：
- 当前仓库是
hermes-agent - 用户希望在正式
main代码上增加 QQ 渠道 - 需要同时支持 QQ 文本、图片、音频、视频、普通文件发送
不适用场景：
- 当前仓库不是
hermes-agent - 用户只是想分析 QQ adapter 原理，不想改代码
- 仓库已经是自带 QQ 支持的分支，且不需要再次打补丁
工作流程
- 先确认目标仓库是
hermes-agent，并且工作树里没有会冲突的本地改动。 - 运行
scripts/install_hermes_qq.py，默认对当前工作目录打补丁。 - 如仓库有
venv，优先执行：source venv/bin/activate && python -m pytest tests/gateway/test_platform_base.py tests/gateway/test_extract_local_files.py tests/gateway/test_send_image_file.py tests/cron/test_scheduler.py tests/gateway/test_background_command.py tests/gateway/test_internal_event_bypass_pairing.py -q -n 0 - 如果没有现成环境，再按仓库约定补测试环境后执行同一组定向测试。
运行方式
当前目录就是目标 hermes-agent 仓库时：
python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py
指定目标仓库时：
python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py /path/to/hermes-agent
资源
assets/qq.pyQQ adapter 完整实现，会被复制到gateway/platforms/qq.pyreferences/verification.md安装后建议执行的验证命令
如果脚本提示某个补丁锚点不存在，说明目标仓库已经偏离官方 main 太多。这种情况下不要盲写，先读 references/verification.md，再手动审查差异后补丁。