输入框联想 ferrisching/dsh-prompt-predict

dsh-prompt-predict

为 DeepSeek Harness 提供 Codex 风格的输入框预测每次回复结束后，下一条提示词会以幽灵文本的形式浮现在输入框里 —— 按 Tab 采纳，按 Esc 忽略，一开始打字它就消失

🌏 中文 · English

dsh-prompt-predict 是 DeepSeek Harness 插件：每轮助手回复结束后，它会预测你接下来最可能输入的消息，并以灰色幽灵文本的形式浮现在输入框里。这条建议不会进入编辑器 —— 只有按 Tab 才会插入，而且插入后仍可撤销 —— 所以预测错了也不会有任何损失。

📑 目录

- ✨ 功能
- 🚀 安装
- ⌨️ 使用
- ⚙️ 设置
- 🔌 HTTP API
- 🧩 工作原理
- 🛠️ 开发
- 🔐 安全与成本
- 🩺 故障排查
- ⚠️ 已知限制
- 📄 许可证

✨ 功能

- 单行或多行 —— 句子保持一行；代码片段、列表和多段回复保留换行与缩进
- 回复一结束就给出建议 —— 灰色幽灵文本渲染在输入框第一个字符处，与编辑器的光标位置、字号、行高保持一致
- 三种交互 —— 按 Tab 采纳，按 ↻（或 ↓）换一条建议，按 Esc 忽略；打字会隐藏它，清空草稿后它又会回来
- 轻量上下文 —— 只带最近用户与助手的文本；工具结果、附件和系统提示词从不离开你的机器
- 默认跟随当前会话模型 —— 没有任何地方硬编码到某个服务商，预测调用复用会话自身所用的模型；你也可以固定一个更便宜的模型
- 不重复，不死胡同 —— 重复上一条建议会自动触发「换一个」；真实模型不支持的推理级别会自动回退，所以你永远不会遇到「设置看着没问题，但建议就是不出现」
- 一切可调 —— 开关、服务商 / 模型、响应超时、上下文大小与预算、输出上限、推理强度；改动立即生效，无需重启 DSH
- 明暗双色 —— 幽灵文本、设置页和历史记录跟随系统 / 应用配色方案（prefers-color-scheme），两种模式下对比度都保持 WCAG AA
- 界面跟随你的语言 —— 插件自带 DSH 本身支持的语言词典（中文和英文），并把它拥有的每一份词典都交给 locale 服务。切换「设置 → 语言」，整个插件界面立刻改变，包括输入框上方的幽灵提示以及设置页内的校验错误（这些错误由宿主产生，宿主用客户端发来的语言作答）；无需重新加载，没有 locale 服务时回退到中文
- 零运行时依赖 —— 宿主端和客户端都是纯 ESM

🚀 安装

插件已发布到 npm。下面按便利程度排列几种方式。

在 DSH 内安装（推荐）

图形界面：打开插件页 → 添加插件 → 输入包名 dsh-prompt-predict → 安装。

或者用 dsh 命令行 —— 用 pnpm 的 @version 语法固定任意已发布版本：

dsh plugin --profile desktop add dsh-prompt-predict@0.2.10

把 --profile 换成你自己的配置档（桌面应用通常是 desktop，Web 构建是 web），然后重启 DSH。

升级到最新版本

dsh plugin --profile desktop add dsh-prompt-predict@latest

从源码检出运行时，bash scripts/update.sh [profile] 做同样的事，还会同步锁文件；应用还开着时它会拒绝运行 —— 先退出应用。设置页在版本号旁边有检查更新按钮，打开时也会自动查询 npm（最多每 10 分钟一次）；它会识别运行环境（桌面应用 / Web 构建），并预填更新命令里的配置档。更新提示只出现在设置里 —— 输入框下方没有横幅。

⚠️ 命令行只负责安装包。 只有插件同时列在 ~/.dsh/profiles/<profile>/package.json 的 dsh.profile.bundles 里，DSH 才会加载它。已验证：包已安装但不在该列表中时，插件的路由返回 404，什么都不会加载。图形界面这条路径上面已经替你处理好了；用命令行的话，自己把 "dsh-prompt-predict" 加进那个数组，或者直接运行下面的 scripts/install.sh，两步它都包了。

开关和全部参数都在 Settings → Prompt Suggestions 里。

从 release tarball 安装

每个 release 都附带与 npm 上完全一致的 tarball（shasum 与 registry 对得上），离线机器或者想固定一份可校验的产物时很好用：

gh release download v0.2.10 --repo ferrisching/dsh-prompt-predict --pattern '.tgz'
dsh plugin --profile desktop add ./dsh-prompt-predict-0.2.10.tgz

