dsh-select-quote 0.3.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,88 +15,85 @@
 
 ---
 
-## 兼容性
-
-| 项 | 值 |
-|---|---|
-| dsh | `0.1.7-rc.1`（2026-09-24 实测：划词、批注卡片、正文标记、对话记录渲染全通） |
-| profile | web（`dsh web`）与桌面端（desktop）都可用；桌面端在 0.2.0 及更早版本会楔死渲染进程，本仓库已修复，详见下节 |
-| 运行时 | 只有浏览器半有业务；Node 半仅用于让包被 Loader 挂载 |
-
-实现依赖若干产品内部约定（槽位名、composer DOM、深色主题属性等），升级 dsh 后请先跑 `npm run check`，再照 [`docs/internals.md`](docs/internals.md) 末尾的复核清单人工回归一遍。
-
-### 桌面端（desktop profile）
-
-桌面端是 Electron 外壳 + 同一个 Web 客户端，插件声明的 `dsh.client.platform: "web"` 在桌面端同样加载，槽位与 DOM 契约都在，功能本身可用（实测批注随消息送达模型、模型回指渲染为 chip 均正常）。
-
-> ⚠️ **0.2.0 及更早版本在桌面端会楔死渲染进程**，见 [#1](https://github.com/latte03/dsh-select-quote/issues/1)：App 能启动、界面完整渲染，但整个输入区无法点击，renderer 子进程单核 100% 持续旋转。根因在插件自己的装饰器里——协议头部逐字写出了 `:dsh-annotation{index="N"}`，当文本含有这个字面量而严格正则一条都没匹配上时，装饰器仍然替换了一次内容完全相同的 Text 节点，于是被自己的 `MutationObserver` 反复触发，微任务队列永远排不空，宏任务和定时器再也得不到执行。触发条件是文本内容，与 Electron 或 `dsh-app://` 无关，桌面端只是恰好把那段文本送进了 Text 节点。完整机制与两道防线记录在 [`docs/internals.md`](docs/internals.md) 关键机制 8。
-
-> **现在的状态**：修复已进主干，Windows 桌面端 0.2.0-rc.2 实测重新启用插件后批注正常送达、Turn 正常结束、输入框可点击、没有新的崩溃日志。npm 上可安装的仍是 `0.2.0`，也就是带缺陷的那一版，因此桌面端用户在修复版发布之前请在 `dsh.profile.bundles` 中摘除本插件，或改用浏览器访问同一个端口。[#1](https://github.com/latte03/dsh-select-quote/issues/1) 保持 open，等报告人复验后关闭。
-
 ## 安装
 
-### 方式一：从 npm 安装（bundle）
+网页版：
 
 ```bash
 dsh plugin --profile web add dsh-select-quote
 dsh --profile web
 ```
 
-> npm 上目前最新是 `0.2.0`（2026-09-24 发布）：带批注卡片、正文标记与模型回指，但界面只有简体中文，桌面端还会楔死渲染进程（见兼容性一节）。本仓库的 `0.3.0` 修掉了楔死、加了简体中文 / English / Русский 三语，并把对话记录里的批注卡片改到用户气泡内，**还没发布到 npm**。要用 `0.3.0` 的行为，先按方式二从本地 checkout 加载；发布完成后这一节需要更新。仓库里另有 `0.1.0`，那是旧版「引用块」，不要装错。
+桌面版：在应用内输入`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
 
-## 语言 / Localization
+## 语言
 
-界面文案支持 **简体中文 / English / Русский**，默认跟随浏览器语言：
+界面语言由 dsh 决定，插件不再自己判断浏览器语言。在 **设置 → 通用 → 语言** 里切换。
 
-| 语言 | 默认值 |
-|---|---|
-| `zh` | 原文案，同时作为缺失键的兜底词典 |
-| `en` | 非中文环境 |
-| `ru` | `ru` / `ru-RU` 等标签 |
 
-想固定语言，在 Web GUI 控制台里设置后刷新页面：
+## 已知限制
 
-```js
-localStorage.setItem('dsq-locale', 'ru') // 'ru' | 'en' | 'zh'
-localStorage.removeItem('dsq-locale')    // 恢复跟随浏览器
-```
+- **待发批注只在内存里**：刷新页面或切换会话后会丢，卡片不持久化；已发送消息里的批注不受影响。
+- **占用了用户气泡的渲染**：本插件以最低优先级替换内置 `user` 节点。其它插件若替换同一个键（例如 `dsh-easyrewrite` 用 `-1`），会被本插件屏蔽。
+- **卡片宽度有限**：输入框内每条摘要最宽约为输入框的 1/4，超长标题走省略号。
+- **划词只在对话区生效**：不介入编辑器、终端等面板。
 
-**刻意不翻译的部分**：`> [选中文本]`、`<response-annotations>`、`:dsh-annotation{index="N"}` 这些是模型与解析器约定的传输格式；`# Response annotations:` 那段是给模型的指令正文，不是界面文案。只有面向人的 chrome 走 `t()`。
+## 常见问题
 
-新增文案：在 `src/client/i18n.ts` 的三份词典里各加一条，再在组件里 `t('key', { ... })` 调用。带 `{count}` 的键可以写成复数形式对象（中文用 `other`，俄语用 `one` / `few` / `many`）。
+**升级 dsh 之后功能不对？** 先 `npm run check`；产物没问题就对照 [`docs/internals.md`](docs/internals.md) 的「依赖的产品内部约定」逐条复核，那里列了所有产品内部名。
 
-## 已知限制
+**划词没有工具条？** 确认选区在对话区而不是编辑器里；刷新页面（样式与观察者是幂等注入的）；宿主 boot 日志里应出现 `dsh-select-quote`。
 
-- **待发批注只在内存里**：刷新页面或切换会话后会丢，卡片不持久化（已发送消息里的批注不受影响）。
-- **占用了用户气泡的渲染**：本插件以最低优先级替换内置 `user` 节点。若其它插件也替换同一个键（例如 `dsh-easyrewrite` 用 `-1`），会被本插件屏蔽。
-- **卡片宽度有限**：输入框内每条摘要最宽约为输入框的 1/4，超长标题走省略号。
-- 划词只在对话区生效，不介入编辑器、终端等面板。
+**输入框里出现了协议原文？** 发送前的注入没生效，一般是 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     # 增量重建
 ```
 
-改 CSS 后要刷新页面（样式只注入一次）。协议格式、槽位注册、以及几处非显而易见的坑（U+200B 草稿标记、portal 到 body 的浮层、`--dsq-quote-pad` 高度补偿）记录在 **[docs/internals.md](docs/internals.md)**。
+`npm run verify` 无头执行产物，断言 8 项贡献都注册上，并检查三份词典的键与 `{placeholder}` 在每种语言里都齐备（复数消息必须有 `.other` 兜底）。
+
+发布：先把源码与产物 `lib/` 一起提交，再跑
+
+```bash
+npm run release   # check → 追加 CHANGELOG.md → 提升版本号并打 tag
+```
+
+## 贡献
+
+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

@@ -1765,175 +1765,204 @@ function LucideIcon({ name, size = 15 }) {
 }
 //#endregion
 //#region src/client/i18n.ts
-const LOCALES = [
-	"ru",
-	"en",
-	"zh"
-];
-const STORAGE_KEY = "dsq-locale";
-const MESSAGES = {
-	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} аннотация. Наведите, чтобы увидеть детали.",
-			few: "{count} аннотации. Наведите, чтобы увидеть детали.",
-			many: "{count} аннотаций. Наведите, чтобы увидеть детали."
-		},
-		"summary.title": {
-			one: "{count} аннотация",
-			few: "{count} аннотации",
-			many: "{count} аннотаций"
-		},
-		"summary.removeAll": "Удалить все аннотации",
-		"chip.annotation": "Аннотация {index}"
-	},
-	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.",
-			other: "{count} annotations. Hover to view details."
-		},
-		"summary.title": {
-			one: "{count} annotation",
-			other: "{count} annotations"
-		},
-		"summary.removeAll": "Remove all annotations",
-		"chip.annotation": "Annotation {index}"
-	},
-	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}"
-	}
+/**
+* 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}"
 };
-let cached = null;
-function matchLocale(tag) {
-	const lower = tag.toLowerCase();
-	for (const locale of LOCALES) if (lower === locale || lower.startsWith(`${locale}-`) || lower.startsWith(`${locale}_`)) return locale;
-	return null;
-}
-function localStore() {
-	return globalThis.localStorage;
-}
-function readOverride() {
-	try {
-		const raw = localStore()?.getItem(STORAGE_KEY);
-		return raw ? matchLocale(raw) : null;
-	} catch {
-		return null;
-	}
-}
-function detectLocale() {
-	const override = readOverride();
-	if (override) return override;
-	const nav = globalThis.navigator;
-	const tags = nav ? [...nav.languages ?? [], nav.language].filter(Boolean) : [];
-	for (const tag of tags) {
-		const hit = matchLocale(tag);
-		if (hit) return hit;
-	}
-	return "en";
+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 locale (resolved once, then cached). */
-function getLocale() {
-	cached ??= detectLocale();
-	return cached;
+/** Active language id, or `en` before the host service is bound. */
+function activeLocale() {
+	return api?.getActive() ?? "en";
 }
-function pluralize(forms, locale, count) {
+function pluralForm(count) {
+	const locale = activeLocale();
 	if (locale === "ru") {
 		const mod10 = count % 10;
 		const mod100 = count % 100;
-		if (mod10 === 1 && mod100 !== 11) return forms.one ?? forms.other ?? "";
-		if (mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)) return forms.few ?? forms.other ?? "";
-		return forms.many ?? forms.other ?? "";
+		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 ? forms.one : void 0) ?? forms.other ?? "";
-	return forms.other ?? forms.many ?? "";
-}
-function interpolate(template, params) {
-	return template.replace(/\{(\w+)\}/g, (whole, name) => name in params ? String(params[name]) : whole);
+	if (locale === "en") return count === 1 ? "one" : "other";
+	return "other";
 }
 /**
-* Translate a key for the active locale.
-* `{name}` placeholders are filled from `params`; a numeric `count` also
-* selects the right plural form when the message is a `PluralForms` object.
+* 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 = {}) {
-	const locale = getLocale();
-	const value = MESSAGES[locale][key] ?? MESSAGES.zh[key] ?? key;
-	return interpolate(typeof value === "string" ? value : pluralize(value, locale, typeof params.count === "number" ? params.count : 0), 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", {
@@ -1993,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 = t("summary.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);
@@ -2285,7 +2315,7 @@ function AnnotationSummary({ count, items, onRemoveAll, onItemSelect, onItemRemo
 					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", {
@@ -2586,6 +2616,7 @@ async function copyText(text) {
 /** 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);
@@ -2913,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);
@@ -3064,10 +3111,30 @@ function UserMessageDisplay({ node, renderMessageImages }) {
 * 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"];
+const inject = [
+	"slots",
+	"sessions",
+	"locale"
+];
 function apply(ctx) {
 	ensureToolbarStyles();
+	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(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-select-quote",
-  "version": "0.3.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,6 +67,7 @@
   "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",