dsh-quote-annotate-pro 0.2.4 → 0.2.6

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 本项目的所有重要变更都记在这里。版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## 0.2.6 — 输入框与消息统一为紧凑引用（消除插入瞬间的闪烁）
+
+- **输入框里的引用**：插入后立刻渲染成**紧凑原文块**（位置行隐藏），不再"先露出完整引用块、稍后才变紧凑"
+  - 实现：装饰函数暴露为模块级钩子，插入成功即调用一次；MutationObserver 的防抖从 250ms 降到 40ms
+- **引用文本去掉 `> ` 前缀**（`【引用 · 第N轮 · 角色】` + 原文），编辑器里不再多露一个符号
+- **文本保持完整**：界面只是隐藏位置行（加样式类，不动编辑器文本），因此**发送出去的内容仍带轮次/角色** → 模型侧定位能力不变
+- 消息侧（0.2.3）的紧凑渲染保持不变，输入与输出观感一致
+
+## 0.2.5 — 引用块样式：贴在输入框上沿
+
+- 0.2.4 曾把引用块挪进 `conversation.input.overlay`，实测该槽位是**浮动弹层**（放的是 slash-menu / command-popup 这类弹窗），静态内容放进去不可见 → **改回 `conversation.input.dock`**
+- DSH 没有"输入框卡片内部、文字上方"的静态槽位：
+  - `conversation.input.overlay` = 浮动弹层（不适用）
+  - `conversation.input.attachments` = 官方草稿附件栏（single 槽位，占用会顶掉官方附件 UI，不能碰）
+- 折中方案：引用块留在卡片上沿，用样式做成**贴着输入框**（顶部大圆角、底部小圆角、无间隙），视觉上与输入框连成一体
+- 对话页里的紧凑引用（0.2.3）不受影响
+
 ## 0.2.4 — 输入框里的引用块（挪进输入框卡片内）
 
 - 引用块从「输入框卡片**上方**」挪到「输入框卡片**内部**、文字上方」（`conversation.input.overlay` 槽位），与参考产品一致：引用跟着输入内容走，看起来是一体的

package/README.en.md

@@ -17,8 +17,8 @@
 | --- | --- |
 | Select & annotate | Select text in the transcript → a bubble appears above the selection → write a comment (optional) → `Enter` |
 | Quote chip | An atomic `引用1` chip (short label) lands in the composer; it expands to the full quote block on send |
-| **Quote block** | While a quote is in the composer, a compact block above it shows the **quoted text snippet** (single line, ellipsised). Click it to jump back to the source and highlight it — no visible "jump" affordance, so the composer stays clean |
-| **Compact quotes in the transcript** | A sent message shows only a **compact quote block** (up to 3 lines) — the `【引用 · 第N轮 · 角色】` label is hidden. Clicking the block jumps back to the source and highlights it, while the message payload still carries the turn/role, so the model keeps the position context |
+| **Quote block (in the composer)** | After inserting a quote the composer shows only the **quoted text** (the turn/role line is hidden); click it to jump back to the source and highlight it — no visible "jump" affordance |
+| **Compact quotes in the transcript** | A sent message shows only a **compact quote block** (up to 3 lines). The message text still starts with `【引用 · 第N轮 · 角色】` — hidden in the UI, so the model keeps the position context |
 | **Turn-accurate context** | The quote block starts with `【引用 · 第3轮 · 你的消息】` followed by `> quoted text`, so the model knows exactly which turn and whose message |
 | Turn-level quoting | Every finished turn gets `引用提问` / `引用回答` buttons that quote the whole question or answer |
 | Anchors survive reload | The `ref → anchor` map is persisted in `localStorage` (per session, 60 entries max), so quotes still jump after a page refresh |

package/README.md

@@ -17,8 +17,8 @@
 |---|---|
 | 划词批注 | 会话里选中任意文字 → 选区上方浮出气泡（预览 + 「批注」）→ 编辑框里写评语（可留空）→ `Enter` 插入 |
 | 引用 chip | 输入框里出现 `引用1` 的原子 chip（短标签）；发送时展开为完整引用块 |
