前言¶
在 DSH（DeepSeek Harness）里和 agent 协作时，写给模型的指令、要发出的消息，经常写着写着就不太通顺。常见的做法是另开一个会话，把草稿粘过去让模型改写，再复制回来——切来切去，步骤不少。
@max-null/dsh-draft-polish 把这一步收进了输入框：发送按钮左侧有一个 ✨ 按钮，点一下就调用 LLM 润色当前草稿，结果直接回填输入框。润色不创建会话、不写入历史，会话正在输出时也照常可用。下面按功能、安装、用法、设置的顺序介绍这个插件。
这是什么¶
一句话定位：面向 DeepSeek Harness 的草稿润色插件。维护者是 Max-Null，属于 @max-null/* 插件系列、SSID（思灵 · Seek Soul in Darkness）桌面体验的组成部分，从分形（OC 桌面壳）的同类功能迁移进化而来。当前版本 0.2.3，许可证 MIT。
DSH 的理念是「一切皆插件」，润色这种挂在输入框旁边的小工具，正适合以插件形式接入，而不是塞进内核。
核心功能¶
已核实的能力有六项，逐条说：
- 一键润色：发送按钮左侧的 ✨ 按钮，点击后 LLM 润色草稿，结果回填输入框。输入为空时按钮不触发。
- 会话进行中可用：润色走 DSH
llm渠道，与 agent 会话调度解耦，会话正在输出时照常润色。这一点是相对 OC 桌面壳旧版本的改进。 - 携带会话上下文：默认把最近 4 条对话作为背景上下文带给模型，帮助理解你这段草稿的意图；不需要时可以关闭。
- 复用现有模型渠道：默认继承当前会话的渠道，不需要单独配 API Key；也可以单独指定 provider 和 model。
- 零污染：润色不创建会话、不写入历史，只改输入框里的草稿。
- 按会话隔离：每个会话的输入框独立。润色进行中切换到别的会话，结果仍写回发起润色的那个会话。
安装与启用¶
先做安装。官方方式是把插件加进指定 profile：
dsh plugin --profile <name> add @max-null/dsh-draft-polish
也可以手动加入 profile 的 package.json dependencies 和 dsh.profile.bundles：
- id: draft-polish
name: '@max-null/dsh-draft-polish'
版本与兼容性：0.2.2 及以上适配 DSH 0.1.2-alpha.2+（当前 0.2.3 属于这一档）；0.2.1 及更早版本适配 0.1.1-rc.2。安装前先确认自己的 DSH 版本。
典型用法¶
经过上面的步骤，插件启用后即可使用。日常润色的完整流程是四步：
- 在输入框里写草稿；
- 点发送按钮左侧的 ✨ 按钮（输入为空时按钮不触发）；
- 等待数秒，润色结果自动替换输入框内容，按钮转圈表示润色中；
- 检查结果，满意后照常发送。
设置¶
设置页 → 左栏「润色设置」条目（DSH 0.1.2-alpha.2 起，配置命名空间 draft-polish）。主要配置项与默认值如下：
| 配置 | 默认值 | 说明 |
|---|---|---|
provider |
'' |
润色模型渠道，留空继承当前会话渠道 |
model |
deepseek-v4-flash |
润色用的模型 |
reasoningEffort |
off |
思考强度，润色场景用 off 最快 |
budgetTokens |
1024 |
输出 token 预算 |
temperature |
0.3 |
低随机性，保住原意 |
timeoutMs |
30000 |
超时兜底 |
contextEnabled |
true |
是否携带会话上下文 |
recentWindowMessages |
4 |
作为上下文的近期对话条数 |
只改想改的项即可，默认值覆盖多数场景。
权限与安全¶
装进自己的环境前，值得先弄清它碰了什么：
- 网络：client 半端只通过同源相对路径
/draft-polish/api/*访问当前 DSH 进程内的 host JSON API（本机），不请求任何外部 URL、不上传数据、无遥测。 - 凭证：插件不持有 API Key，润色调用经 DSH
llm渠道，复用你已配置的模型渠道与凭证。 - 依赖：运行时零外部 npm 依赖（schemastery 已内联进
lib/index.js）；peer 依赖只有 DSH 官方服务与 react，由 DSH 运行时提供。 - 文件系统：不读写任何文件，唯一的持久状态是
draft-polish设置命名空间，由 DSH settings 服务管理。
失败时也不吞草稿：host API 不可用 → 提示错误、草稿不变；LLM 调用失败 → 原草稿保留并提示，默认 30 秒超时；上下文读取失败 → 降级为不带上下文润色，不中断。
需要提醒：插件以当前 dsh 进程的权限运行，安装前建议检查源码与许可证（本项目为 MIT），确认没有超出预期的行为。
适用场景¶
适合这几类情况：经常在 DSH 里给 agent 写指令、发消息，希望发出去之前把措辞理顺；会话经常长时间运行，不想为了润色一段话专门另开会话；在意会话历史保持干净，不希望润色过程留下痕迹。多会话并行使用也没问题，按会话隔离的机制保证结果写回正确的输入框。
小结¶
@max-null/dsh-draft-polish 把「润色一段草稿」从切会话、粘贴、复制，简化成点一下按钮：调用复用 DSH 现有模型渠道，不建会话、不写历史，失败也不丢草稿。如果你的日常工作重度依赖 DSH 输入框，可以按上面的步骤装上试一试。
插件目录页：https://www.skillhub.cn/plugins/Max-Null/dsh-draft-polish
GitHub 仓库：https://github.com/Max-Null/dsh-draft-polish
说明一句：skillhub 是社区维护的独立插件目录，与 DeepSeek、幻方没有官方从属关系。
