dsh-prompt-predict 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -6,6 +6,28 @@ All notable changes to this project are documented here. The format follows
 
 [中文](CHANGELOG_zh.md)
 
+## [0.2.3] — 2026-10-18
+
+### Fixed
+
+- **The suggestion is visible again.** `0.2.2` drew it as a row inside `conversation.composer.dock`;
+  the row rendered in tests and `Tab` accepted it, but it was **invisible in the real app**, so
+  rendering went back to the original overlay.
+- **The ghost text disappears as soon as you start typing.** DSH `0.2.1-rc.2` stopped exposing the
+  composer draft through the slot's `useInput` (it now returns the Lexical input state), so the
+  overlay stayed on screen and sat on top of what you were writing. It now hides on the first
+  printable keypress, which needs no draft state at all, and comes back with the next prediction.
+- Verified end to end on DSH `0.2.1-rc.2`: the suggestion appears after a reply, and the first
+  keystroke removes it.
+
+## [0.2.2] — 2026-10-18 (deprecated)
+
+### Changed
+
+- The suggestion was drawn as a row inside `conversation.composer.dock` instead of a fixed overlay.
+  **Deprecated:** that row turned out not to be visible in the real app. Use `0.2.3` instead.
+
+
 ## [0.2.1] — 2026-10-17
 
 ### Fixed

package/CHANGELOG_zh.md

@@ -5,6 +5,25 @@
 
 [English](CHANGELOG.md)
 
+## [0.2.3] — 2026-10-18
+
+### 修复
+
+- **建议重新可见。** `0.2.2` 把它画成 `conversation.composer.dock` 里的一行；这一行在测试里能渲染、
+  `Tab` 也能采纳，但在**真实 app 里看不见**，所以渲染退回原来的覆盖层。
+- **一开始打字，ghost 提示就消失。** DSH `0.2.1-rc.2` 不再通过 slot 的 `useInput` 暴露草稿
+  （现在返回的是 Lexical 输入态），覆盖层会一直留在屏幕上、压住你正在写的内容。现在改为在第一个
+  可打印按键时隐藏——完全不依赖草稿状态——下一次预测到达时再出现。
+- 已在 DSH `0.2.1-rc.2` 上端到端验证：回复结束后出现建议，第一个按键后消失。
+
+## [0.2.2] — 2026-10-18（已弃用）
+
+### 变更
+
+- 建议改为画在 `conversation.composer.dock` 内的一行，不再是 fixed 覆盖层。
+  **已弃用：** 这一行在真实 app 里看不见。请使用 `0.2.3`。
+
+
 ## [0.2.1] — 2026-10-17
 
 ### 修复

package/README.md

@@ -6,7 +6,7 @@
   <a href="https://www.npmjs.com/package/dsh-prompt-predict"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-prompt-predict" /></a>
   <a href="https://www.npmjs.com/package/dsh-prompt-predict"><img alt="npm downloads" src="https://img.shields.io/npm/dm/dsh-prompt-predict" /></a>
   <a href="https://github.com/ferrisching/dsh-prompt-predict/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/ferrisching/dsh-prompt-predict" /></a>
-  <img alt="Verified on DSH 0.2.0-rc.2" src="https://img.shields.io/badge/DSH-0.2.0--rc.2-4d6bfe" />
+  <img alt="Verified on DSH 0.2.1-rc.2" src="https://img.shields.io/badge/DSH-0.2.1--rc.2-4d6bfe" />
   <img alt="Zero runtime dependencies" src="https://img.shields.io/badge/dependencies-zero%20runtime-41ba41" />
   <img alt="Host + client plugin" src="https://img.shields.io/badge/shape-host%20%2B%20client-8250df" />
   <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
@@ -54,15 +54,35 @@ The plugin is published on npm. Options are ordered by convenience.
 
 **GUI**: open the plugins page → **Add plugin** → enter the package name `dsh-prompt-predict` → install.
 
-**Or the dsh CLI**:
+**Or the dsh CLI** — pin any published version with pnpm's `@version` syntax:
 
 ```bash
-dsh plugin --profile desktop add dsh-prompt-predict
+dsh plugin --profile desktop add dsh-prompt-predict@0.2.3
 ```
 
-Replace `--profile` with your own profile (usually `desktop` on the desktop app, `web` for the web build). Both routes pull from npm; **restart DSH afterwards**.
+Replace `--profile` with your own profile (usually `desktop` on the desktop app, `web` for the web build), then **restart DSH**.
 
