WenhongPan/dsh-projects

Full-screen, real interaction capture. The directory chooser is opened by the Windows native API; editing is limited to cropping, camera zoom, and GIF compression—no system UI was reconstructed.

DSH makes it easy to enter a Workspace, but folder selection and a flat session list become difficult to navigate as your work grows. dsh-projects adds a project layer over DSH's native Workspace and Session data: select and create projects, organize the sidebar, search chats, and inspect archived work without copying or migrating existing sessions.

New in v0.3

• Multi-folder projects: group existing Workspaces and choose an explicit primary folder for new sessions.
• Attention summaries: use Off, Compact, or Expanded views for waiting, running, and completed sessions.
• Better search: group project, title, and chat-body matches directly under their projects with highlighted snippets.
• Smarter folder picking: remember the previous location or start from Desktop, Home, or the current project's parent.

Every advanced capability is opt-in. Without it, the plugin remains a lightweight organization layer over DSH data.

At a glance

Capability	What it gives you
Project entry	Search and switch projects above the composer, or start without choosing one
Project creation	Keep display names independent from folders and prefer the OS directory chooser locally
Sidebar	Group by project or use one list, with Recent, pinning, favorites, drag ordering, plus Off, Compact, or Expanded Session-status summaries
Management	Rename, open in the file manager, archive chats, and remove project registrations
Multi-folder projects	Optionally group existing Workspaces under one project without moving files or chats; dissolve the group at any time
Global search	Group results directly by project; optionally include chat bodies through DSH indexing
Archive center	Inspect archived chats; restore depends on a public DSH unarchive API
Theme and data	Follow DSH light/dark themes and keep using DSH's own Workspace and Session data

Quick install

The current version is 0.3.0-alpha.1. Windows x64 with DSH Desktop 2.0.1 and DeepSeek Harness 0.1.0-rc.6 is the primary verified environment.

DSH Desktop

dsh plugin --profile desktop add https://github.com/WenhongPan/dsh-projects/releases/download/v0.3.0-alpha.1/dsh-projects-0.3.0-alpha.1.tgz

DSH Web UI

dsh plugin --profile web add https://github.com/WenhongPan/dsh-projects/releases/download/v0.3.0-alpha.1/dsh-projects-0.3.0-alpha.1.tgz

Fully quit and restart the selected DSH profile after installation or upgrade. Desktop and Web are separate profiles and must be installed independently.

Source install is also available:

git clone https://github.com/WenhongPan/dsh-projects.git
cd dsh-projects
npm install
npm run verify
dsh plugin --profile desktop add link:/absolute/path/to/dsh-projects

On Windows, a link path can be written as link:C:/path/to/dsh-projects.

Native folder picking

The plugin includes its own native directory bridge, so regular users do not need to replace Desktop:

• DSH Desktop opens Electron's operating-system directory chooser.
• The first chooser starts on the system Desktop; later opens can remember the last project's parent or use Desktop, Home, or the current project's parent.
• Local Web UI on the same machine delegates to DSH's official cross-platform native picker.
• Remote Web UI and failures fall back to DSH's in-app Host directory browser.

An optional patched DSH Desktop build is available in Releases for users who want every compatible plugin to receive a Desktop-level native picker. It is not required by dsh-projects. See native picker options for the trade-offs and checksum instructions.

Chat without choosing a project

A regular chat receives an isolated task directory automatically:

~/Documents/DSH-Default/YYYY-MM-DD/new-chat[-N]

Default tasks stay out of the Projects section but remain available in Recent. Each chat gets its own workspace instead of treating the whole Documents or home directory as writable.

Compatibility

Surface	Current status
DSH Desktop 2.0.1 / Windows x64	✅ Manually verified, including the native directory chooser
Local DSH Web UI / Windows	🟡 Designed to work; more manual regression coverage is needed
DSH Desktop / macOS Apple Silicon	🟡 CI passes; native picker and file-manager actions need manual coverage
Local Web UI / macOS and Linux	🟡 CI passes; Host paths and local directory rules need manual coverage
Remote Web UI	✅ Uses the Host-side in-app browser and never opens an OS dialog remotely

See the full compatibility matrix and architecture notes. DeepSeek Harness is still a Developer Preview, so runtime upgrades may require compatibility work.

Optional chat-body search

Project and chat-title search work by default. Chat-body search requires the DSH session index in the target profile's cordis.patch.yml:

- id: session-query-sqlite
  config:
    path: !!js dshHomePath('session-search.sqlite')
    openAt: first-search

The index contains data derived from chat content and should receive the same privacy protection as the original sessions.

Data and uninstalling

Basic mode does not create a second project database, and uninstalling the plugin does not delete folders or session logs. Grouping, ordering, pins, and favorites are browser-local preferences stored in localStorage. The optional multi-folder layer stores only its label, Workspace IDs, and primary Workspace ID there; it does not store chat bodies or move files. Clearing site data dissolves local groups without changing DSH Workspaces, Sessions, or project files.

Development and feedback

npm install
npm run verify
npm pack --dry-run

This is an alpha. Use the structured forms to report a bug, share a platform compatibility result, or propose a feature. Remove private paths, prompts, and credentials before submitting.

See CONTRIBUTING.md for contribution guidance, CHANGELOG.md for release history, and the public roadmap for possible next steps.

If dsh-projects makes your Workspace or sidebar workflow easier, consider leaving a Star. It helps other DSH users discover the project, while real compatibility reports directly shape the next release.

License

MIT