Agent Skills
返回列表
飞牛 NAS fnOS FPK 应用开发

飞牛 NAS fnOS FPK 应用开发

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-fn-fpk。

技能介绍

解决的问题

飞牛 NAS 的 fnOS 应用打包并不是普通 Linux 服务：应用需要同时满足 manifest、config/privilege、config/resource、app/ui/config 与 cmd/ 生命周期脚本等约束。工程师常见问题包括：本地用 fnpack 能打包，但安装后入口不出现、端口未随向导更新、settings.conf 被系统覆盖、数据目录权限不清，或 Docker 应用 compose 启动状态检查缺失。本技能用于把这些官方规则整理成可执行开发流程。

工作方式

核心是围绕 FPK 包结构提供开发导航：

  • 使用 fnpack 创建 Native 或 Docker 应用，并确认 x86_64、版本与 manifest 字段。
  • 通过 config/privilege 明确应用用户或 root 模式，并用 config/resource 声明 data-share、usr-local-linker 或 docker-project。
  • 在 app/ui/config 配置桌面、文件右键、CGI 或统一网关入口，注意 port、url、protocol、allUsers 与动态变量。
  • 用 cmd/main 实现启动、停止、状态检查，并用 install_callback、config_callback 等处理向导输入、端口写入与配置迁移。
  • 对 Docker 应用，将 docker-compose.yaml 放在声明路径，并让系统管理 compose 启停。

适用边界

该资料基于 fnOS FPK 开发文档，适合第三方 Native 或 Docker 应用开发。Root 权限应用有发布限制；settings.conf 可能被系统重写，端口和路径应以应用自读配置与验证为主；统一网关适用于 fnOS V1.1.3100+，接入前需确认系统版本与网关字段。

使用场景

  • 在飞牛 NAS 上开发 Native 应用，需要用 fnpack 创建项目、配置 manifest 与入口。
  • 为第三方应用配置权限与共享目录，需要编写 config/privilege 和 config/resource。
  • 排查应用安装后端口未按向导更新，需要检查 settings.conf、config_callback 与 cmd/main。
  • 开发 Docker 应用，需要声明 docker-project、放置 docker-compose.yaml 并实现 status 检查。

适合人员

  • 维护飞牛 NAS 私有应用的后端工程师，需要把 Node.js 或 Python 服务打包成 fnOS FPK。
  • 做内部工具平台的应用开发者，需要配置入口、权限、共享目录和生命周期脚本。
  • 负责 Docker 应用上架的团队工程师，需要处理 docker-project 声明与 compose 状态检查。
  • 排查 fnOS 应用端口或路径异常的系统工程师，需要理解 settings.conf 与生命周期回调。