DeepSeek Harness Hub
← 返回列表

tnnevol/fn-os-apps

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
需源码安装

飞牛 fnOS 应用 Monorepo

暂不能直接安装(需源码编译或环境不满足):缺少 main/exports/bin 入口声明;engines.node 要求 >=24.0.0,不满足 Node 22.19.0;仓库 package.json 标记 private,未发布到 npm,需从源码安装。 · 最近上游提交 2026/9/17 · 已提供中文文档
综合分
47.7
GitHub 分
47.7
用户评分
★ Stars
38
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add tnnevol/fn-os-apps
缺少 main/exports/bin 入口声明;engines.node 要求 >=24.0.0,不满足 Node 22.19.0;仓库 package.json 标记 private,未发布到 npm,需从源码安装,改用 GitHub 源安装
数据截至 2026/9/17(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包fn-os-apps(未发布到 npm,仅可源码安装)
Node 引擎要求 >=24.0.0 · 基线 Node 22.19 不满足
dsh CLI 依赖未声明 dsh 版本约束
入口文件缺少入口声明

缺少 main/exports/bin 入口声明;engines.node 要求 >=24.0.0,不满足 Node 22.19.0;仓库 package.json 标记 private,未发布到 npm,需从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 21:22:19

依赖的 DSH / Cordis 模块
@deepseek-ai/dsh@deepseek-ai/dsh-llm-pi-ai
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

fnOS 应用

飞牛 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

项目应用

| 应用                                                                        | 显示名称     | 说明                                                                                |
| --------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------- |
| fn-reader          | 阅读         | 开源在线电子书阅读器,支持多种格式、书架管理、阅读进度同步、全文搜索、主题定制      |
| fn-xiaoya-only     | 小雅         | 基于 Alist 的网盘聚合工具,支持多网盘挂载、在线播放、WebDAV、目录索引               |
| fn-bitwarden       | Bitwarden    | 开源密码管理器,安全存储网站登录信息、信用卡、安全笔记等                            |
| fn-mysql_v8        | MySQL v8     | MySQL 8.4.9 原生应用,非 Docker 容器化部署,支持远程访问配置和 DNS 优化             |
| fn-halo            | Halo         | 简洁高效的开源建站系统,支持博客、知识库、企业官网等多种场景                        |
| fn-quark-auto-save | 夸克转存     | 夸克网盘签到、自动转存、命名整理、推送提醒和刷新媒体库自动化工具                    |
| fn-new-api         | New API      | 新一代 AI API 管理与分发平台,支持多模型接入、令牌管理、配额控制等功能              |
| fn-zentao          | 禅道项目管理 | 国产开源项目管理软件,基于敏捷和 Scrum 理念,包含产品管理、项目管理、质量管理等模块 |
| fn-memos           | Memos        | 轻量级自托管笔记工具,支持 Markdown 编写、标签管理、多端同步                        |
| fn-moviepilot      | MoviePilot   | 影视自动化管理工具,支持媒体库管理、智能订阅、自动化整理等功能                      |
| fn-hermes-agent    | Hermes Agent | Nous Research 开发的 AI 代理,支持多平台消息网关、自主学习、技能创建、跨会话记忆    |
| fn-deepseek-harness                   | DeepSeek Harness | DeepSeek AI 开源的插件化智能代理工具,通过 Web UI 提供 dsh 操作界面                 |
| fn-uv              | uv           | 极速 Python 包管理器,替代 pip/pip-tools,提供虚拟环境和依赖解析能力                |
| fn-nvm             | NVM          | Node.js 版本管理工具,由 UID 1000 用户管理 NVM 和 Node.js 运行时                   |
| fn-ohmyzsh         | Oh My Zsh    | Zsh 配置管理框架,提供丰富的插件、主题和自动补全,增强命令行体验                    |

测试与安装

项目文档

pnpm install
pnpm run start -- --docs

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

本地快速安装(开发阶段推荐)

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

通过 fpk 文件安装

appcenter-cli install-fpk .fpk

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

手动安装模式(用于分发测试)

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

关闭
appcenter-cli manual-install disable

查看日志

日志路径
cat /var/apps//var/info.log

应用管理
appcenter-cli list
appcenter-cli start
appcenter-cli stop

版本发布

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

Tag 命名规范

v

| Tag 示例     | 版本                |
| ------------ | ------------------- |
| v4.0.0     | 4.0.0               |
| v4.1.0-rc1 | 4.1.0-rc1(预发布) |

发布步骤

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,文件名格式 -v4.0.0.fpk
- release — 生成中文 Release 文案 → 创建 GitHub Release,附带所有 .fpk 包

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

上架应用

上架流程:

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

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

manifest 字段参考

| 字段                         | 必填 | 说明                             | 示例                    |
| ---------------------------- | ---- | -------------------------------- | ----------------------- |
| appname                    | 是   | 应用唯一标识                     | fn-reader             |
| version                    | 是   | 版本号,格式 x[.y[.z]][-build] | 3.2.14                |
| display_name               | 是   | 显示名称                         | 阅读                  |
| desc                       | 是   | 应用描述(支持 HTML)            | 功能说明                |
| platform                   | 是   | 架构,x86 / arm / all      | x86                   |
| source                     | 是   | 应用来源                         | thirdparty            |
| maintainer                 | -    | 原始维护者                       | GitHub ID               |
| maintainer_url             | -    | 原始项目地址                     | URL                     |
| distributor                | -    | 分发者                           | GitHub ID               |
| distributor_url            | -    | 分发者主页                       | URL                     |
| service_port               | -    | 服务端口                         | 4396                  |
| os_min_version             | -    | 最低 fnOS 版本                   | 0.9.27                |
| desktop_uidir              | -    | UI 目录名                        | ui                    |
| desktop_applaunchname      | -    | 桌面启动项                       | .Application |
| disable_authorization_path | -    | 禁用目录授权                     | true                  |

开发资源

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

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群