Back to Details

hermes-qq

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Hermes QQ Installer

Hermes QQ Installer

这个技能用于把 Hermes Agent 的 
main
正式代码 补成支持 QQ platform 的版本。
适用场景：
  • 当前仓库是 
    hermes-agent
  • 用户希望在正式 
    main
    代码上增加 QQ 渠道
  • 需要同时支持 QQ 文本、图片、音频、视频、普通文件发送
不适用场景：
  • 当前仓库不是 
    hermes-agent
  • 用户只是想分析 QQ adapter 原理，不想改代码
  • 仓库已经是自带 QQ 支持的分支，且不需要再次打补丁
This skill is used to update the official 
main
code of Hermes Agent to a version that supports the QQ platform.
Applicable scenarios:
  • The current repository is 
    hermes-agent
  • Users want to add QQ channel to the official 
    main
    code
  • Need to support QQ text, image, audio, video, and regular file sending simultaneously
Inapplicable scenarios:
  • The current repository is not 
    hermes-agent
  • Users only want to analyze the principle of QQ adapter without modifying code
  • The repository is already a branch with built-in QQ support and does not need patching again

工作流程

Workflow

  1. 先确认目标仓库是 
    hermes-agent
    ，并且工作树里没有会冲突的本地改动。
  2. 运行 
    scripts/install_hermes_qq.py
    ，默认对当前工作目录打补丁。
  3. 如仓库有 
    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
  4. 如果没有现成环境，再按仓库约定补测试环境后执行同一组定向测试。
  1. First confirm that the target repository is 
    hermes-agent
    and there are no conflicting local changes in the working tree.
  2. Run 
    scripts/install_hermes_qq.py
    , which will patch the current working directory by default.
  3. If the repository has a 
    venv
    , prioritize executing: 
    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
  4. If there is no existing environment, set up the test environment according to the repository conventions first, then execute the same set of targeted tests.

运行方式

Execution Methods

当前目录就是目标 
hermes-agent
仓库时：
bash
python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py
指定目标仓库时：
bash
python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py /path/to/hermes-agent
When the current directory is the target 
hermes-agent
repository:
bash
python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py
When specifying the target repository:
bash
python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py /path/to/hermes-agent

资源

Resources

  • assets/qq.py
    QQ adapter 完整实现，会被复制到 
    gateway/platforms/qq.py
  • references/verification.md
    安装后建议执行的验证命令
如果脚本提示某个补丁锚点不存在，说明目标仓库已经偏离官方 
main
太多。这种情况下不要盲写，先读 references/verification.md，再手动审查差异后补丁。
  • assets/qq.py
    Complete implementation of QQ adapter, which will be copied to 
    gateway/platforms/qq.py
  • references/verification.md
    Verification commands recommended to execute after installation
If the script prompts that a certain patch anchor does not exist, it means the target repository has deviated too much from the official 
main
branch. In this case, do not patch blindly. First read references/verification.md, then manually review the differences before patching.