# Hermes Workspace

> 仓库地址：https://github.com/outsourc-e/hermes-workspace
> 作者/组织：outsourc-e
> 成熟度：production
> 分析日期：2026-04-15

## 一句话总结
一个集 chat、文件管理、memory 浏览、skills 注册、terminal 于一体的 AI agent Web 工作台，是 Hermes 生态中最完整的 GUI 前端。

## 项目定位与架构
Hermes Workspace 定位为 Hermes Agent 的"命令中心"（command center），不是简单的 chat wrapper，而是一个全功能 workspace。前端基于 Node.js 22+，集成 Monaco editor、PWA 支持和八套主题系统（Official/Classic/Slate/Mono 各含 light/dark 变体）。

架构分为三层：Workspace UI（前端 SPA）、OpenAI-compatible API 中间层、以及可选的 Hermes Gateway 增强层（端口 8642）。这种分层设计允许它连接任意 OpenAI-compatible 后端（如 Ollama、LM Studio、vLLM），同时在接入 Hermes gateway 时解锁完整功能（sessions、memory 持久化、skills 管理、job tracking）。

通信采用 SSE streaming，支持 tool call 渲染和 artifact events。安全方面实现了认证中间件、CSP headers、路径遍历防护和执行审批提示。还支持 Tailscale 集成实现免端口转发的远程访问。

## 关键技术特性
- **双模式运行**：Portable Mode 直连本地推理服务器（基础 chat）；Enhanced Mode 通过 Hermes gateway 解锁全部功能
- **全功能 workspace**：Memory browser（搜索+编辑）、Skills 注册表（2,000+ skills）、文件浏览器（Monaco editor）、跨平台 PTY terminal
- **PWA 支持**：可安装为桌面/移动应用，mobile-first 响应式设计
- **Docker 一键部署**：`docker compose up` 同时启动 gateway 和 workspace
- **多本地模型支持**：Ollama、LM Studio、vLLM、llama.cpp、LocalAI、Atomic Chat

## 设计亮点与创新
渐进式增强（progressive enhancement）的设计哲学非常出色：无需 Hermes gateway 也能用作通用 chat UI，接入 gateway 后逐步解锁高级功能。八套主题系统和 PWA 支持体现了对用户体验的重视。500+ stars 反映了社区认可度。

## 局限性与风险
原生桌面应用（Electron）、model switching、chat cancel 功能仍在开发中。团队协作和云托管版本尚未发布。完整功能依赖 Hermes gateway，而非所有后端都支持其扩展 API。

## 与生态系统的关联
作为 Hermes Agent 生态中最成熟的 Web GUI，与 Mission Control（偏运维编排）互补。可搭配 hermes-agent-docker 或 evey-setup 等部署方案使用。是终端用户与 Hermes Agent 交互的主要入口之一。