Preface

DSH emphasizes “everything is a plugin,” and the community directory is an independent site, not an official app store. When browsing a long conversation in dsh web, relying solely on scrolling to review a specific turn’s prompt and response is inefficient.

dsh-ui-outline is a turn navigation plugin for dsh web. It adds a navigation rail to the side of the conversation, supporting turn-by-turn browsing, click-to-snap, drag-to-scrub, and previewing each turn’s prompt and response. Below are its features, installation methods, and typical usage.

What is this

dsh-ui-outline is maintained by iluluyu and is licensed under MIT. The current version in package.json is 0.0.2, suitable for scenarios where dsh.client.platform is web.

It implements the dsh web turn navigation rail following the official TurnNavigator design language and provides capabilities related to outline, scales, and frosted glass preview.

Core Features

The capabilities listed below are derived from verified plugin documentation.

  • dsh web turn navigation rail
  • Official TurnNavigator design language
  • Configurable Side: Right / Left
  • Configurable Preview material: None / Frosted / Liquid glass
  • Configurable Mark layout: Compact / Loose
  • Clicking snaps to the nearest visible turn
  • Supports drag to scrub to browse the entire conversation
  • Each turn’s preview card shows that turn’s prompt and response
  • Settings are persisted in the host settings document, not using localStorage
  • Preview cards are implemented using pure CSS
  • Supports zh / en bilingual interface, following the app locale
  • Animations use only compositor-only properties and respect reduced motion

Three common configurations are as follows:

  1. Side: Choose whether the rail is on the right or left, options are Right or Left.
  2. Preview material: Choose the preview card material, options are None, Frosted, or Liquid glass.
  3. Mark layout: Choose the scale layout, options are Compact or Loose.

Installation and Enabling

First, confirm that the environment meets version requirements: dsh ≥ 0.1.0-rc.7 is required, and keyed plugin-settings slot + open settings namespaces is required.

Below are three installation methods.

Install from npm:

dsh plugin --profile web add dsh-ui-outline

Install from GitHub:

dsh plugin --profile web add github:iluluyu/dsh-ui-outline

Fixed to v0.0.2:

dsh plugin --profile web add github:iluluyu/dsh-ui-outline#v0.0.2

After installation, restart dsh web and reload the page to enable the plugin:

dsh web

Then refresh the page in your browser.

Update and remove plugin:

dsh plugin --profile web update dsh-ui-outline

dsh plugin --profile web remove dsh-ui-outline

Typical Usage

After enabling through the steps above, find the rail in the dsh web page and complete the following operations.

  1. Click rail. Clicking snaps to the nearest visible turn.
  2. Drag rail. Supports drag to scrub for browsing the entire conversation.
  3. View preview. Each turn’s preview card displays that turn’s prompt and response.
  4. Switch language. The interface supports zh / en and follows the app locale.
  5. Adjust rail configuration. Configurable options include Side, Preview material, and Mark layout.
  6. Save settings. Settings are persisted in the host settings document, not using localStorage.

The settings namespace is outline. If manual override is needed, you can use an example like this in ~/.dsh/settings.yaml:

outline: { side: left, material: frost, layout: loose }

Applicability and Notes

This plugin is suitable for users who need to quickly browse long conversations in dsh web and locate a specific turn’s prompt and response. It can also be used to adjust the visual and interactive layout of the rail according to Right / Left, None / Frosted / Liquid glass, and Compact / Loose.

Please note the following:

  • The plugin runs with the current dsh process permissions. You should check the source code and license before installing.
  • Requires dsh ≥ 0.1.0-rc.7 and possesses keyed plugin-settings slot + open settings namespaces.
  • package.json version is 0.0.2.
  • License is MIT, copyright is iluluyu.
  • PeerDependencies are @deepseek-ai/cordis >=1.0.0 and react >=18.0.0.
  • Dependency is @deepseek-ai/schemastery ^3.18.1.
  • No third-party code is bundled inside the package, and there are no transitive license obligations.
  • Settings are saved in the host settings document, not using localStorage.
  • The directory page can be viewed at: https://www.skillhub.cn/plugins/iluluyu/dsh-ui-outline. This directory page is a community directory page, not an official app store.
  • GitHub repository: https://github.com/iluluyu/dsh-ui-outline.

Conclusion

The value of dsh-ui-outline is specific: providing a configurable turn navigation rail in dsh web, supporting click-to-snap, drag to scrub, and preview cards showing prompt and response, and persisting settings in the host settings document. After the installation, restart, and page reload described above, it can be used for daily conversation browsing and turn location.