前言¶
在 DeepSeek Harness(DSH)的 Web 会话里,agent 回合结束后,用户经常要重新输入下一轮提示词。dsh-suggest-prompt 针对这个环节:它在每个 agent 回合完成后,通过一次有界的辅助 LLM 调用写入一条建议的下一条提示词;Web 端将这条建议渲染为输入框内部的浅色幽灵占位文字,默认按 Tab 采纳进草稿。
插件定位¶
它是 DSH 的一个 Web profile 插件,维护者为 studyzy,许可证为 MIT。核心职责是:
- 在回合完成后生成建议提示词;
- 将建议写入会话日志;
- 在 Web 输入框内显示为占位文字;
- 提供可配置的采纳快捷键。
核心功能¶
建议生成¶
每个 agent 回合完成后,插件会执行一次有界的辅助 LLM 调用。默认情况下:
- 继承主请求最近一次记录的路由;
- 发送最后一轮用户输入与 AI 最终回答;
maxRecentTurns默认为1;- 关闭思考,使用
reasoningEffort: off,对应thinking: disabled。
Web 端展示¶
建议会在 Web 输入框内显示为浅色幽灵占位文字。每个完成回合都会生成建议,但幽灵文字只在草稿为空时显示。默认按 Tab 采纳进草稿;也可以将采纳快捷键录制为 Alt+Slash、Ctrl+Enter 等。
可配置限制¶
插件提供字节、令牌、超时上限、转录长度预算和建议可见字符上限等限制。支持显式指定 provider / model,不指定时跟随会话路由。
过滤与跳过¶
发送前会做转录脱敏,输出会做净化与语义过滤。空回复或不合格回复会被静默跳过:不写 suggest-prompt/suggested 事件、投影保持 null、不记录警告。
安装与启用¶
前置条件¶
需要满足以下环境:
- Node.js
^22.19或>=24 pnpm- 基于
deepseek-harness的dsh部署,且使用 web profile dsh ≥ 0.1.1-rc.1- 浏览器端提供
conversation.input.overlay槽位与inputActions.setDraft
从 GitHub 安装¶
推荐先使用 GitHub 仓库安装:
dsh plugin --profile web add git@github.com:studyzy/dsh-suggest-prompt.git
安装完成后,重启正在运行的 dsh web 服务。
如果 pnpm ≥10 在 git 安装时拦截 prepare 构建脚本,需要把 pnpm 打印的包键加入:
~/.dsh/profiles/web/pnpm-workspace.yaml
的 allowBuilds,然后重新执行安装命令。
本地源码安装¶
如果本地已有源码目录:
dsh plugin --profile web add /path/to/dsh-suggest-prompt
通过 npm 安装¶
插件发布后,可以使用 npm 包名安装:
dsh plugin --profile web add @studyzy/dsh-suggest-prompt
卸载¶
dsh plugin --profile web remove @studyzy/dsh-suggest-prompt
典型用法¶
1、打开 WebUI「设置 → 插件」的「建议提示词」卡片。
2、选择建议生成使用的 provider / model,或选择跟随会话路由。
3、保存配置。下一个完成回合生效。
4、如需要,在该卡片中录制采纳快捷键,例如 Alt+Slash 或 Ctrl+Enter。
5、等待 agent 完成一个回合。若输入框草稿为空,输入框内会出现浅色幽灵占位文字。
6、按默认 Tab 将建议采纳进草稿,再编辑或发送。
适用场景与注意¶
适合在 DSH Web profile 中连续多轮对话的使用者。它适合需要快速获得下一句提示词草稿、同时希望保留人工确认的场景。
使用前需要注意:
- 插件以当前
dsh进程权限运行。安装前应检查源码与许可证;本项目声明 MIT 许可。 - 该插件通过 DSH 插件机制接入,不是官方应用商店组件。
- 每个完成回合都会生成建议,但 Web 端只在草稿为空时显示幽灵文字。
- 被中止(取代)的生成不会为较早回合留下建议。
- 空回复或被过滤的回复视为无建议:不写
suggest-prompt/suggested事件、投影保持null、不记录警告。 - 投影保留最后一条建议;重新打开旧会话会显示其最终建议,且不发起新的模型调用。
- 对无法关闭思考的模型,思考可能消耗预算;
maxOutputTokens偏小时可能提前以max-tokens结束。
结尾¶
dsh-suggest-prompt 将建议提示词限制为一次有界的辅助生成,并在 Web 输入框中提供可采纳的占位文字。它适合想减少重复输入、又不希望打断当前草稿的 DSH Web 使用者。
GitHub 仓库:
- https://github.com/studyzy/dsh-suggest-prompt