在 DSH（DeepSeek Harness）开发流程中，输入框是交互的核心。开发者输入的原始草稿往往口语化、含糊不清，或者包含大量指代，直接发给 Agent 执行效果较差。dsh-improve-prompt 插件通过本地 LLM 能力，将输入框草稿改写为结构清晰、指令明确的提示词，并确保不丢失关键信息。
核心功能¶
保真闸与长度闸
插件内置两层安全机制。保真闸会提取草稿中的硬事实（如文件路径、URL、代码块、版本号），验证改写后是否保留。若缺失，会触发修复调用或回灌原始细节。长度闸限制改写后的文本长度，标准档不超过输入的 2.5 倍，且不低于 200 字符。若超预算，插件会拒绝改写并保留原文。
一键改写与撤回
点击输入框工具栏的 ✦ 按钮，插件会在 1-3 秒内将草稿直接替换为增强版本。替换后 8 秒内可点击「撤回」恢复原文。一旦手动编辑输入框，撤回条自动消失，不会覆盖用户的新输入。
质量凭证与档位
改写完成后，输入框上方会显示状态条，包含「保真 X/5」、「长度倍率」、「耗时」等信息。插件提供轻（去废话、≤1.2x）和标准（结构化、≤2.5x）两档位，支持一键切换，档位记忆在本地。
智能上下文与斜杠命令
对于含指代（如「那个」、「it」）或短草稿，插件会自动携带最近 N 轮对话上下文。对于斜杠命令（如 /bugfix），插件会保留命令前缀，仅改写正文内容。
失败即原文
在模型不可用、超时或网络失败时，插件绝不改动输入框内容，仅返回提示信息，保证用户输入不被破坏。
零配置与接口
插件无需 API Key，直接调用 DSH 自带模型。同时提供本地 HTTP 接口 POST /dsh-improve-prompt/api/improve，供脚本或工具集成。
安装与启用¶
安装
确保 dsh 版本不低于 0.1.1-rc.2。在终端执行以下命令安装插件：
dsh plugin --profile web add dsh-improve-prompt
启用与卸载
安装后重启 dsh web，输入框工具栏（发送键左侧）会出现 ✦ 按钮。点击按钮悬停可查看当前档位。
dsh plugin --profile web remove dsh-improve-prompt # 卸载
典型用法¶
1. 口语化改写
输入口语化需求：
就是那个 帮我把 src/host/config.ts 里的 maxRatioFor 改成 2.5 呗
点击 ✦ 后，草稿被替换为：
把src/host/config.ts里的maxRatioFor改成2.5
2. 斜杠命令支持
输入 /bugfix ISS-202607-00090605A 用户反馈填充后密码框被清空。
点击 ✦ 后，前缀 /bugfix ... 被保留，正文被改写为排查步骤清晰的版本。
3. 脚本集成
通过本地 HTTP 接口调用：
curl -X POST http://127.0.0.1:3080/dsh-improve-prompt/api/improve \
-H 'content-type: application/json' \
-d '{"text":"把那个接口加上限流","sessionId":"sess-1","mode":"standard"}'
4. 失败处理
若未配置默认模型，点击 ✦ 时会报错「未找到可用模型」，原文保持不变。
适用场景与注意¶
适用场景
* 需要精准保留文件路径、类名、版本号等硬事实的改动请求。
* 口语化、英文长句或中英混合草稿的规范化。
* 续写式草稿或报错日志的直接贴入。
* 希望快速验证 Prompt 改写效果，并随时撤回的场景。
注意事项
* 插件运行在当前 DSH 进程权限下，安装前建议检查源码。
* 失败时插件不会修改输入框内容，适合对输入安全要求高的场景。
* 仅支持 Web Profile，需在 dsh web 环境中使用。
短结尾¶
dsh-improve-prompt 专注于解决输入框草稿质量参差不齐的问题。通过保真闸、长度闸和一键撤回机制，它能在几秒钟内提供高质量的 Prompt 改写，同时保证用户输入的绝对安全。如需定制行为，可覆盖 prompts/*.md 模板文件。
GitHub 仓库：https://github.com/hoyyang/dsh-improve-prompt
