Agent Skills
返回列表
飞牛应用开发文档

飞牛应用开发文档

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md 安装 @user_5c85a23c/fnnas-docs。

技能介绍

为什么要整理这套文档

开发飞牛 fnOS 应用时，官方文档分散在文档站点的各个角落：从环境准备、应用创建，到 Manifest 配置、打包上架，再到开放 API 的调用方式。当你想快速确认「打包参数怎么加」「安装回调阶段该做什么」这类问题时，逐个翻页效率很低。这个技能把散落的文档整理成一份可检索的索引，让助手能按你的提问直接定位到对应文档，而不是凭印象回答。

它如何工作

技能的核心是一套分类索引与意图匹配规则：

  • 概览与快速开始：平台介绍、环境要求，以及创建、测试、上架应用的完整流程
  • 开发指南（13 篇）：覆盖应用框架、Manifest、环境变量、权限、应用入口、统一网关、向导等核心概念
  • 应用案例：分别给出从零创建 Native 应用与 Docker 应用的实战步骤
  • CLI 工具：fnpack 负责应用打包，appcenter-cli 负责安装、卸载与日志管理
  • 开放 API（11 篇）：包括 JS SDK、文件授权、页面路由、平台配置与错误码
  • 更新日志：文档站点与开放 API 的变更记录，便于追踪行为变化

提问时，技能会根据关键词匹配目标文档：提到「容器化」指向 Docker 案例，提到「权限声明」指向 privilege 文档，提到「网关注册」则定位到统一网关文档。

需要注意的边界

  • 原生应用用 fnpack create（不加 --template），Docker 应用必须加 --template docker，两者不能混用
  • 创建后不要删除模板自带的文件或目录，只能在其基础上修改或新增
  • 涉及安装目录、框架环境变量的逻辑应放在 cmd/install_callback 阶段，该阶段才会生成环境变量目录
  • 生命周期脚本直接输出到 stdout/stderr，框架会统一收集日志，无需自建日志文件
  • 目标系统要求 fnOS 0.9.27 及以上，架构支持 x86_64 与 ARM，服务端可选用 Node.js、Python、Java、Go 等运行时

使用场景

  • 用户询问飞牛应用开发或查阅 fnOS 开发文档时，快速定位概览与快速开始文档。
  • 需要创建原生或 Docker 应用时，查阅 fnpack create 命令的参数区别与模板保护规则。
  • 配置 Manifest、环境变量或应用权限时，检索核心概念文档以明确字段和阶段要求。
  • 准备应用打包和上架时，查找 fnpack、appcenter-cli 工具及发布流程文档。

适合人员

  • 飞牛 fnOS 应用开发者，需要快速定位官方文档解决开发问题。
  • 后端工程师，正在为 fnOS 构建 Native 或 Docker 应用，关注打包与上架细节。
  • 前端工程师，需要调用 JS SDK 或后端 API 实现文件授权、页面路由与平台配置。