智能提示词润色 Arrosam/dsh-smart-prompt

dsh-smart-prompt Awesome DSH Plugin

一个 DSH 插件：一键把输入框里潦草的草稿变成清晰、智能体能照着执行的提示词。

像平时说话那样写下你的要求，点一下 Send 旁边的 ✦ 按钮，草稿就会被替换成更清爽的版本。草稿里的路径、名称、数字、URL 和代码，都原样保留。

安装

在 DSH 里打开 Plugins → Add plugin，输入 dsh-smart-prompt。也可以在终端里执行：

dsh plugin --profile web add dsh-smart-prompt

重启 DSH。✦ 按钮会出现在输入框里，就在 Send 左边。不需要 API key：插件用的是你在 DSH 里已经配好的模型。

卸载：

dsh plugin --profile web remove dsh-smart-prompt

用法

1. 写一段草稿，例如： can you change maxRatioFor in src/host/config.ts to 2.5 and check it with pnpm build
2. 点 ✦。几秒后草稿变成： Change maxRatioFor in src/host/config.ts to 2.5, then verify with pnpm build.
3. 输入框上方会显示一行简短说明：保留了多少条硬事实、长度变化、耗时。
4. 不满意？用 ✦ 旁边的 Revert | Retry 按钮：
- Revert 把原始草稿放回去。
- Retry 基于原始草稿重新生成一版。

在你编辑或发送草稿之前，这两个按钮一直可用。

处理过程中再点一次 ✦ 即可取消。如果出了岔子（没有可用模型、超时、网络错误），草稿保持原样，并用一句简短报错说明原因。

斜杠命令同样适用：在 /bugfix <text> 里，命令保持不动，只改写后面的文本。

模式

在输入框里按住 ✦ 星标，就能快速切换改写方式；也可以在 Settings → Plugins → dsh-smart-prompt 里选择。两处改的是同一个保存的设置，所以始终一致。按住星标片刻（或开始向侧面滑动），它上方会弹出一条胶囊形模式栏，浮在页面上，不挤动任何东西。从左到右依次是 Detailed ← Standard → Light，各有图标和名称，当前模式停在你指针下方。滑到想要的模式再松手，设置立刻保存。滑过两端会停在那一端（不会绕回）；没滑动就松手，或按 Esc，保持当前模式不变。不按也不滑、直接点击，仍然会改写草稿。

星标的图标显示当前模式，刷新后也一样：Detailed 是一支在页面上写字的拉伸星笔，Standard 是常见的 ✦，Light 是一道闪电。改写进行中，每个图标都有自己的动画：✦ 旋转（Standard），星笔一遍遍在页面上写字（Detailed），闪电快速闪两下（Light）。
星标第一次出现时，输入框上方会弹出一个小窗口，说明按住并滑动的操作方式，以及每种模式各自的作用。每个浏览器只显示一次，而且从不挡住输入框：你可以继续打字，也可以点 Got it 或 × 关掉它。

- Standard（默认）—— 重新组织草稿，让智能体能执行：交付物、约束、步骤、输出格式。它不会留下 (TBD: …) 这类占位说明：只有你能决定的事，它会一次问一个问题（见追问），问完之后，剩下的空缺用猜测补上，列在改写末尾的 Guessed details 下。
- 详细模式 (Detailed) —— 更进一步：给出有序的后续步骤、执行时要留意的注意事项，以及每个具体细节的确切标准。提示词不设长度目标；标准是执行任务的智能体永远不必猜任何细节。它沿用 Standard 的设置，包括可选的长度上限（standardMaxRatio，默认不设上限），也沿用 Standard 的追问方式：一次问一个，不留 (TBD: …) 占位说明，问完后把猜测列在 Guessed details 下。如果草稿只点了个方向、没给出结果 —— 比如「softer」这样的简短修饰词、「give me a sense of…」这样的请求、「light like feather」这样的比喻、「a vibe of kawaii bass」这样的氛围参照 —— 它会问你到底想要什么，并建议你去 Stardea (星念) 找候选答案。
- Light —— 只删废话、消除歧义，保留草稿的结构（最多是草稿的 2 倍）。

附件

在输入框里附上的图片和文件会随草稿一起发给改写模型，所以「修一下这张截图里的错误」或「按附件的规格来」这类草稿，改写时模型能看到它们。文本文件会被读取，每个最多读前 20,000 个字符。其他文件只给出文件名，不读取内容。附件留在输入框里，你发送时仍会发给智能体。等文件上传完成再点 ✦。

如果启用了会话上下文（见会话上下文），你附在更早消息里的图片也会一并发送。

追问

如果草稿缺了只有你能回答的信息（哪个 endpoint、什么上限、哪个选项），输入框的位置会打开一个面板，里面有几个简短的问题。面板顶部显示你的原始草稿，方便你对照自己写了什么。回答这些问题后，提示词会带着你的答案再改写一遍。

