techysy/deepseek-harness-fnos

🚀 适用于 fnOS 的 DeepSeek Harness

GitHub release
License: MIT
dsh
fnOS
[Node.js]()
[bun]()

DeepSeek 官方 Agent 浏览器 UI（一切皆插件）的 fnOS 快捷入口。

- 🎯 目标：https://www.deepseek.com/harness/（DeepSeek Harness 开发者预览版）
- 🐳 离线自托管：@deepseek-ai/dsh（含 node_modules）随 fpk 内置，安装免联网
- 🐋 图标：DeepSeek 官方黑色鲸鱼 logo

下载安装

从 Releases 下载 fpk，在 fnOS App Center 手动安装。

版本说明

当前版本：0.1.5-rc.2（升级上游 dsh 0.1.5-rc.2，新增 28001 管理面板）

| 文件 | 架构 | 类型 | 说明 |
|------|------|------|------|
| dsh-0.1.5-rc.2-iframe-x86.fpk | x86 | iframe | 桌面窗口内打开（推荐） |
| dsh-0.1.5-rc.2-x86.fpk | x86 | url | 新标签页打开 |
| dsh-0.1.5-rc.2-iframe-arm.fpk | ARM | iframe | 桌面窗口内打开（推荐） |
| dsh-0.1.5-rc.2-arm.fpk | ARM | url | 新标签页打开 |

全部为离线包（含对应架构 node_modules），安装免联网。ARM 版在 manylinux_2_28 容器构建，兼容旧 glibc。

访问方式

dsh 以 fnOS 应用（dsh 用户常驻服务）运行，web 服务绑 0.0.0.0:28000，提供多条访问入口：

| 入口 | 地址 | 说明 |
|------|------|------|
| fnOS 桌面图标 | http://127.0.0.1:28000 | 桌面图标 iframe/url 直连，无需网关 |
| 局域网 / Tailscale | http://:28000 | 局域网设备直接访问 |
| FN Connect | https://dsh..fnos.net | FN 鉴权后公网直达（安装向导填 FN ID 自动配置信任域） |
| fnOS 统一网关（可选） | /app/dsh | 经 app.sock → proxy.py → 127.0.0.1:28000 |

安全机制（0.1.2-rc.1 现状）：

- 信任围栏：/api/ 校验 Host/Origin，仅放行回环 + --trusted-host 列表（本机非回环 IP 自动探测 + fnos.net + trusted_hosts.conf 自定义域名），其余来源 403
- 桌面免 401：上游 0.1.2 的浏览器 token 鉴权对静态桌面入口不可用，fpk 运行时补丁对围栏内请求放行（等效"围栏即认证"，请勿将 28000 端口暴露到不受信任网络）
- 0.0.0.0 绑定：cordis.patch.yml 覆盖 webserver 配置（dsh CLI 层拒绝 --host 0.0.0.0）
- 设置页 host 模式：构建期补丁使非 loopback 访问也能读写服务端配置

📖 围栏与回环限制详解：docs/dsh-loopback-restriction.md · docs/dsh-access-and-gateway.md

🛠️ 管理面板（28001）

0.1.5-rc.2 起内置独立管理面板，随 dsh 自动启动，浏览器打开：

http://:28001/

| 功能 | 说明 |
|------|------|
| 服务状态 | dsh web 进程/健康检查/运行时长、网关代理、当前版本 |
| 日志查看 | app.log（生命周期）/ dsh.log（dsh 输出）/ 面板日志，tail 尾部 + 5s 自动刷新 |
| 插件管理 | 第三方插件禁用/启用/删除/安装（profile bundles 开关，重启 dsh 生效）——插件不兼容导致启动崩溃循环时可在此快速禁用 |
| 版本检查 | 上游 dsh npm latest 对比当前版本 + 本项目最新 Release 链接 |
| 一键重启 dsh | 面板自身不受重启影响 |
| 📥 一键更新 | 检测到新版本后一键下载对应架构 fpk（Gitee 优先）到 NAS，再点「安装更新」自动完成安装+重启（需一次性 sudo 授权，见下） |

