dsh-prompt-predict
Codex 风格的输入框提示词联想
助手回复结束后，把你的下一句话以灰色 ghost text 直接写进输入框 —— Tab 采纳、Esc 忽略、开始输入自动消失
🌏 中文 · English
dsh-prompt-predict 是一个 DeepSeek Harness 插件：每轮助手回复结束后，它根据当前会话预测你下一句最可能输入什么，并以灰色 ghost text 的形式浮在输入框里。整条建议不写进编辑器，只有按下 Tab 采纳时才真正插入（可撤销），因此误预测零成本。
📑 目录
- ✨ 功能一览
- 🚀 安装
- ⌨️ 使用
- ⚙️ 设置
- 🔌 HTTP 接口
- 🧩 工作原理
- 🛠️ 开发
- 🔐 安全与成本
- 🩺 排查
- ⚠️ 已知限制
- 📄 许可
✨ 功能一览
-
单行/多行都支持：普通句子保持单行；代码片段、列表、多段文本会保留换行与缩进
-
回复结束即出建议：在输入框首字符处浮出灰色 ghost text，光标位置、字号、行高都对齐当前编辑器
- 三种交互：
Tab采纳 ·↻（或↓）换一条 ·Esc忽略；开始输入自动消失，把草稿删空它还会回来 - 轻量上下文：只取最近若干条 user/assistant 的纯文本，工具结果、附件、系统提示一律不进辅助调用
- 默认跟随当前会话模型：不写死任何提供商，联想调用沿用会话自身选用的模型；也可以在设置页固定到某个更便宜的模型
- 不会复读、不会卡死：连续两轮撞车时自动要求换一条；思考档位与真实模型不兼容时自动降级重试，不会出现「设置都对但永远没建议」
- 全部可调：开关、提供商 / 模型、响应超时、上下文规模与预算、输出上限、思考深度，保存后立即生效，无需重启 DSH
- 浅色/深色自适应：ghost、设置页与历史列表跟随系统/应用的配色（
prefers-color-scheme），两种主题下都保持 WCAG AA 对比度 - 界面跟随语言设置：插件随 DSH 自身支持的界面语言提供词典（中文、英文），并把已有词典全部注册给 locale 服务。切换「设置 → 语言」后插件界面立刻跟着变——包括输入框上的 ghost 提示与设置里的校验报错（报错文案由 Host 生成，会按请求带来的语言返回），无需刷新；没有语言服务时回落中文
- 零运行时依赖：纯 ESM，Host 端与客户端都不引入第三方包
🚀 安装
插件已发布到 npm，安装方式按方便程度排序。
在 DSH 里安装（推荐）
图形界面：打开插件页 →「添加插件」→ 填入包名 dsh-prompt-predict → 安装。
或者用 dsh CLI——想装某个已发布版本就用 pnpm 的 @版本 语法：
dsh plugin --profile desktop add dsh-prompt-predict@0.2.10
--profile 换成你自己的 profile（桌面端一般是 desktop，Web 端是 web），装完重启 DSH 生效。
升级到最新版
dsh plugin --profile desktop add dsh-prompt-predict@latest
如果用的是源码仓库，bash scripts/update.sh [profile] 会做同样的事并同时收敛 lock；App 仍在运行时会直接拒绝执行——先退出 App 再用。设置页版本号旁有「检查更新」按钮，打开设置页时也会自动检查一次（10 分钟内不重复）；会按运行环境（桌面 App / Web 构建）在更新命令里自动填好 profile。更新提示只出现在设置页，输入框下方不再有横幅。
> ⚠️ CLI 只负责装包。 DSH 只有在 ~/.dsh/profiles//package.json 的
> dsh.profile.bundles 里也列出该插件时才会加载它。实测：包装了但不在该列表里，插件路由返回 404，
> 什么都不会加载。上面的图形界面路径会替你处理；用 CLI 的话请自己把 "dsh-prompt-predict" 加进该数组，
> 或直接跑下面的 scripts/install.sh——它两步都做。
> 装完在 设置 → 提示词联想 里能看到开关与各项参数。
从 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
与上面 CLI 路径同样的注意点：请自己把 "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
# 先确认 App 已完全退出（Cmd+Q）——App 在运行时脚本会拒绝执行
脚本会现场打包本仓库、装进 profile 的 node_modules，并把 dsh-prompt-predict 接进 dsh.profile.bundles。默认目标是 ~/.dsh/profiles/desktop，装别的 profile：
bash scripts/install.sh ~/.dsh/profiles/web
装完重启 DSH 生效，然后在 设置 → 提示词联想 里能看到开关与各项参数。
手动安装
cd ~/.dsh/profiles/desktop
pnpm add dsh-prompt-predict # 从 npm 装
# 或装本地源码（符号链接，适合边改边调）：
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 未验证
⌨️ 使用
- 正常对话，等助手这一轮回复结束，且输入框为空
- 约 350 ms 后，输入框里浮出一条灰色建议，右侧是
Tab/↻/Esc 忽略三个操作 - 按需选择：
| 操作 | 效果 |
|---|---|
Tab |
输入框聚焦时整条采纳（此刻才插入输入框，可撤销） |
↻（点右侧按钮） |
换一条：让模型给一条不同的建议 |
Esc |
忽略这条 |
↓ |
生成下一条建议（计入「最大切换次数」）；本轮已有后续建议时则免费前进。没有建议且输入框为空时直接拉一条。纯 ↓ 被系统/输入法吞掉时可用 Ctrl/⌘+↓ |
↑ |
回到本轮的上一条建议（免费） |
Ctrl/⌘+Shift+Space |
手动触发一次预测；已有建议时等同换一条 |
| 直接开始打字 | 建议消失；把草稿删空它还会回来（只有 Esc 是永久忽略） |
建议只在输入框为空、且当前会话不在运行中时出现；切换会话、中断回复都会清掉旧建议。
⚙️ 设置
设置 → 提示词联想：
| 设置项 | 说明 | 默认 |
|---|---|---|
| 启用联想 | 总开关 | 开 |
| 提供商 / 模型 | 联想调用使用的模型；选「跟随当前会话模型」则沿用会话自身模型 | 跟随当前会话模型 |
| 响应超时（高级） | 1–60 秒 | 12 秒 |
| 上下文规模（高级） | 少 3 条 / 标准 8 条 / 多 12 条 | 标准 8 条 |
| 上下文预算（高级） | 送进辅助调用的字符上限，1000–20000 | 6000 |
| 字数上限 | 建议写多长，按字符算（20–400），不用换算 token；选了英文/俄文等拉丁语言时会附带「约 N 个单词」的参考（中文/日文按字，不做词数换算）。Host 会按语言推导一个宽裕的 token 安全网，并把字数预算写进提示词；仍被截断时自动放宽重试，ghost 上会标 已截断 · 建议调高字数上限 | 120 |
| 保留多行格式 | 允许代码/列表保留换行与缩进；关闭后一律单行 | 开启 |
| 可切换提示词 | 开启后 ↓ 生成下一条、↑ 回到上一条（保留本轮历史）；关闭后方向键不切换，↻ 按钮也隐藏 | 开启 |
| 最大切换次数 | 每轮最多生成几条新建议（0–10，0 = 不限）；↑ 回看不计入 |
3 |
| 思考深度（高级） | 选项按真实使用的模型动态生成（跟随会话时按会话模型），模型不支持的档位不会出现 | 关闭（最快最省） |
| 建议语言 | 自动 跟随对话；也可固定成某种语言。下拉先列 14 种主流语言，其余收进「更多语言…」；带地区变体的语言会多出地区下拉：简体中文（中国大陆/新加坡/马来西亚）、繁體中文（台灣/香港）、English（美/英/澳/加）、Português（巴西/葡萄牙）、Español（西班牙/拉丁美洲（中性）/墨西哥/阿根廷/哥伦比亚）、Français（法國/加拿大）、Deutsch（德國/奧地利/瑞士）、Nederlands（荷蘭/比利時）。每个列表第一项就是该语言的默认地区，不再有含糊的「通用」。选中的变体会明确写进提示词（如 Traditional Chinese (Taiwan)、British English） |
自动 |
| 暂停预测 | 停止预测十分钟并显示倒计时，到点自动恢复；截止时间刷新后仍有效 | 关闭 |
| 记录条数（高级） | 设置页保留最近多少次预测记录（0–50，0 = 关闭历史）。记录存在应用自身的 localStorage（桌面端是 Electron 渲染层存储，Web 端是页面 localStorage；都只在本机、不上传） |
10 |
设置页底部是最近预测列表（默认 10 条，可调）：时间、哪个会话、所用模型、耗时，以及是否自动降级了思考档位 / 换过一条 / 被输出上限截断，失败时直接显示原因；列表默认只显示最新一条（▸ 展开全部 看其余），最新一条原文默认展开，点其它行的 ▸ 会展开它并自动收起上一条；记录存在应用自身的 localStorage（桌面端是 Electron 渲染层，Web 端是页面存储），不会上传——联想出问题时不必靠猜。
- 保存后立即生效，无需重启 DSH
- 设置落盘在
~/.dsh/dsh-prompt-predict/config.json（权限 600） - 优先级：用户保存的设置 > cordis patch 部署默认 > 内置默认
🔌 HTTP 接口
插件在 DSH 的 Web 服务上注册同源前缀路由 /dsh-prompt-predict，设置页与输入框联想都走它。所有接口都经 DSH 浏览器 Cookie 认证（connection.requestRejection），非本机浏览器调用会拿到 401/403。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /dsh-prompt-predict/status |
当前会话模型、有效设置、已保存项、部署默认 |
| GET | /dsh-prompt-predict/catalog |
全部 provider 与模型（供下拉选择） |
| 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，缺省即中文）：它决定校验错误与预测失败原因用哪种语言返回。客户端会自动带上当前界面语言。
🧩 工作原理
Host 端（lib/）
lib/index.js作为插件入口注册同源 HTTP 路由- 收到
suggest后，lib/predict.mjs从会话里裁出最近的 user/assistant 纯文本——按条数上限和字符预算从后往前取 - 裁剪结果被帧化成一条 request-only 的 user 输入再发给辅助模型：DSH 的 Assistant Message 必须带完整
stream/replayState，不能拿裁剪片段伪装成助手消息（与 session-title 的做法一致） - 流式收回的文本经归一化（剥掉代码块包装、
建议：前缀、成对引号，合并换行）后返回给客户端
模型选择上，provider / model 为 auto 表示跟随会话；此时不向辅助调用写死路由，由 predictNextPrompt 继承会话自身选用的模型。
客户端（client/）
- 注入
conversation.composer.dock（输入框旁的生命周期挂载点）与settings.section（设置页分区）两个 slot - ghost text 是一层覆盖层，不写进 Lexical 编辑器；只有采纳时才通过
inputActions.insertText真正插入
客户端源码结构
客户端由 client/src/ 里按顺序排列的片段拼接而成（npm run build:client 生成 client/client.js）。DSH 只加载单个客户端脚本，所以拆分只是开发期的组织方式、不是原生 ES module；pretest 和 prepack 会自动重建。
真实 DSH 冒烟（macOS，可选）
npm run test:smoke 会创建临时 DSH profile、把本仓库打成 tgz 装进去、启动本地 mock LLM，并用无头 Edge 通过 CDP 驱动真实 composer。验证：真实回复后出现 ghost、焦点在其它输入框时 Tab 不采纳、composer 聚焦时 Tab 采纳、reroll 换成新建议、暂停隐藏并在恢复后重现。需要安装 DeepSeek Harness App 与 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 项：51 项 Host 端 + 20 项客户端渲染冒烟
.
├── lib/ Host 端（纯 ESM，无构建步骤）
│ ├── index.js 插件入口，注册 HTTP 路由
│ ├── host-route.mjs 同源接口：状态 / 模型目录 / 思考档位 / 设置 / 建议
│ ├── predict.mjs 会话裁剪、调用辅助模型、建议归一化
│ ├── messages.mjs Host 端面向用户的文案（中英双语）
│ └── config.mjs 用户设置持久化
├── client/
│ └── client.js 客户端：输入框 ghost text 覆盖层 + 设置页
├── test/
│ ├── predict.mjs 51 项用例：文本裁剪、建议清洗、路由继承、设置校验、降级重试、去重、双语错误、接口端到端
│ └── client-render.mjs 20 项用例：极简 React 替身渲染 ghost 覆盖层与设置页，含中英双语与词典自检
├── scripts/
│ ├── install.sh 一键安装 / 升级
│ └── update.sh 把 profile 升级到 npm 最新版
├── cordis.patch.yml 插件挂载补丁
└── package.json
> test/client-render.mjs 是客户端唯一的自动化防线：它不依赖浏览器，用一个极简 React 替身把组件递归展开成对象树，断言 ghost 是否出现、Tab / ↻ / Esc 控件是否齐全。加它的直接原因是一个真实事故——覆盖层引用了没从 props 读出的变量，渲染时抛错被 error boundary 吞掉，表现是「接口正常返回建议但界面上永远没有」，而当时 Host 端用例全绿。
测试不依赖 DSH 运行时：用假 ctx 与本地 HTTP server 覆盖路由注册、设置校验、路由继承与端到端调用。
🔐 安全与成本
- 每轮助手回复默认产生一次小额辅助调用；只有在「撞到字数上限」「档位需降级」或「撞车需换一条」时才会多试一次，极端情况上限 4 次（主调用 + 档位降级 + 长度放宽 + 换一条），且共享同一个超时预算
- 建议不写入会话日志；只有按
Tab采纳并发送后才成为正式消息 - 只发送裁剪后的 user/assistant 纯文本，工具结果、附件、系统提示都不出本机
- 设置页与联想接口均走 DSH 自身的浏览器 Cookie 认证
🩺 排查
完全没有建议
- 它只在助手这一轮回复结束（约 350 ms 后）才触发，回复还在流式输出时不会有。
- 输入框必须是空的。你已经写了草稿时，预测会被有意跳过（也不会花调用）。
- 全新会话没有消息，没有可预测的内容。
- 看 设置 → 提示词联想：启用联想 是否打开、是否处于暂停、「最近预测」里有没有报错。
输入框下方出现「联想没成功：…」（连续两次失败才会出现）
| 原因文案 | 处理 |
|---|---|
Request timed out |
在「高级」里调大 响应超时 |
Provider "…" is unavailable / has no model "…" |
显式固定提供商与模型，不要「跟随会话模型」 |
Prompt prediction is turned off |
把开关打开 |
| 其它 | 打开 设置 → 提示词联想 → 最近预测，每行都带 Host 给出的具体原因 |
建议的语言不对
- 默认
自动：按最近五条消息逐条识别、取多数票，所以一条「主要是粘贴日志」的消息可能把结果带偏。 - 直接固定：设置 → 建议语言（中文、英文、葡语、西语、法语、德语、荷兰语还有 地区 二级选择）。
- 界面语言不影响建议语言，这是两个独立设置。
建议末尾出现「已截断 · 建议调高字数上限」
- 调高 字数上限。出现标记之前，插件已经自动放宽过一次预算重试。
- 推理型模型可能在开始写之前就把预算花掉一大截；经常出现的话，调高字数上限，或保持 思考深度 为关闭（默认）。
按 Tab 没反应
- 只在有建议显示时才会拦截
Tab；没有灰字时Tab是正常行为。 - 先点一下输入框——覆盖层是对着编辑器的光标框定位的，
Tab也作用于聚焦中的编辑器。
灰字压在已输入的文字上
0.2.7已修：粘贴、输入法合成、拖拽都会立刻隐藏，而且输入框已有草稿时不再显示。还遇到请升级。
「最近预测」是空的
- 记录存在应用自己的本地存储里，点 清空 会删掉；
0.2.5之前的记录没有建议原文。
升级了却没变化
- Host 侧改动（设置项、提示词构造）需要重启 App；客户端改动刷新窗口即可。刷新窗口不会改写
package.json里的版本号。
⚠️ 已知限制
- 仅在 DSH
0.2.1-rc.3上验证过，其它版本未测 - 依赖宿主的
conversation.composer.dock与settings.section两个 slot 名称，DSH 大版本调整后可能需要适配 - 联想会消耗所选模型的额度；固定到快速小模型比跟随推理模型更省
📄 许可
MIT © ferrisching
可以自由使用、修改、分发，包括闭源商业项目；只需保留版权声明与许可证文本。
变更记录见 CHANGELOG_zh.md（English）。
