dsh-sun-space 0.2.9 → 0.3.1

package/lib/index.mjs

@@ -22,11 +22,12 @@ var __exportAll = (all, no_symbols) => {
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
 *   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
 *   ③ ~/.dsh/state/sun-space/state.json 的 vault 字段（Router 会话创建时插件自动登记 = 用户选定的工作区目录）
-*   ④ 默认约定 ~/Workspace/sun-vault
+*   ④ 会话工作目录（调用方从 exec 提取传入——用户在哪个工作区开会话，vault 就解析到哪）
+*   ⑤ 默认约定 ~/Workspace/sun-vault
 *
 * ③ 的设计动机：用户的 vault 就是他在 DSH 里选定的那个目录——Router 会话创建时
 * 插件自动把该会话 cwd 登记为 vault 根（registerVaultRootFromSession），无需任何
-* 手工配置。①② 供自定义/覆盖；④ 仅在全新裸环境兜底。
+* 手工配置。①② 供自定义/覆盖；⑤ 仅在全新裸环境兜底。
 *
 * 解析结果写回 state.json，作为浏览器端（孙学空间）的发现通道——浏览器经
 * workspaceFiles/read 以绝对路径读取该文件（工作区外绝对路径读取被宿主允许）。
@@ -38,13 +39,14 @@ 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");
-/** 纯函数：四级优先解析（测试与 vaultPath 共用）。 */
-function computeVaultPath(envValue, configJson, stateJson, home = homedir()) {
+/** 纯函数：五级优先解析（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, stateJson, sessionCwd, home = homedir()) {
 	if (envValue && envValue.trim() !== "") return envValue;
 	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 = {
@@ -52,8 +54,9 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。 */
-function vaultPath(now = Date.now()) {
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。
+*  sessionCwd：调用方从 exec 提取的会话工作目录（可选）——用户在哪个工作区开会话，vault 就解析到哪。 */
+function vaultPath(sessionCwd, now = Date.now()) {
 	const dir = stateDir();
 	let configJson;
 	let stateJson;
@@ -63,9 +66,9 @@ function vaultPath(now = Date.now()) {
 	try {
 		stateJson = readFileSync(join(dir, "state.json"), "utf8");
 	} catch {}
-	const key = `${configJson ?? ""}|${stateJson ?? ""}`;
+	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);
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson, sessionCwd);
 	cached = {
 		at: now,
 		key,
@@ -110,7 +113,7 @@ function publishVaultState(now = /* @__PURE__ */ new Date()) {
 		try {
 			state = JSON.parse(readFileSync(p, "utf8"));
 		} catch {}
-		state.vault = vaultPath(now.getTime());
+		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 {}

package/lib/router-tools.mjs

@@ -193,11 +193,12 @@ async function dingSelf(userId, content, type = "app") {
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
 *   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
 *   ③ ~/.dsh/state/sun-space/state.json 的 vault 字段（Router 会话创建时插件自动登记 = 用户选定的工作区目录）
-*   ④ 默认约定 ~/Workspace/sun-vault
+*   ④ 会话工作目录（调用方从 exec 提取传入——用户在哪个工作区开会话，vault 就解析到哪）
+*   ⑤ 默认约定 ~/Workspace/sun-vault
 *
 * ③ 的设计动机：用户的 vault 就是他在 DSH 里选定的那个目录——Router 会话创建时
 * 插件自动把该会话 cwd 登记为 vault 根（registerVaultRootFromSession），无需任何
-* 手工配置。①② 供自定义/覆盖；④ 仅在全新裸环境兜底。
+* 手工配置。①② 供自定义/覆盖；⑤ 仅在全新裸环境兜底。
 *
 * 解析结果写回 state.json，作为浏览器端（孙学空间）的发现通道——浏览器经
 * workspaceFiles/read 以绝对路径读取该文件（工作区外绝对路径读取被宿主允许）。
@@ -209,13 +210,14 @@ 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");
-/** 纯函数：四级优先解析（测试与 vaultPath 共用）。 */
-function computeVaultPath(envValue, configJson, stateJson, home = homedir()) {
+/** 纯函数：五级优先解析（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, stateJson, sessionCwd, home = homedir()) {
 	if (envValue && envValue.trim() !== "") return envValue;
 	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 = {
@@ -223,8 +225,9 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。 */
-function vaultPath(now = Date.now()) {
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。
+*  sessionCwd：调用方从 exec 提取的会话工作目录（可选）——用户在哪个工作区开会话，vault 就解析到哪。 */
+function vaultPath(sessionCwd, now = Date.now()) {
 	const dir = stateDir();
 	let configJson;
 	let stateJson;
@@ -234,9 +237,9 @@ function vaultPath(now = Date.now()) {
 	try {
 		stateJson = readFileSync(join(dir, "state.json"), "utf8");
 	} catch {}
-	const key = `${configJson ?? ""}|${stateJson ?? ""}`;
+	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);
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson, sessionCwd);
 	cached = {
 		at: now,
 		key,
@@ -247,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
@@ -322,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 = [];
@@ -357,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,
@@ -372,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) {
@@ -395,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) }
@@ -406,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) }
@@ -448,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");
@@ -544,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 {
@@ -620,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

@@ -36,11 +36,12 @@ function resolveSafe(vaultRoot, rel) {
 *   ① 环境变量 SUN_VAULT（启动命令注入，随进程生效）
 *   ② ~/.dsh/state/sun-space/config.json 的 vault 字段（用户手写，持久化，不入库）
 *   ③ ~/.dsh/state/sun-space/state.json 的 vault 字段（Router 会话创建时插件自动登记 = 用户选定的工作区目录）
-*   ④ 默认约定 ~/Workspace/sun-vault
+*   ④ 会话工作目录（调用方从 exec 提取传入——用户在哪个工作区开会话，vault 就解析到哪）
+*   ⑤ 默认约定 ~/Workspace/sun-vault
 *
 * ③ 的设计动机：用户的 vault 就是他在 DSH 里选定的那个目录——Router 会话创建时
 * 插件自动把该会话 cwd 登记为 vault 根（registerVaultRootFromSession），无需任何
-* 手工配置。①② 供自定义/覆盖；④ 仅在全新裸环境兜底。
+* 手工配置。①② 供自定义/覆盖；⑤ 仅在全新裸环境兜底。
 *
 * 解析结果写回 state.json，作为浏览器端（孙学空间）的发现通道——浏览器经
 * workspaceFiles/read 以绝对路径读取该文件（工作区外绝对路径读取被宿主允许）。
@@ -52,13 +53,14 @@ 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");
-/** 纯函数：四级优先解析（测试与 vaultPath 共用）。 */
-function computeVaultPath(envValue, configJson, stateJson, home = homedir()) {
+/** 纯函数：五级优先解析（测试与 vaultPath 共用）。 */
+function computeVaultPath(envValue, configJson, stateJson, sessionCwd, home = homedir()) {
 	if (envValue && envValue.trim() !== "") return envValue;
 	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 = {
@@ -66,8 +68,9 @@ let cached = {
 	key: "",
 	value: ""
 };
-/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。 */
-function vaultPath(now = Date.now()) {
+/** 运行期解析：每次调用重读状态目录（60s 微缓存防抖），登记/手改后即时生效。
+*  sessionCwd：调用方从 exec 提取的会话工作目录（可选）——用户在哪个工作区开会话，vault 就解析到哪。 */
+function vaultPath(sessionCwd, now = Date.now()) {
 	const dir = stateDir();
 	let configJson;
 	let stateJson;
@@ -77,9 +80,9 @@ function vaultPath(now = Date.now()) {
 	try {
 		stateJson = readFileSync(join(dir, "state.json"), "utf8");
 	} catch {}
-	const key = `${configJson ?? ""}|${stateJson ?? ""}`;
+	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);
+	const value = computeVaultPath(process.env.SUN_VAULT, configJson, stateJson, sessionCwd);
 	cached = {
 		at: now,
 		key,
@@ -90,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) {
@@ -135,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.9",
+  "version": "0.3.1",
   "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 = '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 {
@@ -289,12 +298,14 @@ window.__ModuleLoader__.load({
             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 字段）
-完成后报告清单。` }],
+            content: [{ type: 'text', text: `【知识库骨架补建 + vault 根登记】你的工作目录即知识库根（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) 用 sun_vault_write 创建/补全知识库骨架：
+   - 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": "<你的工作目录绝对路径>", "updatedAt": "<本地时间>"}（已有的话合并更新 routerSession/vault 字段）
+完成后报告清单与知识库路径。` }],
             clientTimeZone: 'Asia/Shanghai',
           })
           onRetry()
@@ -526,6 +537,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' } }),