dsh-mindmap 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project are documented here. Release-specific notes
 
 ## [Unreleased]
 
+### Changed
+
+- The browser client is now maintained as focused source fragments under `src/client/` and assembled into the single runtime `client.js` entry by `npm run build:client`.
+- AI create/open/view intent now restores and switches the target mindmap panel smoothly, including repeated opens and open-then-update tool sequences.
+- Added release metadata, a `prepack` verification hook, and an npm package dry-run check to the documented development flow.
+
 ### Added
 
 - Settings page section「思维脑图」in the left nav (`settings.section`), backed by a host settings namespace (`mindmap`): node theme (line style curve/elbow, card corners rounded/square, three color themes ocean/sunset/forest), default panel width (20-80%). The `requireApproval` switch stays functional (read at tool pre-execute time) but is hidden from the UI by design. Introduces a `@deepseek-ai/schemastery` dependency for the settings schema.

package/README.md

@@ -17,7 +17,7 @@ A DeepSeek Harness plugin that turns a plain Markdown file into a live mindmap.
 
 - **Four tools** (`mindmap_create` / `mindmap_open` / `mindmap_get` / `mindmap_update`) — plain Markdown files in the session working directory; the root node title is the filename and stays in sync both ways (`renameRoot` renames the file, collisions are rejected).
 - **Live panel with zero extra channels** — the panel consumes the session snapshot (`mindmap_*` tool results), so every AI edit re-renders immediately.
-- **Floating right panel** — toggled by the 思维脑图 button in the session header; opens on AI `mindmap_open`/`create` too. Opening the panel pushes the chat to the left (layout-push, the chat is never covered); width is drag-resizable (280px ~ 80% viewport) and persisted.
+- **Floating right panel** — toggled by the 思维脑图 button in the session header; AI create/open/view intents also expand it and switch to the target document, including when the panel is currently closed or the same document is opened again. Opening the panel pushes the chat to the left (layout-push, the chat is never covered); width is drag-resizable (280px ~ 80% viewport) and persisted.
 - **Directory tree tab** — a persistent tree of the session working directory (served by a plugin-owned read-only route), lazy-loaded per directory; right-click to create a mindmap (at the root or inside a directory); left-click a `.md` to open it instantly and hand it to the AI for editing.
 - **Single-mindmap mode** — two tabs only: 目录 (tree) and 脑图 (the current mindmap); opening another `.md` replaces the previous one.
 - **"What you see is what the AI edits"** — when the visible mindmap differs from the AI's working document, the panel automatically asks the AI to open it, keeping the chat focus in sync.
@@ -58,9 +58,13 @@ dsh plugin --profile <profile> add <pkg>#v<version>
 ## Development
 
 ```bash
-npm run verify   # syntax check + node --test
+npm run build:client  # assemble the runtime client.js from src/client fragments
+npm run verify        # rebuild + syntax check + node --test
+npm pack --dry-run    # inspect the files that will enter the npm package
 ```
 
+The browser implementation is maintained under `src/client/` and assembled into the single `client.js` entry required by DeepSeek Harness. Edit the source fragments, then run `npm run build:client`; do not hand-edit the generated entry.
+
 ## License
 
 Not yet chosen — contact the author before redistributing.

package/README.zh-CN.md

@@ -17,7 +17,7 @@
 
 - **四个工具**（`mindmap_create` / `mindmap_open` / `mindmap_get` / `mindmap_update`）——会话工作目录里的普通 `.md` 文件；根节点标题 = 文件名，双向同步（`renameRoot` 触发文件重命名，撞名报错不覆盖）。
 - **零通道实时面板**——面板直接消费会话快照里的 `mindmap_*` 工具结果，AI 每改一步面板即渲染一次。
-- **右侧悬浮面板**——会话头部「思维脑图」按钮开合；AI 打开/创建脑图时也会自动展开。打开时**聊天区向左让位**（布局推挤，互不遮挡）；宽度可拖（280px ~ 80% 视口）并持久化。
+- **右侧悬浮面板**——会话头部「思维脑图」按钮开合；AI 创建、打开或查看脑图时会自动展开并切换到目标文档，即使面板当前收起或重复打开同一文档也能接续跟随。打开时**聊天区向左让位**（布局推挤，互不遮挡）；宽度可拖（280px ~ 80% 视口）并持久化。
 - **常驻目录树 tab**——工作目录结构懒加载树（插件自建只读路由）；空白处/目录右键新建脑图；左键点 `.md` 秒开 tab 并自动交给 AI 打开，随后直接对话继续编辑。
 - **单脑图模式**——面板只有「目录」和「脑图」两个 tab，打开新脑图替换旧的那颗。
 - **「所见即所编」焦点同步**——可见脑图与 AI 工作文档不一致时，面板自动让 AI 打开它，聊天焦点始终跟随你的眼睛。
