dsh-plugin-lookatstudy 0.25.4 → 0.26.0

package/lib/client.js

@@ -401,6 +401,19 @@ window.__ModuleLoader__.load({
    registration; the span class is the no-Highlight-API fallback) */
 ::highlight(lks-reading){background:rgb(var(--brand-rgb)/0.28);color:var(--ink-strong)}
 .lks-ui .lks14-reading-mark{background:rgb(var(--brand-rgb)/0.28);color:var(--ink-strong);border-radius:3px}
+/* v0.35.1-alignment: persistent note highlights ride the same registration
+   route (zero DOM mutation) — same skin as the mark.lks-hl fallback */
+.lks-ui ::highlight(lks-note-hl){background:rgb(var(--gold-rgb)/0.25);border-bottom:2px solid var(--gold)}
+/* v0.37-alignment: the progression-boundary card + the rail pulse ring the
+   「指出下一课」 action arms (bot points, user drives — nothing auto-switches) */
+.lks-ui .lks14-boundary{display:flex;align-items:center;gap:10px;margin:10px 20px 4px;padding:10px 12px;border:1px solid rgb(var(--gold-rgb)/0.5);background:rgb(var(--gold-rgb)/0.08);border-radius:10px;flex:none;color:var(--gold-dark)}
+.lks-ui .lks14-boundary-text{flex:1;min-width:0}
+.lks-ui .lks14-boundary-title{font-weight:700;font-size:13.5px;color:var(--ink-strong)}
+.lks-ui .lks14-boundary-sub{font-size:12px;color:var(--ink-muted);margin-top:2px}
+.lks-ui .lks14-boundary-x{flex:none;background:none;border:none;color:var(--ink-muted);cursor:pointer;font-size:13px;padding:4px 6px}
+.lks-ui .lks14-boundary-x:hover{color:var(--ink-strong)}
+.lks-ui .lks-lessorow.next-hint{outline:2px dashed var(--gold);outline-offset:1px;animation:lks-hint-pulse 1.6s ease-in-out infinite}
+@keyframes lks-hint-pulse{0%,100%{outline-color:rgb(var(--gold-rgb)/0.95)}50%{outline-color:rgb(var(--gold-rgb)/0.25)}}
 /* #10-followup: the reading column is height:auto (the note col scrolls), so
    .lks14-board's height:100% resolved against a content-sized parent and the
    stage collapsed to a ~90px sliver — the never-upscale contain fit then
@@ -1990,6 +2003,37 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				});
 				this.refresh();
 			}
+			/** Upstream v0.36: save the learner's OWN profile edit (the human path —
+			*  this is also what marks older AI suggestions stale). */
+			async saveProfile(patch) {
+				await fetchJson("/lookatstudy/api/profile", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify(patch)
+				});
+				this.refresh();
+			}
+			/** Accept or ignore one AI profile suggestion (the settings-page consumer). */
+			async resolveProfileProposal(id, accept) {
+				await fetchJson("/lookatstudy/api/profile/resolve", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({
+						id,
+						accept
+					})
+				});
+				this.refresh();
+			}
+			/** Anti-farming (upstream v0.35): a locally-judged practice card is human
+			*  grading — report it so the tutor-only mastery cap lifts on the lesson. */
+			async reportPracticeGraded(lessonId) {
+				await fetchJson("/lookatstudy/api/practice-graded", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({ lessonId })
+				}).catch(() => void 0);
+			}
 			/** Delete one notebook entry from a lesson's Cornell zones. */
 			async deleteNote(lessonId, noteId) {
 				await fetchJson("/lookatstudy/api/note/delete", {
@@ -2159,6 +2203,9 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				setFocus: studyStore.setFocus.bind(studyStore),
 				searchLessons: studyStore.searchLessons.bind(studyStore),
 				tts: studyStore.tts.bind(studyStore),
+				saveProfile: studyStore.saveProfile.bind(studyStore),
+				resolveProfileProposal: studyStore.resolveProfileProposal.bind(studyStore),
+				reportPracticeGraded: studyStore.reportPracticeGraded.bind(studyStore),
 				setCourseScope: studyStore.setCourseScope.bind(studyStore),
 				deleteCourse: studyStore.deleteCourse.bind(studyStore),
 				deleteNote: studyStore.deleteNote.bind(studyStore),
@@ -2255,6 +2302,15 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			"proposal.banner": "《{lesson}》可以提前毕业了",
 			"proposal.accept.msg": "我接受《{lesson}》的掌握度提议，帮我标记为掌握。",
 			"proposal.decline.msg": "《{lesson}》我先再练练，暂不接受提前毕业。",
+			"boundary.done": "本课完成，皇冠到手！",
+			"boundary.course.done": "整门课程完成！",
+			"boundary.next.sub": "下一课是《{title}》——在课程栏点它进入。",
+			"boundary.thread.sub": "下一课是《{title}》——点开始，就在这条线上接着讲。",
+			"boundary.thread.point": "开始下一课",
+			"boundary.thread.send": "这一课完成了，我们开始下一课《{title}》吧。",
+			"boundary.last.sub": "全部课时都已掌握，复习会按计划回来。",
+			"boundary.point": "在课程栏指出下一课",
+			"boundary.dismiss": "收起",
 			"tutor.thinking": "导师思考中…",
 			"header.xp": "经验值 {xp}",
 			"header.streak": "连续学习天数",
@@ -2489,7 +2545,34 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			"settings.stats.courses": "课程 {count} 个",
 			"settings.stats.xp": "XP {xp} · Lv{level}({pct}%)",
 			"settings.stats.today": "今日 {xp}/{goal}",
-			"settings.stats.streak": "连续 {days} 天(最长 {best},剩冻结 {freeze})",
+			"settings.stats.streak": "连续 {days} 天 · 最长 {best} 天 · 冻结 {freeze}",
+			"settings.stats.mastered": "已掌握 {count} 课 · 待复习 {due} 课",
+			"settings.profile": "学习者画像",
+			"settings.profile.hint": "只属于你的背景事实，用来调整怎么教——不进任何评分。AI 的建议也在这里处理，不打断对话。",
+			"settings.profile.name": "称呼",
+			"settings.profile.mbti": "MBTI（快捷入口，自动展开为风格四维）",
+			"settings.profile.interests": "兴趣点（顿号/逗号分隔，最多 8 个）",
+			"settings.profile.interests.ph": "例如：天文、做菜、悬疑小说",
+			"settings.profile.note": "想对导师说的话",
+			"settings.profile.motive": "学习动机（只有你自己能设置）",
+			"settings.profile.unset": "未设置",
+			"settings.profile.save": "保存画像",
+			"settings.profile.private": "画像只存本地 state.json，不会上传。",
+			"settings.style.start": "讲解起点",
+			"settings.style.analogy": "先具体实例建直觉",
+			"settings.style.framework": "先框架后细节",
+			"settings.style.interaction": "互动密度",
+			"settings.style.dialogue": "边讲边问",
+			"settings.style.lecture": "讲完一节再答疑",
+			"settings.style.feedback": "反馈风格",
+			"settings.style.direct": "直接纠错",
+			"settings.style.encouraging": "先肯定再指正",
+			"settings.style.pacing": "节奏",
+			"settings.style.sequential": "按顺序推进",
+			"settings.style.exploratory": "允许跳着学",
+			"settings.suggest.head": "AI 建议的",
+			"settings.suggest.apply": "采纳",
+			"settings.suggest.ignore": "忽略",
 			"settings.about": "关于",
 			"settings.about.hint": "当前运行的构建版本,点击查看该版更新内容。",
 			"settings.stateFile": "状态文件",
@@ -2626,6 +2709,15 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			"proposal.banner": "{lesson} is ready to graduate early",
 			"proposal.accept.msg": "I accept the mastery proposal for \"{lesson}\" — mark it mastered.",
 			"proposal.decline.msg": "I want more practice on \"{lesson}\" before graduating.",
+			"boundary.done": "Lesson complete — crown earned!",
+			"boundary.course.done": "Course complete!",
+			"boundary.next.sub": "Next up: {title} — click it in the course rail to continue.",
+			"boundary.thread.sub": "Next: {title} — continue right here in this thread.",
+			"boundary.thread.point": "Start the next lesson",
+			"boundary.thread.send": "This lesson is wrapped up — let's start the next one, {title}.",
+			"boundary.last.sub": "Every lesson is mastered; reviews will come back on schedule.",
+			"boundary.point": "Point at the next lesson",
+			"boundary.dismiss": "Dismiss",
 			"tutor.thinking": "The tutor is thinking…",
 			"header.xp": "{xp} XP",
 			"header.streak": "Day streak",
@@ -2860,7 +2952,34 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			"settings.stats.courses": "{count} courses",
 			"settings.stats.xp": "XP {xp} · Lv{level} ({pct}%)",
 			"settings.stats.today": "Today {xp}/{goal}",
-			"settings.stats.streak": "Streak {days}d (best {best}, {freeze} freeze left)",
+			"settings.stats.streak": "Streak {days} days · best {best} · freezes {freeze}",
+			"settings.stats.mastered": "{count} lessons mastered · {due} due",
+			"settings.profile": "Learner profile",
+			"settings.profile.hint": "Background facts only you can declare — they shape HOW you are taught, never any scoring. AI suggestions resolve here, never in the chat.",
+			"settings.profile.name": "Name",
+			"settings.profile.mbti": "MBTI (shortcut — expands into the style dims)",
+			"settings.profile.interests": "Interests (comma-separated, max 8)",
+			"settings.profile.interests.ph": "e.g. astronomy, cooking, mystery novels",
+			"settings.profile.note": "Note to the tutor",
+			"settings.profile.motive": "Learning motive (only you can set this)",
+			"settings.profile.unset": "Not set",
+			"settings.profile.save": "Save profile",
+			"settings.profile.private": "Stored in your local state.json only — never uploaded.",
+			"settings.style.start": "Explanation start",
+			"settings.style.analogy": "Concrete examples first",
+			"settings.style.framework": "Framework first",
+			"settings.style.interaction": "Interaction density",
+			"settings.style.dialogue": "Questions as we go",
+			"settings.style.lecture": "Lecture first, Q&A after",
+			"settings.style.feedback": "Feedback style",
+			"settings.style.direct": "Direct corrections",
+			"settings.style.encouraging": "Encouraging corrections",
+			"settings.style.pacing": "Pacing",
+			"settings.style.sequential": "Sequential",
+			"settings.style.exploratory": "Exploratory",
+			"settings.suggest.head": "AI suggested",
+			"settings.suggest.apply": "Accept",
+			"settings.suggest.ignore": "Ignore",
 			"settings.about": "About",
 			"settings.about.hint": "The version of the running build — click to see its release notes.",
 			"settings.stateFile": "State file",
@@ -4764,7 +4883,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				nodes
 			};
 		}
-		function offsetsToRange(model, start, end) {
+		function offsetsToRange$1(model, start, end) {
 			const range = document.createRange();
 			let setStart = false;
 			let setEnd = false;
@@ -4823,7 +4942,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			if (m === null && from > 0) m = matchSentenceAligned(model.text, trimmed, 0);
 			if (m === null) return null;
 			readingCursors.set(container, m[1]);
-			const range = offsetsToRange(model, m[0], m[1]);
+			const range = offsetsToRange$1(model, m[0], m[1]);
 			if (range === null) return null;
 			const cssLike = CSS;
 			if (typeof Highlight !== "undefined" && cssLike.highlights !== void 0) try {
@@ -5249,6 +5368,35 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			};
 		}
 		/**
+		* Tool-error visibility (upstream v0.37.1 toolErrorVisibility, part-accumulator):
+		* an error tool row that is SUPERSEDED by a later same-tool call within the
+		* same turn (no learner message in between) is dropped — weak models fail a
+		* zod-validated input on the first try and succeed on the retry (observed
+		* live: the quiz error block flashed, then the quiz card landed), and the
+		* stale transient failure is pure noise. A real failure — no successor —
+		* stays visible; nothing is silently swallowed. Pure.
+		*/
+		function hideSupersededToolErrors(rows) {
+			const out = [];
+			for (let i = 0; i < rows.length; i++) {
+				const row = rows[i];
+				if (row.role === "tool" && row.toolState === "error") {
+					let superseded = false;
+					for (let j = i + 1; j < rows.length; j++) {
+						const later = rows[j];
+						if (later.role === "user") break;
+						if (later.role === "tool" && later.text === row.text && (later.toolState === "loading" || later.toolState === "done")) {
+							superseded = true;
+							break;
+						}
+					}
+					if (superseded) continue;
+				}
+				out.push(row);
+			}
+			return out;
+		}
+		/**
 		* Fold one event-window snapshot into ordered chat rows. The transient
 		* `text-delta` chunks of the most recent attempt accumulate into a single
 		* streaming row (the durable `assistant/message` replaces it on settlement).
@@ -5369,7 +5517,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 					running: true
 				});
 			}
-			return rows;
+			return hideSupersededToolErrors(rows);
 		}
 		/**
 		* Parse an ask_user_question call's arguments into the answerable row payload
@@ -6058,6 +6206,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				if (!showScore || !allAnswered || hookSent) return;
 				setHookSent(true);
 				onFinished?.(score.correct === score.total);
+				studyStore.reportPracticeGraded(lessonId);
 				const next = {
 					answers: [...progress.answers],
 					done: true
@@ -6924,11 +7073,39 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				nodes
 			};
 		}
-		/** The mark class applied to persisted highlights. */
+		/** The mark class applied to persisted highlights (DOM fallback channel only). */
 		const HIGHLIGHT_MARK = "lks-hl";
 		/**
+		* Persistent-note highlight registry name — the CSS Custom Highlight API
+		* channel (upstream v0.35.1 root fix): the old scheme split text nodes and
+		* inserted <mark>, rewriting DOM a framework may reconcile over — any later
+		* re-render could throw a DOMException into the error boundary. The registry
+		* channel registers Ranges in CSS.highlights and touches ZERO DOM nodes.
+		* Styled by the `::highlight(lks-note-hl)` rule in the upstream skin.
+		*/
+		const NOTE_HIGHLIGHT_NAME = "lks-note-hl";
+		/** Whether the registration channel exists (Highlight ctor + CSS.highlights). */
+		function supportsHighlightMarks() {
+			return typeof Highlight !== "undefined" && !!CSS.highlights;
+		}
+		/** Live note ranges: quote → Range. CSS.highlights is a document-level
+		*  singleton, so every container shares one Highlight; dead ranges (nodes
+		*  detached by a re-render of the source) are pruned on rebuild so the map
+		*  cannot grow without bound. */
+		const liveNoteRanges = /* @__PURE__ */ new Map();
+		const noteRangeOwners = /* @__PURE__ */ new WeakMap();
+		function rebuildNoteHighlight() {
+			const cssLike = CSS;
+			for (const [quote, r] of liveNoteRanges) if (!r.startContainer.isConnected) liveNoteRanges.delete(quote);
+			try {
+				if (liveNoteRanges.size === 0) cssLike.highlights?.delete(NOTE_HIGHLIGHT_NAME);
+				else cssLike.highlights?.set(NOTE_HIGHLIGHT_NAME, new Highlight(...liveNoteRanges.values()));
+			} catch {}
+		}
+		/**
 		* Apply one highlight range to the live DOM: split the boundary text nodes
 		* and wrap the covering segments in marks. Returns the created marks.
+		* (The DOM fallback channel — only reached when the Highlight API is absent.)
 		*/
 		function wrapRange(model, start, end) {
 			const marks = [];
@@ -6949,12 +7126,35 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 		}
 		/**
 		* Render the persisted highlights for one lesson: each record-zone note with a
-		* quote anchors a mark. Idempotent per call — call on a freshly rendered
-		* (pre-mark) container; the model skips existing marks so re-entry is safe.
-		* @returns how many notes got at least one mark.
+		* quote anchors a highlight. Registry channel first (zero DOM mutation — a
+		* framework re-render can never hit a foreign node); the mark-wrapping
+		* fallback only runs on engines without CSS.highlights. Idempotent per call —
+		* call on a freshly rendered container; re-entry replaces this container's
+		* registered ranges first.
+		* @returns how many notes got at least one highlight.
 		*/
 		function applyHighlights(container, quotes) {
 			let applied = 0;
+			if (supportsHighlightMarks()) {
+				const owned = noteRangeOwners.get(container);
+				if (owned !== void 0) for (const quote of owned) liveNoteRanges.delete(quote);
+				const hits = /* @__PURE__ */ new Map();
+				for (const quote of quotes) {
+					const trimmed = quote.trim();
+					if (trimmed.length < 2) continue;
+					const model = getTextModel(container);
+					const located = locateInModel(model, trimmed, void 0);
+					if (located === null) continue;
+					const range = offsetsToRange(model, located.start, located.end);
+					if (range === null) continue;
+					hits.set(trimmed, range);
+					liveNoteRanges.set(trimmed, range);
+					applied += 1;
+				}
+				noteRangeOwners.set(container, new Set(hits.keys()));
+				rebuildNoteHighlight();
+				return applied;
+			}
 			for (const quote of quotes) {
 				const trimmed = quote.trim();
 				if (trimmed.length < 2) continue;
@@ -6965,6 +7165,22 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			}
 			return applied;
 		}
+		/** Build one Range across the model's text nodes (null when the browser
+		*  refuses — e.g. a detached node between model build and call). */
+		function offsetsToRange(model, start, end) {
+			const segments = planSegments(model.nodes, start, end);
+			if (segments.length === 0) return null;
+			const first = segments[0];
+			const last = segments[segments.length - 1];
+			try {
+				const range = new Range();
+				range.setStart(model.nodes[first.index].node, first.localStart);
+				range.setEnd(model.nodes[last.index].node, last.localEnd);
+				return range;
+			} catch {
+				return null;
+			}
+		}
 		//#endregion
 		//#region src/client/maprail.tsx
 		/**
@@ -6995,17 +7211,31 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			if (lesson.status === "in_progress") return lesson.masteryPct ?? 0;
 			return null;
 		}
-		/**
-		* A section's world (D6, upstream World = study | practice): the plugin's
-		* state flattens the design's per-lesson world into lesson kinds, so a
-		* section is the practice world iff it is non-empty and purely practice
-		* (the design protocol marks sections, keeping them homogeneous).
-		*/
+		function nextStudyAfterView(courses, lessonId) {
+			for (const course of courses) for (let si = 0; si < course.sections.length; si++) {
+				const lessons = course.sections[si].lessons;
+				const li = lessons.findIndex((l) => l.id === lessonId);
+				if (li < 0) continue;
+				for (let j = li + 1; j < lessons.length; j++) if (lessons[j].kind === "study") return {
+					id: lessons[j].id,
+					title: lessons[j].title
+				};
+				for (let s = si + 1; s < course.sections.length; s++) {
+					const first = course.sections[s].lessons.find((l) => l.kind === "study");
+					if (first !== void 0) return {
+						id: first.id,
+						title: first.title
+					};
+				}
+				return null;
+			}
+			return null;
+		}
 		function sectionWorldOf(section) {
 			return section.lessons.length > 0 && section.lessons.every((l) => l.kind === "practice") ? "practice" : "study";
 		}
 		/** One section: a quiet header toggle + the lesson rows. */
-		function ListSectionView({ section, examAllowed, open, onToggle, onJump, streamingId }) {
+		function ListSectionView({ section, examAllowed, open, onToggle, onJump, streamingId, hintId }) {
 			const lessons = section.lessons;
 			const done = lessons.filter((l) => l.status === "mastered").length;
 			return (0, react.createElement)("section", { className: "lks-railsec" }, (0, react.createElement)("button", {
@@ -7022,7 +7252,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				return (0, react.createElement)("button", {
 					key: lesson.id,
 					type: "button",
-					className: `lks-lessorow st-${state}${lesson.focus ? " selected" : ""}`,
+					className: `lks-lessorow st-${state}${lesson.focus ? " selected" : ""}${hintId !== void 0 && hintId !== null && hintId === lesson.id ? " next-hint" : ""}`,
 					"data-node-id": lesson.id,
 					"aria-disabled": locked || void 0,
 					"data-tooltip": `${lesson.title} — ${stateWord}`,
@@ -7864,6 +8094,17 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			}
 		}
 		/** C8: the most recent decided proposal's badge payload (render order preserved). */
+		/** Upstream v0.37 boundary card: lessons whose card the learner dismissed
+		*  (persisted so a remount does not re-nag about an already-mastered lesson). */
+		const BOUNDARY_DISMISS_KEY = "lks-boundary-dismissed";
+		function boundaryDismissedLessons() {
+			try {
+				const raw = JSON.parse(localStorage.getItem(BOUNDARY_DISMISS_KEY) ?? "[]");
+				return new Set(Array.isArray(raw) ? raw.filter((s) => typeof s === "string") : []);
+			} catch {
+				return /* @__PURE__ */ new Set();
+			}
+		}
 		function decidedBadgeOf(decided) {
 			const entries = Object.values(decided);
 			return entries.length > 0 ? entries[entries.length - 1] : null;
@@ -8141,6 +8382,39 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			const [draft, setDraft] = (0, react.useState)("");
 			const [narrowPane, setNarrowPane] = (0, react.useState)(pickNarrowPane(null));
 			const lesson = data?.lesson ?? null;
+			const [boundary, setBoundary] = (0, react.useState)(null);
+			const [nextHint, setNextHint] = (0, react.useState)(null);
+			const prevStatusRef = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				const status = lesson?.status ?? null;
+				const prev = prevStatusRef.current;
+				prevStatusRef.current = status;
+				if (lesson === null || lesson.kind !== "study" || status !== "mastered") {
+					setBoundary(null);
+					return;
+				}
+				if (prev === "mastered") return;
+				if (boundaryDismissedLessons().has(lesson.lessonId)) return;
+				const next = data !== null ? nextStudyAfterView(data.courses, lesson.lessonId) : null;
+				setBoundary({
+					lessonId: lesson.lessonId,
+					nextId: next?.id ?? null,
+					nextTitle: next?.title ?? null,
+					last: next === null
+				});
+			}, [lesson, data]);
+			const dismissBoundary = (0, react.useCallback)(() => {
+				if (boundary !== null) try {
+					const set = boundaryDismissedLessons();
+					set.add(boundary.lessonId);
+					localStorage.setItem(BOUNDARY_DISMISS_KEY, JSON.stringify([...set]));
+				} catch {}
+				setBoundary(null);
+			}, [boundary]);
+			const pointAtNext = (0, react.useCallback)((nextId) => {
+				setNextHint(nextId);
+				setNarrowPane("rail");
+			}, []);
 			const examLessonActive = lesson !== null && lesson.kind === "exam" && examOpen(data?.courses.flatMap((c) => c.sections).find((s) => s.lessons.some((l) => l.id === lesson.lessonId))?.lessons ?? []);
 			const localBound = (0, react.useRef)(null);
 			const boundSessionOf = (lessonId) => lessonId !== null && localBound.current?.lessonId === lessonId ? localBound.current.sessionId : null;
@@ -8542,7 +8816,10 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			}, (0, react.createElement)(CourseRail, {
 				data,
 				activate,
-				setFocus: guardedSetFocus,
+				setFocus: (id) => {
+					setNextHint(null);
+					return guardedSetFocus(id);
+				},
 				searchLessons,
 				deleteCourse,
 				send,
@@ -8555,7 +8832,8 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				stop,
 				sendImport,
 				endImportSession,
-				paletteBus
+				paletteBus,
+				nextHintLessonId: nextHint
 			}), (0, react.createElement)(PaneResizeHandle, {
 				side: "rail",
 				clampLive: railClampLive,
@@ -8629,7 +8907,10 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				},
 				contextMeter,
 				contextBreakdown: breakdown,
-				uploadAttachment
+				uploadAttachment,
+				boundary,
+				onPointNext: pointAtNext,
+				onDismissBoundary: dismissBoundary
 			}), (0, react.createElement)(PaneResizeHandle, {
 				side: "chat",
 				clampLive: chatClampLive,
@@ -8966,7 +9247,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			PANEL_SHELL.current = shell;
 		}
 		/** 左栏:course picker, tree, review box, import. */
-		function CourseRail({ data, activate, setFocus, searchLessons, deleteCourse, send, onJumped, streamingLessonId, turnActive, importProgress, stop, paletteBus, sendImport, endImportSession }) {
+		function CourseRail({ data, activate, setFocus, searchLessons, deleteCourse, send, onJumped, streamingLessonId, turnActive, importProgress, stop, paletteBus, sendImport, endImportSession, nextHintLessonId }) {
 			const [selectedCourse, setSelectedCourse] = (0, react.useState)("");
 			const [query, setQuery] = (0, react.useState)("");
 			const [searchRows, setSearchRows] = (0, react.useState)([]);
@@ -9194,6 +9475,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				return [(0, react.createElement)(ListSectionView, {
 					key: section.title,
 					streamingId: streamingLessonId,
+					hintId: nextHintLessonId ?? null,
 					section: {
 						title: section.title,
 						index: section.index,
@@ -9597,7 +9879,7 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			return cut <= 0 ? path : norm.slice(0, cut);
 		}
 		/** 中栏:the tutor chat stream with its own composer (upstream ChatStream + ChatComposer). */
-		function ChatPane({ data, lesson, rows, feedAttached, bound, busy, sendError, draft, setDraft, send, stop, setMode, narrowPane, onThreadSwitch, onThreadNew, onThreadRename, onThreadArchive, onThreadDelete, courseScope, onScopeToggle, contextMeter, contextBreakdown, uploadAttachment }) {
+		function ChatPane({ data, lesson, rows, feedAttached, bound, busy, sendError, draft, setDraft, send, stop, setMode, narrowPane, onThreadSwitch, onThreadNew, onThreadRename, onThreadArchive, onThreadDelete, courseScope, onScopeToggle, contextMeter, contextBreakdown, uploadAttachment, boundary, onPointNext, onDismissBoundary }) {
 			const stuck = (0, react.useRef)(true);
 			const [showFab, setShowFab] = (0, react.useState)(false);
 			const [threadsOpen, setThreadsOpen] = (0, react.useState)(false);
@@ -10104,7 +10386,23 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				onClick: () => {
 					if (!dormant) send(s.message);
 				}
-			}, s.label))) : null, (0, react.createElement)("div", { className: "lks14-composer" }, (0, react.createElement)("div", {
+			}, s.label))) : null, boundary !== null ? (0, react.createElement)("div", {
+				className: "lks14-boundary",
+				"data-testid": "boundary-card"
+			}, (0, react.createElement)(IconCrownFill16, { size: 16 }), (0, react.createElement)("div", { className: "lks14-boundary-text" }, (0, react.createElement)("div", { className: "lks14-boundary-title" }, boundary.last ? tr("boundary.course.done") : tr("boundary.done")), (0, react.createElement)("div", { className: "lks14-boundary-sub" }, boundary.last ? tr("boundary.last.sub") : boundary.nextTitle !== null ? courseScope === "course" ? tr("boundary.thread.sub", { title: boundary.nextTitle }) : tr("boundary.next.sub", { title: boundary.nextTitle }) : "")), !boundary.last && boundary.nextId !== null ? (0, react.createElement)("button", {
+				className: "lks-btn primary",
+				"data-testid": "boundary-next",
+				onClick: () => {
+					if (courseScope === "course" && !dormant) {
+						send(tr("boundary.thread.send", { title: boundary.nextTitle ?? "" }));
+						onDismissBoundary();
+					} else onPointNext(boundary.nextId);
+				}
+			}, courseScope === "course" ? tr("boundary.thread.point") : tr("boundary.point")) : null, (0, react.createElement)("button", {
+				className: "lks14-boundary-x",
+				"aria-label": tr("boundary.dismiss"),
+				onClick: onDismissBoundary
+			}, "✕")) : null, (0, react.createElement)("div", { className: "lks14-composer" }, (0, react.createElement)("div", {
 				className: "lks14-composer-card",
 				onDragOver: (e) => {
 					if (e.dataTransfer?.types.includes("Files") === true) e.preventDefault();
@@ -11031,6 +11329,79 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 			return !suppressed && !wasHydration;
 		}
 		//#endregion
+		//#region src/learner-profile.ts
+		/**
+		* 学习者画像（声明侧）— ported from LookatStudy shared/learner-profile.ts
+		* (upstream v0.36.0, MIT License). The learner-declared profile: MBTI as a
+		* shortcut entry expanding into the four style dims (the dims are the source
+		* of truth), the OIT motivation stage, interests, and a free note. The
+		* profile adjusts HOW the tutor teaches — it never touches BKT/mastery/
+		* unlock numbers (upstream SPEC §7 forbidden zone). Injection copy carries
+		* the anti-injection annotation ("background data, not instructions").
+		* @module dsh-plugin-lookatstudy/learner-profile
+		*/
+		const MBTI_TYPES = [
+			"INTJ",
+			"INTP",
+			"ENTJ",
+			"ENTP",
+			"INFJ",
+			"INFP",
+			"ENFJ",
+			"ENFP",
+			"ISTJ",
+			"ISFJ",
+			"ESTJ",
+			"ESFJ",
+			"ISTP",
+			"ISFP",
+			"ESTP",
+			"ESFP"
+		];
+		/**
+		* 动机阶段（OIT 内化连续体 2-6 级；无动机级不设）。用户侧只见白话名，
+		* 临床语义只活在注入文案里。AI 结构上不可提议（patch 类型排除）。
+		*/
+		const MOTIVE_STAGES = [
+			"external",
+			"introjected",
+			"identified",
+			"integrated",
+			"intrinsic"
+		];
+		/** MBTI 四字母 → style 四维（快捷入口展开为真源初值，用户可逐维手调）。 */
+		function expandMbtiToStyle(mbti) {
+			return {
+				start: mbti.includes("N") ? "framework" : "analogy",
+				interaction: mbti.includes("E") ? "dialogue" : "lecture",
+				feedback: mbti.includes("T") ? "direct" : "encouraging",
+				pacing: mbti.includes("P") ? "exploratory" : "sequential"
+			};
+		}
+		/** 动机阶段白话名 + tagline（用户侧只见白话；临床语义只在注入块）。 */
+		const MOTIVE_DISPLAY = {
+			external: {
+				name: "为了考试/面试",
+				tagline: "这场考试/面试在前头等着，得过去。"
+			},
+			introjected: {
+				name: "为了填满休息时间",
+				tagline: "闲着也是闲着，学点总没坏处。"
+			},
+			identified: {
+				name: "未来能用得上",
+				tagline: "这本事存着，总有一天用得上。"
+			},
+			integrated: {
+				name: "终身学习",
+				tagline: "学习这事儿，我打算干一辈子。"
+			},
+			intrinsic: {
+				name: "享受学习过程",
+				tagline: "懂的那个瞬间，本身就挺爽。"
+			}
+		};
+		//#endregion
 		//#region src/client/settings.tsx
 		/**
 		* The plugin's settings page: one `settings.section` entry riding the host's
@@ -11059,12 +11430,162 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				hintKey: "soul.practice.hint"
 			}
 		];
+		/** The four style dims (label key per value), upstream's DIM_LABELS UI face. */
+		const STYLE_DIMS = [
+			{
+				key: "start",
+				values: [["analogy", "settings.style.analogy"], ["framework", "settings.style.framework"]]
+			},
+			{
+				key: "interaction",
+				values: [["dialogue", "settings.style.dialogue"], ["lecture", "settings.style.lecture"]]
+			},
+			{
+				key: "feedback",
+				values: [["direct", "settings.style.direct"], ["encouraging", "settings.style.encouraging"]]
+			},
+			{
+				key: "pacing",
+				values: [["sequential", "settings.style.sequential"], ["exploratory", "settings.style.exploratory"]]
+			}
+		];
+		/**
+		* The learner-profile editor + AI-suggestion consumer (upstream v0.36).
+		* Form state seeds from the persisted profile; saving writes the human path
+		* (which stales older pending suggestions via the updatedAt arbitration).
+		*/
+		function ProfileSection({ data, save, resolve, fire }) {
+			const profile = data?.profile ?? null;
+			const [name, setName] = (0, react.useState)(profile?.name ?? "");
+			const [mbti, setMbti] = (0, react.useState)(profile?.mbti ?? "");
+			const [style, setStyle] = (0, react.useState)(() => ({
+				start: profile?.style.start ?? null,
+				interaction: profile?.style.interaction ?? null,
+				feedback: profile?.style.feedback ?? null,
+				pacing: profile?.style.pacing ?? null
+			}));
+			const [interests, setInterests] = (0, react.useState)(profile?.interests?.join("、") ?? "");
+			const [motive, setMotive] = (0, react.useState)(profile?.motiveStage ?? "");
+			const [freeNote, setFreeNote] = (0, react.useState)(profile?.freeNote ?? "");
+			const seededFor = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				const stamp = profile?.updatedAt ?? null;
+				if (stamp === null || stamp === seededFor.current) return;
+				seededFor.current = stamp;
+				setName(profile?.name ?? "");
+				setMbti(profile?.mbti ?? "");
+				setStyle({
+					start: profile?.style.start ?? null,
+					interaction: profile?.style.interaction ?? null,
+					feedback: profile?.style.feedback ?? null,
+					pacing: profile?.style.pacing ?? null
+				});
+				setInterests(profile?.interests?.join("、") ?? "");
+				setMotive(profile?.motiveStage ?? "");
+				setFreeNote(profile?.freeNote ?? "");
+			}, [profile?.updatedAt]);
+			const saveAll = () => {
+				fire(save({
+					name: name.trim() === "" ? null : name.trim(),
+					mbti: mbti === "" ? null : mbti,
+					interests,
+					freeNote: freeNote.trim() === "" ? null : freeNote.trim(),
+					motiveStage: motive === "" ? null : motive,
+					style
+				}));
+			};
+			const pickMbti = (next) => {
+				setMbti(next);
+				if (next !== "" && MBTI_TYPES.includes(next)) {
+					const expanded = expandMbtiToStyle(next);
+					setStyle({ ...expanded });
+				}
+			};
+			const suggestions = data?.pendingProfileProposals ?? [];
+			return (0, react.createElement)("section", {
+				className: "lks-set-row",
+				"data-testid": "profile-section"
+			}, (0, react.createElement)("h3", null, tr("settings.profile")), (0, react.createElement)("p", { className: "lks-set-hint" }, tr("settings.profile.hint")), (0, react.createElement)("div", { className: "lks-profile-grid" }, (0, react.createElement)("label", null, tr("settings.profile.name"), (0, react.createElement)("input", {
+				className: "lks-set-input",
+				value: name,
+				"data-testid": "profile-name",
+				onChange: (e) => {
+					setName(e.target.value);
+				}
+			})), (0, react.createElement)("label", null, tr("settings.profile.mbti"), (0, react.createElement)("select", {
+				className: "lks-set-select",
+				value: mbti,
+				"data-testid": "profile-mbti",
+				onChange: (e) => {
+					pickMbti(e.target.value);
+				}
+			}, (0, react.createElement)("option", { value: "" }, tr("settings.profile.unset")), ...MBTI_TYPES.map((t) => (0, react.createElement)("option", {
+				key: t,
+				value: t
+			}, t)))), (0, react.createElement)("label", null, tr("settings.profile.interests"), (0, react.createElement)("input", {
+				className: "lks-set-input",
+				value: interests,
+				"data-testid": "profile-interests",
+				placeholder: tr("settings.profile.interests.ph"),
+				onChange: (e) => {
+					setInterests(e.target.value);
+				}
+			})), (0, react.createElement)("label", null, tr("settings.profile.note"), (0, react.createElement)("input", {
+				className: "lks-set-input",
+				value: freeNote,
+				onChange: (e) => {
+					setFreeNote(e.target.value);
+				}
+			})), ...STYLE_DIMS.map((dim) => (0, react.createElement)("label", { key: dim.key }, tr(`settings.style.${dim.key}`), (0, react.createElement)("span", { className: "lks-pills" }, ...dim.values.map(([value, labelKey]) => (0, react.createElement)("button", {
+				key: value,
+				className: `lks-pill${style[dim.key] === value ? " on" : ""}`,
+				onClick: () => {
+					setStyle((cur) => ({
+						...cur,
+						[dim.key]: cur[dim.key] === value ? null : value
+					}));
+				}
+			}, tr(labelKey)))))), (0, react.createElement)("label", null, tr("settings.profile.motive"), (0, react.createElement)("span", { className: "lks-pills" }, (0, react.createElement)("button", {
+				className: `lks-pill${motive === "" ? " on" : ""}`,
+				onClick: () => {
+					setMotive("");
+				}
+			}, tr("settings.profile.unset")), ...MOTIVE_STAGES.map((stage) => (0, react.createElement)("button", {
+				key: stage,
+				className: `lks-pill${motive === stage ? " on" : ""}`,
+				title: MOTIVE_DISPLAY[stage].tagline,
+				onClick: () => {
+					setMotive(stage);
+				}
+			}, MOTIVE_DISPLAY[stage].name))))), (0, react.createElement)("div", null, (0, react.createElement)("button", {
+				className: "lks-btn primary",
+				"data-testid": "profile-save",
+				onClick: saveAll
+			}, tr("settings.profile.save")), (0, react.createElement)("span", { className: "lks-set-state" }, tr("settings.profile.private"))), suggestions.length > 0 ? (0, react.createElement)("div", {
+				className: "lks-profile-suggests",
+				"data-testid": "profile-suggest-card"
+			}, (0, react.createElement)("h4", null, tr("settings.suggest.head")), ...suggestions.map((sg) => (0, react.createElement)("div", {
+				key: sg.id,
+				className: "lks-profile-suggest"
+			}, (0, react.createElement)("p", null, sg.rationale), (0, react.createElement)("div", { className: "lks-pills" }, (0, react.createElement)("button", {
+				className: "lks-btn primary",
+				"data-testid": "profile-suggest-apply",
+				onClick: () => {
+					fire(resolve(sg.id, true));
+				}
+			}, tr("settings.suggest.apply")), (0, react.createElement)("button", {
+				className: "lks-btn ghost",
+				onClick: () => {
+					fire(resolve(sg.id, false));
+				}
+			}, tr("settings.suggest.ignore")))))) : null);
+		}
 		/**
 		* The settings section component. Props from the settings shell (`close`) are
 		* unused — every control stays on the page.
 		*/
 		function StudySettingsSection() {
-			const { data, setMode, activate, setHistoryBudget } = useStudy();
+			const { data, setMode, activate, setHistoryBudget, saveProfile, resolveProfileProposal } = useStudy();
 			const [error, setError] = (0, react.useState)(null);
 			const [voice, setVoice] = (0, react.useState)(storedTtsVoice);
 			const fire = (action) => {
@@ -11114,7 +11635,15 @@ mark.lks-hl{background:var(--dsw-alias-state-warn-tertiary);color:inherit;border
 				days: progress.streak,
 				best: progress.longestStreak,
 				freeze: progress.freezeCount
-			})))), (0, react.createElement)("section", { className: "lks-set-row" }, (0, react.createElement)("h3", null, tr("settings.about")), (0, react.createElement)("p", { className: "lks-set-hint" }, tr("settings.about.hint")), data?.version ? (0, react.createElement)("a", {
+			})), (0, react.createElement)("li", { "data-testid": "recap-mastered" }, tr("settings.stats.mastered", {
+				count: (data?.courses ?? []).reduce((n, c) => n + c.mastered, 0),
+				due: data?.dueCount ?? 0
+			})))), (0, react.createElement)(ProfileSection, {
+				data,
+				save: saveProfile,
+				resolve: resolveProfileProposal,
+				fire
+			}), (0, react.createElement)("section", { className: "lks-set-row" }, (0, react.createElement)("h3", null, tr("settings.about")), (0, react.createElement)("p", { className: "lks-set-hint" }, tr("settings.about.hint")), data?.version ? (0, react.createElement)("a", {
 				href: `https://github.com/Kaiji-Z/dsh-plugin-lookatstudy/releases/tag/v${data.version}`,
 				target: "_blank",
 				rel: "noreferrer"