首发!DeepSeek Harness 飞牛商店专属版一键部署与实测

AI教程

首发!DeepSeek Harness 飞牛商店专属版一键部署与实测

3010 字 15 分钟

如果你想在自己的飞牛 NAS 上运行 DeepSeek Harness,却不想先折腾 Node.js、代理、跨域和一堆命令行配置,这个版本可以直接试试。

我把 DeepSeek Harness(下文简称 DSH)重新打包成了适配飞牛 fnOS 的 .fpk 安装包,并针对飞牛的应用中心、文件管理和局域网访问做了定制。安装时不需要手动搭建 Node 环境,按照向导操作即可完成初始化。

先说清楚:本文所说的“飞牛商店专属版”,指的是面向 fnOS 应用中心手动安装流程定制的版本,并不代表它已经进入飞牛官方应用商店。安装包和源代码均以本文提供的链接及 GitHub Releases 页面为准。

一、DeepSeek Harness 到底是什么#

普通网页聊天通常是“你提问,AI 返回代码,你再复制到电脑里执行”。Harness 更像一个面向开发任务的 Agent 工作台:给它一个工作区后,它可以读取项目文件、分析目录和依赖,在得到授权的情况下调用终端、修改文件,再把结果反馈回来。

换句话说,它不是只负责回答问题的聊天框,而是把模型、工作区和工具调用放在了一起。你可以让它先分析项目,再决定是否执行命令;也可以让它协助生成代码、检查错误和整理文件。

不过要注意,Harness 能做什么取决于它实际拥有的目录权限和工具权限。不要把包含密码、私钥、生产数据库配置或客户资料的目录直接交给它,更不要一上来就授权删除文件、重置服务或修改系统配置。

二、这次 fnOS 定制版改了什么#

这次打包的重点不是简单把网页套进一个安装包,而是把安装、配置和工作区整理成适合飞牛用户的流程:

  • FPK 离线安装:在飞牛应用中心通过“手动安装”上传 .fpk,不需要先在 NAS 上配置 Node.js。
  • 两步安装向导:默认内置安装所需的基础参数,向导主要让你填写 API Key;没有密钥时也可以先跳过,之后再补充。
  • 默认公益 API 线路:当前安装包内置 https://api.910501.xyz/v1 作为默认接口,并锁定一万 AI 分享 DSH 专用模型。使用前请确认账户额度和服务状态,不要把公益线路当成永久稳定的生产依赖。
  • 工作区与飞牛文件管理互通:应用工作目录桥接到“应用文件”中的 DeepSeekHarness 文件夹,项目可以直接复制进去,也可以从这里下载结果。
  • 局域网 HTTP 适配:针对部分内网非 HTTPS 场景加入了安全上下文兼容和反向代理适配,但这不等于可以把服务端口直接暴露到公网。
  • x86 与 ARM64 分包:Intel / AMD 设备和 ARM NAS 必须选择对应架构的安装包,不能混用。

程序运行效果如下:

DeepSeek Harness 在飞牛 fnOS 上运行
DeepSeek Harness 在飞牛 fnOS 上运行

三、下载前先确认三件事#

1. 确认 NAS 架构#

在飞牛系统信息中确认你的设备是 x86_64 还是 ARM64:

NAS 类型应选择的文件常见设备
x86_64*_x86.fpkIntel 或 AMD 处理器设备
ARM64*_arm.fpkRockchip、Allwinner、树莓派等 ARM 设备

不要因为文件名看起来相似就随便安装。原生依赖需要匹配目标架构,架构选错可能导致应用一直停留在“启动中”,或者网页能打开但工具调用失败。

2. 下载安装包#

我整理的打包下载入口:

夸克网盘打包下载

如果你想查看源代码、构建记录和最新版本,建议优先使用项目仓库的 Releases 页面:

截至本文发布时,Releases 页面显示的最新版本为 v0.1.0-rc.6.3,同时提供 x86_64 和 ARM64 安装包。版本会继续更新,实际下载时请以 Releases 页面标记的 Latest 版本为准。

3. 先做一次备份#

如果你已经安装过旧版本,升级前建议先备份 DeepSeekHarness 工作区和应用配置。覆盖安装通常不会主动清空工作区,但不同版本的迁移规则可能变化,重要项目不要只保留一份。

四、飞牛 fnOS 两步安装#

第一步:在应用中心手动安装#

  1. 登录飞牛 fnOS 管理后台。
  2. 打开 应用中心
  3. 点击右上角的 手动安装
  4. 从电脑选择刚才下载的 .fpk 文件。
  5. 阅读提示后点击同意并继续。

飞牛会先上传并校验安装包。这个阶段不要关闭浏览器,也不要重复点击安装按钮,等待应用中心完成解包即可。

第二步:填写安装向导#

安装向导已经把常用的基础配置预先准备好了,通常只需要处理 API Key:

  1. 如果你已经有可用的公益 API Key,把它粘贴到向导中。
  2. 如果暂时没有 API Key,可以先留空并继续,之后在应用设置中补充。
  3. 确认配置后点击下一步,等待环境初始化和后台服务启动。

当前版本内置的默认接口是:

https://api.910501.xyz/v1

这是本次 fnOS 定制版预置的公益线路,不是 DeepSeek 官方 API。API Key、额度、模型可用性和服务稳定性都以实际控制台状态为准;如果你有长期或重要项目,建议改用自己管理的 API 服务。

