Introduction

DeepSeek Harness (DSH) adopts a plugin-based architecture that allows users to extend functionality through extensions. Over long periods of use, managing a large number of sessions and physical directories can easily lead to a cluttered system. The dsh-workspace-tree plugin introduces a virtual session folder mechanism to group and manage sessions without touching the physical file system, aiming to provide a more stable cross-workspace experience.

Plugin Overview

This is a client-side plugin maintained by pipipigu and is part of the DeepSeek Harness (DSH) ecosystem.

Core Value: Provides virtual session folder grouping, drag-and-drop (or click-to-move), and subproject management features.

Basic Information:
* Name: dsh-workspace-tree
* Category: Client
* License: MIT
* Repository: github:pipipigu/dsh-workspace-tree

Core Features

This plugin achieves fine-grained session management through a zero file-system-pollution mechanism:

  1. Virtual Session Folders

    • Zero File System Pollution: It does not move or modify underlying conversation logs or physical directories. Metadata is atomically persisted in .dsh/workspace-tree...
    • Multi-Workspace Stability: Each workspace has independent categorization and pinning queues. When switching workspaces, the folder state remains persistent and stable.
    • Full Lifecycle: Supports creation, inline renaming (double-click), custom color labels, and deletion (uncategorized sessions safely fall back).

  2. Folder-Scoped Session Creation

    • Hover over any folder and click [+] to start a new conversation directly inside that target folder. Atomic SessionId binding avoids race conditions.

  3. Active Task Banner and “Read-and-Remove”

    • A top capsule (28px) continuously displays running tasks and unread completed sessions.
    • A pulsing blue dot is shown during generation; a persistent green [Unread] marker is displayed upon background completion; it is automatically removed after being read.
    • Supports one-click deep jumping with automatic expansion of parent workspaces and folders.

  4. Precise “Move to Folder” Dropdown Menu

    • Replaces the interaction pain points of dragging in the sidebar by providing precise click-to-move functionality.
    • Supports quick folder selection, inline creation of new folders, and an “Eject” button inside a folder that returns a session to the uncategorized area.

  5. In-App Visual Directory Browser and Workspace Creator

    • Clicking the [+] in the sidebar header opens a native-style “Select Workspace Directory” modal.
    • Supports full hierarchy navigation, including breadcrumbs, single-click selection, double-click/arrow-key drill-down, and returning to the parent directory.
    • Supports creating subdirectories directly within the dialog, toggling the display of hidden files (such as .config), and editing the path directly.

  6. Session Pinning, Inline Renaming, and Pagination

    • Supports pinning important sessions.
    • Double-clicking a session title activates inline renaming.
    • The first 10 sessions are displayed by default, with an expander to view the remaining items.

  7. Native Single-Slot Shadowing

    • Fully self-contained host RPC and UI, bypassing DSH internal slot conflicts.
    • Shadows the native sidebar.workspaces slot with a priority of -10, blending seamlessly with DSH’s dark and light color schemes.

  8. 0ms Reactive Engine

    • Based on useSyncExternalStore and immutable version snapshots, ensuring that UI rendering has 0ms latency under any operation.

Installation and Activation

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

dsh plugin --profile web add github:pipipigu/dsh-workspace-tree

After installation, restart the DSH Web instance (or refresh the browser) to activate the plugin.

Typical Usage

  • Create a Session in a Specific Folder: Hover over a folder in the sidebar, click the [+] button next to it, and start a new conversation directly inside that folder.
  • Select or Create a Workspace Directory: Click the [+] at the top of the sidebar to open a native-style modal. It supports browsing directories, creating subdirectories, or pasting a path directly.
  • Rename a Session: Double-click any session title to rename it inline directly within the list.

Applicable Scenarios and Notes

  • Applicable Scenarios: DSH users who need to manage a large number of sessions, want to keep physical directories tidy, or need to switch among multiple workspaces frequently while maintaining stable session categorization.
  • Notes:
    • The plugin runs with the permissions of the current dsh process. Please ensure the installation source is trusted.
    • This plugin achieves 100% stability across Web and Desktop platforms through self-contained RPC and UI.
    • It overrides DSH’s native sidebar.workspaces slot with a priority of -10.

Summary

dsh-workspace-tree provides DSH with a lightweight and high-performance session management solution. Through virtualized folders and precise interaction controls, it solves the pain points of traditional physical directory management and is suitable for technical users pursuing an efficient workflow.