提示词增强 saul-dsh/dsh-prompt-enhancer

dsh-prompt-enhancer

给 DeepSeek Harness（dsh）做的对话框提示词自动增强插件：你在对话框里随手打一句粗糙的需求，插件在消息真正发给模型之前，先调用一次轻量改写，把它变成一段清晰、具体、自包含的提示词——体验对标 WorkBuddy / ChatGPT 的「提示词增强」。

你输入 → [dsh-prompt-enhancer 改写] → 增强后的提示词进入会话 → Agent 执行

效果示例

| 你的原始输入 | 增强后（自动进入会话） |
| 帮我写个爬虫 | 编写一个 Python 爬虫脚本：抓取指定网址列表中每个页面的标题和正文，按天保存为 CSV（列：url、title、content、date）。要求：请求间隔 ≥1 秒、失败自动重试 3 次、超时 10 秒，代码含中文注释并附使用说明。 |
| 这个 bug 修一下 | 定位并修复当前仓库中的构建失败：先运行 pnpm run build 复现报错，给出根因分析（引用具体文件与行号），完成最小修复后重新运行构建验证通过，并总结改动点。 |
| 做个网站 | 用单个 HTML 文件制作一个「个人书签导航页」：顶部搜索过滤，卡片式分组展示书签（名称、URL、备注），支持增删改（localStorage 持久化），浅色主题、移动端适配，无外部依赖。 |

更多对比见 examples/before-after.md。

安装

方式一：本地路径安装（开发/试用）

dsh plugin --profile web add /path/to/dsh-prompt-enhancer
dsh --profile web --dump-config # 确认插件树里出现 prompt-enhancer
dsh --profile web

方式二：从 GitHub 安装

dsh plugin --profile web add https://github.com/saul-dsh/dsh-prompt-enhancer

方式三：不改 profile，先用 --patch 临时挂载试用

scratch.cordis.yml
- insert:
- id: prompt-enhancer
name: /absolute/path/to/dsh-prompt-enhancer/index.js

dsh --profile web --patch ./scratch.cordis.yml

启动日志出现 [dsh-prompt-enhancer] loaded (mode=auto, ...) 即安装成功。

配置

在 profile 配置（或 market 安装后的插件设置）里对 prompt-enhancer 行写 config：

- override:
id: prompt-enhancer
config:
enabled: true
mode: auto # auto=发送前自动增强；manual=只注册工具不自动改写 provider: deepseek-official # 留空=跟随当前会话的模型路由 model: deepseek-flash # 建议配一个快模型，降低每次发送的延迟 timeoutMs: 20000 # 单次增强超时，超时后原样发送 minPromptLength: 4 # 「继续」「ok」这类超短输入不增强 maxInputChars: 4000 # 长输入视为已是完整提示词，不再增强 language: auto # auto=跟随输入语言；可强制 zh / en styleHint: "" # 追加自定义风格要求，例如"偏工程口吻，给出验收标准"

| 字段 | 默认 | 说明 |
| enabled | true | 总开关 |
| mode | auto | auto 自动增强；manual 仅暴露工具 |
| provider / model | 跟随会话 | 增强调用用的模型路由，建议快模型 |
| timeoutMs | 20000 | 超时即放弃增强（fail-open） |
| minPromptLength | 4 | 短于该长度不增强 |
| maxInputChars | 4000 | 长于该长度不增强 |
| language | auto | 输出语言 |
| styleHint | 空 | 自定义风格要求 |

工作原理

- 挂载 agent/pre-step 瀑布流（dsh 的权威消息准入接缝）：每一步开始前拿到默认裁决 { kind: 'enter', messages }，把批次内的纯文本用户消息用一次 LLM 调用重写后，以全新 UserMessage 放行。
- 跳过规则：斜杠命令（/plan 等）不改写；含文件/图片附件的消息不改写；过短、过长输入不改写；非聊天框来源的内部 user 消息（goal 轮次、会话引用、notice 等）不改写。
- fail-open：增强失败 / 超时 / 无可用路由时，原始消息原样放行，绝不阻塞对话。
- 输入框增强按钮：web 端在输入框工具栏左侧注册一个 Sparkle 图标（conversation.input.left slot，对齐 WorkBuddy 的「增强提示词」图标）。点击后把当前草稿发给 /api/prompt-enhancer/rewrite，用改写结果替换输入框内容；草稿为空或正在请求时按钮禁用。CLI / TUI 等没有 web 客户端的宿主不加载这部分，只保留发送前自动增强。
- 同时注册 enhance_prompt 工具：模型自己也能调用（例如在重跑一个模糊需求前先改写它）。

注意事项

- dsh 目前处于 developer preview，插件 API 可能随版本变动；本插件已针对 0.2.x 的事件与类型核对，升级后如失效应先复查 agent/pre-step 签名。
- 每条消息发送前会多一次模型调用（增强调用本身消耗少量 token）；对延迟敏感时请给 model 配置快模型。
- 增强后的提示词会进入会话日志（与 WorkBuddy 行为一致）；想回看原始输入可在插件日志里找到 enhanced X -> Y chars 记录。
- 输入框的增强按钮只在 web 客户端出现；要在配置层面彻底关闭自动增强，请在配置档里设 enabled: false（此时按钮也不会注册）。

发布到 GitHub（维护者）

1. Fork / 推送本仓库，把 package.json 里 repository.url 改成你的地址。
2. 给仓库添加 GitHub Topic：dsh-plugin（官方发现机制会按该 topic 收录）。
3. （可选）发布到 npm：npm publish，files 白名单已含 index.js 与 cordis.patch.yml。
4. 建议在 README 顶部放一段安装命令，方便一键复制。

License

MIT