Hermes Core for fnOS

Hermes Agent 自包含全能套件 — 本地内核 Gateway + 内置 dashboard Web UI，一个套件全搞定。

• English README

---

✨ 功能亮点

• 自包含，一个套件全搞定：本地内核 Gateway（:8642）+ 内置 dashboard Web UI（:9119），替代废弃的 HermesWebUI，无需任何前端套件
• 本地内核，无需远程服务器：在飞牛 NAS 上本地运行 Hermes Agent 内核，提供 :8642 的 OpenAI 兼容 API
• 自带状态页 + 配置面板：网页内查看状态、管理配置、测试聊天
• 内置 Dashboard Web UI（默认开启）：Hermes 原生 Web 管理界面，聊天/会话/文件/模型/日志/cron/技能全功能
• 多 LLM 供应商：9Router / DeepSeek / MiMo / 任意 OpenAI 兼容 API

🏗️ 架构

fnOS
└── Hermes Core
    ├── Gateway (:8642)        ← hermes gateway run (本地 venv, OpenAI 兼容 API)
    ├── 自研状态页仪表盘 (:8648) ← status_server.py (纯 stdlib, 零依赖) = 桌面图标入口
    │   ├─💬 聊天              ← 流式 SSE 代理 → :8642
    │   ├─🖥️ 终端              ← 真终端 (PTY + WebSocket + xterm.js), spawn hermes chat
    │   ├─ 📊 状态              ← 内核/消息网关/LLM/Dashboard 状态
    │   ├─ ⚙️ 配置              ← gateway.env 配置管理 + 一键重启
    │   └─ 🍟 模型供应商        ← 9Router/DeepSeek/MiMo 卡片 + Token 管理
    └── 原生 Dashboard (:9119)   ← Hermes 原生 Web 管理界面 (默认开启, 聊天/会话/文件/模型/日志/cron/技能全功能)

• 桌面图标 → 打开自研状态页仪表盘（:8648），管理配置、查看状态、测试聊天、原生终端
• 官方统一网关：应用入口走 /app/hermescore（gatewaySocket: app.sock），fnOS 校验会话 + 转发用户 Header（X-Trim-*）
• 原生 Dashboard（:9119）：Hermes 官方完整 Web UI，默认开启，作为进阶前端

🚀 快速安装

1. 从 Releases 下载 HermesCore.fpk
2. 飞牛 NAS → 应用中心 → 手动安装 → 选择 fpk
3. 安装时按向导配置监听地址 / 端口 / API Key
4. 安装完成后在应用中心手动启动（fnOS 不会自动启动）

# SSH 到飞牛手动启动（可选，正常用应用中心启停）
cd /var/apps/HermesCore && bash cmd/main start
curl -sf http://127.0.0.1:8642/health

📖 使用说明

状态页配置

安装后打开内核图标进入状态页（:8648），在「配置」标签编辑保存基础配置，保存后一键重启内核生效。

• 📑 「状态」「配置」两个标签页
• 🌙 日夜主题 · 🌐 中英文切换（自动记住）
• 📡 消息网关状态 · 🧠 兜底 LLM 探测 · 📊 Dashboard 状态

端口

服务	端口	说明
Gateway API	8642	OpenAI 兼容 API
自研状态页仪表盘	8648	状态页 + 配置 + 聊天代理（桌面图标入口）
原生 Dashboard	9119	Hermes Web 管理界面（默认开启）

访问（两个前端都可用）

• 自研状态页仪表盘（:8648）：桌面点应用图标进入，管理配置、查看状态、测试聊天，保存后一键重启内核生效
• 原生 Dashboard（:9119）：浏览器打开 http://<NAS>:9119，用安装时设置的用户名/密码登录，聊天/会话/文件/模型/日志/cron/技能全功能
• Gateway API（:8642）：OpenAI 兼容，可被其他工具对接

对接外部工具

# 其他 OpenAI 兼容客户端指向本地内核即可
# Base URL: http://127.0.0.1:8642
# API Key:  <gateway.env 里的 API_SERVER_KEY>

⚙️ 配置

安装向导（首次安装）与 状态页网页（日常调整）两种方式。

常用配置项

字段	说明
API_SERVER_HOST	内核监听地址
API_SERVER_PORT	内核 API 端口
API_SERVER_KEY	内核 API Key（鉴权用）
ROUTER_API_KEY	9Router API Key（本机 :20128，可选）
LLM_BASE_URL	兜底 LLM Base URL（任意 OpenAI 兼容 API）
LLM_API_KEY	兜底 API Token
LLM_MODEL	兜底模型名
DASHBOARD_ENABLED	是否启用内置 dashboard（默认 true，即前端）
DASHBOARD_USER / DASHBOARD_PASSWORD	dashboard 登录用户名/密码

LLM 优先级：填了 LLM_BASE_URL 用 Custom LLM，否则用 9Router。配置变更后重启内核生效。

内置 Dashboard（默认开启）

自包含套件默认开启内置 dashboard（:9119），作为 Web 前端：

DASHBOARD_ENABLED=true
DASHBOARD_USER=admin
DASHBOARD_PASSWORD=***

• 重启内核后 :9119 自动启动。
• 未设密码时自动生成随机密码并持久化到 gateway.env（重启不变），记录在 core.log。
• 需要关闭前端时设 DASHBOARD_ENABLED=false。

🐛 问题排查

安装/运行/配置的常见问题与修复，见 TROUBLESHOOTING.md。

🛠️ 从源码构建

# 在飞牛上
fnpack build   # 生成 HermesCore.fpk

License

MIT