dsh-plugin-lookatstudy 0.22.2 → 0.24.0

package/lib/client.js

@@ -156,6 +156,7 @@ window.__ModuleLoader__.load({
 .lks-ui .lks14-viewtab:hover{color:var(--ink)}
 .lks-ui .lks14-viewtab.on{background:rgb(var(--brand-rgb)/0.16);color:var(--brand)}
 .lks-ui .lks14-prose{color:var(--ink);font-size:.9375rem;line-height:1.65}
+.lks-ui .lks14-prose img{max-width:100%;height:auto}
 .lks-ui .lks14-prose h1,.lks-ui .lks-note-text h1{font-size:1.25rem;font-weight:800;color:var(--ink-strong)}
 .lks-ui .lks14-prose h2,.lks-ui .lks-note-text h2{font-size:1.1rem;font-weight:700;color:var(--ink-strong);border-bottom:1px solid var(--border);padding-bottom:.3em}
 .lks-ui .lks14-prose h3,.lks-ui .lks-note-text h3{font-size:1rem;font-weight:700;color:var(--ink)}
@@ -434,9 +435,27 @@ window.__ModuleLoader__.load({
 
 /* ══════════ P11b (C-track closure): chat parts, notes closure, tooltip, confirm ══════════ */
 /* C14: the collapsible reasoning block */
+/* 0.24.0: the host-style thinking disclosure (ReasoningRow port) — running
+   rows stream the latest line follow-end with the sweep, settled rows lead
+   with the first line, the expanded body reads the tertiary tier */
 .lks-ui .lks14-reasoning{border:1px solid var(--border-faint);border-radius:10px;padding:4px 10px;font-size:12px;color:var(--ink-faint)}
 .lks-ui .lks14-reasoning summary{cursor:pointer;font-weight:600;color:var(--ink-muted);user-select:none}
 .lks-ui .lks14-reasoning[open] summary{margin-bottom:4px}
+.lks-ui .lks14-reasoning-row{display:flex;align-items:center;gap:6px;min-width:0;position:relative;overflow:hidden}
+.lks-ui .lks14-reasoning-title{flex:none;font-weight:400;color:var(--ink-muted)}
+.lks-ui .lks14-reasoning-sep{flex:none;width:2px;height:2px;margin:0 4px;border-radius:1px;background:var(--ink-faint)}
+.lks-ui .lks14-reasoning-summary{min-width:0;overflow:hidden;flex:1 1 auto;color:var(--ink-faint);white-space:nowrap}
+.lks-ui .lks14-reasoning-sumtext{display:block;overflow:hidden;text-overflow:ellipsis}
+.lks-ui .lks14-reasoning-summary[data-follow-end]{display:flex;justify-content:flex-end}
+.lks-ui .lks14-reasoning-summary[data-follow-end] .lks14-reasoning-sumtext{flex:0 0 auto;width:max-content;min-width:100%;overflow:visible;text-align:start;text-overflow:clip}
+.lks-ui .lks14-reasoning[data-state='running'] .lks14-reasoning-row::after{content:'';position:absolute;inset-block:0;left:0;width:180px;background:linear-gradient(90deg,transparent 0%,rgb(var(--surface-2-rgb)/0.9) 55%,transparent 100%);animation:lks-reasoning-sweep 2.6s ease-out infinite;pointer-events:none}
+@keyframes lks-reasoning-sweep{0%{left:-180px}90%,100%{left:100%}}
+@media (prefers-reduced-motion: reduce){.lks-ui .lks14-reasoning[data-state='running'] .lks14-reasoning-row::after{animation:none}}
+.lks-ui .lks14-reasoning.open .lks14-reasoning-body,.lks-ui .lks14-reasoning[open] .lks14-reasoning-body{padding:4px 0 4px 20px;color:var(--ink-faint);white-space:pre-wrap;word-break:break-word}
+/* 0.24.0: the teach-tab 原文/对照/译文 segmented control */
+.lks-ui .lks-langview{display:inline-flex;gap:2px;padding:2px;border:1px solid var(--border-faint);border-radius:8px;background:rgb(var(--surface-2-rgb)/0.6)}
+.lks-ui .lks-langview button{border:0;background:transparent;color:var(--ink-muted);font-size:12px;line-height:1;padding:4px 8px;border-radius:6px;cursor:pointer}
+.lks-ui .lks-langview button.on{background:rgb(var(--brand-rgb)/0.16);color:var(--brand)}
 /* C14: the tool-call chip states */
 .lks-ui .lks14-toolchip{display:inline-flex;align-items:center;gap:6px;align-self:flex-start;font-size:12px;font-weight:600;
   padding:3px 10px;border-radius:999px;background:rgb(var(--ink-rgb)/0.05);color:var(--ink-muted)}
@@ -787,7 +806,31 @@ window.__ModuleLoader__.load({
 .lks-ui .lks14-threadmenu-row.on{background:rgb(var(--brand-rgb)/0.1)}
 .lks-ui .lks14-threadmenu-row.on .lks14-threadmenu-title{color:var(--brand);font-weight:700}
 .lks-ui .lks14-threadmenu-dot{flex:none;width:6px;height:6px;border-radius:999px;background:var(--ink-faint)}
-.lks-ui .lks14-threadmenu-row.new{margin-top:3px;border-top:1px solid var(--border-faint);border-radius:0 0 7px 7px;padding-top:7px}
+/* 0.23.0 course scope: the coverage line under a course thread's title, and
+   the granularity toggle row pinned above the ＋新建 row */
+.lks-ui .lks14-threadmenu-title{display:flex;flex-direction:column;gap:1px;min-width:0;flex:1}
+.lks-ui .lks14-threadmenu-cover{font-size:10.5px;color:var(--ink-muted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.lks-ui .lks14-threadmenu-row.scope{margin-top:3px;border-top:1px solid var(--border-faint);border-radius:0;padding-top:7px}
+.lks-ui .lks14-threadmenu-scope-icon{flex:none;font-size:12px;line-height:1}
+.lks-ui .lks14-threadmenu-scope-state{flex:none;margin-left:auto;font-size:10.5px;font-weight:700;color:var(--ink-faint);padding:1px 7px;border-radius:999px;border:1px solid var(--border)}
+.lks-ui .lks14-threadmenu-scope-state.on{color:var(--brand);border-color:rgb(var(--brand-rgb)/0.45);background:rgb(var(--brand-rgb)/0.08)}
+.lks-ui .lks14-threadmenu-row.new{margin-top:1px;border-top:1px solid var(--border-faint);border-radius:0 0 7px 7px;padding-top:7px}
+/* 0.23.0: the ask_user_question answer row — the panel's own answer UI for
+   the host's pending clarifying question (the hidden host column used to be
+   the only place its options lived) */
+.lks-ui .lks14-askrow{display:flex;flex-direction:column;gap:8px;padding:12px 14px;border:1px solid rgb(var(--brand-rgb)/0.35);border-radius:12px;background:rgb(var(--brand-rgb)/0.05)}
+.lks-ui .lks14-askrow.answered{opacity:.62;border-color:var(--border-faint);background:none}
+.lks-ui .lks14-askhead{font-size:12px;font-weight:800;color:var(--brand)}
+.lks-ui .lks14-askrow.answered .lks14-askhead{color:var(--ink-muted)}
+.lks-ui .lks14-askq{display:flex;flex-direction:column;gap:6px}
+.lks-ui .lks14-askq-h{font-size:13px;font-weight:700;color:var(--ink)}
+.lks-ui .lks14-askopt{display:flex;flex-direction:column;gap:2px;align-items:flex-start;padding:8px 12px;border:1px solid var(--border);border-radius:9px;background:var(--surface-0);cursor:pointer;text-align:left;font:inherit}
+.lks-ui .lks14-askopt:hover:not(:disabled){border-color:rgb(var(--brand-rgb)/0.55);background:rgb(var(--brand-rgb)/0.07)}
+.lks-ui .lks14-askopt:disabled{cursor:default;opacity:.75}
+.lks-ui .lks14-askopt-label{font-size:12.5px;font-weight:600;color:var(--ink)}
+.lks-ui .lks14-askopt-desc{font-size:11px;color:var(--ink-muted);line-height:1.5}
+.lks-ui .lks14-askfree{font-size:12px;color:var(--ink-muted)}
+.lks-ui .lks14-askdone{font-size:11px;color:var(--ink-faint)}
 .lks-ui .lks14-threadmenu-row{position:relative}
 .lks-ui .lks14-threadmenu-gear{flex:none;margin-left:auto;border:none;background:none;color:var(--ink-faint);font-size:13px;line-height:1;cursor:pointer;padding:2px 5px;border-radius:5px;opacity:0;transition:opacity .12s,color .12s}
 .lks-ui .lks14-threadmenu-row:hover .lks14-threadmenu-gear,.lks-ui .lks14-threadmenu-gear:focus-visible{opacity:1}
@@ -1778,6 +1821,16 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				});
 				this.refresh();
 			}
+			/** 0.24.0: push the host interface language (the panel reads <html lang>,
+			*  which the host keeps in sync with the active locale) — the apply-side
+			*  translation matching consumes it. */
+			async setInterfaceLang(lang) {
+				await fetchJson("/lookatstudy/api/prefs", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({ interfaceLang: lang })
+				});
+			}
 			/** E3: land one attachment verbatim in the study workspace; returns the workspace-relative path. */
 			async uploadAttachment(name, dataBase64) {
 				const body = await fetchJson("/lookatstudy/api/attachment", {
@@ -1850,6 +1903,19 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				this.refresh();
 				return res;
 			}
+			/** Flip a course's thread granularity (0.23.0, issue #11 follow-up). Never
+			*  touches sediment — both sides' groups stay and are resumed on flip. */
+			async setCourseScope(courseId, scope) {
+				await fetchJson("/lookatstudy/api/course-scope", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({
+						courseId,
+						scope
+					})
+				});
+				this.refresh();
+			}
 			/** Delete one course (and its proposals) from the host state. */
 			async deleteCourse(courseId) {
 				await fetchJson("/lookatstudy/api/course/delete", {
@@ -2047,10 +2113,12 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				activate: studyStore.activate.bind(studyStore),
 				setMode: studyStore.setMode.bind(studyStore),
 				setHistoryBudget: studyStore.setHistoryBudget.bind(studyStore),
+				setInterfaceLang: studyStore.setInterfaceLang.bind(studyStore),
 				uploadAttachment: studyStore.uploadAttachment.bind(studyStore),
 				setFocus: studyStore.setFocus.bind(studyStore),
 				searchLessons: studyStore.searchLessons.bind(studyStore),
 				tts: studyStore.tts.bind(studyStore),
+				setCourseScope: studyStore.setCourseScope.bind(studyStore),
 				deleteCourse: studyStore.deleteCourse.bind(studyStore),
 				deleteNote: studyStore.deleteNote.bind(studyStore),
 				editNote: studyStore.editNote.bind(studyStore),
@@ -2255,6 +2323,13 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			"review.banner": "正在复习：{lesson}",
 			"review.threadTitle": "复习：{lesson}",
 			"threads.label": "课时线程",
+			"threads.scope": "跨课时连续对话",
+			"threads.scope.on": "已开启",
+			"threads.scope.off": "未开启",
+			"threads.coverage": "覆盖",
+			"ask.title": "导师想先确认一下",
+			"ask.free": "在下方输入框直接回复即可",
+			"ask.answered": "已回答",
 			"meter.label": "上下文用量",
 			"meter.aria": "上下文已用 {pct}%",
 			"meter.brk.system": "系统提示",
@@ -2283,6 +2358,10 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			"rail.due.start": "开始复习",
 			"rail.due.none": "暂时没有到期的复习，保持节奏！",
 			"chat.reasoning": "思考过程（{n} 字）",
+			"chat.think": "思考",
+			"langview.original": "原文",
+			"langview.bilingual": "对照",
+			"langview.translation": "译文",
 			"msg.speak": "朗读",
 			"note.pin": "置顶笔记",
 			"note.unpin": "取消置顶",
@@ -2603,6 +2682,13 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			"palette.kind.action": "Action",
 			"palette.empty": "No matches",
 			"threads.label": "Lesson threads",
+			"threads.scope": "Continuous course thread",
+			"threads.scope.on": "on",
+			"threads.scope.off": "off",
+			"threads.coverage": "covers",
+			"ask.title": "The tutor wants a quick confirm",
+			"ask.free": "Answer in the composer below",
+			"ask.answered": "answered",
 			"threads.open": "{n} threads",
 			"threads.now": "current",
 			"threads.new": "New thread (your next message starts it)",
@@ -2643,6 +2729,10 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			"rail.due.start": "Start reviewing",
 			"rail.due.none": "Nothing due right now — keep the streak!",
 			"chat.reasoning": "Thinking ({n} chars)",
+			"chat.think": "Think",
+			"langview.original": "Original",
+			"langview.bilingual": "Both",
+			"langview.translation": "Translation",
 			"msg.speak": "Speak",
 			"note.pin": "Pin note",
 			"note.unpin": "Unpin",
@@ -2998,6 +3088,13 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			return out.join("\n");
 		}
 		//#endregion
+		//#region src/thread-key.ts
+		/** Resolve the thread-group map key for a send from `lessonId`. Absent scope
+		*  is legacy lesson behavior — old files never move. */
+		function threadOwnerKey(scope, courseId, lessonId) {
+			return scope === "course" ? `course:${courseId}` : lessonId;
+		}
+		//#endregion
 		//#region src/vendor/mermaid-elk-rewrite.ts
 		/**
 		* mermaid-elk-rewrite —— flowchart → flowchart-elk 前缀改写(v0.21 纯函数)。
@@ -3634,6 +3731,22 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			return (0, react.createElement)("div", { className: "lks-propcard-err" }, error);
 		}
 		/**
+		* The thinking disclosure's collapsed one-line summary (0.24.0, the host
+		* ReasoningRow contract verbatim): while RUNNING the LAST line rides (the
+		* summary visibly follows the stream's tail), settled the FIRST line leads;
+		* double-asterisk markers are omitted either way. Pure.
+		*/
+		function reasoningSummaryLine(text, running) {
+			return (running ? (() => {
+				const v = text.trimEnd();
+				const nl = v.lastIndexOf("\n");
+				return nl === -1 ? v : v.slice(nl + 1);
+			})() : (() => {
+				const nl = text.indexOf("\n");
+				return nl === -1 ? text : text.slice(0, nl);
+			})()).replaceAll("**", "");
+		}
+		/**
 		* Tooltip text for one course-tree status glyph. Pure (the translator is an
 		* optional parameter defaulting to the active one, evaluated per call).
 		*/
@@ -3751,10 +3864,26 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			return group.threads.filter((t) => t.status !== "archived").slice().sort((a, b) => a.lastAt < b.lastAt ? 1 : -1).map((t) => ({
 				id: t.id,
 				title: t.title,
-				current: t.id === group.active
+				current: t.id === group.active,
+				touchedLessons: t.touchedLessons
 			}));
 		}
 		/**
+		* 0.23.0 course scope: the coverage label under a course-scoped thread — the
+		* lessons it has been sent from, by section order, capped at three titles
+		* with an 等 N 课时 tail. Empty/undefined coverage renders '' (lesson-scoped
+		* threads show nothing). Pure.
+		*/
+		function threadCoverageLabel(touched, courses) {
+			if (touched === void 0 || touched.length === 0) return "";
+			const titleOf = /* @__PURE__ */ new Map();
+			for (const c of courses) for (const s of c.sections) for (const l of s.lessons) titleOf.set(l.id, l.title);
+			const titles = touched.map((id) => titleOf.get(id)).filter((t) => t !== void 0);
+			if (titles.length === 0) return "";
+			const head = titles.slice(0, 3).join(" · ");
+			return titles.length > 3 ? `${head} 等 ${String(titles.length)} 课时` : head;
+		}
+		/**
 		* Default expansion for one rail section: collapsed when every study lesson is
 		* done (mastered) or not yet reachable (locked). The focus lesson's section
 		* stays open; exam nodes never force a section open. Pure.
@@ -4680,6 +4809,27 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 		*/
 		const TURN_STALL_MS = 24e4;
 		/**
+		* 0.23.1 issue 3: how long an import funnel may sit with NO live turn before
+		* the panel reads the import as failed. The old failure exit armed on the
+		* turnActive prop having rendered true once — but a turn that dies inside one
+		* event-window notification batch (turn/start + turn/end between two reads,
+		* the keyless-provider fast fail; journal-verified: attempt → step/end →
+		* turn/end within seconds) never flips the prop, so the exit never armed and
+		* the funnel spun forever. This deadline needs no observation: past grace
+		* with the turn not active = failed. The grace only covers prompt queue
+		* latency (turn/start journals within seconds of the queue-time resolve); a
+		* live turn holds the funnel open for its whole life however long the import
+		* tools run.
+		*/
+		const IMPORT_FAIL_GRACE_MS = 3e4;
+		/**
+		* The funnel's failure decision (pure — the wall clock lives at the poll call
+		* site, mirroring {@link turnStalled}).
+		*/
+		function importJobDead(job, turnActive, now, grace = IMPORT_FAIL_GRACE_MS) {
+			return job !== null && !turnActive && now - job.startedAt > grace;
+		}
+		/**
 		* The stall decision (pure — the wall clock lives at the poll call site):
 		* an ACTIVE fold stays active while the window's top seq keeps advancing;
 		* once it has been frozen for longer than stallMs the panel treats the turn
@@ -4873,8 +5023,20 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 						});
 					} else if (event.type === "tool/call") {
 						const name = event.data?.tool?.name ?? event.data?.name ?? "tool";
+						const callId = event.data?.callId ?? event.data?.toolCallId;
+						if (name === "ask_user_question") {
+							const ask = parseAskArguments(event.data?.arguments, callId ?? String(event.seq));
+							rows.push({
+								key: `t${String(callId ?? event.seq)}`,
+								role: "ask",
+								text: ask.summary,
+								toolState: "loading",
+								ask
+							});
+							continue;
+						}
 						rows.push({
-							key: `t${event.data?.callId ?? event.data?.toolCallId ?? event.seq}`,
+							key: `t${String(callId ?? event.seq)}`,
 							role: "tool",
 							text: name,
 							toolState: "loading"
@@ -4882,13 +5044,17 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					} else if (event.type === "tool/result") {
 						const rid = event.data?.message?.source?.callId ?? event.data?.callId ?? event.data?.toolCallId;
 						if (rid !== void 0) {
-							const idx = rows.findIndex((r) => r.key === `t${rid}` && r.role === "tool");
+							const idx = rows.findIndex((r) => r.key === `t${rid}` && (r.role === "tool" || r.role === "ask"));
 							if (idx >= 0) {
 								const failed = event.data?.message?.isError === true || event.data?.error !== void 0;
 								rows[idx] = {
 									...rows[idx],
 									toolState: failed ? "error" : "done",
-									resultText: failed ? void 0 : resultRenderedText(event)
+									resultText: failed ? void 0 : resultRenderedText(event),
+									...rows[idx].role === "ask" && rows[idx].ask !== void 0 && !failed ? { ask: {
+										...rows[idx].ask,
+										answered: true
+									} } : {}
 								};
 							}
 						}
@@ -4897,17 +5063,32 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					continue;
 				}
 				const chunk = event.data?.chunk;
-				if (chunk === void 0 || chunk.type !== "text-delta") continue;
+				if (chunk === void 0 || chunk.type !== "text-delta" && chunk.type !== "reasoning-delta") continue;
 				const attemptId = event.data?.attemptId ?? String(event.seq);
+				const delta = chunk.text ?? "";
 				const stream = streams.get(attemptId);
 				if (stream === void 0) streams.set(attemptId, {
-					text: chunk.text ?? "",
+					text: chunk.type === "text-delta" ? delta : "",
+					reasoning: chunk.type === "reasoning-delta" ? delta : "",
 					anchor: rows.length,
 					settled: false
 				});
-				else stream.text += chunk.text ?? "";
+				else if (chunk.type === "text-delta") stream.text += delta;
+				else stream.reasoning += delta;
 				latest = attemptId;
 			}
+			let askOpen = false;
+			for (let i = rows.length - 1; i >= 0; i--) {
+				const r = rows[i];
+				if (r.role === "user") askOpen = true;
+				else if (r.role === "ask" && r.ask !== void 0 && askOpen && !r.ask.answered) rows[i] = {
+					...r,
+					ask: {
+						...r.ask,
+						answered: true
+					}
+				};
+			}
 			const stream = latest !== void 0 ? streams.get(latest) : void 0;
 			if (stream !== void 0 && !stream.settled) {
 				const text = stream.text.trim();
@@ -4916,9 +5097,70 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					role: "streaming",
 					text
 				});
+				const reasoning = stream.reasoning.trim();
+				if (reasoning !== "") rows.splice(stream.anchor, 0, {
+					key: "streaming-reasoning",
+					role: "reasoning",
+					text: reasoning,
+					running: true
+				});
 			}
 			return rows;
 		}
+		/**
+		* Parse an ask_user_question call's arguments into the answerable row payload
+		* (0.23.0). The live journal carries a JSON STRING (verified against real
+		* journals 2026-09-14: {questions:[{header,id,multi_select,options:[{label,
+		* description}]}]}); tolerate an already-parsed object arm for robustness.
+		* Unparseable shapes degrade to a header-only row (the composer still answers
+		* in free text). Pure.
+		*/
+		function parseAskArguments(raw, callId) {
+			const empty = {
+				callId,
+				summary: "",
+				questions: [],
+				answered: false
+			};
+			if (raw === void 0 || raw === "") return empty;
+			let parsed;
+			try {
+				parsed = JSON.parse(raw);
+			} catch {
+				return empty;
+			}
+			if (typeof parsed !== "object" || parsed === null || !Array.isArray(parsed.questions)) return empty;
+			const questions = [];
+			for (const q of parsed.questions) {
+				if (typeof q !== "object" || q === null) continue;
+				const rec = q;
+				const id = typeof rec.id === "string" ? rec.id : String(questions.length);
+				const header = typeof rec.header === "string" && rec.header !== "" ? rec.header : typeof rec.question === "string" ? rec.question : "";
+				const multiSelect = rec.multi_select === true;
+				const options = [];
+				if (Array.isArray(rec.options)) for (const o of rec.options) {
+					if (typeof o !== "object" || o === null) continue;
+					const orec = o;
+					if (typeof orec.label === "string" && orec.label !== "") options.push({
+						label: orec.label,
+						description: typeof orec.description === "string" ? orec.description : ""
+					});
+				}
+				questions.push({
+					id,
+					header,
+					multiSelect,
+					options
+				});
+			}
+			if (questions.length === 0) return empty;
+			return {
+				callId,
+				summary: questions.map((q) => q.header).filter((h) => h !== "").join(" / "),
+				questions,
+				answered: false
+			};
+		}
 		//#endregion
 		//#region src/client/error-boundary.tsx
 		/**
@@ -7384,14 +7626,44 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				key: row.key,
 				className: "lks14-msg lks14-msg-user"
 			}, row.text);
-			if (row.role === "reasoning") return (0, react.createElement)("details", {
-				key: row.key,
-				className: "lks14-reasoning"
-			}, (0, react.createElement)("summary", null, tr("chat.reasoning", { n: String(row.text.length) })), row.text);
+			if (row.role === "reasoning") {
+				const running = row.running === true;
+				return (0, react.createElement)("details", {
+					key: row.key,
+					className: "lks14-reasoning",
+					"data-state": running ? "running" : "ok",
+					"data-testid": "reasoning-row"
+				}, (0, react.createElement)("summary", { className: "lks14-reasoning-row" }, (0, react.createElement)(IconThinkOutline16, { size: 14 }), (0, react.createElement)("span", { className: "lks14-reasoning-title" }, tr("chat.think")), (0, react.createElement)("span", {
+					className: "lks14-reasoning-sep",
+					"aria-hidden": true
+				}), (0, react.createElement)("span", {
+					className: "lks14-reasoning-summary",
+					"data-follow-end": running || void 0
+				}, (0, react.createElement)("span", { className: "lks14-reasoning-sumtext" }, reasoningSummaryLine(row.text, running)))), (0, react.createElement)("div", { className: "lks14-reasoning-body" }, row.text));
+			}
 			if (row.role === "tool") return (0, react.createElement)("div", {
 				key: row.key,
 				className: "lks14-toolchip " + String(row.toolState ?? "loading")
 			}, row.toolState === "done" ? "✓" : row.toolState === "error" ? "×" : (0, react.createElement)("i", null), (0, react.createElement)("span", null, row.text));
+			if (row.role === "ask" && row.ask !== void 0) {
+				const answered = row.ask.answered;
+				return (0, react.createElement)("div", {
+					key: row.key,
+					className: `lks14-askrow${answered ? " answered" : ""}`,
+					"data-testid": "ask-row"
+				}, (0, react.createElement)("div", { className: "lks14-askhead" }, tr("ask.title")), ...row.ask.questions.map((q) => (0, react.createElement)("div", {
+					key: q.id,
+					className: "lks14-askq"
+				}, q.header !== "" ? (0, react.createElement)("div", { className: "lks14-askq-h" }, q.header) : null, ...q.options.map((opt) => (0, react.createElement)("button", {
+					key: opt.label,
+					className: "lks14-askopt",
+					disabled: answered || interactive?.answerAsk === void 0,
+					"data-testid": "ask-option",
+					onClick: () => {
+						interactive?.answerAsk?.(opt.label);
+					}
+				}, (0, react.createElement)("span", { className: "lks14-askopt-label" }, opt.label), opt.description !== "" ? (0, react.createElement)("span", { className: "lks14-askopt-desc" }, opt.description) : null)), q.options.length === 0 ? (0, react.createElement)("div", { className: "lks14-askfree" }, tr("ask.free")) : null)), answered ? (0, react.createElement)("div", { className: "lks14-askdone" }, tr("ask.answered")) : null);
+			}
 			const cls = row.role === "streaming" ? "lks14-msg lks14-msg-assistant streaming" : "lks14-msg lks14-msg-assistant";
 			const body = (0, react.createElement)(ErrorBoundary, { key: `b-${row.key}` }, (0, react.createElement)("div", {
 				className: cls,
@@ -7444,7 +7716,15 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			};
 		}
 		function StudyPanelBody({ ctx }) {
-			const { data, activate, setMode, setFocus, searchLessons, deleteCourse, deleteNote, bindLessonSession, lessonThreadOp, uploadAttachment } = useStudy();
+			const { data, activate, setMode, setFocus, searchLessons, deleteCourse, deleteNote, bindLessonSession, lessonThreadOp, setCourseScope, uploadAttachment, setInterfaceLang } = useStudy();
+			(0, react.useEffect)(() => {
+				const read = () => {
+					const lang = document.documentElement.lang;
+					if (/^[a-z]{2,3}(-[A-Za-z0-9]+)*$/.test(lang)) setInterfaceLang(lang).catch(() => {});
+				};
+				read();
+				return ctx.locale?.subscribe(read);
+			}, []);
 			(0, react.useEffect)(() => {
 				wireCodeBlockCopy();
 			}, []);
@@ -7592,6 +7872,15 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			const examLessonActive = lesson !== null && lesson.kind === "exam" && examOpen(data?.courses.flatMap((c) => c.sections).find((s) => s.lessons.some((l) => l.id === lesson.lessonId))?.lessons ?? []);
 			const localBound = (0, react.useRef)(null);
 			const boundSessionOf = (lessonId) => lessonId !== null && localBound.current?.lessonId === lessonId ? localBound.current.sessionId : null;
+			const threadKeyOf = (lessonId) => {
+				if (lessonId === null || data === null) return null;
+				for (const c of data.courses) if (c.sections.some((s) => s.lessons.some((l) => l.id === lessonId))) return threadOwnerKey(c.threadScope, c.courseId, lessonId);
+				return null;
+			};
+			const threadGroupOf = (lessonId) => {
+				const key = threadKeyOf(lessonId);
+				return key !== null ? data?.lessonThreads[key] ?? null : null;
+			};
 			const streamEl = (0, react.useRef)(null);
 			const touchStart = (0, react.useRef)(null);
 			const activeFace = (0, react.useRef)(null);
@@ -7600,7 +7889,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					try {
 						let face = activeFace.current;
 						if (face === null) {
-							const sessionId = boundSessionOf(lesson !== null ? lesson.lessonId : null) ?? (lesson !== null ? data?.lessonThreads[lesson.lessonId]?.active ?? data?.lessonSessions[lesson.lessonId] ?? null : null);
+							const sessionId = boundSessionOf(lesson !== null ? lesson.lessonId : null) ?? threadGroupOf(lesson !== null ? lesson.lessonId : null)?.active ?? (lesson !== null ? data?.lessonSessions[lesson.lessonId] ?? null : null);
 							if (sessionId !== null && sessionKnown(ctx, sessionId)) {
 								const actx = ctx.sessions.scope(sessionId);
 								face = actx === void 0 ? void 0 : ctx.sessions.sessionOf(actx) ?? null;
@@ -7636,7 +7925,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				} else celebrate(ev.kind);
 				prevCelebrationRef.current = snapshot;
 			}, [data]);
-			const boundId = boundSessionOf(lesson !== null ? lesson.lessonId : null) ?? (lesson !== null ? data?.lessonThreads[lesson.lessonId]?.active ?? data?.lessonSessions[lesson.lessonId] ?? null : null);
+			const boundId = boundSessionOf(lesson !== null ? lesson.lessonId : null) ?? threadGroupOf(lesson !== null ? lesson.lessonId : null)?.active ?? (lesson !== null ? data?.lessonSessions[lesson.lessonId] ?? null : null);
 			const nudged = (0, react.useRef)(false);
 			(0, react.useEffect)(() => {
 				if (nudged.current || (data?.dueCount ?? 0) === 0) return;
@@ -7823,7 +8112,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 						if (data?.active !== true) await activate(true);
 						if (targetLessonId !== void 0 && targetLessonId !== lesson.lessonId) await setFocus(targetLessonId).catch(() => {});
 						const bindId = targetLessonId ?? lesson.lessonId;
-						let sessionId = boundSessionOf(bindId) ?? data?.lessonThreads[bindId]?.active ?? data?.lessonSessions[bindId] ?? null;
+						let sessionId = boundSessionOf(bindId) ?? threadGroupOf(bindId)?.active ?? data?.lessonSessions[bindId] ?? null;
 						if (sessionId !== null && !sessionKnown(ctx, sessionId)) sessionId = null;
 						if (sessionId === null) {
 							const area = await fetch("/lookatstudy/api/study-workspace");
@@ -7836,10 +8125,13 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 								sessionId
 							};
 							await bindLessonSession(bindId, sessionId, threadTitle ?? threadAutoTitle(text));
-						} else localBound.current = {
-							lessonId: bindId,
-							sessionId
-						};
+						} else {
+							localBound.current = {
+								lessonId: bindId,
+								sessionId
+							};
+							await bindLessonSession(bindId, sessionId);
+						}
 						const shell = PANEL_SHELL.current;
 						if (shell !== null) shell.suppressHandBack(() => {
 							ctx.sessions.open(sessionId);
@@ -8018,6 +8310,11 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				onThreadRename: renameLessonThreadUi,
 				onThreadArchive: archiveLessonThreadUi,
 				onThreadDelete: deleteLessonThreadUi,
+				courseScope: data !== null && lesson !== null ? data.courses.find((c) => c.sections.some((sec) => sec.lessons.some((l) => l.id === lesson.lessonId)))?.threadScope ?? "lesson" : "lesson",
+				onScopeToggle: (next) => {
+					const cid = data !== null && lesson !== null ? data.courses.find((c) => c.sections.some((sec) => sec.lessons.some((l) => l.id === lesson.lessonId)))?.courseId : void 0;
+					if (cid !== void 0) setCourseScope(cid, next);
+				},
 				contextMeter,
 				contextBreakdown: breakdown,
 				uploadAttachment
@@ -8390,11 +8687,8 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			};
 			const [importJob, setImportJob] = (0, react.useState)(null);
 			const [importResult, setImportResult] = (0, react.useState)(null);
-			const sawTurnRef = (0, react.useRef)(false);
-			if (importJob !== null && turnActive) sawTurnRef.current = true;
 			const startImport = (label, prompt) => {
 				setImportResult(null);
-				sawTurnRef.current = false;
 				setImportJob({
 					label,
 					startedAt: Date.now(),
@@ -8415,7 +8709,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					setPanel("map");
 					return;
 				}
-				if (sawTurnRef.current && !turnActive) {
+				if (importJobDead(importJob, turnActive, Date.now())) {
 					setImportJob(null);
 					setImportResult({
 						ok: false,
@@ -8981,7 +9275,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			return cut <= 0 ? path : norm.slice(0, cut);
 		}
 		/** 中栏:the tutor chat stream with its own composer (upstream ChatStream + ChatComposer). */
-		function ChatPane({ data, lesson, rows, feedAttached, bound, busy, sendError, draft, setDraft, send, stop, setMode, narrowPane, onThreadSwitch, onThreadNew, onThreadRename, onThreadArchive, onThreadDelete, contextMeter, contextBreakdown, uploadAttachment }) {
+		function ChatPane({ data, lesson, rows, feedAttached, bound, busy, sendError, draft, setDraft, send, stop, setMode, narrowPane, onThreadSwitch, onThreadNew, onThreadRename, onThreadArchive, onThreadDelete, courseScope, onScopeToggle, contextMeter, contextBreakdown, uploadAttachment }) {
 			const stuck = (0, react.useRef)(true);
 			const [showFab, setShowFab] = (0, react.useState)(false);
 			const [threadsOpen, setThreadsOpen] = (0, react.useState)(false);
@@ -9207,7 +9501,13 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					revealed
 				}));
 			};
-			const threadPills = threadGroupPills(lesson !== null && data !== null ? data.lessonThreads[lesson.lessonId] : void 0);
+			const threadKeyOfHere = (lessonId) => {
+				if (lessonId === null || data === null) return null;
+				for (const c of data.courses) if (c.sections.some((sec) => sec.lessons.some((l) => l.id === lessonId))) return threadOwnerKey(c.threadScope, c.courseId, lessonId);
+				return null;
+			};
+			const keyHere = threadKeyOfHere(lesson !== null ? lesson.lessonId : null);
+			const threadPills = threadGroupPills(keyHere !== null ? data?.lessonThreads[keyHere] : void 0);
 			const lastAssistant = rowsView.reduce((acc, row, i) => row.role === "assistant" ? i : acc, -1);
 			const [error, setError] = (0, react.useState)(null);
 			const fire = (action) => {
@@ -9298,14 +9598,14 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					}));
 					send(tr("proposal.decline.msg", { lesson: proposal.lessonTitle }));
 				}
-			}, tr("proposal.decline"))) : decidedBadge !== null ? (0, react.createElement)("div", { className: `lks-propbanner decided ${decidedBadge.kind}` }, decidedBadge.kind === "accepted" ? (0, react.createElement)(IconCrownFill16, { size: 14 }) : (0, react.createElement)(IconBookFill16, { size: 14 }), (0, react.createElement)("span", { className: "lks-propbanner-why" }, tr(decidedBadge.kind === "accepted" ? "proposal.applied" : "proposal.rejected", { lesson: decidedBadge.title }))) : null, lesson !== null || !dormant ? (0, react.createElement)("div", { className: "lks14-lessonrow" }, lesson !== null ? (0, react.createElement)("span", null, lesson.title) : (0, react.createElement)("span", null, tr("col.tutor")), threadPills.length > 0 ? (0, react.createElement)("div", { className: "lks14-threadswitch" }, (0, react.createElement)("button", {
+			}, tr("proposal.decline"))) : decidedBadge !== null ? (0, react.createElement)("div", { className: `lks-propbanner decided ${decidedBadge.kind}` }, decidedBadge.kind === "accepted" ? (0, react.createElement)(IconCrownFill16, { size: 14 }) : (0, react.createElement)(IconBookFill16, { size: 14 }), (0, react.createElement)("span", { className: "lks-propbanner-why" }, tr(decidedBadge.kind === "accepted" ? "proposal.applied" : "proposal.rejected", { lesson: decidedBadge.title }))) : null, lesson !== null || !dormant ? (0, react.createElement)("div", { className: "lks14-lessonrow" }, lesson !== null ? (0, react.createElement)("span", null, lesson.title) : (0, react.createElement)("span", null, tr("col.tutor")), threadPills.length > 0 || courseScope === "course" ? (0, react.createElement)("div", { className: "lks14-threadswitch" }, (0, react.createElement)("button", {
 				className: "lks14-threadchip",
 				"aria-expanded": String(threadsOpen),
 				"data-tooltip": tr("threads.label"),
 				onClick: () => {
 					setThreadsOpen((v) => !v);
 				}
-			}, tr("threads.open", { n: String(threadPills.length) }), (0, react.createElement)("span", { className: "lks14-threadchip-caret" }, threadsOpen ? "▾" : "▸")), threadsOpen ? (0, react.createElement)("div", {
+			}, threadPills.length > 0 ? tr("threads.open", { n: String(threadPills.length) }) : tr("threads.scope"), (0, react.createElement)("span", { className: "lks14-threadchip-caret" }, threadsOpen ? "▾" : "▸")), threadsOpen ? (0, react.createElement)("div", {
 				className: "lks14-threadmenu",
 				role: "menu"
 			}, ...threadPills.map((p) => (0, react.createElement)("div", {
@@ -9350,7 +9650,10 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					if (v !== "" && v !== p.title) onThreadRename(p.id, v);
 					setRenaming(null);
 				}
-			}) : (0, react.createElement)("span", { className: "lks14-threadmenu-title" }, p.title), p.current ? (0, react.createElement)("span", { className: "lks14-threadmenu-now" }, tr("threads.now")) : null, (0, react.createElement)("button", {
+			}) : (0, react.createElement)("span", { className: "lks14-threadmenu-title" }, p.title, courseScope === "course" && threadCoverageLabel(p.touchedLessons, data?.courses ?? []) !== "" ? (0, react.createElement)("span", {
+				className: "lks14-threadmenu-cover",
+				"data-testid": "thread-cover"
+			}, `${tr("threads.coverage")}: ${threadCoverageLabel(p.touchedLessons, data?.courses ?? [])}`) : null), p.current ? (0, react.createElement)("span", { className: "lks14-threadmenu-now" }, tr("threads.now")) : null, (0, react.createElement)("button", {
 				className: "lks14-threadmenu-gear",
 				"aria-label": tr("threads.actions"),
 				"data-tooltip": tr("threads.actions"),
@@ -9393,6 +9696,18 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					setGearFor(null);
 				}
 			}, tr("threads.delete"))) : null)), (0, react.createElement)("button", {
+				key: "__scope__",
+				className: "lks14-threadmenu-row scope",
+				role: "menuitemcheckbox",
+				"aria-checked": String(courseScope === "course"),
+				"data-testid": "thread-scope-toggle",
+				onClick: () => {
+					onScopeToggle(courseScope === "course" ? "lesson" : "course");
+				}
+			}, (0, react.createElement)("span", {
+				className: "lks14-threadmenu-scope-icon",
+				"aria-hidden": "true"
+			}, courseScope === "course" ? "🔗" : "⛓"), (0, react.createElement)("span", { className: "lks14-threadmenu-title" }, tr("threads.scope")), (0, react.createElement)("span", { className: `lks14-threadmenu-scope-state${courseScope === "course" ? " on" : ""}` }, courseScope === "course" ? tr("threads.scope.on") : tr("threads.scope.off"))), (0, react.createElement)("button", {
 				key: "__new__",
 				className: "lks14-threadmenu-row new",
 				role: "menuitem",
@@ -9427,7 +9742,20 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				onClick: () => {
 					send(starters[0]?.message ?? tr("prompt.start"));
 				}
-			}, tr("chat.start")) : null) : rowsView.map((row, i) => row.role === "artifact" ? inlineArtifactCard(row, rowsView.slice(i + 1).some((r) => r.role === "assistant")) : chatRow(row, !dormant && i === lastAssistant ? { send } : void 0, row.role === "assistant" ? {
+			}, tr("chat.start")) : null) : rowsView.map((row, i) => row.role === "artifact" ? inlineArtifactCard(row, rowsView.slice(i + 1).some((r) => r.role === "assistant")) : chatRow(row, !dormant && (i === lastAssistant || row.role === "ask" && row.ask !== void 0 && !row.ask.answered) ? {
+				send,
+				answerAsk: (label) => {
+					(async () => {
+						if (busy) {
+							stop();
+							await new Promise((r) => {
+								setTimeout(r, 1800);
+							});
+						}
+						send(label);
+					})();
+				}
+			} : void 0, row.role === "assistant" ? {
 				playing: msgAudio?.key === row.key,
 				index: msgAudio?.index ?? 0,
 				total: msgAudio?.total ?? 0,
@@ -9618,6 +9946,17 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			const [read, setRead] = (0, react.useState)(null);
 			const readCtl = (0, react.useRef)(null);
 			const [readError, setReadError] = (0, react.useState)(null);
+			const [langView, setLangView] = (0, react.useState)("bilingual");
+			(0, react.useEffect)(() => {
+				if (lesson === null) return;
+				let next = "bilingual";
+				try {
+					const stored = localStorage.getItem(`lks-langview:${lesson.lessonId}`);
+					if (stored === "original" || stored === "bilingual" || stored === "translation") next = stored;
+				} catch {}
+				setLangView(next);
+			}, [lesson?.lessonId]);
+			const teachHtml = lesson === null ? "" : langView === "translation" && lesson.translationHtml !== void 0 ? lesson.translationHtml : langView === "bilingual" && lesson.bilingualHtml !== void 0 ? lesson.bilingualHtml : lesson.html;
 			const { tts, addUserNote, recordReview, editNote, pinNote } = useStudy();
 			const proseRef = (0, react.useRef)(null);
 			const diagRef = (0, react.useRef)(null);
@@ -9819,7 +10158,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					if (proseRef.current !== null) applyHighlights(proseRef.current, recordQuotes);
 					setEnhanceTick(Date.now());
 				});
-			}, [tab, lesson?.html]);
+			}, [tab, teachHtml]);
 			(0, react.useEffect)(() => {
 				if (pendingLocate === null || tab !== "teach" || proseRef.current === null) return;
 				locateNoteQuote(pendingLocate, proseRef.current);
@@ -9882,7 +10221,24 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 						setRateBusy(false);
 					});
 				}
