Introduction to the DSH Prompt Optimizer Plugin

DeepSeek Harness（DSH）用户在与 Agent 交互时，常遇到输入指令模糊、缺乏结构化约束的问题，导致 Agent 理解偏差或执行不达预期。DSH Prompt Optimizer 插件位于用户输入与 Agent 执行之间，负责在发送前将随意输入转化为结构化、可执行的提示词。

该插件由 YMRwithNoworry 维护，是一个通用 Prompt 优化器。它的核心作用是将随意输入转化为结构化、可执行的提示词，并严格遵循“用户审核机制”。优化结果仅展示在预览弹窗中，供用户对比与确认，只有在用户明确点击“采用优化结果”时才会写回输入框，绝不会自动发送消息。

安装与启用¶

前置条件¶

DSH 版本 0.1.7-rc.2（@deepseek-ai/dsh）
Web profile（CLI 不支持 desktop profile）
pnpm（需在 PATH 中）

安装步骤¶

执行安装命令：

    dsh plugin --profile web add "git+https://github.com/YMRwithNoworry/dsh-prompt-optimizer.git"

手动将插件添加到 bundle 配置。编辑 ~/.dsh/profiles/web/package.json，在 dsh.profile.bundles 数组中加入 "dsh-prompt-optimizer"。
重启 dsh --profile web。

核心功能¶

插件通过以下步骤工作：
1. 读取草稿：点击 Composer 右下角的“✨ 优化提示词”按钮，读取当前输入（不发送）。
2. 智能分析：识别任务领域（如 Minecraft、UI Design、游戏开发等），分析复杂度与字符预算。
3. 结构化补全：根据强度设置，补全缺失的约束、验收标准与执行要求，复用 DSH 现有的 LLM 服务与认证。
4. 预览与写入：在弹窗中展示原始与优化结果的对比（支持逐行 Diff）。用户确认后，插件仅将优化结果写入输入框，由用户手动按发送。

典型用法¶

在输入框随意输入（如：“帮我做个好看的管理后台”）。
点击 ✨ 优化提示词。
在预览弹窗中查看原始 Prompt 与优化后的 Prompt。
选择 采用优化结果 写回输入框。
检查无误后，手动按发送。

配置与设置¶

插件支持在设置面板或通过 ~/.dsh/prompt-optimizer.json 配置。关键设置项包括：

优化模型：默认 current，复用当前会话模型。
思考强度：
- light：仅修语法、指代、缺失的动作对象。
- balanced（默认）：补全约束，结构化多步骤任务。
- deep：建立目标、标准、验收条件，推演歧义。
优化语言：auto（跟随原文）、chinese、english、original。
上下文策略：
- 参考项目规则：默认开启，读取 AGENTS.md、DESIGN.md 等白名单文件（不读源码）。
- 参考会话上下文：默认开启，仅用于消解指代，不复制整段历史。
- 视觉上下文：默认开启，仅引用文件名，不描述或猜测图片内容。

领域策略¶

插件内置了针对不同领域的策略，在检测到关键词时会自动应用。主要领域包括：
* minecraft：关注原版视觉语言、像素网格、Mod 实现约束。
* ui-design：关注信息层级、交互状态、可访问性。
* game-development、coding、writing、research、data-analysis 等。

注意事项¶

安全边界：插件严格增强意图，绝不改变用户原始意图。它不自动决定技术选型（如数据库类型），也不新增功能或范围。
数据隐私：插件不读取源码文件，不复制整段历史会话，视觉上下文仅保留文件引用。
版本要求：必须使用 DSH 0.1.7-rc.2 或更高版本。

生态链接¶

插件目录：https://www.skillhub.cn/plugins/YMRwithNoworry/dsh-prompt-optimizer
GitHub 仓库：https://github.com/YMRwithNoworry/dsh-prompt-optimizer