提示词优化按钮x118111/prompt-optimizer

✨ Prompt Optimizer

一个用于 DeepSeek Harness (DSH) 的插件：在聊天输入框（发送按钮左侧）添加一个 ✨ 按钮，用大模型把当前草稿提示词改写得更清晰、更具体、更有效，并把优化结果写回输入框供确认后发送。支持静态配置（重启自动加载）与动态加载（快速试用）两种方式。

optimize button

功能特性

- 一键优化：在输入框工具行放置一个 28×28 圆形按钮（单色 ✨ 闪光星图标，与 Harness 浅色外观统一），点击即可用大模型改写当前提示词。
- 上下文感知：优化时自动携带最近 8 条对话（用户 + 助手），让模型先理解你的真实意图再改写，避免优化结果偏离需求；新会话没有上下文时，则直接基于提示词本身优化。
- 模型回退链：优先使用配置的默认模型（agentDefaultModel.currentSelection()）；若未配置或不可用，自动回退到第一个已注册 provider 的第一个可用模型（llm.listProviders() + llm.listModels()）。
- 可见的错误提示：失败原因不再只藏在 title 里——同时输出到浏览器控制台、显示在悬停提示与 aria-label 中（如 优化失败：no-model）。
- 写回确认：优化结果通过 inputActions.setDraft() 写回输入框，你可以检查、编辑后再发送，不会直接发出。
- 忙碌状态：优化过程中按钮切换为沙漏图标并禁用，防止重复点击。
- 零调试残留：console.error 仅用于真实错误上报，正常路径无任何日志噪音。

工作原理

插件分为两半：

| 文件 | 运行环境 | 职责 |
| --- | --- | --- |
| host.js / static/lib/index.js | DSH Node.js 进程（Host） | 解析模型路由（含回退）、构造优化提示、流式调用 llm.stream() 并返回结果 |
| client.js / static/lib/client.js | 浏览器页面（Client） | 在 conversation.input.right 插槽注册按钮，读取草稿与对话上下文，调用 Host，写回优化结果 |

- 动态版（根目录 host.js / client.js）：Host 注册 prompt.optimize RPC，Client 用 host.call 调用；
- 静态版（static/）：Host 注册 promptOptimizer Typert Remote 服务，Client 用 ctx.remote.promptOptimizer.optimize 调用。

安装方式

本插件支持两种加载方式，推荐静态配置（重启后自动加载）：

| 方式 | 持久性 | 适用场景 |
| --- | --- | --- |
| 静态配置（推荐） | ✅ 重启自动加载 | 长期使用、团队部署 |
| 动态加载（手动） | ❌ 重启丢失 | 快速试用、迭代调试 |

完整对比、优缺点、推荐建议、静态配置的完整示例与操作步骤见
docs/loading-methods.md。

方式一：静态配置（推荐，重启自动加载）

1. 将仓库 static/ 目录复制为 $DSH_HOME/profiles//plugins/prompt-optimizer/；
2. 在 profile package.json 的 dependencies 增加 "prompt-optimizer": "file:plugins/prompt-optimizer"；
3. 在 cordis.patch.yml 的 insert 列表增加 - id: prompt-optimizer / name: 'prompt-optimizer'；
4. pnpm install 后重启 DSH，✨ 按钮自动出现。

方式二：动态加载（手动，重启丢失）

在 DSH 会话中通过动态插件机制加载：

1. 将 host.js 的完整内容作为 code.host，client.js 的完整内容作为 code.client，调用 cordis_define 定义插件；
2. 调用 cordis_run 激活（首次运行需在界面中批准）；
3. 批准后按钮即出现在输入框工具行。

动态插件临时扩展当前 DSH 进程，定义不修改仓库源文件，进程重启后需重新加载。若希望常驻，请使用方式一。

使用方法

1. 在输入框输入你想优化的提示词，例如：帮我写个介绍；
2. 点击输入框工具行左侧（发送按钮旁）的 ✨ 按钮；
3. 等待模型改写（按钮变为沙漏，几秒完成）；
4. 优化结果自动填入输入框，检查、编辑后发送。

交互细节

| 状态 | 按钮表现 |
| --- | --- |
| 空闲 | ✨ 闪光星（浅灰单色） |
| 悬停 | 显示气泡提示"优化提示词" |
| 优化中 | ⏳ 沙漏，按钮禁用 |
| 失败 | 悬停/aria-label 显示"优化失败：\"，控制台同步输出 |

配置说明

本插件本身无需配置，但依赖 Host 侧的 LLM 服务：

- 默认模型（推荐）：在 Harness 设置中配置默认 provider/model，插件会通过 agentDefaultModel.currentSelection() 读取；
- 无默认模型时：插件自动使用 llm.listProviders() 返回的第一个 provider 及其第一个模型；
- 优化策略：系统提示词内置（保留原意、参考上下文、具体化、分步、明确格式、输出语言跟随原文）。如需调整优化风格，可修改 host.js 中的 system 数组后重新加载插件。

错误处理说明

插件通过 { ok: boolean, error?: string } 结构化返回结果，可能的错误码：

| error | 含义 | 建议 |
| --- | --- | --- |
| empty | 草稿为空 | 输入内容后再点击 |
| no-model | 无法解析任何可用模型 | 检查 Harness 是否配置了默认模型或注册了 LLM provider |
| llm-error / adapter 消息 | 模型调用失败（网络、鉴权等） | 查看控制台完整错误，检查模型凭据/网络 |
| max-tokens | 输出达到 token 上限 | 精简输入或调整 maxTokens |
| tool-calls | 模型意外请求调用工具 | 重试一次，一般偶发 |
| empty-result | 模型未产出文本 | 重试或调整输入 |
| 其他 | Host 内部异常 | 控制台有 [prompt-optimizer] 前缀的完整堆栈 |

所有失败都会：写入浏览器控制台（[prompt-optimizer] 前缀）、显示在按钮悬停提示和 aria-label 中——不会静默失败。

常见问题（FAQ）

Q：新建对话（无上下文）时点优化没反应？
A：新会话没有上下文时插件仍会正常工作——系统提示词明确“若没有上下文，直接基于提示词本身优化”。若按钮未出现，是因为 Harness 在 hero/无会话状态下本就不渲染工具行按钮（产品行为）；进入会话后按钮即出现。若点击后无效果，请打开浏览器控制台查看 [prompt-optimizer] 错误信息。

Q：优化结果为什么和我想要的不一致？
A：插件会携带最近 8 条对话作为上下文帮助模型理解意图。若在全新会话中优化，模型只能基于提示词本身推断；建议在优化前补充必要的背景信息，或先进行一两轮对话建立上下文。

Q：图标为什么是单色的？
A：为了与 Harness 浅色外观统一，图标使用内联 SVG + fill: currentColor（无彩色、无描边），颜色跟随按钮的浅灰文字色。形状为四角闪光星（sparkles），与原 ✨ 一致。

Q：点一次会消耗多少模型调用？
A：每次点击恰好一次 llm.stream() 调用。优化结果写回输入框后由你决定是否发送，不会自动重复请求。

Q：会生成两遍提示词吗？
A：不会。Host 端只累加 text-delta 增量（block-end 携带的是完整块，若同时累加会造成重复），与 DSH 官方 BlockAssembler 语义一致。

License

MIT