DeepSeek Harness 桌面端 Linux 怎么装？DSH plugin 桌面应用安装

Linux 上目前装不了 DeepSeek Harness 桌面端——官方只发布 macOS 与 Windows 安装包，桌面端 README 明确 Linux 不是其发布目标（来源）。 这不是坏消息：Linux 走命令行版即可拿到同源的图形界面。这篇按三个方向讲：为什么没有、等价路径怎么走、以及有哪些坑。

概览：Linux 桌面端先给结论，再谈 DeepSeek Harness 的替代

一句话：Linux 没有官方桌面端安装包，正确做法是用命令行版启动 Web UI。

原因也不复杂：桌面端是包裹 dsh Web UI 的 Electron 应用，需要为每个平台单独构建与签名发布；官方当前的发布目标只有 macOS 与 Windows（来源）。Linux 的需求由命令行版承接。

为什么 Linux 上没有 DeepSeek Harness 桌面端：形态与发布目标

三形态里，Linux 最合适的那一支本来就存在——命令行版自带 Web 界面。

1. 桌面端 = Electron 壳 — 它把 Web UI 包进独立应用，界面通过应用内协议加载，不面向浏览器。预期：这类发布要按平台分别出包，官方暂时只覆盖 macOS 与 Windows。
2. Linux 的等价形态 = 命令行版 + 浏览器 — 用 dsh web 起本地 Web 服务，浏览器访问即是同一套界面。预期：Linux 上同样有完整图形界面，只是外壳换成浏览器。
3. 别信「Linux 桌面版」 — 官方没有理由让你从第三方拿安装包，第三方「绿色版」「汉化版」都不受支持。预期：只从官方渠道获取任何安装包。

Linux 上怎么装 DeepSeek Harness：命令行版两步走

按你的使用习惯二选一，装完用浏览器访问：

1. 免安装试用：

npx @deepseek-ai/dsh web

预期：终端打印本地地址，浏览器打开即进入界面。

2. 长期使用，全局安装：

npm install -g @deepseek-ai/dsh
dsh web

预期：任何目录都能直接敲 dsh web，服务默认监听 127.0.0.1:3080。

两种方式的取舍见《三种安装方式对比》，平台细分可参考《按平台安装》。装好本体、连上模型之后，插件从内置市场补齐：打开 Web UI 里的 DSH Plugin Hub，按分类浏览、一键安装即可。

关于 profile：命令行版用 web profile，桌面端独占 desktop profile，Linux 上只涉及前者（来源）。会话、设置与凭据都落在同一个 $DSH_HOME（默认 ~/.dsh），与其它平台一致。

装 DeepSeek Harness 的常见坑：依赖、无 GUI 环境与受限网络

Linux 上出问题多半不在「装不上」，而在环境与网络。

1. 依赖缺失 — Node 与包管理器版本过低会在第一步就报错；从源码装时可能缺原生构建依赖（编译工具链）。预期：先确认 Node 可用，再决定是否走源码路径。
2. 无沙箱 / 权限受限环境 — 容器或受限权限下写入 $DSH_HOME 可能失败，需要给它可写目录。预期：把数据根指向你有权写入的位置。
3. 无图形界面的服务器 — dsh web 只绑 127.0.0.1，远程要访问就做 SSH 端口转发，在本地浏览器打开，并注意启动令牌认证的地址。预期：远程也能进界面，但别把监听地址对外放开。
4. 纯内网 — npx 与在线安装都要联网拉包，纯内网应改用离线包或本地镜像。预期：不联网也能装起，见《离线安装与内网部署》。
5. 与命令行版共存 — Linux 上只有命令行版，不存在桌面端抢占 profile 的问题；但如果从别处拷来 ~/.dsh，仍要确认凭据与配置能正常复用。

在 Linux 上安装 DeepSeek Harness 的注意事项

1. 别装第三方「Linux 桌面版」：官方不发布，来源不明的包风险自负。
2. 认准官方包名：命令行版是 @deepseek-ai/dsh，不要装同名仿冒包。
3. 远程别放开监听：dsh web 默认仅本机可达，远程访问用 SSH 端口转发。
4. 数据位置统一：$DSH_HOME 默认 ~/.dsh，迁移前先确认影响范围。
5. 等官方更新：若官方未来增加 Linux 发布目标，以官网下载页为准，别提前按旧教程猜包名。

来源：DeepSeek Harness 桌面端 README、DeepSeek Harness 桌面端下载、dsh CLI README