返回目录

其他插件

dsh-desktop-window

hxwi1/dsh-desktop-window

Desktop window for the DeepSeek Harness WebUI (Cordis plugin)

查看仓库

Stars: 0
Forks: 0
Issues: 0
更新: 4 天前

PROJECT TOPICS

项目标签

deepseek-harness-desktop dsh-plugin

INSTALL REFERENCE

安装参考

未验证

dsh plugin --profile web add github:hxwi1/dsh-desktop-window

在 DSH 中安装

该命令指向仓库当前默认分支；尚无绑定当前 commit 的完整验证结果。

PROJECT README

README

# 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 --patch layer, 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.

关掉窗口，DSH 还在后台跑吗？ · Does DSH keep running in the background?

能一边用浏览器一边用窗口吗？ · Can I use the browser and the window at once?

可以，两者是同一个 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.

每次都要重新构建吗？ · Do I need to rebuild every time?

不用，构建一次即可，之后都是双击启动。 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

CLASSIFICATION EVIDENCE

分类依据

项目类型插件

功能分类其他

规则置信度低

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中：无有效分类标签。