dsh-prompt-predict 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -4,11 +4,27 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the version numbers follow
 [Semantic Versioning](https://semver.org/).
 
-[中文](CHANGELOG.zh.md)
+[中文](CHANGELOG_zh.md)
 
-## [0.2.0] — Unreleased
+### Fixed
+
+- **The suggestion is now an in-dock row instead of a fixed overlay.** DSH `0.2.1-rc.2` stopped
+  exposing the composer draft through the slot's `useInput`, so the overlay kept showing while
+  typing; and because it was positioned from `getBoundingClientRect` it vanished whenever that
+  measurement failed. The row lives in `conversation.composer.dock` — space the host allocates —
+  and hides on the first printable keypress, which needs no draft state.
+- Verified on DSH `0.2.1-rc.2`.
+
+## [0.2.1] — 2026-10-17
+
+### Fixed
+
+- **The npm package page rendered the Chinese README.** npm picks the first `README.*` match in
+  glob order, and `README.zh.md` sorts before `README.md`, so the Chinese file won. The Chinese
+  README is now `README_zh.md`, which npm's `{README,README.*}` pattern does not match, so
+  `README.md` (English) is always the one published. Supersedes `0.2.0`; no code changes.
 
-> The code is on `main`; it is not published to npm yet (npm still serves `0.1.0`). The date will be added here once released.
+## [0.2.0] — 2026-10-17
 
 ### Added
 
@@ -35,10 +51,10 @@ All notable changes to this project are documented here. The format follows
 
 ### Docs
 
-- English README is now the primary `README.md` (Chinese moved to `README.zh.md`, 11 sections each, cross-linked)
+- English README is now the primary `README.md` (Chinese moved to `README_zh.md`, 11 sections each, cross-linked)
 - README gained the in-DSH install route, npm install and badges, the four interactions, and the new settings
 - New demo assets: `docs/demo.gif`, `docs/screenshot.png`, `docs/social-preview.png`
-- This file (`CHANGELOG.md` / `CHANGELOG.zh.md`)
+- This file (`CHANGELOG.md` / `CHANGELOG_zh.md`)
 
 ## [0.1.0] — 2026-10-17
 

package/{CHANGELOG.zh.md → CHANGELOG_zh.md}

@@ -5,9 +5,23 @@
 
 [English](CHANGELOG.md)
 
-## [0.2.0] — 未发布
+### 修复
+
+- **建议改为在 composer dock 内的一行，不再用 fixed 覆盖层。** DSH `0.2.1-rc.2` 不再通过 slot 的
+  `useInput` 暴露草稿，覆盖层会在打字时继续显示；而它靠 `getBoundingClientRect` 定位，一旦算不出
+  坐标就整个消失。新实现放在 `conversation.composer.dock`（宿主分配好的空间），并在第一个可打印
+  按键时隐藏——不依赖草稿状态。
+- 已在 DSH `0.2.1-rc.2` 上验证。
+
+## [0.2.1] — 2026-10-17
+
+### 修复
+
+- **npm 包页显示的是中文 README**。npm 按 glob 取第一个 `README.*` 匹配，而 `README.zh.md`
+  排序在 `README.md` 之前，于是中文版被选中。中文版改名 `README_zh.md` 后不再匹配
+  `{README,README.*}`，npm 必然选到英文的 `README.md`。取代 `0.2.0`，无代码改动。
 
-> 代码已在 `main` 分支，尚未发布到 npm（npm 上仍是 `0.1.0`）。发布后本节会补上日期。
+## [0.2.0] — 2026-10-17
 
 ### 新增
 
@@ -34,10 +48,10 @@
 
 ### 文档
 
-- 英文版升为主 `README.md`（中文移到 `README.zh.md`，两侧 11 节逐节对应并互链）
+- 英文版升为主 `README.md`（中文移到 `README_zh.md`，两侧 11 节逐节对应并互链）
 - README 补充「在 DSH 里安装」、npm 安装方式与徽章、四种交互说明、新设置项
 - 演示素材重录为含 `↻` / `Alt+→` 的新界面：`docs/demo.gif`、`docs/screenshot.png`、`docs/social-preview.png`
-- 本文件（`CHANGELOG.md` / `CHANGELOG.zh.md`）
+- 本文件（`CHANGELOG.md` / `CHANGELOG_zh.md`）
 
 ## [0.1.0] — 2026-10-17
 

package/README.md

@@ -6,14 +6,14 @@
   <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>
 </div>
 
 <div align="center">
-  🌏 <a href="./README.zh.md">中文</a> · <b>English</b>
+  🌏 <a href="./README_zh.md">中文</a> · <b>English</b>
 </div>
 
 <div align="center">
@@ -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.1
 ```
 
-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.1 --repo ferrisching/dsh-prompt-predict --pattern '*.tgz'
+dsh plugin --profile desktop add ./dsh-prompt-predict-0.2.1.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
 
@@ -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
 
@@ -213,4 +233,4 @@ The tests need no DSH runtime: a fake ctx plus a local HTTP server cover route r
 
 Free to use, modify and distribute, including in closed-source commercial projects — just keep the copyright notice and license text.
 
-See [CHANGELOG.md](./CHANGELOG.md) for the change history ([中文](./CHANGELOG.zh.md)).
+See [CHANGELOG.md](./CHANGELOG.md) for the change history ([中文](./CHANGELOG_zh.md)).

package/{README.zh.md → 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.1
 ```
 
-`--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.1 --repo ferrisching/dsh-prompt-predict --pattern '*.tgz'
+dsh plugin --profile desktop add ./dsh-prompt-predict-0.2.1.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 未验证
 
@@ -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 大版本调整后可能需要适配
 - 联想会消耗所选模型的额度；固定到快速小模型比跟随推理模型更省
 
@@ -213,4 +231,4 @@ npm test        # 66 项：51 项 Host 端 + 15 项客户端渲染冒烟
 
 可以自由使用、修改、分发，包括闭源商业项目；只需保留版权声明与许可证文本。
 
-变更记录见 [CHANGELOG.zh.md](./CHANGELOG.zh.md)（[English](./CHANGELOG.md)）。
+变更记录见 [CHANGELOG_zh.md](./CHANGELOG_zh.md)（[English](./CHANGELOG.md)）。

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,7 +513,37 @@ window.__ModuleLoader__.load({
 
       // 建议直接以灰色 ghost text 覆盖在 Lexical 输入框首字符处。
       if (!enabled || dismissedByDraft.current || !visibleSuggestion) return null;
-      return h(GhostOverlay, { suggestion: visibleSuggestion, sessionId: sessionId, onAccept: accept, onReroll: reroll, t: t });
+      // 在 composer dock 的流内渲染一行建议（不再用 fixed 覆盖层）：
+      // dock 是宿主分配了空间的位置，不依赖 findElement 算坐标，也不会压在草稿文字上。
+      return h("div", {
+        "data-prompt-predict-row": "true",
+        role: "status",
+        "aria-live": "polite",
+        style: {
+          display: "flex", alignItems: "center", gap: 8, minWidth: 0,
+          padding: "2px 4px", fontSize: 12, lineHeight: "18px", color: "#9aa3b2",
+        },
+      },
+        h("span", {
+          style: { flex: 1, minWidth: 0, whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" },
+        }, visibleSuggestion),
+        h("button", {
+          type: "button", onClick: accept, title: tt(t, "ghost.acceptHint"),
+          style: {
+            flex: "none", padding: "0 7px", height: 19, borderRadius: 5,
+            border: "1px solid var(--dsw-alias-border-l1, #d1d5db)", background: "var(--dsw-alias-bg-secondary, #f8fafc)",
+            color: "#9aa3b2", fontSize: 10, fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace", cursor: "pointer",
+          },
+        }, "Tab"),
+        h("button", {
+          type: "button", onClick: reroll, title: tt(t, "ghost.reroll"),
+          style: {
+            flex: "none", width: 19, height: 19, padding: 0, borderRadius: 5,
+            border: "1px solid var(--dsw-alias-border-l1, #d1d5db)", background: "var(--dsw-alias-bg-secondary, #f8fafc)",
+            color: "#9aa3b2", fontSize: 11, lineHeight: 1, cursor: "pointer",
+          },
+        }, "↻"),
+        h("span", { style: { flex: "none", fontSize: 10, whiteSpace: "nowrap" } }, tt(t, "ghost.dismiss")));
     }
 
     // ================= 设置页 =================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prompt-predict",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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",
@@ -16,9 +16,9 @@
     "client",
     "cordis.patch.yml",
     "README.md",
-    "README.zh.md",
+    "README_zh.md",
     "CHANGELOG.md",
-    "CHANGELOG.zh.md"
+    "CHANGELOG_zh.md"
   ],
   "scripts": {
     "test": "node test/predict.mjs && node test/client-render.mjs",