dsh-select-quote 0.2.0 → 0.3.1

package/README.md

@@ -1,12 +1,13 @@
 # dsh-select-quote
 
-[DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/guide/quickstart) 的 Web 客户端插件：在对话里**划词加批注**——把选中的原文连同你的评论一起交给模型，并让它在回答里明确指出说的是哪一段。
+[DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/guide/quickstart) 的客户端插件：在对话里**划词加批注**——选中的原文连同你的评论一起交给模型，并让它在回答里明确指出说的是哪一段。
 
 - **划词工具条**：选中对话区任意文本，浮出「复制 / 添加到任务」；拖拽结束才出现，不挡操作
-- **批注卡片**：添加后输入框内出现一张摘要卡片（可多条），**草稿里不会出现任何协议文本**
-- **正文标记**：被划中的文字在原消息里留下虚线下划线 + 序号角标；点卡片里的条目会滚回那段文字
-- **模型回指**：模型回答时以内联指令标出它处理的每一条批注，插件把这些指令渲染成可点击的 chip
-- **对话记录**：已发送消息里的批注渲染为卡片，用户气泡只剩你打的问题
+- **批注卡片**：添加后输入框内出现摘要卡片（可多条），草稿里不会出现任何协议文本
+- **正文标记**：被划中的文字在原消息里留下虚线下划线 + 序号角标，点卡片条目会滚回那段文字
+- **模型回指**：模型回答里指向某条批注的位置，渲染成可点击的 chip
+- **对话记录**：已发送消息里的批注渲染成卡片，用户气泡只剩你打的问题
+- **界面语言**：跟随 dsh 自己的语言设置，简体中文 / English / Русский
 
 ![screenshot](https://raw.githubusercontent.com/latte03/dsh-select-quote/main/assets/screenshot-1.png)
 
@@ -14,59 +15,85 @@
 
 ---
 
-## 兼容性
-
-| 项 | 值 |
-|---|---|
-| dsh | `0.1.7-rc.1`（2026-09-24 实测：划词、批注卡片、正文标记、对话记录渲染全通） |
-| profile | web（`dsh web`） |
-| 运行时 | 只有浏览器半有业务；Node 半仅用于让包被 Loader 挂载 |
-
-实现依赖若干产品内部约定（槽位名、composer DOM、深色主题属性等），升级 dsh 后请先跑 `npm run check`，再照 [`docs/internals.md`](docs/internals.md) 末尾的复核清单人工回归一遍。
-
 ## 安装
 
-### 方式一：从 npm 安装（bundle）
+网页版：
 
 ```bash
 dsh plugin --profile web add dsh-select-quote
 dsh --profile web
 ```
 
-> ⚠️ npm 上目前只有 `0.1.0`，那是旧版「引用块」行为，不含批注卡片、正文标记与模型回指。要用现在这套，请先用方式二，或从仓库目录安装：`dsh plugin --profile web add <本仓库绝对路径>`。
+桌面版：在应用内输入`dsh-select-quote`安装，或者插件页搜索 `dsh-select-quote` 安装，重启客户端生效。
 
-### 方式二：本地 checkout 加载（`--patch`）
+改了代码想立刻验证，用本地 checkout 加载：
 
 ```bash
-git clone <repo> && cd dsh-select-quote
+git clone https://github.com/latte03/dsh-select-quote && cd dsh-select-quote
 npm install && npm run build
 dsh web --patch "$PWD/dev.patch.yml"
 ```
 
-打开 `http://127.0.0.1:3080`，在对话消息里划词即可看到工具条。`dev.patch.yml` 里的插件路径按本机写死（必须是绝对路径），换机器或换目录时改那一行；该文件不随 npm 包发布。
+打开 `http://127.0.0.1:3080`，在对话消息里划词即可看到工具条。`dev.patch.yml` 里的插件路径必须是绝对路径，换机器或换目录时改那一行；该文件不随 npm 包发布。
 
 ## 用法
 
-1. 在对话区选中一段文本 → 点「添加到任务」
-2. 弹出评论框，写一句想说的话（可留空，只划不评）→ `⌘/Ctrl + Enter` 确认
-3. 输入框上方出现批注卡片，悬停可展开列表：逐条编辑、删除，或一键清空；点条目会跳到正文里对应的那段文字
-4. 正常打字、按 Enter 发送。批注随消息一起交给模型，卡片随之消失
-5. 模型回答里指向某条批注的位置，会显示成可点的 chip
+1. 在对话区选中一段文本，点「添加到任务」
+2. 在弹出的评论框里写一句想说的话（可留空，只划不评），`⌘/Ctrl + Enter` 确认
+3. 输入框上方出现批注卡片：悬停展开列表，可逐条编辑、删除或一键清空，点条目跳回正文对应文字
+4. 正常打字发送，批注随消息一起交给模型，卡片随之消失
+5. 模型回答里引用某条批注的位置显示为可点击 chip
+
+## 语言
+
+界面语言由 dsh 决定，插件不再自己判断浏览器语言。在 **设置 → 通用 → 语言** 里切换。
+
 
 ## 已知限制
 
-- **待发批注只在内存里**：刷新页面或切换会话后会丢，卡片不持久化（已发送消息里的批注不受影响）。
-- **占用了用户气泡的渲染**：本插件以最低优先级替换内置 `user` 节点。若其它插件也替换同一个键（例如 `dsh-easyrewrite` 用 `-1`），会被本插件屏蔽。
+- **待发批注只在内存里**：刷新页面或切换会话后会丢，卡片不持久化；已发送消息里的批注不受影响。
+- **占用了用户气泡的渲染**：本插件以最低优先级替换内置 `user` 节点。其它插件若替换同一个键（例如 `dsh-easyrewrite` 用 `-1`），会被本插件屏蔽。
 - **卡片宽度有限**：输入框内每条摘要最宽约为输入框的 1/4，超长标题走省略号。
-- 划词只在对话区生效，不介入编辑器、终端等面板。
+- **划词只在对话区生效**：不介入编辑器、终端等面板。
+
+## 常见问题
+
+**升级 dsh 之后功能不对？** 先 `npm run check`；产物没问题就对照 [`docs/internals.md`](docs/internals.md) 的「依赖的产品内部约定」逐条复核，那里列了所有产品内部名。
+
+**划词没有工具条？** 确认选区在对话区而不是编辑器里；刷新页面（样式与观察者是幂等注入的）；宿主 boot 日志里应出现 `dsh-select-quote`。
+
+**输入框里出现了协议原文？** 发送前的注入没生效，一般是 composer 结构变了——检查 `[data-composer-card]` 是否还在。
+
+**对话记录里没有批注卡片？** 卡片渲染在用户气泡内部，若 `user` 节点被别的接管者赢走，或那条消息里确实没有批注块，都不会出现。
+
+**界面语言不跟着 dsh 变？** 文案取自宿主的语言服务；宿主没有该服务或语言未注册时回退到 English。此时确认 dsh 版本带 `dsh-client-locale`，以及设置里确有语言选项。
+
+**改了 CSS 不生效？** 样式只注入一次，刷新页面。
 
 ## 开发
 
 ```bash
-npm run check   # typecheck + build + verify，提交前跑这个
+npm install
+npm run check     # typecheck + build + verify
+npm run watch     # 增量重建
+```
+
+`npm run verify` 无头执行产物，断言 8 项贡献都注册上，并检查三份词典的键与 `{placeholder}` 在每种语言里都齐备（复数消息必须有 `.other` 兜底）。
+
+发布：先把源码与产物 `lib/` 一起提交，再跑
+
+```bash
+npm run release   # check → 追加 CHANGELOG.md → 提升版本号并打 tag
 ```
 
-改 CSS 后要刷新页面（样式只注入一次）。协议格式、槽位注册、以及几处非显而易见的坑（U+200B 草稿标记、portal 到 body 的浮层、`--dsq-quote-pad` 高度补偿）记录在 **[docs/internals.md](docs/internals.md)**。
+## 贡献
+
+fork 后开分支，提交前跑 `npm run check`。一个 PR 只讲一件事，功能与文档分开，方便追溯。PR 里写清复现方式（环境、dsh 版本、操作步骤）。
+
+## 致谢
+
+- [@imallakov](https://github.com/imallakov)：多语言文案、跨平台构建、装饰器楔死修复与批注卡片归属（PR #2 / #3 / #4）
+- [@EliteOtaku](https://github.com/EliteOtaku)：桌面端渲染进程楔死的定位报告与 CDP 探针方法（[#1](https://github.com/latte03/dsh-select-quote/issues/1)）
 
 ## License
 

package/lib/client.js

@@ -642,17 +642,19 @@ const CSS = `
   gap: 6px;
 }
 
-/* Transcript cards — in-flow Chat node (conversation history), stacked. */
+/* Transcript cards — in-flow rows under the user bubble, side by side. */
 .dsq_tCardStack {
   display: flex;
-  flex-direction: column;
+  flex-direction: row;
+  flex-wrap: wrap;
+  justify-content: flex-end;
   align-items: stretch;
   gap: 6px;
   margin: 4px 0 8px;
-  /* Match composer summary width; sit on the user-bubble side (right). */
-  width: 20%;
-  min-width: 148px;
-  max-width: 220px;
+  /* Cards lay out horizontally and wrap onto the next row when they run out of
+     width. Each card carries the selected text plus the user's comment, so they
+     stay compact and stay on the user-bubble side (right). */
+  max-width: 100%;
   margin-left: auto;
   margin-right: 0;
 }
@@ -729,6 +731,77 @@ const CSS = `
   white-space: nowrap;
 }
 
+/* Transcript card wrapper: the card itself is a click target that scrolls back
+   to the marked text. Unlike the composer summary (one collapsed row per
+   message) each history card shows its own comment, so the fixed 64px height
+   and the single-line clamps are lifted here. */
+.dsq_tCardButton {
+  appearance: none;
+  display: block;
+  /* Compact cards: several fit in one row before wrapping. */
+  flex: 0 1 auto;
+  width: 230px;
+  max-width: 100%;
+  padding: 0;
+  border: none;
+  background: transparent;
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+  border-radius: 14px;
+}
+
+.dsq_tCardButton:focus-visible {
+  outline: 2px solid var(--dsw-static-blue-500, #3b82f6);
+  outline-offset: 2px;
+}
+
+.dsq_tCardButton .dsq_tCard {
+  height: auto;
+  min-height: 0;
+  align-items: flex-start;
+  width: 100%;
+  gap: 8px;
+  padding: 8px;
+  border-radius: 14px;
+}
+
+.dsq_tCardButton .dsq_tCardIcon {
+  width: 22px;
+  height: 22px;
+  border-radius: 8px;
+  font-size: 11px;
+}
+
+.dsq_tCardButton .dsq_tCardTitle {
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+  white-space: normal;
+  overflow-wrap: anywhere;
+  font-size: 13px;
+  line-height: 18px;
+}
+
+.dsq_tCardButton .dsq_tCardSubtitle {
+  display: -webkit-box;
+  -webkit-line-clamp: 3;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  margin-top: 2px;
+  font-size: 12px;
+  line-height: 16px;
+}
+
+/* A comment is the user's own words — give it more presence than the neutral
+   "no comment" placeholder. */
+.dsq_tCardButton .dsq_tCardSubtitle[data-dsq-has-comment='true'] {
+  color: var(--dsw-alias-label-secondary, rgba(0, 0, 0, 0.65));
+}
+
 /* Replacement user bubble (quote block stripped from display). */
 .dsq_userRow {
   display: flex;
@@ -916,6 +989,7 @@ const styles = {
 	commentInput: "dsq_commentInput",
 	commentActions: "dsq_commentActions",
 	tCardStack: "dsq_tCardStack",
+	tCardButton: "dsq_tCardButton",
 	tCard: "dsq_tCard",
 	tCardIcon: "dsq_tCardIcon",
 	tCardBody: "dsq_tCardBody",
@@ -1338,16 +1412,6 @@ function contentBlocksToText(content) {
 		return "";
 	}).join("");
 }
-/**
-* Best-effort plain text from a durable `user/message` event. A surface event
-* carries its blocks directly on `data.content`; `data.message.content` is only
-* a fallback for the older shape.
-*/
-function extractUserText(event) {
-	const data = event?.data;
-	if (!data) return "";
-	return contentBlocksToText(data.content ?? data.message?.content);
-}
 /** Short one-line card title from selected body text. */
 function previewTitle$1(text, max = 48) {
 	const oneLine = text.replace(/\s+/g, " ").trim();
@@ -1526,10 +1590,6 @@ function scanAnnotatedMessage(text) {
 		rest
 	};
 }
-/** Convenience: annotations only. */
-function parseAnnotatedMessage(text) {
-	return scanAnnotatedMessage(text).annotations;
-}
 //#endregion
 //#region src/client/state/annotation-store.ts
 /** Per-session pending selection annotations (composer-side store). */
@@ -1704,7 +1764,249 @@ function LucideIcon({ name, size = 15 }) {
 	});
 }
 //#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.save": "保存",
+	"toolbar.aria": "划词操作",
+	"toolbar.commentHint": "添加批注…",
+	"toolbar.copy": "复制",
+	"toolbar.copyFailed": "复制失败",
+	"toolbar.addToTask": "添加到任务",
+	"toolbar.commentDialogAria": "添加可选评论",
+	"toolbar.skipComment": "暂不评论",
+	"toolbar.addComment": "添加评论",
+	"card.commentSubtitle": "评论 · {comment}",
+	"card.ariaIndexed": "批注 {index}",
+	"card.ariaPlain": "划词批注",
+	"card.editComment": "编辑评论",
+	"card.remove": "移除批注",
+	"summary.hint": "悬停查看批注",
+	"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}"
+};
+const en = {
+	"common.selectedText": "Selected text",
+	"common.commentPlaceholder": "Add an optional comment…",
+	"common.cancel": "Cancel",
+	"common.save": "Save",
+	"toolbar.aria": "Selection actions",
+	"toolbar.commentHint": "Add annotation…",
+	"toolbar.copy": "Copy",
+	"toolbar.copyFailed": "Copy failed",
+	"toolbar.addToTask": "Add to task",
+	"toolbar.commentDialogAria": "Add an optional comment",
+	"toolbar.skipComment": "Skip comment",
+	"toolbar.addComment": "Add comment",
+	"card.commentSubtitle": "Comment · {comment}",
+	"card.ariaIndexed": "Annotation {index}",
+	"card.ariaPlain": "Selection annotation",
+	"card.editComment": "Edit comment",
+	"card.remove": "Remove annotation",
+	"summary.hint": "Hover 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. Hover to view details.",
+	"summary.aria.other": "{count} annotations. Hover to view details.",
+	"summary.title.one": "{count} annotation",
+	"summary.title.other": "{count} annotations",
+	"summary.removeAll": "Remove all annotations",
+	"chip.annotation": "Annotation {index}"
+};
+/**
+* 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.save": "Сохранить",
+	"toolbar.aria": "Действия с выделенным текстом",
+	"toolbar.commentHint": "Добавить аннотацию…",
+	"toolbar.copy": "Копировать",
+	"toolbar.copyFailed": "Не удалось скопировать",
+	"toolbar.addToTask": "Добавить к задаче",
+	"toolbar.commentDialogAria": "Добавить необязательный комментарий",
+	"toolbar.skipComment": "Без комментария",
+	"toolbar.addComment": "Добавить комментарий",
+	"card.commentSubtitle": "Комментарий · {comment}",
+	"card.ariaIndexed": "Аннотация {index}",
+	"card.ariaPlain": "Аннотация к выделенному тексту",
+	"card.editComment": "Изменить комментарий",
+	"card.remove": "Удалить аннотацию",
+	"summary.hint": "Наведите, чтобы увидеть аннотации",
+	"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}"
+};
+/** 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/useLocale.ts
+/**
+* Re-render the calling component when the host language changes, so slot copy
+* switches without a page reload. Subscriptions happen after mount, by which
+* time `apply()` has bound the locale service.
+*/
+function useLocale() {
+	(0, react.useSyncExternalStore)(subscribeLocale, localeRevision, localeRevision);
+}
+//#endregion
 //#region src/client/ui/AnnotationCardView.tsx
