DSH Desktop Edition 0.2.0 removed scanning of preset directories. Presets commonly used under the ~/.dsh/.agent-presets directory in 0.1.x environments will disappear from the mode selector. This plugin aims to restore this discovery channel by reconnecting the conventional 0.1.x preset directory to the DSH Desktop Edition 0.2.x mode list.

Plugin Overview

  • Name: dsh-preset-bridge
  • Maintainer: Lyrissonare
  • Category: Workflow
  • Core Features:
    • Reconnect the conventional 0.1.x preset directory to the DSH Desktop Edition 0.2.x mode list.
    • Handle the compatibility mapping from @deepseek-ai/dsh-workflow-worker-thread to the official dsh-workflow-ptc.
    • Support configuring additional scanning directories (roots) in cordis.patch.yml.
    • Rewrite relative line names to absolute file: URLs to fix mounting errors.

Installation and Enablement

Installing the plugin requires administrator privileges. Run the following command:

D:\DSH\resources\runtime\cli\bin\dsh.cmd plugin --profile desktop add https://github.com/Lyrissonare/dsh-preset-bridge

After installation, the desktop client must be restarted. After restarting, when creating a new session, check the mode selector; presets under .agent-presets should appear. You can also view them under “Settings” -> “Agent Presets” -> “Custom”.

Configuration

The plugin supports overriding configuration by id in the profile’s cordis.patch.yml:

- id: dsh-preset-bridge
  config:
    roots:   # 额外扫描目录；缺省只扫 ${DSH_HOME:-~/.dsh}/.agent-presets
      - D:/somewhere/else/presets

Notes

  1. Version restriction: Only applicable to the 0.2.x Desktop Edition profile (>=0.2.0-rc <0.3.0-0); do not install it in a 0.1.x environment.
  2. Mount status: Being “discovered” does not guarantee a “healthy mount.” The plugin is only responsible for registering presets into the registry; it does not manage the 0.2.x compatibility of the preset contents themselves. If a preset fails to mount, it will be displayed under “Settings” -> “Agent Presets” -> “Custom”.
  3. Compatibility mapping: Compatibility mappings are accumulated item by item and currently only cover known issues (mainly the replacement of worker-thread with workflow-ptc). If a preset references other packages removed in 0.2.0, it may still fail to mount.
  4. Engine differences: worker-thread and workflow-ptc are two different engine implementations (thread pool vs. spawned child processes). Workflow-type presets may have subtle differences in runtime details.
  5. Major version updates: DSH major version updates may invalidate this plugin (in 0.3.0+, these conventions may change at any time).
  6. Transitional nature: This plugin is a transitional patch and may be retired at any time.
  7. No guarantee: This plugin is provided “AS IS” without any warranty.

Technical Details

  • Relative path fix: When 0.2.0 mounts presets, it resolves relative script names based on the base URL at the declaration site; local scripts inside preset directories may fail to resolve. Before mounting, the plugin rewrites line names starting with ./ to absolute addresses using pathToFileURL.
  • Dependency replacement: Delegation groups in 0.1.x presets typically include @deepseek-ai/dsh-workflow-worker-thread, which was removed in 0.2.0. The plugin replaces it in place with the official @deepseek-ai/dsh-workflow-ptc before registration.
  • Name collision handling: If preset names collide (with built-in presets or with each other), the registry throws an error. The plugin catches this, emits a warning, skips the entry, and prevents a single broken preset from blocking the registration of the rest.

Summary

dsh-preset-bridge is a transitional solution introduced to address the removal of directory scanning in DSH Desktop Edition 0.2.0. It can reconnect presets from the local .agent-presets directory back to the system, but it only covers known compatibility issues and does not guarantee that all presets will work.