前言¶

在 DSH 的插件化扩展方式下，开发者可以把常用提示词、模型选择与参数替换封装成可调用单元。dsh-prompt-profile 解决的是重复出现的一组需求：按名称调用一段 Markdown 提示词，把命令参数替换进正文，为单轮会话选择 provider、model 和 reasoning effort，并在调用结束后恢复之前的 Agent 选择。

这是什么¶

dsh-prompt-profile 是 DeepSeek Harness 的插件，用于提供可复用的 Markdown prompt profiles。仓库地址如下：

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

资料中给出的许可证为 MIT。版本说明称 0.1 有意省略 prompt chains、loops、skill injection、subagents、worktrees 和 best-of-N orchestration。

核心功能¶

下面介绍已核实的能力。

1、从用户目录和项目目录发现 profiles；项目 profile 与相同相对名称的用户 profile 相比优先级更高。

2、使用 shell 风格占位符将位置参数替换进 profile 正文。

3、为单轮会话选择 provider、model 和 reasoning effort。

4、自动恢复之前的 Agent 选择；也可以按 profile 关闭恢复。restore 字段默认值为 true。

5、列出可用 profiles，并支持以斜杠分隔名称调用嵌套 profiles。

安装与启用¶

先确认 Node 版本与 peerDependencies 满足要求：

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"
  }
}

资料给出的安装命令是本地路径示例：

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

这条命令用于添加当前路径下的插件示例。资料未提供 GitHub 仓库安装命令，因此不应根据仓库名直接拼接 dsh plugin add ... 形式的命令。

Profile 位置与配置¶

用户目录和项目目录配置示例如下：

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

对应路径：

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

项目 profile 与相同相对名称的用户 profile 相比具有更高优先级。

Profile 写法¶

一个 profile 文件可以包含 frontmatter 和正文。资料给出的示例：

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

frontmatter 可包含以下字段：

• description：用于在 /prompt-profile list 中展示。
• provider、model、reasoningEffort：用于为单轮会话选择 provider、model 和 reasoning effort。
• restore：控制本轮结束后是否恢复先前 Agent 选择，默认值为 true。

如果省略 provider 和 model，资料说明会使用当前 Agent 选择。

嵌套 profile 用斜杠分隔名称。例如：

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

对应调用名称：

review/security

典型用法¶

下面两个示例来自资料：

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

第一条列出可用 profiles。第二条调用名为 review 的 profile，并把 src/index.ts 和 focus on cancellation 作为参数传入；具体如何替换取决于 profile 正文中的占位符。

适用场景与注意¶

dsh-prompt-profile 适合需要把一组提示词和模型参数复用于单轮 DSH 会话的场景，例如代码审查、固定上下文检查等。插件以当前 dsh 进程权限运行，安装前应检查源码、依赖和许可证。资料中给出的许可证为 MIT。

另外，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应把它理解为官方应用商店。

结尾¶

dsh-prompt-profile 的价值在于把提示词正文、位置参数、单轮 provider/model/reasoning effort 选择和 Agent 状态恢复放在一个 profile 里。本文资料中未包含目录页 URL，可用仓库地址如下：

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