初始化完成后,飞牛桌面会出现 DeepSeek Harness 图标。点击图标即可进入控制台。

五、第一次运行怎么测试#

第一次不要直接让它重构整个项目,先用只读任务确认应用、模型和工作区都正常。

可以先发送:

请先读取当前工作区的目录结构,告诉我项目使用的主要技术、启动方式和可能的风险。
不要修改任何文件,也不要执行删除、安装或重启命令。

如果它能够列出目录并给出合理分析,再进行第二步测试:

请检查当前项目是否可以在本地启动。
只执行读取和检查命令,不要修改文件;如果必须执行下一步操作,请先列出方案并等待我确认。

这样可以把问题拆开判断:

  1. 页面是否能正常打开;
  2. API Key 和模型是否能正常调用;
  3. 工作区是否能被读取;
  4. 工具调用和终端权限是否符合预期。

运行截图:

DeepSeek Harness 程序运行截图
DeepSeek Harness 程序运行截图

六、工作区和飞牛文件管理互通#

打开飞牛桌面的 文件管理,在左侧进入:

应用文件 → DeepSeekHarness

这个目录就是 DSH 的工作区桥接目录:

  • 你可以把电脑上的工程源码复制到这里,再让 Harness 分析或修改;
  • Harness 创建的项目和代码文件,也会出现在这里;
  • 完成后可以直接在飞牛文件管理中预览、打包、下载或分享。

建议给每个项目单独建立文件夹,并且只把当前任务需要的文件放进去。这样既方便回滚,也能减少模型误读无关配置的概率。

权限提醒:工作区里的文件会被应用读取。不要把 .env、SSH 私钥、云厂商密钥、数据库密码和客户数据直接复制进去。需要分析配置时,可以先用脱敏副本替代。

七、局域网访问和手机端使用#

这次定制版针对飞牛内网 HTTP 场景做了兼容处理,部分浏览器在访问局域网地址时遇到的安全上下文和跨域问题会少一些。但这只解决应用适配问题,不等于内网服务天然安全。

如果你想在手机端通过飞牛 App 或浏览器访问,需要先满足:

  • NAS 已配置可靠的远程访问方式;
  • 访问链路尽量使用 HTTPS 或可信的内网组网方案;
  • 只开放必要的反向代理路径,不要直接暴露管理端口;
  • API Key 和管理员账号启用强密码,并避免在公共设备上保存会话。

如果只是家里局域网使用,建议先完成本地验证,再考虑远程访问。不要为了“随时随地能用”直接把 NAS 管理后台和 Harness 端口裸露到公网。

八、如何升级#

项目源码和安装包会继续放在 GitHub:

打开 DeepSeek Harness fnOS 项目

升级流程建议如下:

  1. 打开 Releases 页面,查看最新版本和变更说明。
  2. 根据 NAS 架构下载 *_x86.fpk*_arm.fpk
  3. 备份 DeepSeekHarness 工作区和重要配置。
  4. 在飞牛应用中心再次选择 手动安装,上传新版本并按提示覆盖安装。
  5. 启动后先检查工作区、API 配置和一个只读测试任务。

当前仓库的发布流程会分别构建 x86 和 ARM64 包。后续如果版本升级涉及原生依赖、数据结构或配置迁移,请以对应 Release 的升级说明为准,不要仅凭“覆盖安装”四个字判断一定可以无感升级。

九、常见问题#

1. 应用一直显示“启动中”#

优先检查:

  • 是否下载了错误架构的安装包;
  • 是否使用了过旧版本;
  • 应用日志中是否有原生依赖加载失败;
  • NAS 存储空间和内存是否足够。

如果你使用的是较早的候选版本,建议先查看 Releases 更新说明,再升级到最新版本重试。

2. 页面能打开,但模型没有回复#

检查 API Key 是否完整、账户是否有额度、默认接口是否可访问。如果你手动修改过接口地址或模型配置,先恢复到当前安装包的默认配置,确认基础链路正常后再逐项修改。

3. 工作区里看不到项目文件#

确认文件是否放在:

应用文件/DeepSeekHarness

不要只把文件放在 NAS 的其他共享文件夹中,然后期待应用自动读取。必要时检查应用用户对工作区的读写权限。

4. 可以让 Harness 直接改生产项目吗?#

不建议。先复制一份测试项目,要求它只读分析;涉及删除文件、安装依赖、修改服务配置、执行数据库操作时,必须先查看方案并人工确认。AI 能帮你执行命令,也可能把错误命令执行得很快。

总结#

DeepSeek Harness fnOS 定制版的安装流程可以概括为:

  1. 根据 NAS 架构下载对应的 .fpk
  2. 在飞牛应用中心手动安装;
  3. 在向导中填写 API Key,或先跳过;
  4. 启动 DeepSeek Harness,先做只读测试;
  5. 将项目放入 应用文件/DeepSeekHarness 工作区;
  6. 确认权限和远程访问安全后,再安排实际开发任务。

如果你一直被 Node 环境和命令行配置劝退,这个 FPK 版本可以先帮你把“安装门槛”降下来。后续如果大家对自动写代码工作流、完整项目实战和 NAS 远程开发感兴趣,我再继续做更深入的教程。

相关链接:

如果在安装或使用过程中遇到问题,建议留言时一并提供 NAS 架构、fnOS 版本、安装包版本、应用日志和具体报错,不要只留一句“不能用”。

关注一万 AI 分享

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或赞助支持!

赞助

目录