-| **引用块（输入框上方）** | 有引用时在输入框上方显示**原文片段**（单行、超出省略）；**点一下即跳回原文并高亮** —— 不做任何可见的"跳转"提示，保持输入区干净 |
-| **对话页里的紧凑引用** | 已发送消息里的引用也只显示**紧凑原文块**（最多 3 行），**不显示"第N轮/谁说的"标签**；点该块可跳回原文。而**消息本体仍带位置信息**，模型照旧知道出处 |
+| **引用块（输入框内）** | 插入引用后输入框里只显示**原文片段**（位置行隐藏）；**点一下即跳回原文并高亮** —— 不做任何可见的"跳转"提示 |
+| **对话页里的紧凑引用** | 已发送消息里的引用同样只显示**紧凑原文块**（最多 3 行）。**消息文本仍以 `【引用 · 第N轮 · 角色】` 开头** —— 界面隐藏、模型照旧知道出处 |
 | **模型侧精确定位** | 引用块首行是 `【引用 · 第5轮 · 你的消息】`，后接 `> 原文`，让模型明确知道**哪一轮、谁说的** |
 | 回合级引用 | 每条已完成回合尾部有「引用提问 / 引用回答」，整段引用该轮 |
 | 锚点持久化 | `ref → 锚点` 映射写入 `localStorage`（按会话，最多 60 条），**刷新页面后引用块仍能跳回原文** |

package/lib/client.js

