Introduction¶

After opening multiple workspaces, the sidebar flattens all workspace sessions together. It becomes difficult to find them when there are many sessions. You either rely on scrolling or recall the Session ID to remember which environment it belongs to. This plugin solves this step: first, consolidate the workspaces into a dropdown box, and then, within the same workspace, split the sessions into three groups: Today, Yesterday, and Earlier based on the local date.

First, let’s clarify the positioning: This is a client-side sidebar plugin for DeepSeek Harness (DSH), maintained by faqfaqfaqfaq (GitHub repository owner; the author field in package.json is written as fangqi). It belongs to the community ecosystem and is published in the third-party plugin directory. This directory is an independent site and has no official affiliation with DeepSeek / Quant; please do not treat it as an official app store. The philosophy of DSH itself is “everything is a plugin,” so a sidebar modification can also stand as an independent plugin.

What is it¶

After enabling the plugin, the original workspace list on the left side of the sidebar becomes a workspace dropdown. Selecting a workspace lists only that workspace’s sessions, split into Today, Yesterday, and Earlier by the local calendar. Original actions on session entries remain unchanged.

The scope is limited to the interface: operations like registration, renaming, and icons are maintained by the plugin itself; deleting a workspace entry only cancels the registration, and files on the disk and the sessions inside are not deleted.

Core Features¶

The workspace dropdown supports search by name or path. The button on the right can create a new session or register an existing folder as a workspace.

Workspace entries support a right-click menu or the “…” menu at the end: Rename, Delete Registration, Select Icon. Deleting the registration does not touch the files.

After selecting an image, the plugin copies it to the workspace’s .deepseek directory (creating the directory if it doesn’t exist). Subsequently, the latest image in the directory serves as the workspace icon; if no image is available, the first character of the name is displayed. Supported icon formats include PNG, WebP, JPEG, GIF, SVG, and ICO, with a single file size not exceeding 256 KB. It only reads from the .deepseek directory of registered workspaces.

Regarding session grouping, the group names are aligned with the word “Workspace”, and session titles are aligned with the workspace name. Each group can be collapsed. Grouping is based on local date and is not affected by the server timezone.

Session entries retain original operations: Pin, Rename, Fork, Archive, Copy Session ID. In-progress sessions display a loading marker, and completed but unread sessions display a dot.

Installation and Enablement¶

According to the README, once the plugin market is indexed, you can install it by searching for “工作区分组” (Workspace Groups) or dsh-sidebar-workspace-groups on the DeepSeek Harness discovery page.

You can also clone the repository first and then install that directory in the plugin management:

dsh plugin add <repository directory>

This step adds the locally checked plugin directory to the current DSH instance, and then loads it as a client-side plugin.

Version requirements: Requires DeepSeek Harness 0.2.0 or newer. The dsh.engines.dsh field in the package is written as >=0.2.0. The license is MIT. The current package version is 1.0.0.

Typical Usage¶

Register an existing folder: First, select “Add Workspace” in the button next to the dropdown, point to a local existing directory. The plugin only records this registration relationship and does not copy files.

Set icon: Select “Select Icon” in the workspace entry menu, pick a PNG or WebP under 256 KB. The plugin will copy it to <Workspace>/.deepseek/, and the latest image in that directory thereafter becomes the icon.

Time-based traversal: Sessions from today are at the top, yesterday’s are folded into the next group, and earlier ones are gathered in the last group. Click the group name to collapse.

Use Cases and Notes¶

Suitable for two types of people. One is developers who split directories by project locally and use DSH to handle multiple projects; after filtering the sidebar by workspace, sessions from different projects no longer mix together. The other is people who want the sidebar to shoulder some indexing responsibilities; they can conveniently pair an icon for each workspace to reduce recognition costs in multi-workspace scenarios.

Three points need attention. First, the plugin runs with the permissions of the current DSH process. Read the source code before enabling to confirm that cordis.patch.yml and the client-injected dependencies match expectations. Second, icons are only read from the .deepseek directory of registered workspaces; do not put demo images in without knowing the source. Third, deleting a workspace registration does not delete files, but before manually deleting the folder later, confirm that there are no running sessions inside.

Summary¶

The value of this plugin is clear at the interface level: changing “finding a workspace’s sessions” from flipping through a list to first switching the workspace, then looking at the grouped sessions. The cost is that the sidebar area changes from a vertical list to a dropdown plus a grouped list. The functionality isn’t extensive, but every step corresponds to a concrete action, making it suitable for daily use in a multi-workspace environment.

Directory Page: https://www.skillhub.cn/plugins/faqfaqfaqfaq/dsh-sidebar-workspace-groups
Repository: https://github.com/faqfaqfaqfaq/dsh-sidebar-workspace-groups