dsh-suggest-prompt

为 DeepSeek Harness 开发的「建议提示词」插件：每个 agent 回合完成后，通过一次有界的辅助 LLM 调用，在会话日志中写入一条建议的下一条提示词；Web 端把它渲染成输入框内部的浅色幽灵占位文字，按 Tab（默认）即可采纳进草稿（与 Claude Code 一致）。

想快速上手？直接看 使用说明（面向终端用户的操作指南）。

Read this in English · 中文文档

对于开发者 / 维护者：本仓库是单个 bundle 包（@studyzy/dsh-suggest-prompt）的权威源码，把宿主生成与浏览器渲染合并为一个可一键安装的 bundle：

包	作用
@studyzy/dsh-suggest-prompt	宿主插件（., ./invariant, ./types）：在 turn/end（reason=completed）时生成建议，发布 suggestPrompt 会话投影。浏览器插件（./client）：读取投影，渲染为输入框内部的浅色幽灵占位文字（inputActions.setDraft），按配置的快捷键填入草稿。

特性

一个自动「接话」助手：AI 答完后，它替你预测下一句该说什么——既省去反复输入，又不会打断你的思路。

• 默认轻量：不配置 provider / model 时继承主请求最近一次记录的路由，无需为建议单独选模型；需要时也可显式指定任意路由（例如本地 OpenAI 兼容网关）。
• 免思考、快速便宜：建议生成默认携带 reasoningEffort: off（DeepSeek 序列化为 thinking: disabled），不消耗推理预算；模型不支持该参数时自动去掉并重试一次。
• 界面配置模型路由：日常只需在 WebUI「设置 → 插件」的「建议提示词」卡片里选择建议生成的 provider / model（或跟随会话路由），保存后下一完成回合生效，无需手动改配置文件；~/.dsh/settings.yaml 由界面代写。
• 只发最后一轮：默认只把最后一轮的用户输入与 AI 最终回答发给建议模型（maxRecentTurns 默认为 1），中间的工具调用 / 推理过程一律不发送。
• 有界调用：字节 / 令牌 / 超时上限、转录长度预算、建议可见字符上限，全部可配置。
• 安全：转录在发送前脱敏（密钥形状被掩蔽）；输出净化（控制序列、围栏、引号剥离、单行化）并做语义过滤（元文本、评价套话、助手口吻等被当作「无建议」丢弃）。
• 无建议是常态：模型回复为空或不合格时静默跳过，不报错、不写事件、不打扰。
• 免调用重显：删回空草稿会重新显示已持久化的建议，不再发新的模型请求。
• 快捷键可配：采纳快捷键默认 Tab，可在「建议提示词」设置卡片里按实际按键录制（如 Alt+Slash、Ctrl+Enter）。

效果预览

每个 agent 回合完成后，建议模型会在输入框里以浅色幽灵占位文字的形式显示一条预测，按 Tab 即可采纳进草稿：

安装

前置条件

• Node.js ^22.19 或 >=24、pnpm。
• 一个基于 deepseek-harness 的 dsh 部署（web profile），dsh ≥ 0.1.1-rc.1（0.1.1 变更了会话投影注册契约，本插件的宿主端按该契约适配；在 0.1.0 下投影不会同步到 Web 端）。浏览器端需要 conversation.input.overlay 槽位与 inputActions.setDraft（deepseek-harness 的标准 web 输入机均已提供）。

从 GitHub 安装（默认方式，一行命令）

本插件是一个单包 bundle：仓库根 @studyzy/dsh-suggest-prompt 声明了 dsh.bundle（自带 cordis.patch.yml），因此用 dsh plugin add 指向 GitHub 仓库即可安装，装完自动成为 profile 的一个 bundle 层，无需手动改配置文件。

# 从 GitHub 安装（推荐）
dsh plugin --profile web add [email protected]:studyzy/dsh-suggest-prompt.git

# 或 HTTPS
dsh plugin --profile web add https://github.com/studyzy/dsh-suggest-prompt.git

装完后重启正在运行的 dsh web 服务即可。安装后 profile 层叠顺序变为 dsh-base → dsh-web-app → @studyzy/dsh-suggest-prompt。

卸载：

dsh plugin --profile web remove @studyzy/dsh-suggest-prompt

git 安装的 pnpm ≥10 提示：git 托管的插件在安装时通过 prepare 脚本构建，pnpm ≥10 会拦截该脚本直到放行。若 add 报错，把 pnpm 打印的包键加进 ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds，再重跑 add。

本地源码安装（开发用）

dsh plugin --profile web add /path/to/dsh-suggest-prompt

通过 npm 安装（发布后）

dsh plugin --profile web add @studyzy/dsh-suggest-prompt

说明：无论哪种来源，装完都是同一个 bundle 层。日常建议模型的 provider / model 通过 WebUI 设置卡片配置（见下「配置」），不需要在安装时手动指定。

配置

配置分两层：日常的路由配置走界面，一次性的资源上限在 bundle 自带的补丁层提供（可在 profile 补丁层覆盖）。

通过 WebUI 界面配置建议模型（日常）

「设置 → 插件」会出现「建议提示词」卡片。这是日常配置建议模型的主入口，无需手动改配置文件：

…