DSH Prompt Polisher：DeepSeek Harness 的原生提示词润色插件

前言¶

DeepSeek Harness (DSH) 采用插件化架构。在调试提示词时，频繁在 DSH 和外部编辑器之间切换会打断工作流。DSH Prompt Polisher 是一个插件，它在 DSH 输入框的发送按钮旁增加了一个原生「润色」按钮，利用当前会话的模型配置直接优化提示词，减少环境切换成本。

它是什么¶

项目名称：siyue-zo/dsh-prompt-polisher

维护者：SiYue-ZO

简介：DeepSeek Harness 的一个安全、原生提示词润色插件。它复用当前会话的配置进行润色，支持冲突检测、会话隔离和隐私保护。

核心功能¶

• 原生按钮：在官方 conversation.input.right slot 中增加「润色」按钮。
• 配置复用：自动读取当前 session 的 provider、model 和 reasoning effort，无需重复配置 API key。
• 交互控制：支持加载、取消、结果预览、失败重试、应用、复制和恢复原文。
• 冲突检测：使用 draft + draftRev 机制，请求期间继续输入不会覆盖结果。
• 会话隔离：每会话独立的 controller、AbortSignal 和 generation guard，避免陈旧响应跨会话写回。
• 上下文控制：默认只发送当前草稿；可选、受限的最近对话上下文。
• 可访问性：支持中英文界面、键盘可访问、主题 token 和 reduced-motion。

安装与启用¶

环境要求：
- Node.js >= 22.19.0
- DSH 0.1.0-rc.7

安装命令：

dsh plugin --profile web add github:SiYue-ZO/dsh-prompt-polisher#v0.1.0

安装后，Web 界面输入框的发送按钮旁将出现「润色」按钮。

配置¶

插件的默认配置位于 bundle 的 cordis.patch.yml。如需覆盖，请在 profile 的 cordis.patch.yml 中按相同 row id prompt-polisher 提供完整 config（注意：DSH 的后层 config 是整体替换，不是深合并）。

默认配置参数：

配置示例：

- patch:
    id: prompt-polisher
    config:
      includeContext: false
      contextMessages: 6
      contextMaxChars: 8000
      customInstructions: '优先把验收标准整理为清晰列表。'

使用流程¶

1. 输入与触发：在 DSH 输入框撰写提示词。空草稿或输入状态不是 plain 时，按钮禁用。点击「润色」后，按钮进入加载状态，此时可继续编辑或点击「取消」。
2. 预览与处理：请求完成后，结果在上方预览，原文保留。点击「应用」可写回输入框；点击「复制」可单独复制结果。
3. 冲突与恢复：
   - 若草稿未变化，点击「应用」直接写回结果。
   - 若草稿变化，按钮明确改为「仍然替换」，防止误覆盖。
   - 若草稿仍等于刚应用结果且 revision 未变化，「恢复原文」按钮可用，点击后恢复至应用前的状态。

隐私与安全¶

• 不存储凭证：插件不接收或存储 API key，模型凭据由 DSH adapter 配置决定。
• 默认隐私保护：includeContext: false 是隐私默认值。开启后只提取最近的人类/模型纯文本，排除工具结果、图片和插件上下文。
• 数据流隔离：草稿只进入 DSH Host 的一次性辅助 LLM 调用，不写入正常聊天 transcript。
• 数据去向：最终数据会发送给当前 DSH 模型 adapter 所连接的服务商。

注意事项¶

• 插件不保证在未来的 DSH 版本中可用，建议固定版本号安装。
• 在生产环境建议将安装命令中的 #v0.1.0 替换为审核过的 commit SHA。

结语¶

该插件通过在 DSH 原生界面中集成润色功能，降低了提示词调试的切换成本，适合需要在本地快速迭代 Prompt 的开发者使用。

项目地址：https://github.com/SiYue-ZO/dsh-prompt-polisher