FNOSP/fnos-dsh

DeepSeek Harness应用与harness插件 monorepo

Project Overview项目介绍

fnos-dsh is a monorepo maintained by the FNOSP organisation that adapts DeepSeek Harness into an installable native application for Feiniu fnOS NAS systems, while simultaneously producing a set of standalone extension plugins and shared UI components that can be installed into a regular DSH client. The repository is organised with pnpm Workspaces on top of Turborepo and ships a unified CLI that coordinates lint, type-check, build, packaging, versioning and release workflows, so contributors can drive the documentation site, individual plugin packages and the local DSH Web runtime from the same root scripts.

A typical contributor workflow begins by cloning the repository, running nvm use to align Node versions, and executing pnpm install to materialise the workspace dependencies. From there, pnpm run start boots the local development harness, and the same command accepts flags such as --docs to launch the VitePress documentation site, --plugin fnos to iterate on the fnOS adapter package, or --web to run the embedded DSH Web environment for browser-based testing. The intended audience is twofold: operators and home NAS users who want to deploy DeepSeek Harness on fnOS hardware, and third-party plugin authors who need a reproducible build and release pipeline for DSH client extensions.

The project pins hard runtime requirements, namely Node.js 24 or newer and pnpm 11.16 or newer, and documents a stack of TypeScript, Shell scripts, Turborepo, tsdown, Vite, fnpack, VitePress with Mermaid diagrams and the Semi Design UI library. Distribution relies on the fnpack toolchain, with the final application produced via pnpm run build -- --fpk --app fn-deepseek-harness, which generates a signed .fpk artefact that the fnOS app manager can install, upgrade or remove at runtime. Licensing is GNU Affero General Public License v3.0, so any network-served derivative must publish corresponding source under the same terms. First-time contributors should verify their Node toolchain, fnOS host version and fnpack availability before building, because missing signing keys or mismatched runtime versions will fail the packaging step.

fnos-dsh 是 FNOSP 组织维护的 monorepo 项目,目标是将 DeepSeek Harness 适配并打包为可安装的飞牛 fnOS 原生应用,同时为 DSH 客户端开发可独立安装的扩展插件与共享 UI 组件。项目通过 pnpm Workspace 与 Turborepo 组织多个子包,提供统一的 CLI 来管理检查、构建、打包、版本与发布流程,开发者可以按需启动文档站、插件或本地 DSH Web。

典型工作流是先克隆仓库并执行 nvm use 与 pnpm install 完成环境准备,再通过 pnpm run start 启动本地开发模式,分别用 --docs、--plugin fnos、--web 参数选择文档站、插件或本地 DSH Web 子项目。目标用户分为两类:一类是想在飞牛 fnOS NAS 上部署和运行 DeepSeek Harness 的运维与个人用户,另一类是为 DSH 客户端编写、构建并发布第三方扩展插件的开发者。打包阶段使用 tsdown、Vite 与 fnpack,最终通过 pnpm run build -- --fpk --app fn-deepseek-harness 输出可安装的 .fpk 应用。

依赖方面要求 Node.js 24 及以上版本、pnpm 11.16 及以上版本,技术栈涵盖 TypeScript、Shell、Turborepo、VitePress、Mermaid 与 Semi Design UI,运行时需要 fnOS 系统提供网关代理和 DSH Web 运行环境适配。项目采用 GNU Affero General Public License v3.0 开源协议发布,二次分发需遵守 AGPL 条款并保留源码。首次运行前请确认本机 Node 版本、fnOS 系统版本以及 fnpack 工具链可用,否则构建可能因签名或资源校验失败而中断。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 15 stars - an early-stage project星标 15,属于早期项目
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:FNOSP/fnos-dsh

把 FNOSP/fnos-dsh 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

fnOS DSH

GitHub Logo   ·   DeepSeek Harness Logo

GitHub GitHub stars License

Node.js pnpm TypeScript Turborepo VitePress Semi Design fnOS

飞牛 fnOS 上的 DeepSeek Harness 应用与插件生态项目。

项目简介

本项目用于将 DeepSeek Harness 适配并打包为可安装的 fnOS 应用,同时维护可独立安装到 DSH 客户端的插件和配套工具。

项目面向两类场景:

  • 在飞牛 fnOS 上安装和运行 DeepSeek Harness
  • 为 DSH 客户端开发、构建和发布扩展插件

核心能力

  • 提供 DeepSeek Harness 的 fnOS Native 应用适配
  • 支持 fnOS 应用的安装、升级、卸载和运行时管理
  • 提供 fnOS 网关代理和 DSH Web 运行环境适配
  • 支持 DSH 客户端插件及共享 UI 组件开发
  • 提供本地 DSH Web、插件和文档开发能力
  • 通过统一 CLI 管理检查、构建、版本和发布流程

技术栈

类型 技术
包管理 pnpm Workspace
Monorepo Turborepo
开发语言 TypeScript、Shell
构建工具 tsdown、Vite、fnpack
文档 VitePress、Mermaid
UI Semi Design
应用形态 fnOS Native
运行环境 Node.js 24、pnpm 11

快速开始

环境要求

  • Node.js 24 或更高版本
  • pnpm 11.16 或更高版本

安装依赖

nvm use
pnpm install

启动开发环境

pnpm run start

也可以按需启动文档站、插件或本地 DSH Web:

pnpm run start -- --docs
pnpm run start -- --plugin fnos
pnpm run start -- --web

构建与检查

pnpm run build -- --plugin fnos
pnpm run build -- --fpk --app fn-deepseek-harness
pnpm run check -- --all

文档

本地预览文档站:

pnpm run start -- --docs

开源协议

GNU Affero General Public License v3.0

← 上一个 Prev dsh-memory-eternal 下一个 Next dsh-vision-proxy →