# fn-appstores

**Repository Path**: gald/fn-appstores

## Basic Information

- **Project Name**: fn-appstores
- **Description**: FN软仓项目专用仓库，FN软仓是专为FNOS设计的第三方应用商店。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://fn-appstores.hhxs2025.top:1666
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FN软仓v1.0.0初始版

FN软仓是一个运行在飞牛 NAS 系统上的第三方应用商店，支持从 Gitee 平台自动同步应用列表，实现一键安装。

- 一键安装：无需命令行，点击即可安装飞牛应用
- 自动同步：定时从 Gitee 拉取最新应用列表
- 已安装检测：自动识别已安装应用，界面状态实时更新

## 功能特性

✅ 应用列表浏览   
✅ 应用一键安装   
✅ 已安装状态自动识别   
✅ 多源支持（可接入任意开发者仓库）   
✅ 图标显示（支持 Gitee raw 直链）   

## 用户安装

1. 下载 FN软仓 FPK 包
2. 在飞牛应用中心点击“手动安装”,上传 FPK 包
3. 安装完成后，在桌面打开 FN软仓
4. 首次使用建议点击“刷新”按钮同步应用列表

## 技术架构

```
Gitee 主仓库: hhxs2025/fn-appstores/
├──────────── sources.json                    # 云端种子源（官方源列表）
├──────── json/
│      ├────────fn-appstores.json              # FN软仓自身信息
│      ├──────── cloud.json                         # 独立仓库云系列合集（云资源+云收集+云比价）
│      ├──────── apps.json                          # 主仓库apps内应用合集（文件收集器+Lucky+PodNote）
├──────── apps/           # 应用包
│      ├────── Lucky.fpk
│      └────── PodNote.fpk
└── ...

用户飞牛系统: /path/to/FN软仓/data/
└── user-sources.json               # 用户本地源列表（首次启动自动生成）
|         |____________README.MD  
|         |____________.gitee/
|         |        |____________ISSUE_TEMPLATE/ #接入申请模板与配置文件目录 | 
|   

```

## ## 更新说明：

### 1.0.0初始版核心功能

| 功能              | 说明                              |
| ----------------- | --------------------------------- |
| 应用列表浏览      | 从Gitee仓库拉取应用               |
| 一键安装          | 支持                              |
| 已安装状态检测    | 读取@appcenter/目录识别已安装应用 |
| 应用源接入        | 支持                              |
| websocket实时推送 | 安装进度实时反馈                  |
| 后台定时同步      | 每小时自动刷新应用列表            |
| 图标显示          | 支持gitee raw直连图标             |

### 1.0.1版更新说明

| 功能             | 说明                                            |
| ---------------- | ----------------------------------------------- |
| 新增一键卸载     | 已安装应用显示“卸载”按钮，可进行卸载          |
| 新增分类标签     | 支持fnpack.json中tags字段，应用卡片显示标签徽章 |
| 新增加载状态反馈 | 安装/刷新时按钮显示加载状态并自动禁用           |
| 网络超时处理     | 请求超时(10s)显示友好提示，不卡死界面           |
| 新增底部信息栏   | 显示版本号和开发者信息                          |
| 新增接入申请路径 | 底部新增申请接入链接，单击自动复制开发者邮箱    |

### 1.0.2版更新优化说明

| 优化项               | 说明                       |
| -------------------- | -------------------------- |
| 手机端单列布局       | 应用列表自动切换为单列竖排 |
| 手机端标题栏宽度优化 | 手机端标题背景撑满屏幕宽度 |
| 页面底部填充         | 背景填满，无多余空白       |

### 1.0.3版更新优化说明

| 优化项         | 说明                                     |
| -------------- | ---------------------------------------- |
| 新增作者筛选   | 标题下方新增按作者筛选按钮               |
| 筛选后数量更新 | 筛选后符合筛选作者条件的应用数量同步更新 |
| 标题区界面优化 | 图标缩小，上下内边距缩小，布局紧凑化     |

#### 直链下载：[应用仓直链](https://gitee.com/hhxs2025/fn-appstores/raw/master/old-fpk/fn-appstores-1.0.3-x86-jm.fpk)

### 1.0.4版更新说明：

| 优化项                 | 说明                                                                 |
| ---------------------- | -------------------------------------------------------------------- |
| 新增应用搜索与标签筛选 | 标题下方新增                                                         |
| 新增底部导航切换       | 新增导航菜单“应用”、“日志”                                       |
| 新增操作日志           | 通过底部导航切换                                                     |
| 优化应用安装支持       | 优化对内含交互式安装向导的应用的支持，识别此类应用后提示下载手动安装 |

#### 直链下载：[应用仓直链](https://gitee.com/hhxs2025/fn-appstores/raw/master/old-fpk/fn-appstores-1.0.4-x86-jm.fpk)

### 1.0.5版更新说明：

