前言¶
在 DeepSeek Harness(DSH)里写发给智能体的提示,常见做法是先在输入框里打一段草稿,再手动拆成角色、任务、上下文。草稿往往偏口语或缺结构,改一版又要复制到外部工具里做「提示词优化」,改完再贴回来,多一步且容易和会话上下文脱节。
下面介绍的是维护者 Stijnus 发布的 DSH 插件:npm 包名为 dsh-prompt-rewrite,GitHub 仓库名为 dsh-prompt-optimizer。它在 Composer 发送按钮旁增加 Optimize prompt 控制,用当前会话已路由到的模型把草稿改写成结构化提示,流式展示在输入区上方的面板里;只有你点击 Use 才会替换草稿,不会自动把改写结果当作一轮对话发给智能体。
这是什么¶
该插件面向 DSH Web 客户端(--profile web),在 Settings → Plugins 中显示为 Prompt Optimizer。改写逻辑不自行实现,而是复用 npm 包 oss-prompt-optimizer 的引擎;插件自身负责 Host 路由、超时、SSE 流式返回,以及 Client 侧的按钮与面板。
与「直接把优化后的内容当作用户消息发送」不同:点击优化时不会向 Agent 发送改写结果;改写请求走 POST /prompt-optimizer/optimize,且插件说明其不会写入 Session log。输出语言默认跟随草稿(outputLanguage: 'auto')。
核心功能¶
Composer 上的优化流程¶
- 在输入框写好草稿(例如 README 建议的 “Build a task list for my team”)。
- 点击发送按钮旁的 Optimize prompt(界面文案带 ✨ 标识)。
- 在 Composer 上方 dock 面板中流式查看改写结果。
- 面板提供 Use、Undo、Copy、Close:
- Use:用改写结果替换当前草稿;Undo 可恢复点击 Use 之前捕获的草稿。
- Copy:单独复制改写结果,不替换草稿。
- 在未点击 Use 前,草稿不会被自动替换。
改写使用与会话下一 turn 相同的路由模型;调用模型可能产生提供商费用,README 明确说明这不会把改写后的草稿作为对话 turn 发送。
三种 Prompt 风格¶
在 Settings → General → Prompt style 中选择输出形态;该选项按浏览器保存覆盖值。Profile 可为所有客户端设默认,例如在插件 Config 中:
- id: prompt-optimizer
name: 'dsh-prompt-rewrite'
config:
outputStyle: sections
在浏览器未改选前,界面展示 Profile 默认;浏览器内的覆盖优先于 Profile。结果面板会标明本次输出所用的 style。
| Style | 输出形态 |
|---|---|
plain(默认) |
连续正文,无标题分段。 |
sections |
使用 ## Role / ## Task / ## Context / ## Format 等标题。 |
role-task-goal |
使用 Role: / Task: / Goal: 标号行。 |
安装与启用¶
官方安装命令(来自 README):
dsh plugin --profile web add dsh-prompt-rewrite
安装后重启 Harness,或刷新 Web UI。Composer 发送按钮旁应出现 Optimize prompt。
兼容性(资料原文):DSH >=0.2.1-rc.3 <0.3.0-0,Node >=20。当前 npm 版本为 0.2.5,许可证 MIT。
除命令行安装外,插件也出现在 Stijnus 维护的 Market 索引中(例如仓库内的 market-index.json);Host 对每个 Market URL 缓存约 10 分钟,新版本可能在已打开的市场面板里延迟可见。
典型用法¶
经过上面的安装步骤后,可按 README 的本地 walkthrough 自测:
- 在 Composer 输入一句简短需求草稿。
- 点击 Optimize prompt,等待流式输出完成。
- 若满意,点 Use 替换草稿后继续编辑或发送;若仅作参考,点 Copy;若已 Use 且想回退,点 Undo。
具体改写内容与所选 Prompt style、会话模型有关;README 说明这是建议的本地步骤,而非固定演示录像。
适用场景与注意¶
适合谁: 经常在 DSH Composer 里写提示、希望在一键预览结构化改写后再决定是否替换草稿的开发者;需要 plain、sections 或 role-task-goal 多种输出形态时,可通过设置或 Profile 配置切换。
运行与权限: 插件以当前 DSH Host 进程权限运行,改写请求会调用会话路由到的模型。安装前应阅读 GitHub 仓库 源码与 MIT 许可证,确认行为符合你的环境与合规要求。
名称区分: 安装与 npm 依赖请使用 dsh-prompt-rewrite;GitHub 仓库名 dsh-prompt-optimizer 不是 npm 包名。
生态说明: DSH 采用「一切皆插件」的扩展方式;社区插件目录(如 SkillHub 上的条目)为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-prompt-rewrite 把提示词改写收进 Composer:流式预览、显式 Use / Undo、三种输出风格,并复用 oss-prompt-optimizer 引擎。若需安装说明与实现细节,见 GitHub README 与 SkillHub 目录页。