dsh-quote-followup 0.2.3 → 0.2.4

package/README.md

@@ -2,8 +2,17 @@
 
 English | [中文](README.zh.md)
 
+[![npm version](https://img.shields.io/npm/v/dsh-quote-followup.svg)](https://www.npmjs.com/package/dsh-quote-followup)
+[![license](https://img.shields.io/npm/l/dsh-quote-followup.svg)](LICENSE)
+
 A Web-only [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin for quoting selected conversation text into the composer and asking a focused follow-up.
 
+<p align="center">
+  <img src="docs/assets/quote-followup-demo.gif" width="960" alt="Select conversation excerpts, insert native DSH quote chips, and write a focused follow-up">
+</p>
+
+<p align="center"><strong>Select. Quote. Follow up.</strong></p>
+
 ## Features
 
 - Select text inside the Web conversation transcript to reveal a floating **Quote** button.
@@ -16,6 +25,8 @@ TUI is intentionally unsupported.
 
 ## Install
 
+Requires DSH `>=0.1.2-rc.1`.
+
 ```bash
 dsh plugin --profile web add dsh-quote-followup
 ```

package/README.zh.md

@@ -2,8 +2,17 @@
 
 [English](README.md) | 中文
 
+[![npm version](https://img.shields.io/npm/v/dsh-quote-followup.svg)](https://www.npmjs.com/package/dsh-quote-followup)
+[![license](https://img.shields.io/npm/l/dsh-quote-followup.svg)](LICENSE)
+
 一个仅支持 Web 的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件：选中对话文本，将其追加到输入框，再进行针对性追问。
 
+<p align="center">
+  <img src="docs/assets/quote-followup-demo.gif" width="960" alt="划选对话片段，插入 DSH 原生引用 chip，再输入针对性追问">
+</p>
+
+<p align="center"><strong>划选、引用、继续追问。</strong></p>
+
 ## 功能
 
 - 在 Web 对话区选中文本后显示浮动的 **❐ 引用** 按钮。
@@ -16,6 +25,8 @@
 
 ## 安装
 
+要求 DSH `>=0.1.2-rc.1`。
+
 ```bash
 dsh plugin --profile web add dsh-quote-followup
 ```

package/lib/client.js

@@ -33,9 +33,28 @@ window.__ModuleLoader__.load({
 		];
 		const BUTTON_ID = "dsh-quote-followup-btn";
 		const BUTTON_VERSION_ATTR = "data-dsh-quote-followup-version";
-		const CLIENT_VERSION = "0.2.3";
+		const CLIENT_VERSION = "0.2.4";
 		/** Codec owner for native DSH reference chips. */
 		const QUOTE_SOURCE = "quote-followup";
+		const LOCALE_NS = "quote-followup";
+		/** UI + serialized frame copy; the active DSH locale picks the language. */
+		const LOCALE_DICT = {
+			zh: {
+				"button.label": "❐ 引用",
+				"button.title": "引用选中内容到输入框（可多次引用，发送前可编辑）",
+				"quote.header": "引用",
+				"conversation.role": "对话",
+				"quote.truncated": "，已截断"
+			},
+			en: {
+				"button.label": "❐ Quote",
+				"button.title": "Quote the selection into the composer (repeatable; editable before sending)",
+				"quote.header": "Quote",
+				"conversation.role": "conversation",
+				"quote.truncated": ", truncated"
+			}
+		};
+		const fallbackT = (key) => LOCALE_DICT.en[key] ?? key;
 		/** Per-quote character cap for a bounded composer insertion. */
 		const QUOTE_MAX_CHARS = 1600;
 		//#endregion
@@ -75,7 +94,7 @@ window.__ModuleLoader__.load({
 			}
 			return null;
 		};
-		const roleLabel = (role) => role === "user" ? "user" : role === "assistant" ? "assistant" : "对话";
+		const roleLabel = (role, t) => role === "user" ? "user" : role === "assistant" ? "assistant" : t("conversation.role");
 		/** Bound one quote before it becomes editor state. */
 		const quotePayload = (text, role) => {
 			let body = String(text ?? "");
@@ -87,9 +106,9 @@ window.__ModuleLoader__.load({
 			return { text: body, role, truncated };
 		};
 		/** Model / clipboard projection. The composer shows a chip, not this frame. */
-		const quoteFrame = ({ text, role, truncated }) => {
+		const quoteFrame = ({ text, role, truncated }, t) => {
 			const lines = text.split("\n").map((line) => `> ${line}`.trimEnd());
-			return `> [引用 · ${roleLabel(role)}${truncated ? "，已截断" : ""}]\n${lines.join("\n")}\n\n`;
+			return `> [${t("quote.header")} · ${roleLabel(role, t)}${truncated ? t("quote.truncated") : ""}]\n${lines.join("\n")}\n\n`;
 		};
 		const decodeQuote = (ref) => {
 			const value = JSON.parse(ref);
@@ -101,29 +120,31 @@ window.__ModuleLoader__.load({
 				truncated: value.truncated === true
 			};
 		};
-		const quoteInsert = (payload) => {
-			const clipboardText = quoteFrame(payload);
+		const quoteInsert = (payload, t) => {
+			const clipboardText = quoteFrame(payload, t);
 			const preview = payload.text.replace(/\s+/g, " ").trim();
 			return {
 				source: QUOTE_SOURCE,
 				ref: JSON.stringify(payload),
-				label: `引用 · ${roleLabel(payload.role)}: ${preview}${payload.truncated ? "…" : ""}`,
+				// The bubble icon carries the quote meaning; keep only the excerpt
+				// visible. Role/truncation stay in the serialized Markdown frame.
+				label: preview,
 				appearance: "session",
 				clipboardText
 			};
 		};
 		/** Codec-only source: it owns quote chips but intentionally adds no @ candidates. */
-		const QUOTE_TRIGGER_SOURCE = {
+		const makeQuoteSource = (t) => ({
 			trigger: "@",
 			name: QUOTE_SOURCE,
 			order: 1000,
 			candidates: () => Promise.resolve([]),
 			onPick: () => void 0,
 			codec: {
-				clipboardText: (ref) => quoteFrame(decodeQuote(ref)),
-				serialize: (ref) => Promise.resolve(quoteFrame(decodeQuote(ref)))
+				clipboardText: (ref) => quoteFrame(decodeQuote(ref), t),
+				serialize: (ref) => Promise.resolve(quoteFrame(decodeQuote(ref), t))
 			}
-		};
+		});
 		const findComposer = () => {
 			for (const selector of COMPOSER_SELECTORS) {
 				const element = document.querySelector(selector);
@@ -138,7 +159,7 @@ window.__ModuleLoader__.load({
 		 * The node class is already registered on the live composer; no second
 		 * Lexical or React runtime is loaded by this plugin.
 		 */
-		const appendQuoteChip = (element, payload) => {
+		const appendQuoteChip = (element, payload, t) => {
 			const editor = element.__lexicalEditor;
 			const registry = editor?._nodes;
 			const ChipNode = registry?.get?.("reference-chip")?.klass;
@@ -162,7 +183,7 @@ window.__ModuleLoader__.load({
 					const tail = typeof block.getTextContent === "function" ? block.getTextContent().slice(-1) : "";
 					if (tail !== "" && !/\s/u.test(tail))
 						nodes.push(new TextNode(" "));
-					nodes.push(new ChipNode(quoteInsert(payload)));
+					nodes.push(new ChipNode(quoteInsert(payload, t)));
 					const trailing = new TextNode(" ");
 					nodes.push(trailing);
 					block.append(...nodes);
@@ -284,6 +305,7 @@ window.__ModuleLoader__.load({
 		//#region floating button
 		let pendingQuote = null;
 		let quoteSourceReady = false;
+		let currentT = fallbackT;
 		const ensureButton = () => {
 			const existing = document.getElementById(BUTTON_ID);
 			if (existing?.getAttribute(BUTTON_VERSION_ATTR) === CLIENT_VERSION)
@@ -293,8 +315,8 @@ window.__ModuleLoader__.load({
 			button.id = BUTTON_ID;
 			button.setAttribute(BUTTON_VERSION_ATTR, CLIENT_VERSION);
 			button.type = "button";
-			button.textContent = "❐ 引用";
-			button.title = "引用选中内容到输入框（可多次引用，发送前可编辑）";
+			button.textContent = currentT("button.label");
+			button.title = currentT("button.title");
 			Object.assign(button.style, {
 				position: "fixed",
 				zIndex: "2147483600",
@@ -374,8 +396,8 @@ window.__ModuleLoader__.load({
 			// insertion destroys Lexical's caret and makes the next quote unreliable.
 			document.getSelection()?.removeAllRanges();
 			const payload = quotePayload(quote.text, quote.role);
-			if (!(quoteSourceReady && appendQuoteChip(composer, payload)))
-				appendToComposer(composer, quoteFrame(payload));
+			if (!(quoteSourceReady && appendQuoteChip(composer, payload, currentT)))
+				appendToComposer(composer, quoteFrame(payload, currentT));
 		};
 		//#endregion
 		//#region apply
@@ -387,10 +409,34 @@ window.__ModuleLoader__.load({
 			if (typeof previous?.dispose === "function")
 				previous.dispose();
 			let unregisterSource = null;
+			let unregisterLocale = null;
+			let unsubscribeLocale = null;
+			const refreshButtonCopy = () => {
+				const button = document.getElementById(BUTTON_ID);
+				if (button !== null) {
+					button.textContent = currentT("button.label");
+					button.title = currentT("button.title");
+				}
+			};
+			try {
+				const locale = typeof ctx?.get === "function" ? ctx.get("locale") : null;
+				if (typeof locale?.register === "function" && typeof locale?.bind === "function") {
+					unregisterLocale = locale.register(LOCALE_NS, LOCALE_DICT);
+					currentT = locale.bind(LOCALE_NS);
+					if (typeof locale.subscribe === "function") {
+						unsubscribeLocale = locale.subscribe(refreshButtonCopy);
+					}
+				} else {
+					currentT = fallbackT;
+				}
+			} catch (error) {
+				console.warn("[dsh-quote-followup] locale unavailable; using English copy", error);
+				currentT = fallbackT;
+			}
 			try {
 				const inputTriggers = typeof ctx?.get === "function" ? ctx.get("inputTriggers") : null;
 				if (typeof inputTriggers?.registerSource === "function") {
-					unregisterSource = inputTriggers.registerSource(QUOTE_TRIGGER_SOURCE);
+					unregisterSource = inputTriggers.registerSource(makeQuoteSource(currentT));
 					quoteSourceReady = true;
 				}
 			} catch (error) {
@@ -412,6 +458,11 @@ window.__ModuleLoader__.load({
 					return;
 				disposed = true;
 				quoteSourceReady = false;
+				if (typeof unsubscribeLocale === "function")
+					unsubscribeLocale();
+				if (typeof unregisterLocale === "function")
+					unregisterLocale();
+				currentT = fallbackT;
 				if (typeof unregisterSource === "function")
 					unregisterSource();
 				document.removeEventListener("selectionchange", onSelectionChange);
@@ -437,7 +488,7 @@ window.__ModuleLoader__.load({
 				ctx.effect(() => cleanup, "dsh-quote-followup: selection quote ui");
 		}
 		//#endregion
-		exports.inject = ["inputTriggers"];
+		exports.inject = ["inputTriggers", "locale"];
 		exports.apply = apply;
 		return module.exports;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quote-followup",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Quote selected Web conversation text into the DeepSeek Harness composer for targeted follow-up turns.",
   "keywords": [
     "dsh",
@@ -28,6 +28,7 @@
   "files": [
     "lib",
     "cordis.patch.yml",
+    "docs",
     "README.md",
     "README.zh.md"
   ],