DeepSeek Harness (DSH) uses a plugin-based architecture that allows developers to extend or replace UI components. dsh-theme-aurum is a theme plugin for the DSH Web profile, designed to implement a “gold-dusted luxury” visual overhaul by overriding native components. The plugin uses a loader format and requires no build; all capabilities run in the browser.

Core Features

Theme and Layout

The plugin defines light and dark color layers using the oklch color space. At the bottom of the sidebar, it provides a one-click “dark/light theme” toggle synchronized with the official preference. The sidebar uses rounded gradient cards with soft shadows; in its collapsed state, it becomes a 56px-wide slim strip.

Left Session Sidebar

The plugin masks sidebar.workspaces. The directory header includes a “Workspace” tab, expandable search (with gold-ring focus), and a view menu. It supports grouped collapsing, with nonlinear collapse/expand animation and staggered entrance. Session rows include status slots (running/waiting/completed), a gold palette, a hover floating menu (rename, branch, archive), and drag-and-drop sorting. The brand row retains the official whale icon and wordmark.

Conversation Flow

The conversation flow uses right-aligned user bubbles with a gold gradient. The body text uses a serif font, and context lines include the ◈ symbol. The Reasoning section is a collapsible serif italic paragraph. It supports tail nodes such as turn-tail, compress, retry, and err, and implements node-by-node staggered entrance animation.

Tool Cards

The plugin fully takes over conversation.chat.node. It applies special handling for 9 tool categories, and unknown tools fall back to the official icon. Tool cards present pill-shaped status, with a gold sweeping-light effect while running; tool-kids sub-calls support indented display.

Input Dock

The input dock includes a ToDo list bar (gold-to-rose gradient progress), a solid-color input card, and a gold-gradient send button. The mode/model menu supports mono reskin. The bottom area includes a ctx ring, a composition panel, and a c-stats statistics row.

Global Overlays and Responsive Design

The main-area header uses a sh-head floating-header approach, including an absolutely positioned gradient veil and a coaxial title. Global overlays (centered new-session state, command/workspace menus, settings modal) are all gold-themed. Responsive layouts support three reduced-density breakpoints at ≤820, ≤640, and ≤480, covering the full 360–1920 range and ensuring zero horizontal scrolling.

Compatibility and Extensibility

Icons always use the official DSH originals. The plugin retains all officially registered slots (priority:-1 masking), and stopping it restores the official UI. The plugin provides an aurum.workspaces.menu-extra list extension slot and supports coexistence with multiple plugins.

Installation and Activation

Run the following command in a terminal to install the plugin:

# GitHub 安装（推荐；建议固定到特定 commit）
dsh plugin --profile web add github:fengb3/dsh-theme-aurum#<commit-sha>

# 本地开发（Link 安装，编辑即生效）
dsh plugin --profile web add <本仓库路径>

After installation, restart dsh web; all pages will automatically load this theme.

Development and Notes

The plugin is built on official dependencies such as @deepseek-ai/dsh-client-ui-primitives.

  1. Link installation mechanism: When installing with a local path, the deployment copy is a symbolic link. After modifying the code, you must reinstall the plugin or restart dsh web for changes to take effect (hot-reload applies only to already loaded plugins).
  2. Script warning: Running sync-deploy.ps1 reports LINKED; do not use Copy-Item to copy files.
  3. File changes: After modifying package.json, cordis.patch.yml, or index.js, you need to perform the reinstall or restart operation described above.
  4. Compatibility: The plugin requires DSH Web version >= 0.1.0-rc.6.

Conclusion

dsh-theme-aurum provides a full-chain visual takeover solution covering the sidebar, conversation flow, and tool cards. It is suitable for developers who want to unify the visual style of DSH Web or customize the interface.