下一条建议 ihodorchenko/dsh-next-prompt

dsh-next-prompt

在 DeepSeek Harness 的消息输入框里，给出下一条建议消息。

每次智能体回复之后，插件会生成一条简短的下一条消息候选，用灰色的「幽灵」文字直接显示在输入框里——就显示在平时放 placeholder 的位置。按 Tab（或点击这段文字）把候选填进输入框，然后编辑或发送；按 Esc 隐藏。在你确认之前，消息不会自动发出，也不会改动对话。

插件由两部分组成：

| 部分 | 位置 | 作用 |
| index.js（Host） | Host 进程（Node） | 监听根会话的 turn/end，收集最后一个问题和回答，向模型发一次小请求，要 2–3 条下一条消息候选；模型不可用时给出启发式候选。通过 GET /next-prompt/suggest 把结果交给浏览器。 |
| lib/client.js（Client） | Web GUI（浏览器） | 在输入框卡片的 conversation.input.overlay 插槽注册组件，显示幽灵文字，处理 Tab/点击/Esc，并通过 inputActions.setDraft 填入文本。 |

不往会话日志里写任何东西，不给模型添加工具，不改动历史。

安装

通过 Plugin Manager / 命令行（推荐）

dsh plugin --profile desktop add link:/absolute/path/to/dsh-next-prompt

命令会把 link: 依赖加进配置档，并在看到 dsh.bundle.patch 后把 dsh-next-prompt 写进 dsh.profile.bundles——包自带的 patch 层会在构建配置档时插入插件那一行。开启 HMR 时，配置档会重新构建，不用重启应用。

从 GitHub 安装（和 Plugins 页面按 git 地址安装做的事一样）：

dsh plugin --profile desktop add git+https://github.com/ihodorchenko/dsh-next-prompt.git

也可以在 Web GUI 里操作：Plugins → 按 spec link:/absolute/path/to/dsh-next-prompt 或 git 地址安装。

手动安装

在 ~/.dsh/profiles/<profile>/cordis.patch.yml 里加上：

- insert:
- id: next-prompt
name: dsh-next-prompt

并确认配置档能访问到这个包（配置档 package.json 里有 link: 依赖 + dsh.profile.bundles 含 dsh-next-prompt，或者包就在配置档的 node_modules 里）。

手动挂载、不走 bundle 通道时，客户端部分照样能被加载：客户端模块系统会扫描 Loader 里启用的行，并通过 /plugins 提供 lib/client.js。

更新与迁移

用 link: 方式安装时，配置档指向插件目录：改完 index.js/lib/client.js 后，只要触碰一下文件即可（HMR 会重新构建配置档），但移动或删除目录会破坏安装——请从新路径重新安装插件。Git 安装通过 Plugin Manager（Update）或再次执行 dsh plugin add 更新。

配置

所有字段都可选；默认值见下表。

| 字段 | 默认值 | 含义 |
| enabled | true | false — Host 不生成也不返回提示。 |
| maxSuggestions | 3 | 向模型请求多少个候选。输入框里只显示最好的那个。 |
| showGhost | true | 是否在输入框里显示幽灵文本（false — 只走 API，不显示 UI）。 |
| language | auto | auto — 跟随对话语言；ru/en — 强制指定。 |
| model | '' | 留空 — 用会话最后一次请求的模型，否则用配置档的默认模型。支持两种写法：provider/model（例如 deepseek-account/deepseek-flash）和裸模型 id（服务商取自会话/配置档）。 |
| minAnswerChars | 40 | 回答太短时不生成候选。 |

HTTP 路由前缀固定：/next-prompt（客户端那一半直接访问它）。

示例：

- insert:
- id: next-prompt
name: dsh-next-prompt
config:
language: ru
maxSuggestions: 3
model: deepseek-account/deepseek-flash

模型不可用时（没有密钥、适配器报错、超时）——改用启发式候选，按回答文本和对话语言挑选；插件从不阻塞界面，也不会打断会话进程。

行为