| 优化项                 | 说明                                                                                   |
| ---------------------- | -------------------------------------------------------------------------------------- |
| 功能修复               | 卸载后状态刷新修复:卸载成功后直接更新 app.installed = false，然后 renderFilteredApps() |
| 功能新增               | 新增日志自动化清理:写入前检查日志条数，超过 500 条截断保留最新 400 条                  |
| Toast提示优化          | 不同类型不同时长，显示具体应用名                                                       |
| 飞牛手机端界面适配优化 | 手机端 overflow: auto，允许滚动                                                        |

#### 直链下载：[应用仓直链](https://gitee.com/hhxs2025/fn-appstores/releases/download/1.0.5/fn-appstores-1.0.5-x86-jm.fpk)

### 1.0.6 更新说明
#### ✨ 新增功能
1. **安装状态反馈**：应用卡片实时显示安装/卸载进度 
2. **源状态监控**：日志页面显示各应用源连接状态 

#### 🐛 修复问题
1. 修复底部导航与卡片区间距过大问题
2. 修复窗口缩小时卡片左右两侧空白问题

#### 🎨 界面优化
1. **卡片网格自适应**：窗口拉宽时自动增加列数，充分利用屏幕空间
2. **卡片区滚动**：内容超出时出现滚动条实现鼠标滑轮上下滚动
3. **卡片尺寸优化**：卡片尺寸放大，宽度在有限范围内随窗口界面拉宽而自适应
4. **头部压缩**：标题栏高度减少约30%，释放更多内容空间

#### 直链下载：[应用仓直链](https://gitee.com/hhxs2025/fn-appstores/releases/download/1.0.6/fn-appstores-1.0.6-x86-jm.fpk)

![image.png](https://gitee.com/hhxs2025/fn-appstores/raw/master/images/screenshot1.PNG)



## 接入说明：
### 一、接入流程
```
创建仓库→ 编写 fnpack.json →上传应用包→提交链接 →审核上线
```

### 二、仓库结构基本要求
```
|______你的仓库名/
|   |_________app名称.json#应用列表（必须)  
|   |_________icon.png#应用图标 120x120
|   |_________README .md#可选
```

### 三、fnpack.json编写规范

#### 3.1字段说明

| 字段             | 类型    | 必填 | 说明                            |
| ---------------- | ------- | ---- | ------------------------------- |
| id               | string  | ✅   | 应用唯一标识，建议用作者-应用名 |
| name             | string  | ✅   | 应用显示名称 (用户看到的名称)   |
| version          | string  | ✅   | 版本号，如1.0.0                 |
| desc             | string  | ✅   | 应用简短描述                    |
| author           | string  | ✅   | 作者名称                        |
| tags             | string  | ❌   | 分类标签                        |
 has_wizard       | boolean | ❌   | 是否包含安装向导，默认“false” |
| uninstall_wizard | boolean | ❌   | 是否包含安装向导，默认“false” |
| update_time | string | ❌   | 应用更新时间 | 
| has_update | boolean | ⚠️ 只读   | 是否有新版本（前端计算） | 
| download_count | number | ⚠️ 只读   | 下载量（后端获取） |
| _source | string | ⚠️ 只读   | 来源标识（后端自动生成） |
| icon             | string  | ✅   | 图标直链                        |
| download_url     | string  | ✅   | FPK下载直链                     |
| screenshots    | array  | ❌   | 应用预览截图链接列表,格式:["url1", "url2"]      |

### has_wizard 字段说明
如果你的应用在安装时有**交互式向导**（如设置管理员账号密码、选择安装路径等），请将此字段设为 `true`。

- `true`：应用包含安装向导，用户在 FN软仓 中点击 **"下载（手动安装）"**，下载后需在飞牛应用中心手动上传安装
- `false` 或不填：应用无向导，用户点击 **"安装"** 即可一键安装

### ⚠️只读字段由后端处理,json内不用填写 

#### 示例：
```
[
  {
    "id": "zhangsan-file-manager",
    "name": "极速文件管理器",
    "version": "1.0.0",
    "desc": "轻量级文件管理工具，支持批量操作",
    "author": "张三",
    "tags": ["工具"],
    "icon": "https://gitee.com/zhangsan/fnos-tools/raw/master/icon.png",
    "download_url": "https://gitee.com/zhangsan/fnos-tools/releases/download/file-manager.fpk"
  }
]
```

#### 3.3获取fnpack.json直链
#### 3.4注意事项
提交前请确认：
* 仓库是公开的
* fnpack.json 格式正确
* icon 链接在浏览器中能打开
* download\_url 链接能下载 FPK 文件
* 应用 ID 不与现有应用重复

### 四、申请接入
#### 4.1提交方式
在本项目仓库提交 Issue   【[issue地址,点击打开](https://gitee.com/hhxs2025/fn-appstores/issues/new/choose)】
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

## tags分类标签说明
- `工具`：实用工具类应用
- `媒体`：影音、图片、播放器
- `系统`：系统工具、管理工具
- `比价`：价格比较相关
- `收集`：文件收集整理
- `资源`：资源下载站
- `商店`：应用商店类