插件失效需手动重装并强制重载，先用hermes plugin list和hermes doctor --plugin定位路径、导入或元数据问题，再彻底卸载、清缓存、重装（-e模式/Pypi/venv pip）、reload验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 Hermes Agent 中执行插件命令时无响应、提示 plugin not found 或报 ModuleNotFoundError，说明插件已失效，需手动重装并强制重载——这不是重启就能解决的问题，必须清除旧引用、重建安装路径、触发运行时索引刷新。
确认插件当前状态与失效根源
先不急着删文件，用诊断命令快速定位是路径问题、导入失败还是元数据缺失：
执行 hermes plugin list，观察输出中目标插件是否显示为 inactive 或完全不出现；
再运行 hermes doctor --plugin your-plugin-name（将 your-plugin-name 替换为实际插件名），它会直接告诉你缺失 plugin.yaml、入口函数不可调用，还是 Python 模块 import 失败。
如果输出含 entrypoint not callable，说明插件入口函数签名已过时；若提示 no plugin.yaml found，则插件包结构已被破坏——这两类必须重装，不能仅 reload。
彻底卸载旧插件并清理残留
第一步：停止所有正在运行的插件服务，避免文件被占用：hermes plugin stop --all
第二步：进入插件所在目录，手动删除整个插件包（不是只删 .py 文件）：rm -rf ~/.hermes/plugins/your-plugin-name
第三步：清除 Hermes Agent 内部缓存的插件索引，否则即使重装也会加载旧缓存：rm -f ~/.hermes/cache/plugin_index.json
【注意】不要跳过这一步——缓存未清，重装后仍会加载已损坏的元数据快照，导致重装无效。
重新安装插件的三种方法
方法一：本地开发模式安装（推荐给修改过源码的用户）
进入插件源码根目录（含 plugin.yaml 和 __init__.py），执行：hermes plugin install -e .
该命令会自动识别 plugin.yaml，绑定入口，并注册到 Hermes venv 中。
方法二：从 PyPI 安装（适用于已发布插件）
直接运行：hermes plugin install hermes-plugin-xxx
注意：此命令内部调用的是 Hermes 自带 venv 的 pip，而非系统 pip，无需手动激活环境。
方法三：手动注入 Python 环境（当插件依赖冲突严重时）
先查 Hermes venv 路径：hermes --debug info | grep python_path
再用该路径下的 pip 强制重装：/path/to/hermes-venv/bin/python -m pip install --force-reinstall -e /path/to/plugin
Windows 用户请将路径分隔符改为反斜杠，并使用 Scripts\python.exe。
强制重载插件并验证可用性
① 执行重载命令，不重启 Agent：hermes plugin reload
② 立即检查插件是否激活：hermes plugin list | grep your-plugin-name
输出应含 active 字样且状态为绿色。
③ 运行一次真实命令测试功能：hermes your-plugin-command --help
若返回帮助文本，说明插件已成功加载；若仍报错，重点检查 plugin.yaml 中 entrypoint 字段是否指向存在的函数，例如 main:execute 对应 main.py 中的 def execute(context):。
【关键前提】plugin.yaml 中的 entrypoint 必须格式为 “模块名:函数名”，中间是英文冒号，前后不能有空格，否则 Hermes 无法解析。