+function AnnotationCardView({ title, text, comment, variant, index, onRemove, onEditComment }) {
+	useLocale();
+	const composer = variant === "composer";
+	const subtitle = comment ? composer ? t("card.commentSubtitle", { comment }) : comment : composer ? t("common.selectedText") : t("summary.noComment");
+	return (0, react_jsx_runtime.jsxs)("div", {
+		className: composer ? styles.card : styles.tCard,
+		role: "group",
+		"aria-label": index ? t("card.ariaIndexed", { index }) : t("card.ariaPlain"),
+		children: [
+			(0, react_jsx_runtime.jsx)("div", {
+				className: composer ? styles.cardIcon : styles.tCardIcon,
+				"aria-hidden": true,
+				children: index ? String(index) : "AI"
+			}),
+			(0, react_jsx_runtime.jsxs)("div", {
+				className: composer ? styles.cardBody : styles.tCardBody,
+				children: [(0, react_jsx_runtime.jsx)("div", {
+					className: composer ? styles.cardTitle : styles.tCardTitle,
+					title: text,
+					children: title
+				}), (0, react_jsx_runtime.jsx)("div", {
+					className: composer ? styles.cardSubtitle : styles.tCardSubtitle,
+					...comment ? {
+						title: comment,
+						"data-dsq-has-comment": "true"
+					} : {},
+					children: subtitle
+				})]
+			}),
+			composer && onEditComment ? (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: styles.cardAction,
+				"aria-label": t("card.editComment"),
+				onClick: onEditComment,
+				children: "✎"
+			}) : null,
+			composer && onRemove ? (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: styles.cardClose,
+				"aria-label": t("card.remove"),
+				onClick: onRemove,
+				children: "×"
+			}) : null
+		]
+	});
+}
 /** Grace period so pointer transit between the summary and the panel never closes it. */
 const CLOSE_DELAY = 320;
 /** After a viewport change, wait this long before position-checking the pointer. */
