Ackerman0/Dsh-Prompt-Enhancement

dsh-prompt-enhancement

DeepSeek Harness（DSH）Web GUI 的独立「提示词增强」插件：在输入框底行、模型选择器左侧提供一个按钮，
点击后用提示词工程专家框架把你当前输入的草稿真正改写、补充成更清晰具体的提示词，
弹窗确认后由你决定是否替换输入框。宿主侧内置直连模型的快速增强接口（秒级），并带本地离线兜底。

一个独立的 dsh web 插件：模型选择器旁的「提示词增强」按钮，通过提示词工程专家框架
改写并扩展当前输入草稿，带确认弹窗、
快速直连模型引擎、离线兜底，以及设置中自带的开关。

核心功能

- 输入框按钮：注册于官方 conversation.input.right 槽位（模型选择器正左侧），与既有输入框逻辑无缝集成，
样式使用 shell 的 --dsw-* 设计令牌，与相邻控件（权限、模型选择器）字体与高度完全一致。
- 真实改写（LLM 引擎）：宿主侧注册回环 HTTP 路由 /api/prompt-enhance，用当前选定的模型做一次
直接补全（无 agent 回路、无工具调用），系统提示词采用 WorkBuddy 同款提示词工程专家框架：
明确目标、补充上下文、设定约束与输出格式、语言与输入保持一致、约 800 字以内、只输出增强后的提示词。
- 离线兜底：智能体/网络不可用时，回退到本地意图改写引擎（17 类意图：打包发布、翻译、总结、修复、
测试、编程、写作、文生图、分析、计划、邮件、设计等），并按需拉取 GitHub 提示词工程资源
（f/awesome-chatgpt-prompts 模板库、dair-ai/Prompt-Engineering-Guide、GitHub Search API）用于来源展示；
GitHub 亦不可达时使用内置模板。
- 确认式交互：增强结果在弹窗中展示（可继续编辑），提供「复制 / 重新增强 / 关闭 / 替换输入框」；
「替换输入框」只回填草稿、绝不自动发送；「重新增强」始终读取输入框此刻的最新内容。
- 独立设置版块：在「设置」导航栏注册独立的「提示词增强」版块，含开启/关闭开关；
关闭后按钮与智能体公告即时隐藏，状态持久化于 settings.yaml。
- 自诊断：插件把「注册了哪些槽位 / 挂载是否成功 / 渲染错误」写入 prompt-enhance.diagnostics 设置字段
（仅在有异常或每 5 分钟发布一次），便于远程排障。

安装

1. 把本目录链接进 web profile（等价于 pnpm add link: 并登记 bundle）
dsh plugin --profile web add link:$(pwd)

2.（一次性）让 Web 设置界面能读写本插件的开关：
在 dsh 安装目录的 @deepseek-ai/dsh-host-apiproxy/lib/index.js 中，
把 "prompt-enhance" 加入 WEB_SETTINGS_NAMESPACES 数组，然后重启 dsh。
不做这一步时开关界面显示不可用，可改为直接编辑
~/.dsh/settings.yaml 中的 prompt-enhance.enabled: true / false。

刷新 Web GUI 后：输入框底行出现「✨ 提示词增强」按钮；「设置」导航栏出现独立「提示词增强」版块。

使用指南

1. 在输入框写下草稿，点击「✨ 提示词增强」按钮；
2. 弹窗显示「正在分析并增强提示词…」，当前模型直连返回改写后的提示词（秒级）；
3. 在弹窗里可继续编辑；若期间又改了输入框内容，点「重新增强」用最新内容重跑；
4. 点「替换输入框」回填草稿（不发送），或「复制」/「关闭」保持原输入不变；
5. 「设置 → 提示词增强」中的开关可随时停用/启用插件。

目录结构

cordis.patch.yml      组合补丁：插入 ui-prompt-enhance 插件行（node 半 + 浏览器半）
lib/index.js          宿主侧入口：智能体公告、设置命名空间、/api/prompt-enhance 快速 LLM 路由
lib/client.js         浏览器侧入口（ModuleLoader bundle）：按钮、弹窗、意图改写引擎、设置版块
package.json          dsh 清单（dsh.bundle.patch / dsh.client 注入）、依赖与 files 白名单
README.md             本文档
LICENSE               MIT

技术栈与依赖

- 宿主侧（Node / ESM）：@deepseek-ai/dsh-settings（设置命名空间）、@deepseek-ai/dsh-llm（直连模型流式调用 + BlockAssembler）、
schemastery（配置校验）；服务注入：systemPrompt / webServer / llm / agentDefaultModel。
- 浏览器侧：官方 client 槽位系统（conversation.input.right、settings.section），React（peer react@^18.2，
由 shell 注入），运行时 @deepseek-ai/dsh-client-runtime / @deepseek-ai/dsh-client-ui-settings。
- 增强引擎：当前选定的模型（agentDefaultModel.currentSelection()，直连 API，temperature 0.7、maxTokens 1200、60s 超时）。

配置方法

| 配置项 | 位置 | 说明 |
|---|---|---|
| 开启/关闭 | Web「设置 → 提示词增强」或 settings.yaml 的 prompt-enhance.enabled | 关闭后按钮与公告即时隐藏 |
| 诊断记录 | settings.yaml 的 prompt-enhance.diagnostics（只读） | 记录槽位注册、挂载与渲染错误，用于排障 |
| 增强模型 | 全局模型选择器 | 路由使用当前默认模型（provider/model/reasoningEffort） |
| API Key | 走 DSH 自身的模型凭据配置 | 插件不接触、不存储任何密钥 |

常见问题（FAQ）

Q：重启后按钮/设置版块没出现？
A：宿主只在启动时读取插件清单。请完全重启 dsh（出现「服务启动失败」页时点「重试」），并确认
index 响应带 cache-control: no-store（新版 dsh 已内置）；若本机曾修改过 apiproxy 缓存头配置，请核对。

Q：点了按钮一直提示上一次的结果？
A：弹窗里点「重新增强」即可用输入框当前内容重跑；直接点输入框旁的按钮也始终读取文本框实时内容。

Q：增强很慢？
A：新版为直连模型单次调用（秒级）。若超过 60 秒会超时并自动回退本地改写，请检查模型网络或更换模型。

Q：设置里的开关显示「设置暂不可用」？
A：宿主未暴露 prompt-enhance 命名空间。按「安装」第 2 步把 prompt-enhance 加入 apiproxy 的
WEB_SETTINGS_NAMESPACES，或直接编辑 settings.yaml 的 prompt-enhance.enabled。

Q：为什么有时会出现「GitHub 内容获取失败」提示？
A：那是离线兜底路径的提示（LLM 引擎不可用时自动启用），表示本次使用本地模板完成了增强，
原始输入不受影响，可点「重新增强」重试。

模型体验

宿主侧仅在启用时注入一小段插件公告；浏览器侧数据流不进入模型请求（增强调用为独立的一次性补全）。

License

MIT