dsh-plugin-lookatstudy 0.8.1 → 0.9.0

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

@@ -102,6 +102,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}
@@ -325,6 +326,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 +375,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),
@@ -707,14 +721,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 +773,27 @@ 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 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", {
 				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 +817,7 @@ window.__ModuleLoader__.load({
 				}
 			}, p.label))), (0, react.createElement)(CourseRail, {
 				data,
+				activate,
 				setFocus,
 				deleteCourse,
 				bindLessonSession,
@@ -811,7 +832,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 +849,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();
@@ -1129,6 +1151,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 +1160,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 +1193,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);