dsh-plugin-lookatstudy 0.21.0 → 0.22.0

package/lib/index.mjs

@@ -95,6 +95,12 @@ const ZH = {
 	"artifact.guess.title": "猜一猜",
 	"artifact.guess.pick": "我选「{label}」",
 	"artifact.guess.wait": "已记下你的直觉——导师下回合揭晓，看看你想得对不对",
+	"artifact.guess.revealed": "已揭晓——结论见导师的下一条回复",
+	"artifact.fold": "收起卡片（笔记区仍保留）",
+	"artifact.unfold": "展开卡片",
+	"artifact.kind.compare_table": "对照表",
+	"artifact.kind.code_walkthrough": "代码走查",
+	"artifact.kind.diagram": "示意图",
 	"artifact.sedimented": "有新的学习产物沉淀进笔记",
 	"zone.artifacts": "AI 产物",
 	"note.quote.ask": "提问这段",
@@ -214,6 +220,16 @@ const ZH = {
 	"palette.empty": "没有匹配项",
 	"threads.open": "{n} 条对话",
 	"threads.now": "当前",
+	"threads.new": "新建对话（下一条消息开新线）",
+	"threads.actions": "线程操作",
+	"rail.export.pack": "导出课程包（可再导入/分享的 Markdown）",
+	"rail.export.done": "课程包已下载：{file}",
+	"threads.rename": "重命名",
+	"threads.archive": "归档",
+	"threads.delete": "删除",
+	"threads.delete.confirm": "删除「{name}」这条对话线？插件侧记录会移除；宿主会话列表中的原会话保留。",
+	"review.banner": "正在复习：{lesson}",
+	"review.threadTitle": "复习：{lesson}",
 	"threads.label": "课时线程",
 	"meter.label": "上下文用量",
 	"meter.aria": "上下文已用 {pct}%",
@@ -229,6 +245,7 @@ const ZH = {
 	"settings.budget.on": "开启历史预算",
 	"settings.budget.off": "关闭历史预算",
 	"attach.sent": "我发了一个文件:{name}(工作区路径 {path})——请读取它再继续。",
+	"attach.remove": "移除待发附件",
 	"attach.fail": "附件上传失败",
 	"attach.label": "附件(≤20MiB,存入学习工作区)",
 	"rail.mastered": "毕业 {mastered}/{total} 课",
@@ -441,6 +458,12 @@ const EN = {
 	"artifact.guess.title": "Take a guess",
 	"artifact.guess.pick": "I pick \"{label}\"",
 	"artifact.guess.wait": "Your instinct is noted — the tutor reveals next turn",
+	"artifact.guess.revealed": "Revealed — see the tutor reply below for the answer",
+	"artifact.fold": "Fold card (kept in the notes zone)",
+	"artifact.unfold": "Unfold card",
+	"artifact.kind.compare_table": "Compare table",
+	"artifact.kind.code_walkthrough": "Code walkthrough",
+	"artifact.kind.diagram": "Diagram",
 	"artifact.sedimented": "A new artifact settled into the notebook",
 	"zone.artifacts": "AI artifacts",
 	"note.quote.ask": "Ask about this",
@@ -561,6 +584,16 @@ const EN = {
 	"threads.label": "Lesson threads",
 	"threads.open": "{n} threads",
 	"threads.now": "current",
+	"threads.new": "New thread (your next message starts it)",
+	"threads.actions": "Thread actions",
+	"rail.export.pack": "Export course pack (re-importable, shareable Markdown)",
+	"rail.export.done": "Course pack downloaded: {file}",
+	"threads.rename": "Rename",
+	"threads.archive": "Archive",
+	"threads.delete": "Delete",
+	"threads.delete.confirm": "Delete the thread \"{name}\"? The plugin-side record is removed; the original session stays in the host session list.",
+	"review.banner": "Reviewing: {lesson}",
+	"review.threadTitle": "Review: {lesson}",
 	"meter.label": "Context usage",
 	"meter.aria": "{pct}% of context used",
 	"meter.brk.system": "System prompt",
@@ -575,6 +608,7 @@ const EN = {
 	"settings.budget.on": "Enable history budget",
 	"settings.budget.off": "Disable history budget",
 	"attach.sent": "I attached a file: {name} (workspace path {path}) — read it before continuing.",
+	"attach.remove": "Remove pending attachment",
 	"attach.fail": "Attachment upload failed",
 	"attach.label": "Attach (≤20MiB, lands in the study workspace)",
 	"rail.mastered": "{mastered}/{total} lessons graduated",
@@ -778,10 +812,13 @@ function escapeHtml(text) {
 }
 /** Render inline markup (code, bold, italic, links, images) over escaped text.
 * Image src allowlist: https?:// or data:image/ — folder imports inline local
-* images as data URLs (capped), GitHub imports reference jsDelivr; anything
-* else stays literal text (no broken relative images, no exotic schemes). */
+* images as data URLs (capped), GitHub imports reference jsDelivr; the
+* plugin's own attachment route (/lookatstudy/api/attachment/<name>, issue #7
+* — same-origin, server-side validated) renders workspace attachments;
+* anything else stays literal text (no broken relative images, no exotic
+* schemes). */
 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]+)\)/g, (_m, alt, src) => `<img src="${src}" alt="${alt}" loading="lazy">`).replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, "<a href=\"$2\" target=\"_blank\" rel=\"noreferrer\">$1</a>");
