Foreword

The longer a session in DSH, the more likely it becomes that when you want to return to a specific user prompt or the last assistant reply in a particular turn, you’re forced to scroll up repeatedly. dsh-chat-outline is a DeepSeek Harness plugin maintained by liliuCourier, designed to add a persistent outline to the left side of the conversation panel, allowing developers to navigate directly to the corresponding content by turn.

What Is This

Simply put, it adds a 260px sidebar-style outline to the DSH web client. The outline lists each user prompt and the last assistant reply in that turn by turn. Clicking any entry jumps directly back to the corresponding position.

Core Features

Here are the main capabilities of this plugin:

  • Lists each prompt and the last reply in that turn by turn; clicking any entry jumps directly back to the corresponding position.
  • Sidebar-style fixed layout (260px), remains visible even in narrow windows.
  • Header ▸ allows one-click collapse/expand; collapsing restores the full width of the conversation.
  • Blue frame marks the current reading position and follows scrolling.
  • Switch between lightweight and full modes, with your choice remembered.
  • Hold Ctrl/Shift while clicking an entry to switch to the trace view and locate the same position.
  • Supports filtering by keywords.
  • Follows DSH’s light and dark themes.

Installation and Enabling

First, choose an installation method. Install via npm:

dsh plugin --profile web add dsh-chat-outline

Or install from GitHub:

dsh plugin --profile web add github:liliuCourier/dsh-chat-outline

After installation, refresh the browser page; if it still doesn’t work, restart dsh web.

From version 0.1.6 onwards, the package includes dsh.bundle, and npm/GitHub installation will activate it automatically; manual insertion is only applicable for older versions or source directory installations.

Typical Usage

After installation, you can use it in the following ways:

  1. Click an outline entry to locate the corresponding message in the conversation view.
  2. Hold Ctrl or Shift while clicking an entry to switch to the trace view and locate the same position.
  3. Use keyword filtering to narrow down the entries you need to view.
  4. Collapse the panel using the header ▸ to restore the full width of the conversation; expand it again when needed.
  5. Switch between lightweight and full modes. Lightweight mode by default only displays content from the officially loaded window; full mode actively loads the entire history upon entry.

Mode Selection

Lightweight mode is suitable for most daily viewing scenarios: it only presents content from the officially loaded window.

Full mode is suitable for scenarios requiring a complete outline: it paginates and parses the entire session history in the background. Long sessions may significantly slow down loading and response times, so it’s recommended to enable it as needed.

Applicable Scenarios and Notes

This plugin is particularly suitable for these situations:

  • Long sessions where you frequently need to return to a specific user prompt or the last assistant reply in a turn.
  • Need to quickly switch between the conversation view and the trace view.
  • Want to retain a persistent navigation entry in narrow windows.
  • Wish to reduce the search scope through keyword filtering.

Before using, please note:

  • Compatible with DSH 0.1.0-rc.7, rc.6 also works; if you encounter issues after upgrading DSH, please update the plugin.
  • During installation, pnpm may report unmet peer dependency, which is normal and does not affect usage.
  • On Windows, if Git reports a schannel SSL credential error, you can switch to the OpenSSL backend or install directly via npm.
  • The plugin loads within the current DSH environment and runs with the permissions of the current dsh process; it’s recommended to review the source code and MIT license before installation.

Conclusion

The value of dsh-chat-outline is quite focused: it transforms “scrolling up” in long conversations into “clicking the outline to locate,” while preserving the navigation path between the conversation view and the trace view.

GitHub repository: https://github.com/liliuCourier/dsh-chat-outline