@@ -58,9 +58,13 @@ dsh plugin --profile <profile> add <pkg>#v<version>
 ## 开发
 
 ```bash
-npm run verify   # 语法检查 + node --test
+npm run build:client  # 从 src/client 片段组装运行时 client.js
+npm run verify        # 重建 + 语法检查 + node --test
+npm pack --dry-run    # 检查将进入 npm 包的文件
 ```
 
+浏览器端实现维护在 `src/client/` 下，构建后仍输出 DeepSeek Harness 要求的单一 `client.js` 入口。请修改源码片段后运行 `npm run build:client`，不要直接手改生成入口。
+
 ## License
 
 尚未确定——再分发前请先联系作者。

package/client.js

@@ -281,41 +281,97 @@ window.__ModuleLoader__.load({
 		/**
 		 * 重放会话快照里的 mindmap_* 工具结果，得到每个脑图文档的最新状态。
 		 * nodes: ConversationSnapshot.nodes（ToolResultNode 含 call.name 与渲染后的
-		 * content 文本块——host 的工具结果 JSON 就写在其中）。
-		 * 返回 { order: path[], byPath: { path → {path, rootTitle, content, op, callId} } }。
+		 * content 文本块——host 的工具结果 JSON 就写在其中）。Code 等工具的结果
+		 * 还可能把真实的 mindmap ToolResultNode 放在 subCalls 中，因此这里按事件
+		 * 顺序递归重放整棵调用树。
+		 * 返回文档集及最近一次 create/open 意图，用于驱动面板自动切换目标。
 		 */
 		function reduceDocuments(nodes) {
 			const byPath = Object.create(null);
 			let order = [];
-			for (const node of nodes ?? []) {
-				if (!node || node.kind !== "tool-result" || node.isError) continue;
-				const name = node.call?.name;
-				if (typeof name !== "string" || !TOOL_NAMES.has(name)) continue;
-				let parsed;
-				try {
-					parsed = JSON.parse(resultTextOfBlocks(node.content));
-				} catch {
-					continue;
+			let latestOpeningPath = null;
+			let latestOpeningEventKey = null;
+			const visited = new WeakSet();
+			const MAX_SUBCALL_DEPTH = 100;
+
+			function replayNode(node, eventPath, depth) {
+				if (!node || typeof node !== "object" || visited.has(node)) return;
+				visited.add(node);
+
+				if (node.kind === "tool-result" && !node.isError) {
+					const name = node.call?.name;
+					if (typeof name === "string" && TOOL_NAMES.has(name)) {
+						let parsed;
+						try {
+							parsed = JSON.parse(resultTextOfBlocks(node.content));
+						} catch {
+							parsed = null;
+						}
+						if (parsed && parsed.ok === true && typeof parsed.path === "string" && parsed.path) {
+							const op = typeof parsed.op === "string" ? parsed.op : name;
+							// callId 是实际调用的事件身份；eventPath 是无 callId 时按会话
+							// 遍历顺序生成的稳定兜底，避免重复 open 被合并成一个事件。
+							const callId = node.callId != null && String(node.callId)
+								? node.callId
+								: node.call?.callId;
+							const eventKey = callId != null && String(callId)
+								? `call:${String(callId)}`
+								: `node:${eventPath}`;
+							const renamedFrom = typeof parsed.renamedFrom === "string" ? parsed.renamedFrom : null;
+							const previous = byPath[parsed.path];
+							const renamedDocument = renamedFrom && renamedFrom !== parsed.path
+								? byPath[renamedFrom]
+								: null;
+							const inheritedOpeningEventKey = renamedDocument?.openingEventKey
+								?? previous?.openingEventKey
+								?? (renamedFrom && latestOpeningPath === renamedFrom ? latestOpeningEventKey : null);
+
+							// 根节点改名会删除旧路径键；若旧路径正是最近一次打开意图，
+							// 同时迁移路径并保留原 openingEventKey，确保自动切换仍生效。
+							if (renamedFrom && renamedFrom !== parsed.path && latestOpeningPath === renamedFrom) {
+								latestOpeningPath = parsed.path;
+								if (latestOpeningEventKey == null) latestOpeningEventKey = inheritedOpeningEventKey;
+							}
+
+							const openingEventKey = OPENING_OPS.has(op)
+								? eventKey
+								: inheritedOpeningEventKey;
+							if (OPENING_OPS.has(op)) {
+								latestOpeningPath = parsed.path;
+								latestOpeningEventKey = eventKey;
+							}
+							if (renamedFrom && renamedDocument && renamedFrom !== parsed.path) {
+								delete byPath[renamedFrom];
+								order = order.filter((p) => p !== renamedFrom);
+							}
+							if (!byPath[parsed.path]) order.push(parsed.path);
+							byPath[parsed.path] = {
+								path: parsed.path,
+								rootTitle: typeof parsed.rootTitle === "string" && parsed.rootTitle ? parsed.rootTitle : stemOf(parsed.path),
+								content: typeof parsed.content === "string" ? parsed.content : "",
+								op,
+								callId,
+								eventKey,
+								openingEventKey,
+								// 013：rename 迁移后保留旧路径，供本地直读 tab 清理（mergeDocuments）。
+								renamedFrom,
+							};
+						}
+					}
 				}
-				if (!parsed || parsed.ok !== true || typeof parsed.path !== "string" || !parsed.path) continue;
-				// 根标题改名 = 文件重命名：旧路径键迁移到新路径。
-				const renamedFrom = typeof parsed.renamedFrom === "string" ? parsed.renamedFrom : null;
-				if (renamedFrom && byPath[renamedFrom] && renamedFrom !== parsed.path) {
-					delete byPath[renamedFrom];
-					order = order.filter((p) => p !== renamedFrom);
+
+				// 父级非 mindmap 工具不参与文档解析，但其 subCalls 仍是会话事件，
+				// 必须继续深入；深度上限与 WeakSet 一起防止异常结构卡死。
+				if (depth >= MAX_SUBCALL_DEPTH || !Array.isArray(node.subCalls)) return;
+				for (const [subCallIndex, subCall] of node.subCalls.entries()) {
+					replayNode(subCall, `${eventPath}.${subCallIndex}`, depth + 1);
 				}
-				if (!byPath[parsed.path]) order.push(parsed.path);
-				byPath[parsed.path] = {
-					path: parsed.path,
-					rootTitle: typeof parsed.rootTitle === "string" && parsed.rootTitle ? parsed.rootTitle : stemOf(parsed.path),
-					content: typeof parsed.content === "string" ? parsed.content : "",
-					op: typeof parsed.op === "string" ? parsed.op : name,
-					callId: node.callId,
-					// 013：rename 迁移后保留旧路径，供本地直读 tab 清理（mergeDocuments）。
-					renamedFrom: typeof parsed.renamedFrom === "string" ? parsed.renamedFrom : null,
-				};
 			}
-			return { order, byPath };
+
+			for (const [nodeIndex, node] of (Array.isArray(nodes) ? nodes : []).entries()) {
+				replayNode(node, String(nodeIndex), 0);
+			}
+			return { order, byPath, latestOpeningPath, latestOpeningEventKey };
 		}
 
 		/**
@@ -337,7 +393,36 @@ window.__ModuleLoader__.load({
 			for (const p of Object.keys(localDocs)) {
 				if (!snapshot.byPath[p] && !dropped.has(p)) order.push(p);
 			}
-			return { order, byPath };
+			return {
+				order,
+				byPath,
+				latestOpeningPath: snapshot.latestOpeningPath ?? null,
+				latestOpeningEventKey: snapshot.latestOpeningEventKey ?? null,
+			};
+		}
+
+		/**
+		 * 找到本次快照需要自动展示的脑图路径。
+		 * seenKeys 为 null 表示首次挂载：恢复历史会话最近一次 create/open；
+		 * 否则只响应尚未消费的打开事件。
+		 */
+		function autoOpenTarget(snapshot, seenKeys) {
+			if (!snapshot || !snapshot.latestOpeningPath || !snapshot.byPath?.[snapshot.latestOpeningPath]) return null;
+			if (seenKeys === null) return snapshot.latestOpeningPath;
+			const latest = snapshot.byPath[snapshot.latestOpeningPath];
+			if (latest.openingEventKey && !seenKeys.has(latest.openingEventKey)) return snapshot.latestOpeningPath;
+			let target = null;
+			for (const p of snapshot.order ?? []) {
+				const doc = snapshot.byPath[p];
+				if (doc?.openingEventKey && !seenKeys.has(doc.openingEventKey)) target = p;
+			}
+			return target;
+		}
+
+		function openingEventKeys(snapshot) {
+			return new Set((snapshot?.order ?? [])
+				.map((p) => snapshot.byPath[p]?.openingEventKey)
+				.filter((key) => key != null));
 		}
 		//#endregion
 
@@ -1028,26 +1113,17 @@ window.__ModuleLoader__.load({
 				[doc && doc.content, doc && doc.rootTitle],
 			);
 
-			// AI 自动打开（001 决策 5）：新到达的 create/open 结果自动展开悬浮面板；
-			// 首次挂载只登记不打开（刷新后面板保持收起，003 实测行为）。
+			// AI 自动打开：create/open 代表用户明确的「创建 / 打开 / 查看」意图。
+			// 无论面板当前是否收起，都展开并切到这次意图对应的文档；首次挂载的
+			// 历史快照也照常显示最近一次打开的脑图，避免出现「AI 说已打开但面板没了」。
 			const seen = react.useRef(null);
 			react.useEffect(() => {
-				const ids = new Set(merged.order.map((p) => merged.byPath[p].callId));
-				if (seen.current === null) {
-					seen.current = ids;
-					return;
-				}
-				let shouldOpen = false;
-				for (const p of merged.order) {
-					const d = merged.byPath[p];
-					if (OPENING_OPS.has(d.op) && !seen.current.has(d.callId)) shouldOpen = true;
-				}
-				seen.current = ids;
-				if (shouldOpen) {
+				const targetPath = autoOpenTarget(merged, seen.current);
+				seen.current = openingEventKeys(merged);
+				if (targetPath) {
 					onOpen();
-					// 单脑图模式：新打开的脑图顶替旧视图（001 场景 1「一句开脑图」）。
 					setHiddenPath(null);
-					setCurrentPath(null);
+					setCurrentPath(targetPath);
 					setView("mindmap");
 				}
 			}, [merged]);
@@ -1644,6 +1720,8 @@ window.__ModuleLoader__.load({
 			parseMarkdownToTree,
 			reduceDocuments,
 			mergeDocuments,
+			autoOpenTarget,
+			openingEventKeys,
 			resultTextOfBlocks,
 			stemOf,
 			buildExportSvg,

package/index.js

@@ -52,6 +52,7 @@ Tools:
 Markdown mapping (the panel's parser): headings nest by level (H1 are root children, H2 under the previous H1, ...); list items are child nodes nested by 2-space indentation; an EMPTY list item ("- " followed by nothing) renders as a placeholder node — use placeholders for planned-but-unwritten nodes; a fenced code block becomes a leaf node titled "[lang] first line"; plain paragraphs become the note text of the nearest heading.
 
 Behavior rules:
+- When the user asks to create a mindmap, call mindmap_create. When the user asks to open, view, show, or switch to an existing mindmap, call mindmap_open (do not use mindmap_get alone). Both operations bring that document to the visible mindmap panel automatically.
 - Always mindmap_get before editing, then send the complete updated document to mindmap_update. One tool call per step so the panel follows along live.
 - Never delete the whole document or restructure it without an explicit user request. Make the smallest change that answers the request.
 - When the user steps away or pauses (e.g. "我去买咖啡"), stop all mindmap edits immediately and wait — never continue autonomously.

package/package.json

@@ -1,13 +1,26 @@
 {
   "name": "dsh-mindmap",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Mindmap plugin for DeepSeek Harness: a plain markdown file in the working directory IS the mindmap; the chat edits it step by step and the right-side panel follows live.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guhanfei-ai/dsh-mindmap.git"
+  },
+  "homepage": "https://github.com/guhanfei-ai/dsh-mindmap#readme",
+  "bugs": {
+    "url": "https://github.com/guhanfei-ai/dsh-mindmap/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "main": "index.js",
   "scripts": {
-    "check": "node --check index.js && node --check client.js && node --check test/index.test.js && node --check test/client.test.js",
+    "build:client": "node scripts/build-client.mjs",
+    "check": "npm run build:client && node --check index.js && node --check client.js && node --check scripts/build-client.mjs && node --check test/index.test.js && node --check test/client.test.js",
     "test": "node --test",
-    "verify": "npm run check && npm test"
+    "verify": "npm run check && npm test",
+    "prepack": "npm run verify"
   },
   "files": [
     "index.js",