前言¶

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