dsh-quote-annotate-pro 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本项目的所有重要变更都记在这里。版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## 0.3.1 — 引用管线懒重试：页面刷新后不再退化成纯文本
+
+- **根因**：页面刷新时插件 `apply` 早于宿主 `inputTriggers` 服务就绪，`ctx.get('inputTriggers')` 拿到空值后
+  `pipelineAvailable` 被永久置为 `false` → 之后每次批注插入都走「纯文本回退」，输入框里出现 `【批注 1 …】` 裸文本块
+  （实测证据：localStorage 草稿记录为 `{"draft":{"text":"【批注 1 · …】\n钟）\n\n批注：1…","references":[]}}`，即没有 chip）
+- **修复**：引用源注册改为幂等懒加载 `ensureQuoteSource()`，服务未就绪时按 500ms × 20 次（≈10s）自动重试，
+  每次插入前也会先试一次；重试成功即恢复正常 chip 插入，无需用户刷新页面或重启
+- **可观测性**：`insert:draft` 诊断补充 `draftLen` / `pipeline`；`insert:fallback-plaintext` 补充 `draftLen` / `bodyLen` / `pipeline`；
+  编辑器提示按状态区分（`null` = 正在初始化引用管线，`false` = 回退为纯文本）
+- 自检照旧：`npm test`（8 组纯函数断言）、`node --check`、`check-manifest` 全绿
+
 ## 0.3.0 — 编号批注 + 回复逐条对照
 
 - **批注自动编号**：同一条消息里每次插入批注都会编号（`批注 1`、`批注 2`…，删掉中间某条不会重号，见 `nextAnnotationNo()`）；

package/README.en.md

