Preface

In DeepSeek Harness (DSH), switching between workspaces, sessions, file managers, and editors is frequent. Common operations include viewing the absolute path of a workspace, opening a directory in the file manager, opening a workspace with an editor, locating a specific question in a long session, marking idle sessions, and restarting DSH when the service status is abnormal.

dsh-niao-quick-open is a plugin for the DSH Web interface that centralizes these common operations on the interface, reducing the steps of manually finding directories, editors, or session locations after leaving the page.

What is this

dsh-niao-quick-open is a DSH client plugin with package name dsh-niao-quick-open, maintained by dsh-niao, and licensed under MIT.

It primarily provides the following capabilities:

  • One-click workspace opening: Copy path, display in file manager, open with common editor.
  • Auto-discovery of editors: The host scans available editors and lists those capable of generating valid open commands.
  • User message navigation bar: Marks user questions on the right side of long sessions for quick positioning.
  • Session to-do marking: Displays a clickable marker before idle sessions.
  • Single list enhancement: Adjusts session cards in the single list view to a three-row layout.
  • Hard restart: Restarts the DSH service within the page and refreshes the page after the service recovers.

Core Features

Quick Buttons at the Top of the Session Area

After opening any workspace session, the first line of the top of the session area displays the current workspace folder name and provides three icon buttons:

  • Copy absolute path
  • Show in file manager
  • Open with common editor

The second line displays the current session name.

Quick Actions in Workspace Menu

At the bottom of the ⋯ menu for each workspace, the plugin provides a row of quick buttons for:

  • Copy path
  • Show in Finder / File Manager
  • Open workspace folder with common editor

User Message Navigation Bar

On the right side of the session, the plugin displays a user message navigation bar. Each user message corresponds to a marker, supporting:

  • Hover marker to view question summary
  • Click marker to jump to the corresponding question
  • Highlight current reading position
  • Display total user message count badge at the bottom

This navigation bar appears when the session has at least 2 user messages and the content exceeds one screen, and is controlled by the “Interface Features -> User Message Navigation Bar” switch.

Session To-Do Marker

A clickable to-do marker is displayed before idle sessions. Users can mark it as completed or click again to cancel.

The to-do marker state is saved in the browser local storage and does not occupy service configuration.

Single List View Enhancement

When enabled, session cards in the single list view are upgraded to a three-row layout:

  1. Status icon, workspace name, relative time
  2. Session title
  3. Last dialogue preview

Quick Switch in List Header

A “Switch Grouping” quick icon will be added to the header of the workspace/session list. Clicking it allows switching between workspace grouping and single list.

Interface Features Settings Panel

The plugin registers a “Interface Features” page in the DSH settings panel, grouping configuration items into the following areas:

  • Sidebar
  • Session Area
  • System Tools

Configuration changes take effect immediately. For some modifications that require a restart, a “Restart to Apply” banner will appear at the top of the page after completion.

Configuration is persisted to:

~/.dsh/dsh-niao-quick-open.config.json

Editor Auto-Discovery

Editors are scanned by the host, including:

  • Known editor brands
  • System applications
  • Common editor CLIs

The plugin lists editors capable of generating valid open commands. The listed editors are all used to open the current workspace folder.

Hard Restart

A restart icon will be added next to the settings button in the bottom left corner of the interface. After clicking, a double confirmation process is entered.

After confirmation, the plugin launches a new instance detached from the terminal using the same command as the current process, waits for the old process to exit and ports to be released, starts the new instance, and then exits the current process. The foreground page will display a waiting layer and automatically refresh the page when the service recovers.

Installation and Enablement

Recommended install command:

dsh plugin --profile web add dsh-niao-quick-open

Alternatively, you can add the package to dependencies in the current profile’s package.json and dsh.profile.bundles, then restart DSH Web:

dsh web

Typical Usage

The following operations can all be completed in the DSH Web interface:

  1. After opening any workspace session, use “Copy absolute path”, “Show in file manager”, or “Open with common editor” in the first line of the session area top.
  2. Enter DSH settings, open the “Interface Features” page, toggle features as needed, and configure “Common Editor”.
  3. In a long session, hover over the user message navigation bar on the right side of the session to view the question summary, and click the marker to jump to the corresponding question.
  4. Click the to-do marker before an idle session to mark it as completed or cancel it.
  5. When a service restart is needed, click the restart icon next to the settings button in the bottom left corner, perform double confirmation, and execute a hard restart.

Technical Information

The plugin is declared as a Web client plugin:

platform: web
client inject: @deepseek-ai/dsh-client-runtime
dependency: @deepseek-ai/schemastery ^3.18.1

It injects interface enhancement logic via the DSH client runtime and completes editor scanning, service restart, and other operations on the host side.

Applicable Scenarios and Notes

Suitable for developers using the DSH Web interface, especially those who frequently need to:

  • Switch directories between DSH and file managers
  • Quickly open workspaces with an editor
  • Locate historical questions in long sessions
  • Mark idle sessions
  • Restart DSH service within the page

Please note before installation:

  • The plugin runs in the DSH current process environment and has the corresponding permissions of that process.
  • It injects code into the DSH Web client and performs scanning, restart, and other operations on the host side.
  • It is recommended to check the source code, dependencies, and MIT license before installing.
  • A hard restart will restart the DSH service, please use it as needed.

Links

GitHub Repository:

https://github.com/dsh-niao/dsh-niao-quick-open