@@ -1720,7 +2022,8 @@ const SETTLE_DELAY = 600;
 * other cancels. Comment editing happens inline in the list — the panel stays
 * put and auto-close is suppressed while an edit is open.
 */
-function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemove, onItemEdit, hint = "悬停查看批注" }) {
+function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemove, onItemEdit }) {
+	useLocale();
 	const rootRef = (0, react.useRef)(null);
 	const popRef = (0, react.useRef)(null);
 	const closeTimerRef = (0, react.useRef)(null);
@@ -1876,7 +2179,7 @@ function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemo
 		ref: popRef,
 		className: `${styles.summaryHover} ${styles.summaryHoverOpen}`,
 		role: "dialog",
-		"aria-label": `${count} 条划词批注详情`,
+		"aria-label": t("summary.dialogAria", { count }),
 		onPointerEnter: openPop,
 		onPointerLeave,
 		children: (0, react_jsx_runtime.jsx)("div", {
@@ -1895,20 +2198,20 @@ function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemo
 							}),
 							(0, react_jsx_runtime.jsx)("div", {
 								className: styles.summaryItemLabel,
-								children: "选中的文本"
+								children: t("common.selectedText")
 							}),
 							!isEditing && (onItemRemove || onItemEdit) ? (0, react_jsx_runtime.jsxs)("div", {
 								className: styles.summaryItemActions,
 								children: [onItemEdit ? (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: styles.summaryItemAction,
-									"aria-label": `编辑批注 ${i + 1}`,
+									"aria-label": t("summary.edit", { index: i + 1 }),
 									onClick: () => startEdit(i),
 									children: (0, react_jsx_runtime.jsx)(LucideIcon, { name: "pencil" })
 								}) : null, onItemRemove ? (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: styles.summaryItemAction,
-									"aria-label": `移除批注 ${i + 1}`,
+									"aria-label": t("summary.remove", { index: i + 1 }),
 									onClick: () => onItemRemove(i, item),
 									children: (0, react_jsx_runtime.jsx)(LucideIcon, { name: "trash-2" })
 								}) : null]
@@ -1923,12 +2226,12 @@ function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemo
 							}),
 							(0, react_jsx_runtime.jsx)("div", {
 								className: styles.summaryItemLabel,
-								children: "用户评论"
+								children: t("summary.userComment")
 							}),
 							(0, react_jsx_runtime.jsx)("textarea", {
 								ref: editInputRef,
 								className: styles.annEditInput,
-								placeholder: "添加可选评论…",
+								placeholder: t("common.commentPlaceholder"),
 								value: editDraft,
 								onChange: (e) => setEditDraft(e.target.value),
 								onKeyDown: (e) => {
@@ -1949,12 +2252,12 @@ function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemo
 									type: "button",
 									className: styles.annEditCancel,
 									onClick: () => setEditing(null),
-									children: "取消"
+									children: t("common.cancel")
 								}), (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: styles.annEditSave,
 									onClick: commitEdit,
-									children: "保存"
+									children: t("common.save")
 								})]
 							})
 						]
