需在Hermes虚拟环境中执行pip install -e '.[acp]'启用ACP支持，验证hermes acp --check输出“OK”；安装VS Code的ACP Client扩展；配置绝对路径指向acp_registry/agent.json；重启VS Code后连接即可实现快捷键响应、文件读取、终端执行与上下文保持。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让 Hermes Agent 在 VS Code 里像内置功能一样响应快捷键、读取当前文件、执行终端命令、展示 diff 并保持会话上下文，而不是开个网页或弹个独立窗口——这需要打通 ACP 协议栈，把编辑器和 Agent Runtime 绑定在同一个进程边界内。
装 Hermes 的 ACP 适配器
默认安装的 hermes-agent 不含 ACP 支持，必须手动启用 extra。进入 Hermes 安装目录下的虚拟环境：
cd ~/AppData/Local/hermes/hermes-agentsource && venv/Scripts/activate
运行：pip install -e '.[acp]'
验证是否成功：hermes acp --check → 输出 Hermes ACP check OK 才算通过。
【关键前提】 这一步必须在 Hermes 自带的 venv 里执行。如果 pip 装到了系统 Python，hermes acp --check 会报错 ACP dependencies not installed。用 ./venv/Scripts/pip3 list | grep agent-client 确认输出里有 agent-client-protocol 0.9.0。
装 VS Code 的 ACP Client 扩展
打开 VS Code 扩展市场，搜 ACP Client，点击安装；或直接命令行执行：code --install-extension formulahendry.acp-client。
装完后左侧 Activity Bar 出现 ACP 图标，说明扩展已就位。
扩展自带 Hermes 配置，但直接点 Connect 会卡住——因为缺少 registryDir 指向。
配置 registryDir 让握手成功
第一步：确认 hermes-agent/acp_registry/agent.json 文件存在。它描述 Hermes 的 ACP 能力，是 IDE 握手时必读的元数据。
第二步：打开 VS Code 设置（Ctrl+,），搜索 ACP Registry Dir，填入绝对路径：
Windows 用户填：C:\Users\{你的用户名}\AppData\Local\hermes\hermes-agent\acp_registry
macOS/Linux 用户填：/Users/{你的用户名}/.local/share/hermes/hermes-agent/acp_registry
⚠️ 注意：路径中不能用 ~ 或环境变量，必须是完整绝对路径，否则扩展找不到 agent.json，session/new 请求发出去后无响应。
第三步：重启 VS Code，点击左侧 ACP 图标 → “Hermes Agent” → Connect。
几秒后右下角状态栏显示 “Hermes Agent Connected”，聊天面板自动弹出，Agent 开始监听 workspace 文件变更、接受选中文本、执行终端命令。
