dsh-sun-space 0.2.8 → 0.3.0

package/lib/index.mjs

@@ -18,29 +18,35 @@ var __exportAll = (all, no_symbols) => {
 /**
 * vault 路径解析——唯一事实源，全插件共享（source/router-tools/worker-vault/worker-watchdog）。
 *
-* 解析优先级：
+* 解析优先级（vaultPath() 每次调用重读，运行期变更即时生效）：
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
 *   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
-*   ③ 默认约定 ~/Workspace/sun-vault
+*   ③ ~/.dsh/state/sun-space/state.json 的 vault 字段（Router 会话创建时插件自动登记 = 用户选定的工作区目录）
+*   ④ 会话工作目录（调用方从 exec 提取传入——用户在哪个工作区开会话，vault 就解析到哪）
+*   ⑤ 默认约定 ~/Workspace/sun-vault
 *
-* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
-* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
-* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
+* ③ 的设计动机：用户的 vault 就是他在 DSH 里选定的那个目录——Router 会话创建时
+* 插件自动把该会话 cwd 登记为 vault 根（registerVaultRootFromSession），无需任何
+* 手工配置。①② 供自定义/覆盖；⑤ 仅在全新裸环境兜底。
 *
-* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
-* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+* 解析结果写回 state.json，作为浏览器端（孙学空间）的发现通道——浏览器经
+* workspaceFiles/read 以绝对路径读取该文件（工作区外绝对路径读取被宿主允许）。
+*
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①②③（均不入库）。
 */
 const DEFAULT_VAULT_DIRNAME = "sun-vault";
 /** 插件自有状态目录（<DSH_HOME 或 ~/>/.dsh/state/sun-space/），沿用官方 state/<插件名> 约定。
 *  跟随 DSH_HOME：多实例（隔离 HOME 的测试环境）之间状态互不串扰。 */
 const stateDir = () => join(process.env.DSH_HOME ?? homedir(), ".dsh", "state", "sun-space");
-/** 纯函数：给定 env 与 config 内容时的解析结果（测试与 vaultPath 共用）。 */
-function computeVaultPath(envValue, configJson, home = homedir()) {
+/** 纯函数：五级优先解析（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, stateJson, sessionCwd, home = homedir()) {
 	if (envValue && envValue.trim() !== "") return envValue;
-	try {
-		const cfg = JSON.parse(configJson ?? "");
-		if (typeof cfg?.vault === "string" && cfg.vault.startsWith("/")) return cfg.vault;
+	for (const raw of [configJson, stateJson]) try {
+		const parsed = JSON.parse(raw ?? "");
+		if (typeof parsed?.vault === "string" && parsed.vault.startsWith("/")) return parsed.vault;
 	} catch {}
+	if (sessionCwd && sessionCwd.startsWith("/")) return sessionCwd;
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
 let cached = {
@@ -48,32 +54,68 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
-function vaultPath(now = Date.now()) {
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。
+*  sessionCwd：调用方从 exec 提取的会话工作目录（可选）——用户在哪个工作区开会话，vault 就解析到哪。 */
+function vaultPath(sessionCwd, now = Date.now()) {
 	const dir = stateDir();
 	let configJson;
+	let stateJson;
 	try {
 		configJson = readFileSync(join(dir, "config.json"), "utf8");
 	} catch {}
-	if (now - cached.at < 6e4 && cached.key === (configJson ?? "")) return cached.value;
-	const value = computeVaultPath(process.env.SUN_VAULT, configJson);
+	try {
+		stateJson = readFileSync(join(dir, "state.json"), "utf8");
+	} catch {}
+	const key = `${sessionCwd ?? ""}|${configJson ?? ""}|${stateJson ?? ""}`;
+	if (now - cached.at < 6e4 && cached.key === key) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson, sessionCwd);
 	cached = {
 		at: now,
-		key: configJson ?? "",
+		key,
 		value
 	};
 	return value;
 }
 vaultPath();
+/**
+* Router 会话创建时登记 vault 根（"当前目录作为 vault"语义的落点）。
+* 仅在更高优先级来源（env/config/state）均未设置时才登记首个值——
+* 多 Router 并存或重复创建时第一个登记者生效。
+* 尽力而为：任何失败静默退场（最坏是回退到约定路径）。
+*/
+function registerVaultRootFromSession(cwd, now = /* @__PURE__ */ new Date()) {
+	if (!cwd || !cwd.startsWith("/")) return false;
+	if (process.env.SUN_VAULT?.trim()) return false;
+	try {
+		const dir = stateDir();
+		mkdirSync(dir, { recursive: true });
+		const p = join(dir, "state.json");
+		let state = {};
+		try {
+			state = JSON.parse(readFileSync(p, "utf8"));
+		} catch {}
+		if (state.vault && state.vault.startsWith("/")) return false;
+		state.vault = cwd;
+		state.updatedAt = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}T${String(now.getHours()).padStart(2, "0")}:${String(now.getMinutes()).padStart(2, "0")}`;
+		writeFileSync(p, JSON.stringify(state, null, 2), "utf8");
+		return true;
+	} catch {
+		return false;
+	}
+}
 /** 把解析结果写回状态目录的 state.json（apply 时调用，尽力而为），供客户端发现。 */
 function publishVaultState(now = /* @__PURE__ */ new Date()) {
 	try {
 		const dir = stateDir();
 		mkdirSync(dir, { recursive: true });
-		writeFileSync(join(dir, "state.json"), JSON.stringify({
-			vault: vaultPath(now.getTime()),
-			updatedAt: `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}T${String(now.getHours()).padStart(2, "0")}:${String(now.getMinutes()).padStart(2, "0")}`
-		}, null, 2), "utf8");
+		const p = join(dir, "state.json");
+		let state = {};
+		try {
+			state = JSON.parse(readFileSync(p, "utf8"));
+		} catch {}
+		state.vault = vaultPath(void 0, now.getTime());
+		state.updatedAt = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}T${String(now.getHours()).padStart(2, "0")}:${String(now.getMinutes()).padStart(2, "0")}`;
+		writeFileSync(p, JSON.stringify(state, null, 2), "utf8");
 	} catch {}
 }
 // src/dws.ts
