🛠️ Hermes Agent 技能完全使用教程

覆盖 25 个核心技能 · 分类详解 · 真实案例 · 2026 年 5 月

📑 目录

  1. 核心能力 — hermes-agent、记忆、搜索、技能发现
  2. 搜索与情报 — web_search、parallel-cli、DuckDuckGo、浏览器
  3. 笔记与生产力 — Notion、Get笔记、双写同步
  4. 文档生成 — docx、powerpoint
  5. GitHub 开发 — PR、代码审查、Issue管理
  6. DevOps 运维 — Docker、自动化、中国云
  7. 视频/媒体 — B站、YouTube
  8. 创意设计 — 架构图、Diagram、信息图、Manim
  9. AI/ML 模型 — Whisper、Stable Diffusion
  10. 安全审计 — 网站审计、CSO、法证
  11. 决策与规划 — 1-3-1 规则、计划模式

🏗️ 第一章:核心能力

1. hermes-agent Hermes 专属

功能:配置、扩展和贡献 Hermes Agent 本身。覆盖 CLI 命令、配置文件、模型切换、网关管理等。

使用说明

# 查看所有 CLI 命令
hermes --help

# 交互式选模型
hermes model

# 查看当前配置
hermes config show

# 设置单个配置项
hermes config set agent.max_turns 200

# 查看网关状态
hermes gateway status

# 诊断问题
hermes doctor

# 更新到最新版本
hermes update

💼 案例 1:性能调优

用户反馈微信端响应慢,小马自动诊断并调优:

用户:微信端一直显示"正在思考",卡了好几分钟

小马 → 加载 hermes-agent 技能
→ hermes doctor        # 诊断:auxiliary 模型回退到 GLM,超时
→ hermes config set agent.reasoning_effort low
→ hermes config set streaming.enabled true
→ hermes gateway restart
→ 确认 PID 5999 运行正常 ✅

💼 案例 2:切换模型提供商

想临时用通义千问做长文翻译:

用户:切换到通义千问做翻译

小马 → /model qwen:qwen-plus
→ 确认:已切换到 qwen-plus,上下文 131K
→ 执行翻译任务
→ /model deepseek:deepseek-v4-pro  # 完成后切回

💼 案例 3:排查工具集问题

用户:浏览器工具不能用了

小马 → hermes tools --summary          # 查看启用的工具
→ 检查 chrome sandbox 权限
→ setcap cap_net_raw,cap_net_bind_service+eip /opt/google/chrome/chrome
→ browser_navigate https://baidu.com   # 验证修复

2. 记忆系统 (Memory) 核心

功能:跨会话持久化记忆。记住用户偏好、环境配置、项目约定、工具 quirks。内置 FTS5 全文搜索 + LLM 摘要。

使用说明

# 保存一条事实
memory(action="add", target="user", content="用户偏好简洁回复,拒绝长篇大论")

# 更新已有记忆
memory(action="replace", target="memory", old_text="DeepSeek V4 Flash",
        content="主力模型:DeepSeek V4 Pro")

# 删除过时记忆
memory(action="remove", target="memory", old_text="已解决的临时bug说明")

# 搜索历史会话
session_search(query="特朗普访华 OR 中美会谈")
💡 最佳实践:记忆存稳定事实(偏好、约定、环境),不存任务进度。进度用 session_search 回溯。

💼 案例 1:记住用户别名

用户:以后说"笔记"就是 Get笔记,"灵感"就是 Notion 小龙助理

小马 → memory add:
  "笔记"=Get笔记(biji.com),"灵感"=Notion小龙助理,"待办"=Notion待办事项页面
→ 以后用户说"记个笔记",自动调 Get笔记

💼 案例 2:回溯上周做过的任务

用户:上周我们修了什么bug来着?

小马 → session_search(query="微信卡住 OR 网关死循环 limit OR rate limited")
→ 返回摘要:5月11日排查微信限流导致网关卡死,kill旧进程重启解决
→ 无需用户重复描述

💼 案例 3:自动学习项目规则

小马在执行中自动发现:
→ 用户 8 个邮箱的 IMAP/SMTP 地址不同
→ QQ 邮箱用 993 端口、163 需异地验证、Gmail 被墙需走代理
→ memory add: 完整邮箱配置表,以后发邮件不用每次确认

3. find-skills 发现

功能:根据用户需求自动发现并推荐安装合适的技能。

使用说明

直接用自然语言问"能不能做X",系统自动搜索匹配技能:

用户问:"能不能分析 B站视频?"    → 发现 bilibili-agent,自动安装
用户问:"帮我生成 PPT"            → 发现 powerpoint 技能
用户问:"有没有 Word 文档技能?"   → 发现 docx

💼 案例

用户:能帮我分析数据做报表吗?

