dsh-plugin-lookatstudy 0.8.1 → 0.9.1

package/README.md

@@ -1,6 +1,6 @@
 # dsh-plugin-lookatstudy
 
-Turn any markdown document, local folder, or GitHub learning repository into a guided course inside [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) — your dsh agent becomes a full AI tutor with the interaction design of [LookatStudy](https://github.com/kaiji/LookatStudy): per-concept knowledge tracking, mastery-driven progression, spaced repetition, mastery proposals, friction awareness, learner memory, a Cornell notebook, and an in-chat proposal card. Learning engine modules are vendored from LookatStudy (MIT).
+Turn any markdown document, local folder, or GitHub learning repository into a guided course inside [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) — your dsh agent becomes a full AI tutor with the interaction design of [LookatStudy](https://github.com/Kaiji-Z/LookatStudy): per-concept knowledge tracking, mastery-driven progression, spaced repetition, mastery proposals, friction awareness, learner memory, a Cornell notebook, and an in-chat proposal card. Learning engine modules are vendored from LookatStudy (MIT).
 
 ## Install
 
@@ -65,8 +65,8 @@ LookatStudy's Electron-native experiences have no host surface in dsh: persisten
 pnpm exec tsdown        # build lib/ (host + client entries, peers external)
 pnpm test               # 48 node:test cases over the real source (no key needed)
 
-# iterate against a live dsh (from a deepseek-harness checkout):
-pnpm dsh web --patch ./lookatstudy-plugin/cordis.dev.yml
+# iterate against a live dsh (this repo lives beside a deepseek-harness checkout):
+pnpm dsh web --patch ../dsh-plugin-lookatstudy/cordis.dev.yml   # run from the harness checkout
 # then open http://127.0.0.1:3080/ and switch to the 学习 tab
 ```
 

package/lib/adoc-parser-1UxcYHid.mjs

@@ -0,0 +1,47 @@
+//#region src/vendor/adoc-parser.ts
+function parseAdoc(adocText) {
+	const lines = adocText.split("\n");
+	const output = [];
+	let inSourceBlock = false;
+	let pendingLang = "";
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i] ?? "";
+		const sourceMatch = line.match(/^\[source,\s*(\w*)\s*\]$/);
+		if (sourceMatch && !inSourceBlock) {
+			pendingLang = sourceMatch[1] ?? "";
+			if ((lines[i + 1] ?? "").trim() === "----") {
+				inSourceBlock = true;
+				i++;
+				output.push(`\`\`\`${pendingLang}`);
+				continue;
+			}
+		}
+		if (inSourceBlock && line.trim() === "----") {
+			inSourceBlock = false;
+			output.push("```");
+			continue;
+		}
+		if (inSourceBlock) {
+			output.push(line);
+			continue;
+		}
+		let processed = line;
+		processed = processed.replace(/^(=+)\s+/, (_match, eqs) => {
+			if (eqs.length > 6) return "#".repeat(6) + " ";
+			return "#".repeat(eqs.length) + " ";
+		});
+		processed = processed.replace(/image::(\S+?)\[([^\]]*)\]/g, (_m, path, alt) => {
+			return alt ? `![${alt}](${path})` : `![](${path})`;
+		});
+		processed = processed.replace(/image:(\S+?)\[([^\]]*)\]/g, (_m, path, alt) => {
+			return alt ? `![${alt}](${path})` : `![](${path})`;
+		});
+		processed = processed.replace(/link:(\S+?)\[([^\]]*)\]/g, "[$2]($1)");
+		processed = processed.replace(/(\s|^)\*([^\s*][^*]*?)\*(?=\s|[.,;:!?)])/gm, "$1**$2**");
+		processed = processed.replace(/(\s|^)_([^\s_][^_]*?)_(?=\s|[.,;:!?)])/gm, "$1*$2*");
+		output.push(processed);
+	}
+	return { markdown: output.join("\n") };
+}
+//#endregion
+export { parseAdoc };

package/lib/client.js