@@ -1974,11 +2277,11 @@ function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemo
 								}),
 								(0, react_jsx_runtime.jsx)("div", {
 									className: styles.summaryItemLabel,
-									children: "用户评论"
+									children: t("summary.userComment")
 								}),
 								(0, react_jsx_runtime.jsx)("div", {
 									className: item.comment ? styles.summaryItemText : `${styles.summaryItemText} ${styles.summaryItemTextEmpty}`,
-									children: item.comment || "未添加评论"
+									children: item.comment || t("summary.noComment")
 								})
 							]
 						})
@@ -1992,7 +2295,7 @@ function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemo
 		className: styles.summary,
 		tabIndex: 0,
 		"data-selection-annotation-summary": "true",
-		"aria-label": `${count} 条划词批注。悬停查看详情。`,
+		"aria-label": t("summary.aria", { count }),
 		"aria-expanded": open,
 		onPointerEnter,
 		onPointerLeave,
@@ -2009,16 +2312,16 @@ function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemo
 				className: styles.summaryBody,
 				children: [(0, react_jsx_runtime.jsx)("div", {
 					className: styles.summaryTitle,
-					children: `${count} 条批注`
+					children: t("summary.title", { count })
 				}), (0, react_jsx_runtime.jsx)("div", {
 					className: styles.summaryHint,
-					children: hint
+					children: t("summary.hint")
 				})]
 			}),
 			onRemoveAll ? (0, react_jsx_runtime.jsx)("button", {
 				type: "button",
 				className: styles.cardClose,
-				"aria-label": "移除全部划词批注",
+				"aria-label": t("summary.removeAll"),
 				onClick: onRemoveAll,
 				children: (0, react_jsx_runtime.jsx)(LucideIcon, {
 					name: "x",
@@ -2310,7 +2613,10 @@ async function copyText(text) {
 }
 //#endregion
 //#region src/client/SelectionToolbar.tsx
+/** Cap for the auto-growing comment box; beyond this it scrolls internally. */
+const COMMENT_MAX_HEIGHT = 220;
 function SelectionToolbar({ sessionId }) {
+	useLocale();
 	const toolbarRef = (0, react.useRef)(null);
 	const commentWrapRef = (0, react.useRef)(null);
 	const commentRef = (0, react.useRef)(null);
@@ -2376,19 +2682,24 @@ function SelectionToolbar({ sessionId }) {
 			if (dragging) return;
 			schedule();
 		};
+		const onScroll = (event) => {
+			const target = event.target;
+			if (target instanceof Node && (toolbarRef.current?.contains(target) === true || commentWrapRef.current?.contains(target) === true)) return;
+			hide();
+		};
 		document.addEventListener("pointerdown", onPointerDown, true);
 		document.addEventListener("pointerup", onPointerUp, true);
 		document.addEventListener("keyup", schedule, true);
 		document.addEventListener("selectionchange", onSelectionChange);
 		window.addEventListener("resize", hide);
-		document.addEventListener("scroll", hide, true);
+		document.addEventListener("scroll", onScroll, true);
 		return () => {
 			document.removeEventListener("pointerdown", onPointerDown, true);
 			document.removeEventListener("pointerup", onPointerUp, true);
 			document.removeEventListener("keyup", schedule, true);
 			document.removeEventListener("selectionchange", onSelectionChange);
 			window.removeEventListener("resize", hide);
-			document.removeEventListener("scroll", hide, true);
+			document.removeEventListener("scroll", onScroll, true);
 		};
 	}, [hide, refresh]);
 	const placeCommentPop = (0, react.useCallback)(() => {
@@ -2415,6 +2726,18 @@ function SelectionToolbar({ sessionId }) {
 			commentRef.current?.focus();
 		}
 	}, [phase, placeCommentPop]);
+	(0, react.useEffect)(() => {
+		if (phase !== "comment") return;
+		const area = commentRef.current;
+		if (!area) return;
+		area.style.height = "auto";
+		area.style.height = `${Math.min(area.scrollHeight, COMMENT_MAX_HEIGHT)}px`;
+		placeCommentPop();
+	}, [
+		phase,
+		comment,
+		placeCommentPop
+	]);
 	const handleToolbarPointerDown = (0, react.useCallback)((event) => {
 		event.preventDefault();
 		event.stopPropagation();
@@ -2427,7 +2750,7 @@ function SelectionToolbar({ sessionId }) {
 			clearNativeSelection();
 			hide();
 		} catch {
-			setStatus("复制失败");
+			setStatus(t("toolbar.copyFailed"));
 		}
 	}, [hide]);
 	const openComment = (0, react.useCallback)(() => {
@@ -2436,7 +2759,7 @@ function SelectionToolbar({ sessionId }) {
 		setComment("");
 		setStatus(null);
 	}, []);
-	/** Quick-add without opening the comment step (double-tap / “暂不评论”). */
+	/** Quick-add without opening the comment step (double-tap / “Skip comment”). */
 	const commitAnnotation = (0, react.useCallback)((body) => {
 		const snapshot = activeRef.current;
 		if (!snapshot) {
@@ -2471,7 +2794,7 @@ function SelectionToolbar({ sessionId }) {
 			className: styles.toolbar,
 			style: toolbarStyle,
 			role: "toolbar",
-			"aria-label": "划词操作",
+			"aria-label": t("toolbar.aria"),
 			"data-dsq-toolbar": "true",
 			onPointerDown: handleToolbarPointerDown,
 			children: phase === "comment" ? (0, react_jsx_runtime.jsx)("div", {
@@ -2486,7 +2809,7 @@ function SelectionToolbar({ sessionId }) {
 						fontSize: 13,
 						opacity: .8
 					},
-					children: "添加批注…"
+					children: t("toolbar.commentHint")
 				})
 			}) : (0, react_jsx_runtime.jsxs)("div", {
 				style: {
@@ -2502,7 +2825,7 @@ function SelectionToolbar({ sessionId }) {
 						children: [(0, react_jsx_runtime.jsx)(LucideIcon, {
 							name: "copy",
 							size: 14
-						}), "复制"]
+						}), t("toolbar.copy")]
 					}),
 					(0, react_jsx_runtime.jsx)("span", {
 						className: styles.divider,
@@ -2515,7 +2838,7 @@ function SelectionToolbar({ sessionId }) {
 						children: [(0, react_jsx_runtime.jsx)(LucideIcon, {
 							name: "plus",
 							size: 14
-						}), "添加到任务"]
+						}), t("toolbar.addToTask")]
 					})
 				]
 			})
