## 项目概述

Hermes Studio 是 Hermes Agent 的桌面应用、本地运行时和 Web 控制台，提供多平台 AI 聊天、会话管理、定时任务、使用量分析等功能。它支持与 Hermes Agent 进行对话、构建可视化工作流、管理模型和配置文件，并保持所有数据本地化。项目以 TypeScript 为主要语言，采用 Vue 3 技术栈，可通过桌面应用、npm CLI 或 Docker 镜像部署。

## 核心功能

- **AI 聊天**：实时流式聊天、多会话管理、本地 SQLite 会话存储、Markdown 渲染、工具调用详情、文件上传与下载、内联预览。
- **平台渠道**：统一配置 Telegram、Discord、Slack、WhatsApp、Matrix、飞书、钉钉、QQBot、微信、企业微信等 10 个平台。
- **使用量分析**：Token 用量统计、会话数、成本估算、模型分布、30 天趋势。
- **定时任务**：创建、编辑、暂停、恢复、删除 Cron 任务，支持立即执行。
- **看板**：基于配置文件的看板，用于规划和跟踪代理工作。
- **可视化工作流**：Vue Flow 画布，支持 Hermes、Codex、Claude Code 节点，条件分支、循环、审批门等。
- **模型管理**：自动发现模型、增删改提供商、OAuth/设备流登录、模型分组与别名。
- **多配置文件**：创建、克隆、导入导出配置文件，支持账户绑定。
- **文件浏览器**：浏览远程后端（本地、Docker、SSH、Singularity）文件，支持上传下载等操作。
- **群聊**：多代理聊天室，@提及路由、上下文压缩、实时消息。
- **编码代理**：安装、配置、启动和监控 Claude Code 和 Codex。
- **桌面代理浏览器**：桌面端多标签浏览器，代理可通过 MCP 服务器导航。
- **技能与记忆**：浏览、搜索、安装技能包，管理用户笔记和代理记忆。
- **主题定制**：明暗模式、界面风格、字体大小、颜色等。
- **日志**：查看代理/服务器/错误日志，支持过滤和结构化解析。
- **管理与运行时**：设备发现、MCP 管理器、运行时版本预览、性能监控。
- **认证**：基于 Token 或用户名密码登录，支持超级管理员和普通管理员。
- **设置**：显示、代理、记忆、会话重置、隐私、模型等设置。
- **语音/TTS/STT**：管理语音提供商，支持多种 TTS/STT 适配器。
- **Web 终端**：集成终端，支持多会话和实时输入输出。
- **桌面应用与更新**：Electron 原生壳，自动更新。

## 适用与不适用场景

**适用场景**：

- 需要本地化、自托管的 AI 代理管理平台。
- 需要统一管理多个平台（如 Telegram、Discord）的 AI 聊天机器人。
- 需要可视化构建和运行 AI 工作流。
- 需要管理多个模型提供商和配置文件。
- 需要监控 AI 使用量和成本。
- 需要集成编码代理（Claude Code、Codex）进行开发辅助。

**不适用场景**：

- 需要全双工实时语音对话（项目明确不支持）。
- 需要电话集成或始终开启的唤醒词监听。
- 需要完全托管的云服务（项目定位为自托管）。
- 需要非本地化的数据存储（项目强调本地优先）。

## 技术架构与依赖

- **前端**：Vue 3、TypeScript、Vite、Naive UI、Pinia、Vue Router、vue-i18n、SCSS、markdown-it、highlight.js。
- **后端**：Koa 2（BFF 服务器）、node-pty（Web 终端）。
- **实时通信**：Socket.IO。
- **数据库**：SQLite（本地会话存储）。
- **桌面**：Electron。
- **其他**：Hermes Agent 桥接、MCP 服务器、Docker。

## 安装与快速开始

### 桌面应用（推荐）

从 [GitHub Releases](https://github.com/EKKOLearnAI/hermes-studio/releases/latest) 下载最新安装包，支持 Windows、macOS、Linux。

### npm

```bash
npm install -g hermes-web-ui
hermes-web-ui start
```

打开 http://localhost:8648

### Docker Compose

```bash
WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d
```

打开 http://localhost:6060

## 典型使用方法

1. **启动服务**：使用桌面应用、npm 或 Docker 启动 Hermes Studio。
2. **登录**：默认账号 `admin` / `123456`，首次登录后请修改。
3. **配置模型**：在“模型管理”中添加提供商和模型，支持 OpenAI 兼容接口。
4. **创建会话**：在聊天界面创建新会话，选择模型和配置文件。
5. **配置平台渠道**：在“平台渠道”中配置 Telegram、Discord 等机器人。
6. **创建定时任务**：在“定时任务”中创建 Cron 任务。
7. **构建工作流**：在“可视化工作流”中拖拽节点，构建自动化流程。
8. **使用编码代理**：在“编码代理”中启动 Claude Code 或 Codex。

## 配置与部署要点

- **环境变量**：支持 `PORT`、`BIND_HOST`、`HERMES_WEB_UI_HOME`、`AUTH_TOKEN` 等大量环境变量，详见 README。
- **数据存储**：Hermes 数据默认存储在 `~/.hermes`（Windows 为 `%LOCALAPPDATA%\hermes`），Web UI 状态存储在 `~/.hermes-web-ui`。
- **认证**：默认 Token 自动生成，可通过 `AUTH_TOKEN` 设置。
- **Docker 部署**：数据持久化在 `./hermes_data`，认证 Token 存储在 `./hermes_data/hermes-web-ui/.token`。
- **桌面更新**：优先使用 Cloudflare 下载端点，失败时回退到 GitHub Releases。

## 限制、风险与许可证

- **限制**：不支持全双工语音、电话集成、唤醒词监听；外部代理请求的会话绑定尚未实现。
- **风险**：默认凭据 `admin` / `123456` 需立即修改；自托管需自行保障安全。
- **许可证**：BSL-1.1（Business Source License 1.1），覆盖 Hermes Studio、hermes-web-ui npm 包、桌面应用等。

## 官方链接

- GitHub 仓库：https://github.com/EKKOLearnAI/hermes-studio
- 文档：https://hermes-studio.ai/#/docs/getting-started
- npm 包：https://www.npmjs.com/package/hermes-web-ui
- 最新版本：https://github.com/EKKOLearnAI/hermes-studio/releases/tag/v0.6.40

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README、文档目录（docs/）、最新发布信息。
- 分析时间：2026-08-10（基于最新发布版本日期）。