前言¶
在 DeepSeek Harness(DSH)里和模型对话,常见做法是先在输入框里打一句短草稿,再指望模型自己补全目标、输出格式和边界。草稿越短,模型越容易猜错,往往要多问一轮。社区插件 dsh-prompt-rewriter(维护者 huaguoxingkong,分类:模型推理)在会话输入框旁增加一个入口:用当前会话(或可单独指定的)模型,把草稿原地改写成更完整的任务说明,只替换输入框内容,不发送、不运行。不满意可以用 Ctrl+Z 或按钮回退。项目为非官方社区作品,与 DeepSeek 无隶属或授权关系;当前 npm 版本为 1.6.3,MIT 许可(内嵌品牌素材等归属见仓库 NOTICE.md)。
这是什么¶
dsh-prompt-rewriter 是 DSH 的前端平台插件:在 conversation.input.right 渲染鲸鱼尾巴按钮,通过 Host 侧 POST /api/prompt-enhance 调用 ctx.llm 完成改写,Client 侧用 inputActions.insertText 把结果写回输入框。它解决的是「半成品提示词缺目标、格式、边界」的问题——例如 README 中的对比:从「帮我写个爬虫抓豆瓣电影」补成带 Top250 字段、CSV 输出、robots 与请求间隔等约束的完整说明;补全内容仍可手动编辑。
目录与源码:
- 社区目录:https://www.skillhub.cn/plugins/huaguoxingkong/dsh-prompt-rewriter
- GitHub:https://github.com/huaguoxingkong/dsh-prompt-rewriter
核心功能¶
一键增强与回退¶
- 在输入框写下任意长度草稿;输入框为空时按钮不显示。
- 点击模型名左侧的鲸鱼尾巴图标(或开启快捷键后使用键盘,见下文)。
- 约一秒多后(取决于所选模型),草稿被替换为改写后的提示词。
- 改写中再点一次可取消;完成后按钮变为回退箭头,或
Ctrl+Z恢复原文。失败时显示红色重试与原因。
增强是一次真实的模型调用;中途可切换会话,任务会继续跑完(1.0.x 时代切换会中断,当前行为已不同)。两个会话可同时各跑一个增强。
上下文与图片边界¶
按钮右下角小圆点表示「参考之前的对话」是否生效:
- 无圆点:仅根据当前草稿改写。
- 有圆点:还会读取前面聊过的内容,改写更贴会话意图;可在设置中关闭以省 token、加快速度。
只读输入框里当前的图片;历史消息中的图片 deliberately 不参与。设置里可单独打开「参考输入框里的图片」。
设置项(仅影响本按钮)¶
路径:设置 → 提示词增强。
| 选项 | 默认 | 说明 |
|---|---|---|
| 用哪个模型改写 | 关 | 关则跟随当前对话模型;开则固定下拉所选模型 |
| 参考之前的对话 | 开 | 读前文,更准但更耗 token |
| 参考输入框里的图片 | 关 | 与「只读输入框图、不读历史图」一致 |
| 快捷键 | 关 | 桌面 Ctrl+E(macOS Cmd+E);浏览器 Ctrl+Alt+E(macOS Ctrl+Alt+E) |
可选固定增强模型,不影响正常发送消息所用的模型。
按钮状态¶
空闲(可点)→ 改写中(螺旋动画,再点取消)→ 完成(回退箭头)→ 失败(重试与原因)。
安装与启用¶
需要已安装 DeepSeek Harness,Node.js >= 22。README 明确:装完后必须重启 Harness,本插件没有 HMR。
从 npm(推荐)¶
按你实际使用的 profile 二选一:
dsh plugin --profile web add dsh-prompt-rewriter # Web 版
dsh plugin --profile desktop add dsh-prompt-rewriter # 桌面版
从 GitHub 源码¶
dsh plugin --profile web add github:huaguoxingkong/dsh-prompt-rewriter
源码安装会执行构建,首次可能要求授权;仅对信任的包授予。
从 Release zip¶
到 Releases 下载 zip,解压后:
npm install && dsh plugin --profile web add .
典型用法¶
下面步骤与 README「怎么用」一致,可在本地复现:
- 打开 DSH 会话,在输入框输入短句草稿(例如一句需求描述)。
- 确认输入框非空,点击模型名左侧鲸鱼尾巴图标。
- 等待改写完成,检查输入框中的完整提示词,按需微调后再自行发送。
- 若结果不满意:
Ctrl+Z,或点回退箭头;改写过程中想放弃可再点一次按钮,草稿保持原样。
若觉得等待偏长,可将会话模型换成响应更稳定的型号,或在「用哪个模型改写」中固定专用模型。快捷键需先在设置中打开开关,并与内置快捷键无冲突。
适用场景与注意¶
适合:经常在 DSH 里写提示词、希望发送前一次性补全目标/格式/边界,且希望结果留在输入框里可编辑、可撤销的开发者与用户。
运维与权限:插件以当前 DSH 进程权限运行,Host 通过 ctx.connection.fetch 继承 Harness 鉴权。安装前建议阅读仓库源码与 LICENSE、NOTICE;从 GitHub 或 npm 安装即表示接受其分发方式。
常见问题(摘自 README):
- 点了没反应:输入框为空,或开启了固定模型但未选择模型;快捷键需确认开关与冲突提示。
- 「当前模型尚未配置可用的凭据」:为该模型配置 key,或换模型 / 在设置中固定可用模型。
- 不会修改已发送的消息,只改草稿。
profile 中可选 config 字段(如 maxDraftChars、timeoutMs、historyTokenBudget 等)由设置页或运维上限控制,详见 README「配置」一节。
已知限制:历史消息图片不参与;改写完成前为非流式替换;模型目录依赖 Host 的 remote.session.modelCatalog,不可用时下拉会提示读取失败。
结尾¶
dsh-prompt-rewriter 把「提示词增强」收进输入框旁一步操作:改写、不发送、可撤销,并可选择是否读前文与输入框图片。DSH 生态以插件扩展能力为主;社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系。