Introduction

The DSH (DeepSeek Harness) plugin ecosystem emphasizes “Everything is a plugin.” The community plugin directory is an independent site with no official affiliation to DeepSeek or Fangfang; it should not be understood as an official app store.

In DSH, creating a new session defaults to requiring a workspace directory selection first. If a new profile’s workspace list is empty, the interface stops at the “Select Workspace” starting point, and users cannot directly start a conversation. Below is an introduction to fenxin-fx/dsh-default-workspace-plugin: it reduces this prerequisite step by automatically preparing a default workspace or providing an entry point to “Chat without a workspace.”

What is This

This is a DSH plugin maintained by fenxin-fx, identified by the package name @dsh-external/dsh-default-workspace with an MIT license. It addresses the problem that a default workspace directory needs to be selected before a new session starts; this plugin allows this step to be automatically completed or explicitly skipped.

Core Features

It provides two paths: first prepare a default workspace, then let the user decide whether to use a workspace.

  1. Auto-provision default workspace: On the first launch, parse the default workspace directory, create it if missing, and register it in the workspace records.
  2. Provide a no-workspace entry: Add Chat without a workspace (Chinese entry: 不在工作区中对话) to the workspace selector in a new session. Selecting it creates a session that does not bind to a workspace; the working directory falls back to the host’s process.cwd(), and the sidebar displays as Ungrouped.

Behavior constraints are as follows:

  • Auto-provision: Creates and registers the default workspace on the first launch.
  • No-workspace option: Adds a new line to the workspace selector.
  • Zero footprint: Does nothing automatically if a workspace already exists, unless configured with always: true.
  • Idempotent: Reuses an existing record when registering the same path repeatedly.
  • Non-fatal: Failing is recorded as a warning and will not cause the startup to fail.
  • Zero dependencies: Uses only Node built-in modules and browser APIs; no build step is required.

Default Directory

The default workspace directory is:

<DSH_HOME>/workspaces/default

If DSH_HOME is not set, it defaults to:

~/.dsh/workspaces/default

The priority is:

config.path → DSH_DEFAULT_WORKSPACE → <DSH_HOME>/workspaces/default

Configuration

The plugin configuration options are as follows:

Key Type Default Description
path string <DSH_HOME>/workspaces/default Default workspace directory
title string Default Display title for the workspace
always boolean false When set to true, ensures the default workspace exists even if other workspaces are present

You can also specify the default directory via an environment variable before launching:

DSH_DEFAULT_WORKSPACE="$HOME/projects/scratch" dsh web

Installation and Enablement

The recommended installation command is as follows. This command uses an explicit git+https source; the github: shorthand may fail on machines without SSH keys:

dsh plugin --profile web add "git+https://github.com/fenxin-fx/dsh-default-workspace.git#main"

After the first installation, the web profile needs to be restarted for the changes to take effect on the Node side. Subsequent upgrades only require a browser refresh. Enabling or disabling can be done in Settings → Plugins; the package identifier is @dsh-external/dsh-default-workspace.

Typical Usage

After completing the above steps, you can use it directly:

  1. Install and restart the web profile.
  2. A new profile will directly enter a conversation in the default workspace.
  3. In the workspace selector of a new session, you can choose Chat without a workspace to start an ungrouped, unbound session.

Suitable Scenarios and Notes

Suitable for:

  • Reducing the prerequisite “create/select workspace” step in a new profile.
  • Occasionally needing a conversation that does not belong to a workspace.
  • Wanting to retain DSH’s original workspace mechanism while adding a default entry and a no-workspace entry.

Pre-use notes:

  • The plugin runs with the permissions of the current dsh process; the source code and license should be checked before installing.
  • The working directory for Chat without a workspace sessions is the host’s process.cwd(). Please confirm this directory meets expectations.
  • This plugin comes from the community directory and does not represent the official app store of DeepSeek or Fangfang.

Related Links

  • Plugin Directory Page: https://www.skillhub.cn/plugins/fenxin-fx/dsh-default-workspace-plugin
  • GitHub Installation Source: git+https://github.com/fenxin-fx/dsh-default-workspace.git#main
  • Another Repository Entry in Source: https://github.com/fenxin-fx/dsh-default-workspace-plugin