dsh-prompt-enhance
Manifest valid★ 4DSH Web GUI prompt enhancement plugin: transform composer drafts into structured prompts with a single click, supporting docked result cards, apply-backfill, copy, regenerate, and undo.
dsh-prompt-enhance
DeepSeek Harness Web GUI 的「提示词增强」插件 —— 一键把输入框草稿改写为结构化提示词(角色与目标、可执行步骤、输出格式、验收标准、边界条件)。原文保留,失败不改草稿。
简体中文 | English

为什么需要它
写提示词最费劲的往往不是想法,而是补成适合模型执行的样子:角色(助手扮演谁)、交付物(最终交付什么)、输出格式(结构、语言、长度与风格)、合格标准(怎样判断结果正确)。
本插件在输入框加入「提示词增强」按钮,点击即调用 harness LLM 服务生成规范提示词。
增强结果展示在对话框上方且不遮挡对话;不直接替换原文,可回填、复制、重新生成或撤销,原文安全。
开启上下文感知后参照最近几轮对话消解指代,自主理解任务需求。
功能一览
| 功能 | 说明 |
|---|---|
| 🐋 一键增强 | 输入框工具栏按钮(左上角带星芒的 DeepSeek 鲸鱼标识);快捷键默认关闭,可在设置中指定 |
| 🖼️ 停靠结果卡 | 结果显示在输入框上方,不遮挡对话;附模型、耗时与 token 用量,超限时提示结果可能不完整 |
| ↩️ 回填、复制与撤销 | 回填后可直接撤销;关闭卡片后,输入框上方仍保留撤销条 |
| 🔄 重新生成 | 按当前输入框内容再请求一版;回填后也可对增强稿继续生成 |
💬 /enhance 命令 | 斜杠面板直接改写任意文本;结果不进入模型历史 |
| 🧭 模型路由 | 设置中同时指定 provider 与 model 时优先;否则依次跟随当前会话模型、全局默认模型 |
| 🧩 上下文感知 | contextAware 开启时参考最近几轮对话补全「它 / 这个」这类指代,可随时关闭 |
| 🔑 零凭据配置 | 调用走 harness LLM 服务,密钥来自 harness 凭据存储;插件不读取也不保存 |
| 🛡️ 草稿安全 | 空输入、仅附件、超长、含命令或文件引用都在本地拦截,不发请求;上游失败映射为可读提示;失败绝不改动草稿 |
| ⚙️ 配置热生效 | 字段改完自动保存,常用项在前、其余收进「高级设置」;改动对下一次调用立即生效,无需重启 |
环境要求
| 项目 | 要求 |
|---|---|
| dsh | >= 0.1.1-rc.2 < 0.3.0,已在 0.2.2-rc.3 验证 |
| Node(仅源码构建) | ^22.19.0 || >=24.0.0 |
安装
装之前请确认包名。npm 上的 dsh-prompt-enhance(无 scope)是上游原项目,本插件是它的重写分支,包名是 @surfishs/dsh-prompt-enhance。本插件的安装源是本仓库 surfishs/dsh-prompt-enhance 或它在插件市场里的条目。不要执行 dsh plugin add dsh-prompt-enhance。
让 Agent 帮你安装
不用自己敲命令。把下面整段发给能操作本机终端的 Agent(DSH 桌面版、Web 版都可以):
帮我安装 DeepSeek Harness 插件 @surfishs/dsh-prompt-enhance。
1. 先确认我的 DSH profile 名:桌面版通常是 desktop,Web 版通常是 web;不确定就问我。
2. 执行:dsh plugin --profile <profile> add @surfishs/dsh-prompt-enhance
3. 如果 npm 安装失败,改用:dsh plugin --profile <profile> add github:surfishs/dsh-prompt-enhance
4. 安装完成后提示我重启 DSH,并让我确认插件出现在插件列表中。
5. 不要修改我的其他插件或 DSH 配置。
从 npm 安装:
dsh plugin --profile <profile> add @surfishs/dsh-prompt-enhance
# 重启 dsh
<profile>换成你的 profile 名:桌面版通常是desktop,Web 版通常是web。
从 GitHub 安装(lib/ 已随仓库提交,无需本地构建):
dsh plugin --profile <profile> add github:surfishs/dsh-prompt-enhance
从本地检出(开发用):
git clone https://github.com/surfishs/dsh-prompt-enhance.git
cd dsh-prompt-enhance && npm install && npm run build
dsh plugin --profile <profile> add link:C:\path\to\dsh-prompt-enhance
卸载:
dsh plugin --profile <profile> remove @surfishs/dsh-prompt-enhance
使用
- 开始:在输入框写下草稿,点工具栏的增强按钮(或你设置的快捷键)。
- 查看结果:结果出现在输入框上方的停靠卡里,可以:
- 回填:写回输入框,卡片保持打开并显示「已替换」;
- 复制:复制结果;
- 重新生成:按当前输入再生成一版。
- 撤销:回填后点「撤销」恢复;关闭卡片后,输入框上方仍保留撤销条。
- 关闭:发送消息时卡片自动收起,按
Esc也可以关闭。
输入为空或只有附件时,按钮会变灰、不可点;超长或含命令或文件引用会被本地拒绝。输出达到 Token 上限时,会提示结果可能不完整。
/enhance <文本>:从斜杠面板改写任意文本,结果可复制,不进入模型历史。
配置
在 设置 → 提示词增强(或 插件面板 → dsh-prompt-enhance → 配置)编辑。全部字段:
| 字段 | 默认 | 说明 |
|---|---|---|
enabled | true | 总开关;关闭后隐藏输入框按钮,并停用命令与快捷键 |
provider + model | 空 | 从 DSH 已注册的 LLM provider 及模型中选择;模型可选「自定义…」手填 ID;未配置的 provider 置灰、需先在 DSH 模型服务中配置;留空表示跟随当前会话模型(不指定)。只填一个时保存后按跟随会话处理 |
temperature | 0.3 | 采样温度 0~1(步进 0.05),越低越忠实原文 |
reasoningEffort | off | 档位由当前 provider/model 的声明决定;DeepSeek 为 off / low / high / max。未声明档位的路由会自动省略该字段(即跟随提供方默认);inherit 表示不传该字段 |
maxOutputTokens | 8192 | 单次调用的输出 token 上限 |
maxInputChars | 12000 | 输入字符上限;超限拒绝,不截断 |
timeoutMs | 60000 | 单次调用端到端超时(毫秒) |
systemPrompt | 空 | 自定义系统提示词;留空使用内置增强策略 |
strategyMode | replace-default | replace-default 整体替换内置策略(仍保留最小输出契约);extend-default 把自定义策略追加在内置策略之后 |
shortcut | 空(禁用) | 触发快捷键;例 ctrl+alt+shift+e。须包含 ctrl/alt/meta 中至少一个修饰键,shift 可选 |
streaming | true | 边写边显示;仅影响显示节奏,最终结果不变 |
contextAware | true | 读取最近对话以消解指代;含敏感内容的会话建议关闭 |
contextMaxMessages | 8 | 参考的最近消息条数;0 表示不参考 |
contextMaxChars | 4000 | 历史片段的字符预算;0 表示不参考 |
maxConcurrent | 2 | 同时进行的增强上限;达到上限时新请求会提示稍后再试 |
rateLimitPerMinute | 10 | 每分钟增强次数上限(滑动窗口);超限时提示稍后再试 |
输入为空或只有附件时按钮灰掉,不发起请求;结果被截断时调高 maxOutputTokens。
安全
- 仅本机可访问:增强路由由本机 DSH 宿主提供,只接受回环地址和本地
Host/Origin,不接受外部来源。 - 不保存模型密钥:插件不读取或存储模型 API key,调用走宿主已有的 LLM 配置。
- 上下文按需发送:
contextAware开启时,最近几轮 user/assistant 文本和当前草稿会发给当前配置的模型服务商(默认最多 8 条消息、4000 字符);system、reasoning、工具结果和附件不会进入上下文。关闭后只发送草稿。 - 敏感会话:如果内容不能外发,请关闭
contextAware,或改用你信任的本地/私有模型服务。 - 本机档位缓存:插件会把「当前路由声明了哪些推理档位」的查询结果缓存到
$DSH_HOME/dsh-prompt-enhance/reasoning-efforts.json(未设置DSH_HOME时为~/.dsh/…)。文件内容只有 provider、model 与档位信息,不含 API key、草稿或对话内容;缓存没有过期时间,可在设置页点「重新获取档位」刷新,或直接删除该文件。
故障排查
| 现象 | 检查与处理 |
|---|---|
| 工具栏没有增强按钮 | 确认 enabled 为 true;安装后重启 DSH(桌面版或 dsh web);确认当前 profile 正确。 |
| 按钮是灰的 | 输入框为空或只有附件;输入文字后恢复。 |
| 结果不完整 | 查看截断提示,并在设置中调高 maxOutputTokens。 |
| 提示「尚未确定增强用的模型」 | 在设置中成对填写 provider / model;或先在当前会话发一条消息,让插件跟随会话模型。 |
| 鉴权失败 | 检查对应 provider 在 DSH 中的凭据/API Key 是否有效。 |
/enhance 的结果只显示第一行、点不开 | 这是 DSH 聊天界面的渲染限制,与本插件无关:截至 @deepseek-ai/dsh-client-ui-chat 0.2.2-rc.3,只有含换行的结果才提供展开,单行结果会被省略号截断且没有入口。要看全文,把同样的文本放进输入框、用增强按钮——按钮的结果卡会自动折行并可滚动。 |
开发
npm install
npm run typecheck
npm run lint
npm run format:check
npm test
npm run build
详见 CONTRIBUTING.md。
许可证
本项目采用 Apache-2.0,见 LICENSE。
致敬
感谢 rongxingda/dsh-prompt-enhance:本项目的代码与设计建立在该项目(Apache-2.0)的基础之上。
Comments
Loading…
Similar plugins
by rongxingda
Prompt enhancement plugin for the DeepSeek Harness web GUI: one-click rewrite of the composer draft into a structured prompt, with preview, fill-back, and undo.
★ 43
↓ 1.7k/wk
Apache-2.0
TypeScript
Nov 3, 2026
dsh plugin --profile web add dsh-prompt-enhanceby ruiyukirin
DSH 输入框一键提示词增强按钮 | One-click prompt enhancement for the DeepSeek Harness composer: rewrite the unsent draft into a clearer, more specific prompt, restore the original with one click. Ported from Tencent WorkBuddy's EnhancePrompt design; independent model call that never touches the session log.
★ 1
MIT
JavaScript
Oct 25, 2026
dsh plugin --profile web add dsh-prompt-optimization-masterby YiKangMo
DeepSeek Harness 的「增强提示词」按钮:一次辅助 LLM 调用把草稿改写成结构化提示词,支持加载态、失败重试与一键回退。Prompt enhancer button for DeepSeek Harness.
★ 0
MIT
JavaScript
Oct 22, 2026
dsh plugin --profile web add dsh-prompt-enhancerby zzy6-a
DSH 输入框旁的一键提示词增强:把口语化的一句话改写成目标明确、细节完整的任务说明,可一键撤销;五种改写风格、模型可跟随或固定,含 @引用/命令芯片时自动置灰保护。
★ 0
↓ 2.7k/wk
MIT
TypeScript
Sep 14, 2026
dsh plugin --profile web add dsh-prompt-enhanceby kee0012
DSH 提示词优化插件:输入框工具栏一键 ✨ 优化(直接写回可还原),风格/上下文/还原等设置收纳进 ▾ 弹出层。
★ 2
↓ 356/wk
MIT
JavaScript
Oct 13, 2026
dsh plugin --profile web add dsh-prompt-optimizerby master1Sun
DSH(DeepSeek Harness)Web 插件:在 composer 工具栏注入一个「提示词库」按钮,管理可复用的 prompt 片段,点击即可插入当前输入框。支持自动学习:输入复杂 prompt 文案时,插件会自动识别并保存到提示词库。
★ 17
↓ 538/wk
MIT
TypeScript
Nov 11, 2026
dsh plugin --profile web add @sunjuntao/dsh-prompt-library