和上面命令行那条路一样要注意：自己把 "dsh-prompt-predict" 加进 dsh.profile.bundles，或者改用 scripts/install.sh。

从源码安装

git clone https://github.com/ferrisching/dsh-prompt-predict.git
cd dsh-prompt-predict
bash scripts/install.sh
make sure the app is fully quit first (Cmd+Q) — the script refuses to run while it is up

脚本会现场打包这个仓库，装进 profile 的 node_modules，再把 dsh-prompt-predict 加进 dsh.profile.bundles。默认目标是 ~/.dsh/profiles/desktop；要装到别的 profile：

bash scripts/install.sh ~/.dsh/profiles/web

装完重启 DSH，然后到 Settings → Prompt Suggestions 里看。

手动安装

cd ~/.dsh/profiles/desktop
pnpm add dsh-prompt-predict # from npm
or link local source (symlink — handy while developing):
pnpm add /path/to/dsh-prompt-predict

然后打开该 profile 的 package.json，把 "dsh-prompt-predict" 加进 dsh.profile.bundles 数组，重启 DSH。

环境要求

- 已在 DSH 0.2.1-rc.3 上验证（web 构建；桌面应用跑的是同一套 host 和 client 代码）
- node / pnpm：安装脚本优先用 ~/.dsh/dsh-runtimes//dependencies 下 DSH 自带的运行时，找不到才回退到 PATH
- macOS / Linux；Windows 未测试

⌨️ 用法

1. 正常聊天，等助手把这一轮说完，输入框留空
2. 大约 350 ms 后出现一条灰色建议，右侧带 Tab / ↻ / Esc
3. 按需选择：

| 操作 | 效果 |
| Tab | 输入框聚焦时接受整条建议（这时才真正插入，且可以撤销） |
| ↻（右侧按钮） | 重新生成 —— 让模型换一条建议 |
| ↓ | 生成下一条建议（计入 Max switches）；如果这一轮后面还有建议，就免费往后翻。没有建议显示且输入框为空时，会立刻取一条。Ctrl/⌘+↓ 可作为备用 |
| ↑ | 回到这一轮的上一条建议（免费） |
| Ctrl/⌘+Shift+Space | 手动触发一次预测；已经有建议显示时则重新生成 |
| Esc | 关掉这一条 |
| 直接开始输入 | 提示消失；清空草稿后它会回来（只有 Esc 是永久关闭） |

输入框为空且会话未运行时，才会出现建议。切换会话或打断回复，会清掉待处理的建议。

⚙️ 设置

Settings → Prompt Suggestions：

| 设置 | 说明 | 默认值 |
| Enable predictions | 总开关 | 开 |
| Provider / model | 预测调用使用的模型；选「Follow current session model」复用会话自己的模型 | Follow current session model |
| Response timeout (advanced) | 1–60 秒 | 12 秒 |
| Context size (advanced) | 小 3 / 标准 8 / 大 12 条消息 | 标准 8 |
| Context budget (advanced) | 发给辅助调用的字符上限，1000–20000 | 6000 |
| Output length | 建议要多长，单位是字符（20–400）——不用算 token。锁定拉丁字母语言时还会显示等价的词数；CJK 仍按字符计，因为那里的分词没有定义。宿主据此按语言推导一个宽松的 token 安全上限，并把字符预算写进提示词；回复仍被截断时会加大空间重试，并标记 cut off · raise the output length | 120 |
| Keep multi-line formatting | 允许代码片段/列表保留换行和缩进（关闭 = 始终单行） | 开 |
| Switchable suggestions | 开启后，↓ 生成下一条建议，↑ 回到上一条（保留在本轮历史里）；关闭则禁用方向键切换和 ↻ 按钮 | 开 |
| Max switches | 每轮最多生成几条新建议（0–10；0 = 不限）。用 ↑ 往回移动不计入 | 3 |
| Reasoning effort (advanced) | 选项根据实际使用的模型生成（跟随会话时就是会话的模型）；不支持的档位不会出现 | 关（最快、最省） |
| Suggestion language | Auto 跟随对话；锁定语言后，每条建议都用该语言书写。14 种主流语言列在前面，其余收在 More languages… 后面；有地区变体的语言会多出一个 Region 下拉框：简体中文（中国大陆 / 新加坡 / 马来西亚）、繁体中文（台湾 / 香港）、英语（美国 / 英国 / 澳大利亚 / 加拿大）、葡萄牙语（巴西 / 葡萄牙）、西班牙语（西班牙 / 拉丁美洲（中性）/ 墨西哥 / 阿根廷 / 哥伦比亚）、法语（法国 / 加拿大）、德语（德国 / 奥地利 / 瑞士）、荷兰语（荷兰 / 比利时）。选中的变体会在提示词里明确写出（例如 Traditional Chinese (Taiwan)、British English） | Auto |
| Pause | 暂停预测十分钟，带倒计时，之后自动恢复；截止时间在重新加载后仍然有效 | 关 |
| 历史记录条数（高级） | 设置页保留多少条最近的预测（0–50；0 表示关闭历史记录）。记录存放在应用自己的本地存储里——桌面端是 Electron 渲染进程的存储，网页端是页面的 localStorage——从不上传 | 10 |

