Introduction

Under DSH’s plugin-based extension mechanism, developers can encapsulate common prompts, model selection, and parameter replacement into callable units. dsh-prompt-profile addresses a recurring set of needs: calling a Markdown prompt by name, injecting command arguments into the body, selecting provider, model, and reasoning effort for single-turn sessions, and restoring the previous Agent selection after invocation.

What is it

dsh-prompt-profile is a plugin for DeepSeek Harness used to provide reusable Markdown prompt profiles. The repository address is as follows:

https://github.com/BrambleXu/dsh-prompt-profile

The license provided in the documentation is MIT. The version note states that version 0.1 intentionally omits prompt chains, loops, skill injection, subagents, worktrees, and best-of-N orchestration.

Core Features

The following introduces verified capabilities.

  1. Discover profiles from the user directory and project directory; project profiles have higher priority than user profiles with the same relative name.
  2. Use shell-style placeholders to inject positional arguments into the profile body.
  3. Select provider, model, and reasoning effort for single-turn sessions.
  4. Automatically restore the previous Agent selection; this can also be disabled per profile. The restore field defaults to true.
  5. List available profiles and support calling nested profiles with names separated by slashes.

Installation and Activation

First, confirm that the Node version and peerDependencies meet the requirements:

Node: ^22.19.0 || >=24.0.0

{
  "peerDependencies": {
    "@deepseek-ai/cordis": "^4.0.1",
    "@deepseek-ai/dsh-agent": ">=0.1.0-rc.5 <1",
    "@deepseek-ai/dsh-commands": ">=0.1.0-rc.5 <1",
    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.5 <1"
  }
}

The installation command provided in the documentation is an example using a local path:

dsh plugin --profile demo add ./dsh-prompt-profile

This command is used to add the plugin example from the current path. The documentation does not provide a GitHub repository installation command, so commands in the form dsh plugin add ... should not be directly concatenated based on the repository name.

Profile Locations and Configuration

Example configuration for user and project directories:

- id: dsh-prompt-profile
  name: dsh-prompt-profile
  config:
    userDirectory: ~/.dsh/prompt-profiles
    projectDirectory: .dsh/prompt-profiles

Corresponding paths:

~/.dsh/prompt-profiles
.dsh/prompt-profiles

Project profiles have higher priority than user profiles with the same relative name.

Profile Syntax

A profile file can contain frontmatter and body content. The example provided in the documentation:

---
description: Deep code review
provider: deepseek
model: deepseek-reasoner
reasoningEffort: high
restore: true
---
Review $1 for correctness, regressions, and missing tests. Extra context: ${@:2}

The frontmatter can include the following fields:

  • description: Used for display in /prompt-profile list.
  • provider, model, reasoningEffort: Used to select provider, model, and reasoning effort for single-turn sessions.
  • restore: Controls whether to restore the previous Agent selection after the current turn; defaults to true.

If provider and model are omitted, the documentation states that the current Agent selection will be used.

Nested profiles use names separated by slashes. For example:

.dsh/prompt-profiles/review/security.md

Corresponding call name:

review/security

Typical Usage

The following two examples are from the documentation:

/prompt-profile list
/prompt-profile review src/index.ts "focus on cancellation"

The first lists available profiles. The second calls a profile named review, passing src/index.ts and focus on cancellation as arguments; the specific replacement depends on the placeholders in the profile body.

Applicable Scenarios and Notes

dsh-prompt-profile is suitable for scenarios requiring a set of prompts and model parameters to be reused in single-turn DSH sessions, such as code review and fixed context checks. The plugin runs with the permissions of the current dsh process; source code, dependencies, and license should be checked before installation. The license provided in the documentation is MIT.

Additionally, the community directory is an independent site with no official affiliation with DeepSeek / Huafan, and it should not be understood as an official app store.

Conclusion

The value of dsh-prompt-profile lies in putting prompt body, positional arguments, single-turn provider/model/reasoning effort selection, and Agent state restoration into one profile. The directory page URL is not included in the documentation provided here; the repository address is available below:

https://github.com/BrambleXu/dsh-prompt-profile