小马 → 加载 find-skills
→ 搜索匹配:Data Analysis、jupyter-live-kernel
→ 推荐安装 → 安装后立即使用

🔍 第二章:搜索与情报

4. web_search(内置) 可联网

功能:Hermes 内置搜索工具。当前后端为 Parallel,支持中英文。

使用说明

web_search(query="特朗普 2026年5月 访华 工商界", limit=10)

直接调用即可,无需手动加载技能。返回标题、URL、摘要。

5. parallel-cli 高级搜索

功能:Parallel CLI 命令行工具。深度搜索、网页提取、深度研究、实体发现、监控。

安装:v0.3.0 已安装在 ~/.local/bin/parallel-cli

使用说明

# 搜索
parallel-cli search "中美企业家晚宴名单" --json

# 网页提取
parallel-cli extract https://example.com/article --json

# 深度研究(异步)
parallel-cli research run "对比主流AI编程助手" --processor core --no-wait --json
parallel-cli research poll <task_id> --json

# 限定来源
parallel-cli search "SEC filings" --include-domains sec.gov --json

💼 案例 1:快速获取信息

用户:搜一下中美企业家晚宴名单

小马 → parallel-cli search "中美企业家晚宴 2026年5月 名单" --json
→ 返回完整双方名单:美方17人 + 中方15人
→ 自动整理成表格

💼 案例 2:深度研究报告

用户:帮我做一份 AI 编程助手的竞品分析

小马 → parallel-cli research run \
  "对比 Cursor、Copilot、Codex CLI、Claude Code 的定价/模型/功能" \
  --processor core --no-wait --json
→ 获取 run_id → 5分钟后 poll 结果
→ 自动整理成竞品对比矩阵

6. duckduckgo-search 免费搜索

功能:DuckDuckGo 免费搜索。无需 API Key。注意:中文查询走 Brave Search 可能被墙超时。英文查询正常。

使用说明

# 英文搜索(推荐)
ddgs text -q "latest AI research 2026" -m 10 -o json

# 限时搜索(最近一周)
ddgs text -q "semiconductor export controls" -m 5 -t w
⚠️ 避坑:中国服务器上中文查询会超时。用英文搜或用 parallel-cli/web_search。

7. browser / agent-browser 浏览器自动化

功能:Chrome 浏览器控制。导航、点击、填写、截图、提取。

前提:Chrome 已安装且 sandbox 权限已修复。

使用说明

# 导航到页面
browser_navigate(url="https://www.bing.com")

# 截图
browser_snapshot()              # 文本快照
browser_vision(question="页面主要内容是什么?")

# 搜索关键词
browser_type(ref="@e9", text="特朗普访华 中方 企业家")
browser_click(ref="@e18")       # 点击搜索按钮

💼 案例

用户:帮我看看必应国际版上特朗普访华的新闻

小马 → browser_navigate("https://www.bing.com")
→ browser_click(ref="@e7")   # 切换到国际版
→ browser_type(ref="@e9", "Trump China visit May 2026")
→ browser_click 搜索
→ 获取结果列表 + 提取全文

📝 第三章:笔记与生产力

8. notion 知识库

功能:Notion API 集成。页面读写、数据库操作、搜索。

使用说明

# 搜索页面
notion 搜索 "小龙助理"

# 创建页面
notion 在 "小龙助理" 下创建子页面 "今日复盘_2026-05-15"

# 追加内容
notion 追加内容到页面 "待办事项":添加新任务

💼 案例

用户:把今天的复盘总结发到 Notion 小龙助理

小马 → 加载 notion 技能
→ 创建页面 "复盘_2026-05-15"
→ 写入:完成事项 / 待解决 / 技能新增
→ 确认已保存 ✅

9. getnote(Get笔记) 随手记

功能:Get笔记 (biji.com) 的笔记 CRUD、搜索、AI功能。

使用说明

# 列表
GET /voicenotes/web/notes             # 获取所有笔记

# 创建
POST /voicenotes/web/notes             # 创建新笔记

# 搜索
GET /voicenotes/web/notes/search?q=关键词    # 搜索笔记

10. dual-sync(双写同步) 自定义

功能:一键同步内容到 Notion 小龙助理 + Get笔记。复盘报告、会议纪要、配置记录双平台留痕。

使用说明

# 同时写入两个平台
dual-sync("基础设施复盘_2026-05-11", content=复盘内容)

# 流程:
# 1. notion 创建页面 → 写入
# 2. getnote 创建笔记 → 写入
# 3. 返回两个链接

💼 案例

用户:把技能盘点报告同时发到 Notion和Get笔记

小马 → 加载 dual-sync
→ Notion:创建"🛠️ 技能体系盘点"页面 ✅
→ Get笔记:创建笔记 ✅
→ 返回两个直达链接