@@ -147,6 +147,8 @@ window.__ModuleLoader__.load({
     const refTargets = new Map()
     // ref -> { body, clipboardText } 提交时经 codec 序列化
     const refCodecs = new Map()
+    // 输入框引用装饰的"立即执行"钩子：插入后马上贴样式，避免先露出旧样子再变（用户反馈的瞬间闪烁）
+    let composerDecorateNow = null
 
     // 页面内反馈 toast（点击 chip 时显示结果）
     const toastStore = {
@@ -735,8 +737,8 @@ window.__ModuleLoader__.load({
         try {
           const c = (comment || '').trim()
           const header = buildQuoteHeader(item)
-          const quoted = item.text.split('\n').map((line) => '> ' + line).join('\n')
-          const quoteBody = header === '' ? quoted : header + '\n' + quoted
+          // 引用正文不再加 "> " 前缀：输入框与消息里都由插件渲染成紧凑块（前缀会在编辑器里露出一截符号）
+          const quoteBody = header === '' ? item.text : header + '\n' + item.text
           const conversation = rootCtx ? rootCtx.get('conversation') : undefined
           const sessions = rootCtx ? rootCtx.get('sessions') : undefined
           if (!conversation || !conversation.input || !sessions) {
@@ -762,6 +764,8 @@ window.__ModuleLoader__.load({
           const ref = 'q' + REF_RUN + (++refSeq)
           // 输入框里的 chip 文案只要短、可区分即可（轮次/角色写在发送后的引用块里，不在输入框展示）
           const chipLabel = '引用' + refSeq
+          // 输入框与消息里显示的就是这段文本（实测：宿主消息 = 草稿文本，WYSIWYG）；
+          // 因此位置行（【引用 · 第N轮 · 角色】）保留在文本里给模型用，界面上由插件渲染时隐藏。
           refTargets.set(ref, { sessionId, anchorKey: item.anchorKey || null, body: quoteBody, label: chipLabel })
           refCodecs.set(ref, { body: quoteBody, clipboardText: quoteBody })
           saveRef(sessionId, ref, { anchorKey: item.anchorKey || null, body: quoteBody, label: chipLabel })
@@ -791,7 +795,18 @@ window.__ModuleLoader__.load({
               const st3 = input.state.getSnapshot()
               input.setDraft(st3.draft.replace(/[ \t]+$/, '') + commentTail)
             }
+            try {
+              const snap2 = input.state.getSnapshot()
+              const occ2 = (snap2 && snap2.occurrences) || []
+              report('insert:draft', {
+                draft: String((snap2 && snap2.draft) || '').replace(/\s+/g, ' ').slice(0, 120),
+                occ: occ2.length,
+                occLabels: occ2.map((o) => (o && o.label) || '').join('|').slice(0, 80),
+              })
+            } catch (e) { /* ignore */ }
             report('insert:chip', { ref, anchorKey: item.anchorKey || null, header, chars: item.text.length })
+            // 立刻给刚插入的内容贴样式，避免"先露出旧样子、稍后才变紧凑"的闪烁
+            try { if (typeof composerDecorateNow === 'function') composerDecorateNow() } catch (e) { /* ignore */ }
             setStatus({
               ok: true,
               text: '已插入引用 ✓' + (item.anchorKey ? '（输入框上方的引用块可点回原文）' : '（未定位到消息行，可能无法跳回）'),
@@ -987,9 +1002,9 @@ window.__ModuleLoader__.load({
 /* 根因：textarea（透明文字、absolute、inset:0）渲染在 backdrop 之后，整层盖住 chip。
    给 chip 提升 z-index 使其浮到 textarea 之上，点击才能落到 chip 上。 */
 [data-occurrence]{pointer-events:auto;cursor:pointer;position:relative;z-index:1}
-/* 引用块：输入框卡片内部、文字上方（点一下跳回原文，但不显示任何"跳转"提示） */
-.dshq-dock{display:flex;flex-direction:column;gap:4px;padding:0;margin:0 0 6px;min-width:0;width:100%;box-sizing:border-box}
-.dshq-quote-block{display:flex;align-items:center;min-width:0;max-width:100%;box-sizing:border-box;padding:5px 10px;border-radius:8px;background:var(--dsw-alias-bg-layer-2);background:color-mix(in oklab,var(--dsw-alias-brand-primary) 8%,var(--dsw-alias-bg-layer-1));color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;cursor:pointer;transition:background .12s ease,color .12s ease}
+/* 引用块：贴在输入框卡片上沿（点一下跳回原文，不显示任何"跳转"提示） */
+.dshq-dock{display:flex;flex-direction:column;gap:4px;padding:0 6px;margin:6px 0 -2px;min-width:0;box-sizing:border-box}
+.dshq-quote-block{display:flex;align-items:center;min-width:0;max-width:100%;box-sizing:border-box;padding:6px 10px;border-radius:12px 12px 4px 4px;background:var(--dsw-alias-bg-layer-2);background:color-mix(in oklab,var(--dsw-alias-brand-primary) 8%,var(--dsw-alias-bg-layer-1));color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;cursor:pointer;transition:background .12s ease,color .12s ease}
 .dshq-quote-block:hover{color:var(--dsw-alias-label-primary)}
 .dshq-quote-block-text{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 /* 已发送消息里的引用：隐藏位置标签，只显示紧凑的原文块（点击可跳回原文，无可见引导） */
@@ -997,6 +1012,11 @@ window.__ModuleLoader__.load({
 .dshq-sent-quote{display:block;margin:3px 0;padding:6px 10px;border-radius:8px;background:rgba(127,127,127,.10);color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.5;cursor:pointer;overflow:hidden;transition:background .12s ease,color .12s ease}
 .dshq-sent-quote:hover{color:var(--dsw-alias-label-primary)}
 .dshq-sent-quote-text{display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;overflow:hidden;white-space:pre-wrap;word-break:break-word}
+/* 输入框里的引用：隐藏位置行，正文显示为紧凑块（输入框与消息观感一致） */
+.dshq-cmp-header{display:none !important}
+.dshq-cmp-quote{background:rgba(127,127,127,.10);border-radius:8px;padding:2px 10px;margin:2px 0}
+.dshq-cmp-quote-first{margin-top:4px}
+.dshq-cmp-quote-last{margin-bottom:4px}
 `
 
     // ============ 插件主体 ============
@@ -1270,18 +1290,22 @@ window.__ModuleLoader__.load({
             })
             return wrap
           }
-          /** 把承载「【引用…】\n> 原文…」的文本节点拆成：隐藏头部 + 紧凑引用块 + 其余文本 */
+          /** 把承载「【引用…】\n原文…」的文本节点拆成：隐藏头部 + 紧凑引用块 + 其余文本 */
           const transformTextNode = (node) => {
             const raw = node.nodeValue || ''
             const m = HEADER_RE.exec(raw)
             if (!m) return false
-            const quoteStart = m.index + m[0].length
-            const nl = raw.indexOf('\n', quoteStart)
+            const after = raw.slice(m.index + m[0].length)
+            const nl = after.indexOf('\n')
             if (nl < 0) return false
-            const lines = raw.slice(nl + 1).split('\n')
+            const lines = after.slice(nl + 1).split('\n')
+            // 引用正文 = 头部之后、直到空行之前的连续非空行（兼容旧格式的 "> " 前缀）
             const quote = []
             let i = 0
-            while (i < lines.length && /^>\s?/.test(lines[i])) { quote.push(lines[i].replace(/^>\s?/, '')); i++ }
+            for (; i < lines.length; i++) {
+              if (lines[i].trim() === '') break
+              quote.push(lines[i].replace(/^>\s?/, ''))
+            }
             if (quote.length === 0) return false
             const rest = lines.slice(i).join('\n')
             const frag = document.createDocumentFragment()
@@ -1331,6 +1355,60 @@ window.__ModuleLoader__.load({
       } catch (e) {
         report('apply:sent-decor-throw', String((e && e.message) || e))
       }
+
+      // ============ 输入框里的引用：隐藏位置行 + 紧凑块（与消息里的渲染保持一致） ============
+      // 只给编辑器的行元素加 class，**不改动编辑器文本** → 发送出去的内容不变（模型仍拿到位置信息）。
+      // 编辑器重渲染会丢掉 class，因此用 MutationObserver 重新贴上。
+      try {
+        ctx.effect(() => {
+          let timer = null
+          let observer = null
+          const isSingleLine = (t) => t !== '' && t.indexOf('\n') === -1
+          const decorate = () => {
+            timer = null
+            try {
+              for (const ed of document.querySelectorAll('[contenteditable="true"]')) {
+                const kids = Array.from(ed.children || [])
+                let headerEl = null
+                const quoteEls = []
+                for (const el of kids) {
+                  const t = String(el.textContent || '').trim()
+                  if (!headerEl) {
+                    // 位置行必须"整行且只有一行"，避免误把整个编辑器当成头部
+                    if (isSingleLine(t) && /^【引用\s*·[^\n]*】$/.test(t)) headerEl = el
+                    continue
+                  }
+                  if (t === '') break
+                  if (!isSingleLine(t)) break
+                  quoteEls.push(el)
+                }
+                if (!headerEl) continue
+                headerEl.classList.add('dshq-cmp-header')
+                quoteEls.forEach((el, idx) => {
+                  el.classList.add('dshq-cmp-quote')
+                  el.classList.toggle('dshq-cmp-quote-first', idx === 0)
+                  el.classList.toggle('dshq-cmp-quote-last', idx === quoteEls.length - 1)
+                })
+                report('cmp:decorated', { lines: quoteEls.length })
+              }
+            } catch (e) { report('cmp:scan-throw', String((e && e.message) || e)) }
+          }
+          const schedule = () => { if (timer === null) timer = setTimeout(decorate, 40) }
+          decorate()
+          composerDecorateNow = decorate
+          try {
+            observer = new MutationObserver(schedule)
+            observer.observe(document.body, { childList: true, subtree: true, characterData: true })
+          } catch (e) { report('cmp:observer-throw', String((e && e.message) || e)) }
+          return () => {
+            if (composerDecorateNow === decorate) composerDecorateNow = null
+            if (timer !== null) clearTimeout(timer)
+            if (observer) { try { observer.disconnect() } catch (e) { /* ignore */ } }
+          }
+        }, 'dsh-quote-annotate-pro: composer quote decoration')
+      } catch (e) {
+        report('apply:cmp-decor-throw', String((e && e.message) || e))
+      }
       const tryRegister = (tag, fn) => {
         try { fn(); report('register:ok', tag); return true } catch (e) {
           report('register:throw', tag + ' :: ' + String((e && e.stack) || (e && e.message) || e))
@@ -1344,9 +1422,12 @@ window.__ModuleLoader__.load({
         { name: 'conversation.input.dock', id: 'quote-pro-session-probe', order: 1 },
         SessionProbe,
       )))
-      // 引用块放进「输入框卡片内部」（豆包那样：在输入框里、文字上方），不再挂在卡片上方
-      tryRegister('dock:quote-nav', () => slots.inject('conversation.input.overlay', () => slots.register(
-        { name: 'conversation.input.overlay', id: 'quote-pro-quote-block', order: 1 },
+      // 引用块回到「输入框卡片上沿」的 dock 槽位（官方说明：Full-width entries above the composer card），
+      // 用样式把它做成"贴在输入框上沿"的样子 —— DSH 没有"卡片内部、文字上方"的静态槽位：
+      //   conversation.input.overlay 是浮动弹层（放的是 slash-menu / command-popup 这类），
+      //   conversation.input.attachments 是官方草稿附件栏（single，占用会顶掉官方附件 UI，不能碰）。
+      tryRegister('dock:quote-nav', () => slots.inject('conversation.input.dock', () => slots.register(
+        { name: 'conversation.input.dock', id: 'quote-pro-quote-block', order: 2 },
         QuoteDock,
       )))
       tryRegister('turnTail', () => slots.inject('conversation.chat.turnTail', () => slots.register(

package/package.json

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