前言¶
在 DeepSeek Harness(DSH)里跑智能体,输入框里往往先是一段口语化的草稿:意图有了,但结构、约束和上下文经常不齐。自己手工扩写成「给模型看的」提示词既费时,也容易漏掉关键字段。社区里已有类似「增强提示词」的交互参考;@amyaxy/dsh-prompt-boost-model 面向 DSH Web GUI 做了一套独立实现,并支持在设置里选择用哪条模型路由完成改写,而不是只靠两个自由文本框拼 provider / model。
下面介绍这个插件的定位、能力与安装用法。事实以 GitHub 仓库 README 与 package.json 为准;生态目录见 SkillHub 插件页。DSH 的社区插件目录与 DeepSeek / 幻方无官方从属关系。
这是什么¶
- 名称:
@amyaxy/dsh-prompt-boost-model(npm 包名,仓库 amyaxy/dsh-prompt-boost-model) - 维护者:amyaxy
- 分类:模型推理(SkillHub 归类)
- 版本(资料中明确):
0.1.1,许可证 MIT;要求 DSH>=0.2.0-rc.2 - 一句话:在 Web 输入框把当前草稿改写为更结构化的提示词,预览确认后再回填;增强所用模型可在设置中选择。
核心功能¶
输入框与快捷键¶
| 位置 | 行为 |
|---|---|
| 输入框右侧「增强」按钮 | 把当前草稿改写为结构化提示词,先预览,确认后才回填 |
快捷键 Ctrl + Alt + B |
同上 |
改写结果仅在用户确认后替换草稿,并保留「撤销」入口,原始草稿不会丢失。README 写明实现参照 WorkBuddy 的增强提示词体验,为本插件独立实现的一套轻量方案。
设置页:增强提示词¶
路径:设置 → 增强提示词。可配置项包括:
- 勾选启用
- 选择增强所用模型(分组下拉框)
- 温度、输出上限、超时
- 自定义指令(
systemPrompt)
模型下拉框与路由¶
与「两个自由文本输入框拼模型 id」的做法相比,本插件在设置页渲染真实的 <optgroup> / <option>,数据来自宿主当前模型注册表(示例结构见 README:按提供商分组,选项同时显示友好名与模型 id)。
- 列表由宿主聚合
llm.listProviders()与llm.listConfigurableProviders(),尚未配置但可激活的提供商也会出现在列表中 - 选择「跟随默认模型」时不锁定路由,由宿主默认模型兜底
路由优先级:
- 本插件设置里选定的
provider/model - 宿主默认模型(
agentDefaultModel)
诊断与安全¶
- 模型未返回文本时,
finish分块会透出更具体原因(例如适配器失败、推理模型占满输出预算、撞上输出上限等),便于调整maxOutputTokens或换模型 - 增强接口会消耗模型额度,仅在同机同源页面可用:loopback、严格
Host/Origin校验、拒绝代理转发头、请求体与timeoutMs约束(详见 README「安全边界」)
安装与启用¶
官方安装命令如下(勿自行拼接其他 dsh plugin add 形式):
dsh plugin install @amyaxy/dsh-prompt-boost-model
从本地目录安装时,将 <此目录的绝对路径> 换为插件源码所在路径:
dsh plugin install <此目录的绝对路径>
安装后刷新页面即可;cordis.patch.yml 会插入一条 prompt-boost 条目。
典型用法¶
- 在 DSH Web 输入框写好草稿意图。
- 点击「增强」或按
Ctrl + Alt + B,等待模型生成结构化提示词并在预览中查看。 - 确认后回填;不满意可撤销,草稿仍在。
- 在 设置 → 增强提示词 中启用功能,从下拉框选择增强模型,按需调整
temperature、maxOutputTokens、timeoutMs与systemPrompt。
设置在 DSH 数据目录下的独立文件中(非宿主 settings.describe() 表单),路径为 <DSH_HOME>/prompt-boost/settings.json。资料中的字段示例:
{
"enabled": true,
"provider": "trae-enterprise",
"model": "DeepSeek-V4.1-Flash-1017",
"temperature": 0.3,
"maxOutputTokens": 4096,
"timeoutMs": 60000,
"systemPrompt": ""
}
写入采用「临时文件 + rename」的原子替换;读取逐字段校验,损坏时退回默认值。
适用场景与注意¶
适合:经常在 DSH Web 里写长提示、希望一键结构化且能显式选择增强模型的开发者;已配置多提供商、需要从注册表里点选路由而不是手填 id 的环境。
注意:
- 插件在当前 DSH 进程权限下运行,增强调用会走你所选模型的额度与 API 配置;安装前应阅读源码与 MIT 许可证,并知悉上述本地访问边界。
- 本地路径安装的包无法解析
@deepseek-ai/*与react,因此宿主端仅使用node:内置模块、export const inject = [],配置页由浏览器端自绘——这是设计约束,不是功能缺失。 - 引擎要求
dsh >=0.2.0-rc.2,版本不匹配时请先升级宿主。
结构速览¶
package.json # dsh.bundle.patch + dsh.client
cordis.patch.yml # 同时挂载宿主端与浏览器端
lib/index.js # 路由、模型目录、增强调用、设置存储
lib/client.js # 设置页、输入框按钮、预览浮层、i18n
中英文案已内置;label 使用 thunk,切换语言即时生效。
结尾¶
@amyaxy/dsh-prompt-boost-model 把「草稿 → 结构化提示词」收进 DSH Web 输入框,并用宿主模型注册表驱动的下拉框降低选错路由的概率。需要安装命令与配置字段时,以 README 为准。