dsh-prompt-prediction

使用方式

1. 正常提问，等待 Agent 正常完成一轮回复；失败、中断、取消等状态不触发预测。
2. 输入框完全为空且没有附件、引用或排队消息时，才可能显示灰字建议。
3. 聚焦输入框，采纳或忽略建议；采纳后可修改，再自行发送。

操作或状态	行为
Tab / →	填入可编辑草稿，支持撤销、重做，不发送
Esc	忽略当前建议，随后 Tab 可移动焦点；轮询不恢复同一轮的同一条建议
Enter	保留 DSH 原有发送、排队、命令处理逻辑，不用于采纳
输入文字、IME 组字、打开菜单	隐藏建议，不干扰当前输入
会话运行中、Plan 模式或输入框禁用	隐藏建议
长建议	单行省略预览，采纳时填入完整建议
删除草稿至空白	当前建议未被忽略且仍有效时，可以再次显示

插件提供供辅助技术读取的建议全文与按键说明；这不等于已经完成各类屏幕阅读器实测。状态读取请求超过 5 秒会隐藏旧建议并退避重试；这与模型请求的 timeoutMs 是两个不同限制。

配置

打开 插件 → 提示词预测 → 预测设置，可调整预测开关、建议长度、模型请求超时、输出 token 预算和本地审计日志。点击「保存」后立即生效；离开页面会放弃未保存的编辑。恢复默认会回到当前 profile 的继承值，不一定是下表中的内置默认值。

关闭预测会取消待处理请求并清除旧建议。重新开启或改变预测参数后，空输入框可能对最近完成的一轮重新生成建议，产生额外模型请求。关闭日志不会删除已有文件。只读部署不可保存。

插件包会插入 ID 为 prompt-prediction 的配置行。在目标 profile 的 cordis.patch.yml 中覆盖该行，例如：

- id: prompt-prediction
  config:
    enabled: true
    maxSuggestionChars: 160
    timeoutMs: 15000
    auditLog: false

示例不是默认值；完整默认值如下。修改后重新加载对应 profile 或重启 DSH。

参数	默认值	含义
enabled	true	是否启用预测；设为 false 关闭
provider, model	未设置	均不设置时沿用会话路由；必须同时设置才能使用独立预测路由
maxOutputTokens	8192	预测输出 token 预算，适用时包括推理 token
timeoutMs	20000	模型请求超时，单位毫秒；超时后丢弃迟到结果
maxSuggestionChars	1000	建议长度上限，以 UTF-16 单元计数，截断不拆开代理对；不是屏幕显示字数
compactTurns	8	独立路由保留的用户轮次数
maxHistoryChars	0	普通文本历史长度保护；0 关闭，不代表完整序列化请求大小
eagerWindowMs	1800000	最近被浏览器访问后允许后台预测的窗口，毫秒（30 分钟）
auditLog	true	是否将预测与交互记录写入本地日志
reasoningEffort	inherit	预测请求的推理力度：inherit 沿用会话设置（推荐）、min 取模型最低档以省成本、或填模型声明的具体档位如 low/high；模型不支持时回退为继承

输出预算、模型超时和建议长度由 DSH 配置 schema 校验，必须为正整数；超时不能超过 2147483647 毫秒。旧配置中的零、小数或字符串需先改为有效值。精简轮数和后台窗口仍向下取整，不足 1 或无效值回退默认值。关闭预测应使用 enabled: false，而不是 timeoutMs: 0。

独立模型配置（标识符需替换为 DSH 中实际可用的值）：

- id: prompt-prediction
  config:
    provider: your-provider
    model: your-model
    compactTurns: 8

只设置 provider 或 model 之一会回退到会话路由。maxSuggestionChars 同时用于模型指令中的字符上限和结果接收上限，默认 1000（UTF-16 单元）。