@@ -41,9 +41,15 @@ window.__ModuleLoader__.load({
 .lks-body{flex:1;min-height:0;min-width:0;display:flex;gap:16px}
 .lks-col{display:flex;flex-direction:column;min-width:0}
 .lks-colhead{flex:none;font-size:12px;font-weight:600;color:var(--dsw-alias-label-tertiary);letter-spacing:.06em;text-transform:uppercase;margin-bottom:10px}
-.lks-col-rail{flex:1 1 0;min-width:190px;overflow-y:auto;padding:2px 6px}
+.lks-col-rail{flex:0 1 260px;min-width:180px;overflow-y:auto;padding:2px 6px}
 .lks-col-tutor{flex:0 0 auto;width:min(100%,var(--dsh-composer-card-max-width,780px))}
 .lks-col-bb{flex:1 1 0;min-width:230px;overflow-y:auto;padding:2px 6px}
+/* While the study view is mounted in wide mode, the host composer card is
+   shifted under the tutor column (the transcript's width axis) instead of the
+   scroll body's center — views.tsx measures the offset, sets the variable and
+   toggles the class, and removes both whenever the shift collapses (narrow
+   pane, hidden view) so the host's natural centering comes back. */
+[data-composer-card].lks-composer-follow{align-self:flex-start;margin-left:var(--lks-composer-shift,0px)}
 /* narrow (<1220px): one composer-width pane at a time, chosen by a centered
    segmented pill group (joined buttons in one capsule — button language, not
    tab language, against the host's view tabs right above). */
@@ -72,7 +78,7 @@ window.__ModuleLoader__.load({
 .lks-masterybar i{display:block;height:100%;background:var(--dsw-alias-state-business-primary);transition:width .3s ease}
 .lks-masterybar.gold i{background:var(--dsw-alias-state-warn-primary)}
 .lks-search{width:100%;box-sizing:border-box;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;color:var(--dsw-alias-label-primary);font-family:inherit;font-size:13.5px;padding:5px 9px;margin-bottom:4px}
-.lks-search:focus{outline:none;border-color:var(--dsw-alias-state-business-primary)}
+.lks-search:focus{outline:none;border-color:var(--dsw-alias-state-business-primary);box-shadow:0 0 0 2px var(--dsw-alias-border-l3)}
 .lks-sec-num{display:inline-flex;align-items:center;justify-content:center;min-width:20px;height:20px;border-radius:50%;background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-label);font-size:11px;font-weight:700;margin-right:4px}
 .lks-tag.due{background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-label)}
 .lks-import{margin-top:8px}
@@ -87,13 +93,25 @@ window.__ModuleLoader__.load({
 .lks-duebox .lks-over{color:var(--dsw-alias-state-warn-label);flex:none}
 
 .lks-sec{font-size:12px;color:var(--dsw-alias-label-tertiary);text-transform:uppercase;letter-spacing:.05em;margin:14px 0 4px}
-.lks-node{display:flex;align-items:center;gap:8px;padding:6px 9px;border-radius:8px;margin:1px 0;cursor:pointer}
+/* Collapsible section head: a real button (keyboard can toggle it), sticky so
+   the current chapter stays identified while 4000px of nodes scroll under it. */
+.lks-sechead{display:flex;align-items:center;gap:6px;width:100%;box-sizing:border-box;font-size:12px;font-weight:600;color:var(--dsw-alias-label-tertiary);text-transform:uppercase;letter-spacing:.05em;text-align:left;padding:6px 4px;margin:14px 0 4px;border-radius:6px;position:sticky;top:0;z-index:1;background:var(--dsw-alias-bg-base)}
+.lks-sechead:hover{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover)}
+.lks-sechead:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}
+.lks-sechead-t{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.lks-sechead-c{flex:none;font-size:10px}
+.lks-sechead-n{flex:none;font-size:11px;text-transform:none;letter-spacing:0}
+.lks-node{display:flex;align-items:center;gap:8px;width:100%;text-align:left;padding:6px 9px;border-radius:8px;margin:1px 0;cursor:pointer}
 .lks-node:hover{background:var(--dsw-alias-interactive-bg-hover)}
+.lks-node:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}
 .lks-node.focus{background:var(--dsw-alias-bg-layer-3);outline:1px solid var(--dsw-alias-border-l2)}
 .lks-node .lks-g{width:18px;text-align:center;flex:none}
 .lks-node .lks-t{flex:1;font-size:14px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-.lks-node.locked{opacity:.45;cursor:not-allowed}
-.lks-node.locked:hover{background:none}
+/* aria-disabled (not the disabled attribute): the row stays focusable so the
+   status tooltip can explain WHY it is locked — Firefox drops titles on truly
+   disabled form controls. */
+.lks-node[aria-disabled='true']{opacity:.45;cursor:not-allowed}
+.lks-node[aria-disabled='true']:hover{background:none}
 .lks-tag{font-size:11px;border-radius:4px;padding:0 4px;flex:none}
 .lks-tag.weak{background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-label)}
 .lks-tag.fric{background:var(--dsw-alias-state-error-primary);color:#fff}
@@ -102,6 +120,7 @@ window.__ModuleLoader__.load({
 .lks-pct{font-size:12px;color:var(--dsw-alias-label-tertiary);flex:none;width:32px;text-align:right}
 
 .lks-empty{color:var(--dsw-alias-label-tertiary);text-align:center;padding:48px 8px;font-size:14px;line-height:2}
+.lks-actbar{display:flex;flex-direction:row;justify-content:flex-end;flex:none;padding-bottom:8px}
 
 /* ── middle column: the tutor ── */
 .lks-transcript{flex:1;min-height:0;overflow-y:auto;display:flex;flex-direction:column;gap:10px;padding:4px 2px}
@@ -140,7 +159,9 @@ window.__ModuleLoader__.load({
 .lks-starter:hover{border-color:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-label-primary)}
 
 /* proposal banner + shared buttons */
-.lks-banner{display:flex;align-items:center;gap:10px;background:var(--dsw-alias-state-warn-tertiary);border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:10px 14px;margin:8px 0;font-size:14px;flex:none}
+/* A mastery proposal is a positive, informational moment — business tint, not
+   the warn tint it previously wore (a reviewer flagged the semantic mismatch). */
+.lks-banner{display:flex;align-items:center;gap:10px;background:var(--dsw-alias-state-business-tertiary);border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:10px 14px;margin:8px 0;font-size:14px;flex:none}
 .lks-banner .lks-why{flex:1;color:var(--dsw-alias-label-secondary)}
 .lks-btn{display:inline-flex;align-items:center;gap:6px;border-radius:8px;padding:6px 14px;font-size:13.5px;font-weight:600;flex:none}
 .lks-btn.primary{background:var(--dsw-alias-state-business-primary);color:#fff}
@@ -175,7 +196,7 @@ window.__ModuleLoader__.load({
 .lks-zone{margin-bottom:14px}
 .lks-zone h4{font-size:14px;color:var(--dsw-alias-label-secondary);margin:0 0 8px;font-weight:600}
 .lks-note{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:10px;padding:10px 14px;margin-bottom:8px}
-.lks-note .lks-note-src{float:right;font-size:10px;color:var(--dsw-alias-label-tertiary)}
+.lks-note .lks-note-src{float:right;font-size:11.5px;color:var(--dsw-alias-label-secondary)}
 .lks-note .lks-note-title{font-weight:600;font-size:13px}
 .lks-note .lks-note-text{margin-top:4px;white-space:pre-wrap;font-size:13px;color:var(--dsw-alias-label-secondary)}
 .lks-note .lks-note-q{margin-top:6px;color:var(--dsw-alias-label-tertiary);font-size:12px;border-left:2px solid var(--dsw-alias-state-warn-primary);padding-left:8px}
@@ -325,6 +346,18 @@ window.__ModuleLoader__.load({
 				});
 				this.refresh();
 			}
+			/**
+			* Flip learning mode. The host syncs its tool registry before responding,
+			* so awaiting this guarantees the `study_*` tools exist for the next prompt.
+			*/
+			async activate(active) {
+				await fetchJson("/lookatstudy/api/active", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({ active })
+				});
+				this.refresh();
+			}
 			/** Point the tutor's focus at one lesson. */
 			async setFocus(lessonId) {
 				await fetchJson("/lookatstudy/api/focus", {
@@ -362,6 +395,7 @@ window.__ModuleLoader__.load({
 		function useStudy() {
 			return {
 				data: (0, react.useSyncExternalStore)(studyStore.subscribe, studyStore.getSnapshot, studyStore.getSnapshot),
+				activate: studyStore.activate.bind(studyStore),
 				setMode: studyStore.setMode.bind(studyStore),
 				setFocus: studyStore.setFocus.bind(studyStore),
 				deleteCourse: studyStore.deleteCourse.bind(studyStore),
@@ -559,6 +593,17 @@ window.__ModuleLoader__.load({
 		function titleMatches(title, query) {
 			return query.trim().toLowerCase().split(/\s+/).filter(Boolean).every((k) => title.toLowerCase().includes(k));
 		}
+		/**
+		* Default expansion for one rail section: collapsed when every study lesson is
+		* done (mastered) or not yet reachable (locked) — long courses otherwise scroll
+		* 5× their viewport. The active frontier and the focus lesson's section stay
+		* open; exam nodes never force a section open (they are gated separately).
+		* Pure.
+		* @param section - one course section projection with lesson kinds/statuses.
+		*/
+		function sectionDefaultOpen(section) {
+			return section.lessons.some((l) => l.focus || l.kind !== "exam" && l.status !== "mastered" && l.status !== "locked");
+		}
 		/** The rail's import row: a GitHub URL input plus the paste/folder hints. */
 		function ImportRow({ send }) {
 			const [url, setUrl] = (0, react.useState)("");
@@ -707,14 +752,11 @@ window.__ModuleLoader__.load({
 						call: node.call
 					});
 					break;
-				case "turn-error":
-					rows.push({
-						key: `e${node.seq}`,
-						role: "error",
-						text: node.message
-					});
-					break;
-				default: break;
+				case "turn-error": rows.push({
+					key: `e${node.seq}`,
+					role: "error",
+					text: node.message
+				});
 			}
 			if (partial !== null) {
 				const text = assistantText(partial.blocks);
@@ -762,18 +804,64 @@ window.__ModuleLoader__.load({
 		}
 		/** Tab body: the factory-bound ctx carries workspaces/sessions for the per-lesson session jumps. */
 		function StudyTab({ useSession, inputActions, ctx }) {
-			const { data, setMode, setFocus, deleteCourse, bindLessonSession } = useStudy();
+			const { data, activate, setMode, setFocus, deleteCourse, bindLessonSession } = useStudy();
 			const snapshot = useSession((s) => s);
 			const [pane, setPane] = (0, react.useState)(storedPane);
+			const rootRef = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				const root = rootRef.current;
+				const card = document.querySelector("[data-composer-card]");
+				const seat = card?.parentElement ?? null;
+				if (root === null || card === null || seat === null) return;
+				const clear = () => {
+					card.classList.remove("lks-composer-follow");
+					card.style.removeProperty("--lks-composer-shift");
+				};
+				const apply = () => {
+					const tutor = root.querySelector(".lks-col-tutor");
+					const rail = root.querySelector(".lks-col-rail");
+					if (tutor === null || rail === null || getComputedStyle(rail).display === "none") return clear();
+					const seatRect = seat.getBoundingClientRect();
+					const tutorRect = tutor.getBoundingClientRect();
+					if (seatRect.width === 0 || tutorRect.width === 0) return clear();
+					const pad = parseFloat(getComputedStyle(seat).paddingLeft) || 0;
+					const cardW = card.getBoundingClientRect().width;
+					const max = seatRect.width - 2 * pad - cardW;
+					const shift = Math.round(Math.max(0, Math.min(tutorRect.left - (seatRect.left + pad), max)));
+					if (shift < 2) return clear();
+					card.style.setProperty("--lks-composer-shift", `${shift}px`);
+					card.classList.add("lks-composer-follow");
+				};
+				apply();
+				const ro = new ResizeObserver(apply);
+				ro.observe(root);
+				ro.observe(seat);
+				window.addEventListener("resize", apply);
+				return () => {
+					ro.disconnect();
+					window.removeEventListener("resize", apply);
+					clear();
+				};
+			}, []);
 			const send = (text) => {
-				inputActions.setDraft(text);
-				inputActions.submit();
+				(async () => {
+					if (data?.active !== true) await activate(true);
+					inputActions.setDraft(text);
+					inputActions.submit();
+				})();
 			};
 			return (0, react.createElement)("div", {
+				ref: rootRef,
 				className: "lks-root lks-study",
 				"data-conversation-composer-overlay": "",
 				"data-pane": pane
-			}, (0, react.createElement)("div", { className: "lks-body" }, (0, react.createElement)("div", { className: "lks-switch" }, ...[
+			}, (0, react.createElement)("div", { className: "lks-actbar" }, data === null ? null : (0, react.createElement)("button", {
+				className: `lks-btn ${data.active ? "ghost" : "primary"}`,
+				title: data.active ? "注销 study 工具与导师人格;学习进度保留,可随时重新开启" : "注册 study 工具并载入导师人格,之后普通对话和现在一样",
+				onClick: () => {
+					activate(!data.active);
+				}
+			}, data.active ? "⏻ 退出学习模式" : "▶ 开始学习")), (0, react.createElement)("div", { className: "lks-body" }, (0, react.createElement)("div", { className: "lks-switch" }, ...[
 				{
 					id: "rail",
 					label: "课程"
@@ -797,6 +885,7 @@ window.__ModuleLoader__.load({
 				}
 			}, p.label))), (0, react.createElement)(CourseRail, {
 				data,
+				activate,
 				setFocus,
 				deleteCourse,
 				bindLessonSession,
@@ -811,7 +900,7 @@ window.__ModuleLoader__.load({
 			}), (0, react.createElement)(BlackboardColumn, { data })));
 		}
 		/** Left column: course management (pick/delete/search/import), lesson tree, due box. */
-		function CourseRail({ data, setFocus, deleteCourse, bindLessonSession, send, ctx, currentSessionId }) {
+		function CourseRail({ data, activate, setFocus, deleteCourse, bindLessonSession, send, ctx, currentSessionId }) {
 			const [jumping, setJumping] = (0, react.useState)(null);
 			/** Open (or mint) the lesson's own session — the simplified thread system. */
 			const openLessonThread = (lesson) => {
@@ -828,6 +917,7 @@ window.__ModuleLoader__.load({
 				}
 				setJumping(lesson.id);
 				setFocus(lesson.id).then(() => (async () => {
+					if (data?.active !== true) await activate(true);
 					const area = await fetch("/lookatstudy/api/study-workspace");
 					if (!area.ok) throw new Error(`study area unavailable (HTTP ${area.status})`);
 					const { path } = await area.json();
@@ -854,6 +944,8 @@ window.__ModuleLoader__.load({
 			const [query, setQuery] = (0, react.useState)("");
 			const [confirmDelete, setConfirmDelete] = (0, react.useState)(false);
 			const [showImport, setShowImport] = (0, react.useState)(false);
+			/** Per-section open overrides (courseId/sectionTitle → open?), on top of the frontier default. */
+			const [secOpen, setSecOpen] = (0, react.useState)({});
 			const [error, setError] = (0, react.useState)(null);
 			const reportError = (err) => {
 				setError(err instanceof Error ? err.message : String(err));
@@ -911,7 +1003,29 @@ window.__ModuleLoader__.load({
 							}
 						}
 					}
-				}), data.dueCount > 0 ? (0, react.createElement)("div", { className: "lks-duebox" }, `🔁 待复习 ${data.dueCount}`, ...data.due.map((d) => (0, react.createElement)("div", {
+				}), course.sections.some((s) => s.lessons.some((l) => l.focus)) ? (0, react.createElement)("button", {
+					className: "lks-btn ghost",
+					style: {
+						margin: "0 0 6px",
+						padding: "3px 8px",
+						fontSize: "13px"
+					},
+					title: "在课程树中定位当前焦点课时(自动展开所在章节)",
+					onClick: () => {
+						const focusSection = course.sections.find((s) => s.lessons.some((l) => l.focus));
+						if (focusSection === void 0) return;
+						setSecOpen((m) => ({
+							...m,
+							[`${courseId}/${focusSection.title}`]: true
+						}));
+						window.setTimeout(() => {
+							document.querySelector(".lks-col-rail .lks-node.focus")?.scrollIntoView({
+								block: "center",
+								behavior: "smooth"
+							});
+						}, 60);
+					}
+				}, "📍 回到当前课时") : null, data.dueCount > 0 ? (0, react.createElement)("div", { className: "lks-duebox" }, `🔁 待复习 ${data.dueCount}`, ...data.due.map((d) => (0, react.createElement)("div", {
 					key: d.lessonId,
 					className: "lks-due-item"
 				}, (0, react.createElement)("span", null, d.lessonTitle), d.overdueDays > 0 ? (0, react.createElement)("span", { className: "lks-over" }, `超${d.overdueDays}天`) : null)), (0, react.createElement)("button", {
@@ -924,14 +1038,27 @@ window.__ModuleLoader__.load({
 					const examAllowed = examOpen(section.lessons);
 					const lessons = section.lessons.filter((l) => query.trim() === "" || titleMatches(l.title, query) || l.focus);
 					if (lessons.length === 0) return [];
-					return [(0, react.createElement)("div", {
+					const secKey = `${courseId}/${section.title}`;
+					const open = query.trim() !== "" || (secOpen[secKey] ?? sectionDefaultOpen(section));
+					return [(0, react.createElement)("button", {
 						key: section.title,
-						className: "lks-sec"
-					}, (0, react.createElement)("span", { className: "lks-sec-num" }, String(section.index + 1)), ` ${section.title}`), ...lessons.map((lesson) => {
+						type: "button",
+						className: "lks-sechead",
+						"aria-expanded": String(open),
+						title: open ? "折叠本章节" : `展开本章节(${section.lessons.length} 课时)`,
+						onClick: () => {
+							setSecOpen((m) => ({
+								...m,
+								[secKey]: !open
+							}));
+						}
+					}, (0, react.createElement)("span", { className: "lks-sec-num" }, String(section.index + 1)), (0, react.createElement)("span", { className: "lks-sechead-t" }, section.title), open ? null : (0, react.createElement)("span", { className: "lks-sechead-n" }, `${section.lessons.length} 课`), (0, react.createElement)("span", { className: "lks-sechead-c" }, open ? "▾" : "▸")), ...open ? lessons.map((lesson) => {
 						const locked = lesson.status === "locked" || lesson.kind === "exam" && !examAllowed;
-						return (0, react.createElement)("div", {
+						return (0, react.createElement)("button", {
 							key: lesson.id,
-							className: `lks-node${locked ? " locked" : ""}${lesson.focus ? " focus" : ""}`,
+							type: "button",
+							className: `lks-node${lesson.focus ? " focus" : ""}`,
+							"aria-disabled": locked || void 0,
 							title: jumping === lesson.id ? "正在打开课时会话…" : statusTitle(lesson.kind, locked ? "locked" : lesson.status),
 							onClick: () => {
 								if (locked) return;
@@ -958,7 +1085,7 @@ window.__ModuleLoader__.load({
 							className: "lks-pct",
 							title: "课时掌握度 = 最薄弱知识点的掌握度"
 						}, `${lesson.masteryPct}%`) : null);
-					})];
+					}) : []];
 				}), (0, react.createElement)("button", {
 					className: "lks-btn ghost",
 					style: { marginTop: "10px" },
@@ -1129,6 +1256,7 @@ window.__ModuleLoader__.load({
 		}
 		/** Button body in its own component so hook order stays constant. */
 		function Inner({ ctx }) {
+			const { data, activate } = useStudy();
 			const [busy, setBusy] = (0, react.useState)(false);
 			const [error, setError] = (0, react.useState)(null);
 			const start = () => {
@@ -1137,6 +1265,7 @@ window.__ModuleLoader__.load({
 				setError(null);
 				(async () => {
 					try {
+						if (data?.active !== true) await activate(true);
 						const area = await fetch("/lookatstudy/api/study-workspace");
 						if (!area.ok) throw new Error(`study area unavailable (HTTP ${area.status})`);
 						const { path } = await area.json();
@@ -1169,7 +1298,7 @@ window.__ModuleLoader__.load({
 				title: "一键准备学习:建立学习工作区、开启会话并让导师就位",
 				disabled: busy,
 				onClick: start
-			}, busy ? (0, react.createElement)(IconLoadingOutline16, { className: "lks-spin" }) : (0, react.createElement)(IconThinkOutline16, null), busy ? "正在准备学习区…" : "开始学习"), error !== null ? (0, react.createElement)("span", {
+			}, busy ? (0, react.createElement)(IconLoadingOutline16, { className: "lks-spin" }) : (0, react.createElement)(IconThinkOutline16, null), busy ? "正在准备学习区…" : data?.active === true ? "进入学习" : "开始学习"), error !== null ? (0, react.createElement)("span", {
 				className: "lks-propcard-err",
 				style: { marginTop: 0 }
 			}, error) : null);