前言¶
在 DSH 里和模型对话，草稿往往是随口一句：缺背景、缺约束、缺验收标准。自己逐条补全既费时间，也容易在发送后才想起漏项。常见做法是复制到外部工具里改一版再贴回来，或在系统提示里堆通用规则——前者打断工作流，后者对「这一条消息」的针对性有限。
下面介绍 dsh-prompt-studio（提示词优化工坊）：DeepSeek Harness 的插件，在输入框和发送链路里接入「按风格改写提示词」，支持一键预览改写结果，也支持发送前在宿主侧自动优化且对话记录仍保留原话。
这是什么¶
- 仓库：zywnb-2/dsh-prompt-studio
- 维护者：zywnb-2
- 分类：模型推理（社区目录归类）
- 版本：1.0.0（MIT）
- 定位：给「随手说的一句话」套上选定风格，改写成模型更容易一次做对的提示词；风格可在设置页增删改，内置 7 套风格。
插件分宿主半区（配置、模型调用、agent/pre-step）与浏览器半区（输入框控件、设置页），两条优化路径共用同一套 optimizePrompt() 实现。
核心功能¶
输入框一键优化¶
在对话输入框右侧、发送键前增加入口 ✦ 优化 ›。展开面板后可：
- 选择风格（单选，每行图标 + 名称）
- 填写「本次额外要求」（可选）
- 开关「发送前自动优化」「参考本项目对话」
- 点击「开始优化」——草稿被替换为改写结果；失败时在面板报错，不破坏原草稿
优化成功后入口旁出现 ↩ 撤销，可回到改写前原文。撤销只在「已改写、尚未发送且输入框非空」时有效；发送或清空输入框后状态会清掉，避免误恢复已发出的内容。
发送前自动优化¶
打开「发送前自动优化」后，每次发送会按所选风格改写送给模型的内容；会话记录里仍显示你的原话。实现挂在宿主 agent/pre-step 瀑布上，在模型请求提交前完成改写。自动优化失败时按原稿发送，并在宿主日志记警告，不阻断本轮对话。
设置页：风格库与优化参数¶
路径：设置 → 提示词工坊。
- 常规：发送前自动优化、自动优化风格、输入框默认风格、是否显示输入框入口、是否保留一键撤销、优化模型（默认可跟随当前默认模型）、温度、最大输出 tokens
- 风格库：每条含名称、图标、说明与「优化指令」；支持启用/停用、排序、复制、删除、新增、恢复内置
- 优化器提示词：全风格共用的框架，支持
{{styleName}}、{{styleInstruction}}占位符
配置写入 $DSH_HOME/prompt-studio/config.json（不写在包目录，避免升级覆盖）。修改风格或开关保存后立即生效；改宿主代码需重启 DSH，改客户端需刷新页面。
内置七种风格（摘要）¶
| 风格 | 用途 |
|---|---|
| 轻润色 | 修错别字、语序、口水话，保持原意与篇幅 |
| 结构化需求 | 规格书：目标 / 背景 / 约束 / 交付物 / 验收标准 |
| 步骤规划 | 带依赖与检查点的执行计划 |
| 领域专家 | 补术语、隐含约束与边界 |
| 视觉风格增强 | 图像 / 3D / UI 类任务的构图、材质、氛围等 |
| 验收标准 | 在保留原需求上补齐可验证完成定义 |
| 硬邦邦 | 直给、动员式口吻，保留原稿事实 |
项目上下文（可选）¶
面板与设置中的「参考本项目对话」控制优化时是否读取当前项目已有对话作为 【参考上下文】。有预算与过滤规则（如最近消息条数、单条字数上限）；读不到会话时静默降级为无上下文路径，与未开启时行为一致。默认开启。
改写时在用户保存的基底提示词后追加共享改写约束（短请求保持短、保留否定与范围、不编造等），同一次模型调用内完成，不额外多调一轮模型。
安装与启用¶
系统要求（README 已写明）：Windows 10/11；DSH 桌面版 0.2.0-rc.2；从 GitHub 安装需联网；运行时无需单独安装 Node（插件使用 Node 内置模块）。macOS / Linux 未在文档中声明已测。
本包尚未发布到 npm，请勿在「包名或地址」中只填 dsh-prompt-studio。
方式 A（推荐）：DSH 界面¶
- 打开
设置 → 插件 → 添加插件 - 在「包名或地址」粘贴（保留
#v1.0.0）：
github:zywnb-2/dsh-prompt-studio#v1.0.0
- 点「安装」，出现
application: applied后重启 DSH（宿主半区新代码需完整重启才加载）
安装位置示例：%USERPROFILE%\.dsh\profiles\<profile>\node_modules\dsh-prompt-studio\（若设置了 DSH_HOME 则对应其下 profiles）。
方式 B：命令行¶
dsh plugin --profile desktop add github:zywnb-2/dsh-prompt-studio#v1.0.0
个别 DSH 版本若不认 add，可改用 install。
升级：插件页卸载旧版，用新 tag 重新安装，再重启 DSH。目录页：SkillHub 插件条目。
典型用法¶
先改再看再发¶
- 在输入框写好草稿，例如一句图像生成需求
- 点
✦ 优化 ›，选「视觉风格增强」或「结构化需求」 - 可选填「本次额外要求」，点「开始优化」
- 确认改写结果，不满意点
↩ 撤销或再选风格重试 - 满意后正常发送
发送前自动优化、记录留原话¶
- 在面板或
设置 → 提示词工坊打开「发送前自动优化」 - 设置「自动优化风格」
- 之后每次发送：模型收到改写版，对话列表仍显示你输入的原文
自定义风格¶
在 设置 → 提示词工坊 → 风格库 新增条目，填写「优化指令」；在「优化器提示词」里调整全局框架。内置风格删尽后可一键恢复。
适用场景与注意¶
适合谁：经常在 DSH 里写需求、改 prompt、希望少切换外部工具；需要结构化规格、步骤计划、验收标准或视觉类 prompt 扩写的开发者。
架构与隔离（文档说明）：零运行时 dependencies；不依赖其它插件；配置与命名空间带 prompt-studio / dsh-ps- 前缀。可选服务（如 locale、remote）缺失时防御式降级，不因装配失败拖垮同排插件。
安全与信任：插件以当前 DSH 进程权限运行，优化请求会调用你配置的模型 Provider；安装前请阅读 源码与 LICENSE，确认改写内容与上下文读取范围符合你的合规要求。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。
版本绑定：提示词工坊 1.0.0 对应 DSH 0.2.0-rc.2；换其它 DSH 版本可能因接口变化失效。
结尾¶
dsh-prompt-studio 把「多风格改写」收进输入框与发送前链路：一键优化便于预览，自动优化便于日常发送且不失真原话记录，风格库与优化框架可在设置页长期维护。
- 目录页：https://www.skillhub.cn/plugins/zywnb-2/dsh-prompt-studio
- GitHub：https://github.com/zywnb-2/dsh-prompt-studio
- 安装规格：
github:zywnb-2/dsh-prompt-studio#v1.0.0
