提示词预测 littepointR/dsh-prompt-forecast

Prompt Forecast

DeepSeek Harness Web 输入框里的「下一步动作」幽灵预测，交互方式参考 Codex / Claude Code 的 prompt suggestions。

每轮对话完成后，Host 半会让当前会话使用的模型预测用户接下来最可能发送的可执行消息，通过客户端可见的 session projection 发布；Client 半在输入框为空时把这句话以灰色文字显示在第一行。按 Tab 或 → 写入草稿，按 Esc 忽略；开始输入后自动消失，已输入的内容不会被替换。

默认模式是 Codex 风格的上下文 fork：父会话当前的文本 transcript，加一条合成的 user 消息 Suggest my next message.，并附加一段“只写动作、不写结果汇报/猜测”的规则。

依赖要求

- DSH 0.2.1-rc.2 及以上、且仍在 0.2.x 范围内，声明为 engines.dsh: ^0.2.1-rc.2。
- 插件依赖 0.2.1-rc.2 的客户端与 Host 接口：conversation.input.overlay 输入框浮层
slot、InputActions.captureInsertion() / insertText()，以及由
agent/turn-stopping 驱动的 session projection。
- dsh plugin add 会在安装过程中校验该范围，不匹配时回滚到安装前的 profile 状态；profile 启动时还会再检查一次。范围不满足时插件会被拒绝加载；请升级 DSH，或安装 engines.dsh 与当前运行时匹配的插件版本。DSH 0.3 需要插件发布对应版本，而不是靠豁免绕过检查。

行为

- 默认 fork 模式基于完整文本 transcript 预测；digest 模式使用精简 JSON 摘要。
- 预测的是下一步动作，不是结果汇报或结果猜测。
- 使用用户当前书写的语言，输出一行短句。
- 使用刚服务完本轮请求的模型路由（找不到时回退到配置默认模型），无需额外配置 provider。
- 跳过子代理会话和没有人类输入的轮次。
- 静默失败：预测超时、被取消或请求失败都不会在对话里报错。

预测什么

目标是下一条可执行消息，而不是对对话的字面续写。有用的建议是用户接下来会发给助手、告诉它做什么的消息：

- 指令：跑一下测试、修这个错误、查 projection 缓存、解释一下失败原因
- 选择/批准：用方案 A、可以，继续、就这样
- 纠正：不对，应该改 client 那一侧
- 要求解释或诊断：fork 为什么会超时？
- 简短汇报 + 指令：重启了还是不行，查一下日志

纯结果汇报、测试结果、日志状态、叙述性总结、对可能发生什么的猜测都会被拒绝；NONE 是合法输出。另有一层保守的后置过滤，丢弃明显的纯汇报分句；fork 结果不可用时自动回退到 digest。

预测模式

mode: 'fork'（默认）对应 Codex 的 composer prediction 形态：取当前会话的文本 transcript（system / developer 指令加上 user / assistant 文本），丢弃 tool call、 tool result、reasoning 和附件块，然后在末尾追加一条合成的 user 消息：

Suggest my next message.

模型回复就是幽灵文本。这里不会创建子会话或 session 事件；fork 只是一次辅助调用的内存消息列表。system prompt 末尾会附加一段动作规则，要求模型写用户的下一步指令，而不是状态汇报或结果猜测。因为发送完整 transcript，这个模式的 token 成本更高， timeoutMs 也需要比 digest 模式更大。

mode: 'digest' 保留此前的轻量路径：把 recent_user_messages、 latest_assistant_reply、tools_used 打包成 JSON 摘要，配一段动作导向的短 system prompt。适合追求低成本或会话很长、发送完整 transcript 太贵的场景。

配置

cordis.patch.yml 中该行的 config 块可以覆盖全部默认值：

| 字段 | 默认值 | 含义 |
| enabled | true | false 时不注册 Host 半 |
| mode | fork | fork = 完整 transcript + Suggest my next message.；digest = 精简 JSON 摘要 |
| maxTokens | 1024 | 预测请求的输出预算 |
| temperature | 0.4 | 采样温度 |
| timeoutMs | 12000 | 请求硬超时；更慢的答案会被丢弃 |
| maxPromptChars | 80 | 预测文本的裁剪长度 |
| maxForkChars | 12000 | fork 模式对话窗口的字符预算（system / developer 文本始终保留） |
| fallback | true | fork 没有产出时，用精简 digest 再试一次 |
| maxInputChars | 6000 | digest 模式摘要大小上限 |
| skipSubagents | true | 子代理会话不预测 |
| provider | 本轮路由 | 显式指定 provider |
| model | 本轮路由 | 显式指定 model |

预测在轮次边界提交前（agent/turn-stopping）生成，因此文本会随完成的一轮一起到达，不需要轮询。代价是 timeoutMs：超过预算的预测会被放弃，该轮结束时不显示建议。

安装

从 GitHub 安装（无需构建）

dsh plugin --profile web add github:littepointR/dsh-prompt-forecast
dsh web

dsh plugin add 会把参数转发给目标 profile 里的 pnpm，安装包，并因为包声明了 dsh.bundle.patch 而自动把它加入 dsh.profile.bundles。安装后需要重启 profile 才会加载插件。本包是纯 JavaScript、没有 prepare 构建脚本，所以 git 安装不需要额外的 pnpm 构建授权。

固定到已打标签的版本：

dsh plugin --profile web add github:littepointR/dsh-prompt-forecast#v0.2.4

Desktop 应用的 desktop profile 由 Electron 独占，CLI 会拒绝 --profile desktop。在 Desktop 里请使用 设置 → 插件 安装，或安装到 CLI profile。

从本地目录安装

在 Plugin Manager 中把本目录作为 bundle 安装。bundle patch 会插入 prompt-forecast 行；作为普通 profile bundle，它会在重启后保留。

限制

- 只在输入框为空时显示建议。补全已经输入一半的草稿需要 slot 尚未暴露的光标几何信息，不在当前版本范围内。
- 建议只是提示，不是动作：按 Tab 或 → 只把纯文本插入草稿，不会发送。
- 预测质量取决于会话模型；过小的模型可能给出泛泛的追问。

开发

node --test test/host.test.mjs test/client.test.mjs
node --check index.js && node --check client.js

- index.js — Host 半：agent/turn-stopping 生成预测，promptForecast projection 发布。
- client.js — Client 半：注册 conversation.input.overlay，渲染幽灵文本并处理 Tab/→/Esc。
- test/host.test.mjs — 文本清洗、上下文摘要、projection 折叠。
- test/client.test.mjs — Client 渲染分支的结构性冒烟测试（不模拟 DOM）。

License

MIT