前言¶

在 DeepSeek Harness（DSH）的 Web 端写提示词时，草稿可能已经包含任务、文件和目标，但仍需要整理成更适合模型理解的表达。已有做法通常是在另一个窗口手动改写，或临时拼接 system prompt。dsh-prompt-polish 把这一步放进 composer：在 Web 输入框工具行添加 ✨ 按钮，选择一种重写风格后，调用当前已连接的 LLM 重写草稿，并用结果替换原草稿，方便发送前审阅。

插件定位¶

这是一个 DSH 客户端插件，由 JoukoPuro 维护，许可证为 MIT。它适用于 DSH Web profile 场景，要求 @deepseek-ai/dsh web profile 运行，并且已配置模型适配器（例如 DeepSeek provider 带 API key）。插件在 DSH 进程内工作，不要求额外部署独立服务；由于它会以当前 dsh 进程权限运行，安装前应先检查源码与许可证。

核心功能¶

• 在 Web composer 工具行添加 ✨ sparkle 按钮；按钮仅显示图标，完整说明通过 tooltip 提供。
• 提供 balanced、concise、detailed、code-oriented 四种重写风格。
• 菜单文案跟随浏览器语言，支持 zh, en, ja, ko, fr, de, es, pt, ru, it, tr, vi，回退英语。
• 使用当前连接的模型：未配置显式路由时，解析 agentDefaultModel.currentSelection()；也可通过显式 provider/model 配置指定。
• 注册 POST /prompt-polish 接口，并通过 ctx.llm 流式完成一次 LLM 重写。
• 用重写结果替换草稿，便于发送前审阅。

安装与启用¶

1、确认当前 DSH 的 web profile 已能连接模型，例如已配置 DeepSeek provider 和 API key。

2、在插件检出目录或包含 ./dsh-prompt-polish 的目录执行：

dsh plugin --profile web add ./dsh-prompt-polish

3、重启 Web 服务，让 profile 加载新增 bundle：

dsh web

4、打开 Web UI，在输入框输入草稿，点击 composer 工具行的 ✨ 按钮，选择需要的重写风格。

可选配置¶

插件在 profile 的 cordis.patch.yml 中接受 prompt-polish 的可选项。已核实的配置项包括：

• provider：显式路由，可选。
• model：显式模型，必须与 provider 配对。
• style：默认重写风格，可选 balanced、concise、detailed、code-oriented。
• maxTokens：重写调用的输出上限。
• system：自定义重写指令，替换内置的按风格提示。

如果未配置 provider/model，插件会使用 agentDefaultModel.currentSelection()，也就是当前会话使用的默认模型。配置示例中的具体 provider、model 名称需要按当前 DSH 环境填写；这里不给出未在已核实事实中出现的固定值。

工作机制¶

插件分为宿主端和浏览器端。

• 宿主端 lib/index.js：在 Web 服务端注册 POST /prompt-polish，并通过 ctx.llm 流式完成一次 LLM 重写。
• 浏览器端 lib/client.js：在 composer 工具行注册 ✨ 按钮，打开风格菜单，提交草稿，并用润色后的文本替换原草稿。

浏览器端是手工构建的 closure-factory 产物，外部依赖限于 react 和 @deepseek-ai/dsh-client-ui-primitives。插件的 peerDependencies 包含 @deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-llm ^0.1.0-rc.6、@deepseek-ai/dsh-agent ^0.1.0-rc.6。

本地验证¶

在改动正式 profile 前，可以先用临时端口验证插件是否加载：

dsh web --port 3099
curl -s http://127.0.0.1:3099/plugins/dsh-prompt-polish/client.js | head

也可以直接调用重写接口，验证请求路径和参数：

curl -s -X POST http://127.0.0.1:3099/prompt-polish \
  -H 'content-type: application/json' \
  -d '{"text":"read a.csv and sort by b","style":"balanced"}'

上面命令用于检查 /plugins/dsh-prompt-polish/client.js 与 POST /prompt-polish 是否可用；实际 text 和 style 应按自己的草稿填写。

适用场景与注意¶

适合在 DSH Web 端编写或审阅提示词的使用者：已有模型适配器，希望在发送前快速整理草稿，并保留审阅步骤。不适合未配置模型适配器，或需要完全脱离当前 dsh 进程权限运行的场景。

安装前请注意：

• 插件以当前 dsh 进程权限运行，安装前检查源码与许可证。
• 显式 model 必须与 provider 配对。
• 许可证为 MIT。
• DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应描述为官方应用商店。

结尾¶

dsh-prompt-polish 的价值在于把“发送前重写提示词”收敛到 composer 工具行内的一个可审阅动作：使用当前已连接模型，支持多种风格，并用重写结果替换草稿，而不是直接发送。

GitHub 地址：https://github.com/JoukoPuro/dsh-prompt-polish

已核实资料未提供可用的社区目录页 URL；如需从目录查找，请以目录站点的实际页面为准。