@@ -2525,12 +2848,12 @@ function SelectionToolbar({ sessionId }) {
 			className: styles.commentPop,
 			style: void 0,
 			role: "dialog",
-			"aria-label": "添加可选评论",
+			"aria-label": t("toolbar.commentDialogAria"),
 			onPointerDown: handleToolbarPointerDown,
 			children: [(0, react_jsx_runtime.jsx)("textarea", {
 				ref: commentRef,
 				className: styles.commentInput,
-				placeholder: "添加可选评论…",
+				placeholder: t("common.commentPlaceholder"),
 				value: comment,
 				onChange: (e) => setComment(e.target.value),
 				onKeyDown: (e) => {
@@ -2550,13 +2873,13 @@ function SelectionToolbar({ sessionId }) {
 					type: "button",
 					className: styles.button,
 					onClick: () => commitAnnotation(void 0),
-					children: "暂不评论"
+					children: t("toolbar.skipComment")
 				}), (0, react_jsx_runtime.jsx)("button", {
 					type: "button",
 					className: styles.button,
 					disabled: !comment.trim(),
 					onClick: () => commitAnnotation(comment),
-					children: "添加评论"
+					children: t("toolbar.addComment")
 				})]
 			})]
 		}) : null,
@@ -2581,11 +2904,14 @@ function decorateTextNode(node) {
 	const parent = node.parentElement;
 	if (!parent || parent.closest(`[data-${DECO}]`)) return;
 	if (parent.closest("pre, code, [data-dsq-toolbar]")) return;
+	if (parent.closest("textarea, input, [data-lexical-editor=\"true\"]")) return;
 	const frag = document.createDocumentFragment();
 	let last = 0;
+	let matched = false;
 	const re = new RegExp(ANNOTATION_DIRECTIVE_RE.source, "g");
 	let m;
 	while ((m = re.exec(value)) !== null) {
+		matched = true;
 		if (m.index > last) frag.append(document.createTextNode(value.slice(last, m.index)));
 		const index = Number(m[1]);
 		const chip = document.createElement("button");
@@ -2593,7 +2919,7 @@ function decorateTextNode(node) {
 		chip.className = "dsq_annDirective";
 		chip.dataset[DECO] = String(index);
 		chip.setAttribute("data-dsq-deco", "true");
-		chip.textContent = `批注 ${index}`;
+		chip.textContent = t("chip.annotation", { index });
 		chip.addEventListener("click", () => {
 			const mark = findAnnotationMarkBefore(index, chip);
 			if (mark) flashAnnotationMark(mark);
@@ -2601,6 +2927,7 @@ function decorateTextNode(node) {
 		frag.append(chip);
 		last = m.index + m[0].length;
 	}
+	if (!matched) return;
 	if (last < value.length) frag.append(document.createTextNode(value.slice(last)));
 	parent.replaceChild(frag, node);
 }
@@ -2617,6 +2944,22 @@ function decorateAnnotationDirectives(root) {
 	}
 	for (const node of hits) decorateTextNode(node);
 }
+/**
+* Re-label chips that are already on screen after the language changed.
+*
+* Chip text is plain DOM, not React state, so a switch would otherwise leave
+* old-language chips next to new-language popovers. Writing `textContent` here
+* is safe for the observer: the new text node never contains the directive
+* literal, so `decorateTextNode()` returns before it can touch the DOM.
+*/
+function refreshDirectiveChips(root) {
+	const el = root ?? (typeof document === "undefined" ? void 0 : document.body);
+	if (!el) return;
+	for (const chip of el.querySelectorAll(`[data-${DECO}]`)) {
+		const index = Number(chip.dataset[DECO]);
+		if (Number.isFinite(index)) chip.textContent = t("chip.annotation", { index });
+	}
+}
 /** Observe chat DOM and decorate new directive text. Returns disposer. */
 function watchAnnotationDirectives(root) {
 	const el = root ?? (typeof document === "undefined" ? void 0 : document.body);
@@ -2635,7 +2978,16 @@ function watchAnnotationDirectives(root) {
 }
 //#endregion
 //#region src/client/transcript/TranscriptQuoteCard.tsx
-/** History-side annotation summary — same chrome as the composer. */
+/**
+* History-side cards for one user message's annotations.
+*
+* One card per annotation, each showing the selected text **and** the user's
+* comment. The comment is how the user recognizes their own annotation, so it
+* belongs on the visible card — not behind a hover panel that has to be
+* discovered. Clicking a card scrolls back to the marked text in the source
+* message; the ordinal badge matches the `:dsh-annotation{index="N"}` the model
+* refers to.
+*/
 function TranscriptQuoteCard({ node }) {
 	ensureToolbarStyles();
 	const stackRef = (0, react.useRef)(null);
@@ -2652,28 +3004,37 @@ function TranscriptQuoteCard({ node }) {
 			endOffset: quote.endOffset
 		})));
 	}, [quotes]);
