使用技巧
提升使用效率的最佳实践和技巧,帮助你充分发挥 Hermes Agent 的能力。
提示词技巧
明确指定工具
在提示中明确告诉 Hermes 使用哪些工具,可以提高执行效率:
text
# 好的提示
"使用浏览器访问 https://example.com,然后用终端执行 ls 命令"
# 更好的提示 — 带具体步骤
"请按以下步骤操作:
1. 使用 browser 工具访问 https://example.com
2. 提取页面中的所有链接
3. 将结果保存到 links.txt 文件中"
使用上下文文件
通过上下文文件向 Hermes 提供额外的参考信息:
text
# 引用文件作为上下文
"请参考 project-spec.md 中的需求,帮我设计 API 接口"
# 引用多个文件
"根据 src/models.py 和 src/schemas.py 的结构,生成对应的 CRUD 操作"
分步骤描述任务
复杂任务分解为多个步骤,每步都明确描述:
text
# 复杂任务的分步描述
"帮我完成以下任务:
1. 在 src/ 目录下创建 api.py 文件
2. 实现 Flask REST API,包含 GET /users 和 POST /users 端点
3. 添加输入验证和错误处理
4. 编写对应的单元测试文件 tests/test_api.py
5. 运行测试确认全部通过"
CLI 使用技巧
善用多行输入
使用 Alt + Enter 输入复杂的多行提示:
text
> 帮我写一个 Python 函数 [Alt+Enter]
> 功能是实现快速排序算法 [Alt+Enter]
> 要求:使用类型注解、添加文档字符串、[Alt+Enter]
> 包含边界情况处理 [Enter]
使用斜杠命令别名
text
# 为常用命令创建别名
/alias c = compact
/alias m = memory read
/alias sl = skills list
/alias tl = tools list
中断和恢复
- 使用 Ctrl + C 中断正在进行的生成
- 使用
/undo撤销上一条消息 - 使用
/sessions resume <id>恢复之前的会话
记忆管理技巧
主动保存重要信息
text
# 告诉 Hermes 记住信息
"请记住:我的项目使用 Python 3.11,框架是 FastAPI,数据库是 PostgreSQL"
# 让 Hermes 使用记忆
"根据你记住的我的项目信息,帮我生成 docker-compose.yml"
配置 USER.md
编辑 ~/.hermes/USER.md 文件,让 Hermes 了解你的偏好:
markdown
# USER.md
## 偏好
- 代码风格:使用 Black 格式化
- 编程语言:Python(主要)、TypeScript
- 注释语言:中文
- 回复风格:简洁直接
## 项目
- 当前项目:~/projects/myapp
- 技术栈:FastAPI + PostgreSQL + React
性能优化
选择合适的模型
| 场景 | 推荐模型 | 原因 |
|---|---|---|
| 简单问答 | 轻量模型(DeepSeek Chat) | 速度快,成本低 |
| 代码生成 | GPT-4o / Claude Sonnet | 代码质量高 |
| 复杂推理 | Claude Opus / GPT-4o | 推理能力强 |
| 中文场景 | DeepSeek / Kimi | 中文理解好 |
使用辅助模型
配置轻量辅助模型处理非核心任务,节省费用:
yaml
auxiliary_models:
provider: google
model: gemini-2.0-flash # 免费且快速
定期压缩上下文
- 长对话中定期使用
/compact手动压缩 - 调整压缩阈值以适应你的使用模式
- 重要信息保存到记忆中,不依赖上下文
消息平台技巧
Telegram 最佳实践
- 发送语音消息自动转文字处理
- 支持发送图片让 Hermes 分析
- 使用线程(threads)组织对话
Discord 最佳实践
- 创建专用频道与 Hermes 交互
- 使用 Bot 可以加入语音频道进行实时对话
- 支持表情回应和打字状态显示
安全最佳实践
始终遵循以下安全原则:
- 使用 Docker 隔离:生产环境始终使用 Docker 终端后端
- 启用 DM 配对:防止未授权用户访问
- 最小权限原则:只启用需要的工具和技能
- 保护 API 密钥:使用 .env 文件,不提交到版本控制
- 定期更新:保持 Hermes 和依赖的最新版本
- 审计技能:安装社区技能前使用
/skills audit检查 - 监控日志:定期检查日志中的异常活动
Webhook 使用
Hermes 支持动态 Webhook 订阅,可接收外部事件触发:
- HMAC 签名:每个 Webhook 使用唯一密钥签名验证
- 事件过滤:可配置接收的事件类型
- 跨平台投递:事件可投递到任意已配置的消息平台
遇到问题?使用 hermes doctor 命令诊断常见问题,或查看 ~/.hermes/logs/ 目录中的日志文件。