DeepSeek Harness 的 Linux 原生桌面集成

前言¶

dsh web 提供完整的 Web 界面，但在 Linux 桌面上有三处不便：没有独立的任务栏与 Alt-Tab 条目；服务生命周期依附于终端；社区的桌面类插件主要面向 Windows 与 macOS，面向 Linux XDG 桌面入口的实现较为少见。dsh-linux-integration 插件旨在补齐这三处。

它是什么¶

dsh-linux-integration 是一个 DSH bundle，由 ffyfox 维护。它复用系统已有的 Chromium 系浏览器，用标准 XDG 桌面入口把 dsh web 接入桌面环境，并且不修改 dsh web 自身的行为。

核心功能¶

XDG 桌面入口：在 ~/.local/share/applications/ 写入标准配置文件，使 dsh web 可以从程序启动器启动。
无边框独立窗口：使用 Chromium 的 --app 模式打开窗口，只有界面内容，没有地址栏、标签页或书签栏。
生命周期管理：在 dsh web 未运行时启动它，并在窗口关闭后停止由自己启动的服务。
命令行垫片：提供 dsh-lxi 命令用于维护和诊断。
配置界面：集成到 DSH 的侧栏插件页中。

安装与启用¶

在终端中执行以下命令安装插件：

dsh plugin --profile web add dsh-linux-integration

安装后重启一次 dsh web。安装过程会将插件注册到 profile 的 dsh.profile.bundles。

如果需要从 GitHub 安装特定版本，可以使用：

dsh plugin --profile web add github:ffyfox/dsh-linux-integration#v0.7.0

使用方法¶

从程序启动器（KRunner、应用菜单或任务栏固定项）点击 DeepSeek Harness。

启动器的工作流程如下：
1. 取单实例锁，确保只有一个实例管理服务生命周期。
2. 探测 dsh web 是否已在监听（HTTP 401 也算作在监听）。
3. 若未在监听，启动一个 dsh web。
4. 轮询等待带 token 的鉴权地址出现。
5. 用 --app 模式打开独立窗口。

命令行工具¶

安装后会生成 dsh-lxi 命令行垫片，位于 profile 的 node_modules/.bin/ 下。由于它不在系统 PATH 中，使用时需通过 dsh plugin exec 调用。

命令	作用
`dsh plugin --profile web exec dsh-lxi install`	安装或修复桌面集成（幂等）
`dsh plugin --profile web exec dsh-lxi uninstall`	移除桌面集成，保留配置与备份
`dsh plugin --profile web exec dsh-lxi status`	查看安装状态
`dsh plugin --profile web exec dsh-lxi doctor`	诊断并给出修复建议
`dsh plugin --profile web exec dsh-lxi set <键> <值>`	修改一项配置并重新安装
`dsh plugin --profile web exec dsh-lxi open`	以独立窗口打开 dsh
`dsh plugin --profile web exec dsh-lxi stop`	停止正在运行的 `dsh web`
`dsh plugin --profile web exec dsh-lxi restart`	重启 `dsh web`
`dsh plugin --profile web exec dsh-lxi runtime`	查看当前运行时状态

配置¶

配置文件位于 ~/.config/dsh-lxi/config.json。

配置项¶

键	说明
`host` / `port`	启动器启动 `dsh web` 时使用的地址。
`window`	独立窗口的初始尺寸（逻辑像素）。
`browser`	`auto`，或 `chrome` / `chromium` / `brave` / `edge` / `vivaldi` / `opera`，或浏览器可执行文件的绝对路径。
`profileMode`	`dedicated`（默认）或 `shared`。
`profile`	桌面图标启动哪个 dsh profile。默认 `web`。
`devProfile`	非空时，桌面入口右键菜单多一个「以开发配置运行」。
`autoInstall`	是否在 `dsh web` 启动时自动安装或自愈。
`manageKwinRules`	是否托管 KWin 窗口规则（仅 KDE）。
`manageHyprlandRules`	是否托管 Hyprland 窗口规则（仅 Hyprland）。默认关闭。

修改配置¶

推荐通过 Web 界面修改：
1. 打开 DSH Web 界面。
2. 在侧栏「插件」页找到 dsh-linux-integration 卡片。
3. 点击行 dsh-lxi 的「配置」进行编辑。

也可以直接编辑配置文件或使用命令：

dsh plugin --profile web exec dsh-lxi set window 1400x900

系统要求与注意事项¶

系统环境：需要 Linux 系统。
浏览器：需要一个 Chromium 系浏览器（Chrome、Chromium、Brave、Edge、Vivaldi 或 Opera）。Firefox 不受支持，因为无法提供无地址栏的独立窗口。
DSH 版本：配置界面需要 DSH 0.2+。
Hyprland：manageHyprlandRules 默认关闭。默认情况下，窗口会遵循平铺管理器的布局，此时 window 里的宽高不起作用。若需固定尺寸，需手动开启此选项。

总结¶

dsh-linux-integration 让 DeepSeek Harness 在 Linux 桌面上像原生应用一样运行。通过标准的 XDG 入口和自动化的生命周期管理，解决了终端依赖和窗口管理的问题。