dsh-sun-space 0.2.7 → 0.2.9

package/lib/index.mjs

@@ -18,28 +18,32 @@ 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 会话创建时插件自动登记 = 用户选定的工作区目录）
+*   ④ 默认约定 ~/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, 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 {}
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
@@ -48,32 +52,67 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。 */
 function vaultPath(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 = `${configJson ?? ""}|${stateJson ?? ""}`;
+	if (now - cached.at < 6e4 && cached.key === key) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson);
 	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(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 +532,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,28 +189,32 @@ 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 会话创建时插件自动登记 = 用户选定的工作区目录）
+*   ④ 默认约定 ~/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, 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 {}
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
@@ -219,18 +223,23 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。 */
 function vaultPath(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 = `${configJson ?? ""}|${stateJson ?? ""}`;
+	if (now - cached.at < 6e4 && cached.key === key) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson);
 	cached = {
 		at: now,
-		key: configJson ?? "",
+		key,
 		value
 	};
 	return value;

package/lib/worker-vault.mjs

@@ -32,28 +32,32 @@ 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 会话创建时插件自动登记 = 用户选定的工作区目录）
+*   ④ 默认约定 ~/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, 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 {}
 	return join(home, "Workspace", DEFAULT_VAULT_DIRNAME);
 }
@@ -62,18 +66,23 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读 config.json（60s 微缓存防抖），"以当前目录初始化"写入后即时生效。 */
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。 */
 function vaultPath(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 = `${configJson ?? ""}|${stateJson ?? ""}`;
+	if (now - cached.at < 6e4 && cached.key === key) return cached.value;
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson);
 	cached = {
 		at: now,
-		key: configJson ?? "",
+		key,
 		value
 	};
 	return value;

package/package.json

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

package/src/client.js

@@ -130,9 +130,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
@@ -151,7 +153,7 @@ window.__ModuleLoader__.load({
 
       // ===== 初始化检查（在任何会话的 tab 上都能跑；① 用当前会话作 workspaceFiles scope）=====
       async function runInitChecks(currentSessionId) {
-        const c = { vault: false, presets: false, routerSession: null, vaultPath: null, notes: [] }
+        const c = { vault: false, presets: false, routerSession: null, vaultPath: null, currentCwd: null, notes: [] }
         // ① 知识库：vault 路径动态发现 + runbook 探测
         const vault = await resolveVault()
         c.vaultPath = vault
@@ -176,9 +178,14 @@ window.__ModuleLoader__.load({
           c.presets = false
           c.notes.push('预设服务不可达 → 确认 Harness 实例在线、插件已启用')
         }
-        // ③ Router 会话：动态解析（state.json → 最近活跃）
+        // ③ Router 会话：动态解析 + 首个 sun-router 会话创建时自动登记其 cwd 为 vault 根
+        //   （"当前目录作为 vault"语义的插件层落点；env/config 更高优先级不受影响）
         try {
-          c.routerSession = vault ? await resolveRouterSession(vault) : null
+          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
+          // 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('会话列表不可达 → 重试或检查实例')
@@ -186,9 +193,10 @@ window.__ModuleLoader__.load({
         return c
       }
 
-      async function createRouterSession() {
-        // 不传 cwd：会话随当前工作区分桶（与生产会话同桶）；cwd=vault 反而会分裂出独立桶（踩坑 5）
-        return gw('session/create', { agentPreset: 'sun-router' })
+      async function createRouterSession(cwd) {
+        // cwd 可选：一键初始化时传当前会话的工作区目录——Router 会话落在用户选的工作区
+        //（session/create 带 cwd 还会自动注册该工作区）；不传则随宿主项目目录（踩坑 5）
+        return gw('session/create', cwd ? { cwd, agentPreset: 'sun-router' } : { agentPreset: 'sun-router' })
       }
 
 
@@ -252,19 +260,20 @@ window.__ModuleLoader__.load({
       // 插件运行期动态解析（vaultPath()）保证它写入"当前生效"的知识库路径。
       async function createRouterAndInit(checks, onRetry) {
         try {
-          const v = await createRouterSession()
+          const cwd = checks.currentCwd
+          const v = await createRouterSession(cwd)
           const sid = typeof v === 'string' ? v : (v?.sessionId ?? v)
           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 或用户自定义路径）：
+            content: [{ type: 'text', text: `【孙学空间初始化】你是新环境的 Sun Router（你的会话 id：${sid}）。你的工作目录即知识库根（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：初始版（# 关于用户，待填充）
-2) 用 sun_vault_write 写 90-Meta/system/state.json：{"routerSession": "${sid}", "vault": "<你解析到的知识库绝对路径>", "updatedAt": "<本地时间 YYYY-MM-DDTHH:mm>"}（自登记，供孙学空间发现与轮换机制使用）
+2) 用 sun_vault_write 写 90-Meta/system/state.json：{"routerSession": "${sid}", "vault": "<你的工作目录绝对路径>", "updatedAt": "<本地时间 YYYY-MM-DDTHH:mm>"}（自登记，供孙学空间发现与轮换机制使用）
 3) 完成后列出生成的文件清单与知识库路径。` }],
             clientTimeZone: 'Asia/Shanghai',
           })
@@ -403,7 +412,7 @@ 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 预设 Router 会话 → 在知识库写入 90-Meta 骨架 → 自登记状态（全程走 sun_vault_write，免审批）', action: checks.presets && !checks.routerSession ? 'create-router' : null },
+          { n: 2, ok: !!checks.routerSession, title: '一键初始化（Router 会话 + 知识库）', desc: checks.routerSession ? `已就绪：${checks.routerSession.slice(0, 28)}…` : `一键完成：以当前工作区目录${checks.currentCwd ? `（${checks.currentCwd}）` : ''}为知识库根 → 创建 Router 会话 → 写入 90-Meta 骨架 → 自登记（仅 ~/.dsh 登记需一次批准）`, 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)