dsh-quote-annotate-pro 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 本项目的所有重要变更都记在这里。版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## 0.2.2 — 引用界面改为紧凑式
+
+- **输入框上方的引用块**：不再显示 `引用#N · 第N轮 · 角色` 这类标签，改为**只显示原文片段**（单行、超出省略）；点一下即跳回原文并高亮，且**不再弹出"已跳转"提示**、取消常驻导航条 —— 输入区更干净
+- 输入框内的 chip 标签简化为 `引用1` / `引用2`（唯一、简短）
+- **定位能力不变**：锚点仍写入 `localStorage`（按会话，≤60 条），多轮对话里仍可精确跳回；发送的引用块仍以 `【引用 · 第N轮 · 角色】` 开头（模型侧定位不受影响）
+- 引用块不提供删除按钮：要撤掉引用，请在输入框用 Backspace 删除对应 chip
+
 ## 0.2.1 — 文档与自动发版
 
 - README / README.en：新增 npm 版本、CI、License 徽章；安装章节补上 `dsh plugin add dsh-quote-annotate-pro`（npm）与 `github:` 两种方式

package/README.en.md

@@ -16,8 +16,8 @@
 | Capability | Detail |
 | --- | --- |
 | Select & annotate | Select text in the transcript → a bubble appears above the selection → write a comment (optional) → `Enter` |
-| Quote chip | An atomic `引用#1 · 第3轮 · DSH 回复` chip lands in the composer; it expands to the full quote block on send |
-| **Quote bar** | A persistent bar under the composer (`引用 ❝ …`): click to jump back to the source and highlight it, hover to preview |
+| 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 |
 | **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 |
@@ -80,6 +80,22 @@ 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.
 
