dsh-select-quote 0.3.10 → 0.3.11

package/README.md

@@ -6,7 +6,7 @@
 - **右键菜单**：在选区矩形内点右键，同一套「复制 / 打开链接 / 添加到任务」出现在指针处；选区之外、其它插件已接管的右键一律不碰，桌面端未接管时保留宿主的原生 Copy 菜单
 - **快捷键**：选中文字后一键打开菜单或直接添加；桌面 macOS 是 `⌘L` / `⇧⌘L`，其它平台的默认键位见下表；可在设置里单独开关
 - **批注摘要**：添加后输入框上方出现一块「N 条批注」摘要，草稿里不会出现任何协议文本
-- **正文标记**：被划中的文字在原消息里留下淡色底、虚线下划线和序号角标，点摘要条目会滚回那段文字；角标始终压在选区高亮之上，多条批注结尾重合时会自动向右/向上错开
+- **正文标记**：被划中的文字在原消息里留下淡色底、虚线下划线和序号角标，点摘要条目会滚回那段文字；点标记或角标会打开该条批注的预览（原文 + 评论），角标也能用 Tab 聚焦、Enter 打开。角标始终压在选区高亮之上，多条批注结尾重合时会自动向右/向上错开
 - **模型回指**：模型回答里指向某条批注的位置，渲染成带预览的 chip
 - **对话记录**：已发送消息仍由宿主气泡渲染（时间、复制、撤回都在），批注收成一块摘要，悬停（触屏点按）展开列表
 - **界面语言**：跟随 dsh 自己的语言设置，简体中文 / English / Русский
@@ -44,8 +44,9 @@ dsh web --patch "$PWD/dev.patch.yml"
 1. 在对话区选中一段文本，点「添加到任务」——到这一步批注就已经保存，输入框上方同步出现批注摘要。触屏下操作条固定在屏幕底部，不跟随选区挤在系统选择菜单旁边
 2. 想补充的话在弹出的评论框里写一句，点「添加评论」或 `⌘/Ctrl + Enter`；不写就直接点空白处或「暂不评论」，批注同样保留。触屏下评论在底部抽屉里完成，抽屉顶部会带上选中的原文
 3. 悬停（触屏点按）输入框上方的摘要展开列表，可逐条编辑、删除或一键清空，点条目跳回正文对应文字；对话记录里的摘要只提供列表和跳转。键盘聚焦摘要后按 Enter / ↓ 展开，Tab 在面板内移动，Esc 关闭并回到摘要
-4. 正常打字发送，批注随消息一起交给模型，摘要随之消失
-5. 模型回答里引用某条批注的位置显示为 chip：悬停、点击（触屏点按）或键盘聚焦都会打开预览，显示原文和评论；预览默认在 chip 上方，右上角「原文」按钮回到正文；键盘聚焦 chip 后按 ↓ 进入按钮，Esc 关闭
+4. 点正文里的标记或角标（角标可用 Tab 聚焦后按 Enter）打开批注预览，查看原文和评论；点浮层外或按 Esc 关闭
+5. 正常打字发送，批注随消息一起交给模型，摘要随之消失
+6. 模型回答里引用某条批注的位置显示为 chip：悬停、点击（触屏点按）或键盘聚焦都会打开预览，显示原文和评论；预览默认在 chip 上方，右上角「原文」按钮回到正文；键盘聚焦 chip 后按 ↓ 进入按钮，Esc 关闭
 
 ### 入口与菜单
 
@@ -93,7 +94,7 @@ dsh web --patch "$PWD/dev.patch.yml"
 - **划词只在对话区生效**：不介入编辑器、终端等面板。
 - **右键只在选区矩形内接管**：指针在选区外、右键已被其它插件处理、或触发方式没开「右键菜单」时，插件完全不介入，宿主自己的菜单照常出现。桌面端接管时原生 Copy 菜单会被抑制；没接管时仍由客户端弹原生菜单，这是两条互斥的路径。
 - **Web Linux 快捷键只有两个可用组合**：宿主的 Web 快捷键只接受 `Ctrl+/`、`Ctrl+Shift+,`、`Ctrl+Shift+.` 三种组合，其中 `Ctrl+/` 已被宿主的快捷键面板占用，所以本插件用后两个，且不能像其它平台一样用字母键。桌面 Windows/Linux 用 `Ctrl+Shift+L` / `Ctrl+Shift+.`，不影响 `Ctrl+L` 的平台含义，也避开 AltGr 会打出字符的组合。
-- **创建选区仍依赖指针**：对话正文是静态渲染，没有可放置的键盘光标；键盘用户需借助光标浏览或辅助技术建立选区。选区建立后的工具条按钮可聚焦，摘要面板已支持 Enter / ↓ / Tab / Esc 与触屏点按。
+- **创建选区仍依赖指针**：对话正文是静态渲染，没有可放置的键盘光标；键盘用户需借助光标浏览或辅助技术建立选区。选区建立后的工具条按钮可聚焦，摘要面板已支持 Enter / ↓ / Tab / Esc 与触屏点按；已有批注可以从正文角标 Tab 聚焦后按 Enter 回看。
 
 ## 常见问题
 
@@ -115,13 +116,15 @@ dsh web --patch "$PWD/dev.patch.yml"
 
 ```bash
 pnpm install
-pnpm run check     # typecheck + build + verify
+pnpm run check     # typecheck + test + build + verify
 pnpm run watch     # 增量重建
 ```
 
 依赖用 pnpm 管理（锁文件 `pnpm-lock.yaml`）；构建产物 `lib/` 随源码一起提交，运行时直接读它。
 
-`pnpm run verify` 无头执行产物：断言 10 项贡献都注册上，检查三份词典的键与 `{placeholder}` 在每种语言里都齐备（复数消息必须有 `.other` 兜底）、插件页展示元信息（locale + icon）按宿主规则解析、`npm pack` 实际发货清单。它还会回放批注持久化与跨标签同步、链接识别、宿主视图解析、发送手势、协议块读写与回声剥离、右键接管判定与两个快捷键命令等关键路径。
+`pnpm run test` 用 Vitest 跑纯逻辑（角标避让、评论泡定位、浮层翻转、触发矩阵、配置归一、链接识别、快捷键默认矩阵）；`pnpm run verify` 无头执行产物：断言 10 项贡献都注册上，检查三份词典的键与 `{placeholder}` 在每种语言里都齐备（复数消息必须有 `.other` 兜底）、插件页展示元信息（locale + icon）按宿主规则解析、`npm pack` 实际发货清单。它还会回放批注持久化与跨标签同步、链接识别、宿主视图解析、发送手势、协议块读写与回声剥离、右键接管判定与两个快捷键命令等关键路径。
+
+CI 在 push 与 PR 上跑同一套 `pnpm run check`（`.github/workflows/check.yml`）。
 
 ### 热更新到桌面客户端
 

package/lib/client.js

@@ -64,6 +64,246 @@ function lastEditable() {
 	return null;
 }
 //#endregion
