GitShelf — GitHub 项目目录

项目概述

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 下载最新安装包，支持 Windows、macOS、Linux。

npm

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

打开 http://localhost:8648

Docker Compose

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

打开 http://localhost:6060

典型使用方法

启动服务：使用桌面应用、npm 或 Docker 启动 Hermes Studio。
登录：默认账号 admin / 123456，首次登录后请修改。
配置模型：在“模型管理”中添加提供商和模型，支持 OpenAI 兼容接口。
创建会话：在聊天界面创建新会话，选择模型和配置文件。
配置平台渠道：在“平台渠道”中配置 Telegram、Discord 等机器人。
创建定时任务：在“定时任务”中创建 Cron 任务。
构建工作流：在“可视化工作流”中拖拽节点，构建自动化流程。
使用编码代理：在“编码代理”中启动 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（基于最新发布版本日期）。

EKKOLearnAI/ekko-studio

项目概览