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 入口和自動化的生命週期管理，解決了終端依賴和窗口管理的問題。