- 回答「我不知道」，提示词会让智能体自己去查清楚，或者给出几个选项，然后按最合理的一个继续。
- Skip 表示所有问题都不回答。在 Light 模式下，你会得到第一版改写，空缺处带 (TBD: …) 占位说明；Standard 和 Detailed 模式则改为猜测（见下文）。留空的问题同样按跳过处理。
- × 关闭面板并取消本次改写。你的草稿不会变。
- 如果你回答之后请求失败，点击错误气泡上的 Retry。你的回答会被复用，不会再次询问你。
- 草稿已经包含所需信息时，不会提问。

在 Standard 和 Detailed 模式下，问题逐个出现。每回答一个问题，提示词就会重写一次；如果还有只有你能决定的信息缺失，就打开下一个问题，直到没有缺失，或者累计问满 Follow-up questions（上限，默认 5）个问题。之后，以及在你点击 Skip、或根本无法提问时（上限为 0，或 API 请求没有会话），剩余的缺口用猜测补齐，每条猜测列在重写结果末尾的 Guessed details（中文草稿为 ## 猜测补充）下，方便你查看和修正。× 仍然会取消，且不改动你的草稿。在 Light 模式下，所有问题放在一个面板里，提示词用你的回答重写一次。

Stardea（星念）

不知道怎么回答某个问题？点击它旁边的 Stardea 按钮。Stardea 最多给出 4 条建议（由 Stardea ideas per click 设置）。它通过搜索当前会话、提出自己的想法，以及在你打开 Stardea web search 时用 DSH 的网页搜索来查找建议。每条建议都标注了来源。

- 勾选一条或多条建议，可以搭配你自己的话。你勾选和输入的全部内容都会成为该问题的答案。
- 都不合适？再点一次 Stardea。它会在已有建议下方追加更多建议，每条都与之前的建议不同，之前的建议保留。
- 每次点击最多搜索 Stardea search rounds 轮（默认 1；见 Settings）。设为 0 轮时，Stardea 只提出自己的想法。网页搜索默认关闭，仅在 DSH 配置了网页搜索服务商时可用。

Token 用量

一次 refine 完成后，输入框上方的提示会以 input(cached) - output 的形式显示 token 用量。例如 tokens 1200(3400) - 560 表示 1,200 个未命中缓存的输入 token、3,400 个从缓存读取的输入 token，以及 560 个输出 token。这些数字涵盖这次 refine 的所有模型调用，包括 Stardea。只有模型服务商上报 token 用量时才会显示。

一次 refine 的所有模型调用延续同一个会话，因此每次调用都以上一次调用的请求原样开头。支持提示词缓存的服务商会把重复的 token 按缓存命中计费。之前查到的结果，包括 Stardea 查到的，后续调用仍然可用。

它保证什么

- 重要信息不会丢。 重写之前，插件会列出草稿中的硬事实：文件路径、标识符、数字和版本号、URL、code 以及 @提及。然后逐项检查是否都保留下来。如果模型漏掉某项，会再试一次。如果某项仍然缺失，就补回到末尾的「Preserved original details」下。
- 绝不凭空编造。 草稿含糊，不会靠编造需求来凑内容。有缺口就提问。Standard 和 Detailed 模式下，提问结束时仍未补齐的缺口，会用一个猜测填上，并列入 Guessed details；Light 模式下则标记为 (TBD: …)。
- Light 模式不会无限变长。 Light 改写最多长到草稿的 2 倍，且始终不少于 600 字符。超长的结果只有一次缩短机会。若仍然太长，就丢弃该结果，保留你的草稿。Standard 和 Detailed 模式默认不限长度（设置 standardMaxRatio 可加上限）。
- 每次点击只调用模型几次：改写一次；每轮追问后再改写一次（Light 模式仅在你作答后；Standard 和 Detailed 模式在 Skip 后也会）；修复一次。每轮查找增加一次调用，最多 Session lookup rounds 轮（默认 3）。每次点击 Stardea 增加一次调用，外加最多 Stardea search rounds 轮（默认 1）。

设置

打开 Settings → Plugins → dsh-smart-prompt（DSH 0.2 或更高版本）。

