输入框预测 Lphehe/dsh-composer-assist

输入框预测 · Composer prediction

中文：根据当前对话和你说话的方式，在输入框上方给出你下一条最可能发的消息，按 Tab 即可采用；同时支持输入时补全草稿、一键润色提示词。

English: Predicts your next message in the DSH composer, based on your conversation and how you talk to it. Press Tab to take it. It also completes a draft as you type and rewrites a prompt for clarity on demand.

反馈 · Feedback

问题、建议或使用疑问，欢迎加入 QQ 群 1129389677。

Bugs, suggestions and usage questions: join the QQ group 1129389677.

输入框上方的独立建议栏，与输入框同宽对齐

设置 → 输入框预测

功能 · Features

| 中文 | English |
| 自动预测 | Predicts the next message after each finished turn |
| 手动预测 | Predict on demand from the composer tool row |
| 草稿补全 | Completes the second half of a draft as you type |
| 润色提示词 | Rewrites the current draft into a clearer instruction |

按 Tab 接受建议（填进草稿但不发送），Esc 隐藏，「忽略」按钮则永久丢弃。草稿为空时 ←/→ 在候选之间切换（按住修饰键、或输入法正在组合时不会拦截方向键）。
Tab accepts a suggestion (fills the draft, does not send); Esc hides it; the dismiss button forgets it. With an empty draft, ←/→ cycles between candidates (arrows are left alone while a modifier is held or an IME is composing).

安装 · Install

推荐安装预打包的 v0.1.1，不需要源码构建。在 Harness 中让助手使用 plugin_manager install_bundle 安装这个 URL： Install the prepacked v0.1.1 archive with Harness's plugin_manager install_bundle; no source build is required:

https://github.com/Lphehe/dsh-composer-assist/releases/download/v0.1.1/dsh-composer-assist.tgz

普通 CLI profile 可按下面的示例安装（将 web 换成你的 profile 名；Desktop 请使用插件管理器）： For a regular CLI profile, replace web with your profile name; use Plugin Manager for Desktop:

dsh plugin --profile web add https://github.com/Lphehe/dsh-composer-assist/releases/download/v0.1.1/dsh-composer-assist.tgz

也可克隆仓库，再让 plugin_manager install_bundle 安装克隆目录的绝对路径： Alternatively, clone the repository and install its absolute directory path with plugin_manager install_bundle:

git clone https://github.com/Lphehe/dsh-composer-assist.git

v0.1.1 沿用 0.1 系列输入预测功能，本次更新许可与分发；不包含开发中的 ZCode 动态工作流。
v0.1.1 retains the 0.1-series composer features and updates licensing/distribution; it does not include the in-development ZCode dynamic workflows.

设置 · Settings

设置 → 输入框预测 · Settings → Composer prediction

| 中文 | English |
| 启用 | Enable |
| 接受学习（默认关闭，可清除统计） | Acceptance learning (off by default, with a clear-stats button) |
| 模式：自动 / 单词补全 / 两者 / 仅手动 | Mode: auto / word / both / manual only |
| 显示位置：建议栏 / 行内 | Display: bar above the box / inline |
| 预测模型（留空则跟随本会话） | Predict model (blank follows the session) |
| 输出上限 / 输入停顿 / 超时 / 上下文上限 | Output cap / debounce / timeout / context cap |
| 置信度门槛（0 保留全部） | Confidence bar (0 keeps everything) |

设置存于 $DSH_HOME/composer-assist/settings.json。
设置保存在 $DSH_HOME/composer-assist/settings.json。

建议栏上的「置信度」是模型的自评，只显示为高/中/低三档，不是校准过的概率。

设计要点

- 不写会话日志：预测是 ctx.llm.prepareCall() 的辅助调用，不进入对话历史。
- 每轮只预测一次：Host 侧监听 agent/turn-stopping 记账；预测自身产生的 turn 事件会被过滤，并按 turn 号去重。
- 打字不触发：轮询不依赖草稿内容，键击不会重启轮询或消耗 turn。
- 建议跟着会话走：建议与「生成中」状态都按会话保存在模块级存储，切换对话再切回不会丢失。
- 不抢宿主的命令提示：行内模式会避让宿主的 --dsh-composer-hint。
- 工作区上下文只给名字：工作目录顶层文件名与 git 分支/改动列表会随提示词一起发送，经宿主 fs / subprocess provider 读取。不读文件内容，过滤常见凭据类文件名；目录最多扫描 200 项、发送 8 个文件名和 20 行 git 状态，缺失或超时不阻断预测。

上下文与过期保护

