dsh-desktop-window
把 DSH 的 WebUI 变成桌面窗口，双击就能用。 Turn the DSH WebUI into a desktop window — double-click and go.
无需开浏览器 · 双击即用 · 关窗即退 · 一次构建永久使用 No browser · double-click · close-to-exit · build once, use forever
快速开始 · Quick start
三步，之后每次都是双击。
① 下载 / Download
从 GitHub 下载本仓库，解压成一个文件夹。
Download this repo and extract it into a folder.
② 粘贴 / Paste
把整个文件夹放进 DSH 源码根目录（放哪都行，自动识别）。
Copy the folder into the DSH source tree (anywhere works).
③ 双击 / Double-click
双击启动入口，桌面窗口就出来了。
Double-click the entry for your OS — the window opens.
| 平台（OS） | 启动（Start） | 停止（Stop） |
|---|---|---|
| Windows | start-desktop-window.bat |
stop-desktop-window.bat |
| macOS | start-desktop-window.command |
stop-desktop-window.command |
| Linux | start-desktop-window.sh |
stop-desktop-window.sh |
macOS/Linux 若提示无权限，执行一次
chmod +x *.command *.sh（一般无需，仓库已带执行位）。If you hit "permission denied" on macOS/Linux:
chmod +x *.command *.sh(usually not needed).
为什么用它 · Why use it
| 你需要什么（What you get） | 它怎么满足（How） |
|---|---|
| 不用每次开浏览器 | 双击图标，WebUI 直接变成桌面窗口 / Double-click and it's a desktop app |
| 不想留后台进程 | 关窗即退，无残留 / Close = exit, no residue |
| 习惯用浏览器 | 两者共存，互不干扰 / Coexists with the browser |
| 出了故障能收拾 | stop-desktop-window.* 一键清理 / Force-clean on demand |
| 不想反复折腾 | 构建一次，永久使用 / Build once, use forever |
| 担心动源码 | 零侵入，完全兼容 / Zero-intrusion, fully compatible |
兼容性 · Compatibility
- 不改源码：本仓库只是
--patch注入的一个配置层，DSH 本体零改动，升级 DSH 也不会冲突。No source is modified — a single--patchlayer, the harness stays untouched. - 只用窗口内 WebUI 就完全兼容：所有功能在窗口内使用与浏览器里完全一致，无任何限制。As long as you stay inside the WebUI, everything works exactly as in the browser.
前置准备 · One-time setup
缺哪样启动脚本都会明确报错；以下每步只需做一次，约 3 分钟。
第一步 / Step 1 — 装好 DSH 本体，在 DSH 源码根目录执行：
pnpm install # 安装全部依赖 / install all dependencies
pnpm run build # 构建网页界面（只需这一次） / build the Web UI (once)
第二步 / Step 2 — 安装窗口引擎 Electron，在粘贴好的 <desktop> 文件夹里执行：
npm install # 下载 Electron（约 100MB） / ~100 MB；国内可用 ELECTRON_MIRROR 镜像
第三步 / Step 3 — 配置 API Key：WebUI 设置页，或在家目录放 .env：
DEEPSEEK_API_KEY=sk-...
没有 Key，窗口能打开，但对话无法回复 / Without a key the window opens, but conversations stay silent.
常见问题 · FAQ
会改动 DSH 源码吗？兼容性怎么样？ · Does it change DSH's source? How compatible is it?完全不改动源码——本仓库只是 --patch 注入的一个配置层，DSH 本体一行不改，兼容性良好。只要不跳出 WebUI（在窗口内使用），就完全兼容，与浏览器里用 WebUI 完全一致；所有功能都在窗口内使用也完全没有限制。
It changes no source — this repo is only a --patch config layer; the harness stays untouched and compatibility is good. As long as you stay inside the WebUI, it is fully compatible — identical to using the WebUI in a browser, with no feature restrictions in the window.
可以，两者是同一个 WebUI 的独立入口，互不干扰。 Yes — they are independent entries to the same WebUI, so both work concurrently.
双击没反应？ · Double-click does nothing?按顺序检查：① 在 DSH 根目录跑过 pnpm install 与 pnpm run build；② 在 <desktop> 里跑过 npm install；③ 已配置 API Key。
In order: ① pnpm install + pnpm run build at the source root; ② npm install in <desktop>; ③ an API key is set.
不用，构建一次即可，之后都是双击启动。 No — once is enough; every later launch is a double-click.
开发者 · For developers
目录结构与配置细节，普通使用可以跳过。
目录结构 / Layout
plugin/index.js Cordis 插件本体（纯 ESM，零构建）
electron-app/ 被插件拉起的 Electron 主进程
start.mjs / stop.mjs 跨平台核心逻辑（自动判断 pnpm dsh / 全局 dsh）
start-desktop-window.* 各平台启动入口
stop-desktop-window.* 各平台停止入口
运行方式 / Run modes（脚本自动选择）
| 场景（Scenario） | 命令（Command） |
|---|---|
在 DSH 源码内（检测到 apps/cli/src） |
pnpm dsh web --patch <plugin> |
| 独立运行（DSH 源码外） | dsh web --patch <plugin>（需 npm i -g @deepseek-ai/dsh） |
配置 / Configuration
覆盖 patch 行的 config（默认值如下）：
- insert:
- id: desktop-window
name: '<plugin file:// path>'
config:
title: DeepSeek Harness WebUI # 默认
width: 1280 # 默认
height: 860 # 默认
quitOnClose: true # 默认
- 需要 Node.js ≥ 18；跨平台逻辑为纯 Node，不依赖 PowerShell / Requires Node.js ≥ 18; plain Node, no PowerShell dependency.
- 本仓库只做插件壳；DSH 本体见 deepseek-ai/deepseek-harness（MIT） / This repo is only the plugin shell; the harness lives at deepseek-ai/deepseek-harness (MIT).
License
MIT
No comments yet. Be the first to write one.