DSH Desktop

DeepSeek Harness 的 Linux 桌面客户端（Electron 外壳）。内嵌官方 DeepSeek Harness Web UI，附带自动更新、稳定性自愈与视觉辅助插件。

设计哲学

不 fork、不魔改官方 dsh——纯外壳封装：

• 应用启动时 spawn 官方 dsh --profile web（随机 loopback 端口），窗口内 iframe 嵌入官方 Web UI
• 官方 dsh 升级后自动跟进（内置更新管理器）
• 本仓库不包含任何官方 dsh 代码（官方 CLI 由用户自行安装，MIT 许可）

功能

• 官方 Web UI 内嵌：原生 Harness 界面，会话/工具/工作流全支持
• 自动更新：检查 @deepseek-ai/dsh@next（或 latest 通道）→ 一键安装 → 失败自动回滚
• 稳定性自愈：Web 引擎意外退出自动重启（指数退避）；引擎日志面板
• 单实例锁：重复启动聚焦已有窗口，不会起双引擎
• 设置面板（顶栏 ⚙）：更新偏好、视觉助手配置、引擎日志、关于；ESC 关闭
• 视觉辅助插件：让没有视觉能力的主模型通过 OpenAI 兼容视觉 API "看图"（见下）
• 无边框窗口：自绘顶栏 + 窗口控制按钮

环境要求

• Linux（实测 Fedora + Wayland/niri；X11 应可用）
• Node.js ≥ 22、全局安装的 @deepseek-ai/dsh（npm install -g @deepseek-ai/dsh@next）
• 凭据：~/.dsh/.credentials.yaml（官方 dsh 读取，本应用不接触密钥）

安装与运行

一键安装

git clone https://github.com/MoneShadow/DeepSeek-Harness-linux- && cd DeepSeek-Harness-linux-
./install.sh               # 全自动：环境检查 → dsh CLI → 依赖 → 视觉插件 → AppImage → 桌面入口 → 图标

分步模式：

./install.sh --no-build    # 跳过打包（仅依赖+插件）
./install.sh --no-plugin   # 跳过插件（仅依赖+构建）
npm start                  # 开发模式
npm run selfcheck          # 自检模式（截图+诊断，跑完自动退出）
npm run selfcheck-crash    # 自检 + 引擎崩溃自愈演练
npm test                   # 单元测试（28 用例）
npx electron-builder --linux AppImage   # 手动打包

⚠️ install.sh 首次安装官方 dsh 时执行全局 npm install -g，安装期间请勿中断 （中断会损坏全局依赖树）。若误中断，执行 npm install -g @deepseek-ai/dsh@next --force 修复。

视觉助手插件（dsh-plugin-vision）

给主模型装上"眼睛"：注册 vision_describe 工具，通过 OpenAI 兼容视觉 API 描述图片（本地路径 / file:// / http(s) URL）。

可用性分层：

• 工具层：引擎侧注册，官方 Web UI、桌面端、headless 均可用
• 配置层：桌面端设置面板「视觉助手」区块（读写 ~/.dsh/settings.yaml 的 vision: 段，保存即时生效，无需重启）；官方 UI 的插件配置区仅渲染内置卡片，第三方插件暂不显示

安装插件（需先退出 DSH Desktop / 停用该 profile 的引擎）：