当用户想在 Hermes Agent 正式版 main 分支上补充 QQ platform 支持,或明确提到“给 hermes main 增加 QQ 渠道”“把 QQ support 作为 skill 安装到 Hermes”“让正式版 Hermes 支持 QQ 和文件发送”时使用。这个技能会把当前仓库补成支持 QQ Bot、QQ 文件发送、QQ 平台配置和工具集接线的版本。
这个技能用于把 Hermes Agent 的 main 正式代码 补成支持 QQ platform 的版本。
适用场景:
hermes-agentmain 代码上增加 QQ 渠道不适用场景:
hermes-agenthermes-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.py
QQ adapter 完整实现,会被复制到 gateway/platforms/qq.pyreferences/verification.md
安装后建议执行的验证命令如果脚本提示某个补丁锚点不存在,说明目标仓库已经偏离官方 main 太多。这种情况下不要盲写,先读 references/verification.md,再手动审查差异后补丁。