dsh-plugin-lookatstudy 0.20.0 → 0.21.0

package/lib/index.d.mts

@@ -32,7 +32,7 @@ declare const Config: z<Config>;
 declare const name = "lookatstudy-plugin";
 declare const inject: string[];
 /**
- * Register the activation-gated study surface: the 25 `study_*` tools (kept
+ * Register the activation-gated study surface: the 31 `study_*` tools (kept
  * unregistered while dormant), the tutor persona (stable core + soul), the
  * dynamic learner-snapshot context, and the `/study` command — every prompt
  * text renders empty while inactive, and empty sections are dropped at

package/lib/index.mjs

@@ -201,6 +201,9 @@ const ZH = {
 	"note.retryRender": "重试渲染",
 	"zoom.in": "放大面板字号",
 	"zoom.out": "缩小面板字号",
+	"pane.rail.aria": "调整课程栏宽度",
+	"pane.chat.aria": "调整对话栏宽度",
+	"pane.tip": "拖拽调宽,双击重置",
 	"palette.label": "命令面板",
 	"palette.placeholder": "搜索课时/课程,或选择动作…",
 	"palette.lessons": "课时",
@@ -544,6 +547,9 @@ const EN = {
 	"note.retryRender": "Retry render",
 	"zoom.in": "Increase panel font size",
 	"zoom.out": "Decrease panel font size",
+	"pane.rail.aria": "Resize the course pane width",
+	"pane.chat.aria": "Resize the chat pane width",
+	"pane.tip": "Drag to resize, double-click to reset",
 	"palette.label": "Command palette",
 	"palette.placeholder": "Search lessons/courses or pick an action…",
 	"palette.lessons": "Lesson",
@@ -1485,9 +1491,11 @@ function freshLesson(title, anchor, body, kind = "study") {
 * @param parsed - course tree from an importer.
 * @param source - import origin.
 * @param sourceRef - markdown/folder/repo reference for display.
+* @param languageTarget - the taught language (BCP-47) when the course IS a
+*  language course (design-apply path only; markdown imports stay undefined).
 * @returns the imported (or pre-existing) course.
 */
