应用结构

apps/* 目录是 fnOS 应用的打包输入，由 manifest 和生命周期脚本定义。普通开发机负责构建，真实行为必须在 fnOS 设备上验证。

仓库当前只有 apps/fn-deepseek-harness 一个 Native 应用，没有 Docker 应用。下文标注 Docker 的位置仅在新增该形态应用时适用。

创建应用

创建或重建应用前

先查阅 fnnas-docs Skill，再用官方模板创建：

cd apps
fnpack create <app-name>
# 仅 Docker 应用使用：
fnpack create <app-name> --template docker

不得删除模板文件或目录；在模板基础上修改 manifest、app/、cmd/、config/ 和 wizard/。

创建后按形态编辑：Native 应用改 app/、cmd/main、config/privilege；Docker 应用还需编辑 app/docker/docker-compose.yaml（镜像、端口映射、数据卷）。图标为 ICON.PNG（64×64）与 ICON_256.PNG（256×256）。

目录约定

apps/<appname>/
├── manifest       应用身份、版本、平台、桌面入口和运行约束
├── app/           运行文件、UI 资源和 Docker 配置
├── cmd/           安装、启动、停止、升级和卸载脚本
├── config/        权限、资源和入口配置
├── wizard/        安装、升级、配置和卸载向导
├── ICON.PNG       64×64 图标
└── ICON_256.PNG   256×256 图标

各目录职责：

路径	用途	对应文档
manifest	应用标识、版本、平台、依赖和入口声明	Manifest 配置
cmd/	生命周期脚本，含 main、config_callback 等	生命周期脚本
config/	运行权限、资源声明、桌面入口	权限与入口
wizard/	用户向导，收集安装与运行参数	用户向导
app/	应用运行文件和 UI	视应用形态而定

构建应用

直接构建单个应用：

cd apps/<app-name>
fnpack build

也可以从根目录通过 CLI 选择：

pnpm run build -- --fpk --app <app-name>

交互式构建执行 pnpm run build，选择 FPK 后可以多选应用。选择 fn-deepseek-harness 时，CLI 会先通过 build:gateway 构建 Gateway，再询问是否将 node-pty native 文件内置到 FPK（默认是），选择内置时会在 Linux 构建机上执行 native 准备脚本，最后执行该应用的 fnpack build。非交互构建可显式使用 --bundle-dsh-native 或 --skip-bundle-dsh-native。

FPK 产物生成在应用目录中，不要提交 .fpk 或临时构建目录。

应用依赖的 Node.js、Python、镜像和中间件必须通过 Manifest、资源配置或 fnOS 安装流程声明，不能依赖开发机环境。

在 fnOS 上验证

cd /path/to/apps/<app-name>
appcenter-cli install-local
appcenter-cli start <app-name>
appcenter-cli stop <app-name>
appcenter-cli list

# 验证正式 FPK
appcenter-cli install-fpk <app-name>.fpk

TRIM_* 目录和安装向导环境变量只在 fnOS 生命周期中可靠存在。直接在开发机执行 cmd/main 或 cmd/install_callback，不能替代真实安装验证。

相关页面

• Manifest 配置
• 生命周期脚本
• 权限与入口
• 用户向导
• fnpack 打包