前言¶

给飞牛 NAS（fnOS）写第三方应用，麻烦的地方不在业务逻辑，而在「打包」这一段：要写 manifest、要配权限和资源、要放桌面图标和文件右键菜单、要写生命周期脚本、要处理 CGI 反代和网关注册，最后还要用 fnpack CLI 打出 .fpk 再上架。这些约定散落在文档各处，第一次做很容易在目录结构上反复试错。

下面介绍 fn-fpk 这个 Skill，它把上面这整条链路的约定整理成一套可直接执行的说明，交给 AI 编程助手时，能少走很多弯路。

这是什么¶

fn-fpk 是一个面向通用 SKILL.md 格式的技能包，定位是飞牛 NAS（fnOS）FPK 应用的开发与打包助手。

• 名称：fn-fpk
• 坐标：@user_15292d5a/yjkj-fn-fpk
• 版本：1.0.0
• 来源：community
• 分类：dev-programming
• 发布者：user_15292d5a
• 标签：requires_api_key=false（不需要 API Key）
• 官方地址：https://api.skillhub.cn/user_15292d5a/yjkj-fn-fpk
• SkillHub 页面：https://www.skillhub.cn/skills/user_15292d5a/yjkj-fn-fpk

它解决的是「从零到打出一个能装的 .fpk」这个过程里，约定太多、容易漏项的问题。当用户提到「飞牛」「fnOS」「FPK」「飞牛应用」这类关键词时，这个技能会被触发。

核心功能¶

按照官方简介，fn-fpk 覆盖整个开发周期，分几块看。

支持两类应用形态：

1、Native 应用：Node.js、Python、Java、Go、Shell 等。
2、Docker 应用。

覆盖的开发环节：

1、开发环境准备。
2、用 fnpack 创建项目。
3、manifest 配置。
4、权限与资源配置。
5、用户入口配置：应用入口 app/ui/config，加上桌面图标和文件右键菜单。
6、生命周期脚本编写：cmd/main。
7、向导配置：wizard。
8、图标规范。
9、CGI 反向代理。
10、统一网关注册与认证。
11、运行时环境：Python、Node.js、Java。
12、中间件服务：Redis、MinIO、RabbitMQ、MariaDB。
13、依赖管理。
14、用 fnpack CLI 打包。
15、用 appcenter-cli 测试安装。
16、上架发布。

这些能力都来自 Skill 简介本身，没有额外的实现细节可核对。

安装与启用¶

SkillHub 页面对抓取不友好，正文里没有拿到可直接复制的安装命令，也没有说明 Cursor、Codex CLI、Claude Code 之间是否有差异。

因此这里不给出处不明的命令，只给两条可靠的路径：

1、打开官方地址，按页面给出的安装方式操作。
2、如果使用 SkillHub 的官方 CLI，按其文档的 install 子命令安装，坐标填 @user_15292d5a/yjkj-fn-fpk。

在启用之前，可以先确认两点：一是目标助手是否支持通用 SKILL.md 格式；二是 requires_api_key=false，意味着不需要额外配置 API Key。

典型用法¶

这个 Skill 的典型用法是「对话驱动 + 命令落地」：在支持 SKILL.md 的助手里启用后，直接用自然语言描述要做什么样的飞牛应用，助手会按技能里的约定生成项目骨架和配置。

可复现的流程大致是：

1、先说明应用类型，是 Native 还是 Docker。
2、让它用 fnpack 创建项目，生成目录结构。
3、让它写 manifest，按需补权限和资源。
4、让它放用户入口，包括 app/ui/config、桌面图标、文件右键菜单。
5、让它写生命周期脚本，即 cmd/main。
6、如果应用需要向导，让它配 wizard。
7、涉及反向代理和网关时，让它处理 CGI 反代、统一网关注册与认证。
8、让它按图标规范补齐图标。
9、让它跑依赖管理，处理运行时环境或中间件。
10、让它调用 fnpack CLI 打包。
11、用 appcenter-cli 做测试安装。
12、最后走上架发布。

上面每一步都对应简介里列出的能力，属于官方资料覆盖的范围。

适用场景与注意¶

适合的人：要在 fnOS 上交付第三方应用的开发者，尤其是第一次接触 FPK 打包、不想反复翻文档试目录结构的人；以及用 AI 助手做 Nas 应用脚手架、希望把约定一次性说清的团队。

需要注意的点：

1、这个 Skill 是 community 来源、版本 1.0.0，能力边界以官方简介为准，遇到没有覆盖的接口或字段，仍需回到 fnOS 官方文档核对。
2、它不替代 fnOS 本身的开发文档，只是把打包链路的约定整理成可执行清单；具体字段名、命令参数以 fnpack CLI 和 appcenter-cli 的实际输出为准。
3、中间件只列了 Redis、MinIO、RabbitMQ、MariaDB 四类，如果你要用别的组件，需要自行确认。
4、安装方式没有在抓取资料里核实到，照抄任何未核实的安装命令都有风险。
5、下载量以 SkillHub 页面为准，抓取资料显示为 1176 次，安装数显示为 0。

结尾¶

fn-fpk 的价值在于把 FPK 打包这条链路上分散的约定收拢成一套可执行流程，让 AI 助手在生成项目结构、配置和脚本时有一致的依据，而不是每次凭印象拼。如果你要在 fnOS 上做第三方应用，可以先从它起步，再按官方文档补齐细节。

官方地址：https://api.skillhub.cn/user_15292d5a/yjkj-fn-fpk