The DSH Web profile provides basic file browsing capabilities, but when handling OpenSpec changes, you usually need to switch directories manually or use the command line. The dsh-openspec plugin integrates an entry directly in the session title bar for quick access to the project’s openspec/ directory, creating a closed loop for browsing, previewing, editing, and saving.

This is a DeepSeek Harness client plugin maintained by wx971025. It addresses the need to view, preview, and edit OpenSpec change files in the Web interface without depending on the openspec CLI tool itself.

Core Features

The plugin interacts with the DSH Web UI in the following ways:

  1. Session title bar integration: After installation, an OpenSpec button appears next to Session log in the session title bar.
  2. Automatic workspace following: The panel content follows the current session’s workspace (or session directory), without requiring manual project path configuration.
  3. Directory listing: Automatically lists all contents under the openspec/ directory, including config.yaml, specs/, changes/, archive/, and so on.
  4. Preview and editing:
    • Provides preview mode for Markdown files.
    • Displays other text files in source mode; all support editing.
  5. Save confirmation: Saving is subject to Host write-to-disk confirmation.
  6. Non-invasive operation: The plugin itself does not create, delete, or rename files, nor does it call the openspec CLI.

Installation and Enabling

Before use, make sure that dsh can run on your local machine and that you are using the web profile (i.e., dsh web or dsh --profile web).

1. Install the Plugin

Run the following command in the terminal to add the plugin to the web profile:

dsh plugin --profile web add github:wx971025/dsh-openspec#v0.1.0

2. Verify Installation

After installation, you can use the following command to confirm that the plugin is active:

dsh --profile web --dump-config

You should be able to find entries related to dsh-openspec in the output configuration.

Typical Usage

  1. Start the Web service:
    dsh web

The browser will open the Harness Web UI (the default address is usually `http://127.0.0.1:3080`).

  1. Open a session that has already been bound to a project directory.

  2. Click the OpenSpec button in the session title bar; the panel will display the openspec/ directory contents of the current project.

  3. If there is no openspec/ folder under the current project root directory, the panel will display “Current project has no OpenSpec”.

Notes

  • Source installation dependency: If you use source installation mode (installing via a local absolute path), the local directory must be retained. If the directory is deleted or moved, plugin loading will fail.
  • pnpm 10 compatibility: When using pnpm 10, if installation reports that build scripts are blocked, add the corresponding key to the allowBuilds configuration in the profile’s pnpm-workspace.yaml, and then rerun the installation command.
  • Version adaptation: This plugin is developed for the 0.1.0-rc.5 Web profile of DeepSeek Harness; for other versions, verify whether the extension points are still available.
  • Uninstallation impact: After uninstalling the plugin, the title bar button and the /openspec-viewer interface will disappear, but the openspec/ files on disk will not be deleted.

Summary

dsh-openspec provides a lightweight Web UI entry point that allows DSH users to manage OpenSpec change files without leaving the browser. Together with DSH’s “everything is a plugin” philosophy, it provides a smoother documentation management experience in the agent development workflow.