fnOS Apps

飞牛 fnOS 应用 Monorepo，包含上架到 fnOS 应用商店的第三方应用打包。

项目结构

.
├── apps/
│   ├── fn-reader/                  # 阅读 - 在线电子书阅读器
│   ├── fn-xiaoya-only/             # 小雅 - 网盘聚合工具
│   ├── fn-bitwarden/               # Bitwarden - 密码管理器
│   ├── fn-mysql_v8/                # MySQL v8 - 关系型数据库(原生应用)
│   ├── fn-halo/                    # Halo - 建站系统
│   ├── fn-quark-auto-save/         # 夸克转存 - 夸克网盘自动化工具
│   ├── fn-new-api/                 # New API - AI API 管理平台
│   ├── fn-zentao/                  # 禅道项目管理 - 项目管理软件
│   ├── fn-memos/                   # Memos - 自托管笔记
│   ├── fn-moviepilot/              # MoviePilot - 影视自动化管理
│   ├── fn-hermes-agent/            # Hermes Agent - AI 代理(原生应用)
│   ├── fn-deepseek-harness/        # DeepSeek Harness - 插件化智能代理(原生应用)
│   ├── fn-uv/                      # uv - Python 包管理器(系统工具)
│   ├── fn-nvm/                     # NVM - Node.js 版本管理工具(系统工具)
│   └── fn-ohmyzsh/                 # Oh My Zsh - Zsh 配置管理框架
├── plugins/                        # Agent 插件 workspace
├── .github/workflows/              # CI: FPK 构建与 Release 发布
├── docs/                           # VitePress 项目文档
├── package.json                    # 项目版本与开发脚本
├── .gitignore
└── README.md

项目应用

测试与安装

项目文档

pnpm install
pnpm run start -- --docs

生产构建使用 pnpm run build -- --docs，构建结果位于 docs/.vitepress/dist/。

本地快速安装（开发阶段推荐）

# 在 fnOS 设备上，进入应用目录直接安装
cd /path/to/<appname>
appcenter-cli install-local

通过 fpk 文件安装

appcenter-cli install-fpk <appname>.fpk

# 带环境变量静默安装
appcenter-cli install-fpk <appname>.fpk --env config.env

手动安装模式（用于分发测试）

# 开启手动安装入口
appcenter-cli manual-install enable

# 关闭
appcenter-cli manual-install disable

查看日志

# 日志路径
cat /var/apps/<appname>/var/info.log

# 应用管理
appcenter-cli list
appcenter-cli start <appname>
appcenter-cli stop <appname>

版本发布

通过 GitHub Actions 自动完成 FPK 构建和 Release 发布。项目版本工具位于 tooling/fn-os-apps-cli workspace，通过 fn-apps-cli CLI 使用 bumpp 维护项目/FPK 版本；插件版本由 CLI 直接更新并提交。

Tag 命名规范

v<版本号>

发布步骤

1. 代码变更并推送

git add apps/
git commit -m "feat: 更新多个应用"
git push origin main

2. 推送版本 Tag 触发发布

pnpm run version -- project patch
git push origin main && git push origin v<版本号>

version 使用 bumpp 更新根 package.json、packages/*/package.json、与项目版本匹配的 apps/*/manifest 和 README 中的版本示例，然后创建项目提交和 v<版本号> Tag。插件版本不会被项目版本命令修改。

插件需要单独指定目标插件维护版本：

pnpm run version -- plugin fnos patch
pnpm run version -- plugin codex patch
pnpm run version -- plugin showcase patch

插件版本命令支持多选插件；多选时一次性修改所有选中插件，只生成一条合并提交，不创建 Git Tag。若插件出现在 apps/fn-deepseek-harness/app/published-dsh-plugins.json，其清单版本会与插件 package.json 同步更新。

3. GitHub Actions 自动执行

• discover — 扫描 apps/ 目录，收集所有应用名
• build — 为每个应用并行构建 FPK，文件名格式 <app>-v4.0.0.fpk
• release — 生成中文 Release 文案 → 创建 GitHub Release，附带所有 .fpk 包

单个应用也可以在自己的目录中执行 ./build 构建。fn-deepseek-harness 的构建脚本默认自动递增 patch 版本。

上架应用

上架流程：

1. 加入飞牛粉丝群（fnos.com 二维码）→ 联系社区主理人加入 应用中心开发者先锋交流群
2. 提交基础信息完成认证（个人/企业信息、代表作品、技术栈等）
3. 获取官方文档 → 创建应用 → 提交审核 → 上架

开发者后台即将上线，在此之前通过群内专员协助完成内测和上架。

manifest 字段参考

开发资源

• 飞牛开发者官网
• fnpack 下载
• 通用 CGI 网关集合