dsh-plugin-lookatstudy 0.11.0 → 0.11.1

package/lib/client.js

@@ -21,7 +21,7 @@ window.__ModuleLoader__.load({
 		* The study tab's stylesheet. Class names are `lks-*` namespaced; colors,
 		* fonts, and radii come from `--dsw-*` tokens wherever the concept exists.
 		*/
-		const CSS = `
+		const STUDY_CSS = `
 .lks-root{font-family:var(--dsw-font-family)}
 .lks-root :where(button){font-family:var(--dsw-font-family);cursor:pointer;border:none;background:none;padding:0}
 .lks-root :where(a){color:var(--dsw-alias-state-business-primary)}
@@ -32,24 +32,28 @@ window.__ModuleLoader__.load({
    non-growing host and the composer floats over the tab's bottom band, so
    the tab itself never feeds the page scroll. The bottom padding clears the
    floating composer via the host-published live --dsh-composer-height. The
-   center strip reuses the conversation column's width axis
-   (--dsh-composer-card-max-width inherits from ConversationRoot's root), so
-   the tutor transcript is exactly as wide as the native composer; the
-   flanking columns absorb the remaining width and scroll independently. */
+   tutor column shares the conversation column's width axis
+   (--dsh-composer-card-max-width inherits from ConversationRoot's root) but
+   is capped at 42% of the tab so the BLACKBOARD — the reading surface —
+   keeps the lion's share at every wide width; the composer card follows the
+   tutor column's real measured width (views.tsx), so the two stay visually
+   tied. Flanking columns absorb the remaining width and scroll independently. */
 .lks-study{height:100%;min-height:0;width:100%;box-sizing:border-box;overflow:hidden;display:flex;flex-direction:column;padding:10px 14px calc(var(--dsh-composer-height, 152px) + 12px);color:var(--dsw-alias-label-primary);container:lksstudy/inline-size}
 /* Direction carrier (a container query cannot style the container itself). */
 .lks-body{flex:1;min-height:0;min-width:0;display:flex;gap:16px}
 .lks-col{display:flex;flex-direction:column;min-width:0}
 .lks-colhead{flex:none;font-size:12px;font-weight:600;color:var(--dsw-alias-label-tertiary);letter-spacing:.06em;text-transform:uppercase;margin-bottom:10px}
 .lks-col-rail{flex:0 1 260px;min-width:180px;overflow-y:auto;padding:2px 6px}
-.lks-col-tutor{flex:0 0 auto;width:min(100%,var(--dsh-composer-card-max-width,780px))}
-.lks-col-bb{flex:1 1 0;min-width:230px;overflow-y:auto;padding:2px 6px}
+.lks-col-tutor{flex:0 1 auto;width:min(100%,var(--dsh-composer-card-max-width,780px),42cqi);min-width:360px}
+.lks-col-bb{flex:1 1 0;min-width:320px;overflow-y:auto;padding:2px 6px}
 /* While the study view is mounted in wide mode, the host composer card is
    shifted under the tutor column (the transcript's width axis) instead of the
-   scroll body's center — views.tsx measures the offset, sets the variable and
-   toggles the class, and removes both whenever the shift collapses (narrow
-   pane, hidden view) so the host's natural centering comes back. */
-[data-composer-card].lks-composer-follow{align-self:flex-start;margin-left:var(--lks-composer-shift,0px)}
+   scroll body's center — views.tsx measures the offset, sets the variables
+   and toggles the class, and removes all three whenever the shift collapses
+   (narrow pane, hidden view) so the host's natural centering and width come
+   back. max-width tracks the tutor column's live width: the tutor shrinks
+   proportionally below ~1857px containers, and the card shrinks with it. */
+[data-composer-card].lks-composer-follow{align-self:flex-start;margin-left:var(--lks-composer-shift,0px);max-width:var(--lks-composer-follow-width,var(--dsh-composer-card-max-width,780px))}
 /* narrow (<1220px): one composer-width pane at a time, chosen by a centered
    segmented pill group (joined buttons in one capsule — button language, not
    tab language, against the host's view tabs right above). */
@@ -184,12 +188,18 @@ window.__ModuleLoader__.load({
 .lks-prose pre{background:var(--dsw-alias-markdown-code-block);border:1px solid var(--dsw-alias-border-l1);border-radius:10px;padding:10px;overflow-x:auto;margin:8px 0;font-size:13.5px;font-family:var(--dsw-font-markdown-code-block-small)}
 .lks-prose code{font-family:var(--dsw-font-markdown-code);background:var(--dsw-alias-bg-layer-3);border-radius:4px;padding:1px 5px;font-size:.92em}
 .lks-prose pre code{background:none;padding:0}
-.lks-prose table{border-collapse:collapse;margin:8px 0}
+.lks-prose table{border-collapse:collapse;margin:8px 0;display:block;max-width:100%;overflow-x:auto}
 .lks-prose th,.lks-prose td{border:1px solid var(--dsw-alias-border-l2);padding:5px 11px;font-size:14px}
 .lks-prose th{background:var(--dsw-alias-bg-layer-2)}
 .lks-prose blockquote{border-left:3px solid var(--dsw-alias-state-business-primary);padding:2px 12px;color:var(--dsw-alias-label-secondary);margin:8px 0}
 .lks-prose ul,.lks-prose ol{padding-left:22px;margin:6px 0}
 .lks-prose img{max-width:100%}
+/* width guards for CDN-rendered artifacts (both teach and diagram panes are
+   .lks-prose): mermaid/markmap/elk SVGs carry fixed width attributes; KaTeX
+   display math can exceed the column; both must degrade to fit/scroll
+   internally instead of stretching the blackboard. */
+.lks-prose svg{max-width:100%;height:auto}
+.lks-prose .katex-display{overflow-x:auto;overflow-y:hidden;padding:2px 0}
 
 /* Cornell notes zones */
 .lks-bb-notes{margin-top:14px;padding-top:10px;border-top:1px solid var(--dsw-alias-border-l1)}
@@ -203,6 +213,29 @@ window.__ModuleLoader__.load({
 
 /* inline error text (write-action failures) */
 .lks-propcard-err{color:var(--dsw-alias-state-error-primary);font-size:12px;margin-top:6px;flex:none}
+
+/* settings section (settings.section entry inside the host settings shell) */
+.lks-settings{display:flex;flex-direction:column;gap:18px;font-family:var(--dsw-font-family);color:var(--dsw-alias-label-primary)}
+.lks-set-row h3{margin:0 0 4px;font-size:15px;font-weight:600}
+.lks-set-hint{margin:0 0 10px;font-size:13px;color:var(--dsw-alias-label-tertiary)}
+.lks-set-state{margin-left:10px;font-size:13px;color:var(--dsw-alias-label-secondary)}
+.lks-set-stats{margin:0;padding-left:18px;font-size:14px;line-height:1.9}
+.lks-set-path{font-family:var(--dsw-font-markdown-code);font-size:12.5px;background:var(--dsw-alias-bg-layer-3);border-radius:6px;padding:3px 8px;word-break:break-all}
+
+/* composer dock status pill (conversation.composer.dock entry) */
+.lks-dockpill{display:inline-flex;gap:10px;align-items:center;font-size:12px;color:var(--dsw-alias-label-tertiary)}
+.lks-dockseg{white-space:nowrap}
+.lks-dock-due{color:var(--dsw-alias-state-warn-label)}
+.lks-dock-streak{color:var(--dsw-alias-state-business-primary)}
+
+/* keyed tool.call.toolview cards (conversation tab tool rows) */
+.lks-tv{display:flex;flex-direction:column;gap:4px;padding:6px 10px;border-radius:10px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);font-size:13px}
+.lks-tv.err{border-color:var(--dsw-alias-state-error-primary)}
+.lks-tv-head{font-weight:600;color:var(--dsw-alias-label-secondary);font-size:12px}
+.lks-tv-chip{align-self:flex-start;border-radius:999px;padding:2px 10px;font-size:12.5px;font-weight:600}
+.lks-tv-chip.ok{background:var(--dsw-alias-state-success-tertiary);color:var(--dsw-alias-state-success-label)}
+.lks-tv-chip.bad{background:var(--dsw-alias-state-error-tertiary);color:var(--dsw-alias-state-error-label)}
+.lks-tv-line{color:var(--dsw-alias-label-secondary);line-height:1.6;white-space:pre-wrap}
 `;
 		/**
 		* Inject the study stylesheet into `document.head` (idempotent).
@@ -213,7 +246,7 @@ window.__ModuleLoader__.load({
 			if (existing !== null) return existing;
 			const style = document.createElement("style");
 			style.setAttribute(STYLE_ID, "");
-			style.textContent = CSS;
+			style.textContent = STUDY_CSS;
 			document.head.appendChild(style);
 			return style;
 		}
@@ -358,6 +391,10 @@ window.__ModuleLoader__.load({
 				});
 				this.refresh();
 			}
+			/** Full-text lesson search (rail fallback when local title matching misses). */
+			async searchLessons(query) {
+				return (await fetchJson(`/lookatstudy/api/search?q=${encodeURIComponent(query)}`)).matches ?? [];
+			}
 			/** Point the tutor's focus at one lesson. */
 			async setFocus(lessonId) {
 				await fetchJson("/lookatstudy/api/focus", {
@@ -398,6 +435,7 @@ window.__ModuleLoader__.load({
 				activate: studyStore.activate.bind(studyStore),
 				setMode: studyStore.setMode.bind(studyStore),
 				setFocus: studyStore.setFocus.bind(studyStore),
+				searchLessons: studyStore.searchLessons.bind(studyStore),
 				deleteCourse: studyStore.deleteCourse.bind(studyStore),
 				bindLessonSession: studyStore.bindLessonSession.bind(studyStore)
 			};
@@ -416,9 +454,12 @@ window.__ModuleLoader__.load({
 		function escapeHtml(text) {
 			return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 		}
-		/** Render inline markup (code, bold, italic, links) over escaped text. */
+		/** Render inline markup (code, bold, italic, links, images) over escaped text.
+		* Image src allowlist: https?:// or data:image/ — folder imports inline local
+		* images as data URLs (capped), GitHub imports reference jsDelivr; anything
+		* else stays literal text (no broken relative images, no exotic schemes). */
 		function inline(escaped) {
-			return escaped.replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/\*([^*]+)\*/g, "<em>$1</em>").replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, "<a href=\"$2\" target=\"_blank\" rel=\"noreferrer\">$1</a>");
+			return escaped.replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/\*([^*]+)\*/g, "<em>$1</em>").replace(/!\[([^\]]*)\]\((https?:\/\/[^)\s]+|data:image\/[^)\s]+)\)/g, (_m, alt, src) => `<img src="${src}" alt="${alt}" loading="lazy">`).replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, "<a href=\"$2\" target=\"_blank\" rel=\"noreferrer\">$1</a>");
 		}
 		/** True when the line opens a GFM table row (pipes with a delimiter row next). */
 		function isTableRow(line) {
@@ -540,6 +581,1088 @@ window.__ModuleLoader__.load({
 			return out.join("\n");
 		}
 		//#endregion
+		//#region src/vendor/mermaid-elk-rewrite.ts
+		/**
+		* mermaid-elk-rewrite —— flowchart → flowchart-elk 前缀改写(v0.21 纯函数)。
+		*
+		* 只在渲染层改写:LLM 出题提示词(draw_diagram)与语法修复回路
+		* (diagram-repair-service)都继续产出/接收**原版 flowchart 语法**,零改动;
+		* renderMermaid 喂给 mermaid 前把 flowchart/graph 声明行改成 flowchart-elk ——
+		* 同一套语法换 ELK 布局引擎(正交路由,复杂流程图边交叉显著少于 dagre)。
+		*
+		* mermaid 机制:flowchart-elk 前缀 → detector 置 config.layout="elk" → 查
+		* registerLayoutLoaders 注册的 "elk" 算法;未注册则静默退 dagre 并 console.warn
+		* (ui-test 靠该 warn 断言 ELK 真实生效)。
+		*
+		* 范围:只改首个内容行的 flowchart 家族声明;sequenceDiagram/stateDiagram-v2/
+		* classDiagram 等其余图类型原样返回(ELK 布局只对 flowchart 家族注册)。
+		*/
+		/** 首个内容行(跳过空行与 %% 注释/`%%{init}%%` 指令行)的 flowchart 声明改为
+		*  flowchart-elk;已是 flowchart-elk 则幂等返回;其他图类型不动。 */
+		function rewriteFlowchartToElk(code) {
+			const lines = code.split("\n");
+			for (let i = 0; i < lines.length; i++) {
+				const line = lines[i] ?? "";
+				const trimmed = line.trim();
+				if (!trimmed || trimmed.startsWith("%%")) continue;
+				if (/^flowchart-elk\b/i.test(trimmed)) return code;
+				if (/^(flowchart|graph)\b/i.test(trimmed)) {
+					lines[i] = line.replace(/^(\s*)(flowchart|graph)\b/i, "$1flowchart-elk");
+					return lines.join("\n");
+				}
+				return code;
+			}
+			return code;
+		}
+		//#endregion
+		//#region src/client/enhance.ts
+		/**
+		* Post-render blackboard enhancement (SPEC Phase 2): math (KaTeX), code
+		* highlighting (shiki), and mermaid diagrams — every dependency loaded from a
+		* CDN at runtime (zero-dependency mandate: nothing enters the bundle), every
+		* failure degrading silently to the existing plain rendering. Upstream parity:
+		* math-normalize runs host-side before renderMarkdown; the CDN + lazy-singleton
+		* pattern follows upstream lazy-shiki/lazy-mermaid, pointed at esm.sh/cdnjs.
+		*
+		* Test seams: every loader is injectable via `setEnhanceDeps` so node:test
+		* proves the enhance/degrade paths offline (the structural-test discipline:
+		* prove a gate fails first, then trust its green).
+		*/
+		/** Map a lang-xxx class to shiki's grammar id (upstream's curated set, aliases included). */
+		const LANG_ALIAS = {
+			ts: "typescript",
+			tsx: "tsx",
+			js: "javascript",
+			jsx: "jsx",
+			mjs: "javascript",
+			cjs: "javascript",
+			py: "python",
+			rb: "ruby",
+			rs: "rust",
+			"c++": "cpp",
+			cs: "csharp",
+			kt: "kotlin",
+			sh: "bash",
+			shell: "bash",
+			zsh: "bash",
+			yml: "yaml",
+			md: "markdown",
+			tex: "latex",
+			docker: "dockerfile"
+		};
+		let deps = {};
+		const CDN$1 = {
+			katexJs: "https://cdn.jsdelivr.net/npm/katex@0.16.22/dist/katex.min.js",
+			katexCss: "https://cdn.jsdelivr.net/npm/katex@0.16.22/dist/katex.min.css",
+			shiki: "https://esm.sh/shiki@1.29.2",
+			mermaid: "https://esm.sh/mermaid@11.4.1",
+			mermaidElk: "https://esm.sh/@mermaid-js/layout-elk@0.1.7"
+		};
+		function loadScript(src) {
+			return new Promise((resolve, reject) => {
+				const el = document.createElement("script");
+				el.src = src;
+				el.onload = () => {
+					resolve();
+				};
+				el.onerror = () => {
+					reject(/* @__PURE__ */ new Error(`script load failed: ${src}`));
+				};
+				document.head.append(el);
+			});
+		}
+		let katexPromise = null;
+		function defaultLoadKatex() {
+			katexPromise ??= (async () => {
+				if (!document.querySelector(`link[data-lks-katex]`)) {
+					const link = document.createElement("link");
+					link.rel = "stylesheet";
+					link.href = CDN$1.katexCss;
+					link.setAttribute("data-lks-katex", "1");
+					document.head.append(link);
+				}
+				if (window.katex === void 0) await loadScript(CDN$1.katexJs);
+				const katex = window.katex;
+				if (katex === void 0) throw new Error("katex missing after load");
+				return katex;
+			})();
+			return katexPromise;
+		}
+		let shikiPromise = null;
+		function defaultLoadShiki() {
+			shikiPromise ??= import(
+				/* @vite-ignore */
+				CDN$1.shiki
+).then((mod) => {
+				const create = mod.createHighlighter;
+				if (create === void 0) throw new Error("shiki createHighlighter missing");
+				return create({
+					themes: ["github-dark", "github-light"],
+					langs: [
+						"typescript",
+						"javascript",
+						"python",
+						"bash",
+						"json",
+						"yaml",
+						"css",
+						"html",
+						"markdown",
+						"cpp",
+						"go",
+						"rust",
+						"java",
+						"sql"
+					]
+				});
+			});
+			return shikiPromise;
+		}
+		let mermaidPromise = null;
+		function defaultLoadMermaid() {
+			mermaidPromise ??= (async () => {
+				const mermaid = (await import(
+					/* @vite-ignore */
+					CDN$1.mermaid
+)).default;
+				try {
+					const elk = await import(
+						/* @vite-ignore */
+						CDN$1.mermaidElk
+);
+					mermaid.registerLayoutLoaders(elk.default);
+				} catch {}
+				mermaid.initialize({
+					startOnLoad: false,
+					theme: "base",
+					securityLevel: "loose"
+				});
+				return mermaid;
+			})();
+			return mermaidPromise;
+		}
+		/** Split one text node's data around the FIRST math span; returns null when none. */
+		function findMathSpan(text) {
+			const display = /\$\$([^$]+)\$\$/.exec(text);
+			const inline = /\$([^$\n]+)\$/.exec(text);
+			if (display === null && inline === null) return null;
+			const m = display !== null && (inline === null || display.index <= inline.index) ? {
+				...display,
+				display: true
+			} : inline === null ? null : {
+				...inline,
+				display: false
+			};
+			if (m === null) return null;
+			return {
+				before: text.slice(0, m.index),
+				tex: m[1],
+				after: text.slice(m.index + m[0].length),
+				display: m.display
+			};
+		}
+		/** KaTeX every $..$ / $$..$$ in the container; degrades to plain text on any failure. */
+		async function enhanceMath(container) {
+			let katex;
+			try {
+				katex = await (deps.loadKatex ?? defaultLoadKatex)();
+			} catch {
+				return 0;
+			}
+			let replaced = 0;
+			const walker = document.createTreeWalker(container, NodeFilter.SHOW_TEXT);
+			const targets = [];
+			let node;
+			while ((node = walker.nextNode()) !== null) if (findMathSpan(node.data) !== null && node.parentElement?.tagName !== "CODE") targets.push(node);
+			for (const t of targets) {
+				const span = findMathSpan(t.data);
+				if (span === null) continue;
+				try {
+					const html = katex.renderToString(span.tex, {
+						displayMode: span.display,
+						throwOnError: false
+					});
+					const holder = document.createElement("span");
+					holder.innerHTML = html;
+					if (span.before !== "") t.before(document.createTextNode(span.before));
+					t.before(holder);
+					t.data = span.after;
+					replaced++;
+				} catch {}
+			}
+			return replaced;
+		}
+		/** shiki-highlight every fenced code block; unknown langs and failures keep the plain <pre>. */
+		async function enhanceCode(container) {
+			let shiki;
+			try {
+				shiki = await (deps.loadShiki ?? defaultLoadShiki)();
+			} catch {
+				return 0;
+			}
+			let replaced = 0;
+			const blocks = [...container.querySelectorAll("pre > code")];
+			for (const code of blocks) {
+				if (code.dataset.lksEnhanced === "1") continue;
+				const langClass = [...code.classList].find((c) => c.startsWith("lang-"));
+				if (langClass === void 0) continue;
+				const lang = LANG_ALIAS[langClass.slice(5)] ?? langClass.slice(5);
+				try {
+					const html = await shiki.codeToHtml(code.textContent ?? "", {
+						lang,
+						themes: {
+							light: "github-light",
+							dark: "github-dark"
+						},
+						defaultColor: false,
+						cssVariables: { "--shiki-dark": "var(--shiki-dark, #e6edf3)" }
+					});
+					code.dataset.lksEnhanced = "1";
+					const pre = code.parentElement;
+					const wrap = document.createElement("div");
+					wrap.className = "lks-shiki";
+					wrap.innerHTML = html;
+					pre.replaceWith(wrap);
+					replaced++;
+				} catch {
+					code.dataset.lksEnhanced = "1";
+				}
+			}
+			return replaced;
+		}
+		/** Render mermaid fence blocks to SVG (ELK layout via the registered loader);
+		*  the flowchart prefix rewrite is upstream's mermaid-elk-rewrite, vendored. */
+		async function enhanceDiagrams(container) {
+			let mermaid;
+			try {
+				mermaid = await (deps.loadMermaid ?? defaultLoadMermaid)();
+			} catch {
+				return 0;
+			}
+			let replaced = 0;
+			const blocks = [...container.querySelectorAll("pre > code.lang-mermaid")];
+			for (const code of blocks) {
+				if (code.dataset.lksEnhanced === "1") continue;
+				code.dataset.lksEnhanced = "1";
+				try {
+					const { svg } = await mermaid.render(`lks-mermaid-${replaced}`, rewriteFlowchartToElk(code.textContent ?? ""));
+					const wrap = document.createElement("div");
+					wrap.className = "lks-mermaid";
+					wrap.innerHTML = svg;
+					code.parentElement.replaceWith(wrap);
+					replaced++;
+				} catch {}
+			}
+			return replaced;
+		}
+		/** The full pass over one freshly-rendered container. Never throws. */
+		async function enhanceRendered(container) {
+			try {
+				await enhanceDiagrams(container);
+			} catch {}
+			try {
+				await enhanceCode(container);
+			} catch {}
+			try {
+				await enhanceMath(container);
+			} catch {}
+		}
+		//#endregion
+		//#region src/vendor/mindmap-markdown.ts
+		/**
+		* mindmap-markdown —— 讲解 markdown → 思维导图源文本的纯函数预处理(v0.21)。
+		*
+		* 思维导图是**结构概览**:代码块整段进脑图节点只是噪声(markmap-lib 还会为它
+		* 内嵌 hljs 高亮 HTML),图片也无处安放。喂给 markmap 前剥离:
+		*   - 围栏代码块(``` 或 ~~~,含缩进围栏)→ 单行「代码块」占位(保住结构位置)
+		*   - 图片 ![alt](url) → alt 文字
+		*   - HTML 注释整段剥除
+		* 其余(标题层级/列表/粗体/链接文字)原样保留 —— 层级就是脑图骨架。
+		*/
+		function mindmapMarkdown(md) {
+			const out = [];
+			let fence = null;
+			let fenceLen = 0;
+			for (const line of md.split("\n")) {
+				const open = /^(\s*)(`{3,}|~{3,})/.exec(line);
+				if (fence == null) {
+					if (open) {
+						fence = (open[2] ?? "")[0] ?? "`";
+						fenceLen = (open[2] ?? "").length;
+						out.push(`${open[1] ?? ""}- 代码块`);
+						continue;
+					}
+					out.push(line);
+				} else if (new RegExp(`^\\s*\\${fence === "~" ? "~" : "`"}{${fenceLen},}\\s*$`).test(line)) fence = null;
+			}
+			return out.join("\n").replace(/!\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/<!--[\s\S]*?-->/g, "");
+		}
+		//#endregion
+		//#region src/vendor/cmap-elk-layout.ts
+		/** 字符宽度估算:CJK 全宽,ASCII 约 0.58em,其余(BBOP…)同 ASCII。 */
+		function estTextWidth(text, fontSize = 13) {
+			let w = 0;
+			for (const ch of text) w += /[\u2e80-\u9fff\uf900-\ufaff\uff00-\uffef\u3000-\u303f]/.test(ch) ? fontSize : fontSize * .58;
+			return w;
+		}
+		const LINE_MAX_PX = 118;
+		/** 标签包裹:≤2 行;优先自然断点(空格///-),CJK 连续按宽度一半硬拆;仍超宽截断。 */
+		function wrapLabel(label) {
+			if (estTextWidth(label) <= LINE_MAX_PX) return [label];
+			const breaks = [];
+			for (let i = 0; i < label.length; i++) if (/[\s/\-—·]/.test(label[i] ?? "")) breaks.push(i);
+			const mid = label.length / 2;
+			let split = -1;
+			let best = Infinity;
+			for (const b of breaks) {
+				const d = Math.abs(b + 1 - mid);
+				if (d < best) {
+					best = d;
+					split = b;
+				}
+			}
+			let l1;
+			let l2;
+			if (split >= 0) {
+				l1 = label.slice(0, split + 1).trim();
+				l2 = label.slice(split + 1).trim();
+			} else {
+				let acc = 0;
+				let idx = 0;
+				for (const ch of label) {
+					acc += estTextWidth(ch);
+					idx++;
+					if (acc >= estTextWidth(label) / 2) break;
+				}
+				l1 = label.slice(0, idx);
+				l2 = label.slice(idx);
+			}
+			if (estTextWidth(l1) <= LINE_MAX_PX && estTextWidth(l2) <= LINE_MAX_PX) return [l1, l2];
+			const fit = (s) => {
+				let out = "";
+				for (const ch of s) {
+					if (estTextWidth(out + ch + "…") > LINE_MAX_PX) break;
+					out += ch;
+				}
+				return out + "…";
+			};
+			return [estTextWidth(l1) > LINE_MAX_PX ? fit(l1) : l1, estTextWidth(l2) > LINE_MAX_PX ? fit(l2) : l2];
+		}
+		/** 节点盒:hub(度数最大或 ≥4)字号/内边距更大;宽高由包裹后行宽决定。 */
+		function cmNodeBox(label, hub) {
+			const lines = wrapLabel(label);
+			const fs = hub ? 14 : 13;
+			const textW = Math.max(...lines.map((l) => estTextWidth(l, fs)));
+			const padX = hub ? 30 : 24;
+			const lh = 17;
+			const padY = hub ? 18 : 14;
+			return {
+				width: Math.min(hub ? 200 : 180, Math.max(hub ? 92 : 76, textW + padX)),
+				height: padY + lines.length * lh,
+				lines
+			};
+		}
+		/**
+		* 净化 LLM groups:丢弃指向不存在节点的 nodeIds、去重(先到先得)、
+		* 剩余成员 < 2 的组丢弃;唯一覆盖全部节点的单组视为无效(一个巨容器没有信息量)。
+		* 净化后为空 → clusterByAdjacency 兜底。
+		*/
+		function resolveGroups(nodes, edges, input) {
+			const ids = new Set(nodes.map((n) => n.id));
+			if (Array.isArray(input) && input.length > 0) {
+				const assigned = /* @__PURE__ */ new Set();
+				const groups = [];
+				for (const g of input) {
+					if (!g || typeof g.id !== "string" || !g.id) continue;
+					const nodeIds = Array.isArray(g.nodeIds) ? [...new Set(g.nodeIds.filter((x) => typeof x === "string" && ids.has(x) && !assigned.has(x)))] : [];
+					if (nodeIds.length < 2) continue;
+					nodeIds.forEach((x) => assigned.add(x));
+					groups.push({
+						id: g.id,
+						label: typeof g.label === "string" && g.label ? g.label : "分组",
+						nodeIds
+					});
+				}
+				if (groups.length > 0 && !(groups.length === 1 && assigned.size === nodes.length && nodes.length > 2)) return {
+					groups,
+					fallback: false
+				};
+			}
+			return {
+				groups: clusterByAdjacency(nodes, edges),
+				fallback: true
+			};
+		}
+		/**
+		* 邻接聚类兜底(确定性):度数 top-k 节点做种子(k = clamp(ceil(n/4),1,3)),
+		* 多源 BFS 就近归属(平手先出现的种子赢);孤立节点不归组(根层漂浮,不造假组)。
+		* 组名 = 种子标签(≤5 字加"相关")。
+		*/
+		function clusterByAdjacency(nodes, edges) {
+			if (nodes.length < 4) return [];
+			const index = new Map(nodes.map((n, i) => [n.id, i]));
+			const adj = /* @__PURE__ */ new Map();
+			for (const n of nodes) adj.set(n.id, []);
+			const seenPair = /* @__PURE__ */ new Set();
+			for (const e of edges) {
+				if (!index.has(e.from) || !index.has(e.to) || e.from === e.to) continue;
+				const key = [e.from, e.to].sort().join("→");
+				if (seenPair.has(key)) continue;
+				seenPair.add(key);
+				adj.get(e.from).push(e.to);
+				adj.get(e.to).push(e.from);
+			}
+			const ranked = [...nodes].sort((a, b) => {
+				const da = adj.get(a.id).length;
+				const db = adj.get(b.id).length;
+				return da !== db ? db - da : (index.get(a.id) ?? 0) - (index.get(b.id) ?? 0);
+			});
+			const k = Math.min(3, Math.max(1, Math.ceil(nodes.length / 4)));
+			const seeds = ranked.slice(0, k).filter((s) => (adj.get(s.id)?.length ?? 0) > 0);
+			if (seeds.length === 0) return [];
+			const owner = /* @__PURE__ */ new Map();
+			seeds.forEach((s, si) => owner.set(s.id, si));
+			const queue = seeds.map((s) => s.id);
+			while (queue.length) {
+				const cur = queue.shift();
+				const si = owner.get(cur);
+				for (const nb of adj.get(cur) ?? []) {
+					if (owner.has(nb)) continue;
+					owner.set(nb, si);
+					queue.push(nb);
+				}
+			}
+			const groups = [];
+			seeds.forEach((s, si) => {
+				const nodeIds = nodes.filter((n) => owner.get(n.id) === si).map((n) => n.id);
+				if (nodeIds.length < 2) return;
+				groups.push({
+					id: `grp-${s.id}`,
+					label: s.label.length <= 5 ? `${s.label}相关` : s.label,
+					nodeIds
+				});
+			});
+			return groups;
+		}
+		function buildElkGraph(nodes, edges, groups) {
+			const ids = new Set(nodes.map((n) => n.id));
+			const degree = /* @__PURE__ */ new Map();
+			for (const n of nodes) degree.set(n.id, 0);
+			const seenPair = /* @__PURE__ */ new Set();
+			const drawEdges = [];
+			for (const e of edges) {
+				if (!ids.has(e.from) || !ids.has(e.to) || e.from === e.to) continue;
+				const key = [e.from, e.to].sort().join("→");
+				if (seenPair.has(key)) continue;
+				seenPair.add(key);
+				drawEdges.push(e);
+				degree.set(e.from, degree.get(e.from) + 1);
+				degree.set(e.to, degree.get(e.to) + 1);
+			}
+			let hubId = nodes[0]?.id ?? "";
+			for (const n of nodes) if ((degree.get(n.id) ?? 0) > (degree.get(hubId) ?? 0)) hubId = n.id;
+			const inGroup = /* @__PURE__ */ new Map();
+			for (const g of groups) for (const nid of g.nodeIds) if (ids.has(nid) && !inGroup.has(nid)) inGroup.set(nid, g.id);
+			const nodeChild = (n) => {
+				const box = cmNodeBox(n.label, n.id === hubId || (degree.get(n.id) ?? 0) >= 4);
+				return {
+					id: n.id,
+					width: Math.ceil(box.width),
+					height: Math.ceil(box.height)
+				};
+			};
+			const children = [];
+			for (const g of groups) {
+				const members = g.nodeIds.filter((nid) => inGroup.get(nid) === g.id && ids.has(nid));
+				if (members.length === 0) continue;
+				children.push({
+					id: `g:${g.id}`,
+					layoutOptions: { "elk.padding": `[top=34,left=14,bottom=12,right=14]` },
+					children: members.map((nid) => nodeChild(nodes.find((n) => n.id === nid)))
+				});
+			}
+			for (const n of nodes) if (!inGroup.has(n.id)) children.push(nodeChild(n));
+			return {
+				id: "root",
+				layoutOptions: {
+					"elk.algorithm": "layered",
+					"elk.direction": "DOWN",
+					"elk.edgeRouting": "ORTHOGONAL",
+					"elk.hierarchyHandling": "INCLUDE_CHILDREN",
+					"elk.spacing.nodeNode": "34",
+					"elk.spacing.edgeNode": "26",
+					"elk.spacing.componentComponent": "48",
+					"elk.layered.spacing.nodeNodeBetweenLayers": "56"
+				},
+				children,
+				edges: drawEdges.map((e, i) => ({
+					id: `e${i}`,
+					sources: [e.from],
+					targets: [e.to]
+				}))
+			};
+		}
+		/** 折线弧长中点(标签锚点)。 */
+		function polylineMidpoint(pts) {
+			if (pts.length === 0) return {
+				x: 0,
+				y: 0
+			};
+			if (pts.length === 1) return pts[0];
+			const segLens = [];
+			let total = 0;
+			for (let i = 1; i < pts.length; i++) {
+				const l = Math.hypot(pts[i].x - pts[i - 1].x, pts[i].y - pts[i - 1].y);
+				segLens.push(l);
+				total += l;
+			}
+			let remain = total / 2;
+			for (let i = 0; i < segLens.length; i++) {
+				if (remain <= segLens[i] || i === segLens.length - 1) {
+					const t = segLens[i] === 0 ? 0 : remain / segLens[i];
+					return {
+						x: pts[i].x + (pts[i + 1].x - pts[i].x) * t,
+						y: pts[i].y + (pts[i + 1].y - pts[i].y) * t
+					};
+				}
+				remain -= segLens[i];
+			}
+			return pts[pts.length - 1];
+		}
+		function flattenElkResult(elkOut, nodes, edges, groups, groupsFallback, hubId) {
+			const nodesById = new Map(nodes.map((n) => [n.id, n]));
+			const groupColor = /* @__PURE__ */ new Map();
+			groups.forEach((g, i) => groupColor.set(g.id, i % 5));
+			const groupById = new Map(groups.map((g) => [g.id, g]));
+			const memberGroup = /* @__PURE__ */ new Map();
+			for (const g of groups) for (const nid of g.nodeIds) if (!memberGroup.has(nid)) memberGroup.set(nid, g.id);
+			const outNodes = [];
+			const outGroups = [];
+			const outEdges = [];
+			const containerOff = /* @__PURE__ */ new Map([["root", {
+				x: 0,
+				y: 0
+			}]]);
+			const rawEdges = [];
+			const walk = (elk, offX, offY, containerId) => {
+				for (const child of elk.children ?? []) {
+					const cx = offX + (child.x ?? 0);
+					const cy = offY + (child.y ?? 0);
+					if (child.children?.length) {
+						const gid = child.id.startsWith("g:") ? child.id.slice(2) : child.id;
+						const meta = groupById.get(gid);
+						outGroups.push({
+							id: gid,
+							label: meta?.label ?? "分组",
+							x: cx,
+							y: cy,
+							w: child.width ?? 0,
+							h: child.height ?? 0,
+							colorIdx: groupColor.get(gid) ?? 0
+						});
+						containerOff.set(child.id, {
+							x: cx,
+							y: cy
+						});
+						walk(child, cx, cy, gid);
+					} else {
+						const n = nodesById.get(child.id);
+						if (!n) continue;
+						const box = cmNodeBox(n.label, n.id === hubId);
+						const gid = memberGroup.get(n.id) ?? null;
+						outNodes.push({
+							id: n.id,
+							x: cx,
+							y: cy,
+							w: child.width ?? Math.ceil(box.width),
+							h: child.height ?? Math.ceil(box.height),
+							lines: box.lines,
+							hub: n.id === hubId,
+							groupId: containerId,
+							colorIdx: gid != null ? groupColor.get(gid) ?? 0 : -1
+						});
+					}
+				}
+				for (const e of elk.edges ?? []) rawEdges.push({
+					e,
+					fallback: {
+						x: offX,
+						y: offY
+					}
+				});
+			};
+			walk(elkOut, 0, 0, null);
+			for (const { e, fallback } of rawEdges) {
+				const sec = e.sections?.[0];
+				if (!sec) continue;
+				const off = (e.container != null ? containerOff.get(e.container) : void 0) ?? fallback;
+				const pts = [
+					sec.startPoint,
+					...sec.bendPoints ?? [],
+					sec.endPoint
+				].map((p) => ({
+					x: p.x + off.x,
+					y: p.y + off.y
+				}));
+				const src = edges[Number(e.id.slice(1))];
+				if (!src) continue;
+				outEdges.push({
+					from: src.from,
+					to: src.to,
+					label: src.label,
+					pts,
+					labelPt: src.label ? polylineMidpoint(pts) : null
+				});
+			}
+			return {
+				width: Math.ceil(elkOut.width ?? 0),
+				height: Math.ceil(elkOut.height ?? 0),
+				nodes: outNodes,
+				groups: outGroups,
+				edges: outEdges,
+				hubId,
+				groupsFallback
+			};
+		}
+		let elkPromise = null;
+		/** elkjs 单例:elk.bundled.js 主线程版(无 Worker,打包器友好,React Flow 生态同款)。 */
+		function loadElk() {
+			elkPromise ??= import(
+				/* @vite-ignore */
+				"https://esm.sh/elkjs@0.12/lib/elk.bundled.js"
+).then((mod) => {
+				const m = mod;
+				return new (m.default ?? m)();
+			});
+			return elkPromise;
+		}
+		/** 概念图 → 分组解析 → ELK 布局 → 绝对坐标几何。输入相同则输出逐字段全等。 */
+		async function layoutConceptMap(nodes, edges, groups) {
+			const resolved = resolveGroups(nodes, edges, groups);
+			const graph = buildElkGraph(nodes, edges, resolved.groups);
+			const hubId = computeHubId(nodes, edges);
+			return flattenElkResult(await (await loadElk()).layout(graph), nodes, edges, resolved.groups, resolved.fallback, hubId);
+		}
+		function computeHubId(nodes, edges) {
+			const ids = new Set(nodes.map((n) => n.id));
+			const degree = /* @__PURE__ */ new Map();
+			for (const n of nodes) degree.set(n.id, 0);
+			const seen = /* @__PURE__ */ new Set();
+			for (const e of edges) {
+				if (!ids.has(e.from) || !ids.has(e.to) || e.from === e.to) continue;
+				const key = [e.from, e.to].sort().join("→");
+				if (seen.has(key)) continue;
+				seen.add(key);
+				degree.set(e.from, degree.get(e.from) + 1);
+				degree.set(e.to, degree.get(e.to) + 1);
+			}
+			let hubId = nodes[0]?.id ?? "";
+			for (const n of nodes) if ((degree.get(n.id) ?? 0) > (degree.get(hubId) ?? 0)) hubId = n.id;
+			return hubId;
+		}
+		//#endregion
+		//#region src/client/diagrams.ts
+		/**
+		* Blackboard diagram views (SPEC Phase 2): the lesson mind map (markmap via
+		* CDN, markdown preprocessed by the vendored mindmap-markdown) and the lesson
+		* concept map (ELK layered layout via the vendored cmap-elk-layout + CDN elkjs,
+		* draw.io-flavored SVG skin rendered plugin-side). Both degrade honestly: any
+		* CDN/ELK failure leaves a one-line notice instead of a broken pane.
+		*/
+		const CDN = {
+			markmapLib: "https://esm.sh/markmap-lib@0.18.12",
+			markmapView: "https://esm.sh/markmap-view@0.18.10"
+		};
+		let markmapPromise = null;
+		async function loadMarkmap() {
+			markmapPromise ??= (async () => {
+				const lib = await import(
+					/* @vite-ignore */
+					CDN.markmapLib
+);
+				const view = await import(
+					/* @vite-ignore */
+					CDN.markmapView
+);
+				const Transformer = lib.Transformer ?? {};
+				const d3 = await import(
+					/* @vite-ignore */
+					"https://esm.sh/d3@7"
+);
+				return {
+					transformer: new Transformer(),
+					Markmap: view.Markmap,
+					d3
+				};
+			})();
+			return markmapPromise;
+		}
+		/** Render the lesson markdown as a mind map into an empty container. */
+		async function renderMindmap(container, markdown) {
+			const { transformer, Markmap, d3 } = await loadMarkmap();
+			const { root } = transformer.transform(mindmapMarkdown(markdown));
+			const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+			svg.setAttribute("style", "width:100%;min-height:420px");
+			container.append(svg);
+			window["markmap"] = { d3 };
+			const mm = Markmap.create(svg, { autoFit: true });
+			mm.setData(root);
+			mm.fit();
+		}
+		/** Lesson concept map: the lesson node + its concepts (weak ones accented),
+		*  laid out by the vendored ELK pipeline, skinned draw.io-style (plugin-original,
+		*  upstream's skin is coupled to its token pipeline). Mastery shades the nodes. */
+		async function renderLessonConceptMap(container, lessonTitle, concepts) {
+			const layout = await layoutConceptMap([{
+				id: "lesson",
+				label: lessonTitle
+			}, ...concepts.map((c) => ({
+				id: `c-${c.title}`,
+				label: c.title
+			}))], concepts.map((c) => ({
+				from: "lesson",
+				to: `c-${c.title}`
+			})));
+			const masteryBy = new Map(concepts.map((c) => [`c-${c.title}`, c.masteryPct]));
+			const ns = "http://www.w3.org/2000/svg";
+			const svg = document.createElementNS(ns, "svg");
+			svg.setAttribute("width", String(Math.max(320, layout.width)));
+			svg.setAttribute("height", String(Math.max(200, layout.height)));
+			svg.setAttribute("viewBox", `0 0 ${layout.width} ${layout.height}`);
+			svg.setAttribute("style", "max-width:100%;background:var(--dsw-surface-1, #fff);border:1px solid var(--dsw-border-1, #d0d7de);border-radius:8px");
+			for (const e of layout.edges) {
+				const path = document.createElementNS(ns, "path");
+				path.setAttribute("d", e.pts.map((p, i) => `${i === 0 ? "M" : "L"}${p.x},${p.y}`).join(" "));
+				path.setAttribute("fill", "none");
+				path.setAttribute("stroke", "var(--dsw-border-2, #8b949e)");
+				path.setAttribute("stroke-width", "1.5");
+				svg.append(path);
+			}
+			for (const n of layout.nodes) {
+				const g = document.createElementNS(ns, "g");
+				g.setAttribute("transform", `translate(${n.x},${n.y})`);
+				const rect = document.createElementNS(ns, "rect");
+				const isLesson = n.id === "lesson";
+				const mastery = masteryBy.get(n.id);
+				rect.setAttribute("width", String(n.w));
+				rect.setAttribute("height", String(n.h));
+				rect.setAttribute("rx", "6");
+				rect.setAttribute("fill", mastery !== void 0 && mastery < 70 ? "#fff3d9" : "var(--dsw-surface-2, #f6f8fa)");
+				rect.setAttribute("stroke", isLesson ? "var(--dsw-accent-1, #0969da)" : "var(--dsw-border-2, #8b949e)");
+				rect.setAttribute("stroke-width", isLesson ? "2" : "1");
+				g.append(rect);
+				n.lines.forEach((line, li) => {
+					const label = document.createElementNS(ns, "text");
+					label.setAttribute("x", String(n.w / 2));
+					label.setAttribute("y", String(n.h / 2 - (n.lines.length - 1) * 7 + li * 14 + 4));
+					label.setAttribute("text-anchor", "middle");
+					label.setAttribute("font-size", isLesson ? "13" : "12");
+					label.setAttribute("font-weight", isLesson ? "600" : "400");
+					label.setAttribute("fill", "var(--dsw-ink-1, #1f2328)");
+					label.textContent = line;
+					g.append(label);
+				});
+				svg.append(g);
+			}
+			container.append(svg);
+		}
+		//#endregion
+		//#region src/client/locale.ts
+		/** Simplified Chinese dictionary (also the fallback locale). */
+		const ZH = {
+			"tab.label": "学习",
+			"col.rail": "课程",
+			"col.tutor": "导师",
+			"col.bb": "黑板",
+			"pane.rail": "课程",
+			"pane.tutor": "导师",
+			"pane.bb": "黑板",
+			"viewtab.teach": "讲解",
+			"viewtab.mind": "🧠 脑图",
+			"viewtab.cmap": "🕸 概念图",
+			"viewtab.mind.title": "本课结构一图流(markmap)",
+			"viewtab.cmap.title": "本课概念关系(ELK 布局)",
+			"loading": "加载中…",
+			"start.title": "一键准备学习:建立学习工作区、开启会话并让导师就位",
+			"start.go": "开始学习",
+			"start.enter": "进入学习",
+			"start.busy": "正在准备学习区…",
+			"soul.direct": "直讲",
+			"soul.direct.hint": "direct 精讲:先讲清楚,再确认懂没懂",
+			"soul.guide": "引导",
+			"soul.guide.hint": "guide 引导:让你自己往前推一步,导师递台阶",
+			"soul.practice": "实战",
+			"soul.practice.hint": "practice 实战:在真实世界的乱问题里学",
+			"zone.understand": "🧠 理解区 — 知识结构",
+			"zone.record": "📝 记录区 — 我的话",
+			"zone.practice": "✍️ 练习区 — 答题日志",
+			"rail.empty.title": "暂无课程",
+			"rail.empty.hint": "粘贴 markdown → 说「导入为课程」",
+			"rail.empty.hint2": "本地文件夹 → 说「导入 D:/path/to/folder」",
+			"rail.empty.placeholder": "GitHub 仓库链接,如 microsoft/AI-For-Beginners",
+			"rail.empty.button": "导入",
+			"rail.empty.demo": "导入示例课程",
+			"rail.mastered": "{mastered}/{total} 已掌握",
+			"rail.avg": "平均掌握度 {pct}%",
+			"rail.avg.none": "尚无掌握度数据",
+			"rail.search": "搜索课时…(多关键词空格分隔)",
+			"rail.locate.title": "在课程树中定位当前焦点课时(自动展开所在章节)",
+			"rail.locate": "📍 回到当前课时",
+			"rail.due": "🔁 待复习 {count}",
+			"rail.due.over": "超{days}天",
+			"rail.due.start": "开始复习",
+			"rail.due.tag": "这课时的复习今天到期(SM-2)",
+			"rail.delete": "删除本课程",
+			"rail.delete.confirm": "确认删除?",
+			"rail.delete.title.confirm": "再点一次确认删除(含全部进度与笔记)",
+			"rail.section.collapse": "折叠本章节",
+			"rail.section.expand": "展开本章节({count} 课时)",
+			"rail.section.count": "{count} 课",
+			"rail.lesson.opening": "正在打开课时会话…",
+			"rail.import.toggle": "＋ 导入课程",
+			"rail.import.close": "收起导入",
+			"tag.weak": "{count} 个薄弱知识点,测验会优先考察",
+			"tag.friction": "{count} 次卡点记录(你说\"不懂\"时导师记下的)",
+			"tag.mastery": "课时掌握度 {pct}%(取最薄弱知识点)",
+			"tag.mastery.short": "课时掌握度 = 最薄弱知识点的掌握度",
+			"status.exam": "章节测验:本节全部课时掌握度 ≥50% 后开放",
+			"status.mastered": "已毕业:掌握度 ≥90%(或你接受了掌握提案)",
+			"status.in_progress": "学习中:已开课,掌握度从 50% 起步",
+			"status.available": "可开始:已解锁,尚未学习",
+			"status.locked": "未解锁:先完成前面的课时",
+			"chip.unattributed": "未归因",
+			"chip.correct": "✓ 答对 · {concept}",
+			"chip.wrong": "✗ 答错 · {concept}",
+			"chip.import": "📦 导入课程",
+			"chip.concepts": "🧠 提炼知识点",
+			"row.thinking": "导师思考中…",
+			"row.thinking.title": "导师正在推理,回复马上就来",
+			"quiz.title": "点击选项作答,也可以直接打字回答",
+			"quiz.answer": "选 {letter}:{text}",
+			"tutor.empty": "对话会出现在这里",
+			"tutor.empty.hint": "在下方输入框和导师说话",
+			"proposal.text": "导师提议你已掌握「{lesson}」:{rationale}",
+			"proposal.accept": "接受",
+			"proposal.decline": "再练练",
+			"bb.empty": "黑板还空着",
+			"bb.empty.hint": "在左侧课程树选择一课",
+			"bb.mastery": "掌握度 {pct}%",
+			"bb.fallback.mind": "脑图渲染不可用(网络受限) — 已回退讲解视图",
+			"bb.fallback.cmap.empty": "概念图需要先由导师定义本课概念",
+			"bb.fallback.cmap": "概念图渲染不可用(布局引擎加载失败) — 已回退讲解视图",
+			"bb.notes": "笔记",
+			"bb.notes.empty": "这一课还没有笔记",
+			"active.off.title": "注册 study 工具并载入导师人格,之后普通对话和现在一样",
+			"active.on.title": "注销 study 工具与导师人格;学习进度保留,可随时重新开启",
+			"active.off": "▶ 开始学习",
+			"active.on": "⏻ 退出学习模式",
+			"prompt.kickoff": "开始学习:查看我的学习状态并打开当前焦点课时。如果我还没有课程,推荐我导入示例课程(AI-For-Beginners)并说明怎么开始。回复最后请提醒我点上方「学习」页签进入学习界面。",
+			"settings.nav": "学习",
+			"settings.mode": "教学风格",
+			"settings.mode.hint": "导师的讲解风格;也可在学习页随时切换",
+			"settings.studyMode": "学习模式",
+			"settings.studyMode.hint": "开启后注册 study_* 工具并载入导师人格;进度与笔记始终保留",
+			"settings.on": "已开启",
+			"settings.off": "已关闭",
+			"settings.turnOn": "开启",
+			"settings.turnOff": "关闭",
+			"settings.stats": "学习统计",
+			"settings.stats.courses": "课程 {count} 个",
+			"settings.stats.xp": "XP {xp} · Lv{level}({pct}%)",
+			"settings.stats.today": "今日 {xp}/{goal}",
+			"settings.stats.streak": "连续 {days} 天(最长 {best},剩冻结 {freeze})",
+			"settings.stateFile": "状态文件",
+			"settings.stateFile.hint": "学习进度存放于本机 JSON,换机可迁移",
+			"dock.title": "学习状态:待复习 {due} · 连续 {streak} 天 · Lv{level} — 点上方「学习」页签进入",
+			"dock.due": "⚡{count}",
+			"dock.streak": "🔥{days}d",
+			"dock.lv": "Lv{level}",
+			"prompt.import": "导入课程:用 study_import_github 抓取 {url}",
+			"prompt.lesson": "学习「{title}」:用 study_lesson 打开这一课开始学习。",
+			"prompt.exam": "开始「{section}」的章节测验:按本节课时出题,答完逐题判分",
+			"prompt.review": "开始今天的复习,从最到期的课时开始",
+			"prompt.proposal.accept": "接受提案 {id} —— 确认标记这课为已掌握",
+			"prompt.proposal.decline": "拒绝提案 {id} —— 我想再练练"
+		};
+		/** English dictionary — key set must equal {@link ZH}'s (test-asserted). */
+		const EN = {
+			"tab.label": "Study",
+			"col.rail": "Courses",
+			"col.tutor": "Tutor",
+			"col.bb": "Blackboard",
+			"pane.rail": "Courses",
+			"pane.tutor": "Tutor",
+			"pane.bb": "Board",
+			"viewtab.teach": "Teach",
+			"viewtab.mind": "🧠 Mind map",
+			"viewtab.cmap": "🕸 Concepts",
+			"viewtab.mind.title": "The lesson as one markmap graph",
+			"viewtab.cmap.title": "The lesson's concept relations (ELK layout)",
+			"loading": "Loading…",
+			"start.title": "One click to study: workspace + session + tutor, all set up",
+			"start.go": "Start learning",
+			"start.enter": "Enter study",
+			"start.busy": "Preparing the study area…",
+			"soul.direct": "Direct",
+			"soul.direct.hint": "direct: explain first, then check understanding",
+			"soul.guide": "Guide",
+			"soul.guide.hint": "guide: you push one step forward, the tutor hands you the stairs",
+			"soul.practice": "Practice",
+			"soul.practice.hint": "practice: learn inside real messy problems",
+			"zone.understand": "🧠 Understand — knowledge structure",
+			"zone.record": "📝 Record — in my own words",
+			"zone.practice": "✍️ Practice — answer log",
+			"rail.empty.title": "No courses yet",
+			"rail.empty.hint": "Paste markdown → say \"import as a course\"",
+			"rail.empty.hint2": "Local folder → say \"import D:/path/to/folder\"",
+			"rail.empty.placeholder": "GitHub repo link, e.g. microsoft/AI-For-Beginners",
+			"rail.empty.button": "Import",
+			"rail.empty.demo": "Import the demo course",
+			"rail.mastered": "{mastered}/{total} mastered",
+			"rail.avg": "avg mastery {pct}%",
+			"rail.avg.none": "no mastery data yet",
+			"rail.search": "Search lessons… (space-separated keywords)",
+			"rail.locate.title": "Locate the current focus lesson in the tree (auto-expands its section)",
+			"rail.locate": "📍 Back to current lesson",
+			"rail.due": "🔁 {count} due",
+			"rail.due.over": "{days}d overdue",
+			"rail.due.start": "Start reviewing",
+			"rail.due.tag": "this lesson's review is due today (SM-2)",
+			"rail.delete": "Delete this course",
+			"rail.delete.confirm": "Delete?",
+			"rail.delete.title.confirm": "Click again to confirm (all progress and notes included)",
+			"rail.section.collapse": "Collapse this section",
+			"rail.section.expand": "Expand this section ({count} lessons)",
+			"rail.section.count": "{count} lessons",
+			"rail.lesson.opening": "Opening the lesson session…",
+			"rail.import.toggle": "＋ Import a course",
+			"rail.import.close": "Collapse import",
+			"tag.weak": "{count} weak concepts — quizzes target them first",
+			"tag.friction": "{count} friction marks (logged when you said you were stuck)",
+			"tag.mastery": "lesson mastery {pct}% (the weakest concept)",
+			"tag.mastery.short": "lesson mastery = the weakest concept's mastery",
+			"status.exam": "Section exam: opens when every lesson in the section reaches ≥50% mastery",
+			"status.mastered": "Graduated: mastery ≥90% (or you accepted a mastery proposal)",
+			"status.in_progress": "Learning: opened, mastery starts at 50%",
+			"status.available": "Ready: unlocked, not started",
+			"status.locked": "Locked: finish the preceding lessons first",
+			"chip.unattributed": "unattributed",
+			"chip.correct": "✓ correct · {concept}",
+			"chip.wrong": "✗ wrong · {concept}",
+			"chip.import": "📦 course import",
+			"chip.concepts": "🧠 concepts defined",
+			"row.thinking": "tutor is thinking…",
+			"row.thinking.title": "The tutor is reasoning; the reply is coming",
+			"quiz.title": "Click an option to answer, or just type",
+			"quiz.answer": "Choose {letter}: {text}",
+			"tutor.empty": "The conversation will appear here",
+			"tutor.empty.hint": "Talk to the tutor in the input below",
+			"proposal.text": "The tutor proposes you have mastered \"{lesson}\": {rationale}",
+			"proposal.accept": "Accept",
+			"proposal.decline": "Keep practicing",
+			"bb.empty": "The blackboard is empty",
+			"bb.empty.hint": "Pick a lesson in the course tree on the left",
+			"bb.mastery": "mastery {pct}%",
+			"bb.fallback.mind": "Mind map unavailable (network-restricted) — fell back to the teach view",
+			"bb.fallback.cmap.empty": "The concept map needs the tutor to define this lesson's concepts first",
+			"bb.fallback.cmap": "Concept map unavailable (layout engine failed to load) — fell back to the teach view",
+			"bb.notes": "Notes",
+			"bb.notes.empty": "No notes for this lesson yet",
+			"active.off.title": "Register the study tools and load the tutor persona; plain chats stay as they are",
+			"active.on.title": "Retire the study tools and tutor persona; progress is kept and you can re-enable anytime",
+			"active.off": "▶ Start learning",
+			"active.on": "⏻ Exit study mode",
+			"prompt.kickoff": "Start learning: check my study state and open the current focus lesson. If I have no course yet, suggest importing the demo course (AI-For-Beginners) and explain how to begin. Remind me at the end to open the \"Study\" tab above to enter the study UI.",
+			"settings.nav": "Study",
+			"settings.mode": "Teaching style",
+			"settings.mode.hint": "The tutor's explanation style; switchable anytime in the study tab too",
+			"settings.studyMode": "Study mode",
+			"settings.studyMode.hint": "On registers the study_* tools and the tutor persona; progress and notes are always kept",
+			"settings.on": "On",
+			"settings.off": "Off",
+			"settings.turnOn": "Turn on",
+			"settings.turnOff": "Turn off",
+			"settings.stats": "Study stats",
+			"settings.stats.courses": "{count} courses",
+			"settings.stats.xp": "XP {xp} · Lv{level} ({pct}%)",
+			"settings.stats.today": "Today {xp}/{goal}",
+			"settings.stats.streak": "Streak {days}d (best {best}, {freeze} freeze left)",
+			"settings.stateFile": "State file",
+			"settings.stateFile.hint": "Your progress lives in a local JSON file — copy it to migrate machines",
+			"dock.title": "Study status: {due} due · {streak}d streak · Lv{level} — open the Study tab above to continue",
+			"dock.due": "⚡{count}",
+			"dock.streak": "🔥{days}d",
+			"dock.lv": "Lv{level}",
+			"prompt.import": "Import a course: fetch {url} with study_import_github",
+			"prompt.lesson": "Study \"{title}\": open this lesson with study_lesson and start teaching.",
+			"prompt.exam": "Start the section exam for \"{section}\": quiz me on this section's lessons and grade each answer",
+			"prompt.review": "Start today's review, from the most overdue lesson first",
+			"prompt.proposal.accept": "Accept proposal {id} — confirm marking this lesson as mastered",
+			"prompt.proposal.decline": "Reject proposal {id} — I want to practice more"
+		};
+		/** Both dictionaries under their locale ids (the service's register shape). */
+		const STUDY_DICTS = {
+			zh: ZH,
+			en: EN
+		};
+		/** The namespace id this plugin registers with the framework locale service. */
+		const STUDY_NS = "lookatstudy";
+		/**
+		* Pure translator with the service's semantics: own-locale dict → zh
+		* fallback → the key itself, `{name}` interpolation left untouched when the
+		* param is missing.
+		* @param locale - active locale id ('zh'/'en'; unknown ids fall back to zh).
+		* @returns a stable-shaped translate function.
+		*/
+		function makeT(locale) {
+			const dict = locale === "en" ? EN : ZH;
+			return (key, params) => {
+				const template = dict[key] ?? ZH[key] ?? key;
+				if (params === void 0) return template;
+				return template.replace(/\{(\w+)\}/g, (match, name) => name in params ? String(params[name]) : match);
+			};
+		}
+		/**
+		* Register the namespace with the framework locale service.
+		* @param locale - the client locale service when present.
+		* @returns the registration disposer (a no-op when the service is absent or
+		*          a hostile re-registration was refused).
+		*/
+		function registerStudyLocale(locale) {
+			if (locale === void 0) return () => {};
+			try {
+				return locale.register(STUDY_NS, STUDY_DICTS);
+			} catch {
+				return () => {};
+			}
+		}
+		/**
+		* The live translator: the service's stable `bind` when present (reads the
+		* active locale at call time, so a locale-change re-render picks new
+		* strings), the pure zh translator otherwise.
+		* @param locale - the client locale service when present.
+		*/
+		function studyTranslator(locale) {
+			return locale === void 0 ? makeT("zh") : locale.bind(STUDY_NS);
+		}
+		/** The module's active translator — zh until the view factory installs the live bind. */
+		let activeT = makeT("zh");
+		/**
+		* Install the client-wide translator (called once at client apply, before
+		* any component renders).
+		*/
+		function setStudyTranslator(t) {
+			activeT = t;
+		}
+		/**
+		* Translate through the active translator — the import every client module
+		* uses for user-visible copy. Pure helpers take an optional explicit `t`
+		* defaulting to the current active translator, evaluated per call.
+		*/
+		function tr(key, params) {
+			return activeT(key, params);
+		}
+		//#endregion
 		//#region src/client/views.tsx
 		/**
 		* The study tab: one `conversation.view` entry rendering the whole plugin —
@@ -554,28 +1677,28 @@ window.__ModuleLoader__.load({
 		* @module dsh-plugin-lookatstudy/client/views
 		*/
 		/** The three souls, in pill order (labels from LookatStudy's mode switcher). */
-		const MODES = [
+		const MODES$1 = [
 			{
 				id: "direct",
-				label: "直讲",
-				hint: "direct 精讲:先讲清楚,再确认懂没懂"
+				labelKey: "soul.direct",
+				hintKey: "soul.direct.hint"
 			},
 			{
 				id: "guide",
-				label: "引导",
-				hint: "guide 引导:让你自己往前推一步,导师递台阶"
+				labelKey: "soul.guide",
+				hintKey: "soul.guide.hint"
 			},
 			{
 				id: "practice",
-				label: "实战",
-				hint: "practice 实战:在真实世界的乱问题里学"
+				labelKey: "soul.practice",
+				hintKey: "soul.practice.hint"
 			}
 		];
-		/** Zone labels for the Cornell notebook (understand / record / practice). */
+		/** Zone keys for the Cornell notebook (understand / record / practice). */
 		const ZONES = [
-			["understand", "🧠 理解区 — 知识结构"],
-			["record", "📝 记录区 — 我的话"],
-			["practice", "✍️ 练习区 — 答题日志"]
+			["understand", "zone.understand"],
+			["record", "zone.record"],
+			["practice", "zone.practice"]
 		];
 		/** Status glyph for one lesson row (LookatStudy's map icons). */
 		function glyph(kind, status) {
@@ -610,34 +1733,36 @@ window.__ModuleLoader__.load({
 			return (0, react.createElement)("div", { className: "lks-import" }, (0, react.createElement)("div", { className: "lks-inputrow" }, (0, react.createElement)("input", {
 				className: "lks-input",
 				type: "url",
-				placeholder: "GitHub 仓库链接,如 microsoft/AI-For-Beginners",
+				placeholder: tr("rail.empty.placeholder"),
 				value: url,
 				onChange: (e) => {
 					setUrl(e.target.value);
 				},
 				onKeyDown: (e) => {
-					if (e.key === "Enter" && url.trim() !== "") send(`导入课程:用 study_import_github 抓取 ${url.trim()}`);
+					if (e.key === "Enter" && url.trim() !== "") send(tr("prompt.import", { url: url.trim() }));
 				}
 			}), (0, react.createElement)("button", {
 				className: "lks-btn primary",
 				disabled: url.trim() === "",
 				onClick: () => {
-					send(`导入课程:用 study_import_github 抓取 ${url.trim()}`);
+					send(tr("prompt.import", { url: url.trim() }));
 				}
-			}, "导入")), (0, react.createElement)("div", { className: "lks-import-hint" }, "粘贴 markdown → 说「导入为课程」", (0, react.createElement)("br"), "本地文件夹 → 说「导入 D:/path/to/folder」"));
+			}, tr("rail.empty.button"))), (0, react.createElement)("div", { className: "lks-import-hint" }, tr("rail.empty.hint"), (0, react.createElement)("br"), tr("rail.empty.hint2")));
 		}
 		/**
-		* Tooltip text for one course-tree status glyph. Pure.
+		* Tooltip text for one course-tree status glyph. Pure (the translator is an
+		* optional parameter defaulting to the active one, evaluated per call).
 		* @param kind - lesson kind ('study' | 'practice' | 'exam').
 		* @param status - lesson status ('locked' | 'available' | 'in_progress' | 'mastered').
+		* @param t - translator (defaults to the module's active translator).
 		*/
-		function statusTitle(kind, status) {
-			if (kind === "exam") return "章节测验:本节全部课时掌握度 ≥50% 后开放";
+		function statusTitle(kind, status, t = tr) {
+			if (kind === "exam") return t("status.exam");
 			switch (status) {
-				case "mastered": return "已毕业:掌握度 ≥90%(或你接受了掌握提案)";
-				case "in_progress": return "学习中:已开课,掌握度从 50% 起步";
-				case "available": return "可开始:已解锁,尚未学习";
-				default: return "未解锁:先完成前面的课时";
+				case "mastered": return t("status.mastered");
+				case "in_progress": return t("status.in_progress");
+				case "available": return t("status.available");
+				default: return t("status.locked");
 			}
 		}
 		/**
@@ -678,13 +1803,14 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* Learning-aware label for one settled tool call; null keeps the generic
-		* 🔧-name chip. Pure.
+		* 🔧-name chip. Pure (translator defaults to the active one, per call).
 		* @param name - tool call name.
 		* @param argsRaw - the call's raw JSON args.
+		* @param t - translator.
 		*/
-		function toolChipLabel(name, argsRaw) {
+		function toolChipLabel(name, argsRaw, t = tr) {
 			if (name === "study_record_answer") {
-				let concept = "未归因";
+				let concept = t("chip.unattributed");
 				let correct = false;
 				try {
 					const args = JSON.parse(argsRaw);
@@ -692,19 +1818,19 @@ window.__ModuleLoader__.load({
 					correct = args.correct === true;
 				} catch {}
 				return correct ? {
-					label: `✓ 答对 · ${concept}`,
+					label: t("chip.correct", { concept }),
 					tone: "ok"
 				} : {
-					label: `✗ 答错 · ${concept}`,
+					label: t("chip.wrong", { concept }),
 					tone: "bad"
 				};
 			}
 			if (name === "study_import_github" || name === "study_import_markdown" || name === "study_import_folder") return {
-				label: "📦 导入课程",
+				label: t("chip.import"),
 				tone: "ok"
 			};
 			if (name === "study_define_concepts") return {
-				label: "🧠 提炼知识点",
+				label: t("chip.concepts"),
 				tone: "ok"
 			};
 			return null;
@@ -720,9 +1846,10 @@ window.__ModuleLoader__.load({
 		* tool activity condenses to one muted chip per settled call.
 		* @param nodes - finalized conversation nodes from the snapshot.
 		* @param partial - the in-flight assistant partial, or null.
+		* @param t - translator (defaults to the active one, per call).
 		* @returns ordered rows; never mutates its inputs.
 		*/
-		function transcriptRows(nodes, partial) {
+		function transcriptRows(nodes, partial, t = tr) {
 			const rows = [];
 			for (const node of nodes) switch (node.kind) {
 				case "user":
@@ -768,12 +1895,12 @@ window.__ModuleLoader__.load({
 				else rows.push({
 					key: "thinking",
 					role: "thinking",
-					text: "导师思考中…"
+					text: t("row.thinking")
 				});
 			}
 			return rows;
 		}
-		/** Small inline error surface for failed write actions. */
+		/** Small inline error surface for failed write actions (shared with the settings page). */
 		function ActionError({ error }) {
 			if (error === null) return null;
 			return (0, react.createElement)("div", { className: "lks-propcard-err" }, error);
@@ -792,6 +1919,7 @@ window.__ModuleLoader__.load({
 				return "tutor";
 			}
 		}
+		const sessionId = (id) => id;
 		/** The whole study tab. Wide = three columns (课程 | 导师 | 黑板); narrow (<1220px) = one composer-width pane with a three-way switcher. */
 		function studyView(ctx) {
 			return function StudyView(props) {
@@ -804,7 +1932,7 @@ window.__ModuleLoader__.load({
 		}
 		/** Tab body: the factory-bound ctx carries workspaces/sessions for the per-lesson session jumps. */
 		function StudyTab({ useSession, inputActions, ctx }) {
-			const { data, activate, setMode, setFocus, deleteCourse, bindLessonSession } = useStudy();
+			const { data, activate, setMode, setFocus, searchLessons, deleteCourse, bindLessonSession } = useStudy();
 			const snapshot = useSession((s) => s);
 			const [pane, setPane] = (0, react.useState)(storedPane);
 			const rootRef = (0, react.useRef)(null);
@@ -816,6 +1944,7 @@ window.__ModuleLoader__.load({
 				const clear = () => {
 					card.classList.remove("lks-composer-follow");
 					card.style.removeProperty("--lks-composer-shift");
+					card.style.removeProperty("--lks-composer-follow-width");
 				};
 				const apply = () => {
 					const tutor = root.querySelector(".lks-col-tutor");
@@ -830,6 +1959,7 @@ window.__ModuleLoader__.load({
 					const shift = Math.round(Math.max(0, Math.min(tutorRect.left - (seatRect.left + pad), max)));
 					if (shift < 2) return clear();
 					card.style.setProperty("--lks-composer-shift", `${shift}px`);
+					card.style.setProperty("--lks-composer-follow-width", `${Math.round(tutorRect.width)}px`);
 					card.classList.add("lks-composer-follow");
 				};
 				apply();
@@ -850,6 +1980,14 @@ window.__ModuleLoader__.load({
 					inputActions.submit();
 				})();
 			};
+			const [, bumpLocale] = (0, react.useState)(0);
+			(0, react.useEffect)(() => {
+				const localeSvc = ctx.locale;
+				if (localeSvc === void 0) return;
+				return localeSvc.subscribe(() => {
+					bumpLocale((v) => v + 1);
+				});
+			}, [ctx]);
 			return (0, react.createElement)("div", {
 				ref: rootRef,
 				className: "lks-root lks-study",
@@ -857,22 +1995,22 @@ window.__ModuleLoader__.load({
 				"data-pane": pane
 			}, (0, react.createElement)("div", { className: "lks-actbar" }, data === null ? null : (0, react.createElement)("button", {
 				className: `lks-btn ${data.active ? "ghost" : "primary"}`,
-				title: data.active ? "注销 study 工具与导师人格;学习进度保留,可随时重新开启" : "注册 study 工具并载入导师人格,之后普通对话和现在一样",
+				title: data.active ? tr("active.on.title") : tr("active.off.title"),
 				onClick: () => {
 					activate(!data.active);
 				}
-			}, data.active ? "⏻ 退出学习模式" : "▶ 开始学习")), (0, react.createElement)("div", { className: "lks-body" }, (0, react.createElement)("div", { className: "lks-switch" }, ...[
+			}, data.active ? tr("active.on") : tr("active.off"))), (0, react.createElement)("div", { className: "lks-body" }, (0, react.createElement)("div", { className: "lks-switch" }, ...[
 				{
 					id: "rail",
-					label: "课程"
+					labelKey: "pane.rail"
 				},
 				{
 					id: "tutor",
-					label: "导师"
+					labelKey: "pane.tutor"
 				},
 				{
 					id: "bb",
-					label: "黑板"
+					labelKey: "pane.bb"
 				}
 			].map((p) => (0, react.createElement)("button", {
 				key: p.id,
@@ -883,10 +2021,11 @@ window.__ModuleLoader__.load({
 						sessionStorage.setItem(PANE_KEY, p.id);
 					} catch {}
 				}
-			}, p.label))), (0, react.createElement)(CourseRail, {
+			}, tr(p.labelKey)))), (0, react.createElement)(CourseRail, {
 				data,
 				activate,
 				setFocus,
+				searchLessons,
 				deleteCourse,
 				bindLessonSession,
 				send,
@@ -900,7 +2039,7 @@ window.__ModuleLoader__.load({
 			}), (0, react.createElement)(BlackboardColumn, { data })));
 		}
 		/** Left column: course management (pick/delete/search/import), lesson tree, due box. */
-		function CourseRail({ data, activate, setFocus, deleteCourse, bindLessonSession, send, ctx, currentSessionId }) {
+		function CourseRail({ data, activate, setFocus, searchLessons, deleteCourse, bindLessonSession, send, ctx, currentSessionId }) {
 			const [jumping, setJumping] = (0, react.useState)(null);
 			/** Open (or mint) the lesson's own session — the simplified thread system. */
 			const openLessonThread = (lesson) => {
@@ -910,9 +2049,9 @@ window.__ModuleLoader__.load({
 					setFocus(lesson.id).catch(reportError);
 					return;
 				}
-				if (mapped !== void 0 && ctx.sessions.binding(mapped) !== void 0) {
+				if (mapped !== void 0 && ctx.sessions.binding(sessionId(mapped)) !== void 0) {
 					setFocus(lesson.id).catch(reportError);
-					ctx.sessions.open(mapped);
+					ctx.sessions.open(sessionId(mapped));
 					return;
 				}
 				setJumping(lesson.id);
@@ -928,7 +2067,7 @@ window.__ModuleLoader__.load({
 					if (face === void 0) throw new Error("lesson session is not addressable yet");
 					const result = await face.prompt([{
 						type: "text",
-						text: `学习「${lesson.title}」:用 study_lesson 打开这一课开始学习。`
+						text: tr("prompt.lesson", { title: lesson.title })
 					}], "queue");
 					if (!result.ok) throw new Error(`lesson prompt rejected: ${result.error.code}: ${result.error.message}`);
 					await bindLessonSession(lesson.id, sessionId);
@@ -950,13 +2089,13 @@ window.__ModuleLoader__.load({
 			const reportError = (err) => {
 				setError(err instanceof Error ? err.message : String(err));
 			};
-			const body = data === null ? (0, react.createElement)("div", { className: "lks-empty" }, "加载中…") : data.courses.length === 0 ? (0, react.createElement)("div", { className: "lks-empty" }, "暂无课程", (0, react.createElement)("br"), (0, react.createElement)("button", {
+			const body = data === null ? (0, react.createElement)("div", { className: "lks-empty" }, tr("loading")) : data.courses.length === 0 ? (0, react.createElement)("div", { className: "lks-empty" }, tr("rail.empty.title"), (0, react.createElement)("br"), (0, react.createElement)("button", {
 				className: "lks-btn primary",
 				style: { margin: "10px 0" },
 				onClick: () => {
-					send("导入课程:用 study_import_github 抓取 https://github.com/microsoft/AI-For-Beginners");
+					send(tr("prompt.import", { url: "https://github.com/microsoft/AI-For-Beginners" }));
 				}
-			}, (0, react.createElement)(IconDownloadOutline16, null), "导入示例课程"), (0, react.createElement)(ImportRow, { send })) : (() => {
+			}, (0, react.createElement)(IconDownloadOutline16, null), tr("rail.empty.demo")), (0, react.createElement)(ImportRow, { send })) : (() => {
 				const courseId = data.courses.some((c) => c.courseId === selectedCourse) ? selectedCourse : data.courses[0].courseId;
 				const course = data.courses.find((c) => c.courseId === courseId);
 				return (0, react.createElement)("div", null, (0, react.createElement)("div", { className: "lks-rail-head" }, data.courses.length > 1 ? (0, react.createElement)("select", {
@@ -971,7 +2110,7 @@ window.__ModuleLoader__.load({
 					value: c.courseId
 				}, c.title))) : (0, react.createElement)("div", { className: "lks-rail-title" }, course.title), (0, react.createElement)("button", {
 					className: `lks-btn ${confirmDelete ? "primary" : "ghost"}`,
-					title: confirmDelete ? "再点一次确认删除(含全部进度与笔记)" : "删除本课程",
+					title: confirmDelete ? tr("rail.delete.title.confirm") : tr("rail.delete"),
 					onClick: () => {
 						if (!confirmDelete) {
 							setConfirmDelete(true);
@@ -982,13 +2121,16 @@ window.__ModuleLoader__.load({
 							setSelectedCourse("");
 						}, reportError);
 					}
-				}, confirmDelete ? "确认删除?" : "🗑")), (0, react.createElement)("div", { className: "lks-rail-sub" }, `${course.mastered}/${course.total} 已掌握`), (0, react.createElement)("div", {
+				}, confirmDelete ? tr("rail.delete.confirm") : "🗑")), (0, react.createElement)("div", { className: "lks-rail-sub" }, tr("rail.mastered", {
+					mastered: course.mastered,
+					total: course.total
+				})), (0, react.createElement)("div", {
 					className: `lks-masterybar${course.avgMasteryPct === 100 ? " gold" : ""}`,
-					title: course.avgMasteryPct === null ? "尚无掌握度数据" : `平均掌握度 ${course.avgMasteryPct}%`
+					title: course.avgMasteryPct === null ? tr("rail.avg.none") : tr("rail.avg", { pct: course.avgMasteryPct })
 				}, (0, react.createElement)("i", { style: { width: `${course.avgMasteryPct ?? 0}%` } })), (0, react.createElement)("input", {
 					className: "lks-search",
 					type: "search",
-					placeholder: "搜索课时…(多关键词空格分隔)",
+					placeholder: tr("rail.search"),
 					value: query,
 					onChange: (e) => {
 						setQuery(e.target.value);
@@ -1002,6 +2144,13 @@ window.__ModuleLoader__.load({
 								return;
 							}
 						}
+						searchLessons(query).then((hits) => {
+							const hit = hits.find((h) => h.lessonId.startsWith(`${courseId}:`)) ?? hits[0];
+							if (hit !== void 0) {
+								setQuery("");
+								setFocus(hit.lessonId).catch(reportError);
+							}
+						}).catch(reportError);
 					}
 				}), course.sections.some((s) => s.lessons.some((l) => l.focus)) ? (0, react.createElement)("button", {
 					className: "lks-btn ghost",
@@ -1010,7 +2159,7 @@ window.__ModuleLoader__.load({
 						padding: "3px 8px",
 						fontSize: "13px"
 					},
-					title: "在课程树中定位当前焦点课时(自动展开所在章节)",
+					title: tr("rail.locate.title"),
 					onClick: () => {
 						const focusSection = course.sections.find((s) => s.lessons.some((l) => l.focus));
 						if (focusSection === void 0) return;
@@ -1025,16 +2174,16 @@ window.__ModuleLoader__.load({
 							});
 						}, 60);
 					}
-				}, "📍 回到当前课时") : null, data.dueCount > 0 ? (0, react.createElement)("div", { className: "lks-duebox" }, `🔁 待复习 ${data.dueCount}`, ...data.due.map((d) => (0, react.createElement)("div", {
+				}, tr("rail.locate")) : null, data.dueCount > 0 ? (0, react.createElement)("div", { className: "lks-duebox" }, tr("rail.due", { count: data.dueCount }), ...data.due.map((d) => (0, react.createElement)("div", {
 					key: d.lessonId,
 					className: "lks-due-item"
-				}, (0, react.createElement)("span", null, d.lessonTitle), d.overdueDays > 0 ? (0, react.createElement)("span", { className: "lks-over" }, `超${d.overdueDays}天`) : null)), (0, react.createElement)("button", {
+				}, (0, react.createElement)("span", null, d.lessonTitle), d.overdueDays > 0 ? (0, react.createElement)("span", { className: "lks-over" }, tr("rail.due.over", { days: d.overdueDays })) : null)), (0, react.createElement)("button", {
 					className: "lks-btn ghost",
 					style: { marginTop: "6px" },
 					onClick: () => {
-						send("开始今天的复习,从最到期的课时开始");
+						send(tr("prompt.review"));
 					}
-				}, "开始复习")) : null, ...course.sections.flatMap((section) => {
+				}, tr("rail.due.start"))) : null, ...course.sections.flatMap((section) => {
 					const examAllowed = examOpen(section.lessons);
 					const lessons = section.lessons.filter((l) => query.trim() === "" || titleMatches(l.title, query) || l.focus);
 					if (lessons.length === 0) return [];
@@ -1045,45 +2194,45 @@ window.__ModuleLoader__.load({
 						type: "button",
 						className: "lks-sechead",
 						"aria-expanded": String(open),
-						title: open ? "折叠本章节" : `展开本章节(${section.lessons.length} 课时)`,
+						title: open ? tr("rail.section.collapse") : tr("rail.section.expand", { count: section.lessons.length }),
 						onClick: () => {
 							setSecOpen((m) => ({
 								...m,
 								[secKey]: !open
 							}));
 						}
-					}, (0, react.createElement)("span", { className: "lks-sec-num" }, String(section.index + 1)), (0, react.createElement)("span", { className: "lks-sechead-t" }, section.title), open ? null : (0, react.createElement)("span", { className: "lks-sechead-n" }, `${section.lessons.length} 课`), (0, react.createElement)("span", { className: "lks-sechead-c" }, open ? "▾" : "▸")), ...open ? lessons.map((lesson) => {
+					}, (0, react.createElement)("span", { className: "lks-sec-num" }, String(section.index + 1)), (0, react.createElement)("span", { className: "lks-sechead-t" }, section.title), open ? null : (0, react.createElement)("span", { className: "lks-sechead-n" }, tr("rail.section.count", { count: section.lessons.length })), (0, react.createElement)("span", { className: "lks-sechead-c" }, open ? "▾" : "▸")), ...open ? lessons.map((lesson) => {
 						const locked = lesson.status === "locked" || lesson.kind === "exam" && !examAllowed;
 						return (0, react.createElement)("button", {
 							key: lesson.id,
 							type: "button",
 							className: `lks-node${lesson.focus ? " focus" : ""}`,
 							"aria-disabled": locked || void 0,
-							title: jumping === lesson.id ? "正在打开课时会话…" : statusTitle(lesson.kind, locked ? "locked" : lesson.status),
+							title: jumping === lesson.id ? tr("rail.lesson.opening") : statusTitle(lesson.kind, locked ? "locked" : lesson.status),
 							onClick: () => {
 								if (locked) return;
 								if (lesson.kind === "exam") {
 									setFocus(lesson.id).catch(reportError);
-									send(`开始「${section.title}」的章节测验:按本节课时出题,答完逐题判分`);
+									send(tr("prompt.exam", { section: section.title }));
 									return;
 								}
 								openLessonThread(lesson);
 							}
 						}, (0, react.createElement)("span", { className: "lks-g" }, jumping === lesson.id ? "⏳" : glyph(lesson.kind, locked ? "locked" : lesson.status)), (0, react.createElement)("span", { className: "lks-t" }, lesson.title), lesson.due ? (0, react.createElement)("span", {
 							className: "lks-tag due",
-							title: "这课时的复习今天到期(SM-2)"
+							title: tr("rail.due.tag")
 						}, "🔁") : null, lesson.weakConcepts > 0 ? (0, react.createElement)("span", {
 							className: "lks-tag weak",
-							title: `${lesson.weakConcepts} 个薄弱知识点,测验会优先考察`
+							title: tr("tag.weak", { count: lesson.weakConcepts })
 						}, `⚡${lesson.weakConcepts}`) : null, lesson.frictionCount > 0 ? (0, react.createElement)("span", {
 							className: "lks-tag fric",
-							title: `${lesson.frictionCount} 次卡点记录(你说"不懂"时导师记下的)`
+							title: tr("tag.friction", { count: lesson.frictionCount })
 						}, `😣${lesson.frictionCount}`) : null, lesson.masteryPct !== null ? (0, react.createElement)("span", {
 							className: "lks-bar",
-							title: `课时掌握度 ${lesson.masteryPct}%(取最薄弱知识点)`
+							title: tr("tag.mastery", { pct: lesson.masteryPct })
 						}, (0, react.createElement)("i", { style: { width: `${lesson.masteryPct}%` } })) : null, lesson.masteryPct !== null ? (0, react.createElement)("span", {
 							className: "lks-pct",
-							title: "课时掌握度 = 最薄弱知识点的掌握度"
+							title: tr("tag.mastery.short")
 						}, `${lesson.masteryPct}%`) : null);
 					}) : []];
 				}), (0, react.createElement)("button", {
@@ -1092,9 +2241,9 @@ window.__ModuleLoader__.load({
 					onClick: () => {
 						setShowImport(!showImport);
 					}
-				}, showImport ? "收起导入" : "＋ 导入课程"), showImport ? (0, react.createElement)(ImportRow, { send }) : null);
+				}, showImport ? tr("rail.import.close") : tr("rail.import.toggle")), showImport ? (0, react.createElement)(ImportRow, { send }) : null);
 			})();
-			return (0, react.createElement)("div", { className: "lks-col lks-col-rail" }, (0, react.createElement)("div", { className: "lks-colhead" }, "课程"), body, (0, react.createElement)(ActionError, { error }));
+			return (0, react.createElement)("div", { className: "lks-col lks-col-rail" }, (0, react.createElement)("div", { className: "lks-colhead" }, tr("col.rail")), body, (0, react.createElement)(ActionError, { error }));
 		}
 		/** One transcript row's element; `interactive` adds the quiz-answer buttons to an assistant row. */
 		function chatRowElement(row, interactive) {
@@ -1120,7 +2269,7 @@ window.__ModuleLoader__.load({
 			if (row.role === "thinking") return (0, react.createElement)("div", {
 				key: row.key,
 				className: "lks-msg thinking",
-				title: "导师正在推理,回复马上就来"
+				title: tr("row.thinking.title")
 			}, (0, react.createElement)(IconLoadingOutline16, {
 				size: 14,
 				className: "lks-spin"
@@ -1138,12 +2287,15 @@ window.__ModuleLoader__.load({
 				className: "lks-turn"
 			}, body, (0, react.createElement)("div", {
 				className: "lks-quiz",
-				title: "点击选项作答,也可以直接打字回答"
+				title: tr("quiz.title")
 			}, ...options.map((opt) => (0, react.createElement)("button", {
 				key: opt.letter,
 				className: "lks-opt",
 				onClick: () => {
-					interactive.send(`选 ${opt.letter}:${opt.text}`);
+					interactive.send(tr("quiz.answer", {
+						letter: opt.letter,
+						text: opt.text
+					}));
 				}
 			}, (0, react.createElement)("span", { className: "lks-optletter" }, opt.letter), (0, react.createElement)("span", null, opt.text)))));
 		}
@@ -1157,6 +2309,10 @@ window.__ModuleLoader__.load({
 				const el = scrollRef.current;
 				if (el !== null) el.scrollTop = el.scrollHeight;
 			}, [rows.length]);
+			(0, react.useEffect)(() => {
+				const el = scrollRef.current;
+				if (el !== null && rows.length > 0) enhanceRendered(el).catch(() => {});
+			}, [rows.length]);
 			const proposal = data?.pendingProposals[0] ?? null;
 			const lesson = data?.lesson ?? null;
 			/** Mode switches are the only fallible write left here (host route); surface failures inline. */
@@ -1167,33 +2323,36 @@ window.__ModuleLoader__.load({
 					setError(err instanceof Error ? err.message : String(err));
 				});
 			};
-			return (0, react.createElement)("div", { className: "lks-col lks-col-tutor" }, (0, react.createElement)("div", { className: "lks-colhead" }, "导师"), (0, react.createElement)("div", {
+			return (0, react.createElement)("div", { className: "lks-col lks-col-tutor" }, (0, react.createElement)("div", { className: "lks-colhead" }, tr("col.tutor")), (0, react.createElement)("div", {
 				className: "lks-transcript",
 				ref: scrollRef
-			}, rows.length === 0 ? (0, react.createElement)("div", { className: "lks-empty" }, "对话会出现在这里", (0, react.createElement)("br"), "在下方输入框和导师说话") : rows.map((row, i) => chatRowElement(row, i === lastAssistant ? { send } : void 0))), proposal !== null ? (0, react.createElement)("div", { className: "lks-banner" }, (0, react.createElement)("span", null, "🎓"), (0, react.createElement)("span", { className: "lks-why" }, `导师提议你已掌握「${proposal.lessonTitle}」:${proposal.rationale}`), (0, react.createElement)("button", {
+			}, rows.length === 0 ? (0, react.createElement)("div", { className: "lks-empty" }, tr("tutor.empty"), (0, react.createElement)("br"), tr("tutor.empty.hint")) : rows.map((row, i) => chatRowElement(row, i === lastAssistant ? { send } : void 0))), proposal !== null ? (0, react.createElement)("div", { className: "lks-banner" }, (0, react.createElement)("span", null, "🎓"), (0, react.createElement)("span", { className: "lks-why" }, tr("proposal.text", {
+				lesson: proposal.lessonTitle,
+				rationale: proposal.rationale
+			})), (0, react.createElement)("button", {
 				className: "lks-btn primary",
 				onClick: () => {
-					send(`接受提案 ${proposal.id} —— 确认标记这课为已掌握`);
+					send(tr("prompt.proposal.accept", { id: proposal.id }));
 				}
-			}, "接受"), (0, react.createElement)("button", {
+			}, tr("proposal.accept")), (0, react.createElement)("button", {
 				className: "lks-btn ghost",
 				onClick: () => {
-					send(`拒绝提案 ${proposal.id} —— 我想再练练`);
+					send(tr("prompt.proposal.decline", { id: proposal.id }));
 				}
-			}, "再练练")) : null, (0, react.createElement)("div", {
+			}, tr("proposal.decline"))) : null, (0, react.createElement)("div", {
 				className: "lks-pills",
 				style: {
 					height: "auto",
 					padding: "4px 0"
 				}
-			}, ...MODES.map((mode) => (0, react.createElement)("button", {
+			}, ...MODES$1.map((mode) => (0, react.createElement)("button", {
 				key: mode.id,
 				className: `lks-pill${data?.mode === mode.id ? " on" : ""}`,
-				title: mode.hint,
+				title: tr(mode.hintKey),
 				onClick: () => {
 					fire(setMode(mode.id));
 				}
-			}, mode.label))), lesson !== null && lesson.starters.length > 0 ? (0, react.createElement)("div", {
+			}, tr(mode.labelKey)))), lesson !== null && lesson.starters.length > 0 ? (0, react.createElement)("div", {
 				className: "lks-dock",
 				style: { padding: "0 0 6px" }
 			}, ...lesson.starters.map((s) => (0, react.createElement)("button", {
@@ -1205,26 +2364,71 @@ window.__ModuleLoader__.load({
 				}
 			}, s.label))) : null, (0, react.createElement)(ActionError, { error }));
 		}
-		/** Right column: the blackboard — focus-lesson 讲解 plus the Cornell 笔记. */
+		/** Right column: the blackboard — focus-lesson 讲解/脑图/概念图 plus the Cornell 笔记. */
 		function BlackboardColumn({ data }) {
 			const lesson = data?.lesson ?? null;
-			const body = lesson === null ? (0, react.createElement)("div", { className: "lks-empty" }, "黑板还空着", (0, react.createElement)("br"), "在左侧课程树选择一课") : (0, react.createElement)("div", null, (0, react.createElement)("div", { className: "lks-lessonhead" }, (0, react.createElement)("h2", null, lesson.title), (0, react.createElement)("div", { className: "lks-meta" }, `${lesson.courseTitle} · ${lesson.status}` + (lesson.masteryPct === null ? "" : ` · 掌握度 ${lesson.masteryPct}%`) + ` · ${lesson.strategy}`), lesson.concepts.length > 0 ? (0, react.createElement)("div", { className: "lks-chips" }, ...lesson.concepts.map((c) => (0, react.createElement)("span", {
+			const [pane, setPane] = (0, react.useState)("teach");
+			const proseRef = (0, react.useRef)(null);
+			const diagRef = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				if (pane !== "teach" || proseRef.current === null || lesson === null) return;
+				const el = proseRef.current;
+				enhanceRendered(el).catch(() => {});
+			}, [pane, lesson?.html]);
+			(0, react.useEffect)(() => {
+				if (pane !== "mind" && pane !== "cmap" || diagRef.current === null || lesson === null) return;
+				const el = diagRef.current;
+				el.textContent = "";
+				(pane === "mind" ? renderMindmap(el, lesson.markdown) : lesson.concepts.length === 0 ? Promise.reject(/* @__PURE__ */ new Error("no concepts")) : renderLessonConceptMap(el, lesson.title, lesson.concepts.map((c) => ({
+					title: c.title,
+					masteryPct: c.masteryPct
+				})))).catch((err) => {
+					console.error("lks diagram pane failed:", pane, err);
+					el.textContent = pane === "mind" ? tr("bb.fallback.mind") : lesson.concepts.length === 0 ? tr("bb.fallback.cmap.empty") : tr("bb.fallback.cmap");
+				});
+			}, [
+				pane,
+				lesson?.lessonId,
+				lesson?.concepts.length
+			]);
+			const body = lesson === null ? (0, react.createElement)("div", { className: "lks-empty" }, tr("bb.empty"), (0, react.createElement)("br"), tr("bb.empty.hint")) : (0, react.createElement)("div", null, (0, react.createElement)("div", { className: "lks-lessonhead" }, (0, react.createElement)("h2", null, lesson.title), (0, react.createElement)("div", { className: "lks-meta" }, `${lesson.courseTitle} · ${lesson.status}` + (lesson.masteryPct === null ? "" : ` · ${tr("bb.mastery", { pct: lesson.masteryPct })}`) + ` · ${lesson.strategy}`), lesson.concepts.length > 0 ? (0, react.createElement)("div", { className: "lks-chips" }, ...lesson.concepts.map((c) => (0, react.createElement)("span", {
 				key: c.title,
 				className: `lks-chip${c.weak ? " weak" : ""}`
-			}, `${c.title} ${c.masteryPct}%${c.weak ? " ⚡" : ""}`))) : null), (0, react.createElement)("div", {
+			}, `${c.title} ${c.masteryPct}%${c.weak ? " ⚡" : ""}`))) : null), (0, react.createElement)("div", { className: "lks-viewtabs" }, (0, react.createElement)("button", {
+				className: `lks-viewtab${pane === "teach" ? " on" : ""}`,
+				onClick: () => {
+					setPane("teach");
+				}
+			}, tr("viewtab.teach")), (0, react.createElement)("button", {
+				className: `lks-viewtab${pane === "mind" ? " on" : ""}`,
+				title: tr("viewtab.mind.title"),
+				onClick: () => {
+					setPane("mind");
+				}
+			}, tr("viewtab.mind")), (0, react.createElement)("button", {
+				className: `lks-viewtab${pane === "cmap" ? " on" : ""}`,
+				title: tr("viewtab.cmap.title"),
+				onClick: () => {
+					setPane("cmap");
+				}
+			}, tr("viewtab.cmap"))), pane === "teach" ? (0, react.createElement)("div", {
 				className: "lks-prose",
+				ref: proseRef,
 				dangerouslySetInnerHTML: { __html: lesson.html }
-			}), (0, react.createElement)("div", { className: "lks-bb-notes" }, (0, react.createElement)("div", { className: "lks-sec" }, "笔记"), lesson.notes.length === 0 ? (0, react.createElement)("div", {
+			}) : (0, react.createElement)("div", {
+				className: "lks-prose",
+				ref: diagRef
+			}), (0, react.createElement)("div", { className: "lks-bb-notes" }, (0, react.createElement)("div", { className: "lks-sec" }, tr("bb.notes")), lesson.notes.length === 0 ? (0, react.createElement)("div", {
 				className: "lks-empty",
 				style: { padding: "16px 0" }
-			}, "这一课还没有笔记") : ZONES.filter(([zone]) => lesson.notes.some((n) => n.zone === zone)).map(([zone, label]) => (0, react.createElement)("div", {
+			}, tr("bb.notes.empty")) : ZONES.filter(([zone]) => lesson.notes.some((n) => n.zone === zone)).map(([zone, labelKey]) => (0, react.createElement)("div", {
 				key: zone,
 				className: "lks-zone"
-			}, (0, react.createElement)("h4", null, label), ...lesson.notes.filter((n) => n.zone === zone).map((n) => (0, react.createElement)("div", {
+			}, (0, react.createElement)("h4", null, tr(labelKey)), ...lesson.notes.filter((n) => n.zone === zone).map((n) => (0, react.createElement)("div", {
 				key: n.id,
 				className: "lks-note"
 			}, (0, react.createElement)("span", { className: "lks-note-src" }, n.source), (0, react.createElement)("div", { className: "lks-note-title" }, n.title), (0, react.createElement)("div", { className: "lks-note-text" }, n.text), n.quote !== null ? (0, react.createElement)("div", { className: "lks-note-q" }, `“${n.quote}”`) : null))))));
-			return (0, react.createElement)("div", { className: "lks-col lks-col-bb" }, (0, react.createElement)("div", { className: "lks-colhead" }, "黑板"), body);
+			return (0, react.createElement)("div", { className: "lks-col lks-col-bb" }, (0, react.createElement)("div", { className: "lks-colhead" }, tr("col.bb")), body);
 		}
 		//#endregion
 		//#region src/client/starter.tsx
@@ -1238,8 +2442,6 @@ window.__ModuleLoader__.load({
 		* not reachable from an additive plugin).
 		* @module dsh-plugin-lookatstudy/client/starter
 		*/
-		/** The kickoff prompt: starts the tutoring loop and points at the study tab. */
-		const KICKOFF = "开始学习:查看我的学习状态并打开当前焦点课时。如果我还没有课程,推荐我导入示例课程(AI-For-Beginners)并说明怎么开始。回复最后请提醒我点上方「学习」页签进入学习界面。";
 		/**
 		* Build the hero starter button bound to the framework services.
 		* @param ctx - client root context (workspaces + sessions injected).
@@ -1276,7 +2478,7 @@ window.__ModuleLoader__.load({
 						if (face === void 0) throw new Error("study session is not addressable yet");
 						const result = await face.prompt([{
 							type: "text",
-							text: KICKOFF
+							text: tr("prompt.kickoff")
 						}], "queue");
 						if (!result.ok) throw new Error(`kickoff prompt rejected: ${result.error.code}: ${result.error.message}`);
 						ctx.sessions.open(sessionId);
@@ -1295,41 +2497,259 @@ window.__ModuleLoader__.load({
 				}
 			}, (0, react.createElement)("button", {
 				className: "lks-pill on",
-				title: "一键准备学习:建立学习工作区、开启会话并让导师就位",
+				title: tr("start.title"),
 				disabled: busy,
 				onClick: start
-			}, busy ? (0, react.createElement)(IconLoadingOutline16, { className: "lks-spin" }) : (0, react.createElement)(IconThinkOutline16, null), busy ? "正在准备学习区…" : data?.active === true ? "进入学习" : "开始学习"), error !== null ? (0, react.createElement)("span", {
+			}, busy ? (0, react.createElement)(IconLoadingOutline16, { className: "lks-spin" }) : (0, react.createElement)(IconThinkOutline16, null), busy ? tr("start.busy") : data?.active === true ? tr("start.enter") : tr("start.go")), error !== null ? (0, react.createElement)("span", {
 				className: "lks-propcard-err",
 				style: { marginTop: 0 }
 			}, error) : null);
 		}
 		//#endregion
+		//#region src/client/settings.tsx
+		/**
+		* The plugin's settings page: one `settings.section` entry riding the host's
+		* settings shell. Teaching style and study mode write through the same host
+		* routes the study tab uses (POST /api/mode, /api/active — the latter syncs
+		* the tool registry before responding); stats and the state-file path are
+		* read-only projections of the shared poll store. Pure display + the store's
+		* existing write actions; no new routes, no new requests beyond the poll.
+		* @module dsh-plugin-lookatstudy/client/settings
+		*/
+		/** The three souls in pill order (same shape as the study tab's pills). */
+		const MODES = [
+			{
+				id: "direct",
+				labelKey: "soul.direct",
+				hintKey: "soul.direct.hint"
+			},
+			{
+				id: "guide",
+				labelKey: "soul.guide",
+				hintKey: "soul.guide.hint"
+			},
+			{
+				id: "practice",
+				labelKey: "soul.practice",
+				hintKey: "soul.practice.hint"
+			}
+		];
+		/**
+		* The settings section component. Props from the settings shell (`close`) are
+		* unused — every control stays on the page.
+		*/
+		function StudySettingsSection() {
+			const { data, setMode, activate } = useStudy();
+			const [error, setError] = (0, react.useState)(null);
+			const fire = (action) => {
+				action.then(() => {
+					setError(null);
+				}, (err) => {
+					setError(err instanceof Error ? err.message : String(err));
+				});
+			};
+			const progress = data?.progress;
+			return (0, react.createElement)("div", { className: "lks-root lks-settings" }, (0, react.createElement)("section", { className: "lks-set-row" }, (0, react.createElement)("h3", null, tr("settings.mode")), (0, react.createElement)("p", { className: "lks-set-hint" }, tr("settings.mode.hint")), (0, react.createElement)("div", { className: "lks-pills" }, ...MODES.map((mode) => (0, react.createElement)("button", {
+				key: mode.id,
+				className: `lks-pill${data?.mode === mode.id ? " on" : ""}`,
+				title: tr(mode.hintKey),
+				onClick: () => {
+					fire(setMode(mode.id));
+				}
+			}, tr(mode.labelKey))))), (0, react.createElement)("section", { className: "lks-set-row" }, (0, react.createElement)("h3", null, tr("settings.studyMode")), (0, react.createElement)("p", { className: "lks-set-hint" }, tr("settings.studyMode.hint")), (0, react.createElement)("div", null, (0, react.createElement)("button", {
+				className: `lks-btn ${data?.active === true ? "ghost" : "primary"}`,
+				onClick: () => {
+					if (data !== null) fire(activate(!data.active));
+				}
+			}, data?.active === true ? tr("settings.turnOff") : tr("settings.turnOn")), (0, react.createElement)("span", { className: "lks-set-state" }, data?.active === true ? tr("settings.on") : tr("settings.off")))), progress === void 0 ? null : (0, react.createElement)("section", { className: "lks-set-row" }, (0, react.createElement)("h3", null, tr("settings.stats")), (0, react.createElement)("ul", { className: "lks-set-stats" }, (0, react.createElement)("li", null, tr("settings.stats.courses", { count: data?.courses.length ?? 0 })), (0, react.createElement)("li", null, tr("settings.stats.xp", {
+				xp: progress.totalXp,
+				level: progress.level,
+				pct: progress.levelPct
+			})), (0, react.createElement)("li", null, tr("settings.stats.today", {
+				xp: progress.todayXp,
+				goal: progress.dailyGoal
+			})), (0, react.createElement)("li", null, tr("settings.stats.streak", {
+				days: progress.streak,
+				best: progress.longestStreak,
+				freeze: progress.freezeCount
+			})))), (0, react.createElement)("section", { className: "lks-set-row" }, (0, react.createElement)("h3", null, tr("settings.stateFile")), (0, react.createElement)("p", { className: "lks-set-hint" }, tr("settings.stateFile.hint")), data === null ? null : (0, react.createElement)("code", { className: "lks-set-path" }, data.statePath)), (0, react.createElement)(ActionError, { error }));
+		}
+		//#endregion
+		//#region src/client/dock.tsx
+		/**
+		* The composer dock status pill: one `conversation.composer.dock` entry (the
+		* ambient readout band under the composer, next to the token stats) showing
+		* due reviews / streak / level while the study surface is ACTIVE — dormant
+		* installs render nothing at all, the same visibility the tool registry has.
+		* Data rides the shared 3 s poll store (no extra requests). Display-only:
+		* conversation-view tab switching is ui-conversation-private (the starter
+		* button's limitation), so the tooltip points at the Study tab instead.
+		* @module dsh-plugin-lookatstudy/client/dock
+		*/
+		/** Pure projection of the pill's segments (testable without React). */
+		function dockSegments(progress) {
+			return [
+				{
+					key: "due",
+					text: tr("dock.due", { count: progress.dueCount })
+				},
+				{
+					key: "streak",
+					text: tr("dock.streak", { days: progress.streak })
+				},
+				{
+					key: "lv",
+					text: tr("dock.lv", { level: progress.level })
+				}
+			];
+		}
+		/** The dock entry component; renders nothing while data is loading or dormant. */
+		function StudyDockPill() {
+			const { data } = useStudy();
+			if (data === null || data.active !== true) return null;
+			const segments = dockSegments({
+				dueCount: data.dueCount,
+				streak: data.progress.streak,
+				level: data.progress.level
+			});
+			return (0, react.createElement)("span", {
+				className: "lks-root lks-dockpill",
+				title: tr("dock.title", {
+					due: data.dueCount,
+					streak: data.progress.streak,
+					level: data.progress.level
+				})
+			}, ...segments.map((s) => (0, react.createElement)("span", {
+				key: s.key,
+				className: `lks-dockseg lks-dock-${s.key}`
+			}, s.text)));
+		}
+		//#endregion
+		//#region src/client/toolviews.tsx
+		/**
+		* Keyed `tool.call.toolview` entries: learning-aware cards for the
+		* conversation tab's tool rows (our own study tab renders its own chips, but
+		* learning also happens in the plain 对话 view). One generic card body over
+		* the result's `meta` (the tool's presentationMeta lines — replay-safe by
+		* construction) with a per-tool header; `study_record_answer` additionally
+		* parses its args for a live ✓/✗ tone while the call is still running.
+		* @module dsh-plugin-lookatstudy/client/toolviews
+		*/
+		/** Header glyph per tool (missing tools simply use the generic row). */
+		const TOOL_GLYPHS = {
+			study_record_answer: "✍️",
+			study_lesson: "📘",
+			study_due_reviews: "🔁",
+			study_exam_result: "🎯"
+		};
+		/** The ✓/✗ tone from record_answer's args; null for other shapes. Pure. */
+		function answerTone(argsRaw) {
+			if (argsRaw === void 0) return null;
+			try {
+				const args = JSON.parse(argsRaw);
+				return {
+					correct: args.correct === true,
+					concept: typeof args.concept === "string" && args.concept !== "" ? args.concept : tr("chip.unattributed")
+				};
+			} catch {
+				return null;
+			}
+		}
+		/** Card lines: the result's meta (string[]) when present, else its text content. Pure. */
+		function metaLines(block) {
+			if (Array.isArray(block.meta)) {
+				const lines = block.meta.filter((x) => typeof x === "string");
+				if (lines.length > 0) return lines;
+			}
+			return (block.content ?? []).filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text.split("\n")).flat().filter((l) => l.trim() !== "");
+		}
+		/** Shared card body: header + lines; error results keep their text visible. */
+		function studyToolCard(toolName, block, extra) {
+			const lines = metaLines(block);
+			const glyph = TOOL_GLYPHS[toolName] ?? "🔧";
+			return (0, react.createElement)("div", { className: `lks-tv${block.isError === true ? " err" : ""}` }, extra ?? null, (0, react.createElement)("span", { className: "lks-tv-head" }, `${glyph} ${toolName}`), lines.length === 0 ? null : (0, react.createElement)("div", { className: "lks-tv-lines" }, ...lines.map((line, i) => (0, react.createElement)("div", {
+				key: String(i),
+				className: "lks-tv-line"
+			}, line))));
+		}
+		/** study_record_answer: live ✓/✗ tone from args + the graded line from meta. */
+		function StudyAnswerView({ toolName, block }) {
+			const tone = answerTone(block.argsRaw);
+			return studyToolCard(toolName, block, tone === null ? null : (0, react.createElement)("span", { className: `lks-tv-chip ${tone.correct ? "ok" : "bad"}` }, tr(tone.correct ? "chip.correct" : "chip.wrong", { concept: tone.concept })));
+		}
+		/** Generic meta-line card for the read-type study tools. */
+		function StudyLessonView({ toolName, block }) {
+			return studyToolCard(toolName, block);
+		}
+		/** study_due_reviews list card. */
+		function StudyDueView({ toolName, block }) {
+			return studyToolCard(toolName, block);
+		}
+		/** study_exam_result star card. */
+		function StudyExamView({ toolName, block }) {
+			return studyToolCard(toolName, block);
+		}
+		//#endregion
 		//#region src/client/index.ts
 		const inject = [
 			"slots",
 			"workspaces",
-			"sessions"
+			"sessions",
+			"locale"
 		];
 		/**
 		* Register the study surfaces: styles inject once; the single
 		* `conversation.view` tab carries the whole plugin; the hero starter button
 		* (`conversation.input.left`, blank sessions only) automates the onboarding —
-		* study workspace + session + kickoff prompt in one click.
+		* study workspace + session + kickoff prompt in one click. The `lookatstudy`
+		* locale namespace rides the framework locale service (zh/en) and the
+		* client-wide translator is installed before any component renders; both
+		* slot entries declare the namespace so the framework synthesizes their `t`
+		* seat and follows locale switches for the labels.
 		* @param ctx - client root context.
 		*/
 		function apply(ctx) {
 			ensureStudyStyles();
+			const localeSvc = ctx.locale;
+			ctx.effect(() => registerStudyLocale(localeSvc), "lookatstudy.locale()");
+			setStudyTranslator(studyTranslator(localeSvc));
 			ctx.slots.inject("conversation.view", () => ctx.slots.register({
 				name: "conversation.view",
 				id: "lookatstudy-study",
 				order: 15,
-				label: "学习"
+				label: () => tr("tab.label"),
+				locale: "lookatstudy"
 			}, studyView(ctx)));
 			ctx.slots.inject("conversation.input.left", () => ctx.slots.register({
 				name: "conversation.input.left",
 				id: "lookatstudy-start",
-				order: 10
+				order: 10,
+				locale: "lookatstudy"
 			}, studyStartButton(ctx)));
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: "lookatstudy",
+				order: 30,
+				label: () => tr("settings.nav"),
+				locale: "lookatstudy"
+			}, StudySettingsSection));
+			ctx.slots.inject("conversation.composer.dock", () => ctx.slots.register({
+				name: "conversation.composer.dock",
+				id: "lookatstudy-status",
+				order: 10,
+				locale: "lookatstudy"
+			}, StudyDockPill));
+			const toolviews = [
+				["study_record_answer", StudyAnswerView],
+				["study_lesson", StudyLessonView],
+				["study_due_reviews", StudyDueView],
+				["study_exam_result", StudyExamView]
+			];
+			for (const [tool, component] of toolviews) ctx.slots.inject("tool.call.toolview", () => ctx.slots.register({
+				name: "tool.call.toolview",
+				key: tool,
+				locale: "lookatstudy"
+			}, component));
 		}
 		//#endregion
 		exports.apply = apply;