@@ -493,5 +535,14 @@ function apply(ctx) {
 	publishVaultState();
 	ctx.plugin(source_exports);
 	ctx.plugin(worker_watchdog_exports);
+	try {
+		ctx.on("agent/created", (...args) => {
+			const agent = args[0]?.agent;
+			const header = agent?.session?.header;
+			if (header?.agentPreset !== "sun-router") return;
+			const cwd = header.cwd ?? agent?.cwd;
+			registerVaultRootFromSession(typeof cwd === "string" ? cwd : void 0);
+		});
+	} catch {}
 }
 export { apply, inject, name };

package/lib/router-tools.mjs

@@ -189,29 +189,35 @@ async function dingSelf(userId, content, type = "app") {
 /**
 * vault 路径解析——唯一事实源，全插件共享（source/router-tools/worker-vault/worker-watchdog）。
 *
-* 解析优先级：
+* 解析优先级（vaultPath() 每次调用重读，运行期变更即时生效）：
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
 *   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
-*   ③ 默认约定 ~/Workspace/sun-vault
+*   ③ ~/.dsh/state/sun-space/state.json 的 vault 字段（Router 会话创建时插件自动登记 = 用户选定的工作区目录）
+*   ④ 会话工作目录（调用方从 exec 提取传入——用户在哪个工作区开会话，vault 就解析到哪）
+*   ⑤ 默认约定 ~/Workspace/sun-vault
 *
-* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
-* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
-* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
+* ③ 的设计动机：用户的 vault 就是他在 DSH 里选定的那个目录——Router 会话创建时
+* 插件自动把该会话 cwd 登记为 vault 根（registerVaultRootFromSession），无需任何
+* 手工配置。①② 供自定义/覆盖；⑤ 仅在全新裸环境兜底。
 *
-* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
-* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+* 解析结果写回 state.json，作为浏览器端（孙学空间）的发现通道——浏览器经
+* workspaceFiles/read 以绝对路径读取该文件（工作区外绝对路径读取被宿主允许）。
+*
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①②③（均不入库）。
 */
 const DEFAULT_VAULT_DIRNAME = "sun-vault";
 /** 插件自有状态目录（<DSH_HOME 或 ~/>/.dsh/state/sun-space/），沿用官方 state/<插件名> 约定。
 *  跟随 DSH_HOME：多实例（隔离 HOME 的测试环境）之间状态互不串扰。 */
 const stateDir = () => join(process.env.DSH_HOME ?? homedir(), ".dsh", "state", "sun-space");
-/** 纯函数：给定 env 与 config 内容时的解析结果（测试与 vaultPath 共用）。 */
-function computeVaultPath(envValue, configJson, home = homedir()) {
+/** 纯函数：五级优先解析（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, stateJson, sessionCwd, home = homedir()) {
 	if (envValue && envValue.trim() !== "") return envValue;
-	try {
-		const cfg = JSON.parse(configJson ?? "");
-		if (typeof cfg?.vault === "string" && cfg.vault.startsWith("/")) return cfg.vault;
+	for (const raw of [configJson, stateJson]) try {
+		const parsed = JSON.parse(raw ?? "");
+		if (typeof parsed?.vault === "string" && parsed.vault.startsWith("/")) return parsed.vault;
 	} catch {}
+	if (sessionCwd && sessionCwd.startsWith("/")) return sessionCwd;
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
 let cached = {
@@ -219,18 +225,24 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
-function vaultPath(now = Date.now()) {
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。
+*  sessionCwd：调用方从 exec 提取的会话工作目录（可选）——用户在哪个工作区开会话，vault 就解析到哪。 */
+function vaultPath(sessionCwd, now = Date.now()) {
 	const dir = stateDir();
 	let configJson;
+	let stateJson;
 	try {
 		configJson = readFileSync(join(dir, "config.json"), "utf8");
 	} catch {}
-	if (now - cached.at < 6e4 && cached.key === (configJson ?? "")) return cached.value;
-	const value = computeVaultPath(process.env.SUN_VAULT, configJson);
+	try {
+		stateJson = readFileSync(join(dir, "state.json"), "utf8");
+	} catch {}
+	const key = `${sessionCwd ?? ""}|${configJson ?? ""}|${stateJson ?? ""}`;
+	if (now - cached.at < 6e4 && cached.key === key) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson, sessionCwd);
 	cached = {
 		at: now,
-		key: configJson ?? "",
+		key,
 		value
 	};
 	return value;
@@ -238,6 +250,12 @@ function vaultPath(now = Date.now()) {
 vaultPath();
 // src/router-tools.ts
 const inject = ["tools", "subagents"];
+/** 从工具执行上下文提取会话工作目录（用户在哪个工作区开会话，vault 就解析到哪）。防御式：形状未知时返回 undefined。 */
+function sessionCwdOf(exec) {
+	const e = exec;
+	const c = e?.agent?.session?.cwd ?? e?.agent?.session?.header?.cwd ?? e?.session?.cwd;
+	return typeof c === "string" && c.startsWith("/") ? c : void 0;
+}
 const text = (s) => [{
 	type: "text",
 	text: s
@@ -313,10 +331,10 @@ function apply(ctx) {
 			}
 		},
 		required: ["what"]
-	}, async (args) => {
+	}, async (args, exec) => {
 		try {
 			if (args.what === "triggers") {
-				const dir = resolveSafe(vaultPath(), "90-Meta/triggers");
+				const dir = resolveSafe(vaultPath(sessionCwdOf(exec)), "90-Meta/triggers");
 				try {
 					const files = (await readdir(dir)).filter((f) => f.endsWith(".json")).sort().reverse().slice(0, 10);
 					const triggers = [];
@@ -348,7 +366,7 @@ function apply(ctx) {
 			}
 			if (args.what === "journal") {
 				const d = args.date ?? localDate();
-				const p = resolveRead(vaultPath(), `40-Journal/${d}.md`);
+				const p = resolveRead(vaultPath(sessionCwdOf(exec)), `40-Journal/${d}.md`);
 				const raw = await readFile(p, "utf8");
 				if (args.full) return {
 					ok: true,
@@ -363,7 +381,7 @@ function apply(ctx) {
 				};
 			}
 			if (args.what === "tasks") {
-				const dir = resolveSafe(vaultPath(), "50-Tasks");
+				const dir = resolveSafe(vaultPath(sessionCwdOf(exec)), "50-Tasks");
 				const files = (await readdir(dir)).filter((f) => f.endsWith(".md"));
 				const tasks = [];
 				for (const f of files) {
@@ -386,7 +404,7 @@ function apply(ctx) {
 				};
 			}
 			if (args.what === "runbook" || args.what === "memory") {
-				const p = resolveSafe(vaultPath(), `90-Meta/${args.what}.md`);
+				const p = resolveSafe(vaultPath(sessionCwdOf(exec)), `90-Meta/${args.what}.md`);
 				return {
 					ok: true,
 					data: { text: (await readFile(p, "utf8")).slice(0, 8e3) }
@@ -397,7 +415,7 @@ function apply(ctx) {
 					ok: false,
 					note: "note 需要 path"
 				};
-				const raw = await readFile(resolveRead(vaultPath(), args.path), "utf8");
+				const raw = await readFile(resolveRead(vaultPath(sessionCwdOf(exec)), args.path), "utf8");
 				if (args.full) return {
 					ok: true,
 					data: { text: raw.slice(0, 8e3) }
@@ -439,9 +457,9 @@ function apply(ctx) {
 			}
 		},
 		required: ["path", "content"]
-	}, async (args) => {
+	}, async (args, exec) => {
 		try {
-			const p = resolveSafe(vaultPath(), args.path);
+			const p = resolveSafe(vaultPath(sessionCwdOf(exec)), args.path);
 			await mkdir(join(p, ".."), { recursive: true });
 			if (args.mode === "append") await appendFile(p, args.content, "utf8");
 			else await writeFile(p, args.content, "utf8");
@@ -535,9 +553,9 @@ function apply(ctx) {
 			}
 		},
 		required: ["path", "fields"]
-	}, async (args) => {
+	}, async (args, exec) => {
 		try {
-			const p = resolveSafe(vaultPath(), args.path);
+			const p = resolveSafe(vaultPath(sessionCwdOf(exec)), args.path);
 			const updated = updateFrontmatter(await readFile(p, "utf8"), args.fields);
 			await writeFile(p, updated, "utf8");
 			return {
@@ -611,7 +629,7 @@ function apply(ctx) {
 			};
 		}
 		try {
-			const p = resolveSafe(vaultPath(), `50-Tasks/${args.task_id}.md`);
+			const p = resolveSafe(vaultPath(sessionCwdOf(exec)), `50-Tasks/${args.task_id}.md`);
 			const raw = await readFile(p, "utf8");
 			await writeFile(p, updateFrontmatter(raw, { session: String(activation.childId ?? "") }), "utf8");
 		} catch {}

package/lib/worker-vault.mjs

@@ -32,29 +32,35 @@ function resolveSafe(vaultRoot, rel) {
 /**
 * vault 路径解析——唯一事实源，全插件共享（source/router-tools/worker-vault/worker-watchdog）。
 *
-* 解析优先级：
+* 解析优先级（vaultPath() 每次调用重读，运行期变更即时生效）：
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
 *   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
-*   ③ 默认约定 ~/Workspace/sun-vault
+*   ③ ~/.dsh/state/sun-space/state.json 的 vault 字段（Router 会话创建时插件自动登记 = 用户选定的工作区目录）
+*   ④ 会话工作目录（调用方从 exec 提取传入——用户在哪个工作区开会话，vault 就解析到哪）
+*   ⑤ 默认约定 ~/Workspace/sun-vault
 *
-* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
-* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
-* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
+* ③ 的设计动机：用户的 vault 就是他在 DSH 里选定的那个目录——Router 会话创建时
+* 插件自动把该会话 cwd 登记为 vault 根（registerVaultRootFromSession），无需任何
+* 手工配置。①② 供自定义/覆盖；⑤ 仅在全新裸环境兜底。
 *
-* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
-* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+* 解析结果写回 state.json，作为浏览器端（孙学空间）的发现通道——浏览器经
+* workspaceFiles/read 以绝对路径读取该文件（工作区外绝对路径读取被宿主允许）。
+*
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①②③（均不入库）。
 */
 const DEFAULT_VAULT_DIRNAME = "sun-vault";
 /** 插件自有状态目录（<DSH_HOME 或 ~/>/.dsh/state/sun-space/），沿用官方 state/<插件名> 约定。
 *  跟随 DSH_HOME：多实例（隔离 HOME 的测试环境）之间状态互不串扰。 */
 const stateDir = () => join(process.env.DSH_HOME ?? homedir(), ".dsh", "state", "sun-space");
-/** 纯函数：给定 env 与 config 内容时的解析结果（测试与 vaultPath 共用）。 */
-function computeVaultPath(envValue, configJson, home = homedir()) {
+/** 纯函数：五级优先解析（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, stateJson, sessionCwd, home = homedir()) {
 	if (envValue && envValue.trim() !== "") return envValue;
-	try {
-		const cfg = JSON.parse(configJson ?? "");
-		if (typeof cfg?.vault === "string" && cfg.vault.startsWith("/")) return cfg.vault;
+	for (const raw of [configJson, stateJson]) try {
+		const parsed = JSON.parse(raw ?? "");
+		if (typeof parsed?.vault === "string" && parsed.vault.startsWith("/")) return parsed.vault;
 	} catch {}
+	if (sessionCwd && sessionCwd.startsWith("/")) return sessionCwd;
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
 let cached = {
@@ -62,18 +68,24 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
-function vaultPath(now = Date.now()) {
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。
+*  sessionCwd：调用方从 exec 提取的会话工作目录（可选）——用户在哪个工作区开会话，vault 就解析到哪。 */
+function vaultPath(sessionCwd, now = Date.now()) {
 	const dir = stateDir();
 	let configJson;
+	let stateJson;
 	try {
 		configJson = readFileSync(join(dir, "config.json"), "utf8");
 	} catch {}
-	if (now - cached.at < 6e4 && cached.key === (configJson ?? "")) return cached.value;
-	const value = computeVaultPath(process.env.SUN_VAULT, configJson);
+	try {
+		stateJson = readFileSync(join(dir, "state.json"), "utf8");
+	} catch {}
+	const key = `${sessionCwd ?? ""}|${configJson ?? ""}|${stateJson ?? ""}`;
+	if (now - cached.at < 6e4 && cached.key === key) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson, sessionCwd);
 	cached = {
 		at: now,
-		key: configJson ?? "",
+		key,
 		value
 	};
 	return value;
@@ -81,6 +93,12 @@ function vaultPath(now = Date.now()) {
 vaultPath();
 // src/worker-vault.ts
 const inject = ["tools"];
+/** 从工具执行上下文提取会话工作目录（同 router-tools）。 */
+function sessionCwdOf(exec) {
+	const e = exec;
+	const c = e?.agent?.session?.cwd ?? e?.agent?.session?.header?.cwd ?? e?.session?.cwd;
+	return typeof c === "string" && c.startsWith("/") ? c : void 0;
+}
 const TASK_ID = /^T-\d{8}-\d{2}$/;
 /** 纯函数：拼装受控产物路径；非法输入抛 VaultPathError。可单测。 */
 function artifactPath(taskId, filename) {
@@ -126,11 +144,11 @@ function apply(ctx) {
 				text: JSON.stringify(value)
 			}]
 		},
-		execute: async (args) => {
+		execute: async (args, exec) => {
 			const { task_id: taskId, filename, content } = args ?? {};
 			try {
 				const rel = artifactPath(String(taskId), String(filename));
-				const abs = resolveSafe(vaultPath(), rel);
+				const abs = resolveSafe(vaultPath(sessionCwdOf(exec)), rel);
 				await mkdir(join(abs, ".."), { recursive: true });
 				await writeFile(abs, String(content ?? ""), "utf8");
 				return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sun-space",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "type": "module",
   "description": "Sun Space：DeepSeek Harness 个人超智能体插件——Router/Worker 双预设工具白名单、钉钉待办轮询、Obsidian 知识库落库、会话工作台与定时任务管理。",
   "exports": {
@@ -54,4 +54,4 @@
       "esbuild"
     ]
   }
-}
+}

package/src/client.js

@@ -22,7 +22,7 @@ window.__ModuleLoader__.load({
       // 会话解析链：session/list（sun-router 会话）→ 90-Meta/system/state.json 裁决 → updatedAt 最新兜底。
       // vault 解析链：会话 cwd 推 HOME → 约定布局探测 state.json → state.json 的 vault 字段裁决（跨机自愈）。
       // 写回：① 创建会话后经 session/prompt 引导自登记（含 vault 字段）；② 晨报自检发现缺失/不一致自动修正。
-      const WB_REV = 'v17' // 根节点 data-wb-rev 版本标记：判别浏览器是否吃到旧 client.js（immutable 缓存坑，HANDOFF 踩坑 1）
+      const WB_REV = 'v18' // 根节点 data-wb-rev 版本标记：判别浏览器是否吃到旧 client.js（immutable 缓存坑，HANDOFF 踩坑 1）
 
       const STATUS_META = {
         proposed: { label: '待确认派发', color: '#9e9e9e' },
@@ -115,7 +115,16 @@ window.__ModuleLoader__.load({
             } catch { /* 该文件不存在 → 下一个 */ }
           }
         }
-        // ② 约定布局探测（默认 ~/Workspace/sun-vault；自定义 vault 路径由①覆盖）
+        // ② 会话 cwd 即 vault（用户"新建目录作为工作区并开会话"流：cwd 下有 90-Meta 即认定）
+        try {
+          const cwd = String((items.find(s => s.sessionId === scope) ?? {}).cwd ?? '')
+          if (cwd && cwd.startsWith('/')) {
+            await readVaultFile(scope, `${cwd}/90-Meta/runbook.md`, 2)
+            D.vaultFoundNoField = cwd
+            return cwd
+          }
+        } catch { /* 该 cwd 无 90-Meta → 约定兜底 */ }
+        // ③ 约定布局探测（默认 ~/Workspace/sun-vault；自定义 vault 路径由①覆盖）
         const candidates = [...new Set(homes.map(h => `${h}/Workspace/${VAULT_DIRNAME}`))]
         for (const cand of candidates) {
           try {
@@ -130,9 +139,11 @@ window.__ModuleLoader__.load({
       }
 
       // ===== Router 会话解析（架构 §4.1 不变量：会话会轮换，呈现层只认 vault state.json + 动态发现）=====
-      async function resolveRouterSession(vault) {
-        const v = await gw('session/list', {})
-        const items = Array.isArray(v?.items) ? v.items : Object.values(v?.items ?? v ?? {})
+      async function resolveRouterSession(vault, items) {
+        if (!items) {
+          const v = await gw('session/list', {})
+          items = Array.isArray(v?.items) ? v.items : Object.values(v?.items ?? v ?? {})
+        }
         // 注意：cwd 是"工作区分桶路径"（实例 boot cwd），不是 vault——过滤只看预设（踩坑 5 延伸）
         const candidates = items.filter(s => s?.projections?.values?.agentPreset === 'sun-router')
         if (!candidates.length) return null
@@ -176,12 +187,14 @@ window.__ModuleLoader__.load({
           c.presets = false
           c.notes.push('预设服务不可达 → 确认 Harness 实例在线、插件已启用')
         }
-        // ③ Router 会话：动态解析（state.json → 最近活跃）；顺带记录当前会话 cwd（一键初始化用它作 vault 根/工作区）
+        // ③ Router 会话：动态解析 + 首个 sun-router 会话创建时自动登记其 cwd 为 vault 根
+        //   （"当前目录作为 vault"语义的插件层落点；env/config 更高优先级不受影响）
         try {
           const sl = await gw('session/list', {})
           const items = Array.isArray(sl?.items) ? sl.items : Object.values(sl?.items ?? {})
           c.currentCwd = (items.find(s => s.sessionId === currentSessionId) ?? {}).cwd ?? null
-          c.routerSession = vault ? await resolveRouterSession(vault) : null
+          // vault 根登记由宿主插件在 sun-router 会话创建时自动完成（index.ts agent/created 钩子）
+          c.routerSession = vault ? await resolveRouterSession(vault, items) : null
           if (!c.routerSession) c.notes.push('Router 会话不存在 → 点下方「创建 Router 会话」（sun-router 预设，随当前工作区），创建后自动登记 state.json')
         } catch {
           c.notes.push('会话列表不可达 → 重试或检查实例')
@@ -265,13 +278,12 @@ window.__ModuleLoader__.load({
             sessionId: sid,
             mode: 'queue',
             content: [{ type: 'text', text: `【孙学空间初始化】你是新环境的 Sun Router（你的会话 id：${sid}）。你的工作目录即知识库根（vault）。按顺序完成：
-1) 把知识库根登记到状态目录 config.json（执行：mkdir -p "\${DSH_HOME:-\$HOME}/.dsh/state/sun-space" && printf '{"vault": "%s"}' "\$(pwd)" > "\${DSH_HOME:-\$HOME}/.dsh/state/sun-space/config.json"——此写在工作区之外，会弹一次审批，等待用户批准后再继续第 2 步）
-2) 用 sun_vault_write 创建知识库骨架（此时插件已从 config.json 动态解析 vault = 你的工作目录）：
+1) 用 sun_vault_write 创建知识库骨架（vault 即你的工作目录，已在会话创建时自动登记）：
    - 90-Meta/schemas.md：frontmatter 契约最小集（通用字段 type/id/status/created/updated；task 的 status 枚举 proposed|running|need-confirm|done|blocked|dropped；写入纪律：Journal 由 Router 独占、日期一律本地时间 YYYY-MM-DDTHH:mm 不带时区后缀、结论必注出处）
    - 90-Meta/runbook.md：初始版（# Sun 行为手册 + v0.1 版本行 + §1 角色：Router 只分派不执行 + §2 沟通规范：IM ≤100 字结论先行 + §3 打扰分级：info 攒批/ask 立即/urgent 加 DING）
    - 90-Meta/memory.md：初始版（# 关于用户，待填充）
-3) 用 sun_vault_write 写 90-Meta/system/state.json：{"routerSession": "${sid}", "vault": "<你的工作目录绝对路径>", "updatedAt": "<本地时间 YYYY-MM-DDTHH:mm>"}（自登记，供孙学空间发现与轮换机制使用）
-4) 完成后列出生成的文件清单与知识库路径。` }],
+2) 用 sun_vault_write 写 90-Meta/system/state.json：{"routerSession": "${sid}", "vault": "<你的工作目录绝对路径>", "updatedAt": "<本地时间 YYYY-MM-DDTHH:mm>"}（自登记，供孙学空间发现与轮换机制使用）
+3) 完成后列出生成的文件清单与知识库路径。` }],
             clientTimeZone: 'Asia/Shanghai',
           })
           try { hostCtx.uiWorkspace.openSession(sid) } catch (e) { D.errors.push('openSession: ' + String(e)) }
@@ -523,6 +535,7 @@ window.__ModuleLoader__.load({
           h('div', { key: 'tabs', style: { display: 'flex', gap: 3, marginBottom: 16, background: 'rgba(128,128,128,0.12)', borderRadius: 8, padding: 3 } }, [
             ['overview', '总览'], ['schedules', '定时任务'], ['setup', '设置'],
           ].map(([id, label]) => h('button', { key: id, onClick: () => setTab(id), style: { flex: 1, border: 'none', cursor: 'pointer', fontSize: 13, padding: '6px 0', borderRadius: 6, color: 'inherit', background: tab === id ? 'rgba(128,128,128,0.28)' : 'transparent', opacity: tab === id ? 1 : 0.6, transition: 'background 0.15s' } }, label))),
+          h('div', { key: 'vp', style: { fontSize: 12, opacity: 0.65, marginBottom: 12 } }, `📚 识别到的知识库：${vault ?? '（未定位——完成下方引导后自动登记）'}`),
           h('div', { key: 'cnt', style: { display: 'flex', gap: 18, marginBottom: 16 } },
             counters.map(([label, n, color]) => h('div', { key: label, style: { display: 'flex', alignItems: 'center', gap: 6 } }, [
               h('span', { key: 'd', style: { width: 8, height: 8, borderRadius: 4, background: color, display: 'inline-block' } }),