dsh-prompt-enhancement
DeepSeek Harness（DSH）Web GUI 的独立「提示词增强」插件：在输入框底行、模型选择器左侧提供一个按钮， 点击后用提示词工程专家框架把你当前输入的草稿真正改写、补充成更清晰具体的提示词， 弹窗确认后由你决定是否替换输入框。宿主侧内置直连模型的快速增强接口（秒级），并带本地离线兜底。
> A standalone dsh web plugin: a Prompt-Enhance button next to the model selector that rewrites and > expands the current input draft through a prompt-engineering expert framework, with a confirm dialog, > a fast direct-model engine, an offline fallback, and its own on/off switch in Settings.
核心功能
- 输入框按钮：注册于官方
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（peerreact@^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