-			}, tr(key))))) : null, (0, react.createElement)("div", { className: "lks-readbar" }, (0, react.createElement)("button", {
+			}, tr(key))))) : null, (0, react.createElement)("div", { className: "lks-readbar" }, lesson.bilingualHtml !== void 0 ? (0, react.createElement)("div", {
+				className: "lks-langview",
+				"data-testid": "langview"
+			}, [
+				"original",
+				"bilingual",
+				"translation"
+			].map((v) => (0, react.createElement)("button", {
+				key: v,
+				className: langView === v ? "on" : "",
+				"data-testid": `langview-${v}`,
+				onClick: () => {
+					setLangView(v);
+					try {
+						localStorage.setItem(`lks-langview:${lesson.lessonId}`, v);
+					} catch {}
+				}
+			}, tr(`langview.${v}`)))) : null, (0, react.createElement)("button", {
 				className: "lks-btn ghost",
 				style: {
 					padding: "3px 8px",
@@ -9916,7 +10272,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			}, (0, react.createElement)("div", {
 				className: "lks14-prose",
 				ref: proseRef,
-				dangerouslySetInnerHTML: { __html: lesson.html }
+				dangerouslySetInnerHTML: { __html: teachHtml }
 			})), quoteBtn !== null ? (0, react.createElement)("div", {
 				className: "lks-quote-btn",
 				"data-lks-quote-btn": "",