前言¶
在 DeepSeek Harness（DSH）里写提示词，常见做法是直接交给模型「润色一遍」。输出往往更流畅，但未必按 role / task / context / constraints / output format 这类 Agent 流水线组织，后续在 composer 里复用、迭代也不直观。
下面介绍社区插件 提示词工坊（dsh-prompt-lab，维护者 xueccci）。它在 DSH Web 输入栏提供 优化 入口：先用规则或可选 LLM 把当前草稿改写成可执行的 Agent 结构，再在确认弹窗里对照原稿、看五层诊断与输出分，由你决定是否写回 composer。本地规则可离线工作；需要精修时可走 hybrid、仅 DSH 或 OpenAI 兼容的云端 API。
这是什么¶
dsh-prompt-lab 是面向 DeepSeek Harness 的 Agent 结构化提示词优化插件，分类上属于模型推理相关能力。它解决的是：把 composer 里的零散草稿，整理成带角色、任务、上下文、约束与输出格式的结构化提示，并在写回前给你明确的确认步骤。
插件为 MIT 许可的独立社区项目，与 DeepSeek AI 无隶属关系。安装与能力说明以 GitHub 仓库 与 SkillHub 目录页 为准；SkillHub 为独立插件目录站点，并非 DeepSeek 官方应用商店。
环境要求： DSH >= 0.2.0-rc.2（Typert 严格 codec 需 create() 工厂；模型元数据经 llm.resolveModelInfo() 读取）。
核心功能¶
与普通「润色」的差异¶
| 通用润色类插件 | dsh-prompt-lab | |
|---|---|---|
| 方法 | 让模型重写一次 | 先做 Agent 阶梯 结构化 |
| 模式 | 多种策略标签 | 普通优化 / 精简 / 扩写 |
| 离线 | 通常依赖模型 | 本地规则 可产出结构化结果 |
| 确认 | 静默写回 | 弹窗 + 分数 + 显式操作 |
| 失败 | 硬失败 | 降级本地，黄条提示 |
三种模式¶
- 普通优化：改写成 Agent 结构（role / task / context / constraints / output format）。
- 精简：提取主干——核心任务、硬约束、交付物。
- 扩写：只细化用户在原稿中点名的需求。
四种引擎¶
| 引擎 | 行为 |
|---|---|
| 仅本地 | 离线规则，不调用模型，草稿不出本机 |
| hybrid（默认） | 本地骨架 → 当 provider 与 model 可解析时再经 DSH 精修 |
| 仅 DSH | 优先 DSH；无模型或失败时降级本地 + 黄条 |
| 云端 API | OpenAI 兼容 HTTP（DeepSeek 或自定义）；失败同样降级本地 + 黄条 |
hybrid / 仅 DSH / 云端 API 会把草稿与本地骨架发给所配置的模型服务商；仅本地模式数据留在本机。
请求超时：idle 15s / 总计 60s。
确认弹窗¶
点 优化（或 Ctrl/Cmd+Enter）后，弹窗展示原稿、结果、五层 chips 与输出分。左侧原稿可编辑。
| 操作 | 行为 |
|---|---|
| 继续优化 | 对当前左侧原稿再跑一轮（与入口「优化」相同逻辑） |
| 回填输入 | 右侧结果填入左侧原稿，便于二次编辑 |
| 采用 | 左侧原稿写回 composer，toast「已写入」；仅当 composer 原草稿未被改动时写回 |
| 复制 | 复制右侧结果到剪贴板 |
| 取消 / Esc / × | 不修改 composer 草稿 |
安装与启用¶
在已安装 DSH 且使用 web profile 的前提下，按 README 安装固定版本：
dsh plugin --profile web add github:xueccci/dsh-prompt-lab#v0.2.0
重启该 profile 的 Web 进程，浏览器内 Ctrl+Shift+R 强刷。Linux 下可用下面命令确认插件已载入（Windows 文档示例为 findstr，可按环境改用 grep）：
dsh --profile web --dump-config | grep dsh-prompt-lab
成功后，composer 输入栏左侧应出现 优化 按钮。
典型用法¶
- 在 composer 输入栏写好草稿。
- 点击 优化，或按
Ctrl/Cmd+Enter。 - 在弹窗中查看原稿与结果；可在左侧编辑，或 继续优化、回填输入。
- 确认无误后点 采用，将左侧内容写回输入框（composer 草稿未变时生效）。
在 设置 → 提示词工坊 中可调整：
- 引擎：仅本地 | hybrid（默认）| 仅 DSH | 云端 API
- 模式：普通优化 | 精简 | 扩写
- 云端 API：Base URL / Key / 模型，含测试连接
- 推理行为：自循环、快捷键（默认开启）
- 关于：维护者与插件信息
云端 API 的 Key 保存在浏览器 localStorage，不会写入工作区文件。
适用场景与注意¶
适合： 经常在 DSH Web composer 里写 Agent 类提示、希望统一五段结构、又需要在写回前人工把关的开发者。
注意：
- 插件随当前 DSH 进程权限运行；安装前建议阅读 源码 与 MIT 许可证（见仓库
LICENSE、NOTICE）。 - 非本地引擎会向配置的服务商发送草稿与骨架；敏感内容请优先 仅本地，或自建可控的云端端点。
- 精修失败时仍会给出本地结构化结果，留意界面黄条说明。
DSH 生态强调「一切皆插件」；本插件当前 package 版本为 0.2.0，GitHub 星标数为 3（以目录页与仓库页面为准）。
