hermes部署完后的优化调整教程

在 Ubuntu 24.04 上部署 Hermes+DeepSeek 后，核心优化是模型参数调优、网络稳定性、系统资源限制与安全配置；必装技能聚焦文件处理、网页搜索、命令行/自动化、写作与总结四类。下面直接给可落地的配置与清单。

一、默认配置必改优化（Ubuntu 24.04 + DeepSeek）

1. 基础环境与依赖优化（避坑）

Ubuntu 24.04 默认 Python 3.12，Hermes 官方适配 3.11，必须锁定版本并补依赖：

# 1. 安装系统依赖
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl wget python3-pip python3-venv python3-dev \
  build-essential libffi-dev libssl-dev ffmpeg libsm6 libxext6

# 2. 创建 Python 3.11 虚拟环境（关键）
python3.11 -m venv ~/hermes-venv
source ~/hermes-venv/bin/activate

# 3. 重装 Hermes 到该环境（避免系统 Python 冲突）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

2. DeepSeek 模型配置（config.yaml 核心）

路径：~/.hermes/config.yaml，直接覆盖默认：

model:
  provider: deepseek
  default: deepseek-v4-flash  # 日常用 Flash（快、便宜）
  model: deepseek-v4-flash
  base_url: https://api.deepseek.com/v1
  api_key: ${DEEPSEEK_API_KEY}  # 从 .env 读取，不硬编码
  # 推理参数优化
  default_params:
    temperature: 0.7    # 平衡创造力/稳定性
    top_p: 0.9
    frequency_penalty: 0.1
    presence_penalty: 0.1
    max_tokens: 4096   # 输出上限，避免超长
    stream: true
  # 复杂任务自动切 Pro+思考模式
  fallback:
    model: deepseek-v4-pro
    thinking:
      type: enabled
      reasoning_effort: high  # high/max，复杂任务自动升 max

3. 环境变量安全与网络优化

新建/编辑 ~/.hermes/.env（权限设 600）：

# 密钥（必须）
DEEPSEEK_API_KEY=sk-xxx
# 网络优化（国内直连提速）
HERMES_DNS_RESOLVER=223.5.5.5  # 阿里 DNS
HERMES_HTTP_TIMEOUT=120         # 超时从 60 改 120
# 代理（可选，直连不稳时用）
# HTTPS_PROXY=http://127.0.0.1:7890

chmod 600 ~/.hermes/.env  # 防止密钥泄露

4. 系统资源与性能限制（Ubuntu）

# 1. 限制 Hermes 内存（避免 OOM）
echo 'export HERMES_MAX_MEMORY=2G' >> ~/.bashrc
source ~/.bashrc

# 2. 增大文件句柄（高并发技能调用）
echo '* soft nofile 65535' | sudo tee /etc/security/limits.conf
echo '* hard nofile 65535' | sudo tee /etc/security/limits.conf
sudo sysctl -w fs.file-max=65535

5. 持久化与自启动（systemd）

sudo nano /etc/systemd/system/hermes.service

写入：

[Unit]
Description=Hermes Agent
After=network.target

[Service]
User=$USER
WorkingDirectory=/home/$USER
ExecStart=/home/$USER/hermes-venv/bin/hermes start
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable hermes
sudo systemctl start hermes

二、必装技能清单（直接可用，按优先级）

🔧 核心必装（5 个，无争议）

1. pdf-reader：PDF 解读、合同/政策提取、划重点

   hermes skill install pdf-reader

2. web-search：网页搜索、实时信息、查政策/文档

   hermes skill install web-search

3. bash：命令行执行、文件操作、系统管理（兜底能力）

   hermes skill install bash

4. document-writer：公文/周报/报告生成、格式规范

   hermes skill install document-writer

5. task-scheduler：定时任务、自动化流程、周期提醒

   hermes skill install task-scheduler

✅ 高频推荐（按需装）

• obsidian-notes：Obsidian 知识库读写、整理笔记
• ppt-generator：一键生成 PPT、大纲转幻灯片
• code-interpreter：Python 代码执行、数据分析、图表生成
• email-sender：邮件发送、模板生成、自动回复

三、验证与测试（改完必做）

# 1. 检查环境全绿
hermes doctor

# 2. 测试 DeepSeek 连通性
hermes model test deepseek

# 3. 测试技能调用
hermes run "解读 ~/test.pdf 并总结核心观点"
hermes run "搜索 2026 年 DeepSeek 最新模型"

四、避坑要点

• 不要硬编码 API Key：统一放 .env 并设 600 权限
• 国内网络优先用 DNS 优化：直连不稳再考虑代理
• 模型选择：日常用 deepseek-v4-flash，复杂任务自动切 v4-pro
• Python 版本：必须 3.11，否则依赖编译报错