dsh-quote-annotate-pro 0.2.8 → 0.2.10

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 本项目的所有重要变更都记在这里。版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## 0.2.10 — 文档更正：如实披露 localhost 诊断探测
+
+- PR #697（`0xsline/awesome-deepseek-harness`）**已合并**，但维护者把我们的收录文案从 "no network access" 改写成
+  *"the client enables localhost diagnostic requests by default"* —— 因为插件默认确实会向 `127.0.0.1:47821` 发一次探测
+- README / README.en 新增「隐私 / 网络」小节：如实说明"纯客户端、不访问外部服务、不碰凭证"，
+  但**默认会向本机 47821 发一次探测**；想让"零请求"成真就设 `DIAG_ENABLED = false`
+- 发布工具包 `PR-TEXTS.md` 同步改写（EN/ZH 两处模板 + 复查清单加了一条 ⚠️ 提醒），避免后续插件再写错
+- 仅文档变更，代码行为不变
+
+## 0.2.9 — 编辑框定位再修：排除"贴文档原点"的退化矩形
+
+- 0.2.8 只拦了"尺寸为 0"的矩形；实测选区被打断后 `getBoundingClientRect()` 会返回**贴文档原点、但高度非 0** 的退化矩形，仍会算出 `left≈12 / top≈8`（窗口左上角）
+- 现在取值优先级为：**当前还活着的选区** → 存下来的矩形（需通过 `plausibleRect()`：有限值、有尺寸、**不在原点附近**、不越出视口）→ **视口底部居中**
+- 新增诊断 `editor:anchor`（只记来源与矩形，不记内容），便于下次一眼定位
+- 文本与模型侧行为不变
+
 ## 0.2.8 — 修复"批注编辑框跑到窗口左上角 / 引用不了"
 
 - **现象**：选中文字点「批注」后，编辑框出现在窗口左上角（压住侧边栏），看起来像引用功能坏了

package/README.en.md

@@ -81,6 +81,12 @@ npm run diag     # local diagnostics sink (http://127.0.0.1:47821)
 
 `lib/client.js` is a hand-written bundle (no build step) — edit and save; the client HMR reloads it. See [README.md](./README.md) (Chinese) for the diagnostics channel and known limitations.
 
+### Privacy / network (state this accurately in directory entries)
+
+This is a client-side plugin: **no external services, no credentials**. Its only data store is the anchor map in `localStorage` (≤60 entries per session).
+
+⚠️ It **does** send one probe to `http://127.0.0.1:47821` on load by default (`DIAG_ENABLED = true`) plus diagnostics once a local sink answers — so **do not describe it as "no network access"**. On 2026-10-16 the `0xsline/awesome-deepseek-harness` maintainer corrected exactly that claim while merging our entry to *"the client enables localhost diagnostic requests by default"*. Set `DIAG_ENABLED = false` if you want zero requests to be literally true.
+
 ## Releasing (maintainers)
 
 Releases go through **npm Trusted Publishing (OIDC)** — no token is stored in the repository and no one-time code is needed:

package/README.md

@@ -129,6 +129,14 @@ const DIAG_URL = 'http://127.0.0.1:47821/dsh-quote-pro'
 插件启动时 POST 一次 `/ping`；**探测不到接收端就本次运行静默**（不会产生网络噪音）。
 配合 `npm run diag`，终端会实时打出全链路事件：
 