+//#region src/client/i18n.ts
+/**
+* Copy for dsh-select-quote, served through the host locale service.
+*
+* The active language is owned by `@deepseek-ai/dsh-client-locale` (Settings →
+* General → Language, persisted as `locale.preference`). This module owns only
+* the dictionaries and the plural form selection that the host's plain-template
+* lookup cannot express; it never resolves a language on its own.
+*
+* NOT localized on purpose:
+*   - wire markers (`> [选中文本]`, `<response-annotations>`,
+*     `:dsh-annotation{index="N"}`) — they are the message format the model
+*     and the transcript parser agree on;
+*   - the `# Response annotations:` header — model-facing instruction prose,
+*     not UI text.
+*/
+const LOCALE_NS = "select-quote";
+const zh = {
+	"common.selectedText": "选中的文本",
+	"common.commentPlaceholder": "添加可选评论…",
+	"common.cancel": "取消",
+	"common.close": "关闭",
+	"common.save": "保存",
+	"toolbar.aria": "划词操作",
+	"toolbar.commentHint": "添加批注…",
+	"toolbar.copy": "复制",
+	"toolbar.openLink": "打开链接",
+	"toolbar.copyFailed": "复制失败",
+	"toolbar.addToTask": "添加到任务",
+	"toolbar.commentDialogAria": "添加可选评论",
+	"toolbar.skipComment": "暂不评论",
+	"toolbar.addComment": "添加评论",
+	"menu.aria": "划词菜单",
+	"menu.shortcutLabel": "打开划词菜单",
+	"menu.addShortcutLabel": "将选中文字添加到任务",
+	"menu.noSelection": "先在对话里选中一段文字",
+	"menu.busy": "先完成当前批注",
+	"summary.hint": "悬停查看批注",
+	"summary.hintTouch": "点按查看批注",
+	"summary.dialogAria": "{count} 条划词批注详情",
+	"summary.edit": "编辑批注 {index}",
+	"summary.remove": "移除批注 {index}",
+	"summary.userComment": "用户评论",
+	"summary.noComment": "未添加评论",
+	"summary.aria.other": "{count} 条划词批注。展开查看详情。",
+	"summary.title.other": "{count} 条批注",
+	"summary.removeAll": "移除全部划词批注",
+	"chip.annotation": "批注 {index}",
+	"chip.previewAria": "批注预览",
+	"mark.previewAria": "查看第 {index} 条批注",
+	"chip.jump": "原文",
+	"chip.jumpAria": "跳转到原文",
+	"settings.trigger": "划词入口",
+	"settings.triggerHint": "选中文字后何时显示操作条。触屏始终使用底部操作条。",
+	"settings.trigger.auto": "自动浮出",
+	"settings.trigger.contextmenu": "右键菜单",
+	"settings.trigger.both": "两者都开",
+	"settings.shortcut": "快捷键",
+	"settings.shortcutHint": "开启后，选中文字即可使用下面的快捷键；可在宿主的「快捷键」设置里改键。",
+	"settings.shortcutListAria": "当前快捷键",
+	"settings.shortcutUnavailable": "快捷键暂不可用（可能被其它插件占用）",
+	"settings.shortcutUnbound": "未绑定",
+	"settings.shortcutConflict": "与其它快捷键冲突"
+};
+const en = {
+	"common.selectedText": "Selected text",
+	"common.commentPlaceholder": "Add an optional comment…",
+	"common.cancel": "Cancel",
+	"common.close": "Close",
+	"common.save": "Save",
+	"toolbar.aria": "Selection actions",
+	"toolbar.commentHint": "Add annotation…",
+	"toolbar.copy": "Copy",
+	"toolbar.openLink": "Open link",
+	"toolbar.copyFailed": "Copy failed",
+	"toolbar.addToTask": "Add to task",
+	"toolbar.commentDialogAria": "Add an optional comment",
+	"toolbar.skipComment": "Skip comment",
+	"toolbar.addComment": "Add comment",
+	"menu.aria": "Selection menu",
+	"menu.shortcutLabel": "Open selection menu",
+	"menu.addShortcutLabel": "Add selected text to task",
+	"menu.noSelection": "Select text in the conversation first",
+	"menu.busy": "Finish the current annotation first",
+	"summary.hint": "Hover to view annotations",
+	"summary.hintTouch": "Tap to view annotations",
+	"summary.dialogAria": "Annotation details: {count}",
+	"summary.edit": "Edit annotation {index}",
+	"summary.remove": "Remove annotation {index}",
+	"summary.userComment": "User comment",
+	"summary.noComment": "No comment added",
+	"summary.aria.one": "{count} annotation. Open to view details.",
+	"summary.aria.other": "{count} annotations. Open to view details.",
+	"summary.title.one": "{count} annotation",
+	"summary.title.other": "{count} annotations",
+	"summary.removeAll": "Remove all annotations",
+	"chip.annotation": "Annotation {index}",
+	"chip.previewAria": "Annotation preview",
+	"mark.previewAria": "View annotation {index}",
+	"chip.jump": "Original",
+	"chip.jumpAria": "Jump to original",
+	"settings.trigger": "Trigger",
+	"settings.triggerHint": "When the action bar appears after you select text. Touch screens always use the bottom bar.",
+	"settings.trigger.auto": "Automatic",
+	"settings.trigger.contextmenu": "Right-click",
+	"settings.trigger.both": "Both",
+	"settings.shortcut": "Shortcut",
+	"settings.shortcutHint": "When on, the shortcuts below work on the selected text. Rebind them in the Host's Keyboard shortcuts settings.",
+	"settings.shortcutListAria": "Active shortcuts",
+	"settings.shortcutUnavailable": "Shortcuts are unavailable (another plugin may already use the keys).",
+	"settings.shortcutUnbound": "Unbound",
+	"settings.shortcutConflict": "Conflicts with another shortcut"
+};
+/**
+* Russian is not a shipped host locale: it is added through
+* `ctx.locale.addLanguage()` and its dictionary through the three-argument
+* `register()`. Its fallback chain ends at `en`, as the host requires.
+*/
+const ru = {
+	"common.selectedText": "Выделенный текст",
+	"common.commentPlaceholder": "Добавить необязательный комментарий…",
+	"common.cancel": "Отмена",
+	"common.close": "Закрыть",
+	"common.save": "Сохранить",
+	"toolbar.aria": "Действия с выделенным текстом",
+	"toolbar.commentHint": "Добавить аннотацию…",
+	"toolbar.copy": "Копировать",
+	"toolbar.openLink": "Открыть ссылку",
+	"toolbar.copyFailed": "Не удалось скопировать",
+	"toolbar.addToTask": "Добавить к задаче",
+	"toolbar.commentDialogAria": "Добавить необязательный комментарий",
+	"toolbar.skipComment": "Без комментария",
+	"toolbar.addComment": "Добавить комментарий",
+	"menu.aria": "Меню выделения",
+	"menu.shortcutLabel": "Открыть меню выделения",
+	"menu.addShortcutLabel": "Добавить выделенный текст к задаче",
+	"menu.noSelection": "Сначала выделите текст в диалоге",
+	"menu.busy": "Сначала завершите текущую аннотацию",
+	"summary.hint": "Наведите, чтобы увидеть аннотации",
+	"summary.hintTouch": "Нажмите, чтобы увидеть аннотации",
+	"summary.dialogAria": "Детали аннотаций: {count}",
+	"summary.edit": "Изменить аннотацию {index}",
+	"summary.remove": "Удалить аннотацию {index}",
+	"summary.userComment": "Комментарий пользователя",
+	"summary.noComment": "Комментарий не добавлен",
+	"summary.aria.one": "{count} аннотация. Откройте, чтобы увидеть подробности.",
+	"summary.aria.few": "{count} аннотации. Откройте, чтобы увидеть подробности.",
+	"summary.aria.many": "{count} аннотаций. Откройте, чтобы увидеть подробности.",
+	"summary.aria.other": "{count} аннотаций. Откройте, чтобы увидеть подробности.",
+	"summary.title.one": "{count} аннотация",
+	"summary.title.few": "{count} аннотации",
+	"summary.title.many": "{count} аннотаций",
+	"summary.title.other": "{count} аннотаций",
+	"summary.removeAll": "Удалить все аннотации",
+	"chip.annotation": "Аннотация {index}",
+	"chip.previewAria": "Просмотр аннотации",
+	"mark.previewAria": "Открыть аннотацию {index}",
+	"chip.jump": "Оригинал",
+	"chip.jumpAria": "Перейти к оригиналу",
+	"settings.trigger": "Триггер",
+	"settings.triggerHint": "Когда показывать панель действий после выделения текста. На сенсорных экранах всегда используется нижняя панель.",
+	"settings.trigger.auto": "Автоматически",
+	"settings.trigger.contextmenu": "По правому клику",
+	"settings.trigger.both": "Оба способа",
+	"settings.shortcut": "Горячая клавиша",
+	"settings.shortcutHint": "Когда включено, сочетания ниже работают с выделенным текстом. Изменить их можно в настройках горячих клавиш.",
+	"settings.shortcutListAria": "Текущие сочетания",
+	"settings.shortcutUnavailable": "Сочетания недоступны (возможно, клавиши заняты другим плагином).",
+	"settings.shortcutUnbound": "Не назначено",
+	"settings.shortcutConflict": "Конфликтует с другим сочетанием"
+};
+/** Both shipped host locales, required together by the typed `register()`. */
+const SHIPPED_DICTS = Object.freeze({
+	zh,
+	en
+});
+/** Dictionary for the language registered through {@link LANGUAGE_RU}. */
+const DICTIONARIES = Object.freeze({
+	zh,
+	en,
+	ru
+});
+const LANGUAGE_RU = Object.freeze({
+	id: "ru",
+	label: "Русский",
+	fallback: "en"
+});
+let api;
+/**
+* Install the host-bound translation entry point. Called once from `apply()`
+* with `ctx.locale.bind(LOCALE_NS)` and the live snapshot accessors.
+*/
+function bindLocale(next) {
+	api = next;
+}
+/** Active language id, or `en` before the host service is bound. */
+function activeLocale() {
+	return api?.getActive() ?? "en";
+}
+function pluralForm(count) {
+	const locale = activeLocale();
+	if (locale === "ru") {
+		const mod10 = count % 10;
+		const mod100 = count % 100;
+		if (mod10 === 1 && mod100 !== 11) return "one";
+		if (mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)) return "few";
+		return "many";
+	}
+	if (locale === "en") return count === 1 ? "one" : "other";
+	return "other";
+}
+/**
+* Translate a `select-quote` key. A numeric `count` selects a plural form and
+* the matching `key.form` entry is used, falling back to `key.other`.
+*/
+function t(key, params = {}) {
+	if (!api) return key;
+	if (typeof params.count === "number") {
+		const form = pluralForm(params.count);
+		const exact = api.translate(`${key}.${form}`, params);
+		if (exact !== `${key}.${form}`) return exact;
+		const other = api.translate(`${key}.other`, params);
+		if (other !== `${key}.other`) return other;
+	}
+	return api.translate(key, params);
+}
+/**
+* Subscribe to language or dictionary changes. Components go through
+* `useLocale()` instead; this is the non-React entry point (DOM decorations).
+* Subscribing before the host service is bound is a no-op, so callers subscribe
+* from `apply()`, after `bindLocale()`.
+*/
+function subscribeLocale(listener) {
+	return api ? api.subscribe(listener) : () => {};
+}
+/** Monotonic host revision counter, bumped on locale and dictionary changes. */
+function localeRevision() {
+	return api?.getRevision() ?? 0;
+}
+//#endregion
 //#region src/client/styles.ts
 /**
 * Every style the plugin ships, in four layers.
@@ -1593,7 +1833,7 @@ function placeBadges(anchors, bounds = {}) {
 	return anchors.map((anchor) => {
 		for (let row = 0; row < MAX_ROWS; row += 1) for (let column = 0; column < MAX_COLUMNS; column += 1) {
 			const dx = column * STEP_X;
-			const dy = -row * STEP_Y;
+			const dy = row === 0 ? 0 : -row * STEP_Y;
 			if (!fits(anchor, dx, dy, bounds)) continue;
 			const candidate = {
 				...anchor,
@@ -1782,11 +2022,25 @@ function isMarked(pieces) {
 	if (!first) return false;
 	return first.entry.node.parentElement?.closest(`[${MARK_ATTR}]`) != null;
 }
+function markLabel(index) {
+	return t("mark.previewAria", { index });
+}
+/** The badge fragment is the keyboard entry into that annotation's preview. */
+function makeBadgeInteractive(mark, index) {
+	mark.tabIndex = 0;
+	mark.setAttribute("role", "button");
+	mark.setAttribute("aria-haspopup", "dialog");
+	const label = markLabel(index);
+	if (mark.getAttribute("aria-label") !== label) mark.setAttribute("aria-label", label);
+}
 function createMark(job, withIndex) {
 	const mark = document.createElement("span");
 	mark.className = styles.annMark;
 	mark.setAttribute(MARK_ATTR, job.markId);
-	if (withIndex) mark.setAttribute(INDEX_ATTR, String(job.index));
+	if (withIndex) {
+		mark.setAttribute(INDEX_ATTR, String(job.index));
+		makeBadgeInteractive(mark, job.index);
+	}
 	return mark;
 }
 /**
@@ -1863,8 +2117,17 @@ function refreshMarkIndex(item, job) {
 	const last = marks[marks.length - 1];
 	const next = String(job.index);
 	if (last.getAttribute(INDEX_ATTR) !== next) last.setAttribute(INDEX_ATTR, next);
+	makeBadgeInteractive(last, job.index);
 	return true;
 }
+/** Refresh the localized labels after a language switch (marks survive renders). */
+function refreshAnnotationMarkLabels() {
+	if (typeof document === "undefined") return;
+	for (const mark of document.querySelectorAll(`[${INDEX_ATTR}]`)) {
+		const index = Number(mark.getAttribute(INDEX_ATTR) ?? 0);
+		if (index > 0) makeBadgeInteractive(mark, index);
+	}
+}
 /**
 * Resolve overlapping ordinal badges. Two annotations can end at the same
 * offset (nested ranges), which puts their pseudo-element badges on the same
@@ -2479,385 +2742,148 @@ function bindAnnotationSession(sessionId) {
 	if (!sessionId || sessionId === runtime.sessionId) return;
 	setRuntimeSession(sessionId);
 	queueMicrotask(() => adoptPersistedAnnotations(sessionId));
-}
-/**
-* Adopt persisted annotations for a session.
-*
-* In-memory entries win on conflict — they can only be newer, because anything
-* added after the bind is persisted immediately. Annotations parked in the
-* memory-only bucket (added before the bind) move over as well.
-*/
-function adoptPersistedAnnotations(sessionId) {
-	if (!persistence) return;
-	const stored = persistence.load(sessionId);
-	const current = bySession.get(sessionId) ?? EMPTY$1;
-	const orphaned = bySession.get(MEMORY_KEY) ?? EMPTY$1;
-	const merged = /* @__PURE__ */ new Map();
-	for (const item of stored) merged.set(item.id, item);
-	for (const item of [...current, ...orphaned]) merged.set(item.id, item);
-	const next = [...merged.values()];
-	if (next.length === current.length && next.every((item, i) => item.id === current[i]?.id) && orphaned.length === 0) return;
-	bySession.set(sessionId, next);
-	if (orphaned.length > 0) bySession.delete(MEMORY_KEY);
-	notify();
-}
-/** Same ids in the same order, with the only mutable field (comment) equal. */
-function sameAnnotations(a, b) {
-	return a.length === b.length && a.every((item, i) => {
-		const other = b[i];
-		return other !== void 0 && item.id === other.id && (item.comment ?? "") === (other.comment ?? "");
-	});
-}
-/**
-* Re-read a session after another tab wrote its storage key.
-*
-* Storage is the shared source of truth: every local mutation persists
-* synchronously, so this tab's memory can only be stale relative to it. The
-* stored array replaces the local one (last writer wins) — merging would
-* resurrect annotations the other tab already sent and cleared.
-*
-* `null` is the `localStorage.clear()` event: reload every partition this tab
-* holds. Sessions that are neither cached nor active are ignored; binding the
-* session later reads storage anyway.
-*/
-function adoptStorageAnnotations(sessionId) {
-	if (!persistence) return;
-	if (sessionId === null) {
-		let changed = false;
-		for (const key of [...bySession.keys()]) {
-			if (key === MEMORY_KEY) continue;
-			const stored = persistence.load(key);
-			const current = bySession.get(key);
-			if (stored.length === 0) {
-				bySession.delete(key);
-				changed = true;
-			} else if (current === void 0 || !sameAnnotations(stored, current)) {
-				bySession.set(key, [...stored]);
-				changed = true;
-			}
-		}
-		if (changed) notify();
-		return;
-	}
-	if (!bySession.has(sessionId) && sessionId !== runtime.sessionId) return;
-	const stored = persistence.load(sessionId);
-	if (sameAnnotations(stored, bySession.get(sessionId) ?? EMPTY$1)) return;
-	if (stored.length === 0) bySession.delete(sessionId);
-	else bySession.set(sessionId, [...stored]);
-	notify();
-}
-function annotationTitle(annotation) {
-	return previewTitle(annotation.text);
-}
-//#endregion
-//#region src/client/dom/popoverPlacement.ts
-const GAP$2 = 8;
-const MARGIN = 8;
-/**
-* Place `panel` near `anchor`, flipping vertical side when the preferred side
-* lacks room. Keeps the panel inside `bounds` (the viewport by default).
-*/
-function placePopover(anchor, panel, preferred = "bottom", gap = GAP$2, bounds) {
-	const box = bounds ?? {
-		top: 0,
-		left: 0,
-		right: window.innerWidth,
-		bottom: window.innerHeight
-	};
-	const spaceBelow = box.bottom - anchor.bottom;
-	const spaceAbove = anchor.top - box.top;
-	let side = preferred;
-	const need = panel.height + gap;
-	if (preferred === "bottom" && spaceBelow < need && spaceAbove > spaceBelow) side = "top";
-	else if (preferred === "top" && spaceAbove < need && spaceBelow > spaceAbove) side = "bottom";
-	return {
-		top: side === "bottom" ? Math.min(anchor.bottom + gap, box.bottom - panel.height - MARGIN) : Math.max(anchor.top - panel.height - gap, box.top + MARGIN),
-		left: Math.min(Math.max(anchor.left, box.left + MARGIN), Math.max(box.left + MARGIN, box.right - panel.width - MARGIN)),
-		side
-	};
-}
-//#endregion
-//#region src/client/ui/icons.tsx
-const SVG_ATTRS = {
-	xmlns: "http://www.w3.org/2000/svg",
-	viewBox: "0 0 24 24",
-	fill: "none",
-	stroke: "currentColor",
-	strokeWidth: 2,
-	strokeLinecap: "round",
-	strokeLinejoin: "round",
-	"aria-hidden": true,
-	focusable: false
-};
-const SHAPES = {
-	copy: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("rect", {
-		width: 14,
-		height: 14,
-		x: 8,
-		y: 8,
-		rx: 2,
-		ry: 2
-	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" })] }),
-	pencil: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m15 5 4 4" })] }),
-	"trash-2": /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M10 11v6" }),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M14 11v6" }),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6" }),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M3 6h18" }),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2" })
-	] }),
-	x: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M18 6 6 18" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m6 6 12 12" })] }),
-	plus: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M5 12h14" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M12 5v14" })] }),
-	"external-link": /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M15 3h6v6" }),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M10 14 21 3" }),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" })
-	] })
-};
-function LucideIcon({ name, size = 15 }) {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
-		...SVG_ATTRS,
-		width: size,
-		height: size,
-		children: SHAPES[name]
-	});
-}
-//#endregion
-//#region src/client/i18n.ts
-/**
-* Copy for dsh-select-quote, served through the host locale service.
-*
-* The active language is owned by `@deepseek-ai/dsh-client-locale` (Settings →
-* General → Language, persisted as `locale.preference`). This module owns only
-* the dictionaries and the plural form selection that the host's plain-template
-* lookup cannot express; it never resolves a language on its own.
-*
-* NOT localized on purpose:
-*   - wire markers (`> [选中文本]`, `<response-annotations>`,
-*     `:dsh-annotation{index="N"}`) — they are the message format the model
-*     and the transcript parser agree on;
-*   - the `# Response annotations:` header — model-facing instruction prose,
-*     not UI text.
-*/
-const LOCALE_NS = "select-quote";
-const zh = {
-	"common.selectedText": "选中的文本",
-	"common.commentPlaceholder": "添加可选评论…",
-	"common.cancel": "取消",
-	"common.close": "关闭",
-	"common.save": "保存",
-	"toolbar.aria": "划词操作",
-	"toolbar.commentHint": "添加批注…",
-	"toolbar.copy": "复制",
-	"toolbar.openLink": "打开链接",
-	"toolbar.copyFailed": "复制失败",
-	"toolbar.addToTask": "添加到任务",
-	"toolbar.commentDialogAria": "添加可选评论",
-	"toolbar.skipComment": "暂不评论",
-	"toolbar.addComment": "添加评论",
-	"menu.aria": "划词菜单",
-	"menu.shortcutLabel": "打开划词菜单",
-	"menu.addShortcutLabel": "将选中文字添加到任务",
-	"menu.noSelection": "先在对话里选中一段文字",
-	"menu.busy": "先完成当前批注",
-	"summary.hint": "悬停查看批注",
-	"summary.hintTouch": "点按查看批注",
-	"summary.dialogAria": "{count} 条划词批注详情",
-	"summary.edit": "编辑批注 {index}",
-	"summary.remove": "移除批注 {index}",
-	"summary.userComment": "用户评论",
-	"summary.noComment": "未添加评论",
-	"summary.aria.other": "{count} 条划词批注。展开查看详情。",
-	"summary.title.other": "{count} 条批注",
-	"summary.removeAll": "移除全部划词批注",
-	"chip.annotation": "批注 {index}",
-	"chip.previewAria": "批注预览",
-	"chip.jump": "原文",
-	"chip.jumpAria": "跳转到原文",
-	"settings.trigger": "划词入口",
-	"settings.triggerHint": "选中文字后何时显示操作条。触屏始终使用底部操作条。",
-	"settings.trigger.auto": "自动浮出",
-	"settings.trigger.contextmenu": "右键菜单",
-	"settings.trigger.both": "两者都开",
-	"settings.shortcut": "快捷键",
-	"settings.shortcutHint": "开启后，选中文字即可使用下面的快捷键；可在宿主的「快捷键」设置里改键。",
-	"settings.shortcutListAria": "当前快捷键",
-	"settings.shortcutUnavailable": "快捷键暂不可用（可能被其它插件占用）",
-	"settings.shortcutUnbound": "未绑定",
-	"settings.shortcutConflict": "与其它快捷键冲突"
-};
-const en = {
-	"common.selectedText": "Selected text",
-	"common.commentPlaceholder": "Add an optional comment…",
-	"common.cancel": "Cancel",
-	"common.close": "Close",
-	"common.save": "Save",
-	"toolbar.aria": "Selection actions",
-	"toolbar.commentHint": "Add annotation…",
-	"toolbar.copy": "Copy",
-	"toolbar.openLink": "Open link",
-	"toolbar.copyFailed": "Copy failed",
-	"toolbar.addToTask": "Add to task",
-	"toolbar.commentDialogAria": "Add an optional comment",
-	"toolbar.skipComment": "Skip comment",
-	"toolbar.addComment": "Add comment",
-	"menu.aria": "Selection menu",
-	"menu.shortcutLabel": "Open selection menu",
-	"menu.addShortcutLabel": "Add selected text to task",
-	"menu.noSelection": "Select text in the conversation first",
-	"menu.busy": "Finish the current annotation first",
-	"summary.hint": "Hover to view annotations",
-	"summary.hintTouch": "Tap to view annotations",
-	"summary.dialogAria": "Annotation details: {count}",
-	"summary.edit": "Edit annotation {index}",
-	"summary.remove": "Remove annotation {index}",
-	"summary.userComment": "User comment",
-	"summary.noComment": "No comment added",
-	"summary.aria.one": "{count} annotation. Open to view details.",
-	"summary.aria.other": "{count} annotations. Open to view details.",
-	"summary.title.one": "{count} annotation",
-	"summary.title.other": "{count} annotations",
-	"summary.removeAll": "Remove all annotations",
-	"chip.annotation": "Annotation {index}",
-	"chip.previewAria": "Annotation preview",
-	"chip.jump": "Original",
-	"chip.jumpAria": "Jump to original",
-	"settings.trigger": "Trigger",
-	"settings.triggerHint": "When the action bar appears after you select text. Touch screens always use the bottom bar.",
-	"settings.trigger.auto": "Automatic",
-	"settings.trigger.contextmenu": "Right-click",
-	"settings.trigger.both": "Both",
-	"settings.shortcut": "Shortcut",
-	"settings.shortcutHint": "When on, the shortcuts below work on the selected text. Rebind them in the Host's Keyboard shortcuts settings.",
-	"settings.shortcutListAria": "Active shortcuts",
-	"settings.shortcutUnavailable": "Shortcuts are unavailable (another plugin may already use the keys).",
-	"settings.shortcutUnbound": "Unbound",
-	"settings.shortcutConflict": "Conflicts with another shortcut"
-};
-/**
-* Russian is not a shipped host locale: it is added through
-* `ctx.locale.addLanguage()` and its dictionary through the three-argument
-* `register()`. Its fallback chain ends at `en`, as the host requires.
-*/
-const ru = {
-	"common.selectedText": "Выделенный текст",
-	"common.commentPlaceholder": "Добавить необязательный комментарий…",
-	"common.cancel": "Отмена",
-	"common.close": "Закрыть",
-	"common.save": "Сохранить",
-	"toolbar.aria": "Действия с выделенным текстом",
-	"toolbar.commentHint": "Добавить аннотацию…",
-	"toolbar.copy": "Копировать",
-	"toolbar.openLink": "Открыть ссылку",
-	"toolbar.copyFailed": "Не удалось скопировать",
-	"toolbar.addToTask": "Добавить к задаче",
-	"toolbar.commentDialogAria": "Добавить необязательный комментарий",
-	"toolbar.skipComment": "Без комментария",
-	"toolbar.addComment": "Добавить комментарий",
-	"menu.aria": "Меню выделения",
-	"menu.shortcutLabel": "Открыть меню выделения",
-	"menu.addShortcutLabel": "Добавить выделенный текст к задаче",
-	"menu.noSelection": "Сначала выделите текст в диалоге",
-	"menu.busy": "Сначала завершите текущую аннотацию",
-	"summary.hint": "Наведите, чтобы увидеть аннотации",
-	"summary.hintTouch": "Нажмите, чтобы увидеть аннотации",
-	"summary.dialogAria": "Детали аннотаций: {count}",
-	"summary.edit": "Изменить аннотацию {index}",
-	"summary.remove": "Удалить аннотацию {index}",
-	"summary.userComment": "Комментарий пользователя",
-	"summary.noComment": "Комментарий не добавлен",
-	"summary.aria.one": "{count} аннотация. Откройте, чтобы увидеть подробности.",
-	"summary.aria.few": "{count} аннотации. Откройте, чтобы увидеть подробности.",
-	"summary.aria.many": "{count} аннотаций. Откройте, чтобы увидеть подробности.",
-	"summary.aria.other": "{count} аннотаций. Откройте, чтобы увидеть подробности.",
-	"summary.title.one": "{count} аннотация",
-	"summary.title.few": "{count} аннотации",
-	"summary.title.many": "{count} аннотаций",
-	"summary.title.other": "{count} аннотаций",
-	"summary.removeAll": "Удалить все аннотации",
-	"chip.annotation": "Аннотация {index}",
-	"chip.previewAria": "Просмотр аннотации",
-	"chip.jump": "Оригинал",
-	"chip.jumpAria": "Перейти к оригиналу",
-	"settings.trigger": "Триггер",
-	"settings.triggerHint": "Когда показывать панель действий после выделения текста. На сенсорных экранах всегда используется нижняя панель.",
-	"settings.trigger.auto": "Автоматически",
-	"settings.trigger.contextmenu": "По правому клику",
-	"settings.trigger.both": "Оба способа",
-	"settings.shortcut": "Горячая клавиша",
-	"settings.shortcutHint": "Когда включено, сочетания ниже работают с выделенным текстом. Изменить их можно в настройках горячих клавиш.",
-	"settings.shortcutListAria": "Текущие сочетания",
-	"settings.shortcutUnavailable": "Сочетания недоступны (возможно, клавиши заняты другим плагином).",
-	"settings.shortcutUnbound": "Не назначено",
-	"settings.shortcutConflict": "Конфликтует с другим сочетанием"
-};
-/** Both shipped host locales, required together by the typed `register()`. */
-const SHIPPED_DICTS = Object.freeze({
-	zh,
-	en
-});
-/** Dictionary for the language registered through {@link LANGUAGE_RU}. */
-const DICTIONARIES = Object.freeze({
-	zh,
-	en,
-	ru
-});
-const LANGUAGE_RU = Object.freeze({
-	id: "ru",
-	label: "Русский",
-	fallback: "en"
-});
-let api;
+}
 /**
-* Install the host-bound translation entry point. Called once from `apply()`
-* with `ctx.locale.bind(LOCALE_NS)` and the live snapshot accessors.
+* Adopt persisted annotations for a session.
+*
+* In-memory entries win on conflict — they can only be newer, because anything
+* added after the bind is persisted immediately. Annotations parked in the
+* memory-only bucket (added before the bind) move over as well.
 */