-	const onItemSelect = (0, react.useCallback)((index, item) => {
-		scrollToAnnotation(index + 1, item.text, item.id);
-	}, []);
 	const markIdOf = (0, react.useCallback)((index) => {
 		const ownerKey = stackRef.current?.closest("[data-chat-flow-key]")?.getAttribute("data-chat-flow-key");
 		return ownerKey ? `dqsm_${ownerKey}_${index}` : void 0;
 	}, []);
+	const onSelect = (0, react.useCallback)((index, text) => {
+		scrollToAnnotation(index + 1, text, markIdOf(index));
+	}, [markIdOf]);
 	if (quotes.length === 0) return null;
 	return (0, react_jsx_runtime.jsx)("div", {
 		ref: stackRef,
 		className: styles.tCardStack,
 		"data-dsq-deco": "true",
-		children: (0, react_jsx_runtime.jsx)(AnnotationSummary, {
-			count: quotes.length,
-			items: quotes.map((quote, index) => ({
-				id: markIdOf(index),
+		children: quotes.map((quote, index) => (0, react_jsx_runtime.jsx)("div", {
+			className: styles.tCardButton,
+			role: "button",
+			tabIndex: 0,
+			"aria-label": quote.title,
+			onClick: () => onSelect(index, quote.text),
+			onKeyDown: (event) => {
+				if (event.key !== "Enter" && event.key !== " ") return;
+				event.preventDefault();
+				onSelect(index, quote.text);
+			},
+			children: (0, react_jsx_runtime.jsx)(AnnotationCardView, {
+				variant: "transcript",
 				title: quote.title,
 				text: quote.text,
-				comment: quote.comment || void 0
-			})),
-			onItemSelect
-		})
+				comment: quote.comment || void 0,
+				index: index + 1
+			})
+		}, `ann-${index}`))
 	});
 }
 //#endregion
