前言¶
在 DeepSeek Harness（DSH）里和 Agent 多轮对话时，助手回复结束后，你往往还要想下一句怎么写。常见做法是盯着空白输入框回忆上下文，或从最近几条消息里复制改几个字。DSH 社区插件 dsh-prompt-prediction（维护者 QingJ01）在 Agent 正常完成一轮回复后，用模型推测你可能输入的下一句话，以灰字显示在完全为空的输入框中；按 Tab 或 → 填入可编辑草稿，不会自动发送。交互思路参考 Codex 的下一句预测，但这是非官方插件，与 DeepSeek、OpenAI 无隶属关系。
这是什么¶
dsh-prompt-prediction 是运行在 DSH 内的客户端插件（分类：客户端），不是独立聊天应用或浏览器扩展。它在 Cordis 宿主与 Web 前端注入输入框浮层，由 Host 侧发起额外模型请求，客户端负责展示与键盘采纳。GitHub 仓库：QingJ01/dsh-prompt-prediction；社区目录页：skillhub.cn 条目。当前 package 版本为 0.2.3，许可证 MIT。声明兼容 DSH >=0.2.1-rc.5 <0.3.0，适配基于 0.2.1-rc.5，范围内并非每个版本都已实测。
核心功能¶
下面介绍插件在资料中明确描述的能力。
触发与展示条件¶
- 你先正常提问，等待 Agent 正常完成一轮回复；失败、中断、取消等状态不触发预测。
- 输入框完全为空，且没有附件、引用或排队消息时，才可能显示灰字建议。
- 会话运行中、Plan 模式或输入框禁用时，建议会隐藏。
键盘与输入行为¶
| 操作或状态 | 行为 |
|---|---|
| Tab / → | 填入可编辑草稿，支持撤销、重做，不发送 |
| Esc | 忽略当前建议；随后 Tab 可移动焦点；轮询不恢复同一轮同一条建议 |
| Enter | 保留 DSH 原有发送、排队、命令逻辑，不用于采纳 |
| 输入文字、IME 组字、打开菜单 | 隐藏建议 |
| 长建议 | 单行省略预览，采纳时填入完整建议；多段时预览只显示第一段，胶囊可标「2 段」，采纳插入完整多段草稿 |
预测允许最多 3 个非空短段落；超过限制时整条丢弃。建议只是模型推测，采纳后仍应检查；插件不会替你发送消息或执行预测中的工具调用。
预测质量与本地过滤¶
Host 在请求中约束模型，并在结果回传后做本地过滤，例如：用你最近 3 条真实用户消息作风格锚点；优先短句；丢弃与上一条归一化后完全相同的重复（repeated-user）；启发式丢弃凭据形态（credential-shaped）；允许模型返回 null 表示弃权。这些规则用于减少无效建议，资料未声称已通过对照评估证明准确率或采纳率提升。
费用与数据¶
默认沿用会话的模型路由与历史，额外发起预测请求，可能计费。预测保存在插件内存，不加入 Agent 会话历史。默认开启本地审计日志（可用 auditLog: false 关闭后续写入）；路径为 $DSH_HOME/prompt-prediction/events.jsonl 或 ~/.dsh/prompt-prediction/events.jsonl。
安装与启用¶
前提：已安装兼容的 DSH，终端可运行 dsh，目标 profile 中的会话已有可用模型路由。插件以当前 DSH 进程权限运行；安装前可在 GitHub 查看源码与 MIT 许可证。
从 npm 安装（推荐）：
dsh plugin --profile desktop add dsh-prompt-prediction
使用其他 profile 时，将 desktop 替换为对应名称。安装后刷新已有 DSH 窗口以加载前端；Host 插件未自动加载时重启 DSH。无需 npm install 或构建步骤。
升级 npm 版本时需先移除再添加：
dsh plugin --profile desktop remove dsh-prompt-prediction
dsh plugin --profile desktop add dsh-prompt-prediction
移除：
dsh plugin --profile desktop remove dsh-prompt-prediction
配置¶
在 DSH 界面打开 插件 → 提示词预测 → 预测设置，可调整预测开关、建议长度、模型请求超时、输出 token 预算和本地审计日志；保存后立即生效。
也可在目标 profile 的 cordis.patch.yml 中覆盖 ID 为 prompt-prediction 的配置行，例如关闭审计日志：
- id: prompt-prediction
config:
enabled: true
maxSuggestionChars: 160
timeoutMs: 15000
auditLog: false
常用默认值（完整表见仓库 README）：
| 参数 | 默认值 | 含义 |
|---|---|---|
enabled |
true |
是否启用预测 |
timeoutMs |
20000 |
模型请求超时（毫秒） |
maxSuggestionChars |
1000 |
建议长度上限（UTF-16 单元） |
maxOutputTokens |
8192 |
预测输出 token 预算 |
auditLog |
true |
是否写入本地审计日志 |
reasoningEffort |
inherit |
推理力度，默认沿用会话 |
provider 与 model 均未设置时沿用会话路由；必须同时设置才能使用独立预测路由。关闭预测应使用 enabled: false，而不是 timeoutMs: 0。
典型用法¶
经过上面的安装与配置，日常使用可以按下面步骤操作。
- 在 DSH 中正常对话，等 Agent 完整结束一轮回复。
- 确认输入框为空且无附件、引用、排队消息，聚焦输入框。
- 若出现灰字建议，阅读后按 Tab 或 → 采纳为草稿，修改无误后再自行发送；不需要则按 Esc 忽略。
- 若你希望 Tab 只用于切换焦点，先 Esc 忽略建议，或使用 Shift+Tab 向前移动。
安装后没有灰字时，可检查是否装到当前 profile、是否刷新或重启、enabled 与模型路由是否正常。
适用场景与注意¶
适合在 DSH Desktop（或对应 Web 客户端 profile）里高频续写提示词、希望减少「下一句写什么」空窗时间的开发者。需要注意：
- 每次有效预测都会额外请求模型，长会话与冷缓存下费用需自行关注；省成本可设
reasoningEffort: min或关闭enabled。 - 默认审计日志可能记录预测与交互文本，敏感环境请关闭或自行清理日志目录。
- 依赖 DSH 内部接口，后续 DSH 版本可能变化；完整 Desktop IPC、所有外部模型提供商与各类屏幕阅读器尚未在资料中声明完成端到端验证。
- 社区目录 skillhub.cn 与 GitHub 为独立生态入口，不是 DeepSeek 或幻方官方应用商店。
结尾¶
dsh-prompt-prediction 把「下一句提示词」做成可选的灰字草稿，Tab 采纳、不自动发送，在 DSH「一切皆插件」的思路里补了一块客户端输入体验。进一步了解安装、排障与开发测试，见 GitHub README 与 社区目录页。