-> You'll find the switch and all parameters under **Settings → Prompt Suggestions**. If the plugin doesn't show up, re-run `scripts/install.sh` below to wire it up (idempotent).
+> ⚠️ **The CLI only installs the package.** DSH loads a plugin only when it is also listed in
+> `dsh.profile.bundles` inside `~/.dsh/profiles/<profile>/package.json`. Verified: with the package
+> installed but not in that list, the plugin's routes answer `404` and nothing loads. The GUI route
+> above handles it for you; with the CLI add `"dsh-prompt-predict"` to that array yourself, or just
+> run `scripts/install.sh` below, which does both steps.
+
+> You'll find the switch and all parameters under **Settings → Prompt Suggestions**.
+
+### Install from a release tarball
+
+Every [release](https://github.com/ferrisching/dsh-prompt-predict/releases) carries the exact
+tarball that is on npm (`shasum` matches the registry), which is handy for offline machines or for
+pinning an artifact you can verify:
+
+```bash
+gh release download v0.2.3 --repo ferrisching/dsh-prompt-predict --pattern '*.tgz'
+dsh plugin --profile desktop add ./dsh-prompt-predict-0.2.3.tgz
+```
+
+Same caveat as the CLI route above: add `"dsh-prompt-predict"` to `dsh.profile.bundles` yourself,
+or run `scripts/install.sh` instead.
 
 ### Install from source
 
@@ -93,7 +113,7 @@ Then open that profile's `package.json` and add `"dsh-prompt-predict"` to the `d
 
 ### Requirements
 
-- Verified on **DSH `0.2.0-rc.2`** (desktop)
+- Verified on **DSH `0.2.1-rc.2`** (web build; the desktop app runs the same host and client code)
 - `node` / `pnpm`: the install script prefers DSH's own runtime under `~/.dsh/dsh-runtimes/*/dependencies` and only falls back to `PATH`
 - macOS / Linux; Windows untested
 
@@ -168,7 +188,7 @@ For model selection, `provider` / `model` set to `auto` means "follow the sessio
 ```bash
 git clone https://github.com/ferrisching/dsh-prompt-predict.git
 cd dsh-prompt-predict
-npm test        # 66 cases: 51 host-side + 15 client render smoke tests
+npm test        # 71 cases: 51 host-side + 20 client render smoke tests
 ```
 
 ```
@@ -183,7 +203,7 @@ npm test        # 66 cases: 51 host-side + 15 client render smoke tests
 │   └── 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  15 cases: renders the ghost overlay and settings page through a tiny React stand-in, incl. both locales and dictionary self-checks
+│   └── 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 / upgrade
 ├── cordis.patch.yml     Plugin mount patch
@@ -203,7 +223,7 @@ The tests need no DSH runtime: a fake ctx plus a local HTTP server cover route r
 
 ## ⚠️ Known limitations
 
-- Verified only on DSH `0.2.0-rc.2`; other versions untested
+- Verified only on DSH `0.2.1-rc.2`; other versions untested
 - Depends on the host's `conversation.composer.dock` and `settings.section` slot names — a major DSH update may require adapting
 - Predictions consume quota on the selected model; pinning a fast small model is cheaper than following a reasoning model
 

package/README_zh.md

@@ -6,7 +6,7 @@
   <a href="https://www.npmjs.com/package/dsh-prompt-predict"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-prompt-predict" /></a>
   <a href="https://www.npmjs.com/package/dsh-prompt-predict"><img alt="npm downloads" src="https://img.shields.io/npm/dm/dsh-prompt-predict" /></a>
   <a href="https://github.com/ferrisching/dsh-prompt-predict/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/ferrisching/dsh-prompt-predict" /></a>
-  <img alt="已验证 DSH 0.2.0-rc.2" src="https://img.shields.io/badge/DSH-0.2.0--rc.2-4d6bfe" />
+  <img alt="已验证 DSH 0.2.1-rc.2" src="https://img.shields.io/badge/DSH-0.2.1--rc.2-4d6bfe" />
   <img alt="零运行时依赖" src="https://img.shields.io/badge/%E4%BE%9D%E8%B5%96-%E9%9B%B6%E8%BF%90%E8%A1%8C%E6%97%B6%E4%BE%9D%E8%B5%96-41ba41" />
   <img alt="客户端 + Host 双端插件" src="https://img.shields.io/badge/%E5%BD%A2%E6%80%81-Host%20%2B%20%E5%AE%A2%E6%88%B7%E7%AB%AF%E6%8F%92%E4%BB%B6-8250df" />
   <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
@@ -54,15 +54,33 @@
 
 **图形界面**：打开插件页 →「添加插件」→ 填入包名 `dsh-prompt-predict` → 安装。
 
-**或者用 dsh CLI**：
+**或者用 dsh CLI**——想装某个已发布版本就用 pnpm 的 `@版本` 语法：
 
 ```bash
-dsh plugin --profile desktop add dsh-prompt-predict
+dsh plugin --profile desktop add dsh-prompt-predict@0.2.3
 ```
 
-`--profile` 换成你自己的 profile（桌面端一般是 `desktop`，Web 端是 `web`）。两条路都是从 npm 拉取；**装完重启 DSH 生效**。
+`--profile` 换成你自己的 profile（桌面端一般是 `desktop`，Web 端是 `web`），**装完重启 DSH 生效**。
 
-> 装完在 **设置 → 提示词联想** 里能看到开关与各项参数。若装完没生效，用下面的 `scripts/install.sh` 再跑一次补接线（幂等，可重复执行）。
+> ⚠️ **CLI 只负责装包。** DSH 只有在 `~/.dsh/profiles/<profile>/package.json` 的
+> `dsh.profile.bundles` 里也列出该插件时才会加载它。实测：包装了但不在该列表里，插件路由返回 `404`，
+> 什么都不会加载。上面的图形界面路径会替你处理；用 CLI 的话请自己把 `"dsh-prompt-predict"` 加进该数组，
+> 或直接跑下面的 `scripts/install.sh`——它两步都做。
+
+> 装完在 **设置 → 提示词联想** 里能看到开关与各项参数。
+
+### 从 release 的 tarball 安装
+
+每个 [release](https://github.com/ferrisching/dsh-prompt-predict/releases) 都附了与 npm 上
+**完全一致**的 tarball（`shasum` 与 registry 相同），适合离线机器或需要自行校验产物的场景：
+
+```bash
+gh release download v0.2.3 --repo ferrisching/dsh-prompt-predict --pattern '*.tgz'
+dsh plugin --profile desktop add ./dsh-prompt-predict-0.2.3.tgz
+```
+
+与上面 CLI 路径同样的注意点：请自己把 `"dsh-prompt-predict"` 加进 `dsh.profile.bundles`，
+或改用 `scripts/install.sh`。
 
 ### 从源码安装
 
@@ -93,7 +111,7 @@ pnpm add /path/to/dsh-prompt-predict
 
 ### 安装要求
 
-- 已在 **DSH `0.2.0-rc.2`** 上验证（桌面端）
+- 已在 **DSH `0.2.1-rc.2`** 上验证（Web 构建；桌面端跑的是同一套 host 与 client 代码）
 - `node` / `pnpm`：安装脚本优先使用 `~/.dsh/dsh-runtimes/*/dependencies` 下 DSH 自带的运行时，找不到才回退 `PATH`
 - macOS / Linux；Windows 未验证
 
@@ -168,7 +186,7 @@ pnpm add /path/to/dsh-prompt-predict
 ```bash
 git clone https://github.com/ferrisching/dsh-prompt-predict.git
 cd dsh-prompt-predict
-npm test        # 66 项：51 项 Host 端 + 15 项客户端渲染冒烟
+npm test        # 71 项：51 项 Host 端 + 20 项客户端渲染冒烟
 ```
 
 ```
@@ -183,7 +201,7 @@ npm test        # 66 项：51 项 Host 端 + 15 项客户端渲染冒烟
 │   └── client.js        客户端：输入框 ghost text 覆盖层 + 设置页
 ├── test/
 │   ├── predict.mjs      51 项用例：文本裁剪、建议清洗、路由继承、设置校验、降级重试、去重、双语错误、接口端到端
-│   └── client-render.mjs  15 项用例：极简 React 替身渲染 ghost 覆盖层与设置页，含中英双语与词典自检
+│   └── client-render.mjs  20 项用例：极简 React 替身渲染 ghost 覆盖层与设置页，含中英双语与词典自检
 ├── scripts/
 │   └── install.sh       一键安装 / 升级
 ├── cordis.patch.yml     插件挂载补丁
@@ -203,7 +221,7 @@ npm test        # 66 项：51 项 Host 端 + 15 项客户端渲染冒烟
 
 ## ⚠️ 已知限制
 
-- 仅在 DSH `0.2.0-rc.2` 上验证过，其它版本未测
+- 仅在 DSH `0.2.1-rc.2` 上验证过，其它版本未测
 - 依赖宿主的 `conversation.composer.dock` 与 `settings.section` 两个 slot 名称，DSH 大版本调整后可能需要适配
 - 联想会消耗所选模型的额度；固定到快速小模型比跟随推理模型更省
 

package/client/client.js

@@ -361,6 +361,10 @@ window.__ModuleLoader__.load({
       var abortRef = useRef(null);
       var sessionRef = useRef(sessionId);
       var dismissedByDraft = useRef(false);
+      // rc.2 不再把 draft 暴露给 slot，拿不到「输入框是否为空」。
+      // 用等价信号：建议可见时按下任何可打印键 = 用户开始输入 → 立即隐藏。
+      var _tk = useState(0), typedTick = _tk[0], setTypedTick = _tk[1];
+      var typedSince = useRef(false);
       // 逐段采纳的前缀，只有「输入框里确实还留着它」时才算数：
       // 用户把它删掉后必须重新完整展示整条建议，否则会出现从中间截断的鬼影。
       var prefixKept = accepted !== "" && suggestion.indexOf(accepted) === 0 && draft === accepted;
@@ -368,7 +372,7 @@ window.__ModuleLoader__.load({
       // 打字即隐藏，两种例外：
       //   (a) 草稿又被删空 —— 用户回到了「需要建议」的状态，让它重新浮现（只有 Esc 才是永久忽略）
       //   (b) 草稿正是我们逐段写进去、且没有改动的前缀 —— 不能把自己插的内容误判成用户打字
-      dismissedByDraft.current = draft.trim() !== "" && !prefixKept;
+      dismissedByDraft.current = (draft.trim() !== "" || typedSince.current) && !prefixKept;
       var visibleSuggestion = dismissedByDraft.current ? "" : remaining;
 
       // 首次读取启用状态；设置页保存后通过事件让当前会话立即生效。
@@ -395,6 +399,7 @@ window.__ModuleLoader__.load({
         dismissedByDraft.current = false;
         setSuggestion("");
         setAccepted("");
+        typedSince.current = false;
         if (abortRef.current) abortRef.current.abort();
       }, [sessionId]);
 
@@ -405,6 +410,7 @@ window.__ModuleLoader__.load({
           dismissedByDraft.current = false;
           setSuggestion("");
           setAccepted("");
+          typedSince.current = false;
           if (abortRef.current) abortRef.current.abort();
           return;
         }
@@ -418,6 +424,7 @@ window.__ModuleLoader__.load({
             .then(function (result) {
               if (controller.signal.aborted || sessionRef.current !== sessionId) return;
               if (result && result.ok && typeof result.suggestion === "string") {
+                typedSince.current = false;
                 setSuggestion(result.suggestion.trim());
                 recordRun(result, null);
               } else {
@@ -483,6 +490,11 @@ window.__ModuleLoader__.load({
         var onKey = function (event) {
           if (event.isComposing) return;
           if (event.key === "Escape") { event.preventDefault(); setSuggestion(""); setAccepted(""); return; }
+          // 任何可打印字符 → 认定用户开始输入，隐藏建议（与「开始输入自动消失」一致）
+          if (!typedSince.current && typeof event.key === "string" && event.key.length === 1 && !event.ctrlKey && !event.metaKey && !event.altKey) {
+            typedSince.current = true;
+            setTypedTick(function (n) { return n + 1; });
+          }
           // Option/Alt + → ：逐段采纳（对齐 Codex 的手感）
           if (event.key === "ArrowRight" && event.altKey) {
             if (!acceptChunk()) return;
@@ -501,6 +513,8 @@ window.__ModuleLoader__.load({
 
       // 建议直接以灰色 ghost text 覆盖在 Lexical 输入框首字符处。
       if (!enabled || dismissedByDraft.current || !visibleSuggestion) return null;
+      // 回到覆盖层：它在真实环境里是可见的（dock 内联行实测看不见）。
+      // 「打字即隐藏」由上面的 typedSince 信号负责，不再依赖草稿状态。
       return h(GhostOverlay, { suggestion: visibleSuggestion, sessionId: sessionId, onAccept: accept, onReroll: reroll, t: t });
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prompt-predict",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "输入框提示词联想插件：助手回复结束后预测你的下一句话，以灰色 ghost text 浮在输入框里，Tab 采纳、Esc 忽略 ｜ Codex-style composer prompt predictions for DeepSeek Harness: your next message ghosted into the composer, accepted with Tab.",
   "type": "module",
   "main": "lib/index.js",