Preface¶

In DSH / agent development, the Web UI input box often needs to reference files or directories in the current Session workspace, as well as reuse prompt words that have been successfully submitted before. The DSH ecosystem emphasizes plugin-based extension, and dsh-input-plus is one DSH Web UI input box enhancement plugin: it does not replace the official input components, but instead builds on the official @ and / input triggers to provide file/directory path selection and current Session user prompt history candidates.

Below introduces its positioning, core features, installation methods, and usage notes.

What This Is¶

dsh-input-plus is a DSH Web UI input box enhancement plugin maintained by WhitePlusMS, licensed under MIT.

It mainly solves two types of input scenarios:

• Use @ to select a file or directory path in the current Session workspace;
• Use /h to open a candidate menu of successfully submitted user prompts in the current Session, with keyword filtering support.

The plugin retains plain-text path references in drafts, does not read files, expand directories, or generate directory listings.

Core Features¶

@ File and Directory Path Selection¶

Type @ in the DSH input box, then continue typing a file name, directory name, or path fragment. Candidates come from the current Session workspace.

After selection, a plain-text path reference is retained in the draft, for example:

@src/contract.ts

The reference here only contains the path itself. When sending the message, the plugin does not read the file, expand directories, or generate a directory listing.

After selecting a directory, you can continue typing subsequent instructions, for example:

@src Find the code responsible for candidate ranking

The official input trigger flow handles the candidate menu, cursor, and write-back behavior. The plugin does not replace the official textarea, send button, or candidate menu, nor does it take over native arrow key behavior.

/h Input History Candidates¶

Type /h in the DSH input box to open a candidate menu of successfully submitted user prompts in the current Session.

After opening the menu, you can continue typing keywords to filter candidate results:

/h

Installation and Activation¶

The plugin requires DSH 0.1.0-rc.6 or a compatible DSH Web profile.

Install it through the official DSH profile plugin process:

dsh plugin --profile web add https://github.com/WhitePlusMS/dsh-input-plus/archive/refs/tags/v0.0.2.tar.gz

This command installs the GitHub tag tarball. GitHub tag installation directly consumes the committed lib/ Host and Client artifacts; if it is a source-only tarball, the installation will fail.

If you need to create or update an installation tag, you should first run:

pnpm run build

and commit the generated lib/ directory.

Configuration¶

The plugin registers an input-plus settings namespace. Options related to the plugin’s workspace indexing and path resolution include:

• maxIndexDepth
• maxIndexEntries
• referenceRoot

These options are used to adjust the plugin’s behavior when generating path candidates and resolving paths.

Typical Usage¶

Below is a set of usage examples that can be directly reproduced in the DSH Web UI input box.

1、Type @, then continue typing a file name, directory name, or path fragment.

@

Candidates come from the current Session workspace.

2、After selecting from the candidates, the draft retains a plain-text path reference:

@src/contract.ts

3、After selecting a directory, you can continue typing instructions:

@src Find the code responsible for candidate ranking

4、Type /h to open the candidate menu of successfully submitted user prompts in the current Session:

/h

5、Continue typing keywords to filter history candidates.

Applicable Scenarios and Notes¶

dsh-input-plus is suitable for users who need to quickly reference paths in the current Session workspace or reuse historical prompt words in the DSH Web UI.

Usage notes:

• The plugin does not replace the official textarea, send button, or candidate menu;
• The plugin does not take over native arrow key behavior;
• Path references are plain text in the draft; when sending, it does not read files, expand directories, or generate directory listings;
• The plugin runs with the current dsh process permissions; check the source code and license before installation;
• The current license is MIT.

The DSH community directory is an independent site with no official affiliation to DeepSeek / 幻方, and should not be understood as an official app store.

Links¶

GitHub repository: https://github.com/WhitePlusMS/dsh-input-plus