ClockworkParrot/dsh-prompt-optimize ↗★ 0
dsh-prompt-optimize
DSH Web UI 原生插件:在输入框发送按钮左侧提供「优化提示词」按钮,用当前会话的模型路由原地改写草稿,一次撤销即可还原。
同名包的其他仓库
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ClockworkParrot/dsh-prompt-optimize说明文档
阅读完整 README ↗配置
Host 与 Client 读同一份 Config schema,默认值直接写在 schema 里,因此
apply(ctx, config) 拿到的就是「用户值或默认值」。在设置里改完立即热替换,无需重启。
设置页
插件在 设置 → 通用设置 → 提示词优化 贡献自己的一行(settings.general.item,id
prompt-optimize,order 5)。这一行直接编辑本插件 Config 的全部六个字段,带 保存 和
恢复默认 按钮,并额外提供:
- Provider / 模型下拉框,选项来自
ctx.remote.session.modelCatalog()——部署已知能连通的 provider 与模型清单。选 provider 之后模型下拉才启用。 - 推理强度下拉框,仅当所选模型声明了可选强度时出现。
- 目录加载失败或尚未就绪时,下拉框自动退化为文本框,可以手填任意 provider/model id。
几个实现细节:
- 这一行通过共享设置镜像(
ctx.configForms)读写,键是本插件的设置命名空间prompt-optimize——也就是cordis.patch.yml里的 Loader 行 id,这是设置文档给 entry 命名的 方式(entry.options.id),不是带前缀的include:…。Host 文档始终是事实来源,所以你手改 profile patch 后,下一次 describe 会在行里同步显示。 - 「恢复默认」是清空字段,而不是把默认值写回去。清空后字段直接读 schema,profile patch 里只留你真正选择过的值。
- 行由
ctx.inject(['slots', 'configForms', 'remote', 'remote.session'], …)注册;万一某个部署 没有 settings 域,还有一条兜底注册,让这一行以「当前无法读取这项配置」的状态出现,而不是 整行消失。 - schema 里三个基础字段带
.volatile(),这不只是热替换通道,还是这一行能存在的前提:settings.describe()只投影 volatile 字段(volatileForm),没有 volatile 字段的 schema 不会 暴露命名空间,那一行就永远不会被服务。apply()随后拿到的是活的{ get() }引用,resolveOptions()在每次点击时读取。 - 值在离开页面前校验:占位符非空且不超过 64 字符,超时是 1000…2147483647 的整数。值非法时 保存按钮禁用,并在按钮下方给出原因。
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
datePlaceholder | string | {{DSH}} | 草稿中提到日期/时间的位置替换成的文本。 |
replaceMode | 'replace' | 'append' | 'replace' | 原地写回;或保留草稿,空一行后追加优化结果。 |
timeoutMs | number(1000…2147483647) | 30000 | 单次模型调用的端到端超时。 |
provider | string | '' | 固定 provider 路由。留空则跟随会话自己的模型。 |
model | string | '' | 固定模型 id。provider 未设时忽略。 |
reasoningEffort | string | '' | 固定路由下的推理强度。留空则跟随路由。 |
provider 与 model 是一对:两个都填才固定路由,两个都空则跟随当前会话(取不到时回退部署
默认)。半填的组合会被设置页拒绝,因为它实际上固定不了任何东西。
插件从不接收 base URL 和 API Key,也从不存储它们:鉴权始终留在 ctx.llm 背后那层 provider
适配器里。如果某个 provider 的目录加载失败,设置页会说明原因,固定路由字段在那里改不了,
但 patch 文件仍接受任何 Host 认的标识符。
也可以在 profile patch 里直接固定:
- id: prompt-optimize
name: dsh-prompt-optimize
config:
datePlaceholder: '[[DATE]]'
replaceMode: append
timeoutMs: 20000
provider: deepseek-account
model: deepseek-flash