FN软仓v1.0.0初始版
FN软仓是一个运行在飞牛 NAS 系统上的第三方应用商店，支持从 Gitee 平台自动同步应用列表，实现一键安装。
- 一键安装：无需命令行，点击即可安装飞牛应用
- 自动同步：定时从 Gitee 拉取最新应用列表
- 已安装检测：自动识别已安装应用，界面状态实时更新
功能特性
✅ 应用列表浏览
✅ 应用一键安装
✅ 已安装状态自动识别
✅ 多源支持（可接入任意开发者仓库）
✅ 图标显示（支持 Gitee raw 直链）
用户安装
- 下载 FN软仓 FPK 包
- 在飞牛应用中心点击“手动安装”,上传 FPK 包
- 安装完成后，在桌面打开 FN软仓
- 首次使用建议点击“刷新”按钮同步应用列表
技术架构
| Gitee仓库(数据源) |
| |_____sources.json #应用源索引 |
| |_____fnpack.json #应用列表 |
| |_____my-apps/ #应用目录 |
| |______app1/ #应用1文件夹 |
| | |______app1.fpk #安装包 |
| | |______icon.png #图标 |
| |_______app2/ #应用2文件夹 |
| | |______app2.fpk #安装包 |
| | |______icon.png #图标 |
……
||
| FN软仓 |
||
||
| FNOS |
|______appcenter-cli #应用安装命令 |
## 更新说明：
1.0.0初始版核心功能
| 功能 |
说明 |
| 应用列表浏览 |
从Gitee仓库拉取应用 |
| 一键安装 |
支持 |
| 已安装状态检测 |
读取@appcenter/目录识别已安装应用 |
| 应用源接入 |
支持 |
| websocket实时推送 |
安装进度实时反馈 |
| 后台定时同步 |
每小时自动刷新应用列表 |
| 图标显示 |
支持gitee raw直连图标 |
1.0.1版更新说明
| 功能 |
说明 |
| 新增一键卸载 |
已安装应用显示“卸载”按钮，可进行卸载 |
| 新增分类标签 |
支持fnpack.json中tags字段，应用卡片显示标签徽章 |
| 新增加载状态反馈 |
安装/刷新时按钮显示加载状态并自动禁用 |
| 网络超时处理 |
请求超时(10s)显示友好提示，不卡死界面 |
| 新增底部信息栏 |
显示版本号和开发者信息 |
| 新增接入申请路径 |
底部新增申请接入链接，单击自动复制开发者邮箱 |
1.0.2版更新优化说明
| 优化项 |
说明 |
| 手机端单列布局 |
应用列表自动切换为单列竖排 |
| 手机端标题栏宽度优化 |
手机端标题背景撑满屏幕宽度 |
| 页面底部填充 |
背景填满，无多余空白 |
FN软仓下载地址
界面展示
接入说明：
一、接入流程
创建仓库→ 编写 fnpack.json →上传应用包→提交链接 →审核上线
二、仓库结构要求
你的仓库名/
|_________fnpack.json#应用列表（必须)
|_________应用名1/
| |_______应用名1.fpk#飞牛安装包
| |_______icon.png#应用图标 120x120
|_________应用名2/
| |_______应用名2.fpk
| |_______icon.png
|_________README .md#可选
三、fnpack.json编写规范
3.1字段说明
| 字段 |
类型 |
必填 |
说明 |
| id |
string |
✅ |
应用唯一标识，建议用作者-应用名 |
| name |
string |
✅ |
应用显示名称 (用户看到的名称) |
| version |
string |
✅ |
版本号，如1.0.0 |
| desc |
string |
✅ |
应用简短描述 |
| author |
string |
✅ |
作者名称 |
| icon |
string |
✅ |
图标直链 |
| download_url |
string |
✅ |
FPK下载直链 |
示例：
[
{
"id": "zhangsan-file-manager",
"name": "极速文件管理器",
"version": "1.0.0",
"desc": "轻量级文件管理工具，支持批量操作",
"author": "张三",
"icon": "https://gitee.com/zhangsan/fnos-tools/raw/master/file-manager/icon.png",
"download_url": "https://gitee.com/zhangsan/fnos-tools/raw/master/file-manager/file-manager.fpk"
}
]
3.3获取fnpack.json直链
3.4注意事项
提交前请确认：
- 仓库是公开的
- fnpack.json 格式正确
- icon 链接在浏览器中能打开
- download_url 链接能下载 FPK 文件
- 应用 ID 不与现有应用重复
四、申请接入
4.1提交方式
在本项目仓库提交 Issue 【issue地址,点击打开】
FN软仓界面底部邮件提交 【接入更快】
4.2提交信息模板
**应用名称：** 极速文件管理器
**应用 ID：** zhangsan-file-manager
**应用描述：** 轻量级文件管理工具
**作者：** 张三
**fnpack.json 直链：** https://gitee.com/zhangsan/fnos-tools/raw/master/fnpack.json
应用ID规范：
- 格式：作者名-应用名 或 com.作者名.应用名
- 全部小写
- 用 - 或 . 分隔 示例：zhangsan-file-manager
五、应用更新
- 更新应用时，无需联系管理员：
- 替换 应用名/应用名.fpk
- 修改 fnpack.json 中的 version
- 提交到 Gitee
