@dsh-external/dsh-desktop
DeepSeek Harness Windows desktop companion: tray icon (whale), desktop shortcut, login auto-start that opens exactly the client you chose (desktop app window or web browser), and one-click desktop/web switching (local Edge/Chrome app mode).
AI 분석
适合Windows用户,需要开机自启、托盘管理以及在桌面窗口与网页端间无缝切换。
설치
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:LvsH13/dsh-desktop🚀 使用方法
打开 设置 → 桌面端:
| 面板 | 功能 |
|---|---|
| 状态 | Harness 服务、托盘、桌面窗口、桌面快捷方式、自启、终端的实时状态 |
| 开机自启动 | 开关登录自启(任务计划程序登录触发器,Run 键兜底);可选择 开机打开方式(桌面端独立应用窗口 / 网页端默认浏览器,二选一,只开一端) |
| 操作 | 切换桌面端 / 切换网页端(按当前模式显示标签)、启动/退出托盘、创建桌面快捷方式、显示/隐藏终端 |
托盘右键菜单中的 重新启动 会按顺序停止并重新启动 Harness,保留托盘图标和开机自启动设置;重启期间重复点击快捷方式或“重新启动”不会创建额外的 Node 实例。
上次打开 一行会报告上次启动的就绪耗时(如 就绪耗时 1.2s)与窗口模式(独立窗口 / 默认浏览器),或失败原因——遇到卡顿时先看这里。
⚙️ 配置说明
| 项目 | 位置 / 说明 |
|---|---|
| 伴生文件目录 | %LOCALAPPDATA%\dsh-desktop\(自动从 v0.1 的 $DSH_HOME\desktop 迁移) |
dsh-tray.ps1 | 托盘/启动器核心脚本(窗口布局、单实例、就绪轮询、退出信号) |
harness.json | 记录当前安装的精确 CLI 入口、node、DSH_HOME、origin、实际绑定端口 |
state.json | showTerminal / autoStart / autoStartMode 状态 |
open-state.json | 上次打开诊断(就绪耗时、窗口模式) |
launch-failures.json | 熔断诊断文件(仅在连续 3 次拉起失败触发熔断时生成,记录原因与日志路径) |
| 启动页 | boot.html——服务就绪前桌面窗口显示的黑色鲸鱼白底启动页,就绪后通过 DevTools 原地导航到 UI |
| 自启方式 | 任务计划程序登录触发器(DSHDesktop 任务,无需管理员权限);HKCU\...\Run 仅注册失败时兜底;当前生效方式见 %LOCALAPPDATA%\dsh-desktop\autostart-method.json(task / runkey) |
| 桌面/Web 状态检测 | 双通道:记录窗口 PID(主)+ WMI 命令行匹配(兜底),无 WMI 环境同样可靠 |
| 运行时依赖 | schemastery(唯一运行时依赖) |
⚠️ 保持
dsh-tray.ps1为 UTF-8 with BOM 编码——Windows PowerShell 5.1 会乱码读取无 BOM 的 UTF-8 文件。