Hermes-Agent 操作指南¶

能做什么？¶

1. 智能对话与任务执行¶

文件操作：读取、编辑、创建文件和目录
代码开发：编写、调试、重构代码
Shell 命令：执行终端命令
搜索分析：搜索代码库、文件内容
Git 操作：提交、推送、拉取

2. Skills 系统¶

安装和管理预置技能
自定义工作流自动化
扩展 Agent 能力

3. 多会话管理¶

保留对话历史
恢复和继续会话
会话洞察分析

如何做？¶

基础对话¶

# 交互式聊天
hermes chat

# 单次查询（安静模式）
hermes chat -q "解释这段代码的作用" -m deepseek/deepseek-chat-v4-flash

# 继续上次会话
hermes chat --continue

# 恢复特定会话
hermes chat --resume session-name

文件操作¶

# 让 Agent 读取文件并分析
hermes chat -q "请分析 /path/to/file.js 的代码结构"

# 让 Agent 修改文件
hermes chat -q "请在 index.js 中添加错误处理逻辑"

# 让 Agent 创建新项目
hermes chat -q "创建一个 Express.js REST API 项目"

代码开发示例¶

示例 1：代码审查

hermes chat -q "审查 /workspace/src/api.ts 的代码质量问题，提供改进建议"

示例 2：Bug 修复

hermes chat -q "这个函数报错 'undefined is not a function'，请定位并修复：
$(cat /workspace/buggy.js)"

示例 3：测试编写

hermes chat -q "为 /workspace/calc.js 中的计算器函数编写单元测试"

Git 操作¶

# 查看变更
hermes chat -q "分析当前的 git status，给出提交建议"

# 自动提交
hermes chat -q "创建一个有意义的 commit message 并提交当前更改"

# 代码审查
hermes chat -q "对比 main 分支，分析当前代码的变更内容"

项目初始化¶

# 初始化新项目
hermes chat -q "初始化一个 Python FastAPI 项目，包含：
- 用户认证
- PostgreSQL 数据库
- Docker 配置"

# 添加功能
hermes chat -q "为现有项目添加 WebSocket 支持"

文档生成¶

# 生成 README
hermes chat -q "为 /workspace 项目生成完整的 README.md 文档"

# 生成 API 文档
hermes chat -q "为 /workspace/api.js 生成 OpenAPI 规范文档"

自动化脚本¶

# 创建部署脚本
hermes chat -q "创建一个自动部署到 Vercel 的 shell 脚本"

# 数据处理
hermes chat -q "编写 Python 脚本，读取 CSV 并生成统计报告"

高级用法¶

上下文传递¶

# 传递文件内容作为上下文
hermes chat -q "基于以下代码，重构为 TypeScript：
$(cat ./legacy.js)"

# 使用会话 ID 保持上下文
hermes chat -q "继续上次的任务" --pass-session-id

调试模式¶

# 启用调试输出
hermes chat -q "..." --dev

# 查看详细日志
hermes logs --tail 100

批量处理¶

# 处理多个文件
hermes chat -q "为 docs/ 目录下所有 markdown 文件添加目录"