- 零依赖（纯 node，随 fpk 内置），信任面与 dsh 一致：本机/局域网 IP + fnos.net + 自定义信任域可访问，其余来源 403
- 日志落点：数据区 dashboard.log；升级/卸载由 uninstall_callback 统一清理
- 启用热更新（一次性，SSH 到 NAS 执行）：
echo 'dsh ALL=(root) NOPASSWD: /usr/local/bin/appcenter-cli install-fpk /vol/@appdata/dsh/dsh_home/update/*' | sudo tee /etc/sudoers.d/dsh-hotfix
sudo chmod 440 /etc/sudoers.d/dsh-hotfix

授权后「安装更新」按钮生效；不授权则按钮会提示失败，走应用中心手动安装（下载的 fpk 在数据区 dsh_home/update/）
- 旧版本 fpk 想用面板：把仓库 cmd/dashboard.js + 最新 cmd/main 拷到 /var/apps/dsh/cmd/ 后重启 dsh 即可（注意转换 CRLF）

安装

1. App Center 手动安装选下载的 fpk（推荐 iframe 版）
2. 安装向导填 DeepSeek API Key（sk- 开头，可留空后配置）与 FN ID（如 techysy，用于 FN Connect 信任域）
3. fnOS 桌面打开 DeepSeek Harness 图标进入 UI

依赖：fnOS 自动安装 nodejs_v24 + bunjs（install_dep_apps），dsh 的 Agent 环境可直接使用 node/npm/pnpm/bun。

配置

DeepSeek API Key

- 安装向导填写，或编辑数据区 dsh_home/.env：
DEEPSEEK_API_KEY=sk-xxx

- 也可在 dsh 设置页内直接配置官方 / 自定义提供方的 API Key（改后重启应用生效）

端口

| 服务 | 端口/路径 | 说明 |
|------|-----------|------|
| dsh web | 0.0.0.0:28000 | DeepSeek Harness 浏览器 UI（局域网直连） |
| 桌面入口 | 127.0.0.1:28000 | fnOS 桌面图标直连 |
| 网关 socket | app.sock → proxy.py | 统一网关 /app/dsh 入口（可选） |

网络代理（可选）

向导或应用设置页填写代理，写入 dsh_home/proxy.conf（PROXY=http://127.0.0.1:7890），dsh 的出站请求（git/npm/API）走该代理；留空不走代理。上游 0.1.2 起也遵循启动环境的 HTTP_PROXY/HTTPS_PROXY/ALL_PROXY/NO_PROXY。

构建

两条打包路径（详见 docs/packaging-fpk.md）：

GitHub Actions 在线打包（推荐） — 手动触发，产出到 artifacts：

gh workflow run build-fpk.yml -f arch=x86    # 或 -f arch=arm
gh run watch                                  # 下载: gh run download

离线脚本（NAS 本机，x86 打包机 / ARM 详见 docs/arm-build.md）：

bash scripts/build-x86-offline.sh             # url 版 + iframe 版，交付到应用中心扫描目录

上游升级 SOP 与补丁核对：docs/upstream-sync-checklist.md。

Agent 环境命令检查

安装后可在 dsh 的 Agent / bash 工具里直接使用以下命令（来自 fnOS 依赖应用，自动加入 PATH）：

| 命令 | 来源 | 版本验证 | 数据落点 |
|------|------|---------|---------|
| node | nodejs_v24 依赖 | node -v | — |
| npm / npx | nodejs_v24 | npm -v | 全局安装 → 数据区 .npm-global |
| pnpm / yarn | corepack（nodejs_v24） | pnpm --version | corepack 缓存 → 数据区 .corepack |
| bun | bunjs 依赖 | bun --version | — |
| corepack | nodejs_v24 | corepack --version | — |

一键验证全部命令
node -v && npm -v && pnpm --version && yarn --version && bun --version

文档

- fpk 打包指南 — 在线 Actions / 离线脚本双路径、版本号策略（跟随上游，本地修复不抬版）、升级 SOP
- 同步上游后检查清单 — 每次同步上游/重装后验证本地补丁是否还在
- 访问与网关 — 多入口访问、proxy.py 网关细节
- 回环限制详解 — 信任围栏 / trusted-host / settings host-mode
- ARM 离线打包
- dsh Node.js 自托管 — node/npm 基础接入
- dsh Agent 命令兼容矩阵 — node/npm/npx/pnpm/yarn/bun/corepack 完整命令 + 数据区配置