前言¶

DeepSeek Harness (dsh) 通过插件机制扩展工具集。在 Agent 开发或使用中，输入往往简短或模糊（例如“帮我写个周报”），直接使用这些指令会导致输出质量不稳定。dsh-tools-plugins 插件为此提供了一个解决方案，通过 optimize_prompt 工具，将自然语言指令改写为包含明确结构（Role, Task, Constraints, Output Format）的 Prompt。

核心功能¶

该插件主要提供 optimize_prompt 工具。

1. 指令重写：接收简短或模糊的指令，利用配置的 LLM 将其改写为结构化 Prompt。
2. 结构化输出：改写后的 Prompt 通常包含四个核心部分：Role（角色）、Task（任务）、Constraints（约束条件）和 Output Format（输出格式）。

安装与启用¶

通过 dsh 的 CLI 安装：

dsh plugin --profile web add github:lizhi00001/dsh-tools-plugins

安装完成后，需要重启 dsh 进程以使插件生效。

如果进行本地开发，环境需要满足以下依赖：
* Node.js 版本：^22.19 或 >=24
* 包管理器：pnpm

典型用法¶

安装插件后，可以通过两种方式使用 optimize_prompt：

1. 手动调用：在 Web UI 中直接输入指令：

Use optimize_prompt to rewrite: "help me write a weekly report"

2. 自动检测：Agent 在处理对话时，若检测到指令模糊，会自动调用该工具进行优化。

配置¶

在 cordis.patch.yml 中配置插件参数，可以覆盖默认的模型设置：

- id: dsh-prompt-enhancer
  config:
    provider: deepseek
    model: deepseek-chat
    maxTokens: 1200

如果不指定 provider 和 model，插件将使用当前 Profile 的默认模型。

生态与开发¶

该插件已声明 dsh.bundle.patch 并添加 dsh-plugin 主题，因此可出现在 DSH 插件生态目录中。开发涉及 TypeScript 编写和构建。

总结¶

dsh-tools-plugins 解决了 Agent 输入指令质量参差不齐的问题，通过结构化 Prompt 重写提升任务执行确定性。更多细节与源码：https://github.com/lizhi00001/dsh-tools-plugins