wmengxiang/dsh-prompt-optimizer

dsh-prompt-optimizer

一个 DeepSeek Harness（DSH）Web 插件：在输入框工具行新增一个 ✨ 图标按钮，点击后调用当前激活模型，把输入框里的提示词优化得更清晰、更具体，并自动回填。

核心功能封装为可复用、可持久化的 DSH Web 插件包，随组合（composition）挂载后即可随部署自动加载。

功能特性

• 一键优化提示词：点击 ✨ 按钮，将当前草稿改写为更适合 AI 编程助手的高质量提示词；
• 保留意图与语言：只做清晰化、具体化改写，不改变原任务意图与语言；
• 图标按钮 + 悬停提示：界面不显示说明文字，仅在鼠标悬停时显示「优化提示词」；
• 进度反馈：优化过程中按钮切换为旋转加载圈，并在按钮底部显示滑动进度条；
• 空内容保护：输入框为空时按钮自动置灰，避免误触发；
• 流式生成：Host 端通过 ctx.llm.stream 流式读取模型输出，再统一回填。

目录结构

dsh-prompt-optimizer/
├── package.json        # 包元信息 + dsh.bundle / dsh.client 清单
├── cordis.patch.yml    # 组合补丁：向组合挂载本插件
├── lib/
│   ├── index.js        # Host 半：注册 /api/prompt-optimizer 数据路由
│   └── client.js       # Client 半：__ModuleLoader__ 图标按钮 UI
├── LICENSE             # MIT
└── README.md

工作原理

• Host 半（lib/index.js）：导出 Cordis 插件，inject 依赖 webServer、llm、agentDefaultModel，注册精确路由 POST /api/prompt-optimizer。收到 { text } 后读取当前默认模型（agentDefaultModel.currentSelection()），组装优化提示词，通过 ctx.llm.stream 流式生成并返回 { optimized }。
• Client 半（lib/client.js）：通过 window.__ModuleLoader__.load 注册，apply 时向 conversation.input.left 槽位注入图标按钮，读取草稿（props.input.draft）、调用接口、再写回（props.inputActions.setDraft）。

安装步骤

方式一：本地路径安装（已验证，无需网络 / SSH）

dsh plugin --profile web add "file:/绝对路径/to/dsh-prompt-optimizer"

dsh plugin add 会自动完成两步：把包写入 profile 的 dependencies，并注册进 dsh.profile.bundles。重启对应 profile 的 Web 界面后，插件即随组合自动加载，无需每次手动激活。

方式二：从 GitHub 安装

dsh plugin --profile web add "github:<owner>/dsh-prompt-optimizer#main"

⚠️ 注意：pnpm 对 github: 源走 SSH（git+ssh://git@github.com/...），要求本机已配置 GitHub SSH 密钥。没有 SSH 密钥时会报 Permission denied (publickey)，此时请改用方式一（本地路径）。也可以先把仓库发布到 npm 再用 dsh plugin --profile web add dsh-prompt-optimizer 安装。

方式三：手动接入组合

在目标 profile 的 package.json 中把本包加入 dependencies 与 dsh.profile.bundles，然后运行 dsh plugin --profile web install 并重启。

方式四：动态插件（临时试用，不持久化）

仅用于临时验证、重启即失效：

1. 打开 DSH Web 的 Cordis 插件开发能力；
2. 分别把 lib/index.js（Host）与 lib/client.js（Client）的 apply 逻辑封装为动态 Package；
3. 运行并批准。

使用说明

1. 在输入框输入一段提示词；
2. 点击输入框工具行左侧的 ✨ 图标按钮；
3. 按钮进入加载状态（旋转图标 + 底部进度条）；
4. 完成后，优化后的提示词自动替换输入框内容；
5. 将鼠标悬停在按钮上可查看说明文字。

常见问题 (FAQ)