-function bindLocale(next) {
-	api = next;
-}
-/** Active language id, or `en` before the host service is bound. */
-function activeLocale() {
-	return api?.getActive() ?? "en";
+function adoptPersistedAnnotations(sessionId) {
+	if (!persistence) return;
+	const stored = persistence.load(sessionId);
+	const current = bySession.get(sessionId) ?? EMPTY$1;
+	const orphaned = bySession.get(MEMORY_KEY) ?? EMPTY$1;
+	const merged = /* @__PURE__ */ new Map();
+	for (const item of stored) merged.set(item.id, item);
+	for (const item of [...current, ...orphaned]) merged.set(item.id, item);
+	const next = [...merged.values()];
+	if (next.length === current.length && next.every((item, i) => item.id === current[i]?.id) && orphaned.length === 0) return;
+	bySession.set(sessionId, next);
+	if (orphaned.length > 0) bySession.delete(MEMORY_KEY);
+	notify();
 }
-function pluralForm(count) {
-	const locale = activeLocale();
-	if (locale === "ru") {
-		const mod10 = count % 10;
-		const mod100 = count % 100;
-		if (mod10 === 1 && mod100 !== 11) return "one";
-		if (mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)) return "few";
-		return "many";
-	}
-	if (locale === "en") return count === 1 ? "one" : "other";
-	return "other";
+/** Same ids in the same order, with the only mutable field (comment) equal. */
+function sameAnnotations(a, b) {
+	return a.length === b.length && a.every((item, i) => {
+		const other = b[i];
+		return other !== void 0 && item.id === other.id && (item.comment ?? "") === (other.comment ?? "");
+	});
 }
 /**
-* Translate a `select-quote` key. A numeric `count` selects a plural form and
-* the matching `key.form` entry is used, falling back to `key.other`.
+* Re-read a session after another tab wrote its storage key.
+*
+* Storage is the shared source of truth: every local mutation persists
+* synchronously, so this tab's memory can only be stale relative to it. The
+* stored array replaces the local one (last writer wins) — merging would
+* resurrect annotations the other tab already sent and cleared.
+*
+* `null` is the `localStorage.clear()` event: reload every partition this tab
+* holds. Sessions that are neither cached nor active are ignored; binding the
+* session later reads storage anyway.
 */
-function t(key, params = {}) {
-	if (!api) return key;
-	if (typeof params.count === "number") {
-		const form = pluralForm(params.count);
-		const exact = api.translate(`${key}.${form}`, params);
-		if (exact !== `${key}.${form}`) return exact;
-		const other = api.translate(`${key}.other`, params);
-		if (other !== `${key}.other`) return other;
+function adoptStorageAnnotations(sessionId) {
+	if (!persistence) return;
+	if (sessionId === null) {
+		let changed = false;
+		for (const key of [...bySession.keys()]) {
+			if (key === MEMORY_KEY) continue;
+			const stored = persistence.load(key);
+			const current = bySession.get(key);
+			if (stored.length === 0) {
+				bySession.delete(key);
+				changed = true;
+			} else if (current === void 0 || !sameAnnotations(stored, current)) {
+				bySession.set(key, [...stored]);
+				changed = true;
+			}
+		}
+		if (changed) notify();
+		return;
 	}
-	return api.translate(key, params);
+	if (!bySession.has(sessionId) && sessionId !== runtime.sessionId) return;
+	const stored = persistence.load(sessionId);
+	if (sameAnnotations(stored, bySession.get(sessionId) ?? EMPTY$1)) return;
+	if (stored.length === 0) bySession.delete(sessionId);
+	else bySession.set(sessionId, [...stored]);
+	notify();
+}
+function annotationTitle(annotation) {
+	return previewTitle(annotation.text);
 }
+//#endregion
+//#region src/client/dom/popoverPlacement.ts
+const GAP$2 = 8;
+const MARGIN = 8;
 /**
-* Subscribe to language or dictionary changes. Components go through
-* `useLocale()` instead; this is the non-React entry point (DOM decorations).
-* Subscribing before the host service is bound is a no-op, so callers subscribe
-* from `apply()`, after `bindLocale()`.
+* Place `panel` near `anchor`, flipping vertical side when the preferred side
+* lacks room. Keeps the panel inside `bounds` (the viewport by default).
 */
-function subscribeLocale(listener) {
-	return api ? api.subscribe(listener) : () => {};
+function placePopover(anchor, panel, preferred = "bottom", gap = GAP$2, bounds) {
+	const box = bounds ?? {
+		top: 0,
+		left: 0,
+		right: window.innerWidth,
+		bottom: window.innerHeight
+	};
+	const spaceBelow = box.bottom - anchor.bottom;
+	const spaceAbove = anchor.top - box.top;
+	let side = preferred;
+	const need = panel.height + gap;
+	if (preferred === "bottom" && spaceBelow < need && spaceAbove > spaceBelow) side = "top";
+	else if (preferred === "top" && spaceAbove < need && spaceBelow > spaceAbove) side = "bottom";
+	return {
+		top: side === "bottom" ? Math.min(anchor.bottom + gap, box.bottom - panel.height - MARGIN) : Math.max(anchor.top - panel.height - gap, box.top + MARGIN),
+		left: Math.min(Math.max(anchor.left, box.left + MARGIN), Math.max(box.left + MARGIN, box.right - panel.width - MARGIN)),
+		side
+	};
 }
-/** Monotonic host revision counter, bumped on locale and dictionary changes. */
-function localeRevision() {
-	return api?.getRevision() ?? 0;
+//#endregion
+//#region src/client/ui/icons.tsx
+const SVG_ATTRS = {
+	xmlns: "http://www.w3.org/2000/svg",
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: 2,
+	strokeLinecap: "round",
+	strokeLinejoin: "round",
+	"aria-hidden": true,
+	focusable: false
+};
+const SHAPES = {
+	copy: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("rect", {
+		width: 14,
+		height: 14,
+		x: 8,
+		y: 8,
+		rx: 2,
+		ry: 2
+	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" })] }),
+	pencil: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m15 5 4 4" })] }),
+	"trash-2": /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M10 11v6" }),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M14 11v6" }),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6" }),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M3 6h18" }),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2" })
+	] }),
+	x: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M18 6 6 18" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m6 6 12 12" })] }),
+	plus: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M5 12h14" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M12 5v14" })] }),
+	"external-link": /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M15 3h6v6" }),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M10 14 21 3" }),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" })
+	] })
+};
+function LucideIcon({ name, size = 15 }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+		...SVG_ATTRS,
+		width: size,
+		height: size,
+		children: SHAPES[name]
+	});
 }
 //#endregion
 //#region src/client/useLocale.ts