+	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
@@ -918,6 +955,135 @@ function renderMarkdown(md) {
 	return out.join("\n");
 }
 //#endregion
+//#region src/vendor/markdown-course.ts
+/**
+* GitHub 风格的 anchor 生成：小写、去一组标点（保留中文等 unicode）、每个空格单独转 -。
+* 注意：**不合并多 -**（"A & B" → 去 & 留两空格 → "a--b"，与 GitHub slugger 一致）。
+* 与 seed.ts 的锚点对齐。
+*/
+function titleToAnchor(title) {
+	return title.toLowerCase().trim().replace(/[!"#$%&'()*+,./:;<=>?@[\\\]^`{|}~]/g, "").replace(/ /g, "-").replace(/^-|-$/g, "");
+}
+/**
+* 清洗课时/章节标题 — 去 emoji、多余空格、markdown 格式符号。
+* "🛠 The Modern FDE Stack" → "The Modern FDE Stack"
+* "## [Pre-lecture quiz](url)" → "Pre-lecture quiz"
+*/
+function cleanTitle(raw) {
+	return raw.replace(/[\u{1F000}-\u{1FFFF}\u{2600}-\u{27BF}\u{2190}-\u{21FF}\u{2B00}-\u{2BFF}]/gu, "").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/^#+\s*/, "").trim().replace(/\s+/g, " ").replace(/^[·\-.\s]+|[·\-.\s]+$/g, "").trim();
+}
+/**
+* 解析 markdown 为课程树。
+* 容错：H3 出现在任何 H2 之前 → 归到一个 "(前言)" section。
+*/
+function parseMarkdownToCourse(md) {
+	const lines = md.split(/\r?\n/);
+	const sections = [];
+	let title = "(untitled)";
+	let currentSection = null;
+	let bodyBuffer = [];
+	let inCodeFence = false;
+	const flushLessonBody = () => {
+		if (currentSection && currentSection.lessons.length > 0) currentSection.lessons[currentSection.lessons.length - 1].body = bodyBuffer.join("\n").trim();
+		bodyBuffer = [];
+	};
+	for (const line of lines) {
+		if (/^(\s*)(```|~~~)/.test(line)) {
+			inCodeFence = !inCodeFence;
+			bodyBuffer.push(line);
+			continue;
+		}
+		if (inCodeFence) {
+			bodyBuffer.push(line);
+			continue;
+		}
+		if (/^#\s+/.test(line) && title === "(untitled)") {
+			title = cleanTitle(line.replace(/^#\s+/, "").trim());
+			continue;
+		}
+		if (/^##\s+/.test(line)) {
+			flushLessonBody();
+			const sectionTitle = cleanTitle(line.replace(/^##\s+/, "").trim());
+			currentSection = {
+				title: sectionTitle,
+				anchor: titleToAnchor(sectionTitle),
+				lessons: []
+			};
+			sections.push(currentSection);
+			continue;
+		}
+		if (/^###\s+/.test(line)) {
+			flushLessonBody();
+			const lessonTitle = cleanTitle(line.replace(/^###\s+/, "").trim());
+			if (!currentSection) {
+				currentSection = {
+					title: "(前言)",
+					anchor: titleToAnchor("前言"),
+					lessons: []
+				};
+				sections.push(currentSection);
+			}
+			currentSection.lessons.push({
+				title: lessonTitle,
+				anchor: titleToAnchor(lessonTitle),
+				body: ""
+			});
+			continue;
+		}
+		bodyBuffer.push(line);
+	}
+	flushLessonBody();
+	return {
+		title,
+		sections
+	};
+}
+//#endregion
+//#region src/export-pack.ts
+/** Find the course for export; null when the id is unknown. */
+function findCourseForPack(state, courseId) {
+	return state.courses.find((c) => c.id === courseId) ?? null;
+}
+/** The machine-readable pack: everything needed to restore the course. */
+function coursePackOf(course, now = /* @__PURE__ */ new Date()) {
+	return {
+		kind: "lookatstudy-course-pack",
+		version: 1,
+		exportedAt: now.toISOString(),
+		course: {
+			title: course.title,
+			languageTarget: course.languageTarget ?? null,
+			sections: course.sections.map((s) => ({
+				title: s.title,
+				lessons: s.lessons.filter((l) => l.kind !== "exam").map((l) => ({
+					title: l.title,
+					kind: l.kind,
+					body: l.body
+				}))
+			}))
+		}
+	};
+}
+/** The markdown rendering — the zero-LLM parser's own format. */
+function coursePackMarkdown(course) {
+	const out = [`# ${course.title}`, ""];
+	for (const section of course.sections) {
+		out.push(`## ${section.title}`, "");
+		for (const lesson of section.lessons) {
+			if (lesson.kind === "exam") continue;
+			out.push(`### ${lesson.title}`, "");
+			const body = lesson.body.replace(/\s+$/, "");
+			if (body !== "") out.push(body, "");
+		}
+	}
+	return `${out.join("\n")}\n`;
+}
+/** Upstream's naming: sanitized title, `.lookatstudy-pack.md` suffix. */
+function packFileName(course) {
+	const base = course.title.replace(/[/\\:*?"<>|#\s]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
+	return `${base !== "" ? base : "course"}.lookatstudy-pack.md`;
+}
+//#endregion
 //#region src/vendor/math-normalize.ts
 /**
 * math-normalize —— 数学记法归一(v0.19 数学渲染前置,纯函数)。
@@ -1350,6 +1516,7 @@ function emptyState() {
 		artifacts: {},
 		proposals: [],
 		lessonSessions: {},
+		lessonThreads: {},
 		lastConsolidatedAt: null,
 		xp: {
 			total: 0,
@@ -1423,6 +1590,35 @@ function loadState(path) {
 		memoryPatterns: raw.memoryPatterns ?? {},
 		proposals: raw.proposals ?? [],
 		lessonSessions: raw.lessonSessions ?? {},
+		lessonThreads: (() => {
+			const groups = {};
+			for (const [lessonId, group] of Object.entries(raw.lessonThreads ?? {})) if (group !== null && typeof group === "object" && Array.isArray(group.threads)) groups[lessonId] = {
+				active: typeof group.active === "string" ? group.active : null,
+				threads: group.threads
+			};
+			for (const [lessonId, sessionId] of Object.entries(raw.lessonSessions ?? {})) {
+				if (typeof sessionId !== "string" || groups[lessonId] !== void 0) continue;
+				let title = lessonId;
+				for (const course of courses) for (const section of course.sections) {
+					const hit = section.lessons.find((l) => l.id === lessonId);
+					if (hit !== void 0) {
+						title = hit.title;
+						break;
+					}
+				}
+				const now = (/* @__PURE__ */ new Date()).toISOString();
+				groups[lessonId] = {
+					active: sessionId,
+					threads: [{
+						id: sessionId,
+						title,
+						createdAt: now,
+						lastAt: now
+					}]
+				};
+			}
+			return groups;
+		})(),
 		artifacts: raw.artifacts ?? {},
 		lastConsolidatedAt: raw.lastConsolidatedAt ?? null,
 		xp: raw.xp ?? {
@@ -1496,9 +1692,11 @@ function freshLesson(title, anchor, body, kind = "study") {
 * @returns the imported (or pre-existing) course.
 */
 function importCourse(state, parsed, source, sourceRef, languageTarget) {
-	const id = slugify(parsed.title);
-	const existing = state.courses.find((c) => c.id === id);
-	if (existing) return existing;
+	const base = slugify(parsed.title);
+	const sameTitle = state.courses.find((c) => c.id === base && c.title === parsed.title);
+	if (sameTitle !== void 0) return sameTitle;
+	let id = base;
+	for (let n = 2; state.courses.some((c) => c.id === id); n++) id = `${base}-${String(n)}`;
 	const course = {
 		id,
 		title: parsed.title,
@@ -1956,6 +2154,96 @@ function recordAnswer(state, lessonId, correct, concept, now) {
 * @param now - current time.
 * @returns completion result including the unlocked lessons.
 */
+/**
+* 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.
+*/
+function bindLessonThread(state, lessonId, sessionId, title) {
+	state.lessonThreads ??= {};
+	const group = state.lessonThreads[lessonId] ?? {
+		active: null,
+		threads: []
+	};
+	if (sessionId === null) {
+		group.active = null;
+		state.lessonThreads[lessonId] = group;
+		delete state.lessonSessions[lessonId];
+		return group;
+	}
+	const existing = group.threads.find((t) => t.id === sessionId);
+	if (existing === void 0) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		group.threads.push({
+			id: sessionId,
+			title: (title ?? "").trim() !== "" ? title.trim() : lessonId,
+			createdAt: now,
+			lastAt: now
+		});
+	} else {
+		existing.lastAt = (/* @__PURE__ */ new Date()).toISOString();
+		if (existing.status === "archived") existing.status = "active";
+	}
+	group.active = sessionId;
+	state.lessonThreads[lessonId] = 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) {
+	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];
+}
+/** 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];
+	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)}`);
+	const clean = title.trim();
+	if (clean !== "") thread.title = clean;
+	return group;
+}
+/** Archive (or restore) a thread. Archiving the current thread rolls the
+*  active pointer to the freshest remaining live thread — upstream's archived
+*  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];
+	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 === null) {
+		group.active = sessionId;
+		state.lessonSessions[lessonId] = sessionId;
+	}
+	return group;
+}
+/** Remove a thread from its group (sediment discipline: the OTHER threads and
+*  the group itself survive). The dsh session itself cannot be deleted through
+*  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];
+	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);
+	return group;
+}
 function completeLesson(state, lessonId, now) {
 	const ref = findLesson(state, lessonId);
 	if (ref.lesson.status === "locked") throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} is locked; complete earlier lessons first`);
@@ -2613,6 +2901,7 @@ function workbenchState(state, now) {
 			};
 		})(),
 		lessonSessions: state.lessonSessions,
+		lessonThreads: state.lessonThreads ?? {},
 		progress: (() => {
 			const xp = levelFromTotalXp(state.xp.total);
 			return {
@@ -3075,18 +3364,84 @@ function registerDashboard(webServer, deps) {
 			if (req.method === "POST" && pathname === "/lookatstudy/api/lesson-session") {
 				const body = await readJsonBodySafe(req, res);
 				if (body === void 0) return;
-				if (typeof body.lessonId !== "string" || typeof body.sessionId !== "string") {
+				if (typeof body.lessonId !== "string" || body.sessionId !== null && typeof body.sessionId !== "string") {
 					sendJson(res, 400, {
 						ok: false,
-						error: "lessonId and sessionId (strings) required"
+						error: "lessonId and sessionId (string or null) required"
 					});
 					return;
 				}
-				deps.store.get().lessonSessions[body.lessonId] = body.sessionId;
+				const title = typeof body.title === "string" ? body.title : null;
+				bindLessonThread(deps.store.get(), body.lessonId, body.sessionId, title);
 				deps.store.save();
 				sendJson(res, 200, { ok: true });
 				return;
 			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/lesson-thread") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.lessonId !== "string" || typeof body.sessionId !== "string" || body.op !== "rename" && body.op !== "archive" && body.op !== "delete") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "lessonId, sessionId and op (rename|archive|delete) required"
+					});
+					return;
+				}
+				const state = deps.store.get();
+				try {
+					if (body.op === "rename") {
+						if (typeof body.title !== "string" || body.title.trim() === "") {
+							sendJson(res, 400, {
+								ok: false,
+								error: "rename requires a non-empty title"
+							});
+							return;
+						}
+						renameLessonThread(state, body.lessonId, body.sessionId, body.title);
+					} else if (body.op === "archive") {
+						if (typeof body.archived !== "boolean") {
+							sendJson(res, 400, {
+								ok: false,
+								error: "archive requires a boolean archived"
+							});
+							return;
+						}
+						archiveLessonThread(state, body.lessonId, body.sessionId, body.archived);
+					} else deleteLessonThread(state, body.lessonId, body.sessionId);
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+					return;
+				}
+				deps.store.save();
+				const group = state.lessonThreads[body.lessonId];
+				sendJson(res, 200, {
+					ok: true,
+					active: group?.active ?? null,
+					threads: group?.threads.length ?? 0
+				});
+				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);
+				if (course === null) {
+					sendJson(res, 404, {
+						ok: false,
+						error: `unknown courseId: ${JSON.stringify(courseId)}`
+					});
+					return;
+				}
+				sendJson(res, 200, {
+					ok: true,
+					fileName: packFileName(course),
+					markdown: coursePackMarkdown(course),
+					pack: coursePackOf(course)
+				});
+				return;
+			}
 			if (req.method === "POST" && pathname === "/lookatstudy/api/tts") {
 				const body = await readJsonBodySafe(req, res);
 				if (body === void 0) return;
@@ -3188,6 +3543,36 @@ function registerDashboard(webServer, deps) {
 				}
 				return;
 			}
+			if (req.method === "GET" && pathname.startsWith("/lookatstudy/api/attachment/")) {
+				let name = "";
+				try {
+					name = decodeURIComponent(pathname.slice(28));
+				} catch {
+					name = "";
+				}
+				if (name === "" || name.includes("..") || /[\\/]/.test(name) || name.length > 250) {
+					sendJson(res, 404, {
+						ok: false,
+						error: "not found"
+					});
+					return;
+				}
+				try {
+					const buf = readFileSync(join(deps.studyAreaPath, "attachments", name));
+					const ext = name.slice(name.lastIndexOf(".") + 1).toLowerCase();
+					const mime = ext === "png" ? "image/png" : ext === "jpg" || ext === "jpeg" ? "image/jpeg" : ext === "gif" ? "image/gif" : ext === "webp" ? "image/webp" : ext === "bmp" ? "image/bmp" : "application/octet-stream";
+					res.writeHead(200, {
+						"content-type": mime,
+						"cache-control": "public, max-age=31536000, immutable"
+					}).end(buf);
+				} catch {
+					sendJson(res, 404, {
+						ok: false,
+						error: "not found"
+					});
+				}
+				return;
+			}
 			sendJson(res, 404, {
 				ok: false,
 				error: "not found"
@@ -3263,90 +3648,6 @@ function registerStudyCommand(commands, deps) {
 	});
 }
 //#endregion
-//#region src/vendor/markdown-course.ts
-/**
-* GitHub 风格的 anchor 生成：小写、去一组标点（保留中文等 unicode）、每个空格单独转 -。
-* 注意：**不合并多 -**（"A & B" → 去 & 留两空格 → "a--b"，与 GitHub slugger 一致）。
-* 与 seed.ts 的锚点对齐。
-*/
-function titleToAnchor(title) {
-	return title.toLowerCase().trim().replace(/[!"#$%&'()*+,./:;<=>?@[\\\]^`{|}~]/g, "").replace(/ /g, "-").replace(/^-|-$/g, "");
-}
-/**
-* 清洗课时/章节标题 — 去 emoji、多余空格、markdown 格式符号。
-* "🛠 The Modern FDE Stack" → "The Modern FDE Stack"
-* "## [Pre-lecture quiz](url)" → "Pre-lecture quiz"
-*/
-function cleanTitle(raw) {
-	return raw.replace(/[\u{1F000}-\u{1FFFF}\u{2600}-\u{27BF}\u{2190}-\u{21FF}\u{2B00}-\u{2BFF}]/gu, "").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/^#+\s*/, "").trim().replace(/\s+/g, " ").replace(/^[·\-.\s]+|[·\-.\s]+$/g, "").trim();
-}
-/**
-* 解析 markdown 为课程树。
-* 容错：H3 出现在任何 H2 之前 → 归到一个 "(前言)" section。
-*/
-function parseMarkdownToCourse(md) {
-	const lines = md.split(/\r?\n/);
-	const sections = [];
-	let title = "(untitled)";
-	let currentSection = null;
-	let bodyBuffer = [];
-	let inCodeFence = false;
-	const flushLessonBody = () => {
-		if (currentSection && currentSection.lessons.length > 0) currentSection.lessons[currentSection.lessons.length - 1].body = bodyBuffer.join("\n").trim();
-		bodyBuffer = [];
-	};
-	for (const line of lines) {
-		if (/^(\s*)(```|~~~)/.test(line)) {
-			inCodeFence = !inCodeFence;
-			bodyBuffer.push(line);
-			continue;
-		}
-		if (inCodeFence) {
-			bodyBuffer.push(line);
-			continue;
-		}
-		if (/^#\s+/.test(line) && title === "(untitled)") {
-			title = cleanTitle(line.replace(/^#\s+/, "").trim());
-			continue;
-		}
-		if (/^##\s+/.test(line)) {
-			flushLessonBody();
-			const sectionTitle = cleanTitle(line.replace(/^##\s+/, "").trim());
-			currentSection = {
-				title: sectionTitle,
-				anchor: titleToAnchor(sectionTitle),
-				lessons: []
-			};
-			sections.push(currentSection);
-			continue;
-		}
-		if (/^###\s+/.test(line)) {
-			flushLessonBody();
-			const lessonTitle = cleanTitle(line.replace(/^###\s+/, "").trim());
-			if (!currentSection) {
-				currentSection = {
-					title: "(前言)",
-					anchor: titleToAnchor("前言"),
-					lessons: []
-				};
-				sections.push(currentSection);
-			}
-			currentSection.lessons.push({
-				title: lessonTitle,
-				anchor: titleToAnchor(lessonTitle),
-				body: ""
-			});
-			continue;
-		}
-		bodyBuffer.push(line);
-	}
-	flushLessonBody();
-	return {
-		title,
-		sections
-	};
-}
-//#endregion
 //#region src/vendor/local-folder-scanner.ts
 /**
 * 本地文件夹通用扫描器 —— 把任意课程文件夹(如 Coursera 下载包)递归扫描成文档清单。
@@ -4805,6 +5106,196 @@ function prepareSingleDoc(name, markdown, stem) {
 	return chunkHeadinglessText(md, (stem ?? name.replace(/\s+/g, "-").slice(0, 40)) || "text");
 }
 //#endregion
+//#region src/vendor/bilibili-wbi.ts
+/**
+* B站 Wbi 签名(纯函数)——playurl 等 web 接口免登录访问的前提。
+* 算法来自社区文档 bilibili-API-collect(docs/misc/sign/wbi.md):
+* nav 接口取 img_key/sub_key → 重排表拼 mixin_key → 参数排序+过滤+chrFilter
+* → query + wts → MD5 = w_rid。纯函数,verify 用固定 key 断言 w_rid。
+*/
+/** 重排映射表(社区文档公开常量,2023 引入后保持稳定;漂移时接口回 -352,live-test 可发现) */
+const MIXIN_KEY_ENC_TAB = [
+	46,
+	47,
+	18,
+	2,
+	53,
+	8,
+	23,
+	32,
+	15,
+	50,
+	10,
+	31,
+	58,
+	3,
+	45,
+	35,
+	27,
+	43,
+	5,
+	49,
+	33,
+	9,
+	42,
+	19,
+	29,
+	28,
+	14,
+	39,
+	12,
+	38,
+	41,
+	13,
+	37,
+	48,
+	7,
+	16,
+	24,
+	55,
+	40,
+	61,
+	26,
+	17,
+	0,
+	1,
+	60,
+	51,
+	30,
+	4,
+	22,
+	25,
+	54,
+	21,
+	56,
+	59,
+	6,
+	63,
+	57,
+	62,
+	11,
+	36,
+	20,
+	34,
+	44,
+	52
+];
+function getMixinKey(imgKey, subKey) {
+	const raw = imgKey + subKey;
+	return MIXIN_KEY_ENC_TAB.map((n) => raw[n]).join("").slice(0, 32);
+}
+/** 从 nav 接口的 img_url/sub_url 里剥文件名(去扩展名)得 img_key/sub_key。 */
+function extractKeysFromNavUrl(imgUrl, subUrl) {
+	const stem = (u) => {
+		return ((u.split("?")[0] ?? u).split("/").pop() ?? "").replace(/\.[^.]+$/, "");
+	};
+	return {
+		imgKey: stem(imgUrl),
+		subKey: stem(subUrl)
+	};
+}
+const CHR_FILTER = /[!'()*]/g;
+/** 对查询参数做 Wbi 签名,返回完整 query(含 w_rid/wts)。 */
+function encWbi(params, mixinKey, nowSec = Math.floor(Date.now() / 1e3)) {
+	const filtered = Object.entries(params).filter(([k]) => k !== "w_rid" && k !== "wts").map(([k, v]) => [k, String(v)]);
+	filtered.push(["wts", String(nowSec)]);
+	filtered.sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+	const query = filtered.map(([k, v]) => {
+		const safeVal = v.replace(CHR_FILTER, "");
+		return `${encodeURIComponent(k)}=${encodeURIComponent(safeVal)}`;
+	}).join("&");
+	return `${query}&w_rid=${createHash("md5").update(query + mixinKey, "utf8").digest("hex")}`;
+}
+//#endregion
+//#region src/vendor/subtitle-parse.ts
+/**
+* 字幕文件 → 纯文本(vtt/srt)——视频导入的"字幕优先"路径:有 CC/自动字幕的
+* 视频直接出文本,零转写零模型。纯函数,verify 直测。
+*
+* 处理(全部是**机器生成的刚性格式指纹**,高置信度规则;语义判断不在此层):
+* - WEBVTT 头/时间轴行/CUE 编号/NOTE 块/样式行剥除;
+* - 行内标签与打词时间戳剥除(`<c>`、`<00:00:01.359>`);
+* - 滚动字幕去重:YouTube 自动字幕的滚动窗结构是 cue N+1 的首行复述 cue N 的
+*   尾行,相邻去重不够(隔一行就重复),须近窗(最近 2 行)去重——2026-08-23
+*   真实样本驱动修复(经典症状:每句话在成文里出现两遍);
+* - HTML 实体解码(&amp; 等;字幕 XML 转义源);
+* - 整行自动标记剥除(封闭集 [Music]/[Applause]… 只删整行,不碰行内——
+*   行内方括号可能是正文);
+* - 行首 `>>` 换说话人标记剥除(YouTube 自动字幕机器标记);
+* - CJK 感知接行:汉字/中文标点之间不加空格(句与句直接相连),拉丁文之间
+*   加空格——中文字幕逐句 join(" ") 会在全文制造 "汉字 空格 汉字" 噪声。
+*/
+/** 单条 cue 的时间轴行特征:00:00:01.000 --> 00:00:03.000(毫秒分隔符兼容 , 和 .) */
+const CUE_TIMING = /^\d{1,2}:\d{2}(?::\d{2})?[.,]\d{3}\s*-->/;
+/** YouTube 自动字幕的整行机器标记(封闭集,只删整行)。 */
+const AUTO_MARKERS = /^\[(music|applause|laughter|laughs?|silence|inaudible|cheering|foreign|blank[_\s]?audio|music playing|noise)\]$/i;
+/** 字幕常见的 XML/HTML 实体(未列出的实体原样保留,不做激进猜测)。 */
+const ENTITIES = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'",
+	nbsp: " "
+};
+function decodeEntities(s) {
+	return s.replace(/&([a-z]+);/gi, (m, name) => ENTITIES[name.toLowerCase()] ?? m).replace(/&#(\d+);/g, (m, d) => {
+		try {
+			return String.fromCodePoint(Number(d));
+		} catch {
+			return m;
+		}
+	});
+}
+/** CJK 统一表意文字/中文标点/全角符号——接行时两侧任一是则不加空格。 */
+const CJKISH = /[\u3000-\u303f\u4e00-\u9fff\uff00-\uffef]/;
+/** CJK 感知拼接:空段跳过;相邻两侧任一是 CJK 字符则直连,否则加空格。 */
+function cjkJoin(parts) {
+	let s = "";
+	for (const p of parts) {
+		if (!s) {
+			s = p;
+			continue;
+		}
+		const last = s[s.length - 1];
+		s += CJKISH.test(last) || CJKISH.test(p[0]) ? p : ` ${p}`;
+	}
+	return s;
+}
+function parseSubtitleToText(raw) {
+	const lines = raw.replace(/\r\n/g, "\n").split("\n");
+	const out = [];
+	/** 近窗去重:最近 2 条已输出的行(滚动字幕 cue 间隔行重复)。 */
+	const recent = [];
+	let inNote = false;
+	for (const line of lines) {
+		const t = line.trim();
+		if (!t) {
+			inNote = false;
+			continue;
+		}
+		if (/^WEBVTT/i.test(t)) continue;
+		if (t.startsWith("NOTE")) {
+			inNote = true;
+			continue;
+		}
+		if (inNote) continue;
+		if (CUE_TIMING.test(t)) continue;
+		if (/^\d+$/.test(t)) continue;
+		if (/^(Kind:|Language:|Style:|Region:|NOTE)/i.test(t)) continue;
+		let text = t.replace(/<[^>]+>/g, "").trim();
+		if (!text) continue;
+		if (AUTO_MARKERS.test(text)) continue;
+		text = decodeEntities(text);
+		if (recent.includes(text)) continue;
+		recent.push(text);
+		if (recent.length > 2) recent.shift();
+		const spoken = text.replace(/^>{2,}\s*/, "").trim();
+		if (spoken) out.push(spoken);
+	}
+	return cjkJoin(out).replace(/\s+/g, " ").trim();
+}
+//#endregion
 //#region src/vendor/video-meta.ts
 const BILI_HEADERS = {
 	"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0 Safari/537.36",
@@ -4836,12 +5327,126 @@ async function fetchBilibiliMeta(url, fetchFn, signal) {
 	})).json();
 	if (resp.code !== 0 || !resp.data) throw new Error(`B站接口返回错误(${resp.code} ${resp.message ?? ""})`);
 	const d = resp.data;
+	const pages = d.pages ?? [];
 	return {
 		title: (d.title ?? "").trim() || "未命名视频",
 		owner: (d.owner?.name ?? "").trim(),
 		desc: (d.desc ?? "").trim(),
-		parts: (d.pages ?? []).map((p) => (p.part ?? "").trim()).filter(Boolean),
-		duration: d.duration ?? 0
+		parts: pages.map((p) => (p.part ?? "").trim()).filter(Boolean),
+		duration: d.duration ?? 0,
+		cids: pages.map((p) => Number(p.cid ?? 0))
+	};
+}
+/** 字幕语言优先级:中文(含 AI)→ 英文(含 AI)→ 其他,同档取第一个。 */
+function pickCcLane(subs) {
+	const usable = subs.filter((s) => typeof s.subtitle_url === "string" && s.subtitle_url !== "");
+	if (usable.length === 0) return null;
+	const rank = (lan) => {
+		if (/^zh-Hans$|^zh-CN$|^zh$/.test(lan)) return 0;
+		if (/^ai-zh/.test(lan)) return 1;
+		if (/^en/.test(lan)) return 2;
+		if (/^ai-en/.test(lan)) return 3;
+		return 4;
+	};
+	const best = usable.map((s) => ({
+		lan: String(s.lan ?? ""),
+		url: String(s.subtitle_url),
+		r: rank(String(s.lan ?? "")),
+		i: usable.indexOf(s)
+	})).sort((a, b) => a.r !== b.r ? a.r - b.r : a.i - b.i)[0];
+	return {
+		lan: best.lan,
+		url: best.url
+	};
+}
+/**
+* 拉取一个 B站视频的 CC 字幕(逐分P)。分P 语义对齐上游:`?p=N` 只导该集,
+* 未带 p 的多分P导整季(≤maxPages,超出截断并在 missing 里披露)。
+* 返回 parts(有字幕的分P)与 missing(无字幕的分P名)——parts 为空时调用方
+* 抛诚实错误。签名材料(nav 取 img/sub_key)整季共用一次。
+*/
+async function fetchBilibiliSubtitles(url, fetchFn, signal, opts) {
+	const meta = await fetchBilibiliMeta(url, fetchFn, signal);
+	const id = parseBilibiliId(url) ?? await (async () => {
+		return parseBilibiliId((await fetchFn(url, {
+			signal,
+			headers: BILI_HEADERS
+		})).url);
+	})();
+	if (!id) throw new Error("不是可识别的 B站视频链接(BV/av 号缺失)");
+	const view = await (await fetchFn(`https://api.bilibili.com/x/web-interface/view?${id.bvid ? `bvid=${id.bvid}` : `aid=${id.aid}`}`, {
+		signal,
+		headers: BILI_HEADERS
+	})).json();
+	if (view.code !== 0 || !view.data) throw new Error(`B站视频信息获取失败: ${view.message ?? ""}`);
+	const pages = view.data.pages ?? [];
+	const maxPages = Math.max(1, opts?.maxPages ?? 200);
+	const partName = (i) => `P${pages[i]?.page ?? i + 1} ${(pages[i]?.part ?? meta.title).trim()}`.trim();
+	let targets;
+	if (id.page !== void 0) {
+		const idx = pages.length > 0 ? Math.min(id.page, pages.length) - 1 : -1;
+		targets = [{
+			cid: Number(idx >= 0 ? pages[idx].cid : view.data.cid ?? meta.cids[0] ?? 0),
+			name: pages.length > 1 ? partName(idx) : meta.title
+		}];
+	} else if (pages.length > 1) targets = pages.slice(0, maxPages).map((pg, i) => ({
+		cid: Number(pg.cid ?? 0),
+		name: partName(i)
+	}));
+	else targets = [{
+		cid: Number(view.data.cid ?? meta.cids[0] ?? 0),
+		name: meta.title
+	}];
+	const wbiImg = (await (await fetchFn("https://api.bilibili.com/x/web-interface/nav", {
+		signal,
+		headers: BILI_HEADERS
+	})).json()).data?.wbi_img ?? {};
+	const { imgKey, subKey } = extractKeysFromNavUrl(wbiImg.img_url ?? "", wbiImg.sub_url ?? "");
+	const mixinKey = getMixinKey(imgKey, subKey);
+	const idKey = id.bvid ? "bvid" : "aid";
+	const idVal = id.bvid ?? String(id.aid ?? "");
+	const parts = [];
+	const missing = [];
+	for (const t of targets) {
+		if (signal?.aborted) break;
+		const player = await (await fetchFn(`https://api.bilibili.com/x/player/wbi/v2?${encWbi({
+			[idKey]: idVal,
+			cid: t.cid
+		}, mixinKey)}`, {
+			signal,
+			headers: BILI_HEADERS
+		})).json();
+		if (player.code !== 0) throw new Error(`B站播放器接口返回错误(${t.name}): ${player.message ?? ""}(可能需要登录或为付费内容)`);
+		const lane = pickCcLane(player.data?.subtitle?.subtitles ?? []);
+		if (lane === null) {
+			missing.push(t.name);
+			continue;
+		}
+		const raw = await (await fetchFn(lane.url.startsWith("//") ? `https:${lane.url}` : lane.url, {
+			signal,
+			headers: BILI_HEADERS
+		})).text();
+		let text = "";
+		try {
+			text = (JSON.parse(raw).body ?? []).map((b) => (b.content ?? "").trim()).filter(Boolean).join("");
+		} catch {
+			text = parseSubtitleToText(raw);
+		}
+		if (text.replace(/\s+/g, "").length < 50) {
+			missing.push(t.name);
+			continue;
+		}
+		parts.push({
+			name: t.name,
+			text,
+			lan: lane.lan
+		});
+	}
+	return {
+		title: meta.title,
+		owner: meta.owner,
+		parts,
+		missing
 	};
 }
 //#endregion
@@ -6067,7 +6672,7 @@ function studyTools(store, deps = {}) {
 	});
 	const importUrl = defineTool({
 		name: "study_import_url",
-		description: "Import any learning URL by auto-routing: GitHub repos reuse the repository import; arXiv papers download the PDF and extract its text layer; other http(s) pages get web-article extraction (nav/ads stripped, honest failure on non-article pages). All routes return the same design brief the tutor designs against (apply with study_apply_design). Video links (B站/YouTube/抖音) are classified with title metadata but cannot be transcribed here — ask the learner to paste the transcript/subtitles and use study_import_markdown instead.",
+		description: "Import any learning URL by auto-routing: GitHub repos reuse the repository import; arXiv papers download the PDF and extract its text layer; other http(s) pages get web-article extraction (nav/ads stripped, honest failure on non-article pages). All routes return the same design brief the tutor designs against (apply with study_apply_design). B站 video links import their CC subtitles directly (a multi-part series becomes one document per part; ?p=N picks one episode); videos without CC, and YouTube/抖音 links, still ask the learner to paste the transcript (study_import_markdown).",
 		parameters: {
 			url: {
 				type: "string",
@@ -6090,9 +6695,25 @@ function studyTools(store, deps = {}) {
 			const fetchFn = signalFetch(exec.signal, baseFetch);
 			if (route.kind === "video") {
 				if (route.source === "bilibili") {
-					const meta = await fetchBilibiliMeta(route.url, fetchFn, exec.signal);
-					const parts = meta.parts.length > 0 ? `, ${meta.parts.length} 分P` : "";
-					throw new Error(`lookatstudy-plugin: B站视频《${meta.title}》(UP:${meta.owner}${parts})已识别,但插件内无字幕拉取与音频转写能力。请让学习者把字幕/文稿粘贴进来,用 study_import_markdown 导入。`);
+					const part = args.part ?? 1;
+					const identity = normalizeUrlIdentity(route.url);
+					const existing = part <= 1 ? store.get().courses.find((c) => c.source === "url" && c.sourceRef === identity) : void 0;
+					if (existing !== void 0) return {
+						status: "imported",
+						...toImportValue(existing)
+					};
+					const cc = await fetchBilibiliSubtitles(route.url, fetchFn, exec.signal);
+					if (cc.parts.length === 0) {
+						const scope = cc.missing.length > 1 ? `共 ${cc.missing.length} 个分P均无` : "无";
+						throw new Error(`lookatstudy-plugin: B站视频《${cc.title}》(UP:${cc.owner})${scope}可用 CC 字幕,插件不拉音轨转写。请让学习者把字幕/文稿粘贴进来,用 study_import_markdown 导入。`);
+					}
+					const docs = cc.parts.flatMap((p, i) => prepareSingleDoc(`bili-p${String(i + 1)}`, `# ${p.name}
+
+${p.text}`));
+					if (docs.length === 0) throw new Error("lookatstudy-plugin: CC subtitle text was empty after chunking");
+					pendingDesign = buildPendingDesignFromUrl(identity, cc.title, docs);
+					pendingPart = part;
+					return designRequiredValue(pendingDesign, part);
 				}
 				throw new Error(`lookatstudy-plugin: ${route.url} 是视频链接(YouTube/抖音需要 yt-dlp,插件环境不可用)。请让学习者把字幕/文稿粘贴进来,用 study_import_markdown 导入。`);
 			}
@@ -6129,7 +6750,7 @@ function studyTools(store, deps = {}) {
 			pendingPart = part;
 			return designRequiredValue(pendingDesign, part);
 		},
-		timeoutMs: 12e4,
+		timeoutMs: 18e4,
 		presentCall: (args) => ({
 			card: "generic",
 			title: `Import URL: ${args.url}`,
@@ -6223,6 +6844,11 @@ function studyTools(store, deps = {}) {
 						type: "integer",
 						required: true
 					},
+					created: {
+						type: "boolean",
+						required: true,
+						description: "False when an existing course short-circuited the import (same title) — the design did NOT land as a new course."
+					},
 					languageTarget: {
 						type: "string",
 						description: "Present only when the course teaches a language itself (BCP-47); the tutor then keeps quiz material in the target language."
@@ -6231,7 +6857,7 @@ function studyTools(store, deps = {}) {
 			},
 			render: (_args, value) => [{
 				type: "text",
-				text: `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.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) {
@@ -6261,7 +6887,13 @@ function studyTools(store, deps = {}) {
 			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);
 			requireParsedLessons(parsed);
 			const languageTarget = typeof args.languageTarget === "string" && args.languageTarget.trim() !== "" ? args.languageTarget.trim().slice(0, 35) : null;
-			const value = mutate((state) => toImportValue(importCourse(state, parsed, pd.source, pd.url, languageTarget)));
+			const value = mutate((state) => {
+				const before = state.courses.length;
+				return {
+					...toImportValue(importCourse(state, parsed, pd.source, pd.url, languageTarget)),
+					created: state.courses.length > before
+				};
+			});
 			pendingDesign = null;
 			pendingPart = 1;
 			return {