+## Releasing (maintainers)
+
+Releases go through **npm Trusted Publishing (OIDC)** — no token is stored in the repository and no one-time code is needed:
+
+1. Bump `version` in `package.json` and note the change in `CHANGELOG.md`
+2. Commit, tag and push:
+
+   ```sh
+   git tag -a v0.2.2 -m "v0.2.2"
+   git push origin main --follow-tags
+   ```
+
+3. [`release.yml`](.github/workflows/release.yml) then checks the tag against the version, runs the syntax/manifest checks, and publishes with `--provenance` (SLSA attestation). An already-published version is skipped, so the workflow is safe to re-run.
+
+Trusted Publisher configured on npm: `zhao-guang-ai` / `dsh-quote-annotate-pro` / workflow `release.yml` / environment `npm`.
+
 ## License
 
 MIT — see [LICENSE](./LICENSE). Upstream: [`wangwei-wade/dsh-quote-annotate`](https://github.com/wangwei-wade/dsh-quote-annotate) (MIT, © 2026 wangwei-wade).

package/README.md

@@ -16,11 +16,11 @@
 | 能力 | 说明 |
 |---|---|
 | 划词批注 | 会话里选中任意文字 → 选区上方浮出气泡（预览 + 「批注」）→ 编辑框里写评语（可留空）→ `Enter` 插入 |
-| 引用 chip | 输入框里出现 `引用#1 · 第5轮 · DSH 回复` 的原子 chip；发送时展开为完整引用块 |
-| **引用导航条** | 输入框下方常驻 `引用 ❝ 引用#1 …`，**点击跳回原文并高亮**，悬停预览原文 |
+| 引用 chip | 输入框里出现 `引用1` 的原子 chip（短标签）；发送时展开为完整引用块 |
+| **引用块（输入框上方）** | 有引用时在输入框上方显示**原文片段**（单行、超出省略）；**点一下即跳回原文并高亮** —— 不做任何可见的"跳转"提示，保持输入区干净 |
 | **模型侧精确定位** | 引用块首行是 `【引用 · 第5轮 · 你的消息】`，后接 `> 原文`，让模型明确知道**哪一轮、谁说的** |
 | 回合级引用 | 每条已完成回合尾部有「引用提问 / 引用回答」，整段引用该轮 |
-| 锚点持久化 | `ref → 锚点` 映射写入 `localStorage`（按会话，最多 60 条），**刷新页面后引用条仍能跳回原文** |
+| 锚点持久化 | `ref → 锚点` 映射写入 `localStorage`（按会话，最多 60 条），**刷新页面后引用块仍能跳回原文** |
 | 中英自适应 | 按钮文案跟随界面语言（沿用上游） |
 
 ## 与上游的差异
@@ -50,9 +50,9 @@
 
 6. **引用块带轮次/角色** —— 上游只发 `> 原文`。→ 首行加 `【引用 · 第N轮 · 角色】`（轮次取自 `data-chat-turn`，角色取自 `data-chat-flow-kind`）。
 
-7. **引用导航条 + 锚点持久化** —— 本版本输入框 chip **没有 `data-*` 属性**（只有 CSS 类），上游"点 chip 跳转"不可能成立。
-   → 改为读官方输入状态 `occurrences`（`source === 'quote-ref'`）渲染导航条；`ref → 锚点` 落 `localStorage`，刷新后仍可跳。
-   （输入框 chip 本体也支持点击跳转：按 `title` = label 反查 ref，不依赖 CSS 类顺序。）
+7. **输入框上方的引用块 + 锚点持久化** —— 本版本输入框 chip **没有 `data-*` 属性**（只有 CSS 类），上游"点 chip 跳转"不可能成立。
+   → 改为读官方输入状态 `occurrences`（`source === 'quote-ref'`）渲染引用块，只显示**原文片段**（不显示标签/轮次，保持简洁）；
+   `ref → 锚点` 落 `localStorage`，刷新后仍可跳。（输入框 chip 本体也支持点击跳转：按 `title` = label 反查 ref，不依赖 CSS 类顺序。）
 
 ## 安装
 
@@ -83,7 +83,8 @@ dsh plugin --profile <profile> add <本仓库绝对路径>
 emit('slash/input-insert-reference', { reference, span })      ← 官方会话事件，会话作用域
   │ 输入机 mint 一条 occurrence（source='quote-ref' / ref / label）
   ▼
-输入框 chip（官方 Lexical 装饰节点）
+输入框 chip（官方 Lexical 装饰节点，标签 `引用N`）
+  │ 同时：输入框上方出现「引用块」（显示原文片段，点一下可跳回）
   │ 发送
   ▼
 本插件 codec.serialize(ref) → 完整引用块
@@ -93,7 +94,7 @@ emit('slash/input-insert-reference', { reference, span })      ← 官方会话
   ▼
 模型收到"哪一轮 + 谁说的 + 原文"
 
-跳回原文：导航条/锚点 → [data-chat-anchor-key] 行 → scrollIntoView + 高亮
+跳回原文：引用块/锚点 → [data-chat-anchor-key] 行 → scrollIntoView + 高亮（无可见提示）
 ```
 
 用到的官方接口：`slots`（`shell.overlay` / `conversation.chat.turnTail` / `conversation.input.dock`）、
@@ -137,12 +138,41 @@ turnTail:render                                     回合尾部按钮取文
 
 不需要时把 `DIAG_ENABLED` 改成 `false` 即可（`console.log('[quote-pro]', …)` 会保留）。
 
+## 发版（维护者）
+
+发布走 **npm Trusted Publishing（OIDC）**，仓库里不保存任何 token，也不需要动态验证码：
+
+1. 改 `package.json` 的 `version`，并在 `CHANGELOG.md` 记录变更
+2. 提交、打标签、推送：
+
+   ```sh
+   git tag -a v0.2.2 -m "v0.2.2"
+   git push origin main --follow-tags
+   ```
+
+3. GitHub Actions 的 [`release.yml`](.github/workflows/release.yml) 自动执行：
+   校验 tag 与版本一致 → 语法与清单自检 → `npm publish --provenance`（带 SLSA 签名）
+4. 该版本已存在时自动跳过，工作流可安全重跑
+
+已在 npm 包设置页配置的 Trusted Publisher：
+
+| 字段 | 值 |
+|---|---|
+| Organization or user | `zhao-guang-ai` |
+| Repository | `dsh-quote-annotate-pro` |
+| Workflow filename | `release.yml` |
+| Environment name | `npm` |
+
+> 注：npm 现在对"绕过 2FA 的 token 直接发布"逐步收紧（账号变更已限制，直接发布 2027-01 起限制），
+> 因此本仓库从一开始就只走 OIDC —— 这是官方推荐方向，也避免了 token 泄漏风险。
+
 ## 已知限制
 
 - **输入框 chip 本体跳转依赖 `title`**：本版本 chip 无 `data-*` 属性，是按渲染出的 `title`（= 插入时写入的 label）反查 ref；
-  label 相同的多条引用只会命中最早的一条（导航条则始终精确）。
+  chip 标签为 `引用1`、`引用2` 这样的短标签（唯一），因此不再有歧义；上方引用块则始终精确。
 - **跳转要求原文行在当前页面**：目标消息未加载（历史未翻到）时只能给出提示，不做自动翻页加载。
-- **导航条在会话切换后重建**：锚点按会话存储；切到别的会话不会串。
+- **引用块在会话切换后重建**：锚点按会话存储；切到别的会话不会串。
+- **引用块不提供"删除"按钮**：要撤掉引用，请在输入框里用 Backspace 删除对应 chip（官方输入的既有行为）。
 - **回合尾部按钮在有交付文件的回合也会显示**：上游会隐藏、让位给官方「已生成文件」chips。
 - **评语以纯文本追加在 chip 之后**：编辑 chip 文本请用 Backspace 删除。
 

package/lib/client.js

@@ -397,8 +397,8 @@ window.__ModuleLoader__.load({
         notifyTimer = setTimeout(() => toastStore.hide(), 2600)
       } catch (e) { /* ignore */ }
     }
-    /** 跳到某个锚点行并高亮它。 */
-    function jumpToAnchorKey(anchorKey, pos) {
+    /** 跳到某个锚点行并高亮它。opts.silent=true 时不弹成功提示（高亮本身就是反馈）。 */
+    function jumpToAnchorKey(anchorKey, pos, opts) {
       if (!anchorKey) return false
       let row = null
       for (const r of document.querySelectorAll('[data-chat-anchor-key]')) {
@@ -412,12 +412,12 @@ window.__ModuleLoader__.load({
       row.scrollIntoView({ block: 'center', behavior: 'smooth' })
       row.classList.add('dshq-flash')
       setTimeout(() => row.classList.remove('dshq-flash'), 1600)
-      notify('已跳转到原文 ✓', pos, true)
+      if (!(opts && opts.silent)) notify('已跳转到原文 ✓', pos, true)
       report('jump:ok', { anchorKey })
       return true
     }
     /** 按 ref 跳回原文：优先用锚点键，退化到按引用正文反查。 */
-    function jumpToRef(ref, pos) {
+    function jumpToRef(ref, pos, opts) {
       const info = refTargets.get(ref)
       if (!info) {
         notify('跳转失败：找不到该引用（可能已发送或已删除）', pos, false)
@@ -442,7 +442,7 @@ window.__ModuleLoader__.load({
         notify('跳转失败：没有定位键（选中时未识别到消息行）', pos, false)
         return false
       }
-      return jumpToAnchorKey(anchorKey, pos)
+      return jumpToAnchorKey(anchorKey, pos, opts)
     }
 
     /**
@@ -760,8 +760,8 @@ window.__ModuleLoader__.load({
           const base = (st.draft || '').replace(/[\s\u00A0]+$/, '')
           const commentTail = c === '' ? '' : '\n\n' + c
           const ref = 'q' + REF_RUN + (++refSeq)
-          const anchorLabel = anchorLabelOf(item)
-          const chipLabel = '引用#' + refSeq + (anchorLabel === '' ? '' : ' · ' + anchorLabel)
+          // 输入框里的 chip 文案只要短、可区分即可（轮次/角色写在发送后的引用块里，不在输入框展示）
+          const chipLabel = '引用' + refSeq
           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 })
@@ -794,7 +794,7 @@ window.__ModuleLoader__.load({
             report('insert:chip', { ref, anchorKey: item.anchorKey || null, header, chars: item.text.length })
             setStatus({
               ok: true,
-              text: '已插入引用 chip ✓（' + (item.anchorKey ? '点击 chip 可跳回原文' : '未定位到消息行，点击可能无法跳转') + '）',
+              text: '已插入引用 ✓' + (item.anchorKey ? '（输入框上方的引用块可点回原文）' : '（未定位到消息行，可能无法跳回）'),
             })
             editorStore.close()
             return
@@ -869,42 +869,39 @@ window.__ModuleLoader__.load({
     }
 
     // ============ 样式（主题令牌自适应明暗） ============
-    // ============ 组件六：输入框下方的引用导航条 ============
+    // ============ 组件六：输入框上方的引用块（紧凑样式；点击可跳回原文，但不显式提示） ============
     // 本版本输入框里的引用 chip 没有 data 属性（只有 CSS 类），DOM 无法反查 occurrence；
-    // 因此导航条直接读官方输入状态的 occurrences（source === 'quote-ref'）来渲染，
-    // 点击即可跳回原文 —— 这是「多轮对话里精准定位」的可靠入口。
-    const QuoteDockChip = ({ item }) => {
+    // 因此这里直接读官方输入状态的 occurrences（source === 'quote-ref'）来渲染。
+    // 展示的是**原文片段本身**（不再显示「引用#N · 第N轮 · 角色」这类标签），保持输入区干净；
+    // 定位能力保留：点一下就跳回原文并高亮，只是不做任何可见的"跳转"提示。
+    const SNIPPET_MAX = 90
+    const snippetOf = (body) => {
+      const raw = String(body || '')
+        .split('\n')
+        .filter((line) => line.trim() !== '' && !/^【引用/.test(line.trim()))
+        .map((line) => line.replace(/^>\s?/, ''))
+        .join(' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+      return raw.length > SNIPPET_MAX ? raw.slice(0, SNIPPET_MAX) + '…' : raw
+    }
+
+    const QuoteBlock = ({ item }) => {
       const onJump = (e) => {
         try {
           const r = e.currentTarget.getBoundingClientRect()
           report('dock:click', { ref: String(item.ref), anchorKey: item.anchorKey || null })
-          jumpToRef(item.ref, { left: r.left + 16, top: r.top })
-        } catch (err) { /* ignore */ }
-      }
-      const onOver = (e) => {
-        try {
-          const info = refTargets.get(item.ref)
-          if (!info || !info.body) return
-          const r = e.currentTarget.getBoundingClientRect()
-          tooltipStore.show({
-            text: String(info.body).replace(/^> ?/gm, '').trim(),
-            label: info.label || '引用',
-            rect: { left: r.left, top: r.top, right: r.right, bottom: r.bottom },
-          })
+          jumpToRef(item.ref, { left: r.left + 16, top: r.top }, { silent: true })
         } catch (err) { /* ignore */ }
       }
-      const onOut = () => { try { tooltipStore.hide() } catch (err) { /* ignore */ } }
-      return React.createElement('button', {
-        type: 'button',
-        className: 'dshq-dock-chip',
+      return React.createElement('div', {
+        className: 'dshq-quote-block',
         onClick: onJump,
-        onMouseEnter: onOver,
-        onMouseLeave: onOut,
-        title: '点击跳回原文，悬停查看原文',
-      },
-        React.createElement('span', { className: 'dshq-dock-chip-icon' }, '❝'),
-        React.createElement('span', { className: 'dshq-dock-chip-label' }, item.label || ('引用#' + item.ref)),
-      )
+        onKeyDown: (e) => { if (e.key === 'Enter' || e.key === ' ') onJump(e) },
+        role: 'button',
+        tabIndex: 0,
+        title: '点击跳回原文',
+      }, React.createElement('span', { className: 'dshq-quote-block-text' }, item.snippet || '引用'))
     }
 
     const QuoteDock = (props) => {
@@ -930,7 +927,11 @@ window.__ModuleLoader__.load({
             for (const occ of occurrences) {
               if (!occ || occ.source !== 'quote-ref') continue
               const info = refTargets.get(occ.ref)
-              next.push({ ref: occ.ref, label: (info && info.label) || occ.label || ('引用#' + occ.ref), anchorKey: (info && info.anchorKey) || null })
+              next.push({
+                ref: occ.ref,
+                anchorKey: (info && info.anchorKey) || null,
+                snippet: snippetOf(info && info.body),
+              })
             }
             setRows(next)
             if (next.length > 0) report('dock:rows', { count: next.length })
@@ -949,8 +950,8 @@ window.__ModuleLoader__.load({
         }
       }, [sessionId])
       if (!sessionId || rows.length === 0) return null
-      const children = [React.createElement('span', { className: 'dshq-dock-title', key: '__t' }, '引用')]
-      for (const row of rows) children.push(React.createElement(QuoteDockChip, { key: row.ref, item: row }))
+      const children = []
+      for (const row of rows) children.push(React.createElement(QuoteBlock, { key: row.ref, item: row }))
       return React.createElement('div', { className: 'dshq-dock' }, children)
     }
 
@@ -985,13 +986,11 @@ 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;align-items:center;gap:6px;flex-wrap:wrap;padding:2px 6px;font-size:11px;color:var(--dsw-alias-label-secondary)}
-.dshq-dock-title{opacity:.65;user-select:none}
-.dshq-dock-chip{appearance:none;display:inline-flex;align-items:center;gap:4px;max-width:280px;padding:2px 9px;border-radius:999px;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;font-size:11px;line-height:18px;cursor:pointer}
-.dshq-dock-chip:hover{border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-brand-primary)}
-.dshq-dock-chip-icon{opacity:.55}
-.dshq-dock-chip-label{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+/* 引用块：输入框上方，紧凑单行（点一下跳回原文，但不显示任何"跳转"提示） */
+.dshq-dock{display:flex;flex-direction:column;gap:4px;padding:0 2px;min-width:0}
+.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-quote-block:hover{color:var(--dsw-alias-label-primary)}
+.dshq-quote-block-text{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 `
 
     // ============ 插件主体 ============

package/package.json

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