dsh-sun-space 0.2.8 → 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.8",
+  "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
@@ -176,12 +178,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 +269,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)) }