前言¶
在 DeepSeek Harness(DSH)里和模型对话,常见情况是:你心里清楚要做什么,输入框里却只有一句含糊的草稿——缺上下文、多个目标搅在一起、前提没写全。直接发送,模型往往是在猜你的意图。
社区插件 dsh-prompt-enhancer 把「把话说清楚」这一步交给当前会话的默认模型:读草稿,补全显然需要但未写出的信息,只回一条改写后的提示词;不改你的意图,也不替你回答问题。下面介绍它是什么、怎么装、怎么用,以及边界行为。
这是什么¶
dsh-prompt-enhancer 由 Xyvanlabs 维护,在 SkillHub 目录中归类为「模型推理」。当前 package.json 版本为 0.1.0,许可证 MIT。
它在 DSH 会话输入框右下角(发送按钮左侧、模型选择器左边)增加一颗提示词增强按钮:写下大概意思,点一下,草稿被替换成更清晰、更具体的提示词;不满意可取消进行中的请求,改坏了可用还原写回原稿。交互规格参考 WorkBuddy 5.8.3 同名功能的三态按钮;空草稿时按钮仍占位(半透明),与原版「不渲染」略有不同,便于发现功能。
核心功能¶
增强与还原¶
- 在输入框写下草稿(一句话即可)。
- 点星芒图标(悬停提示「增强提示词」)。请求期间按钮转圈(「增强中…(点击取消)」),输入框内容在结果返回前不变,你仍可查看或修改。
- 结果返回后,整段草稿被替换为增强版,按钮变为还原箭头(「还原原文」)。可继续编辑或直接发送。
- 点还原箭头,或手动改动输入框内容(备份作废,回到空闲态),可退回原稿逻辑。
增强使用当前会话的默认模型(agentDefaultModel.currentSelection()),插件本身不提供模型选择器;每次点击都是一次独立的模型调用。
三态与边界¶
同一位置只会有一颗按钮,四种表现共用一颗控件:
| 状态 | 点击行为 |
|---|---|
| 空闲(星芒) | 发起增强 |
| 增强中(转圈) | 中止请求 |
| 已增强(还原箭头) | 写回原草稿 |
| 出错(红色星芒) | 重新增强;原因在 tooltip,约 6 秒后消失 |
资料中写明的典型边界包括:
- 草稿为空:提示「先输入内容再增强」,不发请求。
- 超过 12000 字:提示「内容过长,请控制在 12000 字以内」。
- 增强中修改草稿:结果丢弃,提示「输入内容已变化,增强结果已丢弃」。
- 输入框处于发送/排队相位(
adjudicating/submitting/frozen):按钮置灰。 - 无可用默认模型:提示「增强失败:没有可用的默认模型,请先在设置里选择模型」。
主机侧路由 /prompt-enhancer/enhance 仅接受回环地址访问;客户端不接触模型凭证,只调本机路由。
安装与启用¶
前置条件¶
| 依赖 | 要求 |
|---|---|
| DSH | >=0.1.1-rc.2 <0.3.0(package.json 中 dsh.engines.dsh) |
| Node.js | ^22.19.0 \|\| >=24.0.0 |
| 宿主能力 | webServer、llm、agentDefaultModel(由 DSH 提供) |
插件为 bundle 形态:cordis.patch.yml 向 loader 配置插入一行;客户端由 dsh-client-modules 加载 lib/client.js。
安装方式¶
方式一(推荐):打开 DSH 插件管理器,选择「安装本地目录 / 安装 bundle」,指向本仓库的绝对路径,装入目标 profile(通常为 desktop)。以 link 方式登记,源码改动对主机侧可见;客户端 bundle 需按 README 说明重载。
方式二:在 DSH 会话中让 agent 执行:
plugin_manager { action: 'install_bundle', target: '<本仓库绝对路径>' }
成功后返回 application: 'restart-required'。
方式三(命令行):
dsh plugin add link:<本仓库绝对路径> --profile desktop
dsh 不在 PATH 时,可用前两种方式。
装完必须重启 DSH¶
bundle 的加载器行仅在启动时解析。重启后可按 README 建议确认:插槽 conversation.input.right 的 occupants 含 id: prompt-enhancer;界面出现星芒按钮;curl http://127.0.0.1:<端口>/prompt-enhancer/status 返回 configured: true 及当前 provider / model。
典型用法与效果¶
README 给出了四条实测示例(provider aliyun、model deepseek-v4.1-flash-1017,单次约 1~2 秒)。同一条草稿再跑,措辞可能变化;语言、约束保留与大致长度相对稳定。长度在提示词里是软约束(约 800 字、通常不超过原稿两倍),代码不做截断,短草稿有时会长到原稿 2~3 倍,可再点一次重写或手动删减。
模糊交付物(中文)
输入:
帮我把这周的工作整理成周报,主要是给领导看,别太啰嗦,能看出我做了哪些事就行
实测会把「别太啰嗦」「能看出做了哪些事」落成可执行要求(分条、动作与结果),而不强行塞进未提及的章节结构。
英文草稿
输入抱怨式英文时,输出保持英文、不夹带 Language: English 等标签,并把「不知道要写什么」展开为 bug report 要素清单。
冗长中文
重复表述会被压缩,CSV / Excel / 时间范围等约束保留;对「加个功能」类草稿,可能补一句说明方案与代码改动类交付要求。
已较清楚的指令
例如指定文件与行号的空指针检查,会在不扩成教程的前提下,把「列出来」具体化为行号、片段与触发条件。
适用场景与注意¶
适合谁:经常在 DSH 里手写首版提示、希望少改几轮就能发出去的开发者;需要与 WorkBuddy 类似「输入框内增强」体验、又运行在 DSH 上的用户。
运行与信任:插件以当前 DSH 进程权限运行,会向本机 llm 发起流式调用(temperature: 0.5,maxTokens: 1400,超时 120 秒)。安装前请阅读 源码与许可证,确认符合你的环境策略。
已知限制(摘自 README):依赖 conversation.input.right 插槽的 useInput / inputActions;一次一颗按钮、单会话状态,切换会话会中止进行中请求;不支持单独选模型、不做流式回显;失败调用同样可能计费。
生态说明:DSH 主张「一切皆插件」;SkillHub 目录页 是社区收录站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-prompt-enhancer 把「提示词写清楚」留在发送前一步:一颗按钮、可取消、可还原,用会话默认模型改写草稿而不替代你的意图。需要安装包或细节时,可看目录页与仓库 README。
- 目录页:https://www.skillhub.cn/plugins/Xyvanlabs/dsh-prompt-enhancer
- GitHub:https://github.com/Xyvanlabs/dsh-prompt-enhancer