遇到“技能执行超时”问题，应依次调整超时阈值、启用异步非阻塞模式、隔离高开销技能至独立进程、注入心跳检测机制、禁用无效重试策略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Hermes Agent执行某项技能时遇到长时间无响应、任务卡住或主动中断，提示“技能执行超时”，这通常源于工具调用阻塞、异步调度异常、资源竞争或外部服务响应迟滞。以下是解决此问题的步骤：
一、调整技能执行超时阈值
默认超时限制可能过于保守，尤其在处理复杂脚本生成、本地模型推理或网络延迟较高的API调用时，需显式延长允许的最大等待时间。
1、打开~/.hermes/config.yaml文件，定位到tools配置区块。
2、在对应技能（如run_test_suite或execute_shell_command）定义下，添加或修改timeout_seconds字段。
3、将该值设为不低于120（单位：秒），对于含编译或大文件操作的技能可设为300。
4、保存文件后，执行hermes restart使配置生效。
二、启用异步非阻塞执行模式
部分技能在同步上下文中直接调用协程会导致事件循环冲突，造成主线程挂起，表面表现为“超时”，实则为死锁。
1、检查技能实现文件，例如tools/exec_tools.py中对应函数是否使用asyncio.run()。
2、将所有asyncio.run(coro)替换为run_async(coro)调用，该函数已在tools/async_utils.py中预置。
3、确认run_async内部已启用ThreadPoolExecutor回退机制，避免在已有事件循环中重复启动。
三、隔离高开销技能至独立进程
当技能涉及CPU密集型操作（如视频处理、大规模正则匹配、本地LLM推理）时，会阻塞主事件循环，导致其他技能与网关通信停滞。
1、在技能定义的function对象中，添加"execution_mode": "process"字段。
2、确保tools/process_isolation.py已启用，该模块通过multiprocessing.Process启动子进程并设置daemon=True。
3、验证子进程退出码：若返回-9（SIGKILL），说明内存超限，需在environments/default.yaml中调高resource_limits.memory_mb。
四、注入心跳检测与主动中断机制
对无法预估耗时的外部调用（如第三方Webhook、长轮询接口），需防止无限等待，通过周期性探针判断是否应强制终止。
1、在技能入口函数顶部插入from tools.heartbeat import start_heartbeat, stop_heartbeat。
2、调用start_heartbeat(interval=15)启动后台心跳线程，每15秒向/tmp/hermes_heartbeat.pid写入当前时间戳。
3、在主逻辑中每执行一个关键步骤后，调用check_heartbeat_alive()；若检测到心跳停滞超30秒，则抛出SkillTimeoutError并触发清理流程。
五、禁用技能级重试以规避累积延迟
当技能配置了retry_on_failure: true且未限定次数时，连续失败重试会叠加超时，掩盖真实瓶颈。
1、在tools/skill_registry.yaml中找到目标技能条目。
2、移除retry_on_failure字段，或显式设置为false。
3、如确需重试，改用带退避策略的显式调用：retry(max_attempts=2, backoff_factor=2.0)，并在首次失败后记录error_code供诊断。
