dsh-plugin-lookatstudy 0.24.0 → 0.25.1

package/lib/index.mjs

@@ -163,6 +163,7 @@ const ZH = {
 	"toast.close": "关闭",
 	"composer.busy": "导师正在回复…",
 	"rail.empty.demo": "导入示例课程",
+	"import.session.title": "课程导入",
 	"import.cta": "导入新课程",
 	"import.tab.url": "URL",
 	"import.tab.md": "MD",
@@ -265,7 +266,6 @@ const ZH = {
 	"chat.reasoning": "思考过程（{n} 字）",
 	"chat.think": "思考",
 	"langview.original": "原文",
-	"langview.bilingual": "对照",
 	"langview.translation": "译文",
 	"msg.speak": "朗读",
 	"note.pin": "置顶笔记",
@@ -534,6 +534,7 @@ const EN = {
 	"toast.close": "Close",
 	"composer.busy": "The tutor is replying…",
 	"rail.empty.demo": "Import the demo course",
+	"import.session.title": "Course import",
 	"import.cta": "Import a new course",
 	"import.tab.url": "URL",
 	"import.tab.md": "MD",
@@ -636,7 +637,6 @@ const EN = {
 	"chat.reasoning": "Thinking ({n} chars)",
 	"chat.think": "Think",
 	"langview.original": "Original",
-	"langview.bilingual": "Both",
 	"langview.translation": "Translation",
 	"msg.speak": "Speak",
 	"note.pin": "Pin note",
@@ -836,21 +836,6 @@ function escapeHtml(text) {
 function inline(escaped) {
 	return escaped.replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/\*([^*]+)\*/g, "<em>$1</em>").replace(/!\[([^\]]*)\]\((https?:\/\/[^)\s]+|data:image\/[^)\s]+|\/lookatstudy\/api\/attachment\/[^)\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>");
 }
-/** Interleave one body with its translation, paragraph by paragraph (upstream
-* translation-layout "microsoft" semantics: original paragraph then its
-* translation as a quote, tight pairing for bilingual reading; length
-* mismatches append the remainder in order). Pure. */
-function renderBilingual(bodyMd, translationMd) {
-	const par = (md) => md.split(/\n\s*\n/).map((p) => p.trim()).filter((p) => p !== "");
-	const a = par(bodyMd);
-	const b = par(translationMd);
-	const out = [];
-	for (let i = 0; i < Math.max(a.length, b.length); i++) {
-		if (a[i] !== void 0) out.push(a[i]);
-		if (b[i] !== void 0) out.push(`> ${b[i].split("\n").join("\n> ")}`);
-	}
-	return out.join("\n\n");
-}
 /** True when the line opens a GFM table row (pipes with a delimiter row next). */
 function isTableRow(line) {
 	return line.trim().startsWith("|") && line.trim().endsWith("|") && line.includes("|", 1);
@@ -2353,7 +2338,18 @@ function recordAnswer(state, lessonId, correct, concept, now) {
 function setCourseThreadScope(state, courseId, scope) {
 	const course = state.courses.find((c) => c.id === courseId);
 	if (course === void 0) throw new Error(`lookatstudy-plugin: unknown course id ${JSON.stringify(courseId)}`);
+	if ((course.threadScope === "course" ? "course" : "lesson") === scope) return;
 	course.threadScope = scope;
+	const courseKey = `course:${courseId}`;
+	const focusLessonId = state.focus?.lessonId ?? null;
+	if (focusLessonId === null || !course.sections.some((s) => s.lessons.some((l) => l.id === focusLessonId))) return;
+	const lessonKey = focusLessonId;
+	const src = scope === "course" ? state.lessonThreads[lessonKey] : state.lessonThreads[courseKey];
+	const dst = scope === "course" ? state.lessonThreads[courseKey] : state.lessonThreads[lessonKey];
+	if (src === void 0 || src.threads.length === 0) return;
+	if (dst !== void 0 && (dst.active !== null || dst.threads.length > 0)) return;
+	state.lessonThreads[scope === "course" ? courseKey : lessonKey] = src;
+	delete state.lessonThreads[scope === "course" ? lessonKey : courseKey];
 }
 /**
 * Resolve the thread-group map key a send from `lessonId` belongs to — the
@@ -3125,7 +3121,6 @@ function workbenchState(state, now) {
 			markdown: ref.lesson.body,
 			speechText: normalizeSpeechText(normalizeMathNotation(ref.lesson.body)),
 			...ref.lesson.translation !== void 0 ? {
-				bilingualHtml: renderMarkdown(normalizeMathNotation(renderBilingual(ref.lesson.body, ref.lesson.translation))),
 				translationHtml: renderMarkdown(normalizeMathNotation(ref.lesson.translation)),
 				translationLang: ref.lesson.translationLang ?? ""
 			} : {}
@@ -6586,6 +6581,50 @@ function validateDesign(design, validFiles) {
 		droppedLessons
 	};
 }
+/**
+* Heading similarity (word-level overlap) — the translation misalignment
+* guard. Ported verbatim from upstream import-pipeline.ts (their audit F16,
+* 2026-09-13): ordinal alignment assumes both heading lists share structure;
+* a machine-translated file with a dropped header shifts every ordinal, and
+* A's translation would silently land on B's node — overlap too low skips the
+* segment (宁缺毋错). Empty titles cannot be checked and pass conservatively.
+*/
+function headingsSimilar(a, b) {
+	const norm = (s) => s.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim().split(/\s+/).filter(Boolean);
+	const A = norm(a);
+	const B = norm(b);
+	if (A.length === 0 || B.length === 0) return true;
+	if (A.join(" ") === B.join(" ")) return true;
+	const setB = new Set(B);
+	return A.filter((w) => setB.has(w)).length / A.length >= .3;
+}
+/**
+* Replace a translation body's image references BY POSITION with the
+* original lesson's images (upstream method, import-pipeline.ts): translated
+* figure i ← original figure i (the original's refs are already absolute
+* CDN URLs or inlined data URLs); extras beyond the original count drop
+* (machine translation adding figures is rare — dropping is cleanest);
+* HTML imgs convert to markdown. One unified regex pass so HTML→markdown
+* conversion is never re-scanned with a shared index.
+*/
+function replaceImagesByPosition(content, originalImgs) {
+	let imgIdx = 0;
+	return content.replace(/!\[([^\]]*)\]\(([^)]+)\)|<img[^>]+src=["']([^"']+)["'][^>]*>/gi, (match, mdAlt, _mdSrc, htmlSrc) => {
+		if (imgIdx >= originalImgs.length) return "";
+		const replacement = originalImgs[imgIdx++];
+		if (htmlSrc !== void 0) return `![${/alt=["']([^"']*)["']/i.exec(match)?.[1] ?? ""}](${replacement})`;
+		return `![${mdAlt}](${replacement})`;
+	});
+}
+/** The original lesson body's image refs in order (the position-mapping source). */
+function originalImagesOf(body) {
+	const out = [];
+	for (const m of body.matchAll(/!\[([^\]]*)\]\(([^)]+)\)|<img[^>]+src=["']([^"']+)["'][^>]*>/gi)) {
+		const src = m[2] ?? m[3] ?? "";
+		if (src !== "") out.push(src);
+	}
+	return out;
+}
 /** GitHub-style anchor slug for ParsedLesson/ParsedSection anchors. */
 function slugAnchor(title) {
 	const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
@@ -6622,13 +6661,6 @@ function buildCourseFromDesign(courseTitle, validated, contents, translations) {
 			const titleIndex = lesson.anchor === null ? -1 : findTitleIndex(headings, lesson.anchor);
 			const isFirst = !firstLessonSeen.has(lesson.file);
 			firstLessonSeen.add(lesson.file);
-			const pair = translations?.get(lesson.file);
-			let translation;
-			if (pair !== void 0) {
-				const tHeadings = extractHeadings(pair.content);
-				const tIndex = lesson.anchor === null ? -1 : findTitleIndex(tHeadings, lesson.anchor);
-				translation = sliceLessonBody(pair.content, tHeadings, tIndex, isFirst);
-			}
 			const body = sliceLessonBody(content, headings, titleIndex, isFirst);
 			if (body.length > 8e3 && splittableHeadingCount(headings, titleIndex) > 0) pacingViolations.push({
 				title: lesson.title,
@@ -6636,6 +6668,16 @@ function buildCourseFromDesign(courseTitle, validated, contents, translations) {
 				chars: body.length,
 				splittable: splittableHeadingCount(headings, titleIndex)
 			});
+			const pair = translations?.get(lesson.file);
+			let translation;
+			if (pair !== void 0) {
+				const tHeadings = extractHeadings(pair.content);
+				let tIndex = titleIndex;
+				let keep = true;
+				if (lesson.anchor === null || titleIndex === -1) tIndex = -1;
+				else if (titleIndex >= tHeadings.length || !headingsSimilar(lesson.title, tHeadings[titleIndex].title)) keep = false;
+				if (keep) translation = replaceImagesByPosition(sliceLessonBody(pair.content, tHeadings, tIndex, isFirst), originalImagesOf(body));
+			}
 			return {
 				title: lesson.title,
 				anchor: slugAnchor(lesson.title),
@@ -7366,7 +7408,7 @@ function studyTools(store, deps = {}) {
 	};
 	const designOrImportedRender = (_args, value) => [{
 		type: "text",
-		text: value.status === "design_required" ? pendingDesign === null ? "Course design required — the brief is no longer pending; call the import tool again to re-fetch it." : typeof value.designSeq === "number" && value.designSeq !== designSeq ? "This design brief is STALE — a newer import replaced the pending design. Call the import tool again for the fresh brief; do not design against this one." : renderDesignBrief(pendingDesign, pendingPart) : `Imported course “${value.title}” (${value.sections} sections, ${value.lessons} lessons). First lesson: “${value.firstLessonTitle}” (id ${value.firstLessonId}).`
+		text: value.status === "design_required" ? pendingDesign === null ? "Course design required — the brief is no longer pending; call the import tool again to re-fetch it." : typeof value.designSeq === "number" && value.designSeq !== designSeq ? "This design brief is STALE — a newer import replaced the pending design. Call the import tool again for the fresh brief; do not design against this one." : renderDesignBrief(pendingDesign, pendingPart) + (store.get().interfaceLang === void 0 && (pendingDesign.availableLangs?.length ?? 0) > 0 ? "\nNote: the learner's interface language is not recorded — when applying, pass translationLang explicitly as the language the learner writes to you in (e.g. \"zh-CN\" for Chinese), so the translation mirrors pair." : "") : `Imported course “${value.title}” (${value.sections} sections, ${value.lessons} lessons). First lesson: “${value.firstLessonTitle}” (id ${value.firstLessonId}).`
 	}];
 	const designOrImportedPresentationMeta = (_args, value) => value.status === "design_required" ? designBriefLines(value) : importLines(value);
 	const designOrImportedPresent = { presentResult: (_args, result) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-lookatstudy",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "packageManager": "pnpm@11.7.0",
   "description": "Turn any markdown, local folder, or GitHub learning repo into a guided course inside DeepSeek Harness: gated skill-tree progression, BKT mastery tracking, SM-2 spaced repetition.",
   "type": "module",