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