prompt-optimizer-plugin

✨ 提示词优化助手（Prompt Optimizer）for DeepSeek Harness

最新版本 v0.13.0 —— 安装的版本可在 设置 → 提示词优化 的标题旁查看

一款为 DeepSeek Harness（DSH）对话界面自制的小插件：在输入框旁边加一个「✨ 优化」按钮，一键把你的草稿变得更清楚、更有条理。

它能帮你做什么？

• 先读上下文，再改写：点 ✨ 时先读当前会话最近的对话正文（以及会话主题、工作目录），用来把草稿里“这个 / 它 / 继续”指代的对象写清楚，所以结果贴合你正在做的事，而不是只对着一句孤立的话做扩写。
• 点一次就改写：把输入框里的草稿改写成更清晰、更具体的提示词；草稿里没交代清楚的要素（要什么、基于什么、输出成什么样、有什么限制），插件会替你补全。
• 改完直接用：输入框自动变成优化后的版本，直接点发送就行。
• 可撤销、可对照：点「↩ 撤销」还原原文；优化前的原文会浮在输入框上方作参考，发送时不会带出去。
• 不打扰对话：优化只是单独问一次模型，不会把过程塞进你和 AI 的对话里。
• 不需要设置：默认参数已经调好，装完即用；想关就在设置里一键停用，不用重启。

安装前，先认识 3 个词

• DeepSeek Harness（简称 DSH）：运行 AI 对话的程序（网页版界面），你平时聊天用的就是它。
• 终端（PowerShell）：一个可以输入命令的小黑窗口。Windows 下：点「开始」→ 搜索「PowerShell」→ 打开蓝色图标的应用，后面的命令都粘贴进这个窗口并按「回车」执行。
• pnpm：一个帮你下载安装小工具的小帮手，我们马上会装上它。

安装步骤

前提：你的电脑已经装好 DSH 并能正常聊天。下面所有命令都在「终端」里执行。

第 1 步：安装 pnpm（只需一次）

npm install -g pnpm

如果提示“npm 不是内部或外部命令”，说明还没装 Node.js——请先让帮你装机的人装好 Node.js 再回来。

第 2 步：把插件安装到 DSH

dsh plugin --profile web add github:naitoupi/prompt-optimizer-plugin

如果你是自己下载了源码（比如解压了 GitHub 的压缩包），改成装本地文件夹——把路径换成 package.json 所在文件夹的完整路径：

dsh plugin --profile web add C:\Users\你的用户名\Desktop\prompt-optimizer-plugin

看到类似 + prompt-optimizer-plugin link:... 和 Done in ... 就是成功了。这个插件没有构建步骤，安装时不会运行任何代码。

第 3 步：重启 DSH

先关掉正在运行的 DSH 窗口，再重新启动：

dsh web

浏览器会自动打开界面（如果没自动打开，手动访问 http://127.0.0.1:3080）。

快速上手

1. 新建一个对话；
2. 在输入框里写下你的草稿（比如“帮我写个二分查找”）；
3. 点输入框旁边的 ✨ 优化 按钮；
4. 输入框自动变成优化后的版本，上方出现「📋 原文」参考区；
5. 满意就直接点发送；不满意点 ↩ 撤销 恢复原文，或改一改再优化一次。

如果模型判断你的草稿已经足够清晰，它会保持原文不变并提示「无需优化」；只差一两个标点时同样不会改动，而是提示「本次改动极小」。真正有改进空间时，输入框才会被替换——所以撤销栈里不会有看不出区别的改动。

它会读你的上下文（v0.13.0 新增）

点 ✨ 时，插件会先把当前会话的以下内容交给模型，作为改写的背景：

刻意不读——实测这些在真实会话里占绝大多数，只会带来噪声和费用：

• ❌ 工具调用与工具结果：实测同一会话里 133 条工具结果 vs 仅 5 条你的正文；
• ❌ 模型的思考过程（reasoning）；
• ❌ DSH 注入的 <system-reminder> 提醒块（技能清单等）——它不是你说的话；
• ❌ 图片与附件。

边界：上下文只用来消解指代、补足背景，不会被照抄进提示词，也不会因此新增你没提过的要求； 草稿与上下文冲突时一律以草稿为准。读不到上下文时自动退回“只改草稿”（例如新会话还没聊过）， 不报错、不空转。

用量显示在哪里：

• 输入框工具行只留一句短提示（已优化并替换输入框 · 上下文 12 条），6 秒后淡出；
• 完整用量常驻在输入框上方的「📋 原文」参考区：🧠 已参考上下文：12 条历史（共 3874 字符，较早的 3 条未带入）。 它会一直显示到草稿被清空、发送或点「↩ 撤销」为止 —— 不会“还没看清就消失” （v0.13.0 曾把长句放在窄窄的工具行里、3.2 秒就淡出，v0.13.1 改为常驻参考区）。

代价：因为要多发一段历史给模型，单次优化会比以前慢一点、费一点额度；把「上下文长度上限」调小可以省，关掉即完全退回旧行为。

隐私：读到的内容只发给你当前正在用的同一个模型（与聊天同一条链路），不经过任何第三方。

设置

点右上角 设置，左侧导航最后一项就是 提示词优化（和「通用设置」「模型」「插件」并列）：

• 停用 / 启用插件：一键开关，立即生效，不用重启；
• 生成参数：思考强度（off / low / high / max）、最大输出长度、温度；会话上下文开关与长度上限（默认开、4000 字符）；
• 优化指令：查看和修改模型收到的规则。

生成参数与上下文这两组都不需要动。默认值（思考强度 off / 最大输出 1500 / 温度 0.1 / 参考上下文开、上限 4000 字符）是按“效果最明显、速度最快、同一句重复优化结果一致”实测调过的；改坏了就点各区的「恢复默认」/「恢复默认指令」回到推荐值。

常见问题

Q1：输入框旁边没有 ✨ 按钮？

先重启一次 DSH（dsh web）；再进 设置 → 提示词优化，确认不是「已停用」（是的话点「启用插件」）；最后新建一个对话试试（已经打开的旧对话可能没刷新）。

Q2：点优化后出现红字提示？

红字本身会写明具体原因，照着做即可。多数情况是草稿里没有明确要求（比如只是一句陈述），加上“请帮我…”“改写成…”之类的说法再试一次。

Q3：想彻底卸载？

在终端执行下面这行，然后重启 DSH：

dsh plugin --profile web remove prompt-optimizer-plugin

然后重启 dsh web。

小提示

• 所有设置（开关、参数、自定义指令）都存在你本机：~/.dsh/prompt-optimizer-state.json，删除它就等于恢复初始状态。
• 界面语言自动跟随 DSH（中文界面显示中文，英文界面显示英文），内置的默认优化指令也是双语的。
• 本插件是开源的个人作品，许可：MIT（Copyright © 2026 naitoupi）。欢迎在自己机器上自由安装、修改后再分发。