设置页底部显示最近预测列表（默认 10 条，可调整）：时间、会话、模型、延迟，以及推理级别是否被自动降级、是否发生了重新生成、建议是否被输出上限截断、调用是否失败（附原因）。列表默认折叠到最新一次运行（▸ Show all 展开其余部分），最新一次运行的建议文本默认展开，点击某行的 ▸ 会展开该次运行的文本，同时折叠上一次。记录存放在应用自己的本地存储里（桌面端是 Electron 渲染进程的存储，网页端是页面的 localStorage），从不上传。再也不用猜为什么什么都没出现。

- 改动立即生效——无需重启 DSH
- 设置存放在 ~/.dsh/dsh-prompt-predict/config.json（权限 600）
- 优先级：用户保存的设置 > cordis 补丁部署默认值 > 内置默认值

🔌 HTTP API

插件在 DSH 的 web 服务器上注册同源前缀路由 /dsh-prompt-predict；设置页和输入框建议都走这条路由。每个端点都用 DSH 的浏览器 cookie（connection.requestRejection）鉴权——非本机调用方会收到 401/403。

| 方法 | 路径 | 说明 |
| GET | /dsh-prompt-predict/status | 当前会话模型、生效设置、已保存的覆盖项、部署默认值 |
| GET | /dsh-prompt-predict/catalog | 全部服务商和模型（供下拉框使用） |
| GET | /dsh-prompt-predict/efforts?provider=&model= | 该模型实际支持的推理级别 |
| POST | /dsh-prompt-predict/settings | 保存设置；{ "reset": true } 恢复默认值 |
| POST | /dsh-prompt-predict/suggest | { sessionId } → 一条建议 |

每个端点都接受可选的 x-dsh-locale 请求头（zh / en，默认中文），决定校验错误和预测失败以哪种语言返回。客户端会自动发送当前 UI 语言。

🧩 工作原理

宿主侧（lib/）

1. lib/index.js 是插件入口，负责注册同源 HTTP 路由
2. 收到 suggest 时，lib/predict.mjs 把会话裁剪到最近的用户/助手纯文本——同时受消息条数上限和字符预算约束，从后往前遍历
3. 裁剪后的历史在送给辅助模型之前，会包装成一条仅请求用的用户输入：DSH 的助手消息必须携带完整的 stream / replayState，所以裁剪出的片段不能冒充助手消息（会话标题用的是同一套做法）
4. 流式回复会做归一化处理（去掉代码围栏、Suggestion: 前缀和包裹引号，合并换行），然后返回给客户端模型选择上，provider / model 设为 auto 表示「跟随会话」：辅助调用不写死路由，predictNextPrompt 继承会话自身选定的模型。

客户端（client/）

- 注入 conversation.composer.dock（输入框旁的生命周期挂载点）和 settings.section 插槽
- 幽灵文本是浮层，从不写入 Lexical 编辑器；只有接受时才走 inputActions.insertText

客户端源码结构

客户端由 client/src/ 下按顺序排列的片段构建（npm run build:client 输出 client/client.js）。DSH 只加载一个客户端脚本，所以这种拆分只是源码组织手段，并非原生 ES 模块；pretest 和 prepack 会自动重新构建。

真实 DSH 冒烟测试（macOS，可选）

npm run test:smoke 会启动一个临时 DSH 配置档，把本仓库作为本地 tarball 安装进去，启动本地 mock LLM，并通过 CDP 驱动无头 Edge。它检查这些点：真实回复能产生幽灵文本；焦点在别的输入框时 Tab 被忽略；在输入框内 Tab 能接受建议；重新生成会改变建议；暂停会隐藏建议、恢复后重新显示。需要 DeepSeek Harness 应用和 Microsoft Edge；用 DSH_SMOKE_DSH 和 DSH_SMOKE_EDGE 覆盖路径。它刻意不纳入 npm test。

🛠️ 开发

git clone https://github.com/ferrisching/dsh-prompt-predict.git
cd dsh-prompt-predict
npm test # 71 cases: 51 host-side + 20 client render smoke tests

