Back to directory

dsh-melody-launcher

Maintenance: Active

rirko/dsh-melody-launcher

Desktop launcher and plugin manager for DeepSeek Harness on Windows.

View on GitHub
$ dsh plugin add dsh-melody-launcher

48

stars

31

forks

TypeScript

Language

2026-08-14

Created

2026-11-07

Last push

Windows desktop launcher built for DeepSeek Harness: zero-dependency first deploy, GitHub resource market, Profile-native plugin order, and one-click `dsh web` start. Portable Release v0.5.4; license not yet declared in the repo.

DSH integration

Ecosystem-related

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-20

License

Not specified by the author

01What can it help you accomplish?

  • Deploy and run DeepSeek Harness on Windows without manual Node.js or CLI setup

    A working local DSH runtime, default `web` Profile, credentials file, and one-click start with log stream and optional browser open

    Windows users who want a graphical path to DSH instead of `npx @deepseek-ai/dsh` in a terminal

  • Search GitHub and install DSH plugins, skills, and related bundles into the active Profile

    Detected components installed to the correct Profile paths with staged progress and adjustable load order

    DSH users who prefer topic-based discovery and GUI install over typing `dsh plugin add`

  • Set API keys and launch options before starting a DSH session

    `$DSH_HOME/.credentials.yaml` updated from the UI; `DSH_HOME`, Profile name, working directory, and start command editable in settings

    Users who want pre-flight configuration (keys, plugin order, ports) in one place before Harness runs

02How to install into DeepSeek Harness

Prerequisites

  • Windows x64 or arm64 for the portable Release build (README states this npm path is Windows-only)
  • Network access for DSH, Node portable runtime, plugin downloads, and GitHub search
  • A DeepSeek API Key entered in the launcher (written to the official credentials file)

Installation steps

  1. 01

    Download the latest `DSH-Launcher-*-portable.exe` from the repository Releases page.

  2. 02

    Run the portable executable; if no local DSH is detected, click **Download/install DSH** on the home screen.

  3. 03

    On the launch page, enter your DeepSeek API Key so the launcher can write `$DSH_HOME/.credentials.yaml`.

  4. 04

    Optionally open **Resource market** to detect and install plugins or skills, then adjust order under **Plugin order**.

  5. 05

    Click **Start DSH** on the launch page; when the service is ready the Harness web UI opens (auto-open can be turned off in settings).

Verify the integration

  • After DSH install finishes, the home button changes from **Download/install DSH** to **Start DSH**.
  • When DSH is running, the log panel shows runtime status and the Harness page opens if auto-open is enabled.

Rollback

  • In **Plugin order**, **Disable** removes a bundle from the ordered load list but keeps local files; **Uninstall** removes it from the Profile (core bundles have no uninstall entry).

03DSH integration and capability boundaries

DSH integrationEcosystem-related

