Introduction

The extension method of DSH can be summarized as “everything is a plugin”: the community directory is an independent site with no official affiliation to DeepSeek or High-Flyer, and should not be considered an official app store. dsh-ux is one of these DSH web interface experience suites, with its GitHub repository at jiangnanquan/dsh-ux and licensed under MIT.

It consists of two parts: the dsh-enhance web plugin and the dsh-desktop frameless Electron desktop shell. For those already using DSH via the dsh web profile, the following introduces what it does in terms of themes, layouts, collapsible capsules, account usage, and desktop form, as well as how to install, upgrade, and uninstall.

Component Composition

dsh-enhance

dsh-enhance is the DSH web plugin. Its package name declared in package.json is dsh-enhance, version 1.0.0. It declares dsh.bundle.patch and dsh.client, and will be added to the profile’s bundles upon installation.

dsh-desktop

dsh-desktop is a frameless immersive window for macOS, bringing the DSH web into a desktop application form. It can be launched by double-clicking, automatically starting the backend and window.

Core Capabilities

Themes and Layout

For themes, dsh-enhance uses the Solarized light color scheme; dark mode retains the official default.

For fonts, it prioritizes the Maple Mono font stack, enabling it only if detected as installed; otherwise, it automatically falls back to PingFang SC, SF Mono, Menlo, or monospace fonts.

For layouts, it widens the message column, uses compact spacing, narrows the input queue, and disables rubber-band scrolling.

Collapsible Capsules

Thought blocks are aggregated into Think ×N capsules; tool calls are aggregated into A → B → C chain capsules.

Long chains wrap based on available width. Each line becomes an independent capsule, which can be expanded by clicking any line.

Account Usage

The interface displays the official account balance, token cost for the current session, and usage charts for the last 30 days at the bottom.

This information requires the current DSH to have the DEEPSEEK_API_KEY credential configured. If not configured, this information shows as query failed or unavailable, without affecting other features like themes, layouts, and collapsible capsules.

The pricing table is hardcoded according to official peak and off-peak rates. If the official pricing changes, pricingFor in lib/index.js needs to be updated.

Installation and Activation

First, ensure you are running dsh web according to DSH’s profile mechanism.

Then execute the installation command:

dsh plugin --profile web add github:jiangnanquan/dsh-ux#main

This package declares dsh.bundle.patch and dsh.client, and dsh plugin add will add it to the profile’s bundles. After execution, restart dsh for it to take effect without manual configuration changes.

Repeatedly executing the installation command is safe and idempotent. For subsequent upgrades and uninstalls, use the package name dsh-enhance:

dsh plugin --profile web update dsh-enhance

dsh plugin --profile web remove dsh-enhance

Note that the installation address uses the repository name dsh-ux, while the upgrade and uninstall commands use the package name dsh-enhance; both come from the same repository.

Delegating to AI for Execution

If you don’t want to manually execute commands, you can paste the prompts given in the README to any AI agent, letting it complete the installation, self-check, and rollback according to INSTALL.md.

Example prompt:

Please follow the steps at https://github.com/jiangnanquan/dsh-ux/blob/main/INSTALL.md to install and verify the dsh-enhance plugin on my machine (using the web profile), then run the health check in the document and tell me the results. If any step fails, follow the rollback steps in the document to restore the original state and explain the reason.

Desktop Shell Usage

dsh-desktop is designed for macOS. When using the desktop shell, double-click Start DSH.command, and it will automatically start the backend and window.

It supports the following environment variables:

  • DSH_URL
  • DSH_SNAPSHOT

These environment variables are used to point to different DSH web addresses or snapshots.

Dependencies and Prerequisites

The peer dependencies of dsh-enhance include:

react ^18.0.0 || ^19.0.0
@deepseek-ai/dsh-client-runtime ^0.1.0-rc.6
@deepseek-ai/dsh-client-ui-theme ^0.1.0-rc.6

When using the account usage feature, the current DSH must also have DEEPSEEK_API_KEY configured. If not configured, the balance, current session cost, and usage charts for the last 30 days will show as query failed or unavailable.

Applicable Scenarios and Notes

Suitable for:

  1. Users already using DSH via the dsh web profile who want to adjust themes and layouts.
  2. Users frequently facing long thought blocks or tool call chains that need to be collapsed into capsules.
  3. Users who want to see the official account balance, token cost for the current session, and usage for the last 30 days at the bottom of the interface.
  4. Users on macOS who want to turn DSH Web into a frameless desktop window.

Notes:

  • The plugin runs with the permissions of the current DSH process. It is recommended to check the source code, patches, dependencies, and licenses before installation.
  • The license is MIT.
  • Balance, current session cost, and usage charts depend on DEEPSEEK_API_KEY; they are unavailable if not configured.
  • The pricing table is hardcoded according to official peak and off-peak rates; pricingFor needs to be updated if the official pricing changes.
  • The font effect depends on whether Maple Mono is installed locally; fallback fonts are used if not installed.
  • The plugin directory is an independent site with no official affiliation to DeepSeek or High-Flyer.

Conclusion

dsh-ux consolidates themes, layouts, collapsible capsules, and account usage into a DSH web plugin, and additionally provides a macOS frameless desktop shell. It is suitable for users already using dsh web who wish to adjust interface density, collapse long thought and tool chains, and view account usage information.

GitHub repository:

https://github.com/jiangnanquan/dsh-ux

If you are looking for it in a DSH plugin directory, please treat it as an independent plugin entry; this article does not provide specific directory page addresses to avoid referencing unverified URLs.