@@ -2691,101 +3052,89 @@ function contentImages(content) {
 }
 /**
 * Replacement for the built-in `user` Chat node view.
-* Strips the `<response-annotations>` protocol block from the bubble.
+*
+* Strips the `<response-annotations>` protocol block from the bubble **and**
+* renders one card per annotation right under it.
+*
+* Why the cards live here instead of on a `select-quote` Chat node:
+* `conversation.chat.node` is gated by the shipped `TURN_PROCESS_INDEPENDENT_KINDS`
+* allowlist (system-prompt, user, steering, turn-trigger, turn-process,
+* turn-error, turn-max-tokens, turn-tail). A node whose kind is not on that list
+* is classified as a turn-process member and `hidden` inside the collapsed
+* process disclosure of a completed turn — mounted, then invisible. `user` is on
+* the list, so rendering the cards inside this component is the only placement
+* that survives turn folding.
 */
 function UserMessageDisplay({ node, renderMessageImages }) {
 	ensureToolbarStyles();
 	const raw = contentBlocksToText(node.data?.content);
 	const scanned = scanAnnotatedMessage(raw);
 	const text = scanned.annotations.length > 0 ? scanned.rest : displayTextWithoutQuote(raw).trim();
+	const quotes = scanned.annotations;
 	const images = contentImages(node.data?.content);
-	if (!text && images.length === 0) return null;
+	if (!text && images.length === 0 && quotes.length === 0) return null;
 	return (0, react_jsx_runtime.jsx)("div", {
 		className: styles.userRow,
 		children: (0, react_jsx_runtime.jsxs)("div", {
 			className: styles.userStack,
-			children: [images.length > 0 && renderMessageImages !== void 0 ? (0, react_jsx_runtime.jsx)("div", {
-				className: styles.userImages,
-				"data-message-attachments": true,
-				children: renderMessageImages({
-					images,
-					align: "end",
-					compact: images.length > 1
-				})
-			}, "images") : null, text ? (0, react_jsx_runtime.jsx)("div", {
-				className: styles.userBubble,
-				children: text
-			}, "bubble") : null]
+			children: [
+				images.length > 0 && renderMessageImages !== void 0 ? (0, react_jsx_runtime.jsx)("div", {
+					className: styles.userImages,
+					"data-message-attachments": true,
+					children: renderMessageImages({
+						images,
+						align: "end",
+						compact: images.length > 1
+					})
+				}, "images") : null,
+				text ? (0, react_jsx_runtime.jsx)("div", {
+					className: styles.userBubble,
+					children: text
+				}, "bubble") : null,
+				quotes.length > 0 ? (0, react_jsx_runtime.jsx)(TranscriptQuoteCard, { node: { data: { quotes } } }, "quotes") : null
+			]
 		})
 	});
 }
 //#endregion
