前言¶
在 DSH 里与智能体对话时，输入框里往往只有一句意图，例如「把事项中心的材料接口加个导出」。直接发送可以试着让模型猜，但目标、范围、验收标准若不写清，返工概率会上去。手写一整段结构化提示词又费时间。
dsh-prompt-enhancer 在 Web 会话输入框右侧增加「增强提示词」按钮：把当前草稿交给当前默认模型做改写，结果写回输入框，不自动发送；失败有明确反馈，也可随时改回原稿。下面按定位、能力、安装、用法与注意点说明。
这是什么¶
- 插件名称：dsh-prompt-enhancer
- 维护者：991206772-debug
- 分类：模型推理（社区目录 SkillHub）
- 源码：GitHub，MIT 许可证，版本 1.0.0（以
package.json为准）
一句话：用 Host 侧 LLM 路由 + Web 客户端按钮，在本地会话里完成「草稿 → 补齐后的提示词 → 写回输入框」，不执行任务、不替用户点发送。
核心功能¶
改写规则（与 README 一致）¶
- 补全结构：短稿可补齐目标、范围、约束、验收标准、交付形态等常见小节。
- 硬约束保留：代码、路径、报错、命令、变量名、接口名、URL、数字与单位按原文逐字保留。
- 不臆造：草稿没有且无法合理推断的内容，写成「待确认：……」留白，不新增需求。
- 只产出提示词：不执行任务、不加前言、不用代码块包裹输出；输出语言跟随草稿。
- 长度控制：元提示词要求不超过原文约 3 倍（极短草稿放宽到约 500 字）；Host 侧还用
maxTokens与 20000 字符硬上限兜底。
架构：Host 与 Web Client 各一半¶
| 文件 | 作用 |
|---|---|
index.js |
注册同源 POST /prompt-enhancer/enhance，校验、限流、超时，调用 ctx.llm.stream，返回 JSON。 |
client.js |
在 conversation.input.right 注册 id: prompt-enhancer（order: 30）按钮，通过 inputActions.setDraft() 写回草稿。 |
cordis.patch.yml |
bundle patch，插入 Host 插件行。 |
locale/zh.json、locale/en.json |
插件管理器中的标题与描述。 |
客户端不点击发送控件、不读宿主 DOM，只改草稿文本。
安装与启用¶
在 DSH 内安装 bundle¶
资料给出的安装方式为插件管理器安装 GitHub 目标（会自动写入 profile 依赖并启用 bundle）：
plugin_manager(action: "install_bundle", target: "github:991206772-debug/dsh-prompt-enhancer")
装完后 Web GUI 需要刷新页面：客户端半只在页面加载时进入模块表；宿主路由随 plugin 行激活即可用。
命令行 Profile 安装（桌面 / CLI）¶
dsh plugin --profile web add github:991206772-debug/dsh-prompt-enhancer
从 GitHub 安装时，依赖由插件管理器按声明安装；peerDependencies 中的 @deepseek-ai/cordis 由宿主提供，安装时可能出现的 peer 解析 [WARN] 不影响加载。运行环境要求 Node >=22.3.0。
配置（可选）¶
默认 config: {} 即可。覆盖项可写在 cordis.patch.yml 的 config:，或在 profile 的 patch 层按 id: prompt-enhancer 覆盖：
| 字段 | 默认值 | 说明 |
|---|---|---|
provider |
"" |
覆盖模型路由；空则用 ctx.agentDefaultModel.currentSelection()。 |
model |
"" |
与 provider 同时给出才生效，否则回落默认模型。 |
temperature |
0.3 |
0–2。 |
maxTokens |
1200 |
64–8192，输出硬上限。 |
timeoutMs |
60000 |
Host 侧超时（毫秒）。 |
maxDraftChars |
8000 |
超过则 413，不发模型。 |
metaPrompt |
内置中文元提示词 | 整体替换改写规则。 |
Schema 由 @deepseek-ai/schemastery 构造，可在插件面板做结构化查看。
典型用法¶
- 在 DSH Web 会话输入框写好简短草稿（可含路径、接口名、报错等需保留的原文）。
- 点击输入框右侧 ✨「增强提示词」按钮。
- 等待 Host 调用默认模型（或你在配置里指定的 provider/model）。
- 检查写回输入框的正文：满意后再自行发送；不满意可手工编辑或重新编辑草稿后再增强。
Host 接口契约（供排查或二次集成时对照）：
- 路径：
POST /prompt-enhancer/enhance（同源） - 请求头：
content-type: application/json，x-dsh-prompt-enhancer: 1 - 请求体：
{"draft": "..."}
成功时返回 ok: true 及 prompt、provider、model、routeSource、stats 等字段；失败时统一 ok: false 与 error.code / error.message（如空草稿、超时、未配置模型、草稿过长等）。隐私方面：不落盘草稿、日志中对疑似密钥片段做 [redacted] 处理。
适用场景与注意¶
适合：习惯在 DSH Web 里写提示词、希望用同一套默认模型快速把短意图扩成可执行说明，且希望自己过目后再发送的开发者。
注意：
- 插件在当前 DSH 进程权限下运行，增强会调用已配置的 LLM；安装前建议浏览 仓库源码 与 MIT 许可证。
- 按钮与
mcp-manager-quick（order: 40）同列，本插件order: 30在其左侧。 - 社区目录为独立站点 SkillHub，与 DeepSeek / 幻方无官方从属关系。
- 已知限制：页面重渲染后按钮行为等细节，在无浏览器自动化时需人工点一次确认。
卸载：
plugin_manager(action: "remove_bundle", target: "dsh-prompt-enhancer")
卸载后 HTTP 路由与 slot 随 ctx.effect 清理；Web 端刷新后客户端半不再加载。
结尾¶
dsh-prompt-enhancer 把「写完整提示词」从手工扩写变成输入框旁的一步操作：模型只负责改写草稿，发送权仍在你手里。更多信息见社区目录 dsh-prompt-enhancer 与 GitHub 仓库 991206772-debug/dsh-prompt-enhancer。
