sprite5/DshDesktopShell
DeepSeek Harness Web 的极简桌面壳 — Wails v3 + Go 驱动，WebView 直连 DSH Web GUI
catalog 简介 / catalog descriptioncatalog description：deepseek Harness 桌面UI壳
安装Install
dsh plugin --profile web add github:sprite5/DshDesktopShell把 sprite5/DshDesktopShell 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
🖥️ DSH Desktop
DeepSeek Harness Web 的极简桌面壳 — Wails v3 + Go 驱动，WebView 直连 DSH Web GUI
A thin, no-frills desktop shell that points a WebView at your DeepSeek Harness Web GUI.
🪶 只做壳：默认不托管 Node / dsh 进程，直接连接你已运行的 dsh（本地或远端反代好的地址）； 可选
--managed时由壳托管本地 dsh 的生命周期。不实现 /api 反代，不改 DSH 前端。
📸 截图
| 连接设置页（首次启动 / 无地址时） | 主窗口（WebView 直连 DSH Web GUI） |
|---|---|
 |
 |
上图为示意图，实际界面以运行效果为准。
✨ 特性
- WebView 直连 — 窗口直接加载 DSH Web GUI（http/https，本地或远程地址）
- 内嵌设置页 — 首次启动（或无保存地址）自动打开；输入地址 → 测试连接 → 连接
- 地址持久化 —
data/settings.json保存连接 + 最近使用列表（最多 5 条，最新前置） - 启动自愈 — 启动时探测保存的地址，不可达则自动回退到设置页
- 窗口记忆 — 尺寸自动保存恢复（默认 1360×860，最小 900×600）
- 可选托管模式
--managed— 壳启动 / 重启 / 随退随停本地 dsh（dsh命令或npx @deepseek-ai/dsh） - 系统托盘 — 显示/隐藏、重新加载、连接设置、重启 dsh（仅托管）、状态、打开数据目录、退出；关窗隐藏到托盘
- 数据安全 — settings.json 原子写（tmp + rename），数据目录可整体拷贝实现便携
- macOS 适配 — 菜单栏模板图标（深浅色自适应）、左键弹原生菜单、ATS 局域网放行
🧭 两种连接模式
| 外部连接（默认） | 托管模式 --managed |
|
|---|---|---|
| dsh 由谁启动 | 用户自行启动（如 npx @deepseek-ai/dsh web） |
壳启动并管理 |
| dsh 生命周期 | 壳不管理，互不影响 | 随应用退出而停止，托盘可重启 |
| 典型场景 | 本机已跑 dsh / 远端反代地址 | 一键起 dsh，不想碰终端 |
| 启动方式 | dsh-shell.exe |
dsh-shell.exe --managed |
🚀 快速开始
首次运行（无保存地址）会自动打开内嵌设置页；也可以直接用命令行：
dsh-shell.exe # 直连本机 dsh（地址不可达时打开设置页）
dsh-shell.exe --url http://127.0.0.1:3080 # 指定地址并保存为外部连接
dsh-shell.exe --settings # 忽略保存的地址，打开设置页
dsh-shell.exe --reset # 清除保存的地址并打开设置页
dsh-shell.exe --managed # 托管模式：由壳启动并管理本地 dsh
| 参数 | 说明 |
|---|---|
--url <地址> |
本次启动直接打开该地址并保存为外部连接 |
--settings |
忽略保存的连接，强制打开设置页 |
--reset |
清除保存的连接并打开设置页 |
--managed |
托管模式：随程序启动并管理本地 dsh 进程 |
远程地址注意：DSH 的
/api有浏览器信任围栏，需以 IP 字面量 Host 或--trusted-host放行 —— 这是远端 dsh 的配置，本壳不处理。
📂 数据目录
| 平台 | 位置 |
|---|---|
| Windows / Linux | 可执行文件旁的 data/（便携，可整体拷贝） |
| macOS | ~/Library/Application Support/app.dsh.desktop |
| 覆盖 | 环境变量 DSH_SHELL_DATA_ROOT |
🏗️ 架构
main.go 窗口、启动 URL 决策、命令行参数、尺寸记忆、托盘
assets/ 内嵌设置页（index.html + style.css + app.js，手写零构建）
internal/
├── settings/ settings.json 读写（url / recent / window，原子写）
├── host/ 托管 dsh 子进程（DSH_BIN → npm 全局 → PATH dsh → npx）
├── api/ /__api/* 控制路由（AssetServer Middleware）
└── tray/ 系统托盘（图标 / 菜单 / 状态）
- 设置页与 Go 通过
/__api/*HTTP 路由通信：state/connect/probe/version/start-managed - 安全边界：窗口跳转到 DSH 地址后，请求直达 DSH 服务器，控制路由不再可达（不暴露给页面与网络）
- URL 校验复用 Wails 的
application.ValidateAndSanitizeURL（拒绝javascript:/data:/file:等） - 版本号单一来源：
build/config.yml的info.version
🔧 构建
完整构建文档（环境准备、wails3 CLI 安装、macOS 打包备选方案、FAQ）见 BUILD.md
# Windows（发布版 + 调试版）
.\build.ps1 # → bin\dsh-shell.exe（发布，无控制台）
# → bin\dsh-shell-debug.exe（调试，日志写 bin\data\.dsh-shell\）
# 仅调试 / 控制台变体
go build -ldflags "-H windowsgui" -o bin\dsh-shell-debug.exe .
go build -o bin\dsh-shell-console.exe .
# macOS（必须在 Mac 上，Wails v3 走 cgo，无法交叉编译）
wails3 build -clean -platform darwin -skipbindings # → build/bin/DSH Desktop.app
测试 / 静态检查：
go test ./...
go vet ./...
🎨 图标与品牌
- 应用图标使用 DSH 官方品牌图标（
dsh-web-frontend/dist/favicon.svg），由scripts/gen-icon.cjs（sharp + 手写 ICO 打包）生成多尺寸appicon.png/icon.ico/logo.png - macOS 托盘用纯黑 glyph 模板图标（
tray-template.png），随深浅色菜单栏自适应 - exe 资源（图标 / 清单 / 版本信息）：
build.ps1自动执行wails3 generate syso
🧩 边界（有意不做）
- 默认不托管 dsh：外部连接模式下 dsh 由用户自行启动；
--managed才接管其生命周期 - 不做 /api 反代与
__DSH_BOOT__注入（方案 B，后续可选） - WebView2 加载远程失败时显示浏览器错误页，暂无自定义提示
- 暂无通知 / 深链
🙏 致谢
- DeepSeek Harness — 本壳的目标 Web GUI
- Wails v3 — Go 桌面应用框架
📄 License
本项目基于 MIT License 开源。
Copyright (c) 2025 dsh-shell contributors
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
walkinglabs/learn-harness-engineering
Harness engineering beginner tutorial, from 0 to 1
-
YaoApp/yao
✨ All your agents and workspaces in one place, on every device you own. Track tasks on a board, accessible from desktop,…
-
Devin-AXIS/iPolloWork
Enterprise-grade, local-first Agent Workbench for people and agent teams. A unified multi-engine workspace for Codex Har…