Preface¶

By default, DSH sessions are bound to project workspaces. When encountering temporary Q&A or small tasks, to avoid polluting the current workspace, one typically needs to create a new directory, switch to it, and then begin; if handling several unrelated tasks at the same time, directory management becomes even more troublesome.

zsqbfan/dsh-chat-sessions does exactly this: it creates sessions with independent workspaces with a single click, allowing daily Q&A and small tasks to start without manually selecting a project directory, while files generated by each session remain isolated. The appearance and interaction are close to the native DSH sidebar, preserving existing session operation habits.

It is maintained by zsqbfan personally, categorized as a Client, listed in the community directory as a third-party plugin, and has no official affiliation with DeepSeek or Futures.

What is this¶

A one-sentence definition: A DeepSeek Harness plugin that adds “sessions with independent workspaces” to the main interface and integrates operations such as creating, switching, and archiving into the native sidebar.

It solves the burden of “preparing the directory before starting work” when handling multiple unrelated tasks in parallel. New rooms have independent workspaces and directories, and title links provide file entry points, eliminating the need to manually select a project directory first. Derived or subsequent sessions may share that directory.

Host Requirements: DeepSeek Harness >=0.2.0-rc.2 <0.3.0-0, development and testing baseline is 0.2.2-rc.1. License: MIT. Current version v0.1.1.

Core Features¶

1. One-click start, independent workspace. Create a dialogue with an independent workspace with a single click; each stores files generated by the task, and different tasks do not interfere with each other, without the need to manually select a project directory first.
2. Existing session operation habits. The interaction style remains consistent with the original DSH; operations like switching, pinning, archiving, and restoring use familiar methods, requiring no re-adaptation to get started.
3. File management, easy to find. Organize file entry points by session title, making it easy to find files generated during a specific conversation, and allowing for viewing, editing, or continuing use at any time.

A point to clarify: An independent directory is not the same as a system sandbox. Rooms are located at <root>/.sessions/, and title links are just file entry points. The plugin does not isolate processes or permissions at the system level.

Installation and Enablement¶

Below are the official installation steps from the README; the commands and paths are recorded as in the original text:

1. Download dsh-chat-sessions-0.1.1.tgz from Release (SHA256 checksum file also attached).
2. In DSH "Plugins → Add Plugin", fill in the absolute path of the downloaded file, install and enable; reload or restart as prompted by the host.

The current Release is v0.1.1. The main branch is used for future development; use the corresponding Release installation package when a fixed version is needed; do not track main directly.

Typical Usage¶

1. Create a session in the sidebar to get a room with an independent workspace, without selecting a directory first.
2. Ask questions and generate files normally in the room; files fall into the room’s own workspace and do not enter other sessions’ directories.
3. Archive the room using the native session menu; retrieve it from the native archive list when needed. Archiving unpins the room, and it can be pinned again after restoration.
4. Use the title link as a file entry point to view, edit, or continue using files generated by that session.

The background syncs the title link and workspace ownership approximately every 15 seconds; unsent drafts are saved in the browser.

Applicable Scenarios and Considerations¶

Suitable for developers who believe in using DSH for parallel small tasks and want each task to have an independent directory, as well as those who do not want to repeatedly switch project workspaces for temporary tasks.

Before installation, please note that the plugin runs with the permissions of the current DSH process and can read/write directories accessible by that process; please check the source code and MIT license before enabling to confirm the source. It injects native session and workspace related modules into the host via the plugin page; it may need adaptation after major DSH updates; currently it is primarily verified in the 0.2.2-rc.1 environment on macOS, other platforms and versions are still under verification.

Points to note during use:

• When upgrading, retain the original root configuration. Changing the storage location will not automatically migrate old data; archived sessions from old versions can be manually restored from the native archive list.
• When starting or re-enabling the plugin, only recycle empty directories that have been archived and have no unarchived sessions sharing them (allowing only .DS_Store), preserving archived state and session logs; non-empty directories are retained.
• Disable and uninstall are done via the DSH plugin page. After disabling, the underlying workspace may be exposed, but rooms, logs, and existing workspaces are retained; this version does not have automatic disable recycling, nor does it have multi-session room exit management functionality. When backing up, retain both room files and DSH’s session, workspace, and archive records.
• The old configuration item idleMs has been disabled; retaining the old configuration will not take effect.

v0.1.1 fixed the issue where blank dialogues were automatically archived after waiting for about 90 seconds, and the editor falling back to workspace selection.

Summary¶

This plugin changes “binding a session to a workspace” to “one-click start”, suitable for scenarios in DSH where multiple small tasks are processed in parallel without interfering with each other. It relies on the native sidebar structure and is a personal maintenance project; if you encounter issues, it is recommended to attach the DSH version, system, and reproduction steps to GitHub Issues.

Directory Page: https://www.skillhub.cn/plugins/ZSQBFan/dsh-chat-sessions

GitHub: https://github.com/ZSQBFan/dsh-chat-sessions