📄 第四章:文档生成

11. docx Word 文档

功能:创建、读取、编辑 Word 文档(.docx)。表格、样式、图片、修订模式。

使用说明

# 创建文档
docx 创建文件 "项目方案.docx":
  - 封面(标题 + 日期 + 公司名)
  - 目录自动生成
  - 正文(H1/H2/H3 标题层次)
  - 表格(费用明细)
  - 页眉页脚(公司 Logo + 页码)

# 读取文档
docx 读取 "合同.docx" → 提取关键条款

# 批量替换
docx 替换 "模板.docx" 中所有 {{公司名}} → 湖南大地测绘工程有限公司

💼 案例 1:生成投标方案

用户:帮我生成大地公司体艺楼建设方案的 Word 文档

小马 → 加载 docx
→ 创建包含:封面/目录/项目概述/技术方案/施工计划/预算/资质证明
→ 自动添加页眉"湖南大地测绘工程有限公司" + 页码
→ 保存:体艺楼建设方案_2026.docx ✅

12. powerpoint PPT 幻灯片

功能:创建、读取、编辑 .pptx 演示文稿。

使用说明

powerpoint 创建 "AI工具培训.pptx":
  Slide 1:标题 + 副标题
  Slide 2:目录(4个模块)
  Slide 3-6:每个模块 3-5 个要点 + 配图
  Slide 7:总结 + 下一步行动

💻 第五章:GitHub 开发

13. github-pr-workflow PR 工作流

功能:完整的 PR 生命周期管理——分支创建、提交、推送、创建 PR、CI 检查、合并。

# 创建 PR
github-pr-workflow 创建 PR:
  分支:feat/add-search
  标题:新增全文搜索功能
  描述:基于 FTS5 实现跨会话搜索,支持中文分词

# 检查状态
github-pr-workflow 查看 PR #42 的 CI 状态

14. github-code-review 代码审查

功能:审查 PR 变更、写行内评论。

github-code-review 审查 PR #42:
  - 检查代码风格、潜在 bug、安全问题
  - 对有问题行写评论
  - 生成审查摘要

⚙️ 第六章:DevOps 运维

15. china-cloud-deployment 中国云部署

功能:在腾讯云/阿里云/华为云上部署 Hermes。GFW 感知的供应商选择、网络测试、国内模型推荐。

💼 案例

用户:在腾讯云新服务器上部署 Hermes

小马 → 加载 china-cloud-deployment
→ 网络测试:确认 DeepSeek/智谱/阿里 API 可达
→ 安装 Hermes → 配置国内模型
→ 配置 mihomo 代理访问 GitHub
→ 启动网关 → 绑定微信 ✅

16. docker-management Docker 管理

功能:容器/镜像/卷/网络/Compose 全生命周期管理。

docker-management 启动 PostgreSQL + Redis:
  docker-compose.yml 含数据持久化、健康检查、网络隔离

17. devops-automation 运维自动化

功能:CI/CD、监控、事件管理、基础设施工作流。

devops-automation 部署监控:
  - 监控 Hermes 网关进程
  - CPU/内存/磁盘 > 80% 时告警
  - 日志轮转 + 备份到腾讯云 COS

🎬 第七章:视频/媒体

18. bilibili-agent B站解析

功能:解析 B站视频内容、生成文字总结、回复用户查询、推荐最新视频。

💼 案例 1:视频摘要

用户:帮我总结这条B站视频 https://www.bilibili.com/video/BV1xxx

小马 → 加载 bilibili-agent
→ 获取视频信息:标题/UP主/时长/播放量
→ 解析字幕 → 生成结构化摘要
→ 输出:核心观点 + 关键时间点 + 适合人群

💼 案例 2:推荐视频

用户:推荐一些最新的 DeepSeek 使用技巧视频

小马 → bilibili-agent 搜索 "DeepSeek 技巧"
→ 返回 Top 10:标题/UP主/播放量/简介
→ 按相关度排序推荐

19. youtube-content YouTube 提取

功能:提取 YouTube 字幕、生成摘要、转写为博客。

youtube-content 处理 https://youtube.com/watch?v=xxx:
  → 提取字幕 → 翻译 → 生成中英文摘要 → 导出 Markdown

🎨 第八章:创意设计

20. architecture-diagram 架构图

功能:生成深色主题 SVG 架构图——云架构、基础设施、系统拓扑。以 HTML 输出。

💼 案例

用户:画一张 Hermes 的系统架构图

小马 → 加载 architecture-diagram
→ 生成 SVG:
  ┌──────────────────────────────┐
  │  微信 / 企微 / Telegram      │  ← 消息平台
  ├──────────────────────────────┤
  │       Hermes Gateway         │  ← 网关层
  ├──────────────────────────────┤
  │  Agent Core (DeepSeek V4)    │  ← 核心引擎
  ├────┬────┬────┬────┬──────────┤
  │内存│技能│搜索│工具│...        │  ← 能力层
  └────┴────┴────┴────┴──────────┘
