# 推薦方式：通過官方腳本安裝（自動跟蹤最新版本）
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# 或使用源碼安裝（適合開發(fā)者）
git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
./setup-hermes.sh

# 交互式配置向?qū)Вㄍ扑]首次運行）
hermes setup

# 配置/切換模型和提供商（如 OpenAI、Anthropic、本地 Ollama 等）
hermes model

# 診斷配置和依賴問題
hermes doctor

# 查看 Agent、認(rèn)證、平臺狀態(tài)
hermes status

# 更新 Hermes 到最新版本
hermes update

# 查看/編輯配置文件
hermes config

hermes model
# 會彈出交互式界面，選擇：
# 1. 提供商：OpenAI
# 2. 模型：gpt-4-turbo
# 3. 設(shè)置 API Key

# 正常啟動（推薦在項目目錄下啟動，當(dāng)前目錄 = 項目根目錄）
hermes

# 或使用現(xiàn)代 TUI 界面
hermes --tui

# 繼續(xù)上一次對話
hermes -c

# 恢復(fù)指定對話（通過會話 ID）
hermes -r <session_id>
# 完整命令：
hermes --resume <session_id>

# 以獨立工作區(qū)啟動（隔離文件，適合并行任務(wù)）
hermes -w

# 單次查詢模式（不進(jìn)入交互式對話）
hermes chat -q "總結(jié)最新的 Git 提交"

# 純腳本模式（只輸出最終答案，無多余內(nèi)容，適合自動化）
hermes -z "生成一個 Python 爬蟲腳本"

hermes chat -q "今天北京的天氣怎么樣？"
# 輸出：北京今天晴轉(zhuǎn)多云，氣溫 15-25°C...

# 將 Hermes 的輸出保存到變量
result=$(hermes -z "生成一個隨機(jī)密碼，長度 16")
echo "你的新密碼是：$result"

# 查詢所有會話歷史
hermes sessions list

# 通過 ID 刪除指定會話
hermes sessions delete <session_id>

# 清理舊對話（交互式確認(rèn)）
hermes sessions prune

# 刪除 1 天前的所有會話（無需確認(rèn)）
hermes sessions prune --older-than 1 --yes

# 刪除 7 天前的所有會話
hermes sessions prune --older-than 7 --yes

# 查看所有會話
hermes sessions list
# 輸出：
# ID: abc123 | 標(biāo)題: 代碼調(diào)試 | 更新時間: 2026-06-10
# ID: def456 | 標(biāo)題: 文章撰寫 | 更新時間: 2026-06-12

# 刪除指定會話
hermes sessions delete abc123

# 批量清理 3 天前的會話
hermes sessions prune --older-than 3 --yes

# 查看日志
hermes logs

# 查看錯誤級別日志
hermes logs --level error

# 查看完整配置
hermes config

# 查看當(dāng)前使用的配置文件路徑
hermes config --show-path

# 備份 Hermes 主目錄到 zip 文件
hermes backup

# 從 zip 文件恢復(fù)備份
hermes import <backup_file.zip>

# 啟動網(wǎng)關(guān)服務(wù)（前提：已配置微信/釘釘/飛書/Telegram 等）
hermes gateway

# 網(wǎng)關(guān)設(shè)置向?qū)?
hermes gateway setup

# 啟動網(wǎng)關(guān)
hermes gateway start

# 查看網(wǎng)關(guān)/平臺狀態(tài)
hermes gateway status

# 1. 先配置 Telegram Bot Token
hermes gateway setup
# 選擇 Telegram，輸入 Bot Token

# 2. 啟動網(wǎng)關(guān)
hermes gateway start

# 現(xiàn)在可以在 Telegram 中與 Hermes 對話了！

# 瀏覽官方技能商店
hermes skills browse

# 搜索技能
hermes skills search <關(guān)鍵詞>

# 安裝指定技能
hermes skills install <skill_name>

# 列出已安裝的技能
hermes skills list

# 更新技能
hermes skills update <skill_name>

# 搜索與 GitHub 相關(guān)的技能
hermes skills search github

# 安裝 GitHub 技能
hermes skills install github

# 現(xiàn)在可以讓 Hermes 幫你管理 GitHub 倉庫了

# 指定 profile（支持多實例）
hermes --profile <name>

# 恢復(fù)指定會話
hermes --resume <session_id>

# 恢復(fù)最近會話
hermes --continue

# 使用隔離 git worktree（適合并行任務(wù)）
hermes --worktree

# 跳過危險命令確認(rèn)（謹(jǐn)慎使用）
hermes --yolo

# 安靜模式（適合腳本）
hermes --quiet

# 新建會話（清空上下文），可帶標(biāo)題
/new
/new 我的項目討論

# 重置會話（同 /new）
/reset

# 清屏并開啟新會話（對話不變，只是屏幕清理干凈）
/clear

# 恢復(fù)指定會話
/resume <session_id>
/resume <會話標(biāo)題>

# 瀏覽所有會話
/sessions

# 設(shè)置當(dāng)前會話標(biāo)題
/title 項目A代碼審查

# 查看對話歷史
/history

# 保存當(dāng)前對話
/save

# 重新生成上一條回復(fù)
/retry

# 撤銷上一輪對話
/undo

# 手動壓縮上下文（節(jié)省 token）
/compress

# 回滾文件檢查點（代碼改壞了可回滾）
/rollback

# 退出（可刪除當(dāng)前會話記錄）
/quit
/quit --delete

用戶：hermes
Hermes：你好！有什么可以幫你的？

用戶：/new Python 教程
Hermes：已創(chuàng)建新會話"Python 教程"。

