dsh-sun-space 0.2.4 → 0.2.6

package/lib/index.mjs

@@ -1,5 +1,7 @@
-import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { join } from "node:path";
+import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { execFile } from "node:child_process";
 // \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
@@ -12,6 +14,65 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
+// src/vault-path.ts
+/**
+* vault 路径解析——唯一事实源，全插件共享（source/router-tools/worker-vault/worker-watchdog）。
+*
+* 解析优先级：
+*   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
+*   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
+*   ③ 默认约定 ~/Workspace/sun-vault
+*
+* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
+* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
+* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
+*
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+*/
+const DEFAULT_VAULT_DIRNAME = "sun-vault";
+/** 插件自有状态目录（~/.dsh/state/sun-space/），沿用官方 state/<插件名> 约定。 */
+const STATE_DIR = join(homedir(), ".dsh", "state", "sun-space");
+/** 纯函数：给定 env 与 config 内容时的解析结果（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, 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;
+	} catch {}
+	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
+}
+let cached = {
+	at: 0,
+	key: "",
+	value: ""
+};
+/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+function vaultPath(now = Date.now()) {
+	let configJson;
+	try {
+		configJson = readFileSync(join(STATE_DIR, "config.json"), "utf8");
+	} catch {}
+	if (now - cached.at < 6e4 && cached.key === (configJson ?? "")) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson);
+	cached = {
+		at: now,
+		key: configJson ?? "",
+		value
+	};
+	return value;
+}
+vaultPath();
+/** 把解析结果写回状态目录的 state.json（apply 时调用，尽力而为），供客户端发现。 */
+function publishVaultState(now = /* @__PURE__ */ new Date()) {
+	try {
+		mkdirSync(STATE_DIR, { recursive: true });
+		writeFileSync(join(STATE_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");
+	} catch {}
+}
 // src/dws.ts
 /**
 * dws 执行器：单次命令调用（无长连接）。供 sun_notify / Source 轮询使用。
@@ -121,7 +182,6 @@ var source_exports = /* @__PURE__ */ __exportAll({
 	CREDENTIAL_ALERT_COOLDOWN_MS: () => CREDENTIAL_ALERT_COOLDOWN_MS,
 	CREDENTIAL_ALERT_STREAK: () => 2,
 	TRIGGER_TTL_MS: () => TRIGGER_TTL_MS,
-	VAULT: () => VAULT$1,
 	apply: () => apply$2,
 	inject: () => inject$2,
 	parseTriggerTs: () => parseTriggerTs,
@@ -129,11 +189,10 @@ var source_exports = /* @__PURE__ */ __exportAll({
 	shouldAlertCredential: () => shouldAlertCredential
 });
 const inject$2 = ["timer"];
-const VAULT$1 = process.env.SUN_VAULT ?? `${process.env.HOME}/Workspace/云顶天宫`;
 /** 轮询周期（毫秒）：纯程序层，可调密。 */
 const POLL_MS = 18e5;
-const TRIGGER_DIR$1 = `${VAULT$1}/90-Meta/triggers`;
-const SNAPSHOT_FILE = `${VAULT$1}/90-Meta/mock-data/last-snapshot.json`;
+const triggerDir$1 = () => `${vaultPath()}/90-Meta/triggers`;
+const snapshotFile = () => `${vaultPath()}/90-Meta/mock-data/last-snapshot.json`;
 /** trigger 文件 TTL：超过即视为已消费/过期，轮询成功路径顺带清理。 */
 const TRIGGER_TTL_MS = 6048e5;
 const CREDENTIAL_ALERT_COOLDOWN_MS = 36e5;
@@ -179,7 +238,7 @@ function schedulePolling(ctx) {
 			const snap = await snapshot();
 			const prev = await readPrev();
 			if (!prev) {
-				await writeFile(SNAPSHOT_FILE, JSON.stringify(snap), "utf8");
+				await writeFile(snapshotFile(), JSON.stringify(snap), "utf8");
 				return;
 			}
 			const fresh = diff(prev, snap);
@@ -191,9 +250,9 @@ function schedulePolling(ctx) {
 				if (fresh.newApprovals.length) parts.push(`新审批 ${fresh.newApprovals.length} 件`);
 				await notifySelf(uid, `[Sun·info] ${parts.join("、")}，已入触发队列（${(/* @__PURE__ */ new Date()).toLocaleTimeString("zh-CN")}）`);
 			}
-			await writeFile(SNAPSHOT_FILE, JSON.stringify(snap), "utf8");
+			await writeFile(snapshotFile(), JSON.stringify(snap), "utf8");
 			health.fails = 0;
-			await pruneTriggers(TRIGGER_DIR$1).catch(() => {});
+			await pruneTriggers(triggerDir$1()).catch(() => {});
 		} catch (e) {
 			ctx.logger?.warn?.(`[sun-space] poll failed: ${String(e.message).slice(0, 150)}`);
 			health.fails++;
@@ -224,15 +283,15 @@ function schedulePolling(ctx) {
 }
 async function readPrev() {
 	try {
-		return JSON.parse(await readFile(SNAPSHOT_FILE, "utf8"));
+		return JSON.parse(await readFile(snapshotFile(), "utf8"));
 	} catch {
 		return null;
 	}
 }
 async function writeTrigger(label, payload) {
-	await mkdir(TRIGGER_DIR$1, { recursive: true });
+	await mkdir(triggerDir$1(), { recursive: true });
 	const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-	await writeFile(join(TRIGGER_DIR$1, `${ts}-${label}.json`), JSON.stringify({
+	await writeFile(join(triggerDir$1(), `${ts}-${label}.json`), JSON.stringify({
 		label,
 		payload
 	}, null, 2), "utf8");
@@ -275,7 +334,6 @@ async function writeTrigger(label, payload) {
 var worker_watchdog_exports = /* @__PURE__ */ __exportAll({
 	DEFAULT_STALL_MS: () => DEFAULT_STALL_MS,
 	DEFAULT_TICK_MS: () => DEFAULT_TICK_MS,
-	VAULT: () => VAULT,
 	apply: () => apply$1,
 	inject: () => inject$1,
 	isDelegatedChildHeader: () => isDelegatedChildHeader,
@@ -286,8 +344,7 @@ var worker_watchdog_exports = /* @__PURE__ */ __exportAll({
 });
 const name$1 = "worker-watchdog";
 const inject$1 = ["timer"];
-const VAULT = process.env.SUN_VAULT ?? `${process.env.HOME}/Workspace/云顶天宫`;
-const TRIGGER_DIR = `${VAULT}/90-Meta/triggers`;
+const triggerDir = () => `${vaultPath()}/90-Meta/triggers`;
 /** 默认停滞阈值 15 分钟：长思考/长命令完成后即重置计时，真卡死撑不到这么久。 */
 const DEFAULT_STALL_MS = 9e5;
 /** 巡检间隔 30 秒。 */
@@ -344,9 +401,9 @@ function apply$1(ctx) {
 		const idleMin = Math.round((Date.now() - entry.at) / 6e4);
 		log("warn", `stalled: child=${entry.id} idle=${idleMin}min — interrupting & notifying`);
 		try {
-			await mkdir(TRIGGER_DIR, { recursive: true });
+			await mkdir(triggerDir(), { recursive: true });
 			const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-			await writeFile(join(TRIGGER_DIR, `${ts}-watchdog-stall.json`), JSON.stringify({
+			await writeFile(join(triggerDir(), `${ts}-watchdog-stall.json`), JSON.stringify({
 				label: "watchdog-stall",
 				payload: {
 					childId: entry.id,
@@ -430,6 +487,7 @@ function apply$1(ctx) {
 const name = "sun-space";
 const inject = ["timer", "tools"];
 function apply(ctx) {
+	publishVaultState();
 	ctx.plugin(source_exports);
 	ctx.plugin(worker_watchdog_exports);
 }

package/lib/router-tools.mjs

@@ -1,6 +1,8 @@
 import { appendFile, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 import { join, resolve, sep } from "node:path";
 import { execFile } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
 // src/vault.ts
 /**
 * vault 访问：路径守卫 + frontmatter 解析/序列化。纯函数为主，可单测。
@@ -183,9 +185,57 @@ async function dingSelf(userId, content, type = "app") {
 	]);
 	return { ok: data?.ok === true || data?.success === true || data?.data?.success === true };
 }
+// src/vault-path.ts
+/**
+* vault 路径解析——唯一事实源，全插件共享（source/router-tools/worker-vault/worker-watchdog）。
+*
+* 解析优先级：
+*   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
+*   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
+*   ③ 默认约定 ~/Workspace/sun-vault
+*
+* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
+* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
+* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
+*
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+*/
+const DEFAULT_VAULT_DIRNAME = "sun-vault";
+/** 插件自有状态目录（~/.dsh/state/sun-space/），沿用官方 state/<插件名> 约定。 */
+const STATE_DIR = join(homedir(), ".dsh", "state", "sun-space");
+/** 纯函数：给定 env 与 config 内容时的解析结果（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, 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;
+	} catch {}
+	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
+}
+let cached = {
+	at: 0,
+	key: "",
+	value: ""
+};
+/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+function vaultPath(now = Date.now()) {
+	let configJson;
+	try {
+		configJson = readFileSync(join(STATE_DIR, "config.json"), "utf8");
+	} catch {}
+	if (now - cached.at < 6e4 && cached.key === (configJson ?? "")) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson);
+	cached = {
+		at: now,
+		key: configJson ?? "",
+		value
+	};
+	return value;
+}
+vaultPath();
 // src/router-tools.ts
 const inject = ["tools", "subagents"];
-const VAULT = process.env.SUN_VAULT ?? `${process.env.HOME}/Workspace/云顶天宫`;
 const text = (s) => [{
 	type: "text",
 	text: s
@@ -264,7 +314,7 @@ function apply(ctx) {
 	}, async (args) => {
 		try {
 			if (args.what === "triggers") {
-				const dir = resolveSafe(VAULT, "90-Meta/triggers");
+				const dir = resolveSafe(vaultPath(), "90-Meta/triggers");
 				try {
 					const files = (await readdir(dir)).filter((f) => f.endsWith(".json")).sort().reverse().slice(0, 10);
 					const triggers = [];
@@ -296,7 +346,7 @@ function apply(ctx) {
 			}
 			if (args.what === "journal") {
 				const d = args.date ?? localDate();
-				const p = resolveRead(VAULT, `40-Journal/${d}.md`);
+				const p = resolveRead(vaultPath(), `40-Journal/${d}.md`);
 				const raw = await readFile(p, "utf8");
 				if (args.full) return {
 					ok: true,
@@ -311,7 +361,7 @@ function apply(ctx) {
 				};
 			}
 			if (args.what === "tasks") {
-				const dir = resolveSafe(VAULT, "50-Tasks");
+				const dir = resolveSafe(vaultPath(), "50-Tasks");
 				const files = (await readdir(dir)).filter((f) => f.endsWith(".md"));
 				const tasks = [];
 				for (const f of files) {
@@ -334,7 +384,7 @@ function apply(ctx) {
 				};
 			}
 			if (args.what === "runbook" || args.what === "memory") {
-				const p = resolveSafe(VAULT, `90-Meta/${args.what}.md`);
+				const p = resolveSafe(vaultPath(), `90-Meta/${args.what}.md`);
 				return {
 					ok: true,
 					data: { text: (await readFile(p, "utf8")).slice(0, 8e3) }
@@ -345,7 +395,7 @@ function apply(ctx) {
 					ok: false,
 					note: "note 需要 path"
 				};
-				const raw = await readFile(resolveRead(VAULT, args.path), "utf8");
+				const raw = await readFile(resolveRead(vaultPath(), args.path), "utf8");
 				if (args.full) return {
 					ok: true,
 					data: { text: raw.slice(0, 8e3) }
@@ -389,7 +439,7 @@ function apply(ctx) {
 		required: ["path", "content"]
 	}, async (args) => {
 		try {
-			const p = resolveSafe(VAULT, args.path);
+			const p = resolveSafe(vaultPath(), 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");
@@ -485,7 +535,7 @@ function apply(ctx) {
 		required: ["path", "fields"]
 	}, async (args) => {
 		try {
-			const p = resolveSafe(VAULT, args.path);
+			const p = resolveSafe(vaultPath(), args.path);
 			const updated = updateFrontmatter(await readFile(p, "utf8"), args.fields);
 			await writeFile(p, updated, "utf8");
 			return {
@@ -519,7 +569,7 @@ function apply(ctx) {
 			},
 			cwd: {
 				type: "string",
-				description: "可选：Worker 的工作目录（绝对路径）。不传则随当前工作区。代码开发等 vault 外任务必传（如 /Users/40huo/Workspace/<repo>）"
+				description: "可选：Worker 的工作目录（绝对路径）。不传则随当前工作区。代码开发等 vault 外任务必传（如 ~/Workspace/<repo>）"
 			}
 		},
 		required: ["task_id", "prompt"]
@@ -559,7 +609,7 @@ function apply(ctx) {
 			};
 		}
 		try {
-			const p = resolveSafe(VAULT, `50-Tasks/${args.task_id}.md`);
+			const p = resolveSafe(vaultPath(), `50-Tasks/${args.task_id}.md`);
 			const raw = await readFile(p, "utf8");
 			await writeFile(p, updateFrontmatter(raw, { session: String(activation.childId ?? "") }), "utf8");
 		} catch {}
@@ -571,4 +621,4 @@ function apply(ctx) {
 	}));
 	ctx.logger?.info?.("[sun-space] router tools registered: sun_read sun_vault_write sun_vault_meta sun_notify sun_route(subagents)");
 }
-export { VAULT, apply, inject, lossless };
+export { apply, inject, lossless };

package/lib/worker-vault.mjs

@@ -1,5 +1,7 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { join, resolve, sep } from "node:path";
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
 // src/vault.ts
 /**
 * vault 访问：路径守卫 + frontmatter 解析/序列化。纯函数为主，可单测。
@@ -26,9 +28,57 @@ function resolveWithin(vaultRoot, rel, roots, kind) {
 function resolveSafe(vaultRoot, rel) {
 	return resolveWithin(vaultRoot, rel, WRITABLE_ROOTS, "writable");
 }
+// src/vault-path.ts
+/**
+* vault 路径解析——唯一事实源，全插件共享（source/router-tools/worker-vault/worker-watchdog）。
+*
+* 解析优先级：
+*   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
+*   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
+*   ③ 默认约定 ~/Workspace/sun-vault
+*
+* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
+* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
+* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
+*
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+*/
+const DEFAULT_VAULT_DIRNAME = "sun-vault";
+/** 插件自有状态目录（~/.dsh/state/sun-space/），沿用官方 state/<插件名> 约定。 */
+const STATE_DIR = join(homedir(), ".dsh", "state", "sun-space");
+/** 纯函数：给定 env 与 config 内容时的解析结果（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, 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;
+	} catch {}
+	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
+}
+let cached = {
+	at: 0,
+	key: "",
+	value: ""
+};
+/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+function vaultPath(now = Date.now()) {
+	let configJson;
+	try {
+		configJson = readFileSync(join(STATE_DIR, "config.json"), "utf8");
+	} catch {}
+	if (now - cached.at < 6e4 && cached.key === (configJson ?? "")) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson);
+	cached = {
+		at: now,
+		key: configJson ?? "",
+		value
+	};
+	return value;
+}
+vaultPath();
 // src/worker-vault.ts
 const inject = ["tools"];
-const VAULT = process.env.SUN_VAULT ?? `${process.env.HOME}/Workspace/云顶天宫`;
 const TASK_ID = /^T-\d{8}-\d{2}$/;
 /** 纯函数：拼装受控产物路径；非法输入抛 VaultPathError。可单测。 */
 function artifactPath(taskId, filename) {
@@ -78,7 +128,7 @@ function apply(ctx) {
 			const { task_id: taskId, filename, content } = args ?? {};
 			try {
 				const rel = artifactPath(String(taskId), String(filename));
-				const abs = resolveSafe(VAULT, rel);
+				const abs = resolveSafe(vaultPath(), rel);
 				await mkdir(join(abs, ".."), { recursive: true });
 				await writeFile(abs, String(content ?? ""), "utf8");
 				return {
@@ -99,4 +149,4 @@ function apply(ctx) {
 	});
 	ctx.logger?.info?.("[sun-space] worker artifact tool registered: sun_artifact_write");
 }
-export { VAULT, apply, artifactPath, inject };
+export { apply, artifactPath, inject };

package/package.json

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

package/src/client.js

@@ -17,12 +17,12 @@ window.__ModuleLoader__.load({
       let hostCtx = null
 
       const PANEL_ID = 'sun-space'
-      const VAULT_DIRNAME = '云顶天宫' // vault 目录名约定；绝对路径动态发现，见 resolveVault
+      const VAULT_DIRNAME = 'sun-vault' // vault 目录名约定；绝对路径动态发现，见 resolveVault
       // 架构 §4.1 不变量：呈现层不得持有会话 id / vault 绝对路径常量（Router 会话会轮换，机器会换）。
       // 会话解析链：session/list（sun-router 会话）→ 90-Meta/system/state.json 裁决 → updatedAt 最新兜底。
       // vault 解析链：会话 cwd 推 HOME → 约定布局探测 state.json → state.json 的 vault 字段裁决（跨机自愈）。
       // 写回：① 创建会话后经 session/prompt 引导自登记（含 vault 字段）；② 晨报自检发现缺失/不一致自动修正。
-      const WB_REV = 'v15' // 根节点 data-wb-rev 版本标记：判别浏览器是否吃到旧 client.js（immutable 缓存坑，HANDOFF 踩坑 1）
+      const WB_REV = 'v16' // 根节点 data-wb-rev 版本标记：判别浏览器是否吃到旧 client.js（immutable 缓存坑，HANDOFF 踩坑 1）
 
       const STATUS_META = {
         proposed: { label: '待确认派发', color: '#9e9e9e' },
@@ -96,14 +96,26 @@ window.__ModuleLoader__.load({
       }).then(v => v.text || '')
 
       // ===== vault 绝对路径发现（跨机器；呈现层不持常量，架构 §4.1 同款不变量）=====
-      // 链：会话 cwd 推 HOME → 约定布局 <HOME>/Workspace/云顶天宫 探测 state.json → state.json.vault 字段裁决。
+      // 链：会话 cwd 推 HOME → 约定布局 <HOME>/Workspace/sun-vault 探测 state.json → state.json.vault 字段裁决。
       // state.json.vault 由 Router 自登记/晨报自检维护（server 端 VAULT 是唯一事实源）。
       async function resolveVault() {
         const v = await gw('session/list', {})
         const items = Array.isArray(v?.items) ? v.items : Object.values(v?.items ?? v ?? {})
         const scope = items.find(s => s?.projections?.values?.agentPreset === 'sun-router')?.sessionId ?? items[0]?.sessionId
         if (!scope) return null
+        // ① 插件状态目录（HOME 从会话 cwd 推导，绝对路径读取）：
+        //    config.json 优先（运行期事实源——引导初始化/用户手写即时生效），state.json 兜底（启动期快照）
         const homes = [...new Set(items.map(s => String(s.cwd || '')).filter(c => c.startsWith('/')).map(c => c.split('/').slice(0, 3).join('/')))]
+        for (const home of homes) {
+          for (const file of ['config.json', 'state.json']) {
+            try {
+              const raw = await readVaultFile(scope, `${home}/.dsh/state/sun-space/${file}`, 8)
+              const st = JSON.parse(raw)
+              if (st?.vault && st.vault.startsWith('/')) return st.vault
+            } catch { /* 该文件不存在 → 下一个 */ }
+          }
+        }
+        // ② 约定布局探测（默认 ~/Workspace/sun-vault；自定义 vault 路径由①覆盖）
         const candidates = [...new Set(homes.map(h => `${h}/Workspace/${VAULT_DIRNAME}`))]
         for (const cand of candidates) {
           try {
@@ -255,6 +267,17 @@ window.__ModuleLoader__.load({
         }
       }
 
+      // 知识库初始化指令（下发到当前会话执行——标准预设有完整文件工具；
+      // 第 6 步写 ~/.dsh 超出工作区，会在对话中弹一次审批卡，由用户批准）
+      const VAULT_INIT_PROMPT = `【孙学空间知识库初始化】以当前工作目录为知识库根（vault）：
+1) 创建目录：90-Meta/system、40-Journal、50-Tasks/artifacts、00-Inbox、60-Archive
+2) 写 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 不带时区后缀；结论必注出处）
+3) 写 90-Meta/runbook.md：初始版（# Sun 行为手册 + v0.1 版本行 + §1 角色：Router 只分派不执行 + §2 沟通规范：IM ≤100 字结论先行 + §3 打扰分级：info 攒批/ask 立即/urgent 加 DING）
+4) 写 90-Meta/memory.md：初始版（# 关于用户，待填充）
+5) 创建目录 90-Meta/system
+6) 把知识库绝对路径登记到 ~/.dsh/state/sun-space/config.json：内容 {"vault": "<当前目录绝对路径>"}（目录不存在则创建）
+7) 完成后列出生成的文件清单。`
+
       // 创建 Router 会话 → 自登记 state.json → 跳转 → 重检（InitPanel 与 OnboardPanel 共用）
       async function createAndBootstrap(checks, onRetry) {
         try {
@@ -377,10 +400,11 @@ window.__ModuleLoader__.load({
 
       // 新用户三步启用引导（主理鱼同款编号步骤卡；替代旧的一锅炖检查面板）
       function OnboardPanel({ checks, currentSessionId, onRetry }) {
+        const [initBusy, setInitBusy] = React.useState(false)
         const steps = [
           { n: 1, ok: checks.presets, title: '确认依赖插件', desc: checks.presets ? '智能体协作 / 子智能体插件已启用' : '打开插件面板，启用 sun-space / 智能体协作相关插件后重启实例', action: checks.presets ? null : 'plugins' },
           { n: 2, ok: !!checks.routerSession, title: '创建 Router 会话', desc: checks.routerSession ? `已就绪：${checks.routerSession.slice(0, 28)}…` : '一键创建 sun-router 预设会话并自动登记（孙学空间与定时任务都挂在这上面）', action: checks.presets && !checks.routerSession ? 'create-router' : null },
-          { n: 3, ok: checks.vault, title: '知识库就绪', desc: checks.vault ? `已就绪：${checks.vaultPath}` : `用 Obsidian 打开（或创建）~/Workspace/云顶天宫 并放好 90-Meta 骨架；自定义位置让 Router 把绝对路径写进 state.json 的 vault 字段`, action: null },
+          { n: 3, ok: checks.vault, title: '知识库（以当前目录初始化）', desc: checks.vault ? `已就绪：${checks.vaultPath}` : (currentSessionId ? '以当前目录为 vault 根创建 90-Meta 骨架，并把路径登记到 ~/.dsh/state/sun-space/config.json——会在对话中请求一次该写入的批准' : '先打开一个会话再来执行此步'), action: checks.vault || !currentSessionId || initBusy ? null : 'init-vault' },
         ]
         const allOk = steps.every(x => x.ok)
         return h('div', null, [
@@ -394,6 +418,20 @@ window.__ModuleLoader__.load({
             ]),
             st.action === 'plugins' ? h('button', { key: 'a', onClick: () => { try { hostCtx.layout.selectPanel('plugins') } catch (e) { D.errors.push(String(e)) } }, style: btnStyle }, '打开插件面板') : null,
             st.action === 'create-router' ? h('button', { key: 'a', onClick: () => createAndBootstrap(checks, onRetry), style: btnStyle }, '创建 Router 会话') : null,
+            st.action === 'init-vault' ? h('button', { key: 'a', onClick: async () => {
+              setInitBusy(true)
+              try {
+                await gw('session/prompt', {
+                  requestId: 'sun-init-' + Date.now(),
+                  sessionId: currentSessionId,
+                  mode: 'queue',
+                  content: [{ type: 'text', text: VAULT_INIT_PROMPT }],
+                  clientTimeZone: 'Asia/Shanghai',
+                })
+                checks.notes.push('初始化任务已下发到当前会话——请在对话中批准 ~/.dsh 写入并等待完成，然后点「↻ 重新检查」')
+              } catch (e) { D.errors.push('init-vault: ' + String(e)) }
+              setInitBusy(false)
+            }, style: btnStyle }, '以当前目录初始化知识库') : null,
           ])),
           allOk ? h('p', { key: 'done', style: { color: '#57b26a', fontSize: 13 } }, '✓ 全部就绪——到「定时任务」用模板创建晨报等四条生产任务，即可开始使用。') : null,
           h('button', { key: 'retry', onClick: onRetry, style: { ...btnStyle, marginTop: 10 } }, '↻ 重新检查'),