diff --git a/README.md b/README.md index 2136703..7f455a7 100644 --- a/README.md +++ b/README.md @@ -1,149 +1,32 @@ -# FnDepot 应用源构建规范 +# FnDepot 应用源-moxyis -> **版本**: 1.0.0 -> **最后更新**: 2025-11-30 +> **最后更新**: 2025-12-2 -## 1. 概述 (Overview) +## 1. 应用清单 -FnDepot 是运行于 FNOS 上的去中心化第三方应用管理器。本文档详细定义了 FnDepot 应用源（Repository）的构建规范、目录结构及元数据标准。开发者需严格遵循本规范，以确保应用源能被 FnDepot 客户端正确解析、索引及分发。 +| 应用名称 | 版本号 | 开发者/GitHub仓库 | +| :---------------------- | :----- | :----------------------------------------------- | +| **彩虹聚合DNS管理系统** | 2.11 | 消失的彩虹海/https://github.com/netcccyun/dnsmgr | +| **ZFile** | 4.5.0 | zhaojun1998/https://github.com/zfile-dev/zfile | +| **NapCatQQ** | 4.9.80 | NapNeko/https://github.com/NapNeko/NapCatQQ | +| **PanIndex** | 3.1.5 | libsgh/https://github.com/px-org/PanIndex | +| | | | +| | | | +| | | | +| | | | +| | | | -## 2. 仓库规范 (Repository Standards) +## 支持与反馈 -为了保证解析效率与编写方便，项目在制作时大量采用了飞牛官方开发文档的键名，方便开发者识别。应用源仓库必须满足以下硬性条件： +🌐 作者信息：[moxyis](https://github.com/moxyis) -| 项目 | 要求 | 说明 | -| :--- | :--- | :--- | -| **托管平台** | GitHub | 目前仅支持 GitHub 托管的仓库。 | -| **仓库可见性** | Public | 仓库必须设为公开，私有仓库无法被客户端索引。 | -| **仓库命名** | FnDepot | **[强制]** 仓库名称必须严格命名为 `FnDepot`（大小写敏感）。 | -| **分支策略** | main | 客户端默认拉取默认分支的内容。 | +⭐ 如果您觉得本项目对您有帮助，欢迎给项目点个 Star -## 3. 目录结构 (Directory Structure) +🤝 捐赠： -FnDepot 采用扁平化的目录结构。仓库根目录必须包含全局索引文件 `fnpack.json`，每个应用拥有独立的子目录。 + -```text -FnDepot/ # [Root] 仓库根目录 -│ -├── fnpack.json # [Core] 全局元数据索引文件 -│ -├── {app_name}/ # [Dir] 应用目录 (名称即为 Unique ID) -│ ├── ICON.PNG # [Asset] 应用图标 (强制全大写) -│ ├── {app_name}.fpk # [Bin] 安装包 (文件名须与目录名一致) -│ ├── README.md # [Doc] 应用详情文档 (Markdown) -│ └── Preview/ # [Asset] 预览图目录 -│ ├── 01.png -│ └── 02.jpg -│ -└── ... (其他应用目录) -``` +### 其他推荐 -### 3.1 命名约定 - -* **应用唯一标识 (`app_name`)**： - * 仅允许使用 **小写字母 (a-z)**、**数字 (0-9)** 和 **连字符 (-)**。 - * 应用目录名称必须与 `fnpack.json` 中的键名（Key）完全一致。 -* **大小写敏感**：Linux 文件系统对大小写敏感，请严格遵守文件名规范（特别是 `ICON.PNG`）。 - -## 4. 元数据规范 (fnpack.json) - -`fnpack.json` 是应用源的核心数据库，位于仓库根目录。它是一个标准的 JSON 对象，其键（Key）为应用的 `app_name`。 - -### 4.1 数据结构 - -```json -{ - "unique-app-id": { - "display_name": "String", - "version": "String", - "desc": "String", - "labels": "String", - "author": "String", - "author_url": "String", - "bug_report_url": "String", - "install_type": "Enum", - "size": "String", - "history": { - "version_number": "String" - } - } -} -``` - -### 4.2 字段定义表 - -| 字段 | 类型 | 必填 | 描述与约束 | -| :--- | :--- | :---: | :--- | -| **Key** | String | ✅ | 应用唯一标识。必须与应用文件夹名称完全一致。 | -| `display_name` | String | ✅ | 客户端展示的应用名称（UI 显示用）。 | -| `version` | String | ✅ | 当前版本号（建议遵循 SemVer 规范，如 1.0.0）。 | -| `desc` | String | ✅ | 应用简介。支持使用 `\n` 进行换行控制。 | -| `labels` | String | ✅ | 分类标签。多个标签使用半角逗号 `,` 分隔（无空格）。 | -| `download_url` | String | 可选 | 下载地址。建议 Release 发布后填写；若 fpk 小于 100MB 可不填写。 | -| `author` | String | ✅ | 开发者或维护团队名称。 | -| `author_url` | String | ✅ | 开发者主页/仓库链接 (HTTP/HTTPS)。 | -| `bug_report_url` | String | ✅ | 问题反馈链接 (HTTP/HTTPS)。 | -| `install_type` | String | ✅ | 安装目标路径类型。`"系统空间"` 或 `"存储空间"`。 | -| `size` | String | ✅ | 安装包体积。仅填写数字，单位默认为 **MB**。 | -| `history` | Object | ✅ | 版本更新记录。
**Key**: 版本号; **Value**: 更新日志内容。 | - -## 5. 资源文件规范 (Assets Specification) - -### 5.1 图标 (ICON.PNG) -* **路径**: `/{app_name}/ICON.PNG` -* **格式**: PNG -* **尺寸**: 建议 256x256 -* **注意**: 文件名必须为 **`ICON.PNG`**（全大写），否则客户端无法获取。 - -### 5.2 安装包 (.fpk) -* **路径**: - * **模式1**（fpk < 100MB）：`/{app_name}/{app_name}.fpk` - * **模式2**（fpk ≥ 100MB）：通过 Release 发布 -* **格式**: FNOS 标准安装包格式 (.fpk) -* **注意**: 文件名必须严格匹配 `{app_name}.fpk`。 - -### 5.3 预览图 (Preview/) -* **路径**: `/{app_name}/Preview/` -* **支持格式**: `.png`, `.jpg`, `.jpeg`, `.webp` 等 - -## 6. 完整配置示例 (Configuration Example) - -```json -{ - "fntermx": { - "display_name": "FntermX 终端", - "desc": "专为飞牛 NAS 打造的现代化 Web 终端\n支持 SSH 连接与会话管理", - "labels": "工具,终端,SSH,DevOps", - "version": "1.0.8", - "author": "EWEDL", - "author_url": "https://github.com/EWEDLCM", - "bug_report_url": "https://github.com/EWEDLCM/FntermX/issues", - "install_type": "系统空间", - "size": "15", - "history": { - "v1.0.8": "性能优化与 Bug 修复", - "v1.0.7": "新增深色模式支持", - "v1.0.0": "Initial Release" - } - } -} -``` - -## 7. 维护与更新 (Maintenance) - -FnDepot 客户端包含自动同步机制。开发者只需对 GitHub 仓库进行常规的 Git 操作即可完成发布： - -1. **更新二进制文件**：替换对应的 `.fpk` 文件。 -2. **更新元数据**：修改 `fnpack.json` 中的 `version` 字段并追加 `history` 记录。 -3. **推送 (Push)**：将更改推送到 GitHub 的默认分支。 - -客户端会在同步源信息时检测到 `version` 字段变更，正确响应状态。 - -## 8. 法律与免责声明 (Disclaimer) - -* **责任限制**：FnDepot 仅提供分发协议与索引服务。应用开发者需对其提交的代码安全性、稳定性及版权合规性负全部责任。 -* **安全合规**：严禁在应用源中包含恶意代码、后门程序或未经授权的侵权内容。违规仓库将被 FnDepot 索引服务拉黑并公示。 -* **数据安全**：开发者应在文档中明确告知用户应用的权限要求及潜在风险。 - -*** -*FnDepot Protocol Version 1.0* +- [雨云-云计算服务器](https://www.rainyun.com/MzEzNjM0_) +- 联系添加 diff --git a/fnpack.json b/fnpack.json index c6e5d87..83f24a0 100644 --- a/fnpack.json +++ b/fnpack.json @@ -40,5 +40,19 @@ "history": { "V4.5.0": "https://docs.zfile.vip/changelog/os" } + }, + "fpk-panindex": { + "display_name": "PanIndex", + "desc": "PanIndex是一个简易的网盘目录列表.跨平台、易部署、多模式，多账户、多主题、下载直链、防盗链.目前支持的网盘:本地目录、天翼云网盘、teambition盘（个人、项目、国际服）、阿里云盘、115网盘、123云盘、OneDrive. 本套件默认帐号：admin 密码：PanIndex", + "labels": "下载,网盘,同步", + "version": "3.1.5", + "author": "moxyis", + "author_url": "https://github.com/moxyis", + "bug_report_url": "https://github.com/moxyis/FnDepot/issues", + "install_type": "系统空间", + "size": "15", + "history": { + "V3.1.5": "https://github.com/px-org/PanIndex/releases/tag/v3.1.5" + } } } diff --git a/fpk-dnsmgr/fpk-dnsmgr.fpk b/fpk-dnsmgr/fpk-dnsmgr.fpk index b7c4307..1450289 100644 Binary files a/fpk-dnsmgr/fpk-dnsmgr.fpk and b/fpk-dnsmgr/fpk-dnsmgr.fpk differ diff --git a/fpk-panindex/ICON.PNG b/fpk-panindex/ICON.PNG new file mode 100644 index 0000000..7fd2766 Binary files /dev/null and b/fpk-panindex/ICON.PNG differ diff --git a/fpk-panindex/Preview/ScreenShot_2025-12-01_233540_303.png b/fpk-panindex/Preview/ScreenShot_2025-12-01_233540_303.png new file mode 100644 index 0000000..71ac03e Binary files /dev/null and b/fpk-panindex/Preview/ScreenShot_2025-12-01_233540_303.png differ diff --git a/fpk-panindex/Preview/ScreenShot_2025-12-01_233826_047.png b/fpk-panindex/Preview/ScreenShot_2025-12-01_233826_047.png new file mode 100644 index 0000000..20c60bd Binary files /dev/null and b/fpk-panindex/Preview/ScreenShot_2025-12-01_233826_047.png differ diff --git a/fpk-panindex/Preview/ScreenShot_2025-12-01_234003_318.png b/fpk-panindex/Preview/ScreenShot_2025-12-01_234003_318.png new file mode 100644 index 0000000..c70c039 Binary files /dev/null and b/fpk-panindex/Preview/ScreenShot_2025-12-01_234003_318.png differ diff --git a/fpk-panindex/README.md b/fpk-panindex/README.md new file mode 100644 index 0000000..c41eb5d --- /dev/null +++ b/fpk-panindex/README.md @@ -0,0 +1,58 @@ +# PanIndex +[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0) +[![GitHub go.mod Go version of a Go module](https://img.shields.io/github/go-mod/go-version/px-org/PanIndex.svg)](https://github.com/px-org/PanIndex) +[![GoReportCard](https://goreportcard.com/badge/github.com/px-org/PanIndex)](https://goreportcard.com/report/github.com/px-org/PanIndex) +![GitHub all releases](https://img.shields.io/github/downloads/px-org/PanIndex/total) +![Docker pulls](https://img.shields.io/docker/pulls/iicm/pan-index?color=%2348BB78&logo=docker&label=pulls) +![GitHub release (latest by date)](https://img.shields.io/github/v/release/px-org/PanIndex) +![GitHub last commit](https://img.shields.io/github/last-commit/px-org/PanIndex) +[![Nightly build](https://github.com/px-org/PanIndex/actions/workflows/nightly-build.yml/badge.svg)](https://github.com/px-org/PanIndex/actions/workflows/nightly-build.yml) + +--- +[English](https://github.com/px-org/PanIndex/blob/dev/README.md) | 中文 + +## 特性 +- [x] 跨平台、易部署 +- [x] 多模式、多存储 +- [x] 多主题 +- [x] 暗黑模式 +- [x] 文件预览（image, video, audio, code, pdf, epub, markdown） +- [x] 下载直链 +- [x] 防盗链 +- [x] 短链、分享链接 +- [x] 访问控制 +- [x] 分流 +- [x] WebDav + +## 支持的存储 +- 本地目录 +- [天翼云](https://cloud.189.cn/) +- [Teambition 团队盘](https://www.teambition.com/) +- [阿里云盘](https://www.aliyundrive.com/)（分享） +- 微软云盘 / Sharepoint([国际版](https://www.office.com/)、[世纪互联](https://portal.partner.microsoftonline.cn/)) +- [和彩云](https://yun.139.com/) +- [谷歌云盘](https://drive.google.com/) +- WebDav +- FTP +- [S3](https://aws.amazon.com/s3/)（对象存储） +- [PikPak](https://mypikpak.com "https://mypikpak.com") +- [115云盘](https://115.com/ "https://115.com/") +- [123云盘](https://www.123pan.com/ "https://www.123pan.com/") + +## 链接 +- [`dev`branch demo](https://t1.noki.icu "https://t1.noki.icu") +- [`dev`branch demo(Vuetify)](https://t2.noki.icu "https://t2.noki.icu") +- [Document](https://docs.noki.icu) +- [Nightly](https://nightly.link/px-org/PanIndex/workflows/nightly-build/dev) +- [PanIndex Tool](https://pt.noki.icu/) + +## 感谢 +- 主题源自 [JustList](https://github.com/txperl/JustList) 魔改 + +## 声明 +- 本程序免费开源，仅供交流学习使用，请遵循法律法规，由此产生的法律后果自行承担。 +- 本程序旨在分享网盘文件，方便下载，请勿滥用。在使用本程序之前，你应了解并承担相应的风险，包括但不限于账号被ban，下载限速等。 +- 如有侵权，请通过[邮件](mailto:ponbous@gmail.com)告知。 + +## License +[AGPL-V3](https://github.com/px-org/PanIndex/blob/dev/LICENSE) \ No newline at end of file diff --git a/fpk-panindex/fpk-panindex.fpk b/fpk-panindex/fpk-panindex.fpk new file mode 100644 index 0000000..fe9e4ec Binary files /dev/null and b/fpk-panindex/fpk-panindex.fpk differ diff --git a/merged-payment-qr.png b/merged-payment-qr.png new file mode 100644 index 0000000..0828d66 Binary files /dev/null and b/merged-payment-qr.png differ