-function importCourse(state, parsed, source, sourceRef) {
+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;
@@ -1497,6 +1505,7 @@ function importCourse(state, parsed, source, sourceRef) {
 		source,
 		sourceRef,
 		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+		languageTarget: languageTarget ?? null,
 		sections: parsed.sections.map((section) => {
 			const lessons = section.lessons.map((lesson) => (() => {
 				const st = freshLesson(lesson.title, lesson.anchor, lesson.body, lesson.world === "practice" ? "practice" : "study");
@@ -2626,11 +2635,13 @@ function sendJson(res, status, value) {
 /**
 * Read one JSON body, answering 400 on malformed or oversized input so the
 * handler never throws into the HTTP layer.
+* @param maxBytes - per-route body ceiling; defaults to the tight 64 kB every
+* small-json route wants (issue #4: only the attachment intake lifts it).
 * @returns the parsed value, or undefined when the response is already sent.
 */
-async function readJsonBodySafe(req, res) {
+async function readJsonBodySafe(req, res, maxBytes = 65536) {
 	try {
-		return await readJsonBody(req);
+		return await readJsonBody(req, maxBytes);
 	} catch (error) {
 		sendJson(res, 400, {
 			ok: false,
@@ -2639,13 +2650,13 @@ async function readJsonBodySafe(req, res) {
 		return;
 	}
 }
-/** Read one JSON request body with a hard 64 kB cap; malformed bodies reject. */
-function readJsonBody(req) {
+/** Read one JSON request body with a hard cap (64 kB unless the route lifts it); malformed bodies reject. */
+function readJsonBody(req, maxBytes = 65536) {
 	return new Promise((resolve, reject) => {
 		const chunks = [];
 		req.on("data", (chunk) => {
 			chunks.push(chunk);
-			if (chunks.reduce((n, c) => n + c.length, 0) > 65536) {
+			if (chunks.reduce((n, c) => n + c.length, 0) > maxBytes) {
 				reject(/* @__PURE__ */ new Error("request body too large"));
 				return;
 			}
@@ -3140,7 +3151,7 @@ function registerDashboard(webServer, deps) {
 				return;
 			}
 			if (req.method === "POST" && pathname === "/lookatstudy/api/attachment") {
-				const body = await readJsonBodySafe(req, res);
+				const body = await readJsonBodySafe(req, res, 29360128);
 				if (body === void 0) return;
 				const name = typeof body.name === "string" ? body.name.trim() : "";
 				const data = typeof body.dataBase64 === "string" ? body.dataBase64 : "";
@@ -5043,8 +5054,13 @@ function renderDesignBrief(pending, part = 1) {
 	lines.push("- if the directory layout is already clear (e.g. lessons/N-Topic/), keep its sections; do not over-reorganize.");
 	lines.push(`- anchor is the full heading text used to slice the body; omit it for whole-file lessons.${shown.length > 80 ? " This part is large: design at file granularity (omit anchors, one lesson per file) to keep the JSON manageable." : ""}`);
 	lines.push("");
+	lines.push("### Language-course check (decide while designing)");
+	lines.push("Is this course teaching a language ITSELF (vocabulary, grammar, reading/writing/listening of English/Japanese/Korean/Chinese/…), rather than a knowledge/tech course that merely happens to be written in some language? Typical tells: vocab lists, grammar-point explanations, dialogues/readings, sentence-translation pairs, level markers (N5/N1, TOEFL/IELTS, HSK, JLPT), pronunciation content.");
+	lines.push("- Yes → add \"languageTarget\": \"<BCP-47 of the TAUGHT language>\" (teaching English → \"en\", Japanese → \"ja\"). The writing language is NOT the taught language — a Chinese-written English-textbook repo has languageTarget \"en\".");
+	lines.push("- No, or unsure → omit it entirely (a normal course misflagged as a language course is worse than the reverse).");
+	lines.push("");
 	lines.push("Now design the course and call study_apply_design with:");
-	lines.push("{ \"sections\": [ { \"title\": \"...\", \"lessons\": [ { \"title\": \"...\", \"file\": \"<exact path from this brief>\", \"anchor\": \"<optional full heading text>\", \"world\": \"study\" | \"practice\" } ] } ] }");
+	lines.push("{ \"languageTarget\": \"<only for language courses>\", \"sections\": [ { \"title\": \"...\", \"lessons\": [ { \"title\": \"...\", \"file\": \"<exact path from this brief>\", \"anchor\": \"<optional full heading text>\", \"world\": \"study\" | \"practice\" } ] } ] }");
 	lines.push("Use ONLY file paths that appear in this brief — anything else is dropped. Apply directly, then walk the learner through the course map.");
 	return lines.join("\n");
 }
@@ -6124,50 +6140,56 @@ function studyTools(store, deps = {}) {
 	const applyDesign = defineTool({
 		name: "study_apply_design",
 		description: "Apply the tutor-designed course structure to the pending import (the one study_import_github or study_import_folder returned design_required for). Every lesson's file must come from the design brief — unknown paths are dropped (anti-hallucination); lesson bodies are sliced by their anchor heading and the course is imported. On a validation or fetch error the tutor fixes the design and simply calls again.",
-		parameters: { sections: {
-			type: "array",
-			required: true,
-			description: "Designed sections in learning order.",
-			items: {
-				type: "object",
-				additionalProperties: false,
-				properties: {
-					title: {
-						type: "string",
-						required: true,
-						description: "Section title (in the learner's language)."
-					},
-					lessons: {
-						type: "array",
-						required: true,
-						items: {
-							type: "object",
-							additionalProperties: false,
-							properties: {
-								title: {
-									type: "string",
-									required: true,
-									description: "Lesson title."
-								},
-								file: {
-									type: "string",
-									required: true,
-									description: "Exact file path from the design brief."
-								},
-								anchor: {
-									type: "string",
-									description: "Full H2/H3 heading text the lesson body starts at; omit for whole-file lessons."
-								},
-								world: {
-									type: "string",
-									description: "\"study\" (explanation) or \"practice\" (exercise/lab/notebook); anything else is treated as study."
+		parameters: {
+			languageTarget: {
+				type: "string",
+				description: "Set ONLY when this course teaches a language ITSELF (vocabulary, grammar, reading/writing of English/Japanese/Chinese/…) rather than being a knowledge/tech course that merely happens to be written in some language: the taught language as a BCP-47 tag (\"en\", \"ja\", \"zh-CN\", …). The writing language is NOT the taught language — a Chinese-written English-textbook repo has languageTarget \"en\". Typical tells: vocab lists, grammar points, dialogues/readings, sentence-translation pairs, level markers (N5/N1, TOEFL, HSK, JLPT), pronunciation content. When unsure, omit it — a normal course misflagged as a language course is worse than the reverse."
+			},
+			sections: {
+				type: "array",
+				required: true,
+				description: "Designed sections in learning order.",
+				items: {
+					type: "object",
+					additionalProperties: false,
+					properties: {
+						title: {
+							type: "string",
+							required: true,
+							description: "Section title (in the learner's language)."
+						},
+						lessons: {
+							type: "array",
+							required: true,
+							items: {
+								type: "object",
+								additionalProperties: false,
+								properties: {
+									title: {
+										type: "string",
+										required: true,
+										description: "Lesson title."
+									},
+									file: {
+										type: "string",
+										required: true,
+										description: "Exact file path from the design brief."
+									},
+									anchor: {
+										type: "string",
+										description: "Full H2/H3 heading text the lesson body starts at; omit for whole-file lessons."
+									},
+									world: {
+										type: "string",
+										description: "\"study\" (explanation) or \"practice\" (exercise/lab/notebook); anything else is treated as study."
+									}
 								}
 							}
 						}
 					}
 				}
 			}
-		} },
+		},
 		output: {
 			schema: {
 				type: "object",
@@ -6200,12 +6222,16 @@ function studyTools(store, deps = {}) {
 					droppedLessons: {
 						type: "integer",
 						required: true
+					},
+					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."
 					}
 				}
 			},
 			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` : ""}). First lesson: “${value.firstLessonTitle}” (id ${value.firstLessonId}). Present the course map to the learner.`
+				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.`
 			}]
 		},
 		async execute(args, exec) {
@@ -6234,12 +6260,14 @@ 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 value = mutate((state) => toImportValue(importCourse(state, parsed, pd.source, pd.url)));
+			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)));
 			pendingDesign = null;
 			pendingPart = 1;
 			return {
 				...value,
-				droppedLessons: validated.droppedLessons
+				droppedLessons: validated.droppedLessons,
+				...languageTarget !== null ? { languageTarget } : {}
 			};
 		},
 		timeoutMs: 18e4,
@@ -8688,6 +8716,45 @@ function studyTools(store, deps = {}) {
 	];
 }
 //#endregion
+//#region src/vendor/locale-names.ts
+/**
+* Vendored from LookatStudy shared/locales.ts (MIT License,
+* https://github.com/Kaiji-Z/LookatStudy), upstream v0.33.2 — only the
+* name-map + lookup function (the language-course round's BCP-47 → display
+* name need). Unmodified except this provenance header.
+*
+* locales —— BCP-47 → 人类可读语言名的共享映射(纯函数)。
+* 未知 locale 一律原样返回(如 "pt" → "pt"),不猜名字。
+*/
+/** locale → 该语言的自称名(尽量用母语写法,语言学习者认得出) */
+const LOCALE_LANGUAGE_NAMES = {
+	en: "English",
+	"zh-CN": "中文",
+	"zh-TW": "繁體中文",
+	ja: "日本語",
+	ko: "한국어",
+	fr: "Français",
+	de: "Deutsch",
+	es: "Español",
+	"pt-BR": "Português",
+	ru: "Русский",
+	it: "Italiano",
+	ar: "العربية",
+	hi: "हिन्दी",
+	tr: "Türkçe",
+	pl: "Polski",
+	nl: "Nederlands",
+	id: "Indonesia",
+	vi: "Tiếng Việt",
+	th: "ไทย",
+	sv: "Svenska",
+	fi: "Suomi"
+};
+/** BCP-47 → 语言名;未映射的 locale 原样返回 */
+function localeToLanguageName(locale) {
+	return LOCALE_LANGUAGE_NAMES[locale] ?? locale;
+}
+//#endregion
 //#region src/surface.ts
 /**
 * Stable tutor core (ported from LookatStudy's BASE_AGENT_PROMPT plus its
@@ -8798,6 +8865,16 @@ function snapshotSectionText(state) {
 	if (memory.length > 0) lines.push(`记忆: ${memory.join(" | ")}`);
 	if (snap.dueCount > 0) lines.push(`今日待复习: ${snap.dueCount} 项`);
 	if (snap.pendingProposal !== null) lines.push(`待决提案 ${snap.pendingProposal.id}: ${snap.pendingProposal.rationale}(等学习者表态)`);
+	const focusCourse = state.courses.find((c) => c.id === snap.focus?.courseId);
+	if (focusCourse?.languageTarget != null && focusCourse.languageTarget !== "") {
+		const t = localeToLanguageName(focusCourse.languageTarget);
+		lines.push("");
+		lines.push(`【语言教学姿态】这门课程教的是${t}——教学语言(讲解、指令、反馈)跟随学习者的界面语言,${t}是学习对象:`);
+		lines.push(`- 课文引用、例句、题目素材保持${t}原文,考察目标语言本身——不要把目标语言材料翻译成教学语言来讲解或出题(生词首次出现可附教学语言注释,注释是辅助不是替代);`);
+		lines.push(`- 出题双轴:题干和选项中的语言素材(句子/单词/短语/语法点)用${t}原文,指令性文字和解析用教学语言;`);
+		lines.push(`- 学习者用${t}造句或表达时,先肯定再纠正其中的语言错误(语法/用词/拼写),用教学语言讲清错在哪;`);
+		lines.push(`- 随掌握度上升,渐进提高${t}素材的占比,把学习者往"直接用${t}读"带。`);
+	}
 	if (state.historyBudget === true) lines.push("历史预算已开启:当会话变长时,主动概括旧轮次的要点并基于概要继续,避免逐字复读历史。");
 	return lines.join("\n");
 }
@@ -8843,7 +8920,7 @@ function createStudySurface(registry, store) {
 const name = "lookatstudy-plugin";
 const inject = ["tools", "systemPrompt"];
 /**
-* Register the activation-gated study surface: the 25 `study_*` tools (kept
+* Register the activation-gated study surface: the 31 `study_*` tools (kept
 * unregistered while dormant), the tutor persona (stable core + soul), the
 * dynamic learner-snapshot context, and the `/study` command — every prompt
 * text renders empty while inactive, and empty sections are dropped at

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-lookatstudy",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "packageManager": "pnpm@11.7.0",
   "description": "Turn any markdown, local folder, or GitHub learning repo into a guided course inside DeepSeek Harness: gated skill-tree progression, BKT mastery tracking, SM-2 spaced repetition.",
   "type": "module",