dsh-sun-space 0.2.5 → 0.2.7

package/lib/index.mjs

@@ -1,4 +1,5 @@
-import { readFileSync, writeFileSync } from "node:fs";
+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";
@@ -19,30 +20,60 @@ var __exportAll = (all, no_symbols) => {
 *
 * 解析优先级：
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
-*   ② 实例启动目录下的 sun-space.config.json 的 vault 字段（持久化配置，重启不丢）
+*   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
 *   ③ 默认约定 ~/Workspace/sun-vault
 *
-* 解析结果同时写入 <实例cwd>/sun-space.json（仅 vault 字段），作为浏览器端（孙学空间）
-* 的发现通道——浏览器读不到进程环境，靠这个文件拿到真实 vault 路径（workspaceFiles
-* 的相对路径读取以会话工作区根为基准，即实例 cwd，两者同目录）。
+* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
+* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
+* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
 *
-* 注意：本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
 */
 const DEFAULT_VAULT_DIRNAME = "sun-vault";
-/** 解析 vault 绝对路径（① env ② 实例目录配置文件 ③ 默认约定）。 */
-function resolveVaultPath(cwd = process.cwd(), home = process.env.HOME ?? "") {
-	if (process.env.SUN_VAULT && process.env.SUN_VAULT.trim() !== "") return process.env.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()) {
+	if (envValue && envValue.trim() !== "") return envValue;
 	try {
-		const cfg = JSON.parse(readFileSync(join(cwd, "sun-space.config.json"), "utf8"));
+		const cfg = JSON.parse(configJson ?? "");
 		if (typeof cfg?.vault === "string" && cfg.vault.startsWith("/")) return cfg.vault;
 	} catch {}
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
-const VAULT = resolveVaultPath();
-/** 把解析结果落盘为客户端发现文件（apply 时调用，尽力而为）。 */
-function publishVaultForClient(cwd = process.cwd()) {
+let cached = {
+	at: 0,
+	key: "",
+	value: ""
+};
+/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+function vaultPath(now = Date.now()) {
+	const dir = stateDir();
+	let configJson;
+	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);
+	cached = {
+		at: now,
+		key: configJson ?? "",
+		value
+	};
+	return value;
+}
+vaultPath();
+/** 把解析结果写回状态目录的 state.json（apply 时调用，尽力而为），供客户端发现。 */
+function publishVaultState(now = /* @__PURE__ */ new Date()) {
 	try {
-		writeFileSync(join(cwd, "sun-space.json"), JSON.stringify({ vault: VAULT }, null, 2), "utf8");
+		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");
 	} catch {}
 }
 // src/dws.ts
@@ -154,7 +185,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,
 	apply: () => apply$2,
 	inject: () => inject$2,
 	parseTriggerTs: () => parseTriggerTs,
@@ -164,8 +194,8 @@ var source_exports = /* @__PURE__ */ __exportAll({
 const inject$2 = ["timer"];
 /** 轮询周期（毫秒）：纯程序层，可调密。 */
 const POLL_MS = 18e5;
-const TRIGGER_DIR$1 = `${VAULT}/90-Meta/triggers`;
-const SNAPSHOT_FILE = `${VAULT}/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;
@@ -211,7 +241,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);
@@ -223,9 +253,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++;
@@ -256,15 +286,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");
@@ -307,7 +337,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,
@@ -318,7 +347,7 @@ var worker_watchdog_exports = /* @__PURE__ */ __exportAll({
 });
 const name$1 = "worker-watchdog";
 const inject$1 = ["timer"];
-const TRIGGER_DIR = `${VAULT}/90-Meta/triggers`;
+const triggerDir = () => `${vaultPath()}/90-Meta/triggers`;
 /** 默认停滞阈值 15 分钟：长思考/长命令完成后即重置计时，真卡死撑不到这么久。 */
 const DEFAULT_STALL_MS = 9e5;
 /** 巡检间隔 30 秒。 */
@@ -375,9 +404,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,
@@ -461,7 +490,7 @@ function apply$1(ctx) {
 const name = "sun-space";
 const inject = ["timer", "tools"];
 function apply(ctx) {
-	publishVaultForClient();
+	publishVaultState();
 	ctx.plugin(source_exports);
 	ctx.plugin(worker_watchdog_exports);
 }

package/lib/router-tools.mjs

@@ -2,6 +2,7 @@ import { appendFile, mkdir, readFile, readdir, writeFile } from "node:fs/promise
 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 解析/序列化。纯函数为主，可单测。
@@ -190,26 +191,51 @@ async function dingSelf(userId, content, type = "app") {
 *
 * 解析优先级：
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
-*   ② 实例启动目录下的 sun-space.config.json 的 vault 字段（持久化配置，重启不丢）
+*   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
 *   ③ 默认约定 ~/Workspace/sun-vault
 *
-* 解析结果同时写入 <实例cwd>/sun-space.json（仅 vault 字段），作为浏览器端（孙学空间）
-* 的发现通道——浏览器读不到进程环境，靠这个文件拿到真实 vault 路径（workspaceFiles
-* 的相对路径读取以会话工作区根为基准，即实例 cwd，两者同目录）。
+* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
+* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
+* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
 *
-* 注意：本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
 */
 const DEFAULT_VAULT_DIRNAME = "sun-vault";
-/** 解析 vault 绝对路径（① env ② 实例目录配置文件 ③ 默认约定）。 */
-function resolveVaultPath(cwd = process.cwd(), home = process.env.HOME ?? "") {
-	if (process.env.SUN_VAULT && process.env.SUN_VAULT.trim() !== "") return process.env.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()) {
+	if (envValue && envValue.trim() !== "") return envValue;
 	try {
-		const cfg = JSON.parse(readFileSync(join(cwd, "sun-space.config.json"), "utf8"));
+		const cfg = JSON.parse(configJson ?? "");
 		if (typeof cfg?.vault === "string" && cfg.vault.startsWith("/")) return cfg.vault;
 	} catch {}
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
-const VAULT = resolveVaultPath();
+let cached = {
+	at: 0,
+	key: "",
+	value: ""
+};
+/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+function vaultPath(now = Date.now()) {
+	const dir = stateDir();
+	let configJson;
+	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);
+	cached = {
+		at: now,
+		key: configJson ?? "",
+		value
+	};
+	return value;
+}
+vaultPath();
 // src/router-tools.ts
 const inject = ["tools", "subagents"];
 const text = (s) => [{
@@ -290,7 +316,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 = [];
@@ -322,7 +348,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,
@@ -337,7 +363,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) {
@@ -360,7 +386,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) }
@@ -371,7 +397,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) }
@@ -415,7 +441,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");
@@ -511,7 +537,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 {
@@ -585,7 +611,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 {}
@@ -597,4 +623,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,6 +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 解析/序列化。纯函数为主，可单测。
@@ -33,26 +34,51 @@ function resolveSafe(vaultRoot, rel) {
 *
 * 解析优先级：
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
-*   ② 实例启动目录下的 sun-space.config.json 的 vault 字段（持久化配置，重启不丢）
+*   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
 *   ③ 默认约定 ~/Workspace/sun-vault
 *
-* 解析结果同时写入 <实例cwd>/sun-space.json（仅 vault 字段），作为浏览器端（孙学空间）
-* 的发现通道——浏览器读不到进程环境，靠这个文件拿到真实 vault 路径（workspaceFiles
-* 的相对路径读取以会话工作区根为基准，即实例 cwd，两者同目录）。
+* 解析结果写回 ~/.dsh/state/sun-space/state.json，作为浏览器端（孙学空间）的发现
+* 通道——浏览器读不到进程环境与插件 config，经 workspaceFiles/read 以绝对路径读取
+* 该文件（工作区外绝对路径读取被宿主允许，与 vault 本体读取同机制）。
 *
-* 注意：本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
+* 目录约定沿用 DSH 官方先例：~/.dsh/state/<插件名>/（社区插件 session-superagent 同款）。
+* 本文件不携带任何个人路径；个人 vault 位置只存在于①/②（均不入库）。
 */
 const DEFAULT_VAULT_DIRNAME = "sun-vault";
-/** 解析 vault 绝对路径（① env ② 实例目录配置文件 ③ 默认约定）。 */
-function resolveVaultPath(cwd = process.cwd(), home = process.env.HOME ?? "") {
-	if (process.env.SUN_VAULT && process.env.SUN_VAULT.trim() !== "") return process.env.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()) {
+	if (envValue && envValue.trim() !== "") return envValue;
 	try {
-		const cfg = JSON.parse(readFileSync(join(cwd, "sun-space.config.json"), "utf8"));
+		const cfg = JSON.parse(configJson ?? "");
 		if (typeof cfg?.vault === "string" && cfg.vault.startsWith("/")) return cfg.vault;
 	} catch {}
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
-const VAULT = resolveVaultPath();
+let cached = {
+	at: 0,
+	key: "",
+	value: ""
+};
+/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+function vaultPath(now = Date.now()) {
+	const dir = stateDir();
+	let configJson;
+	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);
+	cached = {
+		at: now,
+		key: configJson ?? "",
+		value
+	};
+	return value;
+}
+vaultPath();
 // src/worker-vault.ts
 const inject = ["tools"];
 const TASK_ID = /^T-\d{8}-\d{2}$/;
@@ -104,7 +130,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 {
@@ -125,4 +151,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.5",
+  "version": "0.2.7",
   "type": "module",
   "description": "Sun Space：DeepSeek Harness 个人超智能体插件——Router/Worker 双预设工具白名单、钉钉待办轮询、Obsidian 知识库落库、会话工作台与定时任务管理。",
   "exports": {

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 = 'v15' // 根节点 data-wb-rev 版本标记：判别浏览器是否吃到旧 client.js（immutable 缓存坑，HANDOFF 踩坑 1）
+      const WB_REV = 'v17' // 根节点 data-wb-rev 版本标记：判别浏览器是否吃到旧 client.js（immutable 缓存坑，HANDOFF 踩坑 1）
 
       const STATUS_META = {
         proposed: { label: '待确认派发', color: '#9e9e9e' },
@@ -103,14 +103,19 @@ window.__ModuleLoader__.load({
         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
-        // ① 插件落盘的运行配置（实例 cwd 的 sun-space.json；相对路径以会话工作区根解析，即实例 cwd）
-        try {
-          const raw = await readVaultFile(scope, 'sun-space.json', 4)
-          const cfg = JSON.parse(raw)
-          if (cfg?.vault && cfg.vault.startsWith('/')) return cfg.vault
-        } catch { /* 无发现文件 → 走约定探测 */ }
-        // ② 约定布局探测（默认 ~/Workspace/sun-vault；自定义 vault 路径由①覆盖）
+        // ① 插件状态目录（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 {
@@ -186,26 +191,6 @@ window.__ModuleLoader__.load({
         return gw('session/create', { agentPreset: 'sun-router' })
       }
 
-      // 创建后引导新会话自登记 state.json（workspaceFiles 无写通道，sun_vault_write 是唯一写路径）
-      async function bootstrapRouterSession(sid, vault) {
-        const text = '初始化自登记：用 sun_vault_write（mode=overwrite）写 90-Meta/system/state.json，内容 ' +
-          JSON.stringify({
-            routerSession: sid,
-            vault: vault ?? '（vault 绝对路径，用你环境里 sun 工具实际使用的知识库路径）',
-            updatedAt: new Date().toLocaleString('sv-SE', { timeZone: 'Asia/Shanghai' }),
-          }) +
-          '；完成后一句话报告。'
-        try {
-          await gw('session/prompt', {
-            requestId: 'sun-boot-' + Date.now(),
-            sessionId: sid,
-            mode: 'queue',
-            content: [{ type: 'text', text }],
-            clientTimeZone: 'Asia/Shanghai',
-          })
-          return true
-        } catch (e) { D.errors.push('bootstrapRouterSession: ' + String(e)); return false }
-      }
 
       async function loadTasks(routerSession, vault) {
         if (!routerSession || !vault) return []
@@ -262,16 +247,48 @@ window.__ModuleLoader__.load({
         }
       }
 
-      // 创建 Router 会话 → 自登记 state.json → 跳转 → 重检（InitPanel 与 OnboardPanel 共用）
-      async function createAndBootstrap(checks, onRetry) {
+      // 一键初始化：创建 Router 会话 → 下发合并指令（90-Meta 骨架 + 自登记 state.json）。
+      // 全程走 sun_vault_write（vault 白名单内，零审批弹窗）——Router 是 sun-router 预设，
+      // 插件运行期动态解析（vaultPath()）保证它写入"当前生效"的知识库路径。
+      async function createRouterAndInit(checks, onRetry) {
         try {
           const v = await createRouterSession()
           const sid = typeof v === 'string' ? v : (v?.sessionId ?? v)
-          if (sid) {
-            await bootstrapRouterSession(sid, checks.vaultPath) // 自登记 state.json（含 vault 字段；失败不阻断——下次检查由最近活跃兜底）
-            try { hostCtx.uiWorkspace.openSession(sid) } catch (e) { D.errors.push('openSession: ' + String(e)) }
-            onRetry() // 新会话的 tab 即完整工作台（state.json 已指向它）
-          }
+          if (!sid) return
+          await gw('session/prompt', {
+            requestId: 'sun-init-' + Date.now(),
+            sessionId: sid,
+            mode: 'queue',
+            content: [{ type: 'text', text: `【孙学空间初始化】你是新环境的 Sun Router（你的会话 id：${sid}）。完成知识库初始化：
+1) 用 sun_vault_write 创建知识库骨架（写入插件解析给你的 vault 路径，通常是 ~/Workspace/sun-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：初始版（# 关于用户，待填充）
+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)) }
+          onRetry()
+        } catch (e) { D.errors.push(String(e)) }
+      }
+
+      // Router 已在、知识库缺失时的骨架补建指令（发给现有 Router 会话）
+      async function initSkeletonOnRouter(routerSession, onRetry) {
+        try {
+          await gw('session/prompt', {
+            requestId: 'sun-skel-' + Date.now(),
+            sessionId: routerSession,
+            mode: 'queue',
+            content: [{ type: 'text', text: `【知识库骨架补建】用 sun_vault_write 在你的 vault 路径下创建：
+- 90-Meta/schemas.md：frontmatter 契约最小集（通用字段 type/id/status/created/updated；写入纪律同 runbook）
+- 90-Meta/runbook.md：若缺失则写初始版（# Sun 行为手册 + v0.1）
+- 90-Meta/memory.md：若缺失则写初始版（# 关于用户）
+- 90-Meta/system/state.json：{"routerSession": "${routerSession}", "vault": "<你的 vault 绝对路径>", "updatedAt": "<本地时间>"}（已有的话合并更新 routerSession/vault 字段）
+完成后报告清单。` }],
+            clientTimeZone: 'Asia/Shanghai',
+          })
+          onRetry()
         } catch (e) { D.errors.push(String(e)) }
       }
 