-//#region src/client/transcript/transcript-node.ts
-const KIND = "select-quote";
-function createSelectQuoteDefinition() {
-	return {
-		kind: KIND,
-		target: "chat",
-		match(event) {
-			if (event.type !== "user/message") return null;
-			if (parseAnnotatedMessage(extractUserText(event)).length === 0) return null;
-			return {
-				id: `${KIND}-${event.seq ?? 0}`,
-				role: "start"
-			};
-		},
-		start(_context, match) {
-			const quotes = parseAnnotatedMessage(extractUserText(match.event));
-			if (quotes.length === 0) throw new Error("select-quote: missing annotation payload on start");
-			return {
-				quotes,
-				seq: match.event.seq ?? 0
-			};
-		},
-		update(context) {
-			return context.state;
-		},
-		buildViewNode(context) {
-			if (context.state === void 0) return null;
-			const anchor = context.start?.event.seq ?? context.matches?.[0]?.event.seq ?? context.state.seq ?? 0;
-			const location = context.start?.location ?? context.matches?.[0]?.location ?? { kind: "unresolved" };
-			return {
-				key: context.key,
-				kind: KIND,
-				id: context.id,
-				target: "chat",
-				anchorSeq: anchor,
-				location,
-				visibility: "visible",
-				data: context.state
-			};
-		}
-	};
-}
-function registerSelectQuoteNode(ctx) {
-	const uiConversation = ctx.uiConversation;
-	if (!uiConversation) {
-		console.warn("[dsh-select-quote] uiConversation unavailable; transcript card disabled");
-		return;
-	}
-	ctx.effect(() => uiConversation.events.register(createSelectQuoteDefinition()), "dsh-select-quote: conversation node definition");
-}
-//#endregion
 //#region src/client/index.tsx
 /**
 * Browser half of dsh-select-quote.
 *
 * Selection toolbar is root-scoped (`shell.overlay`) so transcript selections
 * are always observed. Annotation summary stays on the session composer.
+*
+* History cards render **inside** the `user` Chat node view, not on a
+* `select-quote` Chat node. `conversation.chat.node` is gated by the shipped
+* `TURN_PROCESS_INDEPENDENT_KINDS` allowlist (system-prompt, user, steering,
+* turn-trigger, turn-process, turn-error, turn-max-tokens, turn-tail): any other
+* kind is classified as a turn-process member and `hidden` when the completed
+* turn's process disclosure is folded — mounted, but invisible. `user` is on
+* that allowlist, so the bubble is the only placement that is reliably visible.
+*
+* Language is the host's decision, never this plugin's: dictionaries go to
+* `ctx.locale`, and `t()` resolves against whatever language the user picked in
+* Settings. Self-detecting from `navigator` would disagree with the host on the
+* desktop shell, where Electron pins the document language (`--lang`) to its own
+* value while the host preference comes through `__DSH_LOCALE__`.
 */
 const inject = [
 	"slots",
 	"sessions",
-	"uiConversation"
+	"locale"
 ];
 function apply(ctx) {
 	ensureToolbarStyles();
-	registerSelectQuoteNode(ctx);
+	ctx.effect(() => ctx.locale.addLanguage(LANGUAGE_RU), "dsh-select-quote: ru language");
+	ctx.effect(() => ctx.locale.register(LOCALE_NS, SHIPPED_DICTS), "dsh-select-quote: dictionaries (zh, en)");
+	ctx.effect(() => ctx.locale.register(LOCALE_NS, LANGUAGE_RU.id, DICTIONARIES.ru), "dsh-select-quote: dictionary (ru)");
+	bindLocale({
+		translate: ctx.locale.bind(LOCALE_NS),
+		getActive: () => ctx.locale.getLocale().active,
+		getRevision: () => ctx.locale.getSnapshot().revision,
+		subscribe: (listener) => ctx.locale.subscribe(listener)
+	});
+	ctx.effect(() => subscribeLocale(() => refreshDirectiveChips()), "dsh-select-quote: chip language");
 	ctx.effect(() => watchAnnotationDirectives(), "dsh-select-quote: annotation directives");
 	ctx.effect(() => watchAnnotationMarks(), "dsh-select-quote: annotation marks");
 	ctx.effect(() => {
@@ -2814,10 +3163,6 @@ function apply(ctx) {
 		}, SessionBridge);
 	});
 	ctx.slots.inject("conversation.chat.node", () => {
-		ctx.slots.register({
-			name: "conversation.chat.node",
-			key: "select-quote"
-		}, TranscriptQuoteCard);
 		ctx.slots.register({
 			name: "conversation.chat.node",
 			key: "user",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-select-quote",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "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",
@@ -39,7 +39,8 @@
     "watch": "node scripts/build.mjs --watch",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "verify": "node scripts/verify-bundle.mjs",
-    "check": "npm run typecheck && npm run build && npm run verify"
+    "check": "npm run typecheck && npm run build && npm run verify",
+    "release": "npm run check && commit-and-tag-version"
   },
   "dsh": {
     "client": {
@@ -66,8 +67,10 @@
   "devDependencies": {
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3",
+    "commit-and-tag-version": "^13.2.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
+    "tsdown": "0.23.0",
     "typescript": "^5.8.0"
   }
 }