🌲 dsh-workspace-tree
English | 简体中文
Virtual Session Folder Grouping, Move-to-Folder Menu, and In-App Visual Directory Browser for DeepSeek Harness (DSH).
📸 Visual Previews
1. Sidebar Overview & Core Features
dsh-workspace-tree Sidebar Overview
2. In-App Visual Directory Browser & Workspace Creator
dsh-workspace-tree Visual Directory Browser
3. Precision Click-to-Move Folder Menu
dsh-workspace-tree Move-to-Folder Interaction
🌟 Key Features
-
📁 Virtual Session Folders
- Zero Filesystem Pollution: Never moves or modifies underlying conversation logs or physical directories. Metadata is atomically persisted at
.dsh/workspace-tree.json.
- Multi-Workspace Stability: Independent classification and pin queue per workspace. Folders remain persistent and stable across workspace switches.
- Full Folder Lifecycle: Create, inline rename (double-click), custom color badge, and delete (internal sessions safely fallback to uncategorized).
-
➕ Folder-Scoped Session Creation
- Hover on any folder and click
[+] to start a new conversation directly inside that targeted folder with atomic SessionId binding, avoiding race conditions.
-
🚀 Active Task Banner & Read-to-Dismiss
- Compact 28px Top Capsule: Pins active running tasks and unread completed conversations at the top of the sidebar.
- Smooth Lifecycle Transition: Pulsing blue dot during generation -> persistent green
[Unread] badge when completed in background -> automatically dismissed upon reading.
- Deep-Jump & Auto-Expand: One-click navigation that automatically expands the parent workspace and folder.
-
📂 Precision Move-to-Folder Dropdown Menu
- Zero Misclicks: Replaced awkward sidebar drag-and-drop with a crisp, reliable click-to-move dropdown menu.
- Instant Categorization: Quick folder selection or inline new folder creation; dedicated eject button inside folders to return sessions to uncategorized.
-
🗂️ In-App Visual Directory Browser & Workspace Creator
- One-Click Visual Adoption: Click
[+] on the sidebar header to open a native-feeling "Select Workspace Directory" modal dialog.
- Full Hierarchy Navigation: Home directory jump, breadcrumb navigation, single-click selection, double-click/chevron drill-down, and up-level button.
- Inline Folder Creation & Hidden Files: Create new subdirectories directly in the dialog and toggle hidden files (
.config, etc.).
- Direct Path Editing: Click the pen icon to switch to raw path typing/pasting.
- Zero Slot Conflicts: Self-contained host RPC and UI, completely bypassing DSH internal slot conflicts with 100% stability across Web and Desktop.
-
📌 Session Pinning, Inline Rename & Pagination
- Pin important sessions to the top of the workspace.
- Double-click any session title to activate inline renaming.
- Displays top 10 sessions by default with an expander for remaining items.
-
🎨 Native Single Slot Shadowing
- Seamlessly shadows the native
sidebar.workspaces slot with priority: -10, blending with DSH dark/light color schemes (--dsw-*).
- Pure SVG vector icons with zero emoji clutter.
-
⚡ 0ms Reactive Engine (Version Snapshot)
- Powered by
useSyncExternalStore with immutable version increment snapshots, ensuring instant 0ms UI re-renders on any action.
📦 Installation
Option A: Install from GitHub (Recommended)
Run the following command in your terminal:
dsh plugin --profile web add github:pipipigu/dsh-workspace-tree
Restart your DSH Web instance (or refresh the browser) to enjoy!
Option B: Local Development (Link Mode)
# 1. Clone repository
git clone https://github.com/pipipigu/dsh-workspace-tree.git
cd dsh-workspace-tree
# 2. Install dependencies & build
pnpm install
pnpm build
# 3. Link to DSH Web Profile
dsh plugin --profile web add link:$(pwd)
🏗️ Architecture & Data Flow
dsh-workspace-tree Architecture & Data Flow
🛠️ Development & Commands
# Install dependencies
pnpm install
# Type checking (0 errors)
pnpm typecheck
# Unit tests (Vitest)
pnpm test
# Production build (generates lib/index.js & lib/client.js)
pnpm build
📄 License
This project is licensed under the MIT License.