用戶：幫我寫一個快速排序算法
Hermes：[生成代碼...]

用戶：/undo
Hermes：已撤銷上一輪對話。

用戶：/history
Hermes：顯示當(dāng)前會話的歷史記錄...

# 場景：昨天討論了一半的項目，今天繼續(xù)
用戶：hermes
Hermes：你好！

用戶：/sessions
Hermes：
  1. Python 教程 (ID: abc123)
  2. 代碼調(diào)試 (ID: def456)

用戶：/resume abc123
Hermes：已恢復(fù)會話"Python 教程"，我們上次討論到了...

# 切換模型（支持 --global 持久化）
/model
/model gpt-4-turbo
/model claude-3-opus --global

# 查看當(dāng)前使用的模型
/model

# 切換快速模式（省 token，響應(yīng)更快）
/fast fast

# 切換回正常模式
/fast normal

# 調(diào)整推理強(qiáng)度
/reasoning low
/reasoning medium
/reasoning high

# 切換自動批準(zhǔn)危險命令
/yolo

# 調(diào)整工具輸出詳細(xì)程度
/verbose

# 代碼生成任務(wù)：使用 GPT-4
/model gpt-4-turbo

# 創(chuàng)意寫作任務(wù)：使用 Claude
/model claude-3-opus

# 簡單查詢?nèi)蝿?wù)：使用快速模式
/fast fast

# 列出可用工具
/tools

# 啟用/禁用工具
/tools enable <tool_name>
/tools disable <tool_name>

# 列出工具集
/toolsets

# 技能管理
/skills
/skills install <skill_name>
/skills search <keyword>

# 重新加載技能或 .env
/reload-skills
/reload

# 瀏覽器工具控制
/browser connect
/browser status

# 定時任務(wù)管理
/cron
/cron list
/cron add <job>

用戶：/skills search docker
Hermes：找到以下技能：
  1. docker-manager（Docker 容器管理）
  2. docker-compose-helper（Docker Compose 配置生成）

用戶：/skills install docker-manager
Hermes：技能安裝成功！

用戶：幫我啟動 Docker 容器 nginx
Hermes：[調(diào)用 docker-manager 技能，執(zhí)行 docker run...]

# 顯示幫助信息
/help

# 查看會話狀態(tài) + 摘要
/status

# 查看 token 使用量和費用
/usage

# 查看使用統(tǒng)計與分析
/insights
/insights 7  # 查看最近 7 天的統(tǒng)計

# 上傳調(diào)試報告（系統(tǒng)信息 + 日志）
/debug

# 查看網(wǎng)關(guān)/平臺狀態(tài)
/platforms
/gateway

用戶：/usage
Hermes：
  本次會話：
    - Prompt tokens: 1,234
    - Completion tokens: 567
    - Total: 1,801 tokens
  今日總計：
    - Total tokens: 15,678
    - 費用（GPT-4）: $0.48

# 后臺任務(wù)
/background
/bg

# 設(shè)置持續(xù)目標(biāo)（支持子目標(biāo)）
/goal 完成項目A的代碼重構(gòu)

# 不中斷當(dāng)前任務(wù)，注入指引
/steer 優(yōu)先處理登錄模塊的重構(gòu)

# 隊列下一條消息（當(dāng)前任務(wù)完成后執(zhí)行）
/queue 生成重構(gòu)后的單元測試

# 會話切換到 Telegram 等平臺
/handoff telegram

用戶：/goal 開發(fā)一個博客系統(tǒng)
Hermes：已設(shè)置目標(biāo)"開發(fā)一個博客系統(tǒng)"。我會幫你分解任務(wù)并逐步完成。

用戶：/steer 先完成數(shù)據(jù)庫設(shè)計
Hermes：收到，我會優(yōu)先處理數(shù)據(jù)庫設(shè)計部分。

[Hermes 自動生成數(shù)據(jù)庫 schema...]

用戶：/queue 完成后幫我生成 ORM 模型
Hermes：已加入隊列，數(shù)據(jù)庫設(shè)計完成后會自動執(zhí)行。

用戶（按 Alt+Enter 換行）：
我想要一個快速排序的實現(xiàn)：
def quicksort(arr):
    if len(arr) <= 1:
        return arr
    # 后面繼續(xù)輸入...

# 開啟語音模式
/voice on

# 錄制語音（按 Ctrl+B 開始/停止錄音）
Ctrl+B

# 關(guān)閉語音模式
/voice off

hermes -s skill1,skill2,skill3

# 啟動 Hermes 并加載 coding、github、docker 技能
hermes -s coding,github,docker

#!/bin/bash
# 示例：自動生成 Git commit message
changes=$(git diff --staged)
commit_msg=$(hermes -z "根據(jù)以下代碼變更生成簡潔的 Git commit message：$changes")
git commit -m "$commit_msg"

hermes model
# 選擇提供商和模型，配置 API Key

hermes
# 進(jìn)入對話后，測試基本功能
你好，請介紹一下你自己

hermes gateway setup
# 選擇 Telegram/Discord/企業(yè)微信等，配置 Token

hermes gateway start
# 現(xiàn)在可以在消息平臺中與 Hermes 對話了

# 在對話中
/skills browse
/skills install <skill_name>

# 在對話中
/goal 完成我的個人博客項目
/steer 先設(shè)計數(shù)據(jù)庫

# 診斷配置和依賴問題
hermes doctor

# 查看錯誤日志
hermes logs --level error

# 查看所有會話
hermes sessions list

# 恢復(fù)指定會話
hermes -r <session_id>

# 重新加載技能
/reload-skills

# 查看已安裝技能
/skills list

# 重新安裝技能
/skills install <skill_name>