dsh-plugin-lookatstudy 0.12.1 → 0.12.3

package/lib/client.js

@@ -106,7 +106,7 @@ window.__ModuleLoader__.load({
 .lks-sec{font-size:12px;color:var(--dsw-alias-label-secondary);text-transform:uppercase;letter-spacing:.05em;margin:14px 0 4px}
 /* Collapsible section head: a real button (keyboard can toggle it), sticky so
    the current chapter stays identified while 4000px of nodes scroll under it. */
-.lks-sechead{display:flex;align-items:center;gap:6px;width:100%;box-sizing:border-box;font-size:12px;font-weight:600;color:var(--dsw-alias-label-secondary);text-transform:uppercase;letter-spacing:.05em;text-align:left;padding:6px 4px;margin:14px 0 4px;border-radius:6px;position:sticky;top:0;z-index:1;background:var(--dsw-alias-bg-base)}
+.lks-sechead{display:flex;align-items:center;gap:6px;width:100%;box-sizing:border-box;font-size:12px;font-weight:600;color:var(--dsw-alias-label-secondary);text-align:left;padding:6px 4px;margin:14px 0 4px;border-radius:6px;position:sticky;top:0;z-index:1;background:var(--dsw-alias-bg-base)}
 .lks-sechead:hover{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover)}
 .lks-sechead:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-state-business-primary);outline:none}
 .lks-sechead-t{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
@@ -261,6 +261,10 @@ window.__ModuleLoader__.load({
 .lks-dock-streak{color:var(--dsw-alias-state-business-primary)}
 .lks-dockseg.lks-muted{color:var(--dsw-alias-label-secondary)}
 
+/* concept map legend (amber = weak) */
+.lks-cmap-legend{display:inline-flex;align-items:center;gap:5px;font-size:12px;color:var(--dsw-alias-label-secondary);margin-top:4px}
+.lks-cmap-legend i{width:10px;height:10px;border-radius:3px;background:var(--dsw-alias-state-warn-tertiary,#fef5e7);border:1px solid var(--dsw-alias-state-warn-primary,#dd8629)}
+
 /* 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)}
@@ -269,6 +273,11 @@ window.__ModuleLoader__.load({
 .lks-tv-chip.ok{background:var(--dsw-alias-state-success-tertiary);color:var(--lks-ok-ink)}
 .lks-tv-chip.bad{background:var(--dsw-alias-state-error-tertiary);color:var(--lks-err-ink)}
 .lks-tv-line{color:var(--dsw-alias-label-secondary);line-height:1.6;white-space:pre-wrap}
+/* exam star card + the failure moment */
+.lks-tv-stars{display:inline-flex;align-items:center;gap:5px;font-size:13px;font-weight:600;color:var(--lks-warn-ink)}
+.lks-tv-stars .dim{opacity:.22}
+.lks-tv-stars-label{font-weight:400;color:var(--dsw-alias-label-secondary)}
+.lks-tv-failnote{margin-top:4px;font-size:12.5px;color:var(--dsw-alias-label-secondary);line-height:1.6}
 `;
 		/**
 		* Inject the study stylesheet into `document.head` (idempotent).
@@ -1512,77 +1521,6 @@ window.__ModuleLoader__.load({
 			return hubId;
 		}
 		//#endregion
-		//#region src/client/diagrams.ts
-		/**
-		* Blackboard diagram views (SPEC Phase 2): the lesson concept map (ELK layered
-		* layout via the vendored cmap-elk-layout + CDN elkjs, draw.io-flavored SVG
-		* skin rendered plugin-side). Degrades honestly: any CDN/ELK failure leaves a
-		* one-line notice instead of a broken pane.
-		*
-		* The lesson mind map view was RETIRED with upstream v0.26.0 (2026-09-01
-		* port): body text that has headings already shows its structure, text without
-		* headings yields a first-line-truncated node graph nobody can read — both
-		* lose — and this concept map already covers the semantic-structure need at
-		* higher quality. Its three CDN imports went with it.
-		*/
-		/** 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 = {
@@ -1661,11 +1599,15 @@ window.__ModuleLoader__.load({
 			"bb.empty": "黑板还空着",
 			"bb.empty.hint": "在左侧课程树选择一课",
 			"bb.mastery": "掌握度 {pct}%",
+			"cmap.legend": "琥珀色 = 薄弱知识点(掌握度 <70%)",
+			"cmap.node.pct": "掌握度 {pct}%",
 			"bb.strategy": "本课学法",
 			"bb.fallback.cmap.empty": "概念图需要先由导师定义本课概念",
 			"bb.fallback.cmap": "概念图渲染不可用(布局引擎加载失败) — 已回退讲解视图",
 			"bb.notes": "笔记",
 			"bb.notes.empty": "这一课还没有笔记",
+			"tv.exam.stars": "本次 {n}★(历史最佳 {best}★)",
+			"tv.exam.fail": "这轮没拿到星——错题就是下一课的地图,从每题的解析看起。",
 			"active.off.title": "注册 study 工具并载入导师人格,之后普通对话和现在一样",
 			"active.on.title": "注销 study 工具与导师人格;学习进度保留,可随时重新开启",
 			"active.off": "▶ 开始学习",
@@ -1676,8 +1618,8 @@ window.__ModuleLoader__.load({
 			"settings.mode.hint": "导师的讲解风格;也可在学习页随时切换",
 			"settings.studyMode": "学习模式",
 			"settings.studyMode.hint": "开启后注册 study_* 工具并载入导师人格;进度与笔记始终保留",
-			"settings.on": "已开启",
-			"settings.off": "已关闭",
+			"settings.on": "状态：已开启",
+			"settings.off": "状态：已关闭",
 			"settings.turnOn": "开启",
 			"settings.turnOff": "关闭",
 			"settings.stats": "学习统计",
@@ -1777,11 +1719,15 @@ window.__ModuleLoader__.load({
 			"bb.empty": "The blackboard is empty",
 			"bb.empty.hint": "Pick a lesson in the course tree on the left",
 			"bb.mastery": "mastery {pct}%",
+			"cmap.legend": "Amber = weak concept (mastery < 70%)",
+			"cmap.node.pct": "mastery {pct}%",
 			"bb.strategy": "Approach",
 			"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",
+			"tv.exam.stars": "This attempt {n}★ (best {best}★)",
+			"tv.exam.fail": "No stars this round — the wrong answers are the map for the next one; start with their explanations.",
 			"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",
@@ -1792,8 +1738,8 @@ window.__ModuleLoader__.load({
 			"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.on": "Status: on",
+			"settings.off": "Status: off",
 			"settings.turnOn": "Turn on",
 			"settings.turnOff": "Turn off",
 			"settings.stats": "Study stats",
@@ -1879,6 +1825,86 @@ window.__ModuleLoader__.load({
 			return activeT(key, params);
 		}
 		//#endregion
+		//#region src/client/diagrams.ts
+		/**
+		* Blackboard diagram views (SPEC Phase 2): the lesson concept map (ELK layered
+		* layout via the vendored cmap-elk-layout + CDN elkjs, draw.io-flavored SVG
+		* skin rendered plugin-side). Degrades honestly: any CDN/ELK failure leaves a
+		* one-line notice instead of a broken pane.
+		*
+		* The lesson mind map view was RETIRED with upstream v0.26.0 (2026-09-01
+		* port): body text that has headings already shows its structure, text without
+		* headings yields a first-line-truncated node graph nobody can read — both
+		* lose — and this concept map already covers the semantic-structure need at
+		* higher quality. Its three CDN imports went with it.
+		*/
+		/** 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-alias-bg-layer-1, #fff);border:1px solid var(--dsw-alias-border-l2, #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-alias-border-l2, #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 ? "var(--dsw-alias-state-warn-tertiary, #fef5e7)" : "var(--dsw-alias-bg-layer-2, #f6f8fa)");
+				rect.setAttribute("stroke", isLesson ? "var(--dsw-alias-state-business-primary, #0969da)" : "var(--dsw-alias-border-l2, #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-alias-label-primary, #1f2328)");
+					label.textContent = line;
+					g.append(label);
+				});
+				const title = document.createElementNS(ns, "title");
+				const label = n.lines.join(" ");
+				title.textContent = isLesson || mastery === void 0 ? label : `${label} · ${tr("cmap.node.pct", { pct: mastery })}`;
+				g.append(title);
+				svg.append(g);
+			}
+			container.append(svg);
+			const legend = document.createElement("span");
+			legend.className = "lks-cmap-legend";
+			const swatch = document.createElement("i");
+			legend.append(swatch, document.createTextNode(tr("cmap.legend")));
+			container.append(legend);
+		}
+		//#endregion
 		//#region src/client/views.tsx
 		/**
 		* The study tab: one `conversation.view` entry rendering the whole plugin —
@@ -2029,6 +2055,9 @@ window.__ModuleLoader__.load({
 		* Tool results are skipped: the host conversation renders the rich
 		* `tool.call.toolview` cards, and the tutor column stays a pure persona
 		* surface (a transcript mirror there grew a second, diverging record).
+		* Both inputs tolerate undefined: newer hosts (DSH v0.1.2-alpha.4) mount
+		* the conversation view before session data exists, and the fold must
+		* degrade to an empty transcript instead of blanking the whole tab.
 		* @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).
@@ -2036,7 +2065,7 @@ window.__ModuleLoader__.load({
 		*/
 		function transcriptRows(nodes, partial, t = tr) {
 			const rows = [];
-			for (const node of nodes) switch (node.kind) {
+			for (const node of nodes ?? []) switch (node.kind) {
 				case "user":
 				case "steering": {
 					const text = textOf(node.content);
@@ -2062,7 +2091,7 @@ window.__ModuleLoader__.load({
 					text: node.message
 				});
 			}
-			if (partial !== null) {
+			if (partial != null) {
 				const text = assistantText(partial.blocks);
 				if (text !== "") rows.push({
 					key: "streaming",
@@ -2208,7 +2237,7 @@ window.__ModuleLoader__.load({
 				bindLessonSession,
 				send,
 				ctx,
-				currentSessionId: snapshot.sessionId
+				currentSessionId: snapshot?.sessionId ?? ""
 			}), (0, react.createElement)(TutorColumn, {
 				data,
 				setMode,
@@ -2491,7 +2520,7 @@ window.__ModuleLoader__.load({
 		/** Middle column: the tutor — transcript, proposal banner, pills, starters. Typing happens in the native composer below the tab. */
 		function TutorColumn({ data, setMode, send, snapshot }) {
 			const [error, setError] = (0, react.useState)(null);
-			const rows = transcriptRows(snapshot.nodes, snapshot.partial);
+			const rows = transcriptRows(snapshot?.nodes, snapshot?.partial ?? null);
 			const lastAssistant = rows.reduce((acc, row, i) => row.role === "assistant" ? i : acc, -1);
 			const scrollRef = (0, react.useRef)(null);
 			(0, react.useEffect)(() => {
@@ -2641,7 +2670,7 @@ window.__ModuleLoader__.load({
 		*/
 		function studyStartButton(ctx) {
 			return function StudyStartButton({ session }) {
-				if (session.blank !== true) return null;
+				if (session?.blank !== true) return null;
 				return (0, react.createElement)(Inner, {
 					key: "inner",
 					ctx
@@ -2884,9 +2913,34 @@ window.__ModuleLoader__.load({
 		function StudyDueView({ toolName, block }) {
 			return studyToolCard(toolName, block);
 		}
-		/** study_exam_result star card. */
+		/** Stars from the exam card's presentationMeta line (`N★`); null when absent. Pure. */
+		function examStars(block) {
+			const lines = metaLines(block);
+			for (const line of lines) {
+				const m = /^([0-3])★\s*\(?(?:best\s*([0-3])★)?/.exec(line.trim()) ?? /^(?:本次\s*)?([0-3])★/.exec(line.trim());
+				if (m !== null) return {
+					stars: Number(m[1]),
+					best: Number(m[2] ?? m[1])
+				};
+			}
+			return null;
+		}
+		/** study_exam_result star card — and the failure moment finally gets its line. */
 		function StudyExamView({ toolName, block }) {
-			return studyToolCard(toolName, block);
+			const r = examStars(block);
+			const stars = r === null ? null : (0, react.createElement)("span", { className: "lks-tv-stars" }, [
+				0,
+				1,
+				2
+			].map((i) => (0, react.createElement)("span", {
+				key: i,
+				className: i < r.stars ? "full" : "dim"
+			}, "★")), (0, react.createElement)("span", { className: "lks-tv-stars-label" }, tr("tv.exam.stars", {
+				n: r.stars,
+				best: r.best
+			})));
+			const fail = r !== null && r.stars === 0 ? (0, react.createElement)("div", { className: "lks-tv-failnote" }, tr("tv.exam.fail")) : null;
+			return studyToolCard(toolName, block, (0, react.createElement)("span", null, stars, fail));
 		}
 		//#endregion
 		//#region src/client/index.ts