@yfwu2020/dsh-selection-explain 0.4.0 → 0.7.0

package/README.md

@@ -113,6 +113,9 @@
 - **只挂引用、一个字不写也能发**：这时用一句兜底提问（"就上面引用的文字，说说它在这里是什么意思。"），不会空发。
 - **只属于下一条提问**：发出即清空；换一段新的选中文字、或从「最近」回放另一段对话时也会清掉（那些引用属于上一次对话）。
 - **小窗开着时浮标就是「引用」**：要解读新的一段，先按 `Esc` 收起小窗再划词——避免两个小窗抢同一处选区。
+- **点完「✦ 解读」那行高亮会立刻收掉**（`Esc`、重开也一样）：小窗顶部本来就写着选中文字，留着高亮反而碍事——
+  小窗亮着时它是「活的选区」，在输入框里按一下方向键就会又冒出一个「❝ 引用」，指的却是刚才解读的那段。
+  要引用它，重新划一次即可（那时浮标才是「❝ 引用」）。
 - 引用会**进历史、也进升格**：回放这段对话时引用块跟着回来（以拼好的原文形式），升格出来的正式会话里同样带着。
 
 ### 输出偏好：Markdown ↔ 网页
@@ -149,7 +152,11 @@
 
 ### 悬浮状态胶囊
 
-右下角一枚胶囊显示"最近一次划词现在什么状态"（进行中报阶段和秒数、其余报结果），点一下回到那个小窗。它会自动贴到费用胶囊上方。
+右下角一枚胶囊显示"最近一次划词现在什么状态"（进行中报阶段和秒数、其余报结果），点一下回到那个小窗。它会自动贴到费用胶囊上方，宽度也跟着它走（同宽同位置）；**没装**费用胶囊（dsh-spend）时，宽度收到 200px —— 独处右下角时不至于横着一条。宽度不够时先省"选中的是哪个词"（省略号收尾），状态和箭头永远完整。
+
+还能**拖动**：按住拖到别处就留在那儿（**位置记在 host 上**，刷新/重载后回到那儿；拖回右下角就清掉）（贴角那套定位不再动它，窗口缩小时也会夹回视口内）；收球/展开一律以**右边缘**为锚 —— 往左收成球、往右展开回原样，右边缘一个像素都不动；拖到右下角附近会**自动吸附**回去 —— 有费用胶囊就吸附到"跟着它"的位置（在它上方、同宽），没有就吸附回右下角，吸附是滑回去的动画而不是瞬移。点一下仍然是开关小窗（拖完那一下不会误触发）。
+
+**静置收球**（只在没装费用胶囊时）：超过 10 秒没有点击、也没有小窗活动，胶囊会收成一枚 32px 的小球，球心里的圆点会**长成一颗星芒**（和「✦ 解读」浮标那颗星逐点同形，缩小到 12px —— 和胶囊里文字一样高；状态颜色照旧），鼠标一放上去或点一下就展开回来；收和放是**严格互逆**的同一条动画（同一条时长 + 时间对称的曲线，把收球倒过来放就是展开，球心那个图形的长/收也在同一条曲线上）。有费用胶囊时它要和人家并排，所以不收；小窗开着、正在翻译/追问、鼠标停在上面时也都不收。
 
 ### 侧边栏网页里也能划词
 
@@ -479,9 +486,15 @@ git tag v0.2.0 && git push origin v0.2.0
 
 npm 侧只需配一次：包设置 → **Trusted Publisher** → GitHub Actions，填 `yfwu2020` / `dsh-selection-explain` / `publish.yml`，并勾选允许 **`npm publish`**（默认只允许 `npm stage publish`）。
 
-> 注意：`devDependencies` 里的 `@deepseek-ai/*` 钉在 **`0.1.5-rc.3`**（与插件开发所依据的运行时一致）。
+> 注意：`devDependencies` 里的 `@deepseek-ai/*` 钉在 **`0.1.5-rc.3`**（CI 构建校验用的就是这份类型）。
 > npm 上这些包的 `latest` 还停在 `0.0.1-rc.x`，API 更旧（缺 `WebServer`、`createSystemMessage` 等），
 > 用 `latest` 会编译失败——升级运行时时要同步改这里。
+>
+> **本机运行时通常比它新**（如 `0.1.7-rc.2`），两者 API 会漂移：例如 `createSystemMessage` 在
+> `0.1.5-rc.3` 是 `(text, plugin)` 两个必填参数，在 `0.1.7-rc.x` 只剩 `(text)`。此时**别只按本机类型写**，
+> 走一层宽松别名兼容两边（见 `src/index.ts` 的 `systemMessageOf`）——v0.4.0 就是漏了这一步，
+> 本机构建全绿、CI 构建报 TS2554，整条发布卡在第一步（与 Trusted Publisher 无关）。
+> 想提前发现：把仓库复制到临时目录、`npm install --no-save`（会装到 `0.1.5-rc.3`）再 `bash scripts/build.sh`。
 
 ## 目录