+> ⚠️ **隐私 / 网络说明（收录信息里必须如实写）**：本插件是纯客户端插件，**不访问任何外部服务、不碰凭证**，
+> 唯一的数据落点是 `localStorage` 里的锚点表（每会话 ≤60 条）。
+> 但它默认会向**本机** `http://127.0.0.1:47821` 发一次探测（以及探测成功后的诊断事件）——
+> 这是 `DIAG_ENABLED = true` 的默认行为，**不要写成"零网络请求"**。
+> 2026-10-16 我们就因为这句不准确的表述，被 `0xsline/awesome-deepseek-harness` 的维护者在合并时改写成
+> *"the client enables localhost diagnostic requests by default"*。想让"无网络请求"成为事实，就把 `DIAG_ENABLED` 改成 `false`。
+
+
 ```
 module:materialized / apply:start / register:ok …   插件加载与槽位注册
 selection:show / selection:stage                    划词与「批注」

package/lib/client.js

@@ -1,6 +1,16 @@
 // dsh-quote-annotate-pro —— Client 半区（浏览器）
 // Fork of dsh-quote-annotate v0.1.1 (MIT, wangwei-wade) —— 增强：精确锚点 / 可观测性
 // 上游 bundle 形态保留：window.__ModuleLoader__ 工厂式 CJS
+//
+// ⚠️ 开发注意（踩过的坑，改装饰逻辑前必读）
+//   1) 装饰（把"【引用 · 第N轮 · 角色】+ 原文"重排成紧凑块）**绝不能破坏用户当前选区**：
+//      一旦替换了用户正在划词的文本节点，range.getBoundingClientRect() 会退化成"贴文档原点"的矩形，
+//      用它算出的位置正好是 left≈12/top≈8 —— 批注编辑框就跑到窗口左上角（0.2.8 的现象）。
+//      因此：① 扫描时用 selectionTouches(row) 跳过用户正在划词的那条消息；
+//            ② 编辑框定位一律走 anchorRect()：优先**当前活着的选区** → 校验过的旧矩形 → 视口底部居中。
+//   2) 装饰必须是"幂等 + 只加样式类/包一层隐藏元素"，且判定要看**内容**（是否还有未接管的位置行），
+//      不能只看 data-* 标记 —— 宿主会重排气泡内容，标记会骗人。
+//   3) 所有装饰都要 try/catch 且不抛到 React 渲染路径上；观察者回调里同步执行（先于绘制）才不会闪。
 window.__ModuleLoader__.load({
   id: 'dsh-quote-annotate-pro',
   factory: (require) => {
@@ -683,7 +693,11 @@ window.__ModuleLoader__.load({
           anchorKey: sel.anchorKey,
           turn: sel.turn,
           kind: sel.kind,
-        }, safeRect(sel.rect))
+        }, anchorRect(sel.rect))
+        try {
+          const r = anchorRect(sel.rect)
+          report('editor:anchor', { src: r.__dshq === 'fallback' ? 'fallback' : (liveSelectionRect() ? 'live' : 'stored'), rect: [Math.round(r.left), Math.round(r.top), Math.round(r.right - r.left), Math.round(r.bottom - r.top)] })
+        } catch (e) { /* ignore */ }
         finish()
       }
       return React.createElement('div', { className: 'dshq-toolbar', style: { left, top } },
@@ -705,28 +719,46 @@ window.__ModuleLoader__.load({
 
     // ============ 组件三：悬浮批注编辑框（评论输入框元素永久驻留，复用时输入法上下文不重建） ============
     /**
-     * 选区矩形兜底。矩形失效（节点被装饰/重渲染替换后 getBoundingClientRect 会全 0）时，
-     * 直接用它会算出 left=12 / top=8 —— 编辑框就跑到窗口左上角（用户反馈的现象）。
-     * 处理：无效 → 用当前选区重算 → 仍无效 → 退回视口底部居中。
+     * 选区矩形兜底。矩形失效（节点被装饰/重渲染替换后 getBoundingClientRect 会返回"文档原点附近"的退化矩形）
+     * 时，直接用它会算出 left≈12 / top≈8 —— 编辑框就跑到窗口左上角（用户反馈的现象）。
+     * 取值优先级：**当前还活着的选区** → 存下来的矩形（且看着正常）→ 视口底部居中。
      */
-    function safeRect(rect) {
-      const ok = (r) => !!(r
-        && Number.isFinite(r.left) && Number.isFinite(r.top)
-        && Number.isFinite(r.right) && Number.isFinite(r.bottom)
-        && ((r.right - r.left) > 0 || (r.bottom - r.top) > 0))
-      if (ok(rect)) return rect
+    function liveSelectionRect() {
       try {
         const s = typeof window !== 'undefined' ? window.getSelection() : null
-        if (s && s.rangeCount > 0) {
-          const r = s.getRangeAt(0).getBoundingClientRect()
-          if (ok(r)) return r
-        }
-      } catch (e) { /* ignore */ }
+        if (!s || s.rangeCount === 0 || s.isCollapsed) return null
+        const r = s.getRangeAt(0).getBoundingClientRect()
+        return plausibleRect(r) ? r : null
+      } catch (e) { return null }
+    }
+    /** 排除"贴文档原点"的退化矩形：那是选区失效后的典型产物 */
+    function plausibleRect(r) {
+      if (!r) return false
+      if (!(Number.isFinite(r.left) && Number.isFinite(r.top) && Number.isFinite(r.right) && Number.isFinite(r.bottom))) return false
+      const w = r.right - r.left
+      const h = r.bottom - r.top
+      if (!(w > 0 || h > 0)) return false
+      if (r.left < 24 && r.top < 24) return false           // 原点附近 → 视为失效
+      const vw = typeof window !== 'undefined' ? window.innerWidth : 1024
+      const vh = typeof window !== 'undefined' ? window.innerHeight : 768
+      if (r.left > vw || r.top > vh) return false
+      return true
+    }
+    function bottomCenterRect() {
       const vw = typeof window !== 'undefined' ? window.innerWidth : 1024
       const vh = typeof window !== 'undefined' ? window.innerHeight : 768
       const left = Math.max(12, Math.round(vw / 2 - 140))
       const top = Math.max(12, Math.round(vh - 200))
-      return { left, right: left + 280, top, bottom: top + 24, width: 280, height: 24 }
+      return { left, right: left + 280, top, bottom: top + 24, width: 280, height: 24, __dshq: 'fallback' }
+    }
+    function anchorRect(stored) {
+      const live = liveSelectionRect()
+      if (live) return live
+      if (plausibleRect(stored)) return stored
+      return bottomCenterRect()
+    }
+    function safeRect(rect) {
+      return anchorRect(rect)
     }
 
     const AnnotationEditor = () => {
@@ -746,7 +778,10 @@ window.__ModuleLoader__.load({
       const vw = typeof window !== 'undefined' ? window.innerWidth : 1024
       const vh = typeof window !== 'undefined' ? window.innerHeight : 768
       const item = state.item
-      const rect = open ? safeRect(state.rect) : null
+      const rect = open ? anchorRect(state.rect) : null
+      if (rect && rect.__dshq === 'fallback') {
+        try { report('editor:anchor', { src: 'fallback' }) } catch (e) { /* ignore */ }
+      }
       let left = -9999
       let top = -9999
       let w = 200

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quote-annotate-pro",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "选区引用与锚点批注（增强 fork）：划词 → 批注 → 带精确锚点的引用；输入框上方只显示原文片段，点一下跳回原文；发送时把轮次/角色写入引用块，让模型精确知道你指的是哪一处。",
   "keywords": ["dsh", "dsh-plugin", "deepseek-harness", "quote", "annotate", "selection", "reference", "anchor"],
   "license": "MIT",