
> 环境：Hermes v0.16.0 · WSL (Ubuntu) · Docker Desktop (Windows)
> 模型：deepseek-v4-flash (deepseek)
> 项目：药品库存管理系统（Java + Vue + Docker）

---

## 前言

Hermes Agent 可以创建多个独立角色（profile），每个角色拥有独立的人格、工具集和配置。你可以像项目经理一样，给不同角色分配任务，让它们并行干活。

这篇文章用一个完整的项目实战——**药品库存管理系统**，展示多角色协作的完整流程。

---

## 一、原理：Hermes 多角色协作是怎么工作的

### 1.1 核心概念

在开始之前，先理解几个关键概念：

**Profile（角色配置）**
每个 profile 是一个独立的配置目录，包含自己的模型、工具集、API Key 和人格定义。可以理解成"一个独立的 Hermes 分身"。

```
~/.hermes/profiles/
├── default/        ← 项目经理（你正在对话的这个）
├── developer/      ← 后端开发
├── frontend/       ← 前端开发
├── tester/         ← 测试
└── ops/            ← 运维
```

**项目经理（default）**
你正在聊天的这个 Hermes 会话就是项目经理。项目经理负责拆解需求、创建角色、分配任务、检查进度、修复问题。所有子角色由项目经理来指挥和协调。

**SOUL.md（人格文件）**
每个 profile【.hermes\profiles】 目录下有一个 `SOUL.md` 文件，定义了角色的行为方式。告诉角色"你是谁"、"怎么干活"、"输出什么"。

**tmux 通信**
子角色运行在独立的 tmux 终端会话中。项目经理通过 `tmux send-keys` 向子角色发送指令，通过 `tmux capture-pane` 查看子角色的输出。

### 1.2 协作流程

```
你（提需求）
    │
    ▼
项目经理（default）── 拆需求、创建角色、派任务、查进度、修问题
    │
    ├── developer   → 收到任务 → 自动写代码 → 编译 → 报告完成
    ├── frontend    → 收到任务 → 自动写页面 → 联调 → 报告完成
    ├── tester      → 收到任务 → 写测试用例 → 跑测试 → 报告结果
    └── ops         → 收到任务 → 写 Docker 配置 → 构建 → 部署
```

项目经理不需要手动干预每个角色的工作细节，只需要派发任务、检查结果、处理异常。

---

## 二、实操：创建角色

### 2.1 项目经理创建 Profile

在 Hermes 会话里，直接执行创建命令：

```bash
hermes profile create developer --clone-from default
hermes profile create frontend --clone-from default
hermes profile create tester --clone-from default
hermes profile create ops --clone-from default
```

`--clone-from default` 表示从当前项目经理的配置克隆，省去重复设置 API Key 和模型。

创建后用 `hermes profile list` 确认：

```
Profile      Model              Gateway      Alias
◆default     deepseek-v4-flash  running      —
developer    deepseek-v4-flash  stopped      developer
frontend     deepseek-v4-flash  stopped      frontend
tester       deepseek-v4-flash  stopped      tester
ops          deepseek-v4-flash  stopped      ops
```

每个 profile 生成后会自动创建包装脚本，在终端直接输角色名就能启动：
```bash
developer    # 启动 developer 角色
frontend     # 启动 frontend 角色
tester       # 启动 tester 角色
ops          # 启动 ops 角色
```

### 2.2 配置人格（SOUL.md）

角色创建后，项目经理需要告诉每个角色它该用什么风格工作。在各自的 `~/.hermes/profiles/<角色名>/SOUL.md` 中编写人格定义。

**developer 的 SOUL.md**：
```
You are a senior Java backend developer.
- Write production-ready code with proper package structure
- Use MyBatis (XML mapper + annotations)
- Output working code, not pseudocode
- Work directory: ~/projects/drug-inventory/backend/
```

**ops 的 SOUL.md**：
```
You are a DevOps engineer.
- Always give exact commands, not descriptions
- Prefer alpine-based images for small size
- Include health checks in docker-compose
```

核心原则：告诉角色**输出什么**、**在哪输出**、**用什么风格**。SOUL.md 可以用中文也可以用英文，效果一样。

---

## 三、实操：启动与调度

### 3.1 用 tmux 启动角色

每个角色需要独立的终端进程。项目经理在 shell 中用 tmux 创建后台会话：

```bash
tmux new-session -d -s developer -x 120 -y 40 'developer'
tmux new-session -d -s frontend -x 120 -y 40 'frontend'
```

使用 `tmux ls` 确认角色已启动：