- 候选只在输入框为空且本轮结束时出现；已输入的文字、附件和草稿不会被覆盖。
- 智能体工作期间不显示文本；用户发新消息后，旧候选重置。
- 输入字符、发送消息、切换会话、按 Esc —— 都会隐藏提示。
- 点击幽灵文本或在输入框按 Tab，会通过标准 inputActions.setDraft 把它作为普通草稿插入——之后它就是普通文本：可以编辑，按 Enter 发送。
- 如果拿不到输入框的 DOM（app 版本不同、布局不同）——组件静默地什么都不画。

实现原理（简述）

1. Host 监听 session/event；在 turn/end 且原因为 completed 时（且不是子代理会话），收集最后一条 user/message 和 assistant/message。
2. 通过 ctx.llm.stream() 服务发一次短请求（system + 最近几条消息，限制输出长度），解析 JSON 候选数组；任何错误都退回启发式。
3. 结果存进 per-session 内存，由 GET /next-prompt/suggest?session=<id> 返回（Cache-Control: no-store）；GET /next-prompt/config 返回配置。
4. Client 在 conversation.input.overlay 插槽里监听 useSessionStatus()（running 从 true 变 false）和 useInput()（草稿为空、phase: "plain"），发 fetch 并重试，直到 Host 不再返回 pending: true。
5. 幽灵文本按真实的 [data-composer-placeholder] 定位：测量 getBoundingClientRect()，复制 computed font styles，因此文本在任何主题下位置和字体都一致；真正的 placeholder 会暂时隐藏，清空后恢复。
6. 接受方式——Tab（在冒泡阶段：仅当提示可见、输入框获得焦点且为空、没有打开的菜单、没有 IME 组合输入和修饰键时）或点击。

开发

dsh-next-prompt/
├── index.js # Host-половина (ESM, без зависимостей)
├── lib/client.js # клиентский half (lazy-CJS, без сборки)
├── cordis.patch.yml # bundle-слой: вставка строки плагина
├── locale/ # метаданные для Plugin Manager (en, ru)
├── test/ # тесты без зависимостей: node test/run.mjs
└── .github/workflows/ci.yml # CI: Node 20/22/24

测试（host 黑盒、bundle 格式校验、fake DOM/React 渲染）：

node test/run.mjs

跑测试不需要 npm install——只要 Node 20+。细节见 test/README.md。变更记录见 CHANGELOG.md。

改动 index.js/lib/client.js 后，用 link: 方式安装时只需更新文件：配置档的 HMR 观察器会重新构建插件（有时需要触碰文件或刷新 GUI 页面）。

限制

- 「幽灵」文本是覆盖在 placeholder 上的 overlay 元素，不是 Lexical 编辑器的内容：在接受之前，它不进 undo 历史，也不算草稿。
- 输入框里只显示第一个（最佳）候选；完整数组可通过 API（/next-prompt/suggest）获取。
- 候选不会在应用重启之间缓存；重启后要等到下一次回答才会有提示。
- 幽灵层针对 web-GUI 的标准输入框设计；如果其他主题/插件改动了输入框的标记结构，这一层可能不可见（不会报错）。

诊断

- 检查 route 是否存活：curl 'http://127.0.0.1:<port>/next-prompt/config'。
- 检查客户端部分是否进入依赖图：SSE GET /plugins/events——entries 里应有 dsh-next-prompt 一行，其 url 指向 client.js。
- 如果提示不出现：确认本轮已结束（不是「已停止」）、输入框为空、插件已在 Plugins 中启用，且 config.enabled 不是 false。

每次回答后，在 DeepSeek Harness 的消息输入框里以幽灵文本形式显示建议的下一条提示词。Host 部分监听已完成的轮次，向模型请求几条简短建议（带启发式回退），并在 /next-prompt/suggest 提供；Client 部分把最佳的一条渲染到输入框 placeholder 之上，按 Tab 或点击即可插入。不会自动发送任何内容，会话日志和模型上下文都不受影响。配置见上表；安装用 dsh plugin --profile <name> add link:<dir>。

许可证

MIT