Introduction

When using DSH’s Web GUI, you typically start dsh web first and then access it via a browser. If you want it to behave more like a desktop application: after launching, it opens an independent application window, and closing this window causes the entire DSH process to exit gracefully, you can install dsh-app-launcher.

The following introduces its capabilities, installation commands, and configuration options.

What is it

dsh-app-launcher is a DSH profile bundle with the package name dsh-app-launcher, repository address https://github.com/Alvin-Somedo/dsh-app-launcher, and license MIT.

Its purpose is to:

  • Open DSH Web GUI in a standalone application window;
  • Open Chrome/Edge application windows using a dedicated browser configuration directory, without affecting your daily browser usage;
  • The window URL includes a process token, used for authentication on the dsh web homepage request;
  • Call appExit(0) after closing the window to make the DSH process exit gracefully;
  • Can be installed as a DSH profile bundle from GitHub or npm.

Core Features

Standalone Application Window

The plugin opens Chrome/Edge application windows using a dedicated browser configuration directory. The configuration option browser can be set to auto, chrome, or edge.

Authenticated Window URL

The window URL includes a process token. The dsh web homepage request requires authentication; without a token, you will only see the unauthenticated page.

Exit on Window Close

After closing the application window, the plugin calls appExit(0), causing the DSH process to exit gracefully.

Windows Desktop Shortcut

On Windows, createShortcut is enabled by default, automatically generating a desktop DSH.lnk shortcut for one-click launch.

If dsh.ico and the desktop DSH.lnk already exist, they will not be overwritten; start-dsh.vbs will be rebuilt automatically if the version is inconsistent.

Disable Spell Check

Spell check in the application window is disabled by default.

Remember Window State

By default, the size, position, and maximized state of the application window are remembered and restored on the next launch.

For maximized restoration, only --start-maximized is passed, without position/size.

Installation and Usage

You need pnpm before installation:

npm i -g pnpm

Or:

corepack enable

Install from GitHub:

dsh plugin --profile web add github:Alvin-Somedo/dsh-app-launcher

Install from npm:

dsh plugin --profile web add dsh-app-launcher

It takes effect after the next launch:

dsh web

Or:

npx @deepseek-ai/dsh web

Typical Configuration

Override config with id app-launcher in ~/.dsh/profiles/web/cordis.patch.yml.

Do not write insert; the plugin lines are included in the bundle.

- id: app-launcher
  config:
    enabled: true
    openOnStart: true
    exitOnClose: true
    browser: auto
    disableSpellcheck: true
    rememberWindow: true
    createShortcut: true

These configuration options are used to control:

  • enabled: Whether to enable the plugin;
  • openOnStart: Whether to open the window on startup;
  • exitOnClose: Whether to exit DSH when closing the window;
  • browser: Select auto, chrome, or edge;
  • disableSpellcheck: Whether to disable spell check in the application window;
  • rememberWindow: Whether to remember the window size, position, and maximized state;
  • createShortcut: Whether to generate a desktop shortcut on Windows.

Uninstall and Upgrade

Uninstall:

dsh plugin --profile web remove dsh-app-launcher

When uninstalling manually, remove the package name from dsh.profile.bundles in ~/.dsh/profiles/web/package.json, and delete ~/.dsh/profiles/node_modules/dsh-app-launcher.

Upgrade plugin:

dsh plugin --profile web update

Use Cases and Notes

Suitable for:

  • Want to use dsh web as a desktop application-style entry point;
  • Want to end the DSH process immediately upon closing the application window;
  • Want the application window to use a dedicated browser configuration without affecting your daily browser;
  • Launch DSH using a desktop shortcut on Windows.

Notes:

  • The plugin runs with the permissions of the current dsh process; you should check the source code and license (MIT) before installing.
  • It only takes effect after the next launch of dsh web.
  • The window URL requires a process token; without a token, you will only see the unauthenticated page.
  • createShortcut is a Windows-specific behavior and is enabled by default.
  • Do not write insert when overriding configuration in cordis.patch.yml.
  • The DSH community directory is an independent site and is not equivalent to the DeepSeek/Huanfang official app store.

Conclusion

Following the steps above, dsh-app-launcher can open the DSH Web GUI as a standalone application window and exit the DSH process gracefully via appExit(0) when the window is closed. It primarily addresses specific issues like “startup entry point, browser isolation, and exit on window close”.

GitHub: https://github.com/Alvin-Somedo/dsh-app-launcher

Directory Page: The verified information for this session does not provide a specific URL; you can search for the package name dsh-app-launcher in the DSH community directory.