@@ -104,6 +104,7 @@ Official surfaces used: `slots` (`shell.overlay`, `conversation.chat.turnTail`,
 
 ```sh
 npm run check    # manifest self-check (package.json / patch / bundle registration id)
+npm test         # pure-function self-check for the client bundle (numbering, block parsing, snippets — no browser/network)
 npm run diag     # local diagnostics sink (http://127.0.0.1:47821)
 ```
 

package/lib/client.js

@@ -215,6 +215,8 @@ window.__ModuleLoader__.load({
     let currentSessionId = null
     let refSeq = 0
     let pipelineAvailable = null // null=未知 false=不可用 true=可用
+    // 引用 source 的注册函数（懒加载 + 重试）：服务晚就绪、HMR 重载后仍能恢复 chip 插入
+    let ensureQuoteSource = null
     // ref -> { sessionId, anchorKey, body, label } 用于点击 chip 跳回原文 / 悬停显示原文
     const refTargets = new Map()
     // ref -> { body, clipboardText } 提交时经 codec 序列化
@@ -910,6 +912,8 @@ window.__ModuleLoader__.load({
             refCodecs.delete(oldest)
             refTargets.delete(oldest)
           }
+          // 懒重试：若 apply 时 inputTriggers 还没就绪，插入前再试一次（常见于"刚启动就点批注"）
+          try { if (typeof ensureQuoteSource === 'function') ensureQuoteSource() } catch (e) { /* ignore */ }
           // 事件派发目标：优先用 sessions.scope()（社区插件在本版本已验证的路径），退回 binding.ctx
           let emitCtx = binding.ctx
           try {
@@ -929,10 +933,13 @@ window.__ModuleLoader__.load({
             try {
               const snap2 = input.state.getSnapshot()
               const occ2 = (snap2 && snap2.occurrences) || []
+              const draft2 = String((snap2 && snap2.draft) || '')
               report('insert:draft', {
-                draft: String((snap2 && snap2.draft) || '').replace(/\s+/g, ' ').slice(0, 120),
+                draft: draft2.replace(/\s+/g, ' ').slice(0, 400),
+                draftLen: draft2.length,
                 occ: occ2.length,
                 occLabels: occ2.map((o) => (o && o.label) || '').join('|').slice(0, 80),
+                pipeline: pipelineAvailable,
               })
             } catch (e) { /* ignore */ }
             report('insert:chip', { ref, anchorKey: item.anchorKey || null, header, chars: item.text.length })
@@ -950,7 +957,9 @@ window.__ModuleLoader__.load({
           refTargets.delete(ref)
           refCodecs.delete(ref)
           input.setDraft(base === '' ? quoteBody : base + '\n\n' + quoteBody)
-          report('insert:fallback-plaintext', { ref, header })
+          let draftLen = 0
+          try { draftLen = String((input.state.getSnapshot() || {}).draft || '').length } catch (e) { /* ignore */ }
+          report('insert:fallback-plaintext', { ref, header, draftLen, bodyLen: quoteBody.length, pipeline: pipelineAvailable })
           setStatus({ ok: false, text: 'chip 插入未生效，已回退为纯文本引用' })
           editorStore.close()
         } catch (e) {
@@ -1183,9 +1192,21 @@ window.__ModuleLoader__.load({
         available: pipelineAvailable,
         hasInsertReference: !!(inputTriggers && typeof inputTriggers.insertReference === 'function'),
       })
-      if (pipelineAvailable) {
+      // 注册机：幂等、可重试。宿主服务可能晚于插件就绪（或 HMR 重载后旧注册仍在），
+      // 一次性判定会让整页退化成"纯文本回退"，因此这里允许后续再次调用。
+      let quoteSourceRegistered = false
+      ensureQuoteSource = () => {
+        if (quoteSourceRegistered) return true
+        let triggers = inputTriggers
+        if (!triggers) {
+          try { triggers = ctx.get('inputTriggers') } catch (e) { triggers = undefined }
+        }
+        if (!triggers || typeof triggers.registerSource !== 'function') {
+          pipelineAvailable = false
+          return false
+        }
         try {
-          ctx.effect(() => inputTriggers.registerSource({
+          ctx.effect(() => triggers.registerSource({
             trigger: '@',
             name: 'quote-ref',
             order: 100,
@@ -1196,12 +1217,42 @@ window.__ModuleLoader__.load({
               serialize: (ref) => Promise.resolve(refCodecs.get(ref) ? refCodecs.get(ref).body : ''),
             },
           }), 'dsh-quote-annotate-pro: quote-ref source')
+          quoteSourceRegistered = true
+          pipelineAvailable = true
           report('register:quote-ref-source', 'ok')
+          return true
         } catch (e) {
+          const msg = String((e && e.stack) || (e && e.message) || e)
+          // 已注册（HMR 重载后宿主保留旧注册）不算失败：序列化仍会路由到当前模块的 codec
+          if (/already|duplicate|exist|注册/i.test(msg)) {
+            quoteSourceRegistered = true
+            pipelineAvailable = true
+            report('register:quote-ref-source', 'already')
+            return true
+          }
           pipelineAvailable = false
-          report('register:quote-ref-source', 'throw ' + String((e && e.stack) || (e && e.message) || e))
+          report('register:quote-ref-source', 'throw ' + msg)
+          return false
         }
       }
+      if (!ensureQuoteSource()) {
+        // 退避重试：最多 20 次、间隔 500ms（约 10s），把启动时序造成的退化救回来
+        try {
+          ctx.effect(() => {
+            let tries = 0
+            let timer = null
+            const tick = () => {
+              timer = null
+              if (quoteSourceRegistered || tries >= 20) return
+              tries += 1
+              if (!ensureQuoteSource()) timer = setTimeout(tick, 500)
+            }
+            timer = setTimeout(tick, 500)
+            report('register:quote-ref-source', 'retry-scheduled')
+            return () => { if (timer !== null) clearTimeout(timer) }
+          }, 'dsh-quote-annotate-pro: quote-ref retry')
+        } catch (e) { /* ignore */ }
+      }
       // 全局监听（选区气泡 / chip 点击跳转 / chip 悬停提示；ctx.effect 保证卸载时全部清理）
       try {
         ctx.effect(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quote-annotate-pro",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "划词批注与引用锚点：划词 → 批注（自动编号）→ 引用；引用块在输入框和已发送消息里始终可见（最多 3 行、位置行隐藏），点一下跳回原文并高亮；模型按「Annotation N：」逐条回应，回复里的标签可悬浮看原文与评语。纯客户端，锚点存本地 localStorage。",
   "keywords": ["dsh", "dsh-plugin", "deepseek-harness", "quote", "annotate", "selection", "reference", "anchor"],
   "license": "MIT",