# 创建 DeepSeek v4 Pro 专属 Hermes Agent 操作文档

## 目标

创建一个独立的 Hermes Agent 实例（profile），专门使用 DeepSeek v4 Pro 模型。

---

## 前置条件

- 已安装 Hermes Agent（当前已有 MiniMax-M2.7 实例运行中）
- 拥有 DeepSeek API Key（格式：`sk-xxxx`，当前 Key：余额 100 CNY）

---

## 当前 Profile 列表

```
  Profile          Model              Gateway
  ─────────────────────────────────────────────
  default          MiniMax-M2.7       running
  dev-agent        —                  running
  pm-agent         —                  stopped
  zone-a           —                  stopped
  zone-b           —                  stopped
```

---

## 操作步骤

### 方式一：使用 CLI 命令（推荐）

#### Step 1：创建 Profile

```bash
hermes profile create deepseek-agent
```

#### Step 2：配置 DeepSeek v4 Pro

进入新 profile 并配置模型：

```bash
# 进入该 profile 的配置目录
hermes profile use deepseek-agent

# 设置模型为 DeepSeek v4 Pro
hermes config set model.default deepseek/deepseek-v4-pro

# 设置 Provider
hermes config set model.provider deepseek

# 设置 Base URL（DeepSeek API 专用端点）
hermes config set model.base_url https://api.deepseek.com

# 设置 API Key
# 方法A：命令行设置
hermes config set model.api_key sk-cd88d58f003f4971a73f21954835137d

# 方法B：直接编辑 .env 文件
echo "DEEPSEEK_API_KEY=sk-cd88d58f003f4971a73f21954835137d" >> ~/.hermes/.env
```

#### Step 3：验证配置

```bash
# 检查配置是否正确
hermes doctor

# 或者直接启动新 agent 测试
hermes chat -p deepseek-agent -q "你好，测试一下"
```

#### Step 4：启动 Gateway（可选，让它可以接收消息）

```bash
hermes profile use deepseek-agent
hermes gateway start
```

---

### 方式二：手动编辑配置文件

如果 CLI 命令有问题，可以直接操作配置文件：

#### Step 1：创建 Profile 目录

```bash
mkdir -p ~/.hermes/profiles/deepseek-agent
```

#### Step 2：创建 Profile 专属 config.yaml

```bash
cat > ~/.hermes/profiles/deepseek-agent/config.yaml << 'EOF'
model:
  default: deepseek/deepseek-v4-pro
  provider: deepseek
  base_url: https://api.deepseek.com
  api_key: sk-cd88d58f003f4971a73f21954835137d
  context_length: 64000

agent:
  max_turns: 90

display:
  personality: kawaii
  reasoning: medium

compression:
  enabled: true
  threshold: 0.50
  target_ratio: 0.20

terminal:
  backend: local
  cwd: .
  timeout: 180

security:
  redact_secrets: true

memory:
  memory_enabled: true
  user_profile_enabled: true
EOF
```

#### Step 3：创建 Profile 目录结构

```bash
mkdir -p ~/.hermes/profiles/deepseek-agent/sessions
mkdir -p ~/.hermes/profiles/deepseek-agent/skills
```

#### Step 4：注册 Profile

```bash
hermes profile list
# 应该能看到 deepseek-agent 了
```

---

## 启动和使用

### 启动新 Agent（独立窗口）

```bash
# 方式A：使用 profile 名称
hermes chat -p deepseek-agent

# 方式B：使用 profile 别名（如果设置了）
deepseek-agent

# 方式C：在 tmux 中运行
tmux new-session -d -s deepseek -x 120 -y 40 'hermes -p deepseek-agent'
```

### 启动为 Gateway（后台服务，接收消息）

```bash
# 在 deepseek-agent profile 下启动
hermes profile use deepseek-agent
hermes gateway start

# 检查状态
hermes gateway status
```

### 从当前 Agent 派生任务（快速调用）

如果你只需要偶尔用 DeepSeek 处理任务，不需要单独启动，可以直接用 delegate_task：

```
从当前 MiniMax-M2.7 Agent 派生：
goal: "使用 DeepSeek v4 Pro 完成XXX任务"
model: deepseek-v4-pro
```

---

## 配置文件位置

```
~/.hermes/
├── config.yaml              # 主配置（default profile）
├── .env                     # API Keys
├── profiles/
│   ├── default/             # MiniMax-M2.7
│   ├── deepseek-agent/      # 新建的 DeepSeek v4 Pro
│   │   └── config.yaml
│   └── ...
└── sessions/               # 对话历史
```

---

## 多 Agent 并行运行示例

如果需要同时运行多个 Agent（MiniMax + DeepSeek）：

```bash
# Agent 1: MiniMax-M2.7 (已存在，假设用 tmux)
tmux new-session -d -s minimax 'hermes'

# Agent 2: DeepSeek v4 Pro (新建)
tmux new-session -d -s deepseek 'hermes -p deepseek-agent'

# Agent 3: 另一个独立 Agent
tmux new-session -d -s dev 'hermes -p dev-agent'
```

查看所有运行中的 Agent：
```bash
tmux list-sessions
```

---

## 常见问题

### Q: 提示 "Model not found" 或 "Invalid API Key"

**检查：**
1. API Key 是否正确（以 `sk-` 开头）
2. Key 余额是否充足（DeepSeek API Key 余额 100 CNY）
3. base_url 是否设置为 `https://api.deepseek.com`

**修复：**
```bash
hermes config set model.api_key sk-cd88d58f003f4971a73f21954835137d
hermes config set model.base_url https://api.deepseek.com
```

### Q: DeepSeek 模型回答很慢

**原因：** DeepSeek v4 Pro 开启了思考模式（Reasoning），会先推理再回答。

**解决方案：**
```bash
# 关闭思考模式
hermes config set display.reasoning off

# 或设置为 minimal
hermes config set display.reasoning minimal
```

### Q: 想在一条命令里直接指定使用 DeepSeek

```bash
hermes chat -m deepseek/deepseek-v4-pro --provider deepseek -q "你的问题"
```

---

## DeepSeek v4 Pro 特点

| 特性 | 说明 |
|------|------|
| 思考模式 | 支持 CoT 推理，可开启/关闭 |
| 工具调用 | 支持 function calling、tool use |
| 上下文 | 64K tokens |
| API 端点 | `https://api.deepseek.com` |
| 当前余额 | 100 CNY |
| 模型名 | `deepseek-v4-pro` 或 `deepseek/deepseek-v4-pro` |

---

## 快速命令汇总

```bash
# 1. 创建 profile
hermes profile create deepseek-agent

# 2. 配置模型
hermes config set model.default deepseek/deepseek-v4-pro
hermes config set model.provider deepseek
hermes config set model.base_url https://api.deepseek.com
hermes config set model.api_key sk-cd88d58f003f4971a73f21954835137d

# 3. 启动测试
hermes chat -p deepseek-agent -q "你好"

# 4. 停止/启动 gateway
hermes gateway stop
hermes gateway start

# 5. 删除 profile（如需重建）
hermes profile delete deepseek-agent
```