```
developer: 1 windows
frontend: 1 windows
```

### 3.2 给角色派发任务

Hermes 使用 prompt_toolkit，刚启动时需要几秒初始化。项目经理发消息前要等 8 秒：

```bash
sleep 8 && tmux send-keys -t developer '你的任务描述' Enter
```

**实际派发的任务原文**：

developer 收到的任务：
```
请在 ~/projects/drug-inventory/backend/ 下创建完整的 Spring Boot + MyBatis + H2 项目，
实现所有 API 接口（药品 CRUD + 出入库 + 预警）。先建 Maven 项目结构，再写代码。
```

frontend 收到的任务：
```
请在 ~/projects/drug-inventory/frontend/ 下创建 Vue 3 + Vite 项目。
需要实现：药品列表页、新增/编辑表单、入库出库操作、预警高亮显示。
后端 API 在 http://localhost:8080/api。
```

### 3.3 查看进度

项目经理通过 capture-pane 查看各角色的实时输出：

```bash
tmux capture-pane -t developer -p | tail -20
```

developer 正在写代码时的输出：

```
 write  backend/src/main/java/.../DrugController.java
 write  backend/src/main/java/.../DrugService.java
 write  backend/src/main/resources/mapper/DrugMapper.xml
 cd backend && mvn compile -q
```

角色会自动创建目录结构、写代码、编译，完全不需要项目经理手动干预。

### 3.4 任务依赖与并行策略

```
时间线 →
─────────────────────────────────────────────────────────
developer  ████████████████████████████████░░░░░░░░░░░░░
frontend   ████████████████████████████████████████████
tester     ░░░░░░░░░░░░░░░░░████████████████░░░░░░░░░░░
ops        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░████████████████
           ↑                ↑                ↑
        并行开发         测试介入        Docker 部署
```

- **developer + frontend**：可以同时启动，互不依赖
- **tester**：等 developer 写完 API 才能跑测试
- **ops**：等 JAR 包和前端页面都完成才能构建镜像

### 3.5 项目经理的协调工作

开发过程中项目经理遇到并处理了这些问题：

- **Maven 编译超时**：首次下载 Spring Boot 依赖太慢 → 配置阿里云镜像加速
- **安全弹窗卡住**：角色执行 curl 时会弹出确认框 → 发 `1` 指令确认
- **任务时序**：developer 完成后才启动 tester，避免测试跑空

---

