dsh-plugin-lookatstudy 0.23.0 → 0.25.0

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",
@@ -263,6 +264,10 @@ const ZH = {
 	"rail.due.start": "开始复习",
 	"rail.due.none": "暂时没有到期的复习，保持节奏！",
 	"chat.reasoning": "思考过程（{n} 字）",
+	"chat.think": "思考",
+	"langview.original": "原文",
+	"langview.bilingual": "对照",
+	"langview.translation": "译文",
 	"msg.speak": "朗读",
 	"note.pin": "置顶笔记",
 	"note.unpin": "取消置顶",
@@ -530,6 +535,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",
@@ -630,6 +636,10 @@ const EN = {
 	"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",
@@ -2345,7 +2355,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
@@ -3113,9 +3134,14 @@ function workbenchState(state, now) {
 				quote: n.quote,
 				pinned: n.pinned === true
 			})),
-			html: renderMarkdown(normalizeMathNotation(ref.lesson.translation === void 0 ? ref.lesson.body : renderBilingual(ref.lesson.body, ref.lesson.translation))),
+			html: renderMarkdown(normalizeMathNotation(ref.lesson.body)),
 			markdown: ref.lesson.body,
-			speechText: normalizeSpeechText(normalizeMathNotation(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 ?? ""
+			} : {}
 		};
 	} catch {
 		lesson = null;
@@ -3360,6 +3386,7 @@ function registerDashboard(webServer, deps) {
 				}
 				try {
 					const ref = findLesson(deps.store.get(), body.lessonId);
+					if (ref.lesson.kind !== "exam" && ref.lesson.status === "available") attemptLesson(deps.store.get(), ref.lesson.id, /* @__PURE__ */ new Date());
 					deps.store.get().focus = { lessonId: ref.lesson.id };
 					deps.store.save();
 					sendJson(res, 200, { ok: true });
@@ -3893,6 +3920,26 @@ function registerDashboard(webServer, deps) {
 				});
 				return;
 			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/prefs") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.interfaceLang !== "string" || body.interfaceLang === "" || body.interfaceLang.length > 35) {
+					sendJson(res, 400, {
+						ok: false,
+						error: "interfaceLang (non-empty string, max 35 chars) required"
+					});
+					return;
+				}
+				if (deps.store.get().interfaceLang !== body.interfaceLang) {
+					deps.store.get().interfaceLang = body.interfaceLang;
+					deps.store.save();
+				}
+				sendJson(res, 200, {
+					ok: true,
+					interfaceLang: body.interfaceLang
+				});
+				return;
+			}
 			if (req.method === "POST" && pathname === "/lookatstudy/api/attachment") {
 				const body = await readJsonBodySafe(req, res, 29360128);
 				if (body === void 0) return;
@@ -4977,6 +5024,104 @@ async function fetchRepoFileTree(owner, repo, branch, _fetchFn, signal) {
 }
 /** 文件数上限（防爆，和 IPC handler 一致） */
 const MAX_FILES = 500;
+/** 从 markdown 链接中提取翻译语言列表 */
+function extractLanguagesFromReadme(readmeMd) {
+	const pattern = /\[([^\]]+)\]\(\.?\/?translations\/([^/)]+)\/README\.md\)/g;
+	const langs = [];
+	const seen = /* @__PURE__ */ new Set();
+	let m;
+	while ((m = pattern.exec(readmeMd)) !== null) {
+		const name = m[1].trim();
+		const code = m[2].trim();
+		if (!seen.has(code)) {
+			seen.add(code);
+			langs.push({
+				code,
+				name
+			});
+		}
+	}
+	return langs;
+}
+/**
+* 净化翻译版 markdown —— 翻译内容是 CDN 原样拉取的,未经原文管道的
+* code-fence-aware parser 处理,可能含畸形结构导致 react-markdown 崩溃。
+*
+* 处理:
+*   1. 未闭合代码围栏:统计 ``` 和 ~~~ 数量,奇数则补一个闭合围栏
+*   2. 去除 <script>/<style>/<iframe> 等危险 HTML(防 XSS + 防渲染崩溃)
+*   3. 去 BOM、统一换行
+*
+* 这是确定性规则处理(高置信度),不是 LLM 判断 —— 格式修复是规则擅长的。
+*/
+function sanitizeTranslatedMarkdown(md) {
+	let s = md.replace(/^\uFEFF/, "");
+	s = s.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+	const lines = s.split("\n");
+	let fence = null;
+	for (const line of lines) {
+		const m = line.match(/^\s*(```|~~~)/);
+		if (m) fence = fence ? null : m[1];
+	}
+	if (fence) s = s + "\n" + fence + "\n";
+	s = s.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, "");
+	s = s.replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, "");
+	s = s.replace(/<\/?(iframe|object|embed)\b[^>]*>/gi, "");
+	return s.trim();
+}
+/**
+* 拉取翻译版课程内容。
+*
+* 策略:不依赖翻译版 README 的链接（很多翻译只翻译了大纲，README 里没有 lesson 链接，
+* 或链接指向其他语言翻译）。直接用原文课程的文件路径，在前面加 translations/<code>/
+* 前缀去探测翻译版是否存在。5 并发拉取，404 跳过（该课无翻译）。
+*
+* @returns Map<originalPath, { title, content }> — key 是原文路径
+*/
+async function fetchTranslatedContent(owner, repo, branch, langCode, originalFiles, fetchFn, onProgress) {
+	const send = (msg) => onProgress?.(msg);
+	const result = /* @__PURE__ */ new Map();
+	const transReadmeUrl = cdnUrl(owner, repo, branch, `translations/${langCode}/README.md`);
+	send(`检查翻译版 README (${langCode})…`);
+	try {
+		const r = await fetchFn(transReadmeUrl);
+		if (!r.ok) {
+			send(`翻译版不存在 (${r.status})，跳过`);
+			return result;
+		}
+	} catch {
+		send("翻译版检查失败，跳过");
+		return result;
+	}
+	const mdFiles = originalFiles.filter((f) => !f.path.toLowerCase().endsWith(".ipynb"));
+	send(`探测 ${mdFiles.length} 个文件的翻译版（${langCode}）…`);
+	const transPrefix = `translations/${langCode}/`;
+	const CONCURRENCY = 5;
+	let done = 0;
+	for (let i = 0; i < mdFiles.length; i += CONCURRENCY) {
+		const batch = mdFiles.slice(i, i + CONCURRENCY);
+		const results = await Promise.allSettled(batch.map(async (file) => {
+			const r = await fetchFn(cdnUrl(owner, repo, branch, transPrefix + file.path));
+			if (!r.ok) return null;
+			const md = await r.text();
+			return {
+				originalPath: file.path,
+				title: file.title,
+				content: sanitizeTranslatedMarkdown(md)
+			};
+		}));
+		for (const res of results) {
+			done++;
+			if (res.status === "fulfilled" && res.value) result.set(res.value.originalPath, {
+				title: res.value.title,
+				content: res.value.content
+			});
+		}
+		if (done % 10 === 0 || done === mdFiles.length) send(`翻译探测 ${done}/${mdFiles.length}（命中 ${result.size}）`);
+	}
+	send(`翻译版拉取完成: ${result.size}/${mdFiles.length} 文件有翻译`);
+	return result;
+}
 /**
 * Step 1: 拉取仓库清单 —— README 全文 + 完整目录树 + 课程文件列表。
 *
@@ -6072,6 +6217,42 @@ function estimateTokens(text) {
 	return Math.ceil(cjk * 11 / 10 + other / 4);
 }
 /**
+* Match the learner's interface language against the repo's declared
+* translation languages (0.24.0): exact code first (case-insensitive), then
+* the base subtag family — a zh-CN host matches a zh-cn mirror, pt-PT still
+* finds pt-br. No family match (or nothing recorded) returns null and the
+* import stays original-language. Pure.
+*/
+function matchTranslationLang(want, available) {
+	if (want === void 0 || want.trim() === "" || available.length === 0) return null;
+	const norm = (code) => code.trim().toLowerCase();
+	const exact = available.find((a) => norm(a.code) === norm(want));
+	if (exact !== void 0) return exact;
+	const base = (code) => norm(code).split("-")[0];
+	const wantBase = base(want);
+	return available.find((a) => base(a.code) === wantBase) ?? null;
+}
+/**
+* 0.23.1 issue 5: the pacing gate's hard cap (the brief's 3000-8000 target's
+* upper edge). A sliced lesson over this WITH splittable in-span headings is
+* rejected — the brief has always carried the rule, but nothing enforced it,
+* so a flash-tier tutor's 1:1 file→lesson design shipped 45k-char lessons.
+*/
+const LESSON_MAX_CHARS = 8e3;
+/**
+* Count the in-span headings a lesson could be split by: direct children for
+* an anchored lesson (an H2 anchor's span ends at the next ≤-level heading,
+* so its H3s are the split unit; an H3 anchor is the terminal unit — nothing
+* deeper exists to split by), any H2/H3 for a whole-file lesson.
+*/
+function splittableHeadingCount(headings, titleIndex) {
+	if (titleIndex < 0) return headings.filter((h) => h.level >= 2).length;
+	const anchorLevel = headings[titleIndex].level;
+	let count = 0;
+	for (let i = titleIndex + 1; i < headings.length && headings[i].level > anchorLevel; i++) if (headings[i].level === anchorLevel + 1) count++;
+	return count;
+}
+/**
 * Build the pending design from Step 1 (inventory) + Step 3 (outlines).
 * @param url - the GitHub URL the learner asked to import.
 * @param owner - repo owner.
@@ -6244,6 +6425,7 @@ function renderDesignBrief(pending, part = 1) {
 	}
 	lines.push("");
 	lines.push("### Design rules (from the LookatStudy import pipeline)");
+	if (pending.availableLangs !== void 0 && pending.availableLangs.length > 0) lines.push(`Translations available in this repo: ${pending.availableLangs.map((l) => `${l.name} (${l.code})`).join(", ")}. study_apply_design automatically pairs the learner's interface-language mirror (translations/<code>/ file copies) with each lesson — no action needed from you; mention the availability to the learner.`);
 	lines.push("Classify every lesson as exactly one of:");
 	lines.push("- **study**: explanation/theory/tutorial content — the learning-world spine, its own lesson.");
 	lines.push("- **practice**: Exercise / Lab / notebook — its own lesson.");
@@ -6257,7 +6439,7 @@ function renderDesignBrief(pending, part = 1) {
 	lines.push("Other rules:");
 	lines.push("- role hints are references, not verdicts — README tables usually mark real roles (Lesson link = study, Notebook/Lab = practice).");
 	lines.push("- if the directory layout is already clear (e.g. lessons/N-Topic/), keep its sections; do not over-reorganize.");
-	lines.push(`- anchor is the full heading text used to slice the body; omit it for whole-file lessons.${shown.length > 80 ? " This part is large: design at file granularity (omit anchors, one lesson per file) to keep the JSON manageable." : ""}`);
+	lines.push(`- anchor is the full heading text used to slice the body; omit it for whole-file lessons.${shown.length > 80 ? " This part is large: design at file granularity (omit anchors, one lesson per file) to keep the JSON manageable — EXCEPT files over 8000 chars: those still need anchor splitting (anchor = an H2/H3 heading) into 3000-8000-char lessons; study_apply_design rejects over-long lessons whose file has splittable headings." : ""}`);
 	lines.push("");
 	lines.push("### Language-course check (decide while designing)");
 	lines.push("Is this course teaching a language ITSELF (vocabulary, grammar, reading/writing/listening of English/Japanese/Korean/Chinese/…), rather than a knowledge/tech course that merely happens to be written in some language? Typical tells: vocab lists, grammar-point explanations, dialogues/readings, sentence-translation pairs, level markers (N5/N1, TOEFL/IELTS, HSK, JLPT), pronunciation content.");
@@ -6444,42 +6626,56 @@ function buildCourseFromDesign(courseTitle, validated, contents, translations) {
 		return cached;
 	};
 	const firstLessonSeen = /* @__PURE__ */ new Set();
-	return {
-		title: courseTitle,
-		sections: validated.sections.map((section) => {
-			const lessons = section.lessons.map((lesson) => {
-				const content = contents.get(lesson.file);
-				if (content === void 0) throw new Error(`lookatstudy-plugin: no fetched content for designed file ${JSON.stringify(lesson.file)} — fetch failed earlier; retry study_apply_design`);
-				const headings = headingsOf(lesson.file);
-				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);
-				}
-				return {
-					title: lesson.title,
-					anchor: slugAnchor(lesson.title),
-					body: sliceLessonBody(content, headings, titleIndex, isFirst),
-					sourceFilePath: lesson.file,
-					world: lesson.world,
-					...translation !== void 0 ? {
-						translation,
-						translationLang: pair.lang
-					} : {}
-				};
+	const pacingViolations = [];
+	const sections = validated.sections.map((section) => {
+		const lessons = section.lessons.map((lesson) => {
+			const content = contents.get(lesson.file);
+			if (content === void 0) throw new Error(`lookatstudy-plugin: no fetched content for designed file ${JSON.stringify(lesson.file)} — fetch failed earlier; retry study_apply_design`);
+			const headings = headingsOf(lesson.file);
+			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,
+				file: lesson.file,
+				chars: body.length,
+				splittable: splittableHeadingCount(headings, titleIndex)
 			});
 			return {
-				title: section.title,
-				anchor: slugAnchor(section.title),
-				world: lessons.every((l) => l.world === "practice") ? "practice" : "study",
-				lessons
+				title: lesson.title,
+				anchor: slugAnchor(lesson.title),
+				body,
+				sourceFilePath: lesson.file,
+				world: lesson.world,
+				...translation !== void 0 ? {
+					translation,
+					translationLang: pair.lang
+				} : {}
 			};
-		})
+		});
+		return {
+			title: section.title,
+			anchor: slugAnchor(section.title),
+			world: lessons.every((l) => l.world === "practice") ? "practice" : "study",
+			lessons
+		};
+	});
+	if (pacingViolations.length > 0) {
+		const listed = pacingViolations.slice(0, 5).map((v) => `「${v.title}」 ${v.file} (${v.chars} chars, ${v.splittable} splittable heading${v.splittable === 1 ? "" : "s"})`).join("; ");
+		const more = pacingViolations.length > 5 ? ` (+${pacingViolations.length - 5} more)` : "";
+		throw new Error(`lookatstudy-plugin: pacing gate — ${pacingViolations.length} lesson${pacingViolations.length === 1 ? "" : "s"} over ${LESSON_MAX_CHARS} chars while the file has splittable H2/H3 sections (design rule: 3000-8000 chars per lesson): ${listed}${more}. Split each into one lesson per H2/H3 (anchor = the heading's full title, merge fragments under 1000 chars), then re-submit study_apply_design`);
+	}
+	return {
+		title: courseTitle,
+		sections
 	};
 }
 //#endregion
@@ -7142,6 +7338,26 @@ function studyTools(store, deps = {}) {
 				type: "integer",
 				description: "Pending-design sequence (audit C29): renders detect stale briefs."
 			},
+			availableLangs: {
+				type: "array",
+				description: "Translation languages the repo README declares (translations/<code>/ mirrors) — apply pairs the learner's interface language automatically.",
+				items: {
+					type: "object",
+					additionalProperties: false,
+					properties: {
+						code: {
+							type: "string",
+							required: true,
+							description: "BCP-47-ish code as it appears in the translations/ path."
+						},
+						name: {
+							type: "string",
+							required: true,
+							description: "Display name from the README link text."
+						}
+					}
+				}
+			},
 			part: {
 				type: "integer",
 				description: "Brief part this call rendered (context-budget batching)."
@@ -7163,7 +7379,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) => ({
@@ -7245,6 +7461,10 @@ function studyTools(store, deps = {}) {
 			courseTitle: partCount > 1 ? `${pd.courseTitle} (part ${part})` : pd.courseTitle,
 			fileCount: planBriefParts(pd.files)[Math.min(part, partCount) - 1].length,
 			fullTreeCount: pd.fullTreeCount,
+			...pd.availableLangs !== void 0 && pd.availableLangs.length > 0 ? { availableLangs: pd.availableLangs.map((l) => ({
+				code: l.code,
+				name: l.name
+			})) } : {},
 			...partCount > 1 ? {
 				part,
 				partCount
@@ -7265,6 +7485,8 @@ function studyTools(store, deps = {}) {
 		};
 		const inventory = await fetchRepoInventory(owner, repo, resolvedBranch, fetchFn, void 0, exec.signal);
 		const pd = buildPendingDesign(canonicalRef, owner, repo, inventory, await fetchFileOutlines(inventory.fileList.map((f) => f.path), owner, repo, inventory.branch, fetchFn, void 0, exec.signal));
+		const availableLangs = extractLanguagesFromReadme(inventory.readmeMd);
+		if (availableLangs.length > 0) pd.availableLangs = availableLangs;
 		setPendingDesign(pd);
 		if (pd.files.length === 0) throw new Error("lookatstudy-plugin: course files were discovered but no outlines could be fetched (CDN unreachable?)");
 		pendingPart = part;
@@ -7401,7 +7623,11 @@ ${p.text}`));
 		parameters: {
 			languageTarget: {
 				type: "string",
-				description: "Set ONLY when this course teaches a language ITSELF (vocabulary, grammar, reading/writing of English/Japanese/Chinese/…) rather than being a knowledge/tech course that merely happens to be written in some language: the taught language as a BCP-47 tag (\"en\", \"ja\", \"zh-CN\", …). The writing language is NOT the taught language — a Chinese-written English-textbook repo has languageTarget \"en\". Typical tells: vocab lists, grammar points, dialogues/readings, sentence-translation pairs, level markers (N5/N1, TOEFL, HSK, JLPT), pronunciation content. When unsure, omit it — a normal course misflagged as a language course is worse than the reverse."
+				description: "Set ONLY when this course teaches a language ITSELF (vocabulary, grammar, reading/writing of English/Japanese/Chinese/…) rather than being a knowledge/tech course that merely happens to be written in some language: the taught language as a BCP-47 tag (\"en\", \"ja\", \"zh-CN\", …). The writing language is NOT the taught language — a Chinese-written English-textbook repo has languageTarget \"en\". Typical tells: vocab lists, grammar points, dialogues/readings, sentence-translation pairs, level markers (N5/N1, TOEFL/IELTS, HSK, JLPT), pronunciation content. When unsure, omit it — a normal course misflagged as a language course is worse than the reverse."
+			},
+			translationLang: {
+				type: "string",
+				description: "Override the translation mirror language (0.24.0). Default: the learner's interface language, matched against the repo's declared translations (zh-CN matches zh-cn, en-US falls back to en). Set this only when the LEARNER explicitly asks for a different language than their interface."
 			},
 			sections: {
 				type: "array",
@@ -7481,6 +7707,11 @@ ${p.text}`));
 						type: "integer",
 						required: true
 					},
+					translations: {
+						type: "integer",
+						required: true,
+						description: "Lessons that landed with a paired translation (the interface-language mirror existed and its anchor matched) — their teach tab offers 原文/对照/译文."
+					},
 					created: {
 						type: "boolean",
 						required: true,
@@ -7494,7 +7725,7 @@ ${p.text}`));
 			},
 			render: (_args, value) => [{
 				type: "text",
-				text: value.created === false ? `“${value.title}” (id ${value.courseId}) was ALREADY imported — the design did not create a new course. Continue with the existing course, or delete it first (study_delete_course) to rebuild from this design.` : `Imported designed course “${value.title}” (${value.sections} sections, ${value.lessons} lessons${value.droppedLessons > 0 ? `, ${value.droppedLessons} hallucinated lesson(s) dropped` : ""})${typeof value.languageTarget === "string" ? ` — language course (${value.languageTarget}): keep reading passages, example sentences, and quiz language material in the target language` : ""}. First lesson: “${value.firstLessonTitle}” (id ${value.firstLessonId}). Present the course map to the learner.`
+				text: value.created === false ? `“${value.title}” (id ${value.courseId}) was ALREADY imported — the design did not create a new course. Continue with the existing course, or delete it first (study_delete_course) to rebuild from this design.` : `Imported designed course “${value.title}” (${value.sections} sections, ${value.lessons} lessons${value.droppedLessons > 0 ? `, ${value.droppedLessons} hallucinated lesson(s) dropped` : ""})${typeof value.translations === "number" && value.translations > 0 ? ` — ${value.translations} lesson(s) carry the learner's-language translation (原文/对照/译文 in the teach tab)` : ""}${typeof value.languageTarget === "string" ? ` — language course (${value.languageTarget}): keep reading passages, example sentences, and quiz language material in the target language` : ""}. First lesson: “${value.firstLessonTitle}” (id ${value.firstLessonId}). Present the course map to the learner.`
 			}]
 		},
 		async execute(args, exec) {
@@ -7521,7 +7752,22 @@ ${p.text}`));
 				if (contents.size === 0) throw new Error(`lookatstudy-plugin: every designed file failed to fetch (${failed.length}) — the CDN path is unreachable; retry or re-import`);
 				if (failed.length > 0) throw new Error(`lookatstudy-plugin: ${failed.length} designed file(s) failed to fetch: ${failed.join(", ")} — drop or fix them and call study_apply_design again`);
 			}
-			const parsed = buildCourseFromDesign(pd.part !== void 0 && pd.partCount !== void 0 && pd.partCount > 1 ? `${pd.courseTitle} (part ${pd.part})` : pd.courseTitle, validated, contents, pd.translations);
+			let translations = pd.translations;
+			if (pd.localContents === void 0 && pd.availableLangs !== void 0 && pd.availableLangs.length > 0) {
+				const match = matchTranslationLang(typeof args.translationLang === "string" && args.translationLang.trim() !== "" ? args.translationLang : store.get().interfaceLang, pd.availableLangs);
+				if (match !== null && !exec.signal.aborted) {
+					const fetched = await fetchTranslatedContent(pd.owner, pd.repo, pd.branch, match.code, uniqueFiles.map((f) => ({
+						path: f,
+						title: f,
+						md: ""
+					})), signalFetch(exec.signal, baseFetch));
+					if (fetched.size > 0) translations = new Map([...fetched].map(([path, v]) => [path, {
+						lang: match.code,
+						content: v.content
+					}]));
+				}
+			}
+			const parsed = buildCourseFromDesign(pd.part !== void 0 && pd.partCount !== void 0 && pd.partCount > 1 ? `${pd.courseTitle} (part ${pd.part})` : pd.courseTitle, validated, contents, translations);
 			requireParsedLessons(parsed);
 			const languageTarget = typeof args.languageTarget === "string" && args.languageTarget.trim() !== "" ? args.languageTarget.trim().slice(0, 35) : null;
 			const value = mutate((state) => {
@@ -7533,9 +7779,11 @@ ${p.text}`));
 			});
 			setPendingDesign(null);
 			pendingPart = 1;
+			const translatedLessons = parsed.sections.reduce((n, s) => n + s.lessons.filter((l) => l.translation !== void 0).length, 0);
 			return {
 				...value,
 				droppedLessons: validated.droppedLessons,
+				translations: translatedLessons,
 				...languageTarget !== null ? { languageTarget } : {}
 			};
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-lookatstudy",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "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",