Windows Electron launcher that installs `@deepseek-ai/dsh`, writes official Profile and credentials, manages plugins, and starts `dsh web` with live logs.

  • DSH detect and local install

    Existing installs under launcher runtime, PATH, `%APPDATA%\npm`, or system Node paths→Reuses a valid `@deepseek-ai/dsh` install or deploys latest into `%APPDATA%\dsh-launcher\dsh-runtime\`

    Runs npm install of `@deepseek-ai/dsh@latest` into the launcher-managed runtime directory when deployingMay download portable Node.js from nodejs.org into `%APPDATA%\dsh-launcher\node-runtime\` when Node is missing
  • Unified resource market

    GitHub topic search for `dsh-plugin`, `dsh-skill`, and `dsh-app` repositories→Typed install paths for Plugin, Skill, app add-ons, or mixed repos after structure detection

    Calls GitHub APIs for search and downloads (anonymous rate limits apply; optional GitHub login uses encrypted `github-auth.bin`)
  • Profile plugin order and enablement

    Current DSH Profile `package.json` bundle list→Updated enable flags and load order; changes apply on the next DSH start

    Reads and writes the active Profile `package.json` under `$DSH_HOME\profiles\`Blocks disable/uninstall UI for core bundles `@deepseek-ai/dsh-base`, `dsh-web-app`, and `dsh-headless`
  • DSH process control and logs

    Configured start command (default `npx --yes @deepseek-ai/dsh web` or local `dsh web`)→Running DSH with PID, timestamps, service URL detection, and split runtime/plugin log channels

    Spawns and stops DSH child processes; stops related processes when the launcher exits
  • Credential and API configuration

    DeepSeek API Key and optional compatible provider entries in the UI→`.credentials.yaml` at `$DSH_HOME` with `0600` file and `0700` directory permissions

    Writes and atomically replaces `$DSH_HOME\.credentials.yaml` on disk

04Who is it for? When not to use it?

Good for

  • Windows users who want a graphical path to DSH instead of `npx @deepseek-ai/dsh` in a terminal
  • DSH users who prefer topic-based discovery and GUI install over typing `dsh plugin add`
  • Users who want pre-flight configuration (keys, plugin order, ports) in one place before Harness runs

Not for

  • The shipped portable build targets Windows x64 and arm64; README says macOS and Linux are not supported for that release path (source dev may run elsewhere without Windows-only portable Node logic).
  • The repository has no LICENSE file yet; README states default all-rights-reserved copyright until a license is added.
  • First deploy and plugin installs need outbound HTTPS (DSH, Node dist, GitHub, Releases); interrupted downloads can be resumed by clicking again.
  • The launcher stores API keys and optional GitHub tokens (Electron safeStorage), manages child processes, and writes under `%APPDATA%\dsh-launcher\` and `$DSH_HOME`.

05Compatibility, maintenance and safety notes

  • The shipped portable build targets Windows x64 and arm64; README says macOS and Linux are not supported for that release path (source dev may run elsewhere without Windows-only portable Node logic).
  • The repository has no LICENSE file yet; README states default all-rights-reserved copyright until a license is added.
  • First deploy and plugin installs need outbound HTTPS (DSH, Node dist, GitHub, Releases); interrupted downloads can be resumed by clicking again.
  • The launcher stores API keys and optional GitHub tokens (Electron safeStorage), manages child processes, and writes under `%APPDATA%\dsh-launcher\` and `$DSH_HOME`.
  • Portable releases are not commercially code-signed; Windows SmartScreen may warn on first run until you confirm the file came from this repo’s Releases page.
2026-08-142026-11-07v0.5.4

No declared license · last push 2026-11-07 · release v0.5.4

06Frequently asked questions

Windows SmartScreen says the app is untrusted — is that expected?

Yes for the portable build: README says it is not commercially code-signed, so SmartScreen may block unknown publishers. Confirm the file is from this repository’s Releases page, then choose More info → Run anyway.

I already installed DSH manually — will the launcher install again?

No. On startup it scans the launcher runtime folder, your configured command, PATH, `%APPDATA%\npm`, and system Node paths; a valid install must include both the `@deepseek-ai/dsh` package manifest and a `dsh` executable.

Can I use the portable launcher on macOS or Linux?

README only ships a Windows portable exe. You can run the project from source on other platforms for development, but automatic portable Node.js setup is implemented only for Windows.

Why are plugin files still on disk after I disable a plugin?

Disable only removes the bundle from the ordered load list in the Profile; local dependencies stay so you can re-enable quickly. Uninstall is the action that removes the plugin from the active configuration.

GitHub search failed with a rate-limit message — what now?

The resource market uses GitHub’s anonymous API, which is rate limited. README says the launcher will tell you when the quota is exhausted; wait and retry, or sign in with GitHub OAuth or a fine-grained token for authenticated requests.

08Data and sources

  • Author-claimedgithub.coma499e4ec5e0b…

    一个下载即用的启动器:管理 DSH 本体、插件、API Key 与运行配置,无需预装 Node.js。

  • Author-claimedgithub.coma499e4ec5e0b…

    启动器**直接使用 DSH 官方 Profile 结构**,不引入任何不兼容的私有插件配置格式。

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-20. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.