前言¶
在 DeepSeek Harness（DSH）里写 Composer 草稿时，措辞往往还要再改一轮：句式不顺、目标不清晰、引用 @file / @session 芯片已经选好，却不想为润色单独开一条会话。常见做法是复制到别处改完再贴回，或把整段发给模型——前者打断流程，后者会在 Session 里多出一行对话。下面介绍的插件把润色收进 Composer 工具栏：原地改写、不提交 Session，并保留撤销与芯片行为。
这是什么¶
@saoutax/dsh-prompt-polish 是 Saoutax 维护的 DSH 插件（社区分类：模型推理）。它在 Composer 工具栏、模型选择器旁增加一颗紧凑按钮；点击后由 AI 改写当前草稿，结果直接替换输入框内容，不向 Session 提交，因此不会产生新的聊天行。项目仓库：https://github.com/Saoutax/dsh-prompt-polish；目录页：https://www.skillhub.cn/plugins/Saoutax/dsh-prompt-polish。
核心功能¶
原地改写与单次撤销¶
润色后草稿被 polished 文本整体替换；未向 Session 发送，故无额外对话记录。润色前的内容会保留 8 秒，此期间按钮变为撤销控件，再次点击可恢复原草稿。
引用芯片与命令草稿¶
改写会尽量把已有的 @file、@session 芯片重新锚定到润色后的正文；若改写后文中不再出现某芯片，芯片会被追加到末尾而不是丢弃。以命令芯片开头的草稿（例如 plan 模式的 /plan 或已选 slash 命令）同样可润色：仅改写命令标记之后的正文，命令声明原样保留。若 /plan 芯片后没有任务文字，则无可润色内容，按钮保持隐藏直至输入任务描述。
模型与快捷键¶
可在插件行配置 provider、model；留空则跟随当前 Session 的路由与推理强度（并回退到部署默认模型）。快捷键：Windows/Linux 为 Ctrl+Shift+.；macOS 为 Cmd+Shift+.，对当前焦点会话执行工具栏同一动作。
配置项¶
在 DSH 插件列表中为该包配置下列字段（含义与默认值以 README 为准）：
| 字段 | 默认 | 含义 |
|---|---|---|
provider |
"" |
润色请求的 Provider；空则跟随 Session |
model |
"" |
模型 id；空则跟随 Session |
instructions |
空 → 使用 prompts/polish.md |
定义「润色」含义的系统指令 |
maxInputChars |
8000 |
单次润色接受的最长草稿字符数 |
maxOutputTokens |
2000 |
向模型请求的输出 token 上限 |
temperature |
0.3 |
采样温度 |
默认指令仅存在于包内 prompts/polish.md；构建时复制进包，Host 在激活时读取。若该文件缺失或为空，插件会明确报错并拒绝激活，而不会无规则静默运行。可在插件行设置 instructions 覆盖默认文件。
安装与启用¶
包发布在 npm；通过 DSH CLI 安装到 web profile 的示例命令如下（须与官方 README 一致）：
dsh plugin --profile web add @saoutax/dsh-prompt-polish
也可使用 Releases 中的 .tgz 或本地目录作为安装目标，便于离线安装或本地开发。插件以当前 dsh 进程权限运行，安装前应查阅源码与许可证（本插件代码为 MIT；构建时从 Lucide 生成的图标素材为 ISC）。
典型用法¶
- 在 web profile 安装并启用插件后，打开带 Composer 的会话。
- 在输入框撰写或粘贴草稿；若含
@file、@session或命令芯片，按平时方式插入。 - 点击工具栏润色按钮（或使用上述快捷键），等待原地替换完成。
- 若 8 秒内不满意，再次点击按钮撤销；满意则照常发送或继续编辑。
对带 /plan 的草稿：先写出命令芯片后的任务正文，按钮出现后执行润色；仅命令、无正文时按钮不显示。
适用场景与注意¶
适合需要在 Harness 内快速整理 Composer 措辞、又不想污染 Session 历史的开发者。不适合把润色当作「自动发送」：插件设计就是只改输入框、不提交对话。
社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本包是其中之一。维护者通过 CI 与 release-please 在 main 分支上自动发版至 npm；查阅具体版本与变更请以 GitHub Releases / npm 为准。
结尾¶
@saoutax/dsh-prompt-polish 把 AI 润色收进 Composer 工具栏：原地改写、8 秒撤销、芯片与命令草稿行为与 README 描述一致。需要安装命令与配置细节时，以目录页与仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/Saoutax/dsh-prompt-polish
- GitHub：https://github.com/Saoutax/dsh-prompt-polish
