前言¶
在 DeepSeek Harness（dsh）里写 Composer 会话时，草稿往往偏口语、缺结构，改几轮才像样。WorkBuddy 等产品在输入区内置「提示词优化」，dsh 桌面端默认没有同等入口。社区插件 dsh-prompt-polisher（维护者 yuluo554）在聊天输入框工具行增加「优化提示词」按钮：读取当前草稿，经模型改写后回填，仍可继续编辑或还原。下文按安装、配置与日常使用说明其能力边界。
这是什么¶
dsh-prompt-polisher 是面向 dsh web profile 的桌面端插件，npm 包名 dsh-prompt-polisher，当前版本 0.2.0（MIT）。分类上属于「模型推理」：核心是把输入框草稿交给模型做改写，而不是改会话路由或工具链。
交互形态对标 WorkBuddy 内置提示词优化；按钮图标自绘。插件通过 Cordis patch 挂载到 conversation.input.right，并在 conversation.input.dock 提供状态与还原入口。
核心功能¶
一键优化与还原¶
点击按钮后流程为：读取当前草稿 → 模型改写 → 结果写回输入框。原文保存在插件态，状态条提供两个入口：
- 还原上一步：回到本次优化前的草稿。
- 还原首次：回到本会话第一次优化时你手打的草稿。
双模型通路¶
默认走会话模型：使用 dsh workflow 引擎的 agent() 单代理，零额外配置即可用。安装后插件会把 workflow 引擎（workflow-ptc）从 web profile 默认禁用中启用，这是会话模型通路的前提。
也可在设置中配置 OpenAI 兼容独立 API（Base URL、模型、密钥）。开启且配置完整时，优化优先走独立 API；关闭或未配置则走会话模型。API 调用失败不会静默降级到会话模型，界面会提示错误，可据此切回会话通路。密钥只存宿主侧，不下发到浏览器。
风格预设与自定义模板¶
内置两种风格，可在按钮旁菜单切换，选择会写入 localStorage 作为默认：
concise：精炼明确。structured：结构化增强。
设置里可为每种风格填写整段自定义模板，必须包含 {draft} 占位符；无效模板会自动回退内置提示词。
竞态保护与引用安全¶
优化请求进行中若你继续打字，回填前会弹出 「替换 / 放弃」，避免静默覆盖新输入。切换会话会自动取消在途请求。
草稿含 @ 或 / 引用（引用 chips）时禁用优化，因改写会破坏引用记号。草稿 trim 后少于 8 个字符时同样禁用。
安装与启用¶
要求 dsh ^0.2.0-rc.1（0.2.x，含预发布）；门槛由 package.json 的 peerDependencies 表达，不满足时 dsh 会拒绝加载。README 已验证版本：0.2.0-rc.1、0.2.1-rc.2；0.3 不在本版本支持范围。
在终端执行官方安装命令：
dsh plugin --profile web add dsh-prompt-polisher
插件以当前 dsh 进程权限运行。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。
配置¶
路径：Web 设置 → 插件 → Prompt Polisher。字段均为 volatile，修改后免重启即时生效（每次优化现读配置）。
| 字段 | 说明 |
|---|---|
| 启用独立 API | 开启后优化优先走独立 API；关闭/未配置走会话模型 |
| API Base URL | OpenAI 兼容端点，默认 https://api.deepseek.com（自动补 /chat/completions） |
| API Key | 密码框留空表示保持已存值；宿主侧存储，跨 wire 剥除 |
| Key 环境变量名 | 备用凭据，默认 DEEPSEEK_API_KEY（credentials 服务 → 进程环境） |
| 模型 | 默认 deepseek-chat |
| 自定义模板 ×2 | 覆盖 concise / structured 内置提示词，须含 {draft} |
| 客户端诊断上报 | 浏览器侧插件故障上报到宿主日志（不出本机），默认开启 |
典型用法¶
- 在 dsh web 界面打开 Composer 会话，在输入框写好草稿（不含
@//引用，且 trim 后不少于 8 字符）。 - 在工具行点击「优化提示词」；需要时在按钮旁菜单选
concise或structured。 - 等待改写完成，检查回填内容，继续编辑或发送。
- 若优化过程中又改了输入，在弹窗中选「替换」或「放弃」。
- 若要独立 API：在设置中开启「启用独立 API」，填 Base URL、模型与密钥（或配置环境变量），保存后再点优化。
非环回连接（远程访问本机 GUI）下，配置为内存模式，不可持久保存。
适用场景与注意¶
适合：经常在 dsh 里写长提示、希望快速整理语气与结构，且已使用 dsh 0.2.x web profile 的开发者。
注意：
- 风格预设与错误码、模板 id 为冻结契约，目前仅
concise/structured两档。 - 含引用 chips 或过短草稿无法优化，需先去掉引用或补全内容。
- 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，安装第三方插件前请自行评估信任边界。
