前言¶
在使用 DeepSeek Harness (DSH) 时,若直接向后台 agent 提交的需求描述不够严谨或缺乏上下文,可能导致 agent 无法准确定位文件或理解约束。vinzelles/dsh-prompt-enhancer 插件旨在解决这一问题。它通过隔离后台 agent 的方式,结合对话上下文和仓库知识对用户提示词进行重写与增强,并在结果末尾附上经过存在性校验的参考文件清单,确保指令清晰且可落地。
核心功能¶
该插件在聊天输入框右侧提供两个操作按钮:
* 强化:利用隔离的后台 agent,结合当前对话上下文和仓库知识(通过 glob/grep 等方式),将原始输入重写为结构清晰、约束明确的任务提示词。强化结果不自动发送,不进入主对话历史,仅替换输入框草稿。结果末尾附带经过存在性校验的参考文件清单。
* 还原:一键将输入框恢复到强化前的原文状态。
安装与启用¶
安装后需重启 dsh web 或刷新页面才能看到图标。
dsh plugin --profile web add github:Vinzelles/dsh-prompt-enhancer
配置说明¶
在设置 -> 插件 -> 插件配置 -> “提示词强化”卡片中可进行配置:
* 强化强度:
* 低:仅做措辞与结构润色,篇幅最接近原文,不带任何文件引用。
* 中:标准优化,输出紧凑(约 ≤1.5 倍原文),参考文件仅列路径。
* 高:充分展开背景、步骤与验收,输出篇幅 ≤3 倍原文,参考文件带说明。
* 模型配置:支持为强化功能单独指定模型,配置即时生效,无需重启。建议设置轻量快速模型以避免消耗过多 token。
* 转换英文:支持“转换英文”开关。开启后,无论输入何种语言,强化结果均输出为英文提示词(参考文件节标题变为 ## Reference Files,技能引用节为 ## Skill References)。关闭则跟随输入语言。
使用流程¶
- 在聊天输入框输入需求。
- 点击右侧的“强化”按钮,输入框会被锁定,后台 agent 开始处理。
- 强化完成后,输入框显示重写后的提示词及参考文件清单。
- 点击“还原”按钮可恢复原文。
注意事项与故障排查¶
- 强化期间输入框会被锁定,无法编辑。
- 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。
- 零污染:强化在隔离子会话中运行,不污染主对话历史。
- 路径校验:参考文件清单逐行校验存在性,不臆造路径。
- 故障排查:图标不显示或行为异常时,查看日志
~/.dsh/super-injector/prompt-enhancer-diag.log。
结语¶
该插件通过隔离的 agent 运行机制和严格的路径校验,为 DSH 用户提供了安全、可靠的提示词增强方案。对于需要频繁与 agent 协作的开发者,能够显著提升指令的准确性和执行效率。