@@ -5293,6 +5319,7 @@ let onScroll = null;
 let onResize = null;
 let leavingBox = null;
 let leavingTimer = 0;
+let markBindingCleanup = null;
 function cancelTimers() {
 	if (showTimer !== 0) window.clearTimeout(showTimer);
 	if (hideTimer !== 0) window.clearTimeout(hideTimer);
@@ -5453,12 +5480,14 @@ function jumpToMark(event) {
 	}
 	if (text) scrollToAnnotation(index, text);
 }
-function buildPreview(index, quoteText, comment) {
+function buildPreview(index, quoteText, comment, withJump = true) {
 	const box = document.createElement("div");
 	box.className = cx(A.col, styles.chipPreview);
 	box.setAttribute("data-dsq-chip-preview", "true");
 	box.setAttribute("role", "dialog");
 	box.setAttribute("aria-label", t("chip.previewAria"));
+	box.tabIndex = -1;
+	jumpButton = null;
 	const body = document.createElement("div");
 	body.className = styles.chipPreviewBody;
 	body.style.animation = "none";
@@ -5467,18 +5496,21 @@ function buildPreview(index, quoteText, comment) {
 	const title = document.createElement("span");
 	title.className = styles.chipPreviewTitle;
 	title.textContent = t("chip.annotation", { index });
-	jumpButton = document.createElement("button");
-	jumpButton.type = "button";
-	jumpButton.className = cx(A.plain, A.inlineRow, styles.chipPreviewJump);
-	jumpButton.setAttribute("data-dsq-chip-jump", "true");
-	jumpButton.setAttribute("aria-label", t("chip.jumpAria"));
-	jumpButton.title = t("chip.jumpAria");
-	jumpButton.insertAdjacentHTML("afterbegin", JUMP_ICON);
-	const jumpLabel = document.createElement("span");
-	jumpLabel.textContent = t("chip.jump");
-	jumpButton.append(jumpLabel);
-	jumpButton.addEventListener("click", jumpToMark);
-	head.append(title, jumpButton);
+	head.append(title);
+	if (withJump) {
+		jumpButton = document.createElement("button");
+		jumpButton.type = "button";
+		jumpButton.className = cx(A.plain, A.inlineRow, styles.chipPreviewJump);
+		jumpButton.setAttribute("data-dsq-chip-jump", "true");
+		jumpButton.setAttribute("aria-label", t("chip.jumpAria"));
+		jumpButton.title = t("chip.jumpAria");
+		jumpButton.insertAdjacentHTML("afterbegin", JUMP_ICON);
+		const jumpLabel = document.createElement("span");
+		jumpLabel.textContent = t("chip.jump");
+		jumpButton.append(jumpLabel);
+		jumpButton.addEventListener("click", jumpToMark);
+		head.append(jumpButton);
+	}
 	body.append(head);
 	appendLabel(body, t("common.selectedText"));
 	appendText(body, styles.chipPreviewQuote, quoteText);
@@ -5505,6 +5537,39 @@ function buildPreview(index, quoteText, comment) {
 	});
 	return box;
 }
+/** Show and watch one preview; `activeChip` is the element it belongs to. */
+function mountPreview(box, anchor) {
+	preview = box;
+	box.style.visibility = "hidden";
+	document.body.append(box);
+	const { top, left } = placePopover(anchor, {
+		width: box.offsetWidth || 320,
+		height: box.offsetHeight || 180
+	}, "top", GAP);
+	box.style.top = `${top}px`;
+	box.style.left = `${left}px`;
+	box.style.visibility = "";
+	const animated = box.querySelector(`.${styles.chipPreviewBody}`);
+	if (animated) animated.style.animation = "";
+	onDocPointerDown = (event) => {
+		const target = event.target;
+		if (!(target instanceof Node)) return;
+		if (box.contains(target) || activeChip?.contains(target)) return;
+		closeChipPreview(false);
+	};
+	document.addEventListener("pointerdown", onDocPointerDown, true);
+	onScroll = scheduleReposition;
+	document.addEventListener("scroll", onScroll, true);
+	onResize = scheduleReposition;
+	window.addEventListener("resize", onResize);
+	observer = new MutationObserver(() => {
+		if (activeChip && !activeChip.isConnected) closeChipPreview(false);
+	});
+	observer.observe(document.body, {
+		childList: true,
+		subtree: true
+	});
+}
 function showChipPreview(chip, index, nextPinned) {
 	cancelTimers();
 	if (!chip.isConnected) return;
@@ -5538,38 +5603,105 @@ function showChipPreview(chip, index, nextPinned) {
 	activeText = text;
 	activeIndex = index;
 	pinned = nextPinned;
-	const box = buildPreview(index, text, quote ? (quote.comment ?? "").trim() : null);
-	preview = box;
-	box.style.visibility = "hidden";
-	document.body.append(box);
-	const panel = {
-		width: box.offsetWidth || 320,
-		height: box.offsetHeight || 180
+	mountPreview(buildPreview(index, text, quote ? (quote.comment ?? "").trim() : null), chip.getBoundingClientRect());
+}
+/**
+* Resolve the annotation behind a transcript mark. Durable marks carry a
+* `dqsm_` id and read their quote from the user turn's registry; pending marks
+* carry the store id and read the live list, so a comment edited after
+* decoration still shows up.
+*/
+function annotationOfMark(mark) {
+	const id = mark.getAttribute("data-dsq-ann-mark") ?? "";
+	const index = Number(mark.getAttribute("data-dsq-ann-index") ?? 0);
+	if (index <= 0) return null;
+	if (id.startsWith("dqsm_")) {
+		const ownerKey = quotesOwnerOf(mark);
+		const quote = ownerKey ? messageQuotes(ownerKey)?.[index - 1] : void 0;
+		if (!ownerKey || !quote) return null;
+		const text = quote.text.trim();
+		return text ? {
+			text,
+			comment: (quote.comment ?? "").trim(),
+			ownerKey,
+			messageId: quote.messageId ?? null
+		} : null;
+	}
+	const item = getAnnotations().find((annotation) => annotation.id === id);
+	if (!item) return null;
+	const text = item.text.trim();
+	return text ? {
+		text,
+		comment: (item.comment ?? "").trim(),
+		ownerKey: null,
+		messageId: item.sources[0]?.messageId ?? null
+	} : null;
+}
+function showMarkPreview(mark, focus) {
+	if (!mark.isConnected) return;
+	const index = Number(mark.getAttribute("data-dsq-ann-index") ?? 0);
+	if (index <= 0) return;
+	if (activeChip === mark && preview) {
+		pinned = true;
+		return;
+	}
+	const data = annotationOfMark(mark);
+	if (!data) return;
+	cancelTimers();
+	closeChipPreview(false);
+	flushLeavingPreview();
+	activeChip = mark;
+	activeMark = mark;
+	activeOwnerKey = data.ownerKey;
+	activeMessageId = data.messageId;
+	activeText = data.text;
+	activeIndex = index;
+	pinned = true;
+	const box = buildPreview(index, data.text, data.comment, false);
+	mountPreview(box, mark.getBoundingClientRect());
+	if (focus) box.focus({ preventScroll: true });
+}
+/**
+* Click/keyboard previews for the ordinal badge fragments in transcript
+* marks. Delegated on the document: marks are replaced by host re-renders and
+* binding every fragment would leak listeners across those passes.
+*/
+function bindAnnotationMarkPreview() {
+	if (typeof document === "undefined") return () => {};
+	if (markBindingCleanup) return markBindingCleanup;
+	const markOf = (target) => {
+		if (!(target instanceof Element)) return null;
+		return target.closest("[data-dsq-ann-mark]");
 	};
-	const { top, left } = placePopover(chip.getBoundingClientRect(), panel, "top", GAP);
-	box.style.top = `${top}px`;
-	box.style.left = `${left}px`;
-	box.style.visibility = "";
-	const animated = box.querySelector(`.${styles.chipPreviewBody}`);
-	if (animated) animated.style.animation = "";
-	onDocPointerDown = (event) => {
-		const target = event.target;
-		if (!(target instanceof Node)) return;
-		if (box.contains(target) || activeChip?.contains(target)) return;
-		closeChipPreview(false);
+	const onClick = (event) => {
+		const mark = markOf(event.target);
+		if (!mark) return;
+		const selection = window.getSelection();
+		if (selection && !selection.isCollapsed) return;
+		showMarkPreview(mark, false);
 	};
-	document.addEventListener("pointerdown", onDocPointerDown, true);
-	onScroll = scheduleReposition;
-	document.addEventListener("scroll", onScroll, true);
-	onResize = scheduleReposition;
-	window.addEventListener("resize", onResize);
-	observer = new MutationObserver(() => {
-		if (activeChip && !activeChip.isConnected) closeChipPreview(false);
-	});
-	observer.observe(document.body, {
-		childList: true,
-		subtree: true
-	});
+	const onKeyDown = (event) => {
+		const mark = markOf(event.target);
+		if (!mark) return;
+		if (event.key === "Escape" && preview !== null) {
+			event.preventDefault();
+			closeChipPreview(true);
+			return;
+		}
+		if ((event.key === "Enter" || event.key === " ") && mark.hasAttribute("data-dsq-ann-index")) {
+			event.preventDefault();
+			showMarkPreview(mark, true);
+		}
+	};
+	document.addEventListener("click", onClick);
+	document.addEventListener("keydown", onKeyDown);
+	const cleanup = () => {
+		document.removeEventListener("click", onClick);
+		document.removeEventListener("keydown", onKeyDown);
+		markBindingCleanup = null;
+	};
+	markBindingCleanup = cleanup;
+	return cleanup;
 }
 /** Close the preview. `restoreFocus` is for a deliberate Escape. */
 function closeChipPreview(restoreFocus) {
@@ -6253,7 +6385,10 @@ function apply(ctx) {
 		getRevision: () => ctx.locale.getSnapshot().revision,
 		subscribe: (listener) => ctx.locale.subscribe(listener)
 	});
-	ctx.effect(() => subscribeLocale(() => refreshDirectiveChips()), "dsh-select-quote: chip language");
+	ctx.effect(() => subscribeLocale(() => {
+		refreshDirectiveChips();
+		refreshAnnotationMarkLabels();
+	}), "dsh-select-quote: chip language");
 	ctx.inject(["configForms"], (scope) => {
 		scope.effect(() => attachConfigForm(scope.configForms.get(ROW_ID)), "dsh-select-quote: config");
 		const form = scope.configForms.get(ROW_ID);
@@ -6269,6 +6404,7 @@ function apply(ctx) {
 	});
 	ctx.effect(() => watchAnnotationDirectives(), "dsh-select-quote: annotation directives");
 	ctx.effect(() => watchAnnotationMarks(), "dsh-select-quote: annotation marks");
+	ctx.effect(() => bindAnnotationMarkPreview(), "dsh-select-quote: mark preview");
 	ctx.effect(() => watchSubmissionEcho(), "dsh-select-quote: submission echo");
 	ctx.effect(() => {
 		syncPendingAnnotationJobs(getAnnotations());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-select-quote",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "DeepSeek Harness web plugin: annotate text selected in the conversation — the selection rides along with your next message, is marked in the source text, and the model points back at it.",
   "keywords": [
     "deepseek",
@@ -44,8 +44,9 @@
     "sync:desktop": "node scripts/sync-desktop.mjs",
     "dev:desktop": "node scripts/dev-desktop.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
     "verify": "node scripts/verify-bundle.mjs",
-    "check": "pnpm run typecheck && pnpm run build && pnpm run verify",
+    "check": "pnpm run typecheck && pnpm run test && pnpm run build && pnpm run verify",
     "release": "pnpm run check && commit-and-tag-version"
   },
   "dsh": {
@@ -83,6 +84,7 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "tsdown": "0.23.0",
-    "typescript": "^5.8.0"
+    "typescript": "^5.8.0",
+    "vitest": "^5.0.5"
   }
 }