dsh-enhance-prompt

给 DSH（DeepSeek Harness） 输入框加一个 ✨ 按钮：把随手写的草稿，一键改写成结构清晰、约束明确的提示词。

DSH Desktop / dsh web 的插件，dsh.bundle 形态，可直接用 dsh plugin add 或插件市场安装。

兼容 DSH >=0.2.0-rc.2 <0.3.0。

---

它解决什么问题

你写下的往往不是提示词，而是一句念头——「帮我写个脚本批量重命名文件」「这个报错怎么修」。模型拿到这句话，只能自己猜你要什么系统、什么规则、什么边界，猜错就得来回好几轮。

这个插件在发送之前插一步：读你输入框里的草稿，交给 LLM 做一次单轮改写，把意图展开成可执行的约束，然后写回输入框。你可以先看一眼，不满意就改，满意再发。

它只改写，不执行——不回答问题、不调用工具、不建会话、不写历史。改写发生在你自己的模型路由上，用的是 DSH 原生的 ctx.llm.stream()。

效果

输入（13 字）：

帮我写个脚本批量重命名文件

点击 ✨ 后（203 字）：

请帮我写一个用于批量重命名文件的脚本。为准确实现，请先向我确认：使用的操作系统和可运行的脚本环境；
目标文件夹路径及是否处理子文件夹；要匹配的文件类型或文件名规则；具体重命名规则（如查找替换、
添加前后缀、顺序编号、日期、大小写转换等）；是否保留扩展名；重名冲突如何处理；是否需要预览、
确认、备份或撤销。请根据确认结果提供完整脚本、使用说明和示例，并默认先执行预览模式，列出将要
改名的文件及前后名称，避免误改。

特性

• 工具栏一键触发：纯图标按钮（28×28），挂在输入框工具栏发送按钮左侧，不占额外空间
• 单轮、无工具：走 ctx.llm.stream()，tools 天然为空，安全边界由 API 本身保证
• 不污染历史：不建会话、不写对话记录，只是一次文本改写
• 跟随语言：中文进中文出，英文进英文出，不做语言标签
• 写回走官方入口：优先用 composer 的 inputActions.setDraft（Lexical 编辑器）；拿不到时退回编辑命令，再失败复制到剪贴板，不直接改 contenteditable
• 不覆盖新输入：请求期间草稿有改动时只复制结果，不覆盖你刚输入的内容或文件引用
• 消耗可见：右键按钮看累计输入/输出 token、调用次数、失败次数
• 模型可配：默认跟随当前会话的模型选择，也可以在配置里写死

安装

通过插件市场

DSH 里打开 设置 → 插件市场，搜索 dsh-enhance-prompt，点安装。

命令行安装（直接从 GitHub）

市场收录之前，或者想跟 main 分支上的最新代码，可以直接用 GitHub 源安装：

dsh plugin --profile web add github:adcx222/dsh-enhance-prompt

手动安装

1. 把仓库克隆或解压到 %APPDATA%\dsh-desktop\harness\plugins\dsh-enhance-prompt

2. 在 profiles/web/package.json 的 dependencies 里加：

   "dsh-enhance-prompt": "link:../../plugins/dsh-enhance-prompt"
   

3. 在同一个文件的 dsh.profile.bundles 数组里加 "dsh-enhance-prompt"

4. 运行 harness\.desktop-bin\pnpm.cmd install

5. 重启 DSH

卸载反向操作：从 dsh.profile.bundles 和 dependencies 里移除，跑一次 pnpm install，重启，删目录。

配置

配置写在 cordis.patch.yml 的 config 下：

- insert:
    - id: enhance-prompt
      name: 'dsh-enhance-prompt'
      config:
        provider: ''
        model: ''
        maxTokens: 8192
        timeoutMs: 60000
        maxInputChars: 5000

字段	默认	说明
provider	空	模型 provider；留空则跟随当前会话的模型选择
model	空	模型名；留空同上
maxTokens	8192	单次改写输出上限；推理型模型的思考过程也占输出额度，太小会拿不到正文
timeoutMs	60000	请求超时
maxInputChars	5000	草稿长度上限，超过直接拒绝，不浪费一次调用

provider / model 的解析顺序是：请求体 → 当前会话选择 → 配置。两者都解析不出来时接口返回 code: no_model，不会带着空模型名去请求。

工作原理

浏览器端 lib/client.js                宿主端 lib/index.js
─────────────────────                ────────────────────
MutationObserver 找 composer
   ↓
在工具栏插入 ✨ 按钮
   ↓  点击
读草稿（composer projection，含 @ 文件引用）
   ↓
POST /enhance-prompt  ───────────────▶  校验长度 / 解析 provider+model
{ text }                                    ↓
                                       ctx.llm.stream() 单轮，无工具
                                            ↓
                                       拼装 text block，去掉包裹引号
                                            ↓
                                       记 token 账 → stats.json
   ◀──────────────────────────────────  { success, text, tokens }
   ↓
inputActions.setDraft 写回（Lexical）

宿主端注册的是 webServer 上的精确路由 POST /enhance-prompt，同时 GET 返回累计统计。路由通过 ctx.effect 跟随插件生命周期注册/释放，live reload 时会等旧路由释放后再重试注册，避免 duplicate exact route 把接口卡死。

提示词设计

改写用的系统提示词刻意做窄：

- Do not answer the request; only rewrite it.
- Do not invent technologies, tools, or facts.
- Reply in the input's language, with no labels.
- Chinese output: 200-350 characters. English: 300-450 characters.
- Output only the rewritten prompt.

窄是有原因的：一旦允许它「顺手回答」，它就会开始编造你没提过的技术栈和事实，改写结果反而比原稿更偏。字数区间是为了让输出足够具体、又不至于膨胀成一篇需求文档。

已知限制

• DOM 注入：按钮靠 composer 结构定位（编辑器 + 发送按钮 + file input）。上游改版可能让选择器失配，届时按钮不出现（不会报错）；分栏/多会话时每个 composer 各挂一个。
• 写回优先走官方 InputActions：inputActions.setDraft 是 Lexical 的整段替换入口；拿不到该服务时才退回 execCommand('selectAll')，不再直接写 textContent，避免编辑器状态与 DOM 脱节导致输入框/文件引用异常。
• 增强期间不覆盖新输入：请求进行中如果你继续打字或加文件，结果只复制到剪贴板，不覆盖当前草稿。
• 统计是本地文件：stats.json 写在插件目录下，不参与云端计量，口径只覆盖本插件的增强调用。
• 一次一段：只处理输入框当前草稿，不处理选中片段。

开发

仓库没有构建步骤，lib/ 下的文件就是产物：

• lib/index.js — 宿主端（ESM，依赖 @deepseek-ai/dsh-llm 的 BlockAssembler / createUserMessage）
• lib/client.js — 浏览器端（window.__ModuleLoader__.load 模块包装）
• cordis.patch.yml — bundle patch，注册插件条目

改完重启 DSH 或等 HMR 重新组合即可。

License

MIT