@dsh-external/dsh-prompt-enhancer

Readme

# dsh-prompt-enhancer

> 一句大白话丢进去，出来一份 agent 秒懂、自带参考文件清单的任务说明书——从此告别「我这个需求它怎么就是不懂」。

DSH(DeepSeek Harness)提示词增强插件。在聊天输入框右侧加两个按钮：

- **强化 ✦**：把当前草稿交给一个隔离的后台 agent——它会带上你的对话上下文、自己去仓库里 glob/grep 定位真正相关的文件——重写成结构清晰、约束明确、拿去就能用的任务提示词（末尾附经过存在性校验的「参考文件」清单），替换输入框草稿。**不自动发送、不进主对话历史**，改完你过目再发。
- **还原 ↺**：反悔了？一键退回强化前的原文。手动编辑过草稿或消息已发出时自动消失，不打扰。

## 安装

```sh
dsh plugin --profile web add github:Vinzelles/dsh-prompt-enhancer
```

或者直接将这句话发送给你的 DSH：

> 帮我安装 https://github.com/Vinzelles/dsh-prompt-enhancer 这个插件

装完重启 `dsh web`（或刷新页面），输入框右侧就能看到 ✦。

## 强化程度与模型

设置 → 插件 → 插件配置 → 「提示词强化」卡片：

| 强度 | 效果 |
| --- | --- |
| 低 | 只做措辞与结构润色，篇幅最接近原文，不带任何文件引用 |
| 中（默认） | 标准优化、输出紧凑（约 ≤1.5 倍原文），参考文件只列路径 |
| 高 | 充分展开背景/步骤/验收（≤3 倍原文），参考文件带说明 |

还可以给强化单独指定模型（provider → model → 思考强度三级联动），不配置则跟随会话默认模型；配置即时生效，无需重启。
建议设置轻量快速的模型，避免强化消耗过多token或是耗费时间过长。

另有「**转换英文**」开关（默认关）：开启后无论输入什么语言，强化结果都会自动输出为英文提示词（参考文件节标题变为 `## Reference Files`，需要兜底回填的技能引用节为 `## Skill References`）；skill 引用记号、文件路径与专有名词保持原样不翻译，参考文件的存在性校验照常生效。关闭则保持默认行为（输出跟随输入语言）。

## 值得信任的地方

- **零污染**：强化在隔离子会话里跑完即销毁，主对话历史干干净净；子会话失败自动降级为模型直调，再失败保留原文并 toast 提示，可重试。
- **不瞎编路径**：参考文件清单逐行校验存在性，臆造路径自动剔除；没有仓库或检索零命中时静默省略该节。
- **引用不丢**：草稿里的 skill 引用记号（`/tdd`、`/code-review` 这类）强化后原样保留——模型改写意外丢失时自动以「## 技能引用」节补回，发送后技能照常生效。
- **可中止**：强化期间输入卡片盖上加载遮罩、锁定编辑；点「取消」立即中止后台子代理，草稿保持原文。

## 故障排查

图标不显示或行为异常时，先看诊断日志 `~/.dsh/super-injector/prompt-enhancer-diag.log`——各执行阶段的信标都落在这里（`slot-entry-error` = 按钮组件渲染崩溃被槽渲染器静默退役，错误详情就在日志里）。快速自检：`GET /prompt-enhancer` 应返回 405、空体 `POST /prompt-enhancer` 应返回 400，说明 host 路由已注册。

## 开发

纯 JS（无 tsc/tsdown 依赖），构建即 src → lib 拷贝加特征校验：

```bash
bash scripts/build.sh
```

注入器环境内（`<插件目录>` 指本仓库在本机的绝对路径，调用时替换为实际路径）：

```
dev_build_plugin {"dir": "<插件目录>"}
dev_inject_plugin {"dir": "<插件目录>"}
```

领域术语与行为契约见 [CONTEXT.md](CONTEXT.md)，执行通道决策见 [docs/adr/](docs/adr/)，10 项功能验收基线见 [docs/VERIFICATION.md](docs/VERIFICATION.md)。

## License

MIT