【应用分享】FNOS-API — 利用官方hermes的skill 封装了一个api服务

为什么做这个

上周上线的 Hermes Skill 仅向 Hermes 开放了部分接口，受限于 AI 本身的精准度与操作便捷性，实际使用存在不少局限。以对接企业 OA 系统批量创建用户这类场景为例，官方暂未开放对应接口，落地操作十分不便。

虽然官方配套了功能完备的 Hermes Skill 命令行工具 trim-cli，但该工具无法直接集成调用。为此让AI 封装开发了原生 fpk 应用，支持一键安装、开箱即用。

它能做什么

目前已经覆盖了飞牛系统绝大多数核心能力：

• 文件管理：浏览、搜索、上传下载、复制移动删除、分享
• 存储管理：存储池、磁盘信息、SMART、挂载卸载、扩容
• Docker 管理：容器 / 镜像列表、启停、Compose 管理
• 下载中心：添加任务、暂停恢复、删除、进度统计
• 系统监控：CPU、内存、系统信息实时查询
• 用户管理：用户 / 用户组 CRUD、权限配置
• 日志中心：日志查询、清理、导出、归档
• 应用中心：应用列表、安装更新、启停卸载

怎么用

1. 去 GitHub Releases 下载 .fpk 安装包，在应用中心手动上传安装
2. 安装向导里填 NAS 地址、账号密码，设置自己的 API Token
3. 安装完成后服务自动启动，默认端口 9932
4. 所有请求 Header 携带 Authorization: Bearer <你的token> 即可调用

举个最简单的例子：

bash

运行

# 获取系统信息
curl -H "Authorization: Bearer fnosapi2024" http://你的NASIP:9932/api/system/info

项目里还带了完整的 Python 测试脚本，每个接口一个文件，新手也能快速上手。

技术细节

• 后端 Node.js + Express，轻量无依赖
• 底层直接调用官方 trim-cli 二进制，不走野路子
• 支持 x86_64 /arm64 架构
• 要求 fnOS 版本 1.1.3107+

写在最后

这个项目完全是AI写的开源免费，MIT 协议。主要也是提供思路给论坛的各位大佬，我也不会维护他。

希望官方后续能开放原生 API，在那之前，先用这个过渡一下。

项目地址：https://github.com/heijiangangqin/FNOS-API