DeepSeek Harness 插件：dsh-prompt-optimizer

DeepSeek Harness（DSH）采用插件化架构。开发者经常在输入框中编写 prompt，但很难确保其结构清晰。dsh-prompt-optimizer 插件通过一键优化解决了这个问题。

插件简介¶

这是一个为 DSH composer 设计的插件。输入草稿并按 ✨（或 Alt+O）即可重写为更清晰、结构化的 prompt。该插件默认零配置，直接复用当前会话的模型服务，也支持接入任意 OpenAI 兼容的接口。

插件由 winditer 维护，采用 MIT 许可证。

安装¶

推荐通过 GitHub 仓库身份安装，以避免 npm 名字冲突导致市场无法识别插件来源：

dsh plugin --profile desktop add github:winditer/dsh-prompt-optimizer

安装后，请完全重启 DSH（退出并重新打开），composer 右侧才会出现 ✨ 按钮。

核心功能¶

• 一键优化：在 composer 中输入草稿后，点击右侧的 ✨ 按钮，或选中输入框后按 Alt+O。插件会立即在输入框上方显示优化预览卡片。
• 真流式预览：利用 harness 的 webServer 服务进行 SSE 传输。模型先流式输出“推理过程”（通常为次要颜色），随后流式输出润色后的 prompt。你可以实时看到模型思考的过程。
• 零配置默认：默认情况下，插件复用当前会话（session）或 agent 的默认模型配置（agentDefaultModel + llm 服务），无需额外填写 API Key。
• 自定义端点模式：取消勾选“使用当前会话模型”后，可填入任意 OpenAI 兼容的 /chat/completions 接口地址、API Key 和模型名。
• 完成操作行：预览完成后，卡片底部提供操作按钮：替换草稿（将结果写回 composer）、复制、重新优化 或 放弃。
• 双语 UI：界面语言跟随 DSH 的当前语言（中文/English），无需刷新页面。
• 本地配置：设置持久化保存在 ~/.dsh/prompt-optimizer-config.json，通过本地 RPC 通道与主机通信，独立于主机的设置注册表。
• 深色模式支持：所有颜色跟随 DSH 主题变量，在深色夜间模式下使用品牌蓝和白色文本。
• 本地凭证安全：仅在自定义端点模式下，API Key 存储在本地配置文件中，且仅发送至你配置的接口地址。

使用流程¶

1. 在 DSH 的 composer 中输入一段原始 prompt。
2. 点击右侧的 ✨（或按 Alt+O）。
3. 预览卡片出现在输入框上方。你会先看到模型输出的推理文本，随后看到优化后的 prompt 逐 token 流式显示。
4. 查看结果：
   - 点击 替换草稿，将润色后的内容直接写入 composer。
   - 点击 复制，将内容复制到剪贴板。
   - 点击 重新优化，基于原草稿再次运行。
   - 点击 放弃，关闭预览卡片。

配置说明¶

进入 DSH 的 设置 → 通用设置 → Prompt 优化，可以看到以下配置项：

配置文件保存在 ~/.dsh/prompt-optimizer-config.json。卸载插件时，该文件也会被清理。

架构与安全¶

插件采用 Host-Client 分离设计：

• Host Half：位于 lib/index.js。通过 loopback RPC 通道（/dsh-prompt-optimizer）持久化配置，并通过 webServer 注册 HTTP API（/dsh-prompt-optimizer/api）。它负责处理流式请求。
• Client Half：位于 dist/client.js。通过 fetch 调用 Host API，渲染 UI（按钮、预览卡片、设置行）。

安全注意事项：
- 默认路由不发送凭证，它直接复用 harness 已配置的 provider。
- 自定义模式的 API Key 仅保存在本地，不会上传到其他服务器。
- 优化结果仅展示在预览卡片中。只有点击 替换草稿 后，文本才会写入当前会话。

生态与资源¶

插件目录：dsh-prompt-optimizer

源码仓库：github.com/winditer/dsh-prompt-optimizer