Preface¶

In the DSH Web UI, details such as code font size, table style, Git status, archive sessions, and MCP servers can affect daily use. dsh-ui-tweaks is a plugin for the DSH Web UI that consolidates these adjustments into a settings panel and applies them instantly. It is suitable for DSH users who need to adjust the interface according to their workflow and handle Git, archives, MCP, and task reminders within a session.

What This Is¶

dsh-ui-tweaks is a plugin for DeepSeek Harness (DSH) Web UI, maintained by wlj521. It allows real-time adjustments to the conversation interface via the settings panel, including code font size, table style, GitBar, archive management, MCP management, /init, whale indicator, task reminders, and displaying cache hit rate with two decimal places.

DSH’s plugin mechanism allows extending the Web UI; the community directory is a separate site and should not be interpreted as an official app store.

Versions and Dependencies¶

• dsh-ui-tweaks v0.12.0 requires DSH v0.1.2-alpha.1 or later.
• Conversation timeline and dialog box width are natively provided by DSH; the plugin removes its own duplicate implementations and also removes message font size and line height settings.
• When the host has not yet upgraded, you can specify an older version: dsh-ui-tweaks@0.11.2.
• package.json requires Node.js >=20.

Installation¶

First, execute the installation command, then restart dsh web once. Bundle plugins are scanned when the process starts.

Install from npm:

npx -y @deepseek-ai/dsh plugin --profile web add dsh-ui-tweaks

Install from GitHub repository:

npx -y @deepseek-ai/dsh plugin --profile web add github:wlj521/dsh-ui-tweaks

Lock npm version:

npx -y @deepseek-ai/dsh plugin --profile web add dsh-ui-tweaks@0.11.2

Lock git tag:

npx -y @deepseek-ai/dsh plugin --profile web add github:wlj521/dsh-ui-tweaks#v0.11.2

When installing from GitHub, pnpm may require approval for the package’s build scripts. Add the package to the profile’s pnpm-workspace.yaml:

allowBuilds:
  dsh-ui-tweaks: true

Then re-execute the add command.

If pnpm reports symlink or hoist errors, you can set the following in the profile’s pnpm-workspace.yaml:

nodeLinker: hoisted

Settings Entry¶

Settings entry: Settings → UI Tweaks.

The same configuration can also be maintained in YAML:

ui-tweaks:
  tableStyle: claude
  gitBarEnabled: true
  archiveManagerEnabled: true
  initCommandEnabled: true
  whaleIndicatorEnabled: true
  preciseCacheHitEnabled: true
  notificationsEnabled: true

Where gitBarEnabled, archiveManagerEnabled, initCommandEnabled, whaleIndicatorEnabled, preciseCacheHitEnabled, notificationsEnabled correspond to features that are off by default; set to true to enable them.

Core Features¶

Code Font Size¶

Supports 8–32 px, default is 13. Applies to code blocks; inline code follows proportionally. The older percentage configuration codeFontScale is still compatible; once a new px value is set, the px value takes precedence.

Table Style¶

Choose between default style or Claude Desktop style.

GitBar¶

GitBar is off by default. When enabled, if the session’s working directory is a git repository, the branch and diff capsules are displayed in the input box’s tool row.

• Branch capsule supports branch switching, new branch creation, pull, push, and commit graph.
• Diff capsule opens the diff panel, which includes a file list and per-file diff.
• The diff panel supports full file view, draggable width, and can commit or commit and push within the panel.

Git operations are executed via server-side execFile('git', …) without a shell and with a timeout.

Terminal Panel¶

Provides a real PTY terminal based on xterm.js + WebSocket. The terminal width is draggable and also supports one-click half-screen.

Open Project¶

In the session header menu, you can open the current project with Explorer, VS Code, IDEA, GoLand, WebStorm, or PyCharm.

Archive Management¶

Archive management is off by default. When enabled, an “Archives” page appears in settings, allowing you to view, restore, or permanently delete archived sessions, and also supports restore all/delete all.

Archive deletion is permanent and cannot be undone; running sessions will be rejected for deletion.

MCP Management¶

MCP management is off by default. When enabled, an “MCP Management” page appears in settings, allowing you to add, edit, enable/disable, delete, or restart MCP servers.

/init¶

/init is off by default. When enabled, type /init in the input box, select Chinese or English prompts, and submit. It analyzes the current project and submits a prompt to generate AGENTS.md.

Whale Indicator¶

Whale indicator is off by default. When enabled, a small brand whale appears in the upper right corner of the input box; it plays a swimming animation when the model is working.

Task Reminders¶

Task reminders are off by default. When enabled, when a session completes or requires interaction, reminders can be sent via tab title flashing, system notifications, or alert sounds.

System notifications require browser notification permissions; the permission request is attached to the settings toggle’s click gesture.

Cache Hit Rate with Two Decimal Places¶

This feature is off by default. When enabled, it rewrites the cache hit percentage in the native statistics bar to two decimal places.

Typical Usage¶

Enable Common Features¶

Go to Settings → UI Tweaks, or configure in YAML:

ui-tweaks:
  tableStyle: claude
  gitBarEnabled: true
  archiveManagerEnabled: true
  initCommandEnabled: true
  whaleIndicatorEnabled: true
  preciseCacheHitEnabled: true
  notificationsEnabled: true

Using GitBar¶

Once enabled, the branch and diff capsules are displayed in the input box’s tool row:

1. Click the branch capsule to switch or create branches, or perform pull, push, view commit graph.
2. Click the diff capsule to view the file list and diff.
3. Commit or commit and push within the diff panel.

Using /init¶

1. Type /init in the input box.
2. Select Chinese or English prompts.
3. Submit to the current session to generate the AGENTS.md prompt.

Managing Archives¶

In the settings “Archives” page, restore or permanently delete archived sessions. Confirmation is required before deletion, as deletion cannot be undone.

Managing MCP¶

In the settings “MCP Management” page, add, edit, enable/disable, delete, or restart MCP servers.

Use Cases and Notes¶

Suitable for the following scenarios:

• Want to adjust code font size, table style, and prompt elements in DSH Web UI according to work habits.
• Need to handle git branches, diffs, and commits near the input box.
• Need to manage archived sessions, MCP servers, or receive reminders when a session completes or awaits interaction.

Notes:

• The plugin runs with the current dsh process permissions; check the source code and license before installation.
• This material does not specify a license type; LICENSE is included in package.json’s files, but the license text is not provided.
• GitBar, archive management, MCP management, /init, whale indicator, task reminders, and cache hit rate with two decimal places are off by default and must be enabled in settings.
• After installation, restart dsh web once.
• Archive deletion cannot be undone; running sessions will be rejected for deletion.
• Task reminders’ system notifications depend on browser notification permissions.
• When installing from GitHub, you may need to approve pnpm build scripts or adjust nodeLinker.

Related Links¶

• GitHub: https://github.com/wlj521/dsh-ui-tweaks
• Directory page: https://www.skillhub.cn/plugins/wlj521/dsh-ui-tweaks