dsh-tiddlywiki 0.16.11 → 0.16.13

package/lib/index.js

@@ -6,18 +6,6 @@ import { execFile, spawn } from "node:child_process";
 import { promisify } from "node:util";
 import { createServer } from "node:net";
 import { homedir } from "node:os";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
 //#region src/host/git.ts
 /**
 * Git face (design doc §7, D11) — the ONLY place dsh-tiddlywiki shells out to
@@ -36,10 +24,6 @@ var __exportAll = (all, no_symbols) => {
 *
 * @module dsh-tiddlywiki/host/git
 */
-var git_exports = /* @__PURE__ */ __exportAll({
-	AutoCommitter: () => AutoCommitter,
-	GitFace: () => GitFace
-});
 const execFileP = promisify(execFile);
 /** Timeout for quick read-only queries. */
 const QUICK_TIMEOUT_MS = 5e3;
@@ -706,9 +690,23 @@ function collectDescendantIds(nodes, out) {
 		}
 	}
 }
+/**
+* 汇总条目会直接写进 `[[标题]]` wikitext——标题既要能安全渲染、又不能制造死链。
+* 会话日志里常混入模型的示例/残缺写法（`#…`、`#标题`、带反引号的截断链接、
+* 控制字符等），这类收进来会被 TW 渲染成「佚失条目」；一律过滤。
+*/
+function isPlausibleTitle(title) {
+	if (title.length === 0 || title.length > 300) return false;
+	if (title.trim().length === 0) return false;
+	if (/[\u0000-\u001f\u007f]/.test(title)) return false;
+	if (/[\]|`#]/.test(title)) return false;
+	if (title.startsWith("…") || title === "标题") return false;
+	return true;
+}
 /** 记录一篇笔记的触达；同标题合并（时间取最新、detail 取最新、subagent 取 AND）。 */
 function record(map, entry) {
 	if (entry.title.startsWith("$:/")) return;
+	if (!isPlausibleTitle(entry.title)) return;
 	const prev = map.get(entry.title);
 	if (prev !== void 0) {
 		prev.time = Math.max(prev.time, entry.time);
@@ -720,7 +718,7 @@ function record(map, entry) {
 }
 /** 扫助手回复文本里的 `/dsh-tiddlywiki/tw/#标题` 引用链接 → 读取。 */
 function scanRefs(text, time, subagent, collected) {
-	const re = /\/dsh-tiddlywiki\/tw\/#([^)\s\]]+)/g;
+	const re = /\/dsh-tiddlywiki\/tw\/#([^#)\s\]]+)/g;
 	let m;
 	while ((m = re.exec(text)) !== null) {
 		const raw = m[1] ?? "";
@@ -829,29 +827,33 @@ function scanSnapshot(snap, subagent, collected) {
 		}
 	}
 }
-/** 逐个查询每篇笔记的当前状态（404 → 不存在/已删除）。 */
+/** 并发（8 路）查询每篇笔记的当前状态（404 → 不存在/已删除）。 */
 async function enrichTitles(client, titles) {
 	const out = /* @__PURE__ */ new Map();
-	for (const title of titles) try {
-		const t = await client.get(title);
-		if (t === void 0) out.set(title, {
-			exists: false,
-			tags: []
-		});
-		else {
+	const enquire = async (title) => {
+		try {
+			const t = await client.get(title);
+			if (t === void 0) return [title, {
+				exists: false,
+				tags: []
+			}];
 			const flat = typeof t.text === "string" ? t.text.replace(/\s+/g, " ").trim() : "";
-			out.set(title, {
+			return [title, {
 				exists: true,
 				tags: t.tags ?? [],
 				modified: typeof t.modified === "string" ? t.modified : void 0,
 				snippet: flat.length > 48 ? `${flat.slice(0, 48)}…` : flat
-			});
+			}];
+		} catch {
+			return [title, {
+				exists: false,
+				tags: []
+			}];
 		}
-	} catch {
-		out.set(title, {
-			exists: false,
-			tags: []
-		});
+	};
+	for (let i = 0; i < titles.length; i += 8) {
+		const batch = titles.slice(i, i + 8);
+		for (const [title, state] of await Promise.all(batch.map(enquire))) out.set(title, state);
 	}
 	return out;
 }
@@ -978,19 +980,14 @@ async function writeSessionSummary(client, sq, sessionId) {
 	};
 }
 //#endregion
-//#region src/host/routes.ts
-const ROUTE_PREFIX = PATH_PREFIX;
-/** Max JSON body for note/restart. */
-const MAX_BODY_BYTES = 2 * 1024 * 1024;
-/** Max passthrough body (tiddler content can be large). */
+//#region src/host/http.ts
+/** Default cap for small JSON bodies (note/restart/config…). */
+const MAX_JSON_BODY_BYTES = 2 * 1024 * 1024;
+/** Cap for the /api passthrough body (tiddler content can be large). */
 const MAX_PROXY_BODY_BYTES = 16 * 1024 * 1024;
-/** Max uploaded file body. */
+/** Cap for uploaded file bodies (/tw proxy, /upload). */
 const MAX_UPLOAD_BYTES = 64 * 1024 * 1024;
-/** Tiddler type for quick-notes: Markdown, so the uploaded images/links and
-*  any Markdown in the note actually render in TW (a type-less tiddler is
-*  treated as plain wiki text and shows raw `![..]`/`[..]` instead). */
-const NOTE_TYPE = "text/markdown";
-function readBody$1(req, limit = MAX_BODY_BYTES) {
+function readBodyStream(req, limit, encoding) {
 	return new Promise((resolveP, rejectP) => {
 		let size = 0;
 		const chunks = [];
@@ -1003,28 +1000,36 @@ function readBody$1(req, limit = MAX_BODY_BYTES) {
 			}
 			chunks.push(chunk);
 		});
-		req.on("end", () => resolveP(Buffer.concat(chunks).toString("utf8")));
+		req.on("end", () => {
+			const buf = Buffer.concat(chunks);
+			resolveP(encoding ? buf.toString("utf8") : buf);
+		});
 		req.on("error", rejectP);
 	});
 }
-/** Read a raw (binary-safe) request body up to `limit` bytes. */
+/** Read a JSON (utf8) request body up to `limit` bytes (default MAX_JSON_BODY_BYTES). */
+function readBody(req, limit = MAX_JSON_BODY_BYTES) {
+	return readBodyStream(req, limit, true);
+}
+/** Read a raw (binary-safe) request body up to `limit` bytes (default MAX_UPLOAD_BYTES). */
 function readBodyBuffer(req, limit = MAX_UPLOAD_BYTES) {
-	return new Promise((resolveP, rejectP) => {
-		let size = 0;
-		const chunks = [];
-		req.on("data", (chunk) => {
-			size += chunk.length;
-			if (size > limit) {
-				rejectP(/* @__PURE__ */ new Error("file too large"));
-				req.destroy();
-				return;
-			}
-			chunks.push(chunk);
-		});
-		req.on("end", () => resolveP(Buffer.concat(chunks)));
-		req.on("error", rejectP);
+	return readBodyStream(req, limit, false);
+}
+/** Write a JSON response (no-store, utf-8). */
+function json(res, payload, status = 200) {
+	res.writeHead(status, {
+		"content-type": "application/json; charset=utf-8",
+		"cache-control": "no-store"
 	});
+	res.end(JSON.stringify(payload));
 }
+//#endregion
+//#region src/host/routes.ts
+const ROUTE_PREFIX = PATH_PREFIX;
+/** Tiddler type for quick-notes: Markdown, so the uploaded images/links and
+*  any Markdown in the note actually render in TW (a type-less tiddler is
+*  treated as plain wiki text and shows raw `![..]`/`[..]` instead). */
+const NOTE_TYPE = "text/markdown";
 /** Header names forwarded to the upstream TW service by the proxy routes. */
 const FORWARD_HEADER_NAMES = [
 	"accept",
@@ -1059,14 +1064,6 @@ function sanitizeUploadName(input) {
 	if (name.length > 160) return name.slice(0, 160);
 	return name;
 }
-function json$1(res, payload, status = 200) {
-	const body = JSON.stringify(payload);
-	res.writeHead(status, {
-		"content-type": "application/json; charset=utf-8",
-		"cache-control": "no-store"
-	});
-	res.end(body);
-}
 function pad(n) {
 	return n < 10 ? `0${n}` : String(n);
 }
@@ -1138,7 +1135,7 @@ function registerRoutes(ctx, deps) {
 		} catch {
 			gitSummary = null;
 		}
-		json$1(res, {
+		json(res, {
 			ok: true,
 			...view,
 			twProxy: TW_PROXY_PATH,
@@ -1158,11 +1155,11 @@ function registerRoutes(ctx, deps) {
 		try {
 			let body = {};
 			try {
-				body = JSON.parse(await readBody$1(req));
+				body = JSON.parse(await readBody(req));
 			} catch {}
 			const session = typeof body.session === "string" && body.session.trim().length > 0 ? body.session.trim() : "";
 			if (session.length === 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "session is required"
 				}, 400);
@@ -1170,7 +1167,7 @@ function registerRoutes(ctx, deps) {
 			}
 			const client = deps.getClient();
 			if (client === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "wiki service is not running"
 				}, 503);
@@ -1178,19 +1175,19 @@ function registerRoutes(ctx, deps) {
 			}
 			const sq = deps.getSessionQuery();
 			if (sq === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "session query service unavailable"
 				}, 503);
 				return;
 			}
-			json$1(res, {
+			json(res, {
 				ok: true,
 				...await writeSessionSummary(client, sq, session),
 				twUrl: TW_PROXY_PATH
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1207,7 +1204,7 @@ function registerRoutes(ctx, deps) {
 		try {
 			const sc = deps.getSessionController();
 			if (sc === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "session service unavailable"
 				}, 503);
@@ -1220,7 +1217,7 @@ function registerRoutes(ctx, deps) {
 				const headers = await pers.list(AbortSignal.timeout(5e3));
 				for (const h of headers) if (typeof h.agentPreset === "string" && h.agentPreset.length > 0) presetById[h.id] = h.agentPreset;
 			} catch {}
-			json$1(res, {
+			json(res, {
 				ok: true,
 				items: (list.items ?? []).filter((s) => s.parentSessionId === void 0).map((s) => ({
 					sessionId: s.sessionId,
@@ -1232,40 +1229,47 @@ function registerRoutes(ctx, deps) {
 				})).sort((a, b) => b.updatedAt - a.updatedAt)
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
 		}
 	};
 	/**
+	* Shared gate for the TW-side send-to-agent routes: feature switch
+	* (`ui.sendToAgent.enabled`) then, when a shared token is configured, the
+	* `x-send-to-agent-token` header must match. Returns false after writing the
+	* error response — the caller just does `if (!guard(...)) return`.
+	*/
+	const guardSendToAgent = (req, res) => {
+		if (!deps.sendToAgentEnabled()) {
+			json(res, {
+				ok: false,
+				error: "send-to-agent is disabled"
+			}, 403);
+			return false;
+		}
+		const token = deps.sendToAgentToken().trim();
+		if (token.length === 0) return true;
+		const got = req.headers["x-send-to-agent-token"];
+		if ((typeof got === "string" ? got : Array.isArray(got) ? got[0] ?? "" : "") === token) return true;
+		json(res, {
+			ok: false,
+			error: "unauthorized"
+		}, 401);
+		return false;
+	};
+	/**
 	* GET /dsh-tiddlywiki/agent/modes — available "工作模式" (Agent presets) for
 	* the TW picker: id/name/description per preset plus the deployment default.
 	* Guards mirror the other agent routes (feature switch + optional token).
 	*/
 	const handleAgentModes = async (req, res) => {
 		try {
-			if (!deps.sendToAgentEnabled()) {
-				json$1(res, {
-					ok: false,
-					error: "send-to-agent is disabled"
-				}, 403);
-				return;
-			}
-			const token = deps.sendToAgentToken().trim();
-			if (token.length > 0) {
-				const got = req.headers["x-send-to-agent-token"];
-				if ((typeof got === "string" ? got : Array.isArray(got) ? got[0] ?? "" : "") !== token) {
-					json$1(res, {
-						ok: false,
-						error: "unauthorized"
-					}, 401);
-					return;
-				}
-			}
+			if (!guardSendToAgent(req, res)) return;
 			const ap = deps.getAgentPresets();
 			if (ap === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "agent presets service unavailable"
 				}, 503);
@@ -1288,7 +1292,7 @@ function registerRoutes(ctx, deps) {
 			} catch {
 				permissions = null;
 			}
-			json$1(res, {
+			json(res, {
 				ok: true,
 				defaultId: defaultId ?? null,
 				items: presets.map((p) => ({
@@ -1302,7 +1306,7 @@ function registerRoutes(ctx, deps) {
 				permissions
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1315,29 +1319,12 @@ function registerRoutes(ctx, deps) {
 	*/
 	const handleAgentSend = async (req, res) => {
 		try {
-			if (!deps.sendToAgentEnabled()) {
-				json$1(res, {
-					ok: false,
-					error: "send-to-agent is disabled"
-				}, 403);
-				return;
-			}
-			const token = deps.sendToAgentToken().trim();
-			if (token.length > 0) {
-				const got = req.headers["x-send-to-agent-token"];
-				if ((typeof got === "string" ? got : Array.isArray(got) ? got[0] ?? "" : "") !== token) {
-					json$1(res, {
-						ok: false,
-						error: "unauthorized"
-					}, 401);
-					return;
-				}
-			}
-			const body = JSON.parse(await readBody$1(req));
+			if (!guardSendToAgent(req, res)) return;
+			const body = JSON.parse(await readBody(req));
 			const sessionId = typeof body.sessionId === "string" && body.sessionId.trim().length > 0 ? body.sessionId.trim() : "";
 			const text = typeof body.text === "string" && body.text.trim().length > 0 ? body.text.trim() : "";
 			if (sessionId.length === 0 || text.length === 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "sessionId and text are required"
 				}, 400);
@@ -1345,7 +1332,7 @@ function registerRoutes(ctx, deps) {
 			}
 			const sc = deps.getSessionController();
 			if (sc === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "session service unavailable"
 				}, 503);
@@ -1361,13 +1348,13 @@ function registerRoutes(ctx, deps) {
 					text
 				}]
 			}, AbortSignal.timeout(2e4));
-			json$1(res, {
+			json(res, {
 				ok: true,
 				requestId,
 				sessionId
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1395,39 +1382,22 @@ function registerRoutes(ctx, deps) {
 	*/
 	const handleAgentCreate = async (req, res) => {
 		try {
-			if (!deps.sendToAgentEnabled()) {
-				json$1(res, {
-					ok: false,
-					error: "send-to-agent is disabled"
-				}, 403);
-				return;
-			}
-			const token = deps.sendToAgentToken().trim();
-			if (token.length > 0) {
-				const got = req.headers["x-send-to-agent-token"];
-				if ((typeof got === "string" ? got : Array.isArray(got) ? got[0] ?? "" : "") !== token) {
-					json$1(res, {
-						ok: false,
-						error: "unauthorized"
-					}, 401);
-					return;
-				}
-			}
-			const body = JSON.parse(await readBody$1(req));
+			if (!guardSendToAgent(req, res)) return;
+			const body = JSON.parse(await readBody(req));
 			const cwd = typeof body.cwd === "string" ? body.cwd.trim() : "";
 			const mode = typeof body.mode === "string" && body.mode.trim().length > 0 ? body.mode.trim() : void 0;
 			const permission = typeof body.permission === "string" && body.permission.trim().length > 0 ? body.permission.trim() : void 0;
 			const pp = deps.getPermissionPresets();
 			if (permission !== void 0) {
 				if (pp === void 0) {
-					json$1(res, {
+					json(res, {
 						ok: false,
 						error: "permission selected but the permission-presets service is unavailable"
 					}, 503);
 					return;
 				}
 				if (!pp.names.includes(permission)) {
-					json$1(res, {
+					json(res, {
 						ok: false,
 						error: `unknown permission preset "${permission}" (available: ${pp.names.join(", ")})`
 					}, 400);
@@ -1436,7 +1406,7 @@ function registerRoutes(ctx, deps) {
 			}
 			const sc = deps.getSessionController();
 			if (sc === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "session service unavailable"
 				}, 503);
@@ -1467,7 +1437,7 @@ function registerRoutes(ctx, deps) {
 					}
 				} catch {}
 			}
-			json$1(res, {
+			json(res, {
 				ok: true,
 				sessionId: created.sessionId,
 				cwd: cwd || null,
@@ -1477,7 +1447,7 @@ function registerRoutes(ctx, deps) {
 				permissionApplied
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1485,10 +1455,10 @@ function registerRoutes(ctx, deps) {
 	};
 	const handleNote = async (req, res) => {
 		try {
-			const body = JSON.parse(await readBody$1(req));
+			const body = JSON.parse(await readBody(req));
 			const text = typeof body.text === "string" && body.text.trim().length > 0 ? body.text.trim() : null;
 			if (text === null) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "text is required"
 				}, 400);
@@ -1496,7 +1466,7 @@ function registerRoutes(ctx, deps) {
 			}
 			const client = deps.getClient();
 			if (client === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "wiki service is not running"
 				}, 503);
@@ -1511,7 +1481,7 @@ function registerRoutes(ctx, deps) {
 				type: NOTE_TYPE
 			});
 			deps.autoCommit();
-			json$1(res, {
+			json(res, {
 				ok: true,
 				title,
 				tag: tags.join(" "),
@@ -1520,7 +1490,7 @@ function registerRoutes(ctx, deps) {
 				type: NOTE_TYPE
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1528,10 +1498,10 @@ function registerRoutes(ctx, deps) {
 	};
 	const handleEdit = async (req, res) => {
 		try {
-			const body = JSON.parse(await readBody$1(req));
+			const body = JSON.parse(await readBody(req));
 			const client = deps.getClient();
 			if (client === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "wiki service is not running"
 				}, 503);
@@ -1541,13 +1511,13 @@ function registerRoutes(ctx, deps) {
 			const tags = resolveTags(body, deps.noteDefaults().tag);
 			const result = await openInTwEditor(client, title, typeof body.text === "string" ? body.text : "", tags);
 			deps.autoCommit();
-			json$1(res, {
+			json(res, {
 				ok: true,
 				...result,
 				twUrl: TW_PROXY_PATH
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1560,7 +1530,7 @@ function registerRoutes(ctx, deps) {
 	const handleTags = async (_req, res) => {
 		const client = deps.getClient();
 		if (client === void 0) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: "wiki service is not running"
 			}, 503);
@@ -1571,7 +1541,7 @@ function registerRoutes(ctx, deps) {
 			const counts = /* @__PURE__ */ new Map();
 			for (const item of items) for (const tag of item.tags ?? []) if (tag.length > 0 && !tag.startsWith("$:/")) counts.set(tag, (counts.get(tag) ?? 0) + 1);
 			const tags = [...counts.keys()].sort((a, b) => a.localeCompare(b, "zh"));
-			json$1(res, {
+			json(res, {
 				ok: true,
 				tags,
 				items: tags.map((tag) => ({
@@ -1580,7 +1550,7 @@ function registerRoutes(ctx, deps) {
 				}))
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1590,7 +1560,7 @@ function registerRoutes(ctx, deps) {
 	const handleRecent = async (req, res) => {
 		const client = deps.getClient();
 		if (client === void 0) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: "wiki service is not running"
 			}, 503);
@@ -1600,7 +1570,7 @@ function registerRoutes(ctx, deps) {
 			const url = new URL(req.url ?? "/", "http://127.0.0.1");
 			const limitRaw = Number(url.searchParams.get("limit") ?? 15);
 			const limit = Number.isFinite(limitRaw) ? Math.max(1, Math.min(Math.floor(limitRaw), 200)) : 15;
-			json$1(res, {
+			json(res, {
 				ok: true,
 				limit,
 				items: (await client.recent(limit)).map((t) => ({
@@ -1611,7 +1581,7 @@ function registerRoutes(ctx, deps) {
 				}))
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1621,7 +1591,7 @@ function registerRoutes(ctx, deps) {
 	const handleGet = async (req, res) => {
 		const client = deps.getClient();
 		if (client === void 0) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: "wiki service is not running"
 			}, 503);
@@ -1630,7 +1600,7 @@ function registerRoutes(ctx, deps) {
 		try {
 			const title = new URL(req.url ?? "/", "http://127.0.0.1").searchParams.get("title") ?? "";
 			if (title.length === 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "missing title"
 				}, 400);
@@ -1638,7 +1608,7 @@ function registerRoutes(ctx, deps) {
 			}
 			const t = await client.get(title);
 			if (t === void 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					notFound: true,
 					title
@@ -1650,7 +1620,7 @@ function registerRoutes(ctx, deps) {
 				if (k === "title" || k === "text" || k === "tags") continue;
 				fields[k] = v;
 			}
-			json$1(res, {
+			json(res, {
 				ok: true,
 				title: t.title,
 				text: t.text ?? "",
@@ -1660,7 +1630,7 @@ function registerRoutes(ctx, deps) {
 				fields
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1675,7 +1645,7 @@ function registerRoutes(ctx, deps) {
 	const handleSearch = async (req, res) => {
 		const client = deps.getClient();
 		if (client === void 0) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: "wiki service is not running"
 			}, 503);
@@ -1697,7 +1667,7 @@ function registerRoutes(ctx, deps) {
 				type,
 				limit
 			});
-			json$1(res, {
+			json(res, {
 				ok: true,
 				query,
 				tags,
@@ -1714,7 +1684,7 @@ function registerRoutes(ctx, deps) {
 				}))
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1723,12 +1693,12 @@ function registerRoutes(ctx, deps) {
 	const handleRestart = async (_req, res) => {
 		try {
 			await deps.server.restart();
-			json$1(res, {
+			json(res, {
 				ok: true,
 				status: deps.server.status().status
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1752,7 +1722,7 @@ function registerRoutes(ctx, deps) {
 		try {
 			const pulled = await deps.git.pull(dir);
 			if (!pulled.ok) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					action: "sync",
 					message: pulled.message,
@@ -1772,7 +1742,7 @@ function registerRoutes(ctx, deps) {
 			const committed = await deps.git.commit(dir, `sync ${(/* @__PURE__ */ new Date()).toISOString()}`);
 			const pushed = await deps.git.push(dir);
 			const fresh = await status();
-			json$1(res, {
+			json(res, {
 				ok: pushed.ok,
 				action: "sync",
 				message: pushed.ok ? "同步完成" : pushed.message,
@@ -1786,7 +1756,7 @@ function registerRoutes(ctx, deps) {
 				lastSync: (/* @__PURE__ */ new Date()).toISOString()
 			}, pushed.ok ? 200 : 502);
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 500);
@@ -1812,7 +1782,7 @@ function registerRoutes(ctx, deps) {
 				name = sanitizeUploadName(decoded);
 			}
 			if (name.length === 0) {
-				json$1(res, {
+				json(res, {
 					ok: false,
 					error: "missing or invalid filename"
 				}, 400);
@@ -1833,7 +1803,7 @@ function registerRoutes(ctx, deps) {
 			}
 			await writeFile(join(filesDir, candidate), buf);
 			deps.autoCommit();
-			json$1(res, {
+			json(res, {
 				ok: true,
 				name: candidate,
 				path: `files/${candidate}`,
@@ -1842,7 +1812,7 @@ function registerRoutes(ctx, deps) {
 				type: req.headers["content-type"] ?? "application/octet-stream"
 			});
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, err instanceof Error && /too large/.test(err.message) ? 413 : 500);
@@ -1851,7 +1821,7 @@ function registerRoutes(ctx, deps) {
 	/** Passthrough /dsh-tiddlywiki/api/<rest> → TW root /<rest>. */
 	const handleApiProxy = async (req, res) => {
 		if (deps.getClient() === void 0) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: "wiki service is not running"
 			}, 503);
@@ -1870,7 +1840,7 @@ function registerRoutes(ctx, deps) {
 				headers,
 				signal: AbortSignal.timeout(15e3)
 			};
-			if (method === "PUT" || method === "POST") init.body = await readBody$1(req, MAX_PROXY_BODY_BYTES);
+			if (method === "PUT" || method === "POST") init.body = await readBody(req, MAX_PROXY_BODY_BYTES);
 			const upstream = await fetch(`${deps.server.url}${rest}${url.search}`, init);
 			const data = await upstream.text();
 			res.writeHead(upstream.status, {
@@ -1879,7 +1849,7 @@ function registerRoutes(ctx, deps) {
 			});
 			res.end(data);
 		} catch (err) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 502);
@@ -1896,7 +1866,7 @@ function registerRoutes(ctx, deps) {
 	*/
 	const handleTwProxy = async (req, res) => {
 		if (deps.getClient() === void 0) {
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: "wiki service is not running"
 			}, 503);
@@ -1935,7 +1905,7 @@ function registerRoutes(ctx, deps) {
 				res.end();
 				return;
 			}
-			json$1(res, {
+			json(res, {
 				ok: false,
 				error: err instanceof Error ? err.message : String(err)
 			}, 502);
@@ -2296,30 +2266,6 @@ async function ensureLanguage(wikiPath, twRoot, lang) {
 	await writeWikiInfo(wikiPath, info);
 	return true;
 }
-function json(res, payload, status = 200) {
-	res.writeHead(status, {
-		"content-type": "application/json; charset=utf-8",
-		"cache-control": "no-store"
-	});
-	res.end(JSON.stringify(payload));
-}
-async function readBody(req, limit = 1024 * 1024) {
-	return new Promise((resolveP, rejectP) => {
-		let size = 0;
-		const chunks = [];
-		req.on("data", (chunk) => {
-			size += chunk.length;
-			if (size > limit) {
-				rejectP(/* @__PURE__ */ new Error("body too large"));
-				req.destroy();
-				return;
-			}
-			chunks.push(chunk);
-		});
-		req.on("end", () => resolveP(Buffer.concat(chunks).toString("utf8")));
-		req.on("error", rejectP);
-	});
-}
 function registerAdminRoutes(ctx, deps) {
 	const handleState = async (_req, res) => {
 		try {
@@ -2327,7 +2273,6 @@ function registerAdminRoutes(ctx, deps) {
 			const [info, catalog] = await Promise.all([readWikiInfo(wikiPath), bundledCatalog(deps.twRoot())]);
 			let git = null;
 			try {
-				const { GitFace } = await Promise.resolve().then(() => git_exports);
 				git = await new GitFace().status(wikiPath);
 			} catch {
 				git = null;
@@ -3154,130 +3099,107 @@ const removedDetail = (id, removed) => ({
 	wrote: false,
 	detail: removed.length > 0 ? `已移除：${removed.join("、")}` : "本就不存在，无需移除"
 });
+/**
+* Define a seed from a small spec, killing the id/title/description
+* triplication and the try/catch boilerplate every registry entry used to
+* repeat by hand:
+*   - `presentTitle` → default check: is that tiddler present?
+*   - `check`        → custom presence check (overrides presentTitle).
+*   - `write`        → built-in content writer; true = (re)written this call.
+*   - `run`          → custom runner (overrides the standard write wrapper;
+*                      e.g. tw-web-host honors a user-chosen host value).
+*   - `unseed`       → remove the seeded tiddlers + markers (removable seeds).
+*/
+function defineSeed(meta, impl) {
+	const { id, title, description, core } = meta;
+	const removable = !core;
+	const check = impl.check ?? (async (ctx) => {
+		const present = await presentOf(ctx, impl.presentTitle ?? "");
+		return {
+			id,
+			title,
+			description,
+			present,
+			removable,
+			detail: present ? "已存在" : "缺失"
+		};
+	});
+	const run = impl.run ?? (async (ctx, force) => {
+		try {
+			const wrote = await impl.write(ctx.client, { force });
+			return {
+				id,
+				ok: true,
+				wrote,
+				detail: wrote ? force ? "已重新初始化" : "已写入" : force ? "内容已是最新（未重写）" : "已存在，跳过"
+			};
+		} catch (err) {
+			return {
+				id,
+				ok: false,
+				wrote: false,
+				error: err instanceof Error ? err.message : String(err)
+			};
+		}
+	});
+	const remove = impl.unseed === void 0 ? void 0 : async (ctx) => {
+		try {
+			return removedDetail(id, (await impl.unseed(ctx.client)).removed);
+		} catch (err) {
+			return {
+				id,
+				ok: false,
+				wrote: false,
+				error: err instanceof Error ? err.message : String(err)
+			};
+		}
+	};
+	return {
+		id,
+		title,
+		description,
+		core,
+		check,
+		run,
+		...remove === void 0 ? {} : { remove }
+	};
+}
 /** The full registry, in display order. */
 const SEED_DEFS = [
-	{
+	defineSeed({
 		id: "doc-note",
 		title: "插件说明笔记",
 		description: "「dsh-tiddlywiki 插件说明」——新 wiki 首启自动写入的入门说明（ONE-SHOT，用户可改可删）。",
-		core: false,
-		check: async (ctx) => {
-			const present = await presentOf(ctx, DOC_NOTE_TITLE);
-			return {
-				id: "doc-note",
-				title: "插件说明笔记",
-				description: "「dsh-tiddlywiki 插件说明」——新 wiki 首启自动写入的入门说明（ONE-SHOT，用户可改可删）。",
-				present,
-				removable: true,
-				detail: present ? "已存在" : "缺失"
-			};
-		},
-		run: async (ctx, force) => {
-			try {
-				const wrote = await seedDocNote(ctx.client, { force });
-				return {
-					id: "doc-note",
-					ok: true,
-					wrote,
-					detail: wrote ? force ? "已重新初始化" : "已写入" : force ? "内容已是最新（未重写）" : "已存在，跳过"
-				};
-			} catch (err) {
-				return {
-					id: "doc-note",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		},
-		remove: async (ctx) => {
-			try {
-				return removedDetail("doc-note", (await unseedDocNote(ctx.client)).removed);
-			} catch (err) {
-				return {
-					id: "doc-note",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		}
-	},
-	{
+		core: false
+	}, {
+		presentTitle: DOC_NOTE_TITLE,
+		write: seedDocNote,
+		unseed: unseedDocNote
+	}),
+	defineSeed({
 		id: "send-to-agent",
 		title: "「发送给 Agent」按钮",
 		description: "TW 笔记工具栏「发送给 Agent」按钮插件（$:/plugins/dsh/send-to-agent）——把笔记一键注入 DSH 会话。",
-		core: true,
-		check: async (ctx) => {
-			const present = await presentOf(ctx, SEND_TO_AGENT_PLUGIN_TITLE);
-			return {
-				id: "send-to-agent",
-				title: "「发送给 Agent」按钮",
-				description: "TW 笔记工具栏「发送给 Agent」按钮插件（$:/plugins/dsh/send-to-agent）——把笔记一键注入 DSH 会话。",
-				present,
-				removable: false,
-				detail: present ? "已存在" : "缺失"
-			};
-		},
-		run: async (ctx, force) => {
-			try {
-				const wrote = await seedSendToAgent(ctx.client, { force });
-				return {
-					id: "send-to-agent",
-					ok: true,
-					wrote,
-					detail: wrote ? force ? "已重新初始化" : "已写入" : force ? "内容已是最新（未重写）" : "已存在，跳过"
-				};
-			} catch (err) {
-				return {
-					id: "send-to-agent",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		}
-	},
-	{
+		core: true
+	}, {
+		presentTitle: SEND_TO_AGENT_PLUGIN_TITLE,
+		write: seedSendToAgent
+	}),
+	defineSeed({
 		id: "render-route",
 		title: "原生渲染路由（/render）",
 		description: "TW 服务端路由插件（$:/plugins/dsh/render，server-routes/render.js）——把 wiki 文本在运行中的 TW 里原生渲染成 HTML 片段，回复流工具卡与 wiki 链接跳转依赖它。seed 写入后需重启 TW 使路由生效。",
-		core: true,
-		check: async (ctx) => {
-			const present = await presentOf(ctx, RENDER_PLUGIN_TITLE);
-			return {
-				id: "render-route",
-				title: "原生渲染路由（/render）",
-				description: "TW 服务端路由插件（$:/plugins/dsh/render，server-routes/render.js）——把 wiki 文本在运行中的 TW 里原生渲染成 HTML 片段，回复流工具卡与 wiki 链接跳转依赖它。seed 写入后需重启 TW 使路由生效。",
-				present,
-				removable: false,
-				detail: present ? "已存在" : "缺失"
-			};
-		},
-		run: async (ctx, force) => {
-			try {
-				const wrote = await seedRenderRoute(ctx.client, { force });
-				return {
-					id: "render-route",
-					ok: true,
-					wrote,
-					detail: wrote ? force ? "已重新初始化" : "已写入" : force ? "内容已是最新（未重写）" : "已存在，跳过"
-				};
-			} catch (err) {
-				return {
-					id: "render-route",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		}
-	},
-	{
+		core: true
+	}, {
+		presentTitle: RENDER_PLUGIN_TITLE,
+		write: seedRenderRoute
+	}),
+	defineSeed({
 		id: "home-index",
 		title: "首页（主页 / 所有标签 / 标签笔记）",
 		description: "默认主页：四象限待办 + 「所有标签」「所有文章」入口；所有标签：标签统计 + Agent 区块（纯 Agent / Agent+人工）；标签笔记：按标签浏览。系统提示承诺的首页由这里 seed，主页同时写入 $:/DefaultTiddlers。",
-		core: false,
+		core: false
+	}, {
 		check: async (ctx) => {
 			const missing = [];
 			for (const item of HOME_INDEX_ITEMS) if (!await presentOf(ctx, item.title)) missing.push(item.title);
@@ -3290,136 +3212,35 @@ const SEED_DEFS = [
 				detail: missing.length === 0 ? "已存在" : `缺失：${missing.join("、")}`
 			};
 		},
-		run: async (ctx, force) => {
-			try {
-				const wrote = await seedHomeIndex(ctx.client, { force });
-				return {
-					id: "home-index",
-					ok: true,
-					wrote,
-					detail: wrote ? force ? "已重新初始化" : "已写入" : force ? "内容已是最新（未重写）" : "已存在，跳过"
-				};
-			} catch (err) {
-				return {
-					id: "home-index",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		},
-		remove: async (ctx) => {
-			try {
-				return removedDetail("home-index", (await unseedHomeIndex(ctx.client)).removed);
-			} catch (err) {
-				return {
-					id: "home-index",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		}
-	},
-	{
+		write: seedHomeIndex,
+		unseed: unseedHomeIndex
+	}),
+	defineSeed({
 		id: "all-articles",
 		title: "所有文章（两列分页总览）",
 		description: "「所有文章」——全部条目分两列（🤖 Agent 撰写 / 👤 人工·人类）各自分页展示。每页条数取插件设置 ui.allArticles.pageSize（默认 10）。",
-		core: false,
-		check: async (ctx) => {
-			const present = await presentOf(ctx, ALL_ARTICLES_TITLE);
-			return {
-				id: "all-articles",
-				title: "所有文章（两列分页总览）",
-				description: "「所有文章」——全部条目分两列（🤖 Agent 撰写 / 👤 人工·人类）各自分页展示。每页条数取插件设置 ui.allArticles.pageSize（默认 10）。",
-				present,
-				removable: true,
-				detail: present ? "已存在" : "缺失"
-			};
-		},
-		run: async (ctx, force) => {
-			try {
-				const wrote = await seedAllArticles(ctx.client, { force });
-				return {
-					id: "all-articles",
-					ok: true,
-					wrote,
-					detail: wrote ? force ? "已重新初始化" : "已写入" : force ? "内容已是最新（未重写）" : "已存在，跳过"
-				};
-			} catch (err) {
-				return {
-					id: "all-articles",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		},
-		remove: async (ctx) => {
-			try {
-				return removedDetail("all-articles", (await unseedAllArticles(ctx.client)).removed);
-			} catch (err) {
-				return {
-					id: "all-articles",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		}
-	},
-	{
+		core: false
+	}, {
+		presentTitle: ALL_ARTICLES_TITLE,
+		write: seedAllArticles,
+		unseed: unseedAllArticles
+	}),
+	defineSeed({
 		id: "menubar-theme",
 		title: "menubar 顶栏主题自适应",
 		description: "样式表覆盖（$:/plugins/dsh-tiddlywiki/menubar-theme，tag $:/tags/Stylesheet）——把 tiddlywiki/menubar 顶栏从「默认色映射的蓝色」改为跟随当前 palette 的 background/foreground，随 DSH 主题切换（$:/palette 翻转）自动换色。",
-		core: false,
-		check: async (ctx) => {
-			const present = await presentOf(ctx, MENUBAR_THEME_TIDDLER);
-			return {
-				id: "menubar-theme",
-				title: "menubar 顶栏主题自适应",
-				description: "样式表覆盖（$:/plugins/dsh-tiddlywiki/menubar-theme，tag $:/tags/Stylesheet）——把 tiddlywiki/menubar 顶栏从「默认色映射的蓝色」改为跟随当前 palette 的 background/foreground，随 DSH 主题切换（$:/palette 翻转）自动换色。",
-				present,
-				removable: true,
-				detail: present ? "已存在" : "缺失"
-			};
-		},
-		run: async (ctx, force) => {
-			try {
-				const wrote = await seedMenubarTheme(ctx.client, { force });
-				return {
-					id: "menubar-theme",
-					ok: true,
-					wrote,
-					detail: wrote ? force ? "已重新初始化" : "已写入" : force ? "内容已是最新（未重写）" : "已存在，跳过"
-				};
-			} catch (err) {
-				return {
-					id: "menubar-theme",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		},
-		remove: async (ctx) => {
-			try {
-				return removedDetail("menubar-theme", (await unseedMenubarTheme(ctx.client)).removed);
-			} catch (err) {
-				return {
-					id: "menubar-theme",
-					ok: false,
-					wrote: false,
-					error: err instanceof Error ? err.message : String(err)
-				};
-			}
-		}
-	},
-	{
+		core: false
+	}, {
+		presentTitle: MENUBAR_THEME_TIDDLER,
+		write: seedMenubarTheme,
+		unseed: unseedMenubarTheme
+	}),
+	defineSeed({
 		id: "tw-web-host",
 		title: "TW 前端 API 基址（同源代理）",
 		description: "把 $:/config/tiddlyweb/host 指向 DSH 同源代理，嵌入式 TW 才能经 DSH origin 访问（远程访问模式的前提）。",
-		core: true,
+		core: true
+	}, {
 		check: async (ctx) => {
 			let current;
 			try {
@@ -3472,7 +3293,7 @@ const SEED_DEFS = [
 				};
 			}
 		}
-	}
+	})
 ];
 /** Check every seed, returning statuses in registry order. */
 async function checkAllSeeds(ctx) {
@@ -3965,6 +3786,13 @@ function registerTiddlywikiTools(ctx, deps) {
 	const register = (tool) => {
 		disposers.push(ctx.tools.register(tool));
 	};
+	/** Every read/write tool needs a live TW client — shared guard for the 8
+	*  wiki-facing tools (git tools operate on the repo path instead). */
+	const requireWiki = () => {
+		const wiki = deps.wiki();
+		if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
+		return wiki;
+	};
 	register(defineTool({
 		name: "tiddlywiki_search",
 		description: "检索 TiddlyWiki 持久知识库：按关键词（可选 tags 数组 / since 修改时间 / type / limit）搜索非系统 tiddler，返回标题、标签、修改时间与摘要片段。",
@@ -4019,9 +3847,7 @@ function registerTiddlywikiTools(ctx, deps) {
 			}
 		},
 		execute: async (args) => {
-			const wiki = deps.wiki();
-			if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
-			const { items, total } = await wiki.search(args.query, {
+			const { items, total } = await requireWiki().search(args.query, {
 				tags: args.tags,
 				tag: args.tag,
 				since: args.since,
@@ -4073,9 +3899,7 @@ function registerTiddlywikiTools(ctx, deps) {
 			}
 		},
 		execute: async (args) => {
-			const wiki = deps.wiki();
-			if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
-			const items = await wiki.recent(args.limit ?? 15, args.since);
+			const items = await requireWiki().recent(args.limit ?? 15, args.since);
 			return {
 				since: args.since ?? null,
 				results: items.map((t) => ({
@@ -4107,9 +3931,7 @@ function registerTiddlywikiTools(ctx, deps) {
 			}
 		},
 		execute: async () => {
-			const wiki = deps.wiki();
-			if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
-			const tags = await wiki.listTags();
+			const tags = await requireWiki().listTags();
 			return {
 				count: tags.length,
 				tags
@@ -4145,9 +3967,7 @@ function registerTiddlywikiTools(ctx, deps) {
 			}
 		},
 		execute: async (args) => {
-			const wiki = deps.wiki();
-			if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
-			const t = await wiki.get(args.title);
+			const t = await requireWiki().get(args.title);
 			if (t === void 0) return {
 				notFound: true,
 				title: args.title,
@@ -4206,8 +4026,7 @@ function registerTiddlywikiTools(ctx, deps) {
 			}
 		},
 		execute: async (args) => {
-			const wiki = deps.wiki();
-			if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
+			const wiki = requireWiki();
 			const existing = await wiki.get(args.title).catch(() => void 0);
 			const tags = finalTagsForWrite(args.title, existing, Array.isArray(args.tags) ? args.tags.filter((t) => typeof t === "string" && t.trim().length > 0) : []);
 			const tiddler = {
@@ -4276,8 +4095,7 @@ function registerTiddlywikiTools(ctx, deps) {
 			}
 		},
 		execute: async (args) => {
-			const wiki = deps.wiki();
-			if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
+			const wiki = requireWiki();
 			const list = Array.isArray(args.items) ? args.items : [];
 			if (list.length === 0) return {
 				ok: true,
@@ -4358,8 +4176,7 @@ function registerTiddlywikiTools(ctx, deps) {
 			}
 		},
 		execute: async (args) => {
-			const wiki = deps.wiki();
-			if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
+			const wiki = requireWiki();
 			const { oldTitle, newTitle } = args;
 			if (oldTitle === newTitle) return {
 				ok: true,
@@ -4425,9 +4242,7 @@ function registerTiddlywikiTools(ctx, deps) {
 			}]
 		},
 		execute: async (args) => {
-			const wiki = deps.wiki();
-			if (wiki === void 0) throw new Error("TiddlyWiki 服务未运行（tiddlywiki_status 可查）");
-			await wiki.delete(args.title);
+			await requireWiki().delete(args.title);
 			deps.autoCommit();
 			return {
 				ok: true,
@@ -4545,15 +4360,7 @@ function registerTiddlywikiTools(ctx, deps) {
 				lines.push(`  ${value.message}`);
 				if (value.files !== void 0 && value.files.length > 0) lines.push(`涉及文件: ${value.files.join(", ")}`);
 				if (value.commit !== void 0) lines.push(`本地 commit: ${value.commit}`);
-				if (value.status !== void 0) {
-					const s = value.status;
-					const bits = [`分支 ${s.branch}`];
-					if (s.ahead !== void 0) bits.push(`领先 ${s.ahead}`);
-					if (s.behind !== void 0) bits.push(`落后 ${s.behind}`);
-					if (s.dirty) bits.push(`工作区有 ${s.dirtyFiles.length} 个未提交改动`);
-					if (s.lastCommit !== void 0) bits.push(`最近提交 ${s.lastCommit}`);
-					lines.push(`状态: ${bits.join(" · ")}`);
-				}
+				if (value.status !== void 0) lines.push(`状态: ${gitStatusBits(value.status)}`);
 				return [{
 					type: "text",
 					text: lines.join("\n")
@@ -4612,6 +4419,15 @@ function registerTiddlywikiTools(ctx, deps) {
 	}));
 	return disposers;
 }
+/** One-line 状态 summary: 分支 … 领先 … 落后 … 工作区未提交 … 最近提交. */
+function gitStatusBits(s) {
+	const bits = [`分支 ${s.branch}`];
+	if (s.ahead !== void 0) bits.push(`领先 ${s.ahead}`);
+	if (s.behind !== void 0) bits.push(`落后 ${s.behind}`);
+	if (s.dirty) bits.push(`工作区有 ${s.dirtyFiles.length} 个未提交改动`);
+	if (s.lastCommit !== void 0) bits.push(`最近提交 ${s.lastCommit}`);
+	return bits.join(" · ");
+}
 function renderSync(value) {
 	const lines = [`git ${value.action}: ${value.ok ? "成功" : "失败"}`];
 	lines.push(`  ${value.message}`);
@@ -4625,13 +4441,8 @@ function renderSync(value) {
 	if (value.changed === true) lines.push(value.restarted === true ? "本次 pull 拉取了新内容，TW 服务已自动重启（同端口），读取/搜索均为最新快照。" : "本次 pull 拉取了新内容，但 TW 服务未能自动重启（如需最新快照，请手动重启 TW）。");
 	if (value.restartError !== void 0) lines.push(`TW 重启失败: ${value.restartError}`);
 	if (value.status !== void 0) {
+		lines.push(`状态: ${gitStatusBits(value.status)}`);
 		const s = value.status;
-		const bits = [`分支 ${s.branch}`];
-		if (s.ahead !== void 0) bits.push(`领先 ${s.ahead}`);
-		if (s.behind !== void 0) bits.push(`落后 ${s.behind}`);
-		if (s.dirty) bits.push(`工作区有 ${s.dirtyFiles.length} 个未提交改动`);
-		if (s.lastCommit !== void 0) bits.push(`最近提交 ${s.lastCommit}`);
-		lines.push(`状态: ${bits.join(" · ")}`);
 		if (s.dirty && s.dirtyFiles.length > 0) lines.push(`  未提交: ${s.dirtyFiles.join(", ")}`);
 	}
 	return [{
@@ -4686,8 +4497,10 @@ const DEFAULTS = {
 		darkPalette: DARK_PALETTE_DEFAULT,
 		tabLabel: "知识库",
 		showSessionTab: true,
-		sendToAgent: { enabled: true }
+		sendToAgent: { enabled: true },
+		allArticles: { pageSize: 10 }
 	},
+	uiLanguage: "",
 	auth: {
 		username: "",
 		password: ""
@@ -4815,8 +4628,17 @@ function apply(ctx, rawConfig = {}) {
 		},
 		ui: {
 			...DEFAULTS.ui,
-			...rawConfig.ui ?? {}
+			...rawConfig.ui ?? {},
+			sendToAgent: {
+				...DEFAULTS.ui.sendToAgent,
+				...rawConfig.ui?.sendToAgent ?? {}
+			},
+			allArticles: {
+				...DEFAULTS.ui.allArticles,
+				...rawConfig.ui?.allArticles ?? {}
+			}
 		},
+		uiLanguage: typeof rawConfig.uiLanguage === "string" ? rawConfig.uiLanguage.trim() : DEFAULTS.uiLanguage,
 		auth: {
 			...DEFAULTS.auth,
 			...rawConfig.auth ?? {}
@@ -4827,7 +4649,8 @@ function apply(ctx, rawConfig = {}) {
 	const configStore = new ConfigStore({
 		note: config.note,
 		git: config.git,
-		ui: config.ui
+		ui: config.ui,
+		uiLanguage: config.uiLanguage
 	});
 	const eff = () => configStore.get();
 	const effectiveNoteTag = () => {