- 在现有对话历史字符预算内（不含当前草稿及工作区摘要），优先最新用户请求及回答、较早用户约束，再加入最近最多四条工具文本证据（带工具名、错误标记和截断标记）。不复制隐藏推理、图片、附件、工具参数或整个系统提示词；工具证据不作为指令。
- 预测只给有依据的 1～3 条候选，不强求数量、不新增授权或任务；不确定时可以不给建议。空结果不会清除已有有效候选。
- 请求绑定会话、当前消息视图边界和草稿修订。来源变化、乱序结果或期间改稿的请求不能写入候选；接受前再核对来源，草稿变化时接受按钮禁用。润色期间的新输入也不会被旧结果覆盖。
- 已完成候选仍按会话缓存；旧版无来源缓存不会恢复。只读上下文来自 DSH 的 Session.deriveMessages()，不是完整模型请求快照；不创建活跃预测子会话。

硬超时与响应速度

- Host 在工作区准备、等待旧调用退出、模型准备和生成期间执行同一硬截止；浏览器对请求、响应体和来源检查另设配置时限 + 1 秒兜底。接受候选的来源检查最多 5 秒。超时结束「生成中」，丢弃迟到结果，保留有效旧候选，不自动重试。
- 对明确支持 low 推理的模型，只在本次预测、补全或润色调用中使用低推理档；其他模型保持默认。不更换模型、不改主会话设置，也不缩减现有上下文。输出预算是否为远端硬限制，取决于服务商。
- 截止后会请求取消，但不能保证远端立即停止生成或计费；未结束的调用仍被记账，同会话同类新请求会等它退出，避免叠加后台调用。

Host 在工作区准备、上一次调用排空、模型准备和生成这几个阶段统一执行一个截止时间。浏览器按配置的超时加一秒，限制请求、响应体和源校验；验收检查限时五秒。迟到的结果直接丢弃，不清除有效建议，也不重试。只有当确切模型明确声明支持时，辅助调用才使用低推理；不改变主会话，也不改变已选模型。取消是上游的尽力而为：未完成的调用仍归其所有，直到排空为止，替代请求不会与它重叠。token 预算的强制执行取决于服务商。

实现说明 · Implementation notes

display: inline（行内模式）在空草稿上显示一个非编辑预览，与编辑器共享网格区域并隐藏 placeholder；换行会撑开输入区域。草稿补全复用宿主的 --dsh-composer-hint，跟随文字末尾排版。继续编辑使原建议与草稿不匹配时，行内预览隐藏，候选仍保留在建议栏。接受、切换会话或退出行内模式时，会清理插件拥有的提示。

行内模式在空编辑器上显示一个不可编辑的预览，共享其网格区域，并隐藏 placeholder；换行文本会撑开输入区域。草稿补全使用宿主的 --dsh-composer-hint，排在文字末尾。编辑草稿时，不匹配的行内预览会隐藏，候选仍保留在建议栏。接受、切换会话或离开行内模式，都会清除插件自己的提示。

预览使用清晰的灰色，常显「预览 · 未填入草稿」与键盘提示；只有 Tab 或接受按钮会填入草稿。候选和选中位置按会话保存在标签页会话存储中，切换会话、重载插件或刷新后会恢复；关闭标签页会清空这份缓存。生成中状态保留在当前页面内存中，正常切换会话不会丢失。

可读的灰色文字和可见的预览/键盘提示，把建议与草稿区分开；只有 Tab 或接受按钮会插入它们。按会话保存的候选和选中位置，在切换会话、重载插件和刷新页面后仍会保留，存放在标签页会话存储中。关闭标签页会清空这份缓存。进行中的状态存放在页面内存中，正常切换会话不会丢失。

行内显示依赖宿主的 [data-composer-card] / [data-composer-input] 标记及原生提示样式；DSH 升级改名后需要适配。Tab 接受也依赖消息输入框标记，以免搜索等其他输入框误接受候选。

行内渲染依赖宿主的 composer 标记和原生提示样式，DSH 升级后可能需要适配。Tab 接受还会检查消息编辑器标记，这样搜索等其他可编辑字段就无法接受候选。

成本提醒 · Cost warning

每次预测都是一次真实计费的模型调用。 默认开启自动模式，即每轮回答后一次调用。可在设置中改为「仅手动」或直接关闭。

每次预测都是一次真实计费的模型调用。 自动模式开启时，每轮回答结束后会调用一次。可在设置页改为仅手动，或直接关闭插件。

自检 · Self-check

克隆仓库后运行 node selfcheck.mjs，检查解析、学习统计和上下文失败降级；不调用模型或改写用户设置。
克隆仓库后运行 node selfcheck.mjs，检查解析器、学习计数器和上下文降级。它不调用模型，也不改动用户设置。

许可证 · License

原创程序代码采用“源码可见、禁止修改”条款，并非开放源代码许可证。允许使用未经修改的版本；未经著作权人事先书面许可，不得修改本软件、制作衍生版本或分发修改版本。完整条款见 LICENSE。用户自己的配置、输入、输出和工作流脚本不受本项修改限制。
原始程序代码采用「允许使用、禁止修改」的源码公开条款，不是开源许可证。你可以使用未经修改的软件；修改或衍生版本需事先获得版权持有人书面许可。详见 LICENSE。这些限制不适用于你自己的配置、输入、输出或工作流脚本。