→ 保存为 HTML,可直接在浏览器打开

21. concept-diagrams 概念图

功能:教育类 SVG 图表。物理、化学、数学、解剖、楼层平面图等。9种语义配色+自动暗模式。

22. excalidraw 手绘风图

功能:手绘风格图表——架构图、流程图、时序图、思维导图。

excalidraw 画一张"用户通过微信使用 Hermes 的完整流程":

23. manim-video 数学动画

功能:3Blue1Brown 风格的数学/算法动画视频(Manim CE)。

24. baoyu-infographic 信息图

功能:21种布局×21种风格的信息图/数据可视化。

🤖 第九章:AI/ML 模型

25. whisper 语音识别

功能:OpenAI Whisper 语音识别。支持 99 种语言,6种模型(tiny~large)。

whisper 转写 "会议录音.mp3" → 中文 → 输出文本

26. stable-diffusion-image-generation 图片生成

功能:Stable Diffusion 文生图、图生图、修复。

stable-diffusion 生成:"一座未来城市,赛博朋克风格,霓虹灯,雨天"

🛡️ 第十章:安全审计

27. audit-website 网站审计

功能:审计网站 SEO、性能、安全、技术、内容等 15 个类别、230+ 规则。使用 squirrelscan CLI。

💼 案例

用户:帮我校验大地公司官网有哪些问题

小马 → 加载 audit-website
→ squirrelscan https://大地测绘.com
→ 输出报告:
   SEO:5个缺失的 meta description、2个重复标题
   性能:首页 4.2MB(建议压缩图片)、TTFB 1.8s
   安全:1个失效的 SSL 证书、2个未使用 HTTPS 的资源
   可访问性:6个缺失 alt 的图片
→ 按优先级排序修复建议

28. CSO / Chief Strategy Officer 安全审计

功能:领导安全战略——竞争分析、战略规划、增长路线图、业务组合管理。

29. oss-forensics 开源法证

功能:GitHub 供应链调查、证据恢复、法证分析。恢复已删除提交、检测 force-push。

📊 第十一章:决策与规划

30. one-three-one-rule 1-3-1 决策框架

功能:结构化技术决策框架——1个问题、3个方案(含利弊)、1个推荐方案。

💼 案例

用户:该选 DeepSeek V4 Pro 还是 Flash?

小马 → 加载 one-three-one-rule
→ 1 问题:日常编程辅助选哪个模型?
→ 3 方案:
   A. 全用 Pro — 推理最强,但贵 4 倍、慢 2 倍
   B. 全用 Flash — 快省,但复杂推理会翻车
   C. 混用 — Flash 日常 + Pro 按需切换
→ 1 推荐:方案 C。理由:性价比最优,切模型只需 /model 命令
→ 实施:默认 Flash,遇到复杂任务手动切 Pro

31. plan 计划模式

功能:编写 Markdown 计划到 .hermes/plans/,不执行。

plan "为大地公司搭建内部知识库":
  1. 需求分析
  2. 选型对比(Notion vs 语雀 vs 飞书)
  3. 实施步骤(分 3 阶段)
  4. 风险评估
  5. 预算估算

📋 技能速查表

类别技能一句话
🏗️ 核心hermes-agent配置、诊断、管理 Hermes 自身
🧠 核心memory跨会话持久化记忆 + 历史搜索
🔍 搜索web_search / parallel-cli联网搜索主力
🔍 搜索duckduckgo-search免费英文搜索(中文会被墙)
🌐 搜索browser / agent-browserChrome 浏览器自动化
📝 笔记notion / getnoteNotion 知识库 + Get笔记随手记
📝 笔记dual-sync一键双平台同步
📄 文档docx / powerpointWord + PPT 生成
💻 开发github-pr-workflowPR 全生命周期
💻 开发github-code-review代码审查 + 行内评论
⚙️ 运维china-cloud-deployment中国云服务器部署
⚙️ 运维docker-managementDocker 全生命周期
🎬 媒体bilibili-agentB站视频解析+摘要
🎬 媒体youtube-contentYouTube 字幕提取+翻译
🎨 设计architecture-diagram深色主题 SVG 架构图
🎨 设计excalidraw手绘风图表
🎨 设计baoyu-infographic信息图(21×21种组合)
🤖 AIwhisper语音识别(99种语言)
🤖 AIstable-diffusion文生图
🛡️ 安全audit-website网站 230+规则审计
📊 决策one-three-one-rule1-3-1 结构化决策
📊 决策plan计划模式(只写不执行)