dsh-mindmap 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ 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.
+
 ## [0.1.0] - 2026-08-23
 
 First release of dsh-mindmap: a plain Markdown file in the session working directory becomes a live mindmap.

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

@@ -35,6 +35,39 @@ window.__ModuleLoader__.load({
 
 		const EMPTY_NODES = [];
 
+		// 015 节点颜色主题（三风格：海洋蓝 / 落日橙 / 森林绿）。
+		// 根盒用主题色淡底 + 半透明描边；标题节点文字用主题主色；背景永远跟随全局。
+		const COLOR_THEMES = {
+			ocean: { rootBg: "rgba(59,91,219,0.10)", rootBorder: "rgba(59,91,219,0.45)", heading: "#3b5bdb" },
+			sunset: { rootBg: "rgba(232,110,52,0.10)", rootBorder: "rgba(232,110,52,0.45)", heading: "#d96b2a" },
+			forest: { rootBg: "rgba(42,157,104,0.10)", rootBorder: "rgba(42,157,104,0.45)", heading: "#2a9d68" },
+		};
+		/** 颜色主题名 → 色值令牌（未知名回落海洋蓝）。 */
+		function colorThemeTokens(name) {
+			return COLOR_THEMES[name] || COLOR_THEMES.ocean;
+		}
+
+		// 015 设置变更总线：设置面板保存成功后 bump；脑图面板订阅 stamp 重读主题。
+		// 面板组件常驻不卸载，open 不变时不会自行重读——靠总线驱动
+		// （闭包实现，不依赖 this）。
+		const settingsBus = (() => {
+			let stamp = 0;
+			const listeners = new Set();
+			return {
+				get: () => stamp,
+				bump() {
+					stamp += 1;
+					for (const fn of listeners) fn(stamp);
+				},
+				subscribe(fn) {
+					listeners.add(fn);
+					return () => {
+						listeners.delete(fn);
+					};
+				},
+			};
+		})();
+
 		//#region markdown → 脑图树（零依赖手写解析）
 		/** 规范化节点内容用于稳定 ID：折叠空白、截断到 60 字符（MarkGrove 同款）。 */
 		function normalizeForId(text) {
@@ -248,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 };
 		}
 
 		/**
@@ -304,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
 
@@ -496,6 +614,25 @@ window.__ModuleLoader__.load({
 			treeError: { color: "var(--dsw-alias-label-error)", fontSize: "12px", lineHeight: 1.6, margin: "0" },
 			treeMenu: { position: "fixed", zIndex: 60, minWidth: "210px", background: "var(--dsw-alias-bg-layer-3)", border: "1px solid var(--dsw-alias-border-l2)", borderRadius: "10px", padding: "6px", boxShadow: "var(--dsw-shadow-lv2)" },
 			treeMenuItem: { display: "block", width: "100%", boxSizing: "border-box", textAlign: "left", border: "none", background: "none", cursor: "pointer", padding: "7px 12px", borderRadius: "8px", font: "inherit", fontSize: "13px", color: "var(--dsw-alias-label-primary)" },
+			// 015 设置面板（settings.section 页面内容）。
+			settingsWrap: { display: "flex", flexDirection: "column", gap: "12px", padding: "16px", maxWidth: "480px" },
+			settingsGroup: { display: "flex", flexDirection: "column", gap: "14px", border: "1px solid var(--dsw-alias-border-l2)", borderRadius: "12px", padding: "14px", background: "var(--dsw-alias-bg-layer-3)" },
+			settingsGroupTitle: { fontSize: "13px", fontWeight: 600, color: "var(--dsw-alias-label-primary)", margin: "4px 0 0" },
+			settingsRow: { display: "flex", alignItems: "center", gap: "12px", fontSize: "13px", color: "var(--dsw-alias-label-primary)" },
+			settingsLabel: { flex: "1 1 auto", minWidth: 0, color: "var(--dsw-alias-label-secondary)" },
+			settingsInput: { width: "72px", padding: "4px 8px", borderRadius: "6px", border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-base)", color: "var(--dsw-alias-label-primary)", font: "inherit", fontSize: "13px" },
+			settingsHint: { color: "var(--dsw-alias-label-tertiary)", fontSize: "12px", lineHeight: 1.6, margin: "0" },
+			settingsNotice: { color: "var(--dsw-alias-state-success-primary, #1a7f37)", fontSize: "12px", margin: "0" },
+			settingsError: { color: "var(--dsw-alias-label-error)", fontSize: "12px", lineHeight: 1.6, margin: "0" },
+			// 分段选择控件（线型/卡片风格）
+			segmentRow: { display: "inline-flex", gap: "4px", padding: "3px", borderRadius: "8px", background: "var(--dsw-alias-bg-base)", border: "1px solid var(--dsw-alias-border-l2)" },
+			segmentBtn: { border: "none", background: "none", cursor: "pointer", font: "inherit", fontSize: "12px", padding: "3px 12px", borderRadius: "6px", color: "var(--dsw-alias-label-secondary)", lineHeight: "18px" },
+			segmentBtnActive: { background: "var(--dsw-alias-bg-layer-3)", color: "var(--dsw-alias-label-primary)", boxShadow: "0 1px 2px rgba(16,24,40,0.08)" },
+			// 颜色主题色板
+			swatchRow: { display: "flex", gap: "6px", flex: "1 1 auto", justifyContent: "flex-end" },
+			swatchBtn: { display: "inline-flex", alignItems: "center", gap: "6px", border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-base)", cursor: "pointer", font: "inherit", fontSize: "12px", padding: "3px 10px", borderRadius: "8px", color: "var(--dsw-alias-label-secondary)", lineHeight: "18px" },
+			swatchActive: { borderColor: "var(--dsw-alias-state-business-primary)", color: "var(--dsw-alias-label-primary)", boxShadow: "inset 0 0 0 1px var(--dsw-alias-state-business-primary)" },
+			swatchDot: { width: "10px", height: "10px", borderRadius: "50%", flex: "none" },
 			row: { display: "flex", alignItems: "center", minWidth: 0 },
 			childrenColumn: { display: "flex", flexDirection: "column", gap: "8px", marginLeft: "40px", minWidth: 0 },
 			// 面板树连线层：正交折线（MarkGrove 的 orthogonalPath 风格），
@@ -508,6 +645,155 @@ window.__ModuleLoader__.load({
 			codeBox: { fontFamily: "Menlo, monospace", fontSize: "12px" },
 		};
 
+		/** 015 分段选择控件（线型/卡片风格）。 */
+		function Segmented(props) {
+			const { options, value, onChange, disabled } = props;
+			return (0, react_jsx_runtime.jsx)("div", { style: S.segmentRow, children: options.map((opt) => (0, react_jsx_runtime.jsx)("button", {
+				key: opt.value,
+				type: "button",
+				style: value === opt.value ? { ...S.segmentBtn, ...S.segmentBtnActive } : S.segmentBtn,
+				disabled,
+				onClick: () => onChange(opt.value),
+				children: opt.label,
+			}, opt.value)) });
+		}
+
+		/**
+		 * 015 设置面板（settings.section 页面，root scope）：读写 host 的
+		 * settings namespace "mindmap"。节点主题三件套（线/卡片/颜色）+ 面板宽度；
+		 * requireApproval 按作者要求隐藏（功能保留，经 config/API 仍可设）。
+		 */
+		function SettingsPanel(props) {
+			const { mindmapFace } = props;
+			const [value, setValue] = react.useState(null);
+			const [saving, setSaving] = react.useState(false);
+			const [notice, setNotice] = react.useState("");
+			const [error, setError] = react.useState("");
+
+			react.useEffect(() => {
+				let alive = true;
+				(async () => {
+					try {
+						const v = mindmapFace && typeof mindmapFace.readSettings === "function" ? await mindmapFace.readSettings() : null;
+						if (!alive) return;
+						if (v === null) setError("设置服务不可用：settings namespace 未注册或 connection 缺失");
+						setValue({
+							lineStyle: v && v.lineStyle === "curve" ? "curve" : "elbow",
+							cardStyle: v && v.cardStyle === "square" ? "square" : "rounded",
+							colorTheme: v && COLOR_THEMES[v.colorTheme] ? v.colorTheme : "ocean",
+							defaultPanelWidth: v && typeof v.defaultPanelWidth === "number" ? v.defaultPanelWidth : 42,
+						});
+					} catch (err) {
+						if (alive) setError(String(err?.message ?? err));
+					}
+				})();
+				return () => {
+					alive = false;
+				};
+			}, [mindmapFace]);
+
+			async function save(patch) {
+				setSaving(true);
+				setError("");
+				setNotice("");
+				try {
+					if (!mindmapFace || typeof mindmapFace.updateSettings !== "function") throw new Error("settings service unavailable");
+					await mindmapFace.updateSettings(patch);
+					settingsBus.bump(); // 通知脑图面板重读主题（面板常驻，open 不变）
+					setNotice("已保存");
+				} catch (err) {
+					setError(String(err?.message ?? err));
+				} finally {
+					setSaving(false);
+				}
+			}
+
+			if (value === null) {
+				return (0, react_jsx_runtime.jsx)("div", { style: S.settingsWrap, children: error
+					? (0, react_jsx_runtime.jsx)("p", { style: S.settingsError, children: error })
+					: (0, react_jsx_runtime.jsx)("p", { style: S.settingsHint, children: "正在读取设置…" }) });
+			}
+
+			const setField = (patch) => {
+				setValue({ ...value, ...patch });
+				save(patch);
+			};
+			const changeWidth = (e) => {
+				const raw = Number(e.target.value);
+				const next = Number.isFinite(raw) ? Math.min(80, Math.max(20, Math.round(raw))) : value.defaultPanelWidth;
+				setValue({ ...value, defaultPanelWidth: next });
+			};
+			const commitWidth = () => {
+				save({ defaultPanelWidth: value.defaultPanelWidth });
+			};
+
+			return (0, react_jsx_runtime.jsxs)("div", { style: S.settingsWrap, children: [
+				(0, react_jsx_runtime.jsx)("p", { style: S.settingsGroupTitle, children: "节点主题" }),
+				(0, react_jsx_runtime.jsxs)("div", { style: S.settingsGroup, children: [
+					(0, react_jsx_runtime.jsxs)("div", { style: S.settingsRow, children: [
+						(0, react_jsx_runtime.jsx)("span", { style: S.settingsLabel, children: "线" }),
+						(0, react_jsx_runtime.jsx)(Segmented, {
+							options: [{ value: "elbow", label: "折线" }, { value: "curve", label: "曲线" }],
+							value: value.lineStyle,
+							disabled: saving,
+							onChange: (v) => setField({ lineStyle: v }),
+						}),
+					] }),
+					(0, react_jsx_runtime.jsxs)("div", { style: S.settingsRow, children: [
+						(0, react_jsx_runtime.jsx)("span", { style: S.settingsLabel, children: "卡片" }),
+						(0, react_jsx_runtime.jsx)(Segmented, {
+							options: [{ value: "rounded", label: "圆角" }, { value: "square", label: "直角" }],
+							value: value.cardStyle,
+							disabled: saving,
+							onChange: (v) => setField({ cardStyle: v }),
+						}),
+					] }),
+					(0, react_jsx_runtime.jsxs)("div", { style: S.settingsRow, children: [
+						(0, react_jsx_runtime.jsx)("span", { style: S.settingsLabel, children: "颜色" }),
+						(0, react_jsx_runtime.jsx)("div", { style: S.swatchRow, children: [
+							{ value: "ocean", label: "海洋蓝" },
+							{ value: "sunset", label: "落日橙" },
+							{ value: "forest", label: "森林绿" },
+						].map((t) => {
+							const tokens = colorThemeTokens(t.value);
+							return (0, react_jsx_runtime.jsxs)("button", {
+								key: t.value,
+								type: "button",
+								style: value.colorTheme === t.value ? { ...S.swatchBtn, ...S.swatchActive } : S.swatchBtn,
+								disabled: saving,
+								onClick: () => setField({ colorTheme: t.value }),
+								children: [
+									(0, react_jsx_runtime.jsx)("span", { style: { ...S.swatchDot, background: tokens.heading } }),
+									t.label,
+								],
+							}, t.value);
+						}) }),
+					] }),
+				] }),
+				(0, react_jsx_runtime.jsx)("p", { style: S.settingsHint, children: "主题改动在脑图面板下次打开时生效；背景色始终跟随全局主题。" }),
+				(0, react_jsx_runtime.jsx)("p", { style: S.settingsGroupTitle, children: "面板" }),
+				(0, react_jsx_runtime.jsxs)("div", { style: S.settingsGroup, children: [
+					(0, react_jsx_runtime.jsxs)("div", { style: S.settingsRow, children: [
+						(0, react_jsx_runtime.jsx)("span", { style: S.settingsLabel, children: "默认宽度（%）" }),
+						(0, react_jsx_runtime.jsx)("input", {
+							type: "number",
+							min: 20,
+							max: 80,
+							value: value.defaultPanelWidth,
+							disabled: saving,
+							onChange: changeWidth,
+							onBlur: commitWidth,
+							style: S.settingsInput,
+						}),
+					] }),
+					(0, react_jsx_runtime.jsx)("p", { style: S.settingsHint, children: "范围 20~80。拖拽面板后的宽度会记住（localStorage）；清除本地记忆后回到这里配置的默认值。" }),
+				] }),
+				saving ? (0, react_jsx_runtime.jsx)("p", { style: S.settingsHint, children: "保存中…" }) : null,
+				notice ? (0, react_jsx_runtime.jsx)("p", { style: S.settingsNotice, children: notice }) : null,
+				error ? (0, react_jsx_runtime.jsx)("p", { style: S.settingsError, children: error }) : null,
+			] });
+		}
+
 		/**
 		 * 「思维脑图」槽位组件（014）：同一槽位渲染 M 按钮 + 悬浮面板宿主层。
 		 * session scope 的 useSession/sessionId/inputActions 直给，经 props 传给
@@ -560,16 +846,19 @@ window.__ModuleLoader__.load({
 		}
 
 		function NodeBox(props) {
-			const { node } = props;
+			const { node, theme } = props;
+			// 015 节点主题：卡片圆角（圆角/直角）+ 颜色主题令牌（根盒/标题用主题色）。
+			const tokens = colorThemeTokens(theme && theme.colorTheme);
+			const radius = theme && theme.cardStyle === "square" ? 0 : 10;
 			const style = node.kind === "root"
-				? { ...S.box, ...S.rootBox }
+				? { ...S.box, ...S.rootBox, borderRadius: radius, borderColor: tokens.rootBorder, background: tokens.rootBg }
 				: node.kind === "heading"
-					? { ...S.box, ...S.headingBox }
+					? { ...S.box, ...S.headingBox, borderRadius: radius, color: tokens.heading }
 					: node.kind === "placeholder"
-						? { ...S.placeholderBox }
+						? { ...S.placeholderBox, borderRadius: radius }
 						: node.kind === "code"
-							? { ...S.box, ...S.codeBox }
-							: S.box;
+							? { ...S.box, ...S.codeBox, borderRadius: radius }
+							: { ...S.box, borderRadius: radius };
 			const title = node.data?.description
 				? `${node.topic}\n\n${node.data.description}`
 				: node.data?.code
@@ -578,21 +867,23 @@ window.__ModuleLoader__.load({
 			return (0, react_jsx_runtime.jsx)("div", { style, title, children: node.kind === "placeholder" ? "待填写" : node.topic });
 		}
 
-		/** 左→右递归树：节点盒 + 右侧子节点列 + 正交折线连线层（MarkGrove 风格）。 */
+		/** 左→右递归树：节点盒 + 右侧子节点列 + 连线层（015 支持折线/曲线两种线型）。 */
 		function TreeRow(props) {
-			const { node } = props;
+			const { node, theme } = props;
 			const rowRef = react.useRef(null);
 			const boxWrapRef = react.useRef(null);
 			const childRefs = react.useRef([]);
 			const [edges, setEdges] = react.useState([]);
 			const prevEdgesRef = react.useRef("");
 
-			// 测量父盒右缘与各子节点包裹块的几何位置，画直角折线
-			// （M x1 y1 H midX V y2 H x2）；序列化比对防 setState 循环。
+			// 测量父盒右缘与各子节点包裹块的几何位置，画连线
+			// （折线 = M x1 y1 H midX V y2 H x2；曲线 = 贝塞尔水平切出）；
+			// 序列化比对防 setState 循环。
 			react.useLayoutEffect(() => {
 				const rowEl = rowRef.current;
 				const boxEl = boxWrapRef.current;
 				if (!rowEl || !boxEl) return;
+				const curve = theme && theme.lineStyle === "curve";
 				const measure = () => {
 					const rowRect = rowEl.getBoundingClientRect();
 					const boxRect = boxEl.getBoundingClientRect();
@@ -605,7 +896,9 @@ window.__ModuleLoader__.load({
 						const x2 = c.left - rowRect.left;
 						const y2 = c.top - rowRect.top + c.height / 2;
 						const midX = (x1 + x2) / 2;
-						next.push(`M ${x1} ${y1} H ${midX} V ${y2} H ${x2}`);
+						next.push(curve
+							? `M ${x1} ${y1} C ${midX} ${y1}, ${midX} ${y2}, ${x2} ${y2}`
+							: `M ${x1} ${y1} H ${midX} V ${y2} H ${x2}`);
 					}
 					const key = next.join("|");
 					if (prevEdgesRef.current === key) return;
@@ -639,14 +932,14 @@ window.__ModuleLoader__.load({
 						}, i)),
 					})
 					: null,
-				(0, react_jsx_runtime.jsx)("div", { ref: boxWrapRef, style: { flex: "0 0 auto" }, children: (0, react_jsx_runtime.jsx)(NodeBox, { node }) }),
+				(0, react_jsx_runtime.jsx)("div", { ref: boxWrapRef, style: { flex: "0 0 auto" }, children: (0, react_jsx_runtime.jsx)(NodeBox, { node, theme }) }),
 				node.children && node.children.length > 0
 					? (0, react_jsx_runtime.jsx)("div", { style: S.childrenColumn, children: node.children.map((child, idx) => (0, react_jsx_runtime.jsx)("div", {
 						key: child.id,
 						ref: (el) => {
 							childRefs.current[idx] = el;
 						},
-						children: (0, react_jsx_runtime.jsx)(TreeRow, { node: child }),
+						children: (0, react_jsx_runtime.jsx)(TreeRow, { node: child, theme }),
 					}, child.id)) })
 					: null,
 			] });
