用途:把 Hermes Agent 的 main 正式代码补成支持 QQ platform 的版本,适用于当前仓库为 hermes-agent、希望在正式 main 上增加 QQ 渠道、并需要 QQ 文本、图片、音频、视频、普通文件发送的场景。不适用于仓库不是 hermes-agent、仅想分析 QQ adapter 原理、或仓库已自带 QQ 支持且无需再次打补丁的情况。
主要能力:脚本默认对当前工作目录打补丁,并包含 QQ adapter 完整实现 assets/qq.py,该文件会被复制到 gateway/platforms/qq.py;references/verification.md 提供安装后建议执行的验证命令。
使用方式:先确认目标仓库是 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。如仓库有 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;没有现成环境时按仓库约定补测试环境后执行同一组测试。
限制:若脚本提示某个补丁锚点不存在,说明目标仓库已偏离官方 main 太多,不要盲写,应先读 references/verification.md,再手动审查差异后补丁。其他功能、收费、价格、平台与效果等资料暂未提供。