.
├── lib/ Host side (plain ESM, no build step)
│ ├── index.js Plugin entry point, registers the HTTP route
│ ├── host-route.mjs Same-origin API: status / catalog / efforts / settings / suggest
│ ├── predict.mjs Session trimming, helper-model call, suggestion normalization
│ ├── messages.mjs User-facing host copy (Chinese + English)
│ └── config.mjs User settings persistence
├── client/
│ └── client.js Client: composer ghost-text overlay + settings page
├── test/
│ ├── predict.mjs 51 cases: trimming, cleanup, route inheritance, settings validation, degrade-retry, dedup, bilingual errors, HTTP end-to-end
│ └── client-render.mjs 20 cases: renders the ghost overlay and settings page through a tiny React stand-in, incl. both locales and dictionary self-checks
├── scripts/
│ ├── install.sh One-shot install from a local pack
│ └── update.sh Upgrade a profile to the npm latest
├── cordis.patch.yml Plugin mount patch
└── package.json
test/client-render.mjs 是客户端唯一的自动化安全网：不需要浏览器——一个极简的 React 替身把组件展开成普通对象树，测试就能断言幽灵提示确实出现，且 Tab / ↻ / Esc 都在。它源于一次真实事故：浮层引用了一个从未从 props 读取的变量，渲染抛错，React 的错误边界把错误吞掉，症状是「API 返回了建议，但界面上什么都不出现」——而所有宿主侧测试都是绿的。

这些测试不需要 DSH 运行时：一个假 ctx 加一个本地 HTTP 服务器，就能覆盖路由注册、设置校验、路由继承和端到端调用。

🔐 安全与成本

- 默认每个助手回合只调用一次小型辅助接口；只有回复触到长度上限、推理档位需要降级，或建议需要重掷时，才会多试一次——四次调用是硬上限（主调用、推理档位回退、长度重试、重掷），它们共用同一份超时预算
- 建议不写入会话日志；只有你按 Tab 接受并发送后，文本才成为真正的消息
- 只发送裁剪后的用户/助手纯文本——工具结果、附件和系统提示词永远不离开本机
- 设置页和建议接口都位于 DSH 自带的浏览器 Cookie 认证之后

🩺 故障排查

完全不出现建议

- 只在助手回合结束后才运行（约 350 ms 后），回复还在流式输出时绝不运行。
- 输入框必须为空。如果你已经有草稿，预测会被有意跳过——不会发起调用。
- 全新会话没有任何消息，没有可预测的内容。
- 检查 设置 → 提示词建议：启用预测 必须打开，会话不能处于暂停状态，且 最近预测 不能显示错误。

输入框下方显示「Prediction failed: …」（连续两次失败后出现）

| 原因文本 | 该怎么做 |
| Request timed out | 在 高级 里调高 响应超时 |
| Provider "…" is unavailable / has no model "…" | 固定一个服务商和模型，不要跟随会话模型 |
| Prompt prediction is turned off | 把开关重新打开 |
| 其他任何情况 | 打开 设置 → 提示词建议 → 最近预测；该行带有宿主给出的确切原因 |

建议的语言不对

- Auto（默认）从你最近的消息里按多数投票检测语言，取最近五条，所以一条以粘贴日志为主的消息可能把它带偏。
- 改为固定一种：设置 → 建议语言（中文、英文、葡萄牙文、西班牙文、法文、德文、荷兰文都有 区域 选择器）。
- 界面语言不影响建议语言——这是两个独立的设置。

建议结尾显示「cut off · raise the output length」
- 调高输出长度。回复被截断时，系统会先多给一些空间重试一次，之后才出现标记。
- 推理模型可能在写出任何文本前就消耗掉大部分预算；如果经常这样，调高长度，或保持推理强度关闭（默认）。

按 Tab 没反应

- 只有建议可见时才会拦截 Tab；没有幽灵文本时它照常工作。
- 先点进输入框——浮层定位在编辑器光标框上方，Tab 作用于获得焦点的编辑器。

幽灵文本盖住了我输入的内容

- 0.2.7 已修复：粘贴、输入法组合和拖放时它会隐藏，输入框有草稿时也不再出现。如果仍看到此问题，请升级。

「最近预测」是空的

- 记录存在应用自己的本地存储里，点清除按钮会清空；0.2.5 之前记录的运行不带建议文本。

升级了但没变化

- 宿主侧改动（设置字段、提示词构造）要重启应用后生效；客户端侧改动要重新加载窗口后生效。重新加载窗口不会改写 package.json 里的版本号。

⚠️ 已知限制

- 仅在 DSH 0.2.1-rc.3 上验证过；其他版本未测试
- 依赖宿主的 conversation.composer.dock 和 settings.section 插槽名——DSH 大版本更新后可能需要适配
- 预测会消耗所选模型的配额；固定用快速的小模型比跟随推理模型更省钱

📄 许可证

MIT © ferrisching

可自由使用、修改和分发，包括闭源商业项目——只需保留版权声明和许可证文本。

变更历史见 CHANGELOG.md（中文）。