前言¶
在 DSH 里和模型对话时,很多人习惯先在输入框里写一段口语化的想法,再指望模型「猜对」意图。草稿往往缺背景、缺约束、缺输出格式,来回改几轮才够用。另一种做法是在外部文档里写好完整提示词再粘贴,但和当前会话、当前草稿脱节。
下面介绍社区插件 dsh-prompt-polish(维护者 LMQ00):在 Web 客户端侧把粗糙文本交给模型转写成更规范的提示词,在输入框上方的浮层里预览,用户点「采用」后才写入输入框,且从不自动发送。转写走 Host 私有路由,用户原文与规范结果都不写入会话日志。
这是什么¶
dsh-prompt-polish 是 DeepSeek Harness(DSH)的客户端类插件:分类为客户端,当前 GitHub 星标为 0。一句话定位:把粗糙提示词转写成规范提示词,浮层预览确认后写入输入框(不自动发送)。
仓库:https://github.com/LMQ00/dsh-prompt-polish
社区目录页:https://www.skillhub.cn/plugins/LMQ00/dsh-prompt-polish
实现上分为 Host 半边(index.js,export function apply(ctx))与 Client 半边(client.js,dsh.client.platform = web)。协议为 MIT;package.json 中版本为 0.2.0。
核心功能¶
转写与预览¶
- 支持斜杠命令
/polish,也支持点击输入框工具条按钮(位于模型选择器左侧)。 - 转写结果在输入框上方浮层展示;只有点击「采用」才会替换或写入输入框内容。
- 模型认为信息不足时,最多追问 3 轮;追问选项的形态对齐 DSH 内置提问组件。
- 输出语言跟随输入语言,插件不提供语言相关配置项。
调用方式与草稿行为¶
| 调用 | 使用的粗糙文本 | 输入框草稿 |
|---|---|---|
/polish 帮我写个登录页 |
命令参数文本 | 不改动 |
/polish(草稿非空) |
当前草稿 | 不改动,仅在「采用」时被替换 |
/polish(草稿为空) |
无 | 浮层提示「先写点东西」,不调用模型 |
设计约束(v1)¶
- 从不自动发送:
inputActions.submit未被使用;发送始终由用户自行触发。 - 用户文本不进会话日志:转写在 Host 私有路由
POST /polish/translate完成,粗糙文本与规范提示词都不 append 到 session。 - v1 不声明 Config:
MAX_ROUNDS = 3、TIMEOUT_MS = 60000、模型取ctx.agentDefaultModel,均为index.js内代码常量。
依赖¶
README 说明为零依赖:index.js 无 bare import;client.js 仅通过模块加载器查询 require('react')(浏览器模块表,非 ESM 包解析)。
安装与启用¶
资料中的安装形态为:以 link: 方式挂进 profile web,Loader 行为 include:polish。具体 profile 编辑步骤以仓库内 docs/development.md 为准;搭环境、安装 bundle、确认是否生效,也建议按该文档与 docs/runbook.md 操作。
package.json 中 dsh.client 配置了 platform: web、immediately: true,并向 @deepseek-ai/dsh-client-ui-conversation 注入客户端脚本;bundle 通过 ./cordis.patch.yml 打补丁。
注意:插件在当前 DSH 进程权限下运行。安装或 link 前应自行审阅源码与 MIT 许可证,社区目录站点与 DeepSeek / 幻方无官方从属关系,并非官方应用商店。
典型用法¶
先用参数转写,输入框里原有草稿保持不变:
/polish 帮我写个登录页
无参数时,用输入框当前草稿作为粗糙文本(草稿为空则只提示,不调模型):
/polish
也可不写命令,直接点输入框工具条上的 polish 按钮。预览满意后点「采用」写回输入框,再自行决定是否发送。
仓库自测命令(零依赖,node --test):
npm test
适用场景与注意¶
适合:经常在 DSH Web 里写提示词、希望把口语化需求整理成结构更清晰、约束更明确的版本,且希望在写入前人工确认的人。
不适合或需知:
- 需要把转写过程或结果留存在会话历史里——本插件刻意不写 session。
- 需要改追问轮次、超时、默认模型——v1 无 Config,只能改源码常量或等后续版本。
- 非 Web 客户端环境——插件声明为
web平台客户端能力。
出问题时(例如按钮不见、浮层错位、修改不生效),可对照仓库 docs/runbook.md。
结尾¶
dsh-prompt-polish 把「写规范提示词」收成客户端内一步:命令或按钮触发、浮层预览、采用后写框、不自动发送、不进会话日志。DSH 生态强调「一切皆插件」;若要在 Web 侧打磨提示词草稿,可从目录页或 GitHub 查看说明与源码。