Hermes Agent 是专为适配飞牛 NAS（fnOS）的 AI 助手应用，通过原生fpk 应用中心部署。采用基于 Node.js 的 Monitor 服务进行进程管理，提供基于 Web 的控制面板用于配置和对话交互。
- 我们有另一个全新的版本，支持对话中选择专家团+工作流等，功能更多：https://github.com/veenyi/fnos-hermes-agent
- 本项目不定期更新，也可能只留存长期稳定版本
- 支持多通讯渠道接入（微信、QQ 机器人、飞书、WhatsApp、Telegram），网页内扫码绑定，渠道独立启停
- 支持网页端对话，支持完整的Markdown输出
- 支持网页对话js版转换url为二维码、文本等格式的转码
- 支持对话传入图片、文件供AGENT分析
- 支持模型回退机制，主模型故障时自动切换备用模型，保障服务连续性
- 对话支持多窗口并行问询、超时自动提示、新窗口打开持续响应
- 可用存储空间：约 1GB（含 Python 依赖包和缓存）
- 依赖项：Node.js v24（安装时自动处理）
- 在飞牛应用中心添加第三方源或直接上传
.fpk安装包 - 等待安装完成，桌面出现应用图标
- 点击图标打开控制面板
- 在「模型」页选择模型供应商并填入 API Key
- 在「概览」页面，点击启动即可进行对话
应用启动后自动监听内部端口，无需手动配置网络，通过应用中心的快捷入口进入。
/app/home/data/ # 应用数据目录（持久化）
├── venv/ # Python 虚拟环境
│ └── bin/ # Python 可执行文件（python3、uv、hermes）
├── .uv-cache/ # uv 包缓存
├── config.yaml # 主配置文件
├── .env # 环境变量（API Key 等）
├── sessions/ # 会话历史记录
├── skills/ # 技能库（随版本更新）
├── workspace/ # 工作区文件（生成的报告、代码等）
├── weixin/accounts/ # 微信绑定数据（JSON 文件）
├── SOUL.md # 系统提示词（首次安装部署）
└── AGENTS.md # 执行参考规则（首次安装部署）
/var/apps/hermes-agent/ # 应用运行目录
├── target/ # 程序本体（监控脚本、静态资源）
│ ├── server/monitor.js # Monitor HTTP 服务（Node.js）
│ └── ui/ # 前端静态文件
├── hermes-agent.sock # Unix socket（通信端点）
└── var/ # 运行时数据
├── gateway.pid # Gateway 进程 PID
├── dashboard.pid # Dashboard 进程 PID
├── monitor.token # API 认证令牌
├── hermes.log # 运行日志
└── chat/ # 聊天数据
├── config.json
└── sessions/
/vol1/@appdata/hermes-agent/ # 应用数据备份目录（升级保留）
├── tmp/ # 临时文件（重启清空）
├── monitor.token # 监控令牌副本
├── *.pid # PID 文件
└── *.log # 日志归档
应用启动脚本 → Monitor (Node.js, /var/apps/hermes-agent/server/monitor.js)
│
├─► Unix socket: /var/apps/hermes-agent/hermes-agent.sock
│ └─► 控制面板前端 (app/ui/index.html)
│
└─► HTTP 代理 → Hermes Gateway (:8642)
└─► 模型供应商 API / WS 消息通道
应用生命周期由 fnOS 统一管理。控制台可见状态包括：运行中、已停止、启动中。支持在控制面板「状态」页查看进程状态，但不提供手动启停按钮——所有操作均由后台进程管理接口统一调度，避免端口冲突和资源泄漏。
- 启动时会探测端口，如果默认端口8642或9119被占用，则改为28642和29119
- 8642 — Hermes Gateway 通信端口（内部使用，不对外暴露）
- 9119 — Dashboard 仪表板端口（本地回环访问）
控制面板通过基于 HTTP 的 Node.js 服务器（Monitor）通信，该服务器监听 Unix socket（/var/apps/hermes-agent/hermes-agent.sock）。消息被代理至端口 8642 上的 Hermes Gateway 进程。Python 虚拟环境使用 uv 作为包管理器，依赖项在安装时从 PyPI 镜像源拉取（阿里云镜像优先，GitHub 备用）。
监控令牌（Token）位于 /vol1/@appdata/hermes-agent/monitor.token，每次应用启动时生成随机字符串，前后端通过此 Token 鉴权。写操作（配置修改、进程重启）必须携带有效 Token，只读查询（状态、日志）免鉴权。
检查最新版本：控制面板「更新」页会自动拉取 PyPI 版本信息，对比当前版本号后发现新版本即可一键升级。
