Prompt Enhancer for Hermes

【Hermes 桌面端插件】输入框「增强提示词」按钮——一句话草稿改写为结构化完整提示词。en / 简中 / 繁體。

prompt-enhancer

30 秒看懂

输入框右下角（模型选择器左侧）多了一个 ✨ 按钮：随手打一句模糊的话（「帮我写个周报」），点一下，草稿被替换为任务/范围/约束/输出形式一次到位的结构化提示词。不满意再点一下（图标变成回转箭头 ↩）恢复原文。

增强结果只改写、不回答：不替你执行任务，只把意图整理成 AI 更好执行的提示词。单次无状态调用，不进会话历史，不影响 prompt cache。语言跟随输入（英文输入 → 英文输出，混排保持混排）。

想用固定的模型做增强：在 Hermes 的 config.yaml 里给增强任务单独指定 provider / model（写法见下方「边界与说明」）；不配则用主模型。

安装

方式一：官方插件目录（推荐，已通过官方审查收录）

hermes plugins install prompt-enhancer

装完重启 Hermes 桌面端（⌘Q 后重新打开）即可。升级：

hermes plugins update prompt-enhancer

目录条目钉在某个已评审的 commit 上——作者仓库的后续提交不会自动进目录，实际装到的版本以插件卡片上的版本号为准。

方式二：从 Git 安装（装仓库最新提交）

对 Hermes 说：

从 Git 安装这个桌面插件：https://github.com/Heybinshao/prompt-enhancer

也可以走桌面端「技能与工具 → 插件」页面上方的「从 Git 安装」按钮。这条路径装的是仓库当前提交（没有经过目录评审）；升级方式：重做一遍上述安装，弹窗里勾「强制重装」。

方式三：手动放置

下载本仓库的 desktop/plugin.js
放到 ~/.hermes/desktop-plugins/prompt-enhancer/plugin.js（文件夹名必须叫 prompt-enhancer）
重启 Hermes 桌面端（⌘Q 后重新打开）

⚠️ 插件入口在仓库的 desktop/ 子目录里，别把整个仓库 clone 进 ~/.hermes/desktop-plugins/——多出一层目录，宿主就找不到入口文件了。

界面预览

按钮位于输入框控件行最左（模型选择器左侧）：

空闲态	增强后（可恢复）
空心火花 ✨	回转箭头 ↩，点击恢复原文

使用

操作	效果
输入草稿后点 ✨	草稿被增强后的提示词替换
增强后再点 ✨（图标变为回转箭头）	恢复原文
增强等待期继续编辑	保护生效：不覆盖你的手改，弹提示
空输入框点 ✨	提示无可增强内容

模型路由：请求不带 session_id，落在主模型（不随会话变）；要给增强单独指定模型见下方 auxiliary.prompt_enhancement
多行布局：草稿换行后输入框进入堆叠布局（官方行为）；按钮跟随发送按钮簇一起靠右（官方控件行布局问题已在 Hermes v0.21.7 修复）
发送后：按钮自动回到空闲态（增强结果已随消息发出）

卸载

「技能与工具 → 插件」里找到 Prompt Enhancer → 关闭开关；或直接删除 ~/.hermes/desktop-plugins/prompt-enhancer/ 文件夹后重启 Hermes。

反馈

装上了吗？用着如何？遇到报错（哪怕看不懂的）欢迎提 issue——报错时附上 ~/.hermes/logs/desktop.log 里 [prompt-enhancer] 开头的行即可，不用截图也不用复现步骤。也可以在微信公众号「宝藏彬少」后台直接留言。

边界与说明

文件/引用 chip 与文本混合的草稿：引用标记原样保留，只增强文本部分
增强结果保留官方渲染：草稿里已有的 @引用 和 /命令 pill 在增强后原样保留（图标、配色与官方一致）；模型新引入的命令词以纯文本发送，消息气泡里仍会正常渲染
草稿超过 8000 字符暂不支持
增强耗时取决于模型（通常数秒到 2 分钟），转圈即进行中；请求超时上限 3 分钟
语音输入纠错：草稿里的同音/近音错别字、口误漏字会被自动识别修正（如「全休」→「全修」），不确定是否错误时保持原样
多会话状态隔离：每个会话输入框的增强状态独立（转圈/恢复只作用于自己，取消不作废其他会话的请求）
增强中可取消：点 ✨ 后按钮变为转圈动画，转圈期间再点一次即可取消（立即拿回输入框，迟到的增强结果自动丢弃）；取消/完成后自动恢复
限流重试可见：触发 429 自动重试时按钮提示变为「限流重试中…」，不再是静默等待
服务端 429 限流自动重试：网关上游渠道偶发限流（增强失败：… 429）时插件自动退避重试（3s / 5s 各一次）；若重试后仍失败，稍等几秒再点一次即可——限流是网关侧的瞬时状态，与插件和账号无关
固定增强用模型：在 Hermes 的 config.yaml 给增强任务单独配 provider / model（不配则用主模型）：
```
auxiliary:
  prompt_enhancement:
    provider: <你的 provider 名>
    model: <模型名>
    timeout: 120
```
⌘Z 撤销的是你的打字历史，撤销不了增强替换——恢复原文请用按钮
需要网关在线（增强走 llm.oneshot 网关通道）

工作原理

按钮注入官方 composer.actions 贡献区；草稿读写全部走官方 host.composer 接口（getDraft / setDraft，按会话寻址，@引用 与 /命令 由应用自己水化成 chip；SDK 答不上来就提示用户，绝不伸手进应用 DOM）→ 调用 llm.oneshot 网关 RPC（无状态、不污染 prompt cache；请求裸发不带 session_id，落主模型）。写回前做快照比对，草稿在等待期被手改则放弃应用——绝不覆盖用户的字。

v1.6.0 起为纯 SDK 实现，配合版本闸门 requires_hermes: ">=0.21.5"：低于 0.21.5 的 Hermes 不会安装本版本（官方目录 PR #121246 审查要求，删除了旧版桌面端的 DOM 读写兼容层）。

关于作者

彬少 —— 一个什么都折腾一下的人：装系统 · 玩AI · 搭知识库 · 做设计。这个仓库里的东西都是我自己的卡点长出来的，日常在用，做完就开源。

微信公众号 「宝藏彬少」：折腾，是为了更好用。欢迎关注交流。