## 四、实战成果
![image.png](https://developer.qcloudimg.com/http-save/yehe-4827807/dd42247990ad0933b74f1ae4d9be253e.png)
### 4.1 developer — 9 个 API

```
backend/src/main/java/com/example/drug/
├── DrugApplication.java
├── controller/DrugController.java
├── service/ → impl/DrugServiceImpl.java
├── repository/DrugMapper.java, InventoryLogMapper.java
├── entity/Drug.java, InventoryLog.java
├── dto/ (6 个请求/响应 DTO)
└── config/GlobalExceptionHandler.java
```

| 方法 | 路径 | 功能 |
|------|------|------|
| GET | /api/drugs | 药品列表（分页+搜索） |
| GET | /api/drugs/warnings | 预警药品 |
| GET | /api/drugs/{id} | 药品详情 |
| POST | /api/drugs | 新增药品 |
| PUT | /api/drugs/{id} | 编辑药品 |
| DELETE | /api/drugs/{id} | 逻辑删除 |
| POST | /api/drugs/{id}/inbound | 入库 |
| POST | /api/drugs/{id}/outbound | 出库 |
| GET | /api/drugs/{id}/logs | 出入库流水 |

每条 API 均通过 curl 端点测试，种子数据含 5 条常用药品。

### 4.2 frontend — 4 个页面

```
frontend/src/views/
├── DrugList.vue       # 药品列表（分页、搜索、预警高亮、过期检测）
├── DrugForm.vue       # 新增/编辑药品
├── InboundForm.vue    # 入库操作
└── OutboundForm.vue   # 出库操作（含库存校验）
```

Vite 配置了 `/api` 代理到后端 `localhost:8080`，开发联调零配置。

### 4.3 tester — 38 个测试全部通过

| 类别 | 用例数 | 内容 |
|------|--------|------|
| CRUD 操作 | 12 | 创建、查询、分页、更新、删除 |
| 出入库操作 | 12 | 入库、出库、库存不足、流水记录 |
| 库存预警 | 7 | 阈值检测、出入库触发预警 |
| 边界情况 | 9 | 负数、过期、null、超长名、零库存 |

```
Tests run: 38, Failures: 0, Errors: 0
```

### 4.4 ops — Docker 部署

```bash
docker ps
```

```
NAMES                      STATUS                        PORTS
drug-inventory-backend    Up About a minute   0.0.0.0:8080->8080/tcp
drug-inventory-frontend   Up About a minute   0.0.0.0:80->80/tcp
```

| 地址 | 说明 |
|------|------|
| http://localhost:80 | 前端管理页面 |
| http://localhost:8080/api/drugs | 后端 API |
| http://localhost:8080/h2-console | H2 数据库控制台 |

### 4.5 项目经理的故障排查

项目上线后遇到两个问题，项目经理定位并修复：

**问题 1：前端页面空白**
后端 API 返回 200 有数据，但前端什么也不显示。原因是前后端数据格式不匹配。后端返回 `{ code, data: { list, page, total, totalPages } }`，前端却按 `{ content, totalElements }` 解析。修复了 Vue 组件的解析逻辑。

**问题 2：OFFSET 负数报错**
H2 报 `Invalid value "-10" for parameter "result OFFSET"`。前端传 page=0，后端算出 `(0-1)*10 = -10`。在 Service 层加了一行校验：`if (page < 1) page = 1`。

---

## 五、踩坑记录

### 坑 1：tmux 发消息时机

Hermes 刚启动时还没初始化完成，立即发消息会被吞掉。

```bash
# 消息丢失
tmux send-keys -t developer '任务' Enter

# 等 8 秒
sleep 8 && tmux send-keys -t developer '任务' Enter
```

### 坑 2：安全确认弹窗

角色执行 curl 等命令时，Hermes 安全机制会弹出确认框。需要用 send-keys 发 `1` 确认。

### 坑 3：WSL + Docker Desktop

Docker Desktop 安装在 Windows 上，WSL 中没有原生 docker 命令。

```bash
# 用完整路径
"/mnt/c/Program Files/Docker/Docker/resources/bin/docker.exe" compose up -d
```

或者在 Docker Desktop 设置中开启 WSL 集成（推荐）。

### 坑 4：Docker 构建前端失败

`node_modules` 会导致 Docker 构建上下文过大。需要在 frontend 目录下创建 `.dockerignore`：

```
node_modules
```

另外 `npm ci --only=production` 不会安装 vite 等构建工具，需改为 `npm ci`。

### 坑 5：前后端数据格式不匹配

项目经理排查确认后端返回格式后，修改前端解析逻辑解决。


---

## 六、总结

| 角色 | 代码量 | 耗时 | 产出 |
|------|--------|------|------|
| **项目经理 (default)** | 全程指挥 | ~5 分钟 | 需求文档、创建角色、任务协调、故障排查 |
| developer | ~800 行 Java | ~15 分钟 | 9 个 API + 数据库表 |
| frontend | ~500 行 Vue | ~10 分钟 | 4 个完整页面 |
| tester | ~300 行 Java | ~15 分钟 | 38 个测试用例 |
| ops | ~50 行配置 | ~8 分钟 | 2 个 Dockerfile + docker-compose |

**核心公式**：`1 个项目经理 + N 个角色 = 完整项目交付`

项目经理（default 会话）是整个协作的核心——**创建角色、配置人格、分配任务、检查进度、修复问题**，全部由项目经理在同一个 Hermes 会话中完成。子角色只需要收到任务后自动执行即可。

多角色协作适用场景：
- Web 全栈开发：developer + frontend + tester + ops
- 数据分析：data（Hadoop/Spark）+ dev + ops
- 代码审查：analyzer + reviewer + reporter
- 项目重构：architect + developer + tester

---


环境：Hermes v0.16.0 · WSL (Ubuntu) · Docker Desktop (Windows) 模型：deepseek-v4-flash (deepseek) 项目：药品库存管理系统（Java + Vue + Docker）

Hermes 多角色协作实战

Hermes 多角色协作实战：从零开发药品库存管理系统

软件开发工程师

编程语言

开发工具

后端

本文通过药品库存管理系统项目实战，详细展示了HermesAgent多角色协作开发流程。从项目经理创建角色、配置人格、分配任务，到开发、测试、运维各角色并行工作，最终实现前后端完整功能。涵盖SpringBoot+Vue+Docker技术栈，包含9个API接口、4个前端页面、38个测试用例，并解决了开发过程中的典型问题。

数据分析

代码解释

数据库

Windows

Docker

Hadoop 

Ubuntu

Spark 

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Hermes 多角色协作实战-腾讯云开发者社区-腾讯云

Hermes 多角色协作实战

Hermes 多角色协作实战

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