@@ -678,6 +971,43 @@ window.__ModuleLoader__.load({
 					setPanelWidth(Math.round(window.innerWidth * 0.8));
 				}
 			}, []);
+			// 015 设置面板：没有本地拖拽记忆时，用 settings 里的默认宽度。
+			react.useEffect(() => {
+				let hasLocal = false;
+				try {
+					hasLocal = localStorage.getItem(WIDTH_KEY) !== null;
+				} catch {
+					// 忽略
+				}
+				if (hasLocal) return;
+				if (!mindmapFace || typeof mindmapFace.readSettings !== "function") return;
+				mindmapFace.readSettings().then((v) => {
+					const pct = v && typeof v.defaultPanelWidth === "number" ? Math.min(80, Math.max(20, v.defaultPanelWidth)) : 42;
+					const px = Math.round(window.innerWidth * pct / 100);
+					setPanelWidth((prev) => (Math.abs(prev - px) < 2 ? prev : px));
+				}).catch(() => {
+					// 读设置失败：保持 42% 默认
+				});
+			}, [mindmapFace]);
+
+			// 015 节点主题：面板每次打开、或设置总线 bump（设置页保存）时重读
+			// settings——面板常驻不卸载，光靠 open 变化会漏掉「开着面板改设置」。
+			const settingsStamp = react.useSyncExternalStore(settingsBus.subscribe, settingsBus.get);
+			const [theme, setTheme] = react.useState({ lineStyle: "elbow", cardStyle: "rounded", colorTheme: "ocean" });
+			react.useEffect(() => {
+				if (!open) return;
+				if (!mindmapFace || typeof mindmapFace.readSettings !== "function") return;
+				mindmapFace.readSettings().then((v) => {
+					if (!v) return;
+					setTheme({
+						lineStyle: v.lineStyle === "curve" ? "curve" : "elbow",
+						cardStyle: v.cardStyle === "square" ? "square" : "rounded",
+						colorTheme: COLOR_THEMES[v.colorTheme] ? v.colorTheme : "ocean",
+					});
+				}).catch(() => {
+					// 读设置失败：保持当前主题
+				});
+			}, [open, settingsStamp, mindmapFace]);
 			const dragStateRef = react.useRef(null);
 			function startResize(e) {
 				e.preventDefault();
@@ -783,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]);
@@ -1290,7 +1611,7 @@ window.__ModuleLoader__.load({
 					: (doc && doc.op === "local")
 						? renderLoading()
 						: tree
-							? (0, react_jsx_runtime.jsx)(TreeRow, { node: tree })
+							? (0, react_jsx_runtime.jsx)(TreeRow, { node: tree, theme })
 							: renderTree() }),
 				tabMenu ? (0, react_jsx_runtime.jsxs)("div", {
 					style: { ...S.treeMenu, left: tabMenu.x, top: tabMenu.y },
@@ -1317,16 +1638,17 @@ window.__ModuleLoader__.load({
 
 			// 014「布局让位」CSS（better-sidebar 同款机制）：面板打开时给 #root 挂
 			// margin-right + 宽度挤压，把聊天区推到左边、面板占右侧腾出的空间，
-			// 互不遮挡。用插件自己的变量 --dsh-mindmap-width，避免与它家
-			// --dsh-sidebar-width 冲突（同属性同优先级时后注入者胜，双开插件并存
-			// 属已知边界，见 docs/014）。
+			// 互不遮挡。015 修复级联冲突：它家（dsh-better-sidebar）同样注入
+			// #root 规则，后注入者胜导致我们的推挤被压掉——我们的规则加
+			// !important 且把双方变量相加（它开面板时聊天同样让位），无论注入
+			// 顺序如何都稳定生效。若它家未来也用 !important，需再评估（见 docs/014）。
 			if (typeof document !== "undefined") {
 				const style = document.createElement("style");
 				style.setAttribute("data-dsh-mindmap", "layout-push");
 				style.textContent = [
 					"#root{",
-					"margin-right:var(--dsh-mindmap-width,0px);",
-					"width:calc(100% - var(--dsh-mindmap-width,0px));",
+					"margin-right:calc(var(--dsh-mindmap-width,0px) + var(--dsh-sidebar-width,0px))!important;",
+					"width:calc(100% - var(--dsh-mindmap-width,0px) - var(--dsh-sidebar-width,0px))!important;",
 					"transition:margin-right var(--ds-transition-duration-slow) var(--ds-ease-in-out),width var(--ds-transition-duration-slow) var(--ds-ease-in-out);",
 					"}",
 				].join("");
@@ -1349,6 +1671,35 @@ window.__ModuleLoader__.load({
 				return parsed.value;
 			};
 
+			// 015 设置面板：settings namespace（dsh-grafana 同款读写面）。
+			// connection 走 ctx.get 可选查取（动态 ctx 契约）；缺失时设置面板降级提示。
+			const connection = ctx.get("connection");
+			const settingsApi = connection && typeof connection.api === "object" ? connection.api : null;
+			face.readSettings = async () => {
+				if (!settingsApi || typeof settingsApi.settings?.describe !== "function") return null;
+				const res = await settingsApi.settings.describe({});
+				const namespaces = res?.result?.value?.namespaces ?? [];
+				const ns = namespaces.find((n) => n?.ns === "mindmap");
+				return ns?.value ?? null;
+			};
+			face.updateSettings = async (patch) => {
+				if (!settingsApi || typeof settingsApi.settings?.update !== "function") {
+					throw new Error("settings service unavailable");
+				}
+				await settingsApi.settings.update({ ns: "mindmap", patch });
+			};
+
+			// 015 设置面板：settings.section（list 槽、root scope）——设置页左栏
+			// 新增「思维脑图」导航项（better-sidebar 同款入口；dsh-grafana 的
+			// settings.plugin.item 卡片是另一条路，未采用）。
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: "dsh-mindmap",
+				order: 100,
+				label: "思维脑图",
+				inject: () => ({ mindmapFace: face }),
+			}, SettingsPanel));
+
 			// 014 overlay 形态（作者拍板，见 docs/014）：面板宿主层（position:fixed）
 			// 与 M 按钮一起渲染在 conversation.session.header.actions 槽位里——
 			// better-sidebar 同款「fixed 宿主层自举」思路（它的宿主层挂在
@@ -1369,12 +1720,15 @@ window.__ModuleLoader__.load({
 			parseMarkdownToTree,
 			reduceDocuments,
 			mergeDocuments,
+			autoOpenTarget,
+			openingEventKeys,
 			resultTextOfBlocks,
 			stemOf,
 			buildExportSvg,
 			createIdFactory,
 			relPathWithin,
 			visibleTreeRows,
+			colorThemeTokens,
 			TOOL_NAMES,
 			OPENING_OPS,
 		});

package/index.js

@@ -10,16 +10,29 @@
 // - 结果 JSON {ok, op, path, rootTitle, content, renamedFrom?}：content 全文
 //   供模型续编辑，client 用同一份重放面板（工具结果即实时通道，002 第二节）。
 // - requireApproval 配置（决策 6）：默认 false 免审批；置 true 时 mindmap_update
-//   走原生 ask（tools/pre-execute，照 dsh-grafana 的钩子模式）。配置经 bundle
-//   patch 的 config 覆盖传入 apply(ctx, config)。
-// - 无任何 npm 依赖（不用 @deepseek-ai/dsh-tools：link 安装不解析 peer，
-//   见 003 偏差 1），参数 schema 手写 JSON Schema。
+//   走原生 ask（tools/pre-execute，照 dsh-grafana 的钩子模式）。015 起经 settings
+//   namespace 可在设置面板运行时切换（见 SETTINGS_NAMESPACE/Config）。
+// - 依赖：仅 @deepseek-ai/schemastery（settings schema；发布包正常解析，
+//   link 开发需先 npm i）。工具参数 schema 仍手写 JSON Schema（003 偏差 1）。
 import { access, opendir, readFile, rename, writeFile } from 'node:fs/promises'
 import { dirname, isAbsolute, join, relative, resolve as resolvePath } from 'node:path'
+import Schema from '@deepseek-ai/schemastery'
 
 export const name = 'mindmap'
 export const inject = ['tools', 'systemPrompt', 'webServer', 'sessions']
 
+// 015 设置面板：settings namespace（dsh-grafana 同款模式）。
+// requireApproval 在 pre-execute 时读当前值（运行时切换即时生效）；
+// defaultPanelWidth 供客户端面板取默认宽度（20-80 钳制由客户端执行）。
+export const SETTINGS_NAMESPACE = 'mindmap'
+export const Config = Schema.object({
+  requireApproval: Schema.boolean().default(false).description('Require native DSH approval for every mindmap_update (including renameRoot). Files are git-managed, so it defaults to off. Hidden from the settings panel; still honored at runtime.'),
+  defaultPanelWidth: Schema.number().default(42).description('Default floating-panel width as a percentage of the viewport (clamped 20-80 on the client).'),
+  lineStyle: Schema.union(['curve', 'elbow']).default('elbow').description('Connector line style between nodes: curve (bezier) or elbow (orthogonal).'),
+  cardStyle: Schema.union(['rounded', 'square']).default('rounded').description('Node card corner style.'),
+  colorTheme: Schema.union(['ocean', 'sunset', 'forest']).default('ocean').description('Node color theme.'),
+})
+
 const MAX_CONTENT_BYTES = 2 * 1024 * 1024
 const MAX_NAME_CHARS = 80
 const TOOL_TIMEOUT_MS = 15_000
@@ -39,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.
@@ -224,25 +238,38 @@ function defineTool(spec) {
 }
 
 export function apply(ctx, config = {}) {
-  const requireApproval = config.requireApproval === true
-  ctx.systemPrompt.section({ name: 'tool:mindmap', order: 106, text: GUIDANCE })
+  const entryConfig = { requireApproval: config.requireApproval === true, defaultPanelWidth: 42 }
 
-  if (requireApproval) {
-    // 后悔药开关（决策 6）：默认免审批打断「人一句、AI 一步」的节奏；开启后
-    // mindmap_update（含 renameRoot）走原生用户审批，读操作不拦。
-    ctx.on('tools/pre-execute', async (exec, next) => {
-      const decision = await next()
-      if (decision.kind !== 'allow') return decision
-      if (exec.name !== 'mindmap_update') return decision
-      const args = exec.arguments ?? {}
-      const renameNote = typeof args.renameRoot === 'string' && args.renameRoot ? `, rename root to "${args.renameRoot}"` : ''
-      const bytes = typeof args.content === 'string' ? byteLength(args.content) : 0
-      return {
-        kind: 'ask',
-        reason: `Write mindmap ${JSON.stringify(String(args.path ?? '?'))} (${bytes} bytes${renameNote}). dsh-mindmap is configured with requireApproval.`,
-      }
+  // 015 设置面板：settings 服务可用时以命名空间解析值为准
+  // （schema 默认 → 组合层 base → 用户设置层），否则回退入口配置
+  // （dsh-grafana 同款模式；link 环境缺 schemastery 时见 003 偏差 1 的
+  // 依赖说明——发布包正常安装依赖）。
+  let activeConfig = () => entryConfig
+  ctx.inject(['settings'], (sctx) => {
+    const scope = sctx.settings.register(SETTINGS_NAMESPACE, Config, { base: entryConfig })
+    activeConfig = () => scope.get()
+    sctx.effect(() => () => {
+      activeConfig = () => entryConfig
     })
-  }
+  })
+
+  ctx.systemPrompt.section({ name: 'tool:mindmap', order: 106, text: GUIDANCE })
+
+  // 后悔药开关（决策 6）：钩子常驻注册，运行时读 activeConfig().requireApproval
+  // ——设置面板切换立即生效；关闭时直接放行（默认 false 免审批）。
+  ctx.on('tools/pre-execute', async (exec, next) => {
+    const decision = await next()
+    if (decision.kind !== 'allow') return decision
+    if (!activeConfig().requireApproval) return decision
+    if (exec.name !== 'mindmap_update') return decision
+    const args = exec.arguments ?? {}
+    const renameNote = typeof args.renameRoot === 'string' && args.renameRoot ? `, rename root to "${args.renameRoot}"` : ''
+    const bytes = typeof args.content === 'string' ? byteLength(args.content) : 0
+    return {
+      kind: 'ask',
+      reason: `Write mindmap ${JSON.stringify(String(args.path ?? '?'))} (${bytes} bytes${renameNote}). dsh-mindmap is configured with requireApproval.`,
+    }
+  })
 
   ctx.tools.register(defineTool({
     name: 'mindmap_create',

package/package.json

@@ -1,13 +1,26 @@
 {
   "name": "dsh-mindmap",
-  "version": "0.1.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",
@@ -17,6 +30,9 @@
     "README.zh-CN.md",
     "CHANGELOG.md"
   ],
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.0"
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"