dsh-plugin-lookatstudy 0.22.2 → 0.24.0

package/lib/index.mjs

@@ -228,6 +228,13 @@ const ZH = {
 	"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": "系统提示",
@@ -256,6 +263,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": "取消置顶",
@@ -576,6 +587,13 @@ const EN = {
 	"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)",
@@ -616,6 +634,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",
@@ -1482,6 +1504,23 @@ function computeStreakTransition(state, now = /* @__PURE__ */ new Date()) {
 	};
 }
 //#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;
+}
+/** True when a thread-group key names a course-scoped group. Disambiguated
+*  by COLON COUNT, not by prefix alone: a course titled "Course" slugs to
+*  `course`, and its lesson keys (`course:0:0`) live inside the naive
+*  `course:` prefix space (caught live by the B7 trash test). Lesson ids are
+*  always `<slug>:<si>:<li>` — three segments, since slugs strip the colon —
+*  while a course key is exactly `course:<slug>`, two segments. */
+function isCourseOwnerKey(key) {
+	if (!key.startsWith("course:")) return false;
+	return !key.slice(7).includes(":");
+}
+//#endregion
 //#region src/state.ts
 /**
 * Learning state: courses → sections → lessons with mastery-driven gating,
@@ -1814,7 +1853,7 @@ function deleteCourse(state, courseId) {
 	const [course] = state.courses.splice(i, 1);
 	const prefix = `${courseId}:`;
 	const lessonThreads = [];
-	for (const key of Object.keys(state.lessonThreads)) if (key.startsWith(prefix)) {
+	for (const key of Object.keys(state.lessonThreads)) if (key.startsWith(prefix) || key === `course:${courseId}`) {
 		lessonThreads.push([key, state.lessonThreads[key]]);
 		delete state.lessonThreads[key];
 	}
@@ -1871,7 +1910,11 @@ function restoreCourse(state, courseId) {
 		}));
 		for (const p of entry.proposals) p.lessonId = remap(p.lessonId);
 		entry.artifacts = entry.artifacts.map(([k, v]) => [remap(k), v]);
-		entry.lessonThreads = entry.lessonThreads.map(([k, v]) => [remap(k), v]);
+		entry.lessonThreads = entry.lessonThreads.map(([k, v]) => {
+			if (!isCourseOwnerKey(k)) return [remap(k), v];
+			for (const t of v.threads) if (t.touchedLessons !== void 0) t.touchedLessons = t.touchedLessons.map(remap);
+			return [`course:${id}`, v];
+		});
 		entry.lessonSessions = entry.lessonSessions.map(([k, v]) => [remap(k), v]);
 		if (entry.focusLessonId !== null) entry.focusLessonId = remap(entry.focusLessonId);
 	}
@@ -2303,25 +2346,67 @@ function recordAnswer(state, lessonId, correct, concept, now) {
 * @returns completion result including the unlocked lessons.
 */
 /**
+* Set a course's thread granularity (0.23.0). Switching never touches the
+* sediment: both sides' groups stay put and are resumed when the scope flips
+* back. Unknown ids fail loud.
+*/
+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)}`);
+	course.threadScope = scope;
+}
+/**
+* Resolve the thread-group map key a send from `lessonId` belongs to — the
+* 0.23.0 granularity funnel: lesson scope keeps legacy lessonId keys, course
+* scope namespaces the course. Every thread-group access in this module goes
+* through here (or through an ownerKey already derived from it).
+*/
+function ownerKeyFor(state, lessonId) {
+	const ref = findLesson(state, lessonId);
+	const scope = ref.course.threadScope === "course" ? "course" : "lesson";
+	return {
+		key: threadOwnerKey(scope, ref.course.id, lessonId),
+		scope
+	};
+}
+/**
+* Under course scope, mirrors drift per lesson (each remembers the last
+* thread IT used) — drift onto a LIVE thread is fine. The moment a thread
+* leaves the live set (archived, deleted, or rolled off the active pointer),
+* every mirror still naming it is a dead reference — re-point them at the
+* group's current active thread (or drop them when none is left). Lesson
+* scope keeps the legacy exact-mirror behavior at its own key.
+*/
+function repointMirrorsOff(state, key, threadId, group) {
+	if (threadId === null || !isCourseOwnerKey(key)) return;
+	for (const lessonId of Object.keys(state.lessonSessions)) if (state.lessonSessions[lessonId] === threadId) {
+		if (group.active === null) delete state.lessonSessions[lessonId];
+		else state.lessonSessions[lessonId] = group.active;
+	}
+}
+/**
 * Bind a dsh session into a lesson's thread group (the issue-#11 write, the
 * upstream sendMessage/ensureThreadForSend translation): an UNKNOWN session id
 * appends a new thread (titled by the caller — the first message's text or a
 * short action label) and becomes active; a KNOWN id re-activates it (bumping
 * lastAt); `null` clears the active pointer (the ＋新建 affordance — the next
 * send mints a fresh thread). The legacy lessonSessions map stays in lockstep
-* with the active pointer so pre-0.22 readers never disagree.
+* with the active pointer so pre-0.22 readers never disagree. Under course
+* scope (0.23.0) the group is the course's, the send-from lesson joins the
+* thread's touchedLessons coverage, and mirrors sync per
+* {@link repointRolledMirrors}.
 */
 function bindLessonThread(state, lessonId, sessionId, title) {
-	findLesson(state, lessonId);
+	const { key, scope } = ownerKeyFor(state, lessonId);
 	state.lessonThreads ??= {};
-	const group = state.lessonThreads[lessonId] ?? {
+	const group = state.lessonThreads[key] ?? {
 		active: null,
 		threads: []
 	};
 	if (sessionId === null) {
 		group.active = null;
-		state.lessonThreads[lessonId] = group;
-		delete state.lessonSessions[lessonId];
+		state.lessonThreads[key] = group;
+		if (scope === "lesson") delete state.lessonSessions[lessonId];
 		return group;
 	}
 	const existing = group.threads.find((t) => t.id === sessionId);
@@ -2331,31 +2416,37 @@ function bindLessonThread(state, lessonId, sessionId, title) {
 			id: sessionId,
 			title: (title ?? "").trim() !== "" ? title.trim() : lessonId,
 			createdAt: now,
-			lastAt: now
+			lastAt: now,
+			touchedLessons: [lessonId]
 		});
 	} else {
 		existing.lastAt = (/* @__PURE__ */ new Date()).toISOString();
 		if (existing.status === "archived") existing.status = "active";
+		const touched = existing.touchedLessons ??= [];
+		if (!touched.includes(lessonId)) touched.push(lessonId);
 	}
 	group.active = sessionId;
-	state.lessonThreads[lessonId] = group;
+	state.lessonThreads[key] = group;
 	state.lessonSessions[lessonId] = sessionId;
 	return group;
 }
 /** Roll the group's active pointer to the freshest ACTIVE thread (or null)
 *  and keep the legacy lessonSessions mirror in lockstep. Shared by the
 *  archive/delete operations when they take out the current thread. */
-function rollActiveToFresh(state, lessonId, group) {
+function rollActiveToFresh(state, key, group) {
+	const prev = group.active;
 	const live = group.threads.filter((t) => t.status !== "archived");
 	group.active = live.length > 0 ? live.reduce((a, b) => a.lastAt > b.lastAt ? a : b).id : null;
-	if (group.active !== null) state.lessonSessions[lessonId] = group.active;
-	else delete state.lessonSessions[lessonId];
+	if (isCourseOwnerKey(key)) repointMirrorsOff(state, key, prev, group);
+	else if (group.active !== null) state.lessonSessions[key] = group.active;
+	else delete state.lessonSessions[key];
 }
 /** Rename a thread's stored title (issue #11 management: upstream gear menu).
 *  The dsh session's own title is renamed host-side by the client (best
 *  effort) — this is the durable plugin-side half. Throws on unknown ids. */
 function renameLessonThread(state, lessonId, sessionId, title) {
-	const group = state.lessonThreads?.[lessonId];
+	const key = ownerKeyFor(state, lessonId).key;
+	const group = state.lessonThreads?.[key];
 	if (group === void 0) throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} has no thread group`);
 	const thread = group.threads.find((t) => t.id === sessionId);
 	if (thread === void 0) throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} has no thread ${JSON.stringify(sessionId)}`);
@@ -2368,12 +2459,14 @@ function renameLessonThread(state, lessonId, sessionId, title) {
 *  threads leave the switcher list entirely (no unarchive entry there; the
 *  state API keeps `archived: false` for symmetry/future UI). */
 function archiveLessonThread(state, lessonId, sessionId, archived) {
-	const group = state.lessonThreads?.[lessonId];
+	const key = ownerKeyFor(state, lessonId).key;
+	const group = state.lessonThreads?.[key];
 	if (group === void 0) throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} has no thread group`);
 	const thread = group.threads.find((t) => t.id === sessionId);
 	if (thread === void 0) throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} has no thread ${JSON.stringify(sessionId)}`);
 	thread.status = archived ? "archived" : "active";
-	if (archived && group.active === sessionId) rollActiveToFresh(state, lessonId, group);
+	if (archived && group.active === sessionId) rollActiveToFresh(state, key, group);
+	if (archived) repointMirrorsOff(state, key, sessionId, group);
 	if (!archived && group.active === null) {
 		group.active = sessionId;
 		state.lessonSessions[lessonId] = sessionId;
@@ -2385,12 +2478,14 @@ function archiveLessonThread(state, lessonId, sessionId, archived) {
 *  the host session face (no delete primitive) — it stays in the host's session
 *  list; the UI discloses this. Throws on unknown ids. */
 function deleteLessonThread(state, lessonId, sessionId) {
-	const group = state.lessonThreads?.[lessonId];
+	const key = ownerKeyFor(state, lessonId).key;
+	const group = state.lessonThreads?.[key];
 	if (group === void 0) throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} has no thread group`);
 	const idx = group.threads.findIndex((t) => t.id === sessionId);
 	if (idx < 0) throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} has no thread ${JSON.stringify(sessionId)}`);
 	group.threads.splice(idx, 1);
-	if (group.active === sessionId) rollActiveToFresh(state, lessonId, group);
+	if (group.active === sessionId) rollActiveToFresh(state, key, group);
+	repointMirrorsOff(state, key, sessionId, group);
 	return group;
 }
 function completeLesson(state, lessonId, now) {
@@ -2965,6 +3060,7 @@ function workbenchState(state, now) {
 		return {
 			courseId: course.id,
 			title: course.title,
+			threadScope: course.threadScope === "course" ? "course" : "lesson",
 			mastered: lessons.filter((l) => l.status === "mastered").length,
 			total: lessons.length,
 			avgMasteryPct: answered.length === 0 ? null : Math.round(answered.reduce((sum, l) => sum + (l.mastery ?? 0), 0) / answered.length * 100),
@@ -3025,9 +3121,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;
@@ -3272,6 +3373,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 });
@@ -3662,6 +3764,7 @@ function registerDashboard(webServer, deps) {
 					return;
 				}
 				const state = deps.store.get();
+				let group = null;
 				try {
 					if (body.op === "rename") {
 						if (typeof body.title !== "string" || body.title.trim() === "") {
@@ -3671,7 +3774,7 @@ function registerDashboard(webServer, deps) {
 							});
 							return;
 						}
-						renameLessonThread(state, body.lessonId, body.sessionId, body.title);
+						group = renameLessonThread(state, body.lessonId, body.sessionId, body.title);
 					} else if (body.op === "archive") {
 						if (typeof body.archived !== "boolean") {
 							sendJson(res, 400, {
@@ -3680,8 +3783,8 @@ function registerDashboard(webServer, deps) {
 							});
 							return;
 						}
-						archiveLessonThread(state, body.lessonId, body.sessionId, body.archived);
-					} else deleteLessonThread(state, body.lessonId, body.sessionId);
+						group = archiveLessonThread(state, body.lessonId, body.sessionId, body.archived);
+					} else group = deleteLessonThread(state, body.lessonId, body.sessionId);
 				} catch (error) {
 					sendJson(res, 404, {
 						ok: false,
@@ -3690,7 +3793,6 @@ function registerDashboard(webServer, deps) {
 					return;
 				}
 				deps.store.save();
-				const group = state.lessonThreads[body.lessonId];
 				sendJson(res, 200, {
 					ok: true,
 					active: group?.active ?? null,
@@ -3698,6 +3800,32 @@ function registerDashboard(webServer, deps) {
 				});
 				return;
 			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/course-scope") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.courseId !== "string" || body.scope !== "lesson" && body.scope !== "course") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "courseId and scope (lesson|course) required"
+					});
+					return;
+				}
+				try {
+					setCourseThreadScope(deps.store.get(), body.courseId, body.scope);
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+					return;
+				}
+				deps.store.save();
+				sendJson(res, 200, {
+					ok: true,
+					scope: body.scope
+				});
+				return;
+			}
 			if (req.method === "GET" && pathname === "/lookatstudy/api/course-pack") {
 				const courseId = new URL(req.url ?? "/", "http://x").searchParams.get("courseId") ?? "";
 				const course = findCourseForPack(deps.store.get(), courseId);
@@ -3779,6 +3907,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;
@@ -4863,6 +5011,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 全文 + 完整目录树 + 课程文件列表。
 *
@@ -5958,6 +6204,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.
@@ -6130,6 +6412,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.");
@@ -6143,7 +6426,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.");
@@ -6330,42 +6613,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
@@ -7028,6 +7325,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)."
@@ -7131,6 +7448,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
@@ -7151,6 +7472,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;
@@ -7287,7 +7610,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",
@@ -7367,6 +7694,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,
@@ -7380,7 +7712,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) {
@@ -7407,7 +7739,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) => {
@@ -7419,9 +7766,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 } : {}
 			};
 		},
@@ -10144,6 +10493,26 @@ function snapshotSectionText(state) {
 	if (snap.dueCount > 0) lines.push(`今日待复习: ${snap.dueCount} 项`);
 	if (snap.pendingProposal !== null) lines.push(`待决提案 ${snap.pendingProposal.id}: ${sanitizePromptText(snap.pendingProposal.rationale, 160)}(等学习者表态)`);
 	const focusCourse = state.courses.find((c) => c.id === snap.focus?.courseId);
+	if (focusCourse?.threadScope === "course" && snap.focus !== null) {
+		const group = state.lessonThreads[threadOwnerKey("course", focusCourse.id, snap.focus.lessonId)];
+		const touched = group?.threads.find((t) => t.id === group.active)?.touchedLessons;
+		const titleOf = /* @__PURE__ */ new Map();
+		for (const sec of focusCourse.sections) for (const l of sec.lessons) titleOf.set(l.id, l.title);
+		const digest = focusCourse.sections.flatMap((sec) => sec.lessons.filter((l) => l.kind !== "exam")).slice(0, 60).map((l) => {
+			const pct = l.mastery === null ? "" : ` ${String(Math.round(l.mastery * 100))}%`;
+			const weak = (conceptViews(l) ?? []).some((c) => c.weak) ? " ⚡薄弱" : "";
+			const fric = l.friction.length > 0 ? ` ⚑卡点${String(l.friction.length)}` : "";
+			return `- ${sanitizePromptText(l.title)}[${String(l.status)}${pct}]${weak}${fric}`;
+		});
+		lines.push("");
+		lines.push("【本课程进度摘要】(跨课时连续对话:本线跨课时延续,换课时不改线)");
+		lines.push(...digest);
+		if (touched !== void 0 && touched.length > 0) {
+			const names = touched.map((id) => sanitizePromptText(titleOf.get(id) ?? id)).join(" · ");
+			lines.push(`本对话线已覆盖课时: ${names}; 当前焦点: ${sanitizePromptText(snap.focus.lessonTitle)}`);
+		}
+		lines.push("出跨课时综合题前,先调用 study_lesson 调出相关课时正文再命题——组合题优先利用本线已有的跨课时现场。");
+	}
 	if (focusCourse?.languageTarget != null && focusCourse.languageTarget !== "") {
 		const t = localeToLanguageName(focusCourse.languageTarget);
 		lines.push("");