@@ -290,7 +307,7 @@ window.__ModuleLoader__.load({
               h('div', { key: 'd', style: { fontSize: 12, opacity: 0.7, lineHeight: 1.6 } }, r.desc),
             ]),
             r.action === 'plugins' ? h('button', { key: 'a', onClick: () => { try { hostCtx.layout.selectPanel('plugins') } catch (e) { D.errors.push(String(e)) } }, style: btnStyle }, '打开插件面板') : null,
-            r.action === 'create-router' ? h('button', { key: 'a', onClick: () => createAndBootstrap(checks, onRetry), style: btnStyle }, '创建 Router 会话') : null,
+            r.action === 'create-router' ? h('button', { key: 'a', onClick: () => createRouterAndInit(checks, onRetry), style: btnStyle }, '创建 Router 会话') : null,
           ])),
           h('button', { key: 'retry', onClick: onRetry, style: { ...btnStyle, marginTop: 10 } }, '↻ 重新检查'),
         ])
@@ -386,8 +403,8 @@ window.__ModuleLoader__.load({
       function OnboardPanel({ checks, currentSessionId, onRetry }) {
         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/sun-vault 并放好 90-Meta 骨架；自定义位置让 Router 把绝对路径写进 state.json 的 vault 字段`, action: null },
+          { n: 2, ok: !!checks.routerSession, title: '一键初始化（Router 会话 + 知识库）', desc: checks.routerSession ? `已就绪：${checks.routerSession.slice(0, 28)}…` : '一键完成：创建 sun-router 预设 Router 会话 → 在知识库写入 90-Meta 骨架 → 自登记状态（全程走 sun_vault_write，免审批）', action: checks.presets && !checks.routerSession ? 'create-router' : null },
+          { n: 3, ok: checks.vault, title: '知识库就绪', desc: checks.vault ? `已就绪：${checks.vaultPath}` : (checks.routerSession ? '知识库骨架缺失 → 点下方按钮让 Router 补建' : '完成第②步后自动创建'), action: checks.presets && checks.routerSession && !checks.vault ? 'init-skeleton' : null },
         ]
         const allOk = steps.every(x => x.ok)
         return h('div', null, [
@@ -400,7 +417,9 @@ window.__ModuleLoader__.load({
               h('div', { key: 'd', style: { fontSize: 12, opacity: 0.7, lineHeight: 1.6, marginTop: 2 } }, st.desc),
             ]),
             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 === 'create-router' ? h('button', { key: 'a', onClick: () => createRouterAndInit(checks, onRetry), style: btnStyle }, '一键初始化') : null,
+            st.action === 'init-skeleton' ? h('button', { key: 'a', onClick: () => initSkeletonOnRouter(checks.routerSession, onRetry), style: btnStyle }, '补建知识库骨架') : null,
+
           ])),
           allOk ? h('p', { key: 'done', style: { color: '#57b26a', fontSize: 13 } }, '✓ 全部就绪——到「定时任务」用模板创建晨报等四条生产任务，即可开始使用。') : null,
           h('button', { key: 'retry', onClick: onRetry, style: { ...btnStyle, marginTop: 10 } }, '↻ 重新检查'),