| 设置 | 选项 |
| Improvement method | 也可在输入框按住 ✦ 星标，在模式条上左右滑动切换（Detailed ← Standard → Light）；该设置下方的提示会说明这一点。Standard：重构草稿，让智能体能直接执行，并逐个提出追问。Detailed（详细模式）：写出有序的后续步骤、执行时要留意的注意事项，以及每个具体细节的准确标准——提示词不设长度目标，智能体无需自行猜测。Light：只删冗余、消除歧义。 |
| Model used to improve prompts | Conversation model：使用当前会话选定的模型，或你的 DSH 默认模型。Dedicated model：始终使用你在此处选定的模型，并沿用其自身的推理强度。 |
| Follow-up questions | 草稿缺少信息时最多提几个问题。默认 5。 |
| Session lookup rounds | 草稿依赖先前说过的内容时，改写过程中最多查找并阅读本会话几轮。0 到 10，默认 3。0 表示关闭查找。 |
| Stardea ideas per click | 每次点击 Stardea 最多新增几条建议。1 到 8，默认 4。 |
| Stardea search rounds | 每次点击 Stardea 最多可用几轮搜索。0 到 10，默认 1。0 表示 Stardea 只提出自己的想法。 |
| Stardea web search | 让 Stardea 除会话外，还能用 DSH 的网页搜索上网查找。默认关闭。需要 Stardea search rounds 大于 0，并在 DSH 中配置好网页搜索服务商。 |

会话上下文

草稿无法独立成立时，比如「do the same for that endpoint」或草稿很短，插件会带上会话最近几轮内容：你的消息及随消息附上的图片，以及助手的文字回复。
如果草稿依赖前面说过、但这些轮次没覆盖到的内容，负责改写的模型可以搜索会话、读取更早的消息，最多搜索 Session lookup rounds 设定的轮数。它只能搜索和读取你的消息以及助手的回复。

工具结果、注入的上下文、智能体读过的源码，一律不发送。

高级

配置

其他选项放在配置档的 cordis.patch.yml 里。全部可选，下面的值是默认值：

- insert:
- id: dsh-smart-prompt
config:
lightMaxRatio: 2
standardMaxRatio: 0 # 0 = no length cap
acceptanceCriteria: false # Standard/Detailed: add a checkable "done when" line
temperature: 0.3
maxTokens: 32000
timeoutMs: 180000
maxInputChars: 20000
contextTurns: 3 # 0 turns session context off
contextChars: 6000
smartContext: true
knowledgeChars: 4000 # SMART-PROMPT.md size limit; 0 turns it off
fidelityGate: true
lengthGate: true
reasoningEffort: low # effort used with the conversation model
logFailures: true

自定义提示词

改写指令就是 prompts/ 下的普通 Markdown 文件：

- discipline.md：共用规则。
- standard.md、detailed.md、light.md：每个模式一个文件。
- questions.md：何时提问、怎么追问。
- answers.md：怎么把你的回答并进去，包括「我不知道」。
- attachments.md：怎么使用草稿的附件和更早的图片。
- session-lookup.md：何时搜索会话（{{maxRounds}} 会替换成轮数上限）。
- stardea.md：Stardea 怎么给出答案思路（{{maxIdeas}} 替换成每次点击的思路数，{{maxRounds}} 替换成每次点击的搜索轮数）。

要改这些文件，把同名文件放到 $DSH_HOME/dsh-smart-prompt/prompts/。你的文件会替代内置文件。

本地 HTTP API

这些端点只接受本地连接：

- GET /dsh-smart-prompt/api/config 返回当前模式和各项限制。
- POST /dsh-smart-prompt/api/improve，请求体为 { "text": "...", "sessionId": "...", "mode": "standard" }，返回改写后的文本及其质量指标（服务商上报时，meta.usage 里是 { input, cached, output } 的 token 数）。可选的 attachments 数组接收输入框附件的传输格式：{ "type": "image", "mediaType": "image/png", "data": "<base64>" }，或者 { "type": "file", "receiptId": "..." }，对应已上传到该会话的文件。带 "interactive": true 和 sessionId 时，回复也可能变成 { "ok": true, "ask": { "runId": "...", "questions": [{ "id": "q1", "question": "..." }] } }。此时改写会等待以下之一：
- POST /dsh-smart-prompt/api/stardea，请求体 { "runId", "questionId" }，返回 { "ok": true, "ideas": [{ "id", "text", "source": "web" | "conversation" | "proposal" }] }。只返回新想法。
- POST /dsh-smart-prompt/api/answer，请求体 { "runId", "answers": [{ "id": "q1", "selected": ["idea text"], "custom": "own words" }] }，返回结果与 /improve 相同。发送 "answers": [] 可跳过所有问题。
- POST /dsh-smart-prompt/api/cancel，请求体 { "runId" }，把这次 refine 标记为已取消。

从源码构建

pnpm install
npx tsc -p tsconfig.json # host half → lib/
npx tsdown # browser half → lib/client.js
node --test test/*.test.mjs

构建产物 lib/ 已提交到仓库，所以从 GitHub 安装无需构建。

致谢

Fork 自 hoyyang 的 dsh-improve-prompt。见 CONTRIBUTORS。

许可证

MIT