1. 项目定位与用途
Hermes Workspace 是 Hermes AI Agent 的原生 Web 工作区，定位为 Agent 的完整命令中心。它提供聊天、文件管理、内存浏览、技能管理和终端访问的一体化界面，通过直接连接 Hermes Agent Gateway 实现实时交互。项目版本为 2.0.0，采用 MIT 许可证，要求 Node.js >= 22.0.0。
项目档案应用项目
Hermes Workspace - Hermes AI Agent 原生 Web 工作区 | 安装与使用指南
outsourc-e/hermes-workspace：Hermes Workspace 是 Hermes AI Agent 的原生 Web 工作区，提供集成的聊天、终端、内存管理、技能浏览和仪表板功本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
Hermes Workspace 是 Hermes AI Agent 的原生 Web 工作区，提供集成的聊天、终端、内存管理、技能浏览和仪表板功能，作为 Agent 的一体化命令中心，通过 SSE 实时流与 Gateway 通信。
中文项目介绍
Hermes Workspace 是专为 Hermes AI Agent 设计的原生 Web 工作区，定位为 Agent 的完整命令中心，而非简单的聊天包装器。
它解决了 AI Agent 操作界面分散的问题，将聊天对话、终端执行、内存浏览、技能管理、任务监控等核心功能整合到单一 Web 界面中。
适用场景包括：与 Hermes Agent 进行实时流式对话、通过集成终端执行命令、浏览和编辑 Agent 长期记忆、探索 2000+ 可用技能、监控任务队列与作业状态，以及通过移动端 PWA 远程访问。
技术特征：基于 React 19 + TanStack Start + Vite 构建，支持 SSR 与静态托管混合架构，内置 Hermes Agent 自动检测逻辑，提供 8 套主题系统（含明暗变体），具备安全加固的 API 访问控制（Auth 中间件、CSP 头、执行审批提示），并支持 SSE 实时流传输与工具调用可视化。
详细信息与使用说明
2. 解决的问题
项目解决了 AI Agent 操作界面分散、功能割裂的问题。传统方案通常仅提供简单聊天包装器，而 Hermes Workspace 提供完整的工作区体验：支持 Agent 编排、内存浏览、技能管理、终端访问和实时监控。它通过 SSE 实时流传输实现 Agent 输出的即时呈现，并通过安全加固的 API 路由（Auth 中间件、CSP 头、执行审批提示）保障交互安全。
3. 适用场景
适用场景包括：与 Hermes Agent 进行实时对话交互（支持流式输出和工具调用可视化）、通过集成终端执行命令和脚本、浏览搜索和编辑 Agent 的长期记忆、探索和管理 2000+ 可用技能、监控 Agent 状态与任务队列、以及通过移动端 PWA 远程访问（需配合 Tailscale）。适合需要统一控制台管理 AI Agent 全生命周期的开发者和运维人员。
4. 安装方式
提供两种安装方式：一键安装（推荐）运行 curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash，脚本会自动安装 hermes-agent、克隆仓库、配置 .env 并安装依赖。手动安装需先确保 hermes-agent 已安装并运行 Gateway，然后克隆仓库、执行 pnpm install、复制 .env.example 为 .env 并配置 HERMES_API_URL（默认 http://127.0.0.1:8642）。若 Gateway 启用了 API_SERVER_KEY，需同步设置 HERMES_API_TOKEN。
5. 使用方式
启动流程：在终端 1 运行 hermes gateway run 启动 Agent Gateway；在终端 2 进入 hermes-workspace 目录执行 pnpm dev（默认端口 3000）。访问 http://localhost:3000 完成初始配置。界面提供 Chat、Terminal、Memory、Skills、Dashboard、Tasks、Jobs、Settings、Conductor 等面板，通过左侧导航栏切换。Chat 界面支持 SSE 实时流和工具调用渲染，Terminal 基于 xterm.js 提供完整终端功能。
6. 补充说明与实现特点
项目基于 React 19 + TanStack Start + Vite 构建，采用 SSR 与静态托管混合架构（Chat 等路由禁用 SSR）。前端使用 TanStack React Router 管理路由，支持会话状态持久化恢复。样式基于 Tailwind CSS v4，提供 4 种强调色动态切换。生产环境通过自定义 server-entry.js 实现静态资源优先托管与 SSR fallback。项目还提供 Docker 部署支持（docker-compose.yml）和 Playwright smoke 测试脚本。
思维导图
Hermes Workspace
核心功能模块
Chat - SSE 实时对话
Terminal - xterm.js 集成终端
Memory - 内存浏览与编辑
Skills - 2000+ 技能管理
Dashboard - 状态监控面板
Tasks & Jobs - 任务队列管理
Settings - 主题与配置
Conductor - 多 Agent 编排
技术架构
React 19 + TanStack Start
Vite 构建工具
Tailwind CSS v4
SSR + 静态托管混合
Zustand 状态管理
TanStack React Query
安全与部署
Auth 中间件
CSP 响应头
执行审批提示
Docker 部署支持
PWA 移动端适配
安装与配置
一键安装脚本
pnpm 依赖管理
环境变量配置
Gateway 连接
常见问题
Hermes Workspace 与普通聊天客户端有什么区别？
Hermes Workspace 不是简单的聊天包装器，而是提供完整工作区体验的应用。它集成了聊天、终端、内存管理、技能浏览、仪表板、任务监控等八大功能模块，支持 Agent 编排、实时 SSE 流传输和安全加固的 API 访问。
如何连接已有的 Hermes Agent Gateway？
克隆仓库后执行 pnpm install，复制 .env.example 为 .env，设置 HERMES_API_URL 指向 Gateway 地址（默认 http://127.0.0.1:8642）。若 Gateway 启用了 API_SERVER_KEY，需同步设置 HERMES_API_TOKEN。确保 Gateway 的 API_SERVER_ENABLED=true 且绑定到可访问地址。
支持哪些主题和定制选项？
项目提供 8 套主题系统，包含 Official、Classic、Slate、Mono 四种风格，每种风格均提供明暗两种变体。此外支持 4 种强调色（橙、紫、蓝、绿）动态切换，通过 DOM data 属性实现实时生效。
是否支持移动端访问？
是的，Hermes Workspace 是移动端优先的 PWA 应用，提供完整功能 parity。可通过 Tailscale 等组网工具远程连接，在任意设备上通过浏览器访问 Workspace 界面。
生产环境如何部署？
项目提供 pnpm build 构建命令和 pnpm start 生产启动命令，基于自定义 server-entry.js 实现静态资源优先托管与 SSR fallback。同时提供 Docker 部署支持，包含 docker-compose.yml 和 docker-compose.dev.yml 配置文件，以及独立的 agent/ 和 workspace/ Dockerfile。