DeepSeek Harness (DSH) 是用于开发智能体的工具，其 Web UI 默认在浏览器中运行。在长期开发或调试过程中，浏览器标签页容易堆积，且日常浏览记录可能会与开发环境混杂。dsh-desktop-window 插件通过在独立应用窗口中打开 DSH Web UI，解决了这个问题。该窗口不包含标签栏和地址栏，且使用独立的浏览器配置文件，确保了与日常浏览的隔离。
核心功能¶
该插件提供以下功能：
- 自动打开：启动时默认自动打开独立窗口。
- 手动切换：在会话标题栏提供开关按钮，可随时打开或关闭窗口。
- 设置项控制：在设置 -> 常规中提供自动开启的开关，配置持久化。
- 品牌标识：注入官方鲸鱼图标和 Web Manifest，使窗口标题栏和安装为应用后显示 DeepSeek 图标。
- 环境隔离：使用独立的浏览器配置文件，位于
%TEMP%目录，日常浏览不受影响。 - 跨平台支持：支持 Windows 10/11、macOS 11+ 和 Linux。
- 进程管理：关闭窗口时会同步状态并释放进程树。
安装与启用¶
安装前请确保 DeepSeek Harness 版本不低于 0.1.0-rc.6。
运行以下命令安装插件：
dsh plugin --profile web add github:fengzhiyushui/dsh-desktop-window
安装完成后，必须重启 dsh web 进程，配置才会生效。
使用方法¶
安装插件后，运行 dsh web 即可启动服务器。一旦服务器就绪，独立窗口会自动打开。
- 切换窗口：在会话标题栏点击窗口按钮。
- 控制自动打开：进入设置 -> 常规 -> 自动打开，开启或关闭此功能。
- 调整浏览器偏好：编辑
lib/window-spec.js文件中的browserCandidates()方法，改变浏览器选择逻辑。 - Windows 快捷方式：在 Windows 上，运行
<plugin-dir>\scripts\create-shortcut.ps1脚本可创建桌面快捷方式。
配置与注意事项¶
插件配置文件位于 $DSH_HOME/desktop-window.json（默认为 %USERPROFILE%\.dsh\desktop-window.json）。你可以直接编辑此 JSON 文件，也可以在设置界面中修改。
{
"autoOpen": true,
"cleanProfileOnUnload": false
}
autoOpen：启动时是否自动打开窗口。cleanProfileOnUnload：插件卸载时是否删除专用浏览器配置文件。设为false时，配置文件会持久化，下次打开窗口会更快。
重要注意事项：
- 任务栏图标：由于该窗口以 Chromium
--app模式运行，Windows 任务栏或 macOS Dock 默认显示的是浏览器图标而非鲸鱼图标。若要显示鲸鱼图标，需将页面安装为应用（Edge 菜单 -> Apps -> Install this site as an app）。 - 进程状态：关闭独立窗口不会停止
dsh进程，两者是独立的。 - 运行机制：这是一个浏览器窗口，而非嵌入的 WebView。
- 身份验证：打开窗口不进行身份验证，跨站点请求需检查 Origin 头。
生态背景¶
DeepSeek Harness (DSH) 采用了“一切皆插件”的理念，旨在通过插件扩展工具能力。dsh-desktop-window 是社区维护的插件之一，由开发者 fengzhiyushui 创建，遵循 MIT 许可证。更多详情与源码，请访问 GitHub 仓库 或 SkillHub 插件目录。
