dsh-obsidian-notes 0.5.2 → 0.6.0

package/lib/client.js

@@ -85,10 +85,14 @@ window.__ModuleLoader__.load({
 		    return null;
 		  }
 
-		  // ── 行内解析（code > img > embed > link > wikilink > strong > em，取最左匹配）──
+		  // ── 行内解析（escape > code > img > embed > link > wikilink > strong > emph >
+		  //    strike > highlight > comment > autolink > barelink，取最左匹配；
+		  //    同一位置按数组顺序）──
 		  // M7：双链/embed 分开捕获 target（m[1]）、章节（m[2]）、别名（m[3]），
 		  // 显示时别名优先、其次「target › 章节」，偏移各自映射到源码切片。
 		  const INLINE_PATTERNS = [
+		    // 反斜杠转义：`\*` 等只显示被转义的字符本身（偏移只覆盖该字符，不含反斜杠）
+		    ["escape", /\\([\\`*_{}\[\]()#+\-.!|>~=])/],
 		    ["code", /`([^`\n]+)`/],
 		    ["img", /!\[([^\]]*)\]\(([^)\s]+)\)/],
 		    ["embed", /!\[\[([^\]|#\n]*)(?:#([^\]|\n]*))?(?:\|([^\]\n]*))?\]\]/],
@@ -96,6 +100,13 @@ window.__ModuleLoader__.load({
 		    ["wiki", /\[\[([^\]|#\n]*)(?:#([^\]|\n]*))?(?:\|([^\]\n]*))?\]\]/],
 		    ["strong", /\*\*([^*\n]+)\*\*|__([^_\n]+)__/],
 		    ["em", /(^|[^*])\*([^*\n]+)\*(?!\*)|(^|[^_])_([^_\n]+)_(?!_)/],
+		    ["strike", /~~([^~\n]+)~~/],
+		    ["highlight", /==([^=\n]+)==/],
+		    // Obsidian 注释 %%…%%：预览里不显示（单行；跨行注释留到 P2 block 阶段）
+		    ["comment", /%%([^%\n]*)%%/],
+		    ["autolink", /<(https?:[^\s<>]+)>/],
+		    // 裸 URL：只吃 ASCII URL 字符，中文正文/中文标点自然截断（尾部标点下面再收一次）
+		    ["barelink", /https?:\/\/[A-Za-z0-9\-._~:/?#@!$&'*+,;=%]+/],
 		  ];
 		  const patternIndex = (name) => INLINE_PATTERNS.findIndex((p) => p[0] === name);
 
@@ -201,21 +212,39 @@ window.__ModuleLoader__.load({
 		      if (m.index > 0) pushText(rest.slice(0, m.index));
 
 		      const contentLen = (() => {
-		        if (name === "code") return m[1].length;
-		        if (name === "img") return 0;                       // alt 不渲染为可选中文本
-		        if (name === "embed") return m[0].length;           // 按钮/图占整个 ![[...]] 源码
-		        if (name === "link" || name === "wiki") return m[1].length;
-		        if (name === "strong") return (m[1] ?? m[2]).length;
-		        return (m[2] ?? m[4]).length;                       // em（m[0] 含前缀组）
+		        switch (name) {
+		          case "code": return m[1].length;
+		          case "img": return 0;                       // alt 不渲染为可选中文本
+		          case "embed": return m[0].length;           // 按钮/图占整个 ![[...]] 源码
+		          case "link":
+		          case "wiki": return m[1].length;
+		          case "strong": return (m[1] ?? m[2]).length;
+		          case "em": return (m[2] ?? m[4]).length;    // em（m[0] 含前缀组）
+		          case "escape": return 1;                    // 只显示被转义的那一个字符
+		          case "strike":
+		          case "highlight": return m[1].length;
+		          case "comment": return m[1].length;
+		          case "autolink": return m[1].length;
+		          case "barelink": return m[0].length;
+		          default: return 0;
+		        }
 		      })();
 		      const openLen = (() => {
-		        if (name === "code") return 1;                      // `
-		        if (name === "link") return 1;                      // [
-		        if (name === "wiki") return 2;                      // [[
-		        if (name === "embed") return 0;                     // 以整段 ![[...]] 作为可选中源码
-		        if (name === "strong") return 2;                    // ** 或 __
-		        if (name === "em") return m[0].length - contentLen - 1; // 前缀 + *
-		        return 0;
+		        switch (name) {
+		          case "code": return 1;                      // `
+		          case "link": return 1;                      // [
+		          case "wiki": return 2;                      // [[
+		          case "embed": return 0;                     // 以整段 ![[...]] 作为可选中源码
+		          case "strong": return 2;                    // ** 或 __
+		          case "em": return m[0].length - contentLen - 1; // 前缀 + *
+		          case "escape": return 1;                    // 反斜杠
+		          case "strike":
+		          case "highlight": return 2;                 // ~~ 或 ==
+		          case "comment": return 2;                   // %%
+		          case "autolink": return 1;                  // <
+		          case "barelink": return 0;
+		          default: return 0;
+		        }
 		      })();
 		      const bodyStart = cur + openLen;                      // cur 已含 m.index
 
@@ -288,6 +317,63 @@ window.__ModuleLoader__.load({
 		          },
 		          wikilinkDisplayNodes(parts, m, cur, key, handlers),
 		        ));
+		      } else if (name === "escape") {
+		        // 反斜杠转义：只把被转义的字符渲染成文本（偏移只覆盖该字符，不含反斜杠）
+		        const n = textNode(m[1], bodyStart, bodyStart + 1, `${keyBase}-x${keyIndex++}`, handlers);
+		        if (n) nodes.push(n);
+		      } else if (name === "strike" || name === "highlight") {
+		        // ~~删除线~~ / ==高亮==：内容继续走行内解析（可嵌套粗体/链接/代码）
+		        nodes.push(createElement(
+		          name === "strike" ? "del" : "mark",
+		          {
+		            key: `${keyBase}-${name === "strike" ? "d" : "m"}${keyIndex++}`,
+		            ...(name === "highlight" ? { className: "dsh-obs-mark" } : {}),
+		          },
+		          renderInline(m[1], handlers, `${keyBase}-${name}`, bodyStart),
+		        ));
+		      } else if (name === "comment") {
+		        // Obsidian 的 %%注释%% 在预览里不显示：整段不产生节点（源码偏移留空，
+		        // 不影响其它片段的单调性；选中范围也不会把它带进提问内容）。
+		      } else if (name === "autolink") {
+		        // <https://…> → 链接；显示文本是尖括号里的 URL（偏移不含尖括号）
+		        const href = safeUrl(m[1]);
+		        if (href === null) {
+		          const n = textNode(m[0], cur, cur + m[0].length, `${keyBase}-al${keyIndex++}`, handlers);
+		          if (n) nodes.push(n);
+		        } else {
+		          nodes.push(createElement("a", {
+		            key: `${keyBase}-al${keyIndex++}`,
+		            href,
+		            target: "_blank",
+		            rel: "noreferrer",
+		            className: "dsh-obs-autolink",
+		          }, textNode(m[1], bodyStart, bodyStart + m[1].length, `${keyBase}-alt${keyIndex}`, handlers)));
+		        }
+		      } else if (name === "barelink") {
+		        // 裸 URL：尾部标点与不配对的右括号留给普通文本，不算进链接地址
+		        const raw = m[0];
+		        let url = raw;
+		        while (url.length > 0 && /[.,;:!?'"，。；：！？、]/.test(url[url.length - 1])) url = url.slice(0, -1);
+		        while (url.endsWith(")") && (url.match(/\(/g) ?? []).length < (url.match(/\)/g) ?? []).length) {
+		          url = url.slice(0, -1);
+		        }
+		        const href = safeUrl(url);
+		        if (href === null) {
+		          const n = textNode(raw, cur, cur + raw.length, `${keyBase}-bl${keyIndex++}`, handlers);
+		          if (n) nodes.push(n);
+		        } else {
+		          nodes.push(createElement("a", {
+		            key: `${keyBase}-bl${keyIndex++}`,
+		            href,
+		            target: "_blank",
+		            rel: "noreferrer",
+		            className: "dsh-obs-autolink",
+		          }, textNode(url, cur, cur + url.length, `${keyBase}-blt${keyIndex}`, handlers)));
+		          if (url.length < raw.length) {
+		            const n = textNode(raw.slice(url.length), cur + url.length, cur + raw.length, `${keyBase}-bltail${keyIndex}`, handlers);
+		            if (n) nodes.push(n);
+		          }
+		        }
 		      } else {
 		        const body = name === "strong" ? (m[1] ?? m[2]) : (m[2] ?? m[4]);
 		        nodes.push(createElement(
@@ -795,6 +881,8 @@ window.__ModuleLoader__.load({
 		      createElement("div", {
 		        key: `n${keyIdx++}`,
 		        className: `dsh-obs-md-row${rowClass ? ` ${rowClass}` : ""}`,
+		        // 源码行号（1 起）：思维导图「点节点跳到源码行」用它定位，测试不依赖
+		        "data-line": num,
 		        ...(extraProps ?? {}),
 		      },
 		        createElement("span", { className: "dsh-obs-md-ln" }, String(num)),
@@ -1095,6 +1183,563 @@ window.__ModuleLoader__.load({
 
 		const { renderMarkdown, renderNumbered } = renderMarkdownModule;
 
+		/**
+		 * 思维导图（B1）：把 Markdown 笔记的「标题 + 列表」解析成层级树，并做横向树布局。
+		 *
+		 * 纯函数、零 React 依赖：client 半用它渲染 SVG，测试直接断言树/布局/分支区间。
+		 * 只收标题（#～######）与列表项（- * + 1.）；代码围栏内的内容不算；段落忽略。
+		 *
+		 * 设计取舍：
+		 * - 节点行号（line / endLine，1 起）是「点节点跳到源码行」与「针对分支提问」的锚；
+		 *   分支区间 = 该节点行到其子树最大行，因此引用分支时能把整段内容一起带进对话。
+		 * - 布局用横向树：x 由深度决定，y 由叶子顺序决定（父节点居中于子节点），
+		 *   节点矩形固定高度、宽度按列宽；长文本截断显示（完整文本在 title）。
+		 */
+		const mindMapModule = (() => {
+		  /** 节点上限：超大笔记只画前 N 个，避免一次性渲染几万个矩形。 */
+		  const MAX_NODES = 400;
+		  /** 节点显示文本上限（超出截断，完整文本放 title 属性）。 */
+		  const MAX_LABEL = 80;
+
+		  /** 缩进折算成列数：tab 按 4 空格（与 markdown.js 的列表层级口径一致）。 */
+		  function indentCols(s) {
+		    let n = 0;
+		    for (let k = 0; k < s.length; k += 1) n += s[k] === "\t" ? 4 : 1;
+		    return n;
+		  }
+
+		  /** 行内标记剥掉后作为节点文本：`**粗**`、`[[A|别名]]`、`==高亮==` 等只留可读文字。 */
+		  function stripInlineMarkers(s) {
+		    let out = String(s ?? "");
+		    out = out.replace(/!\[\[([^\]|#]+)(?:#[^\]|]*)?(?:\|[^\]]*)?\]\]/g, "$1");
+		    out = out.replace(/\[\[([^\]|#]+)(?:#[^\]|]*)?(?:\|([^\]]*))?\]\]/g, (m, target, alias) => (alias ? alias : target));
+		    out = out.replace(/\[([^\]]+)\]\([^)]*\)/g, "$1");
+		    out = out.replace(/`([^`]*)`/g, "$1");
+		    out = out.replace(/\*\*([^*]+)\*\*/g, "$1");
+		    out = out.replace(/__([^_]+)__/g, "$1");
+		    out = out.replace(/~~([^~]+)~~/g, "$1");
+		    out = out.replace(/==([^=]+)==/g, "$1");
+		    out = out.replace(/\s*\^[A-Za-z0-9-]+\s*$/, "");
+		    return out.trim();
+		  }
+
+		  /** 节点显示文本：剥标记 + 截断。 */
+		  function nodeLabel(s) {
+		    const text = stripInlineMarkers(s);
+		    return text.length > MAX_LABEL ? `${text.slice(0, MAX_LABEL - 1)}…` : text;
+		  }
+
+		  /**
+		   * 解析笔记为树。
+		   * @param markdown - 笔记源码（正文，frontmatter 已由 host 剥离）。
+		   * @param options - `title` 作根节点文本（通常是笔记文件名）；`maxNodes` 覆盖节点上限。
+		   * @returns 根节点 `{ id, kind: "root", text, line: 0, endLine, children }`。
+		   */
+		  function buildTree(markdown, options = {}) {
+		    const lines = String(markdown ?? "").replace(/\r\n/g, "\n").split("\n");
+		    const limit = Number.isInteger(options.maxNodes) && options.maxNodes > 0 ? options.maxNodes : MAX_NODES;
+		    const root = {
+		      id: "n0",
+		      kind: "root",
+		      text: nodeLabel(options.title ?? "笔记"),
+		      line: 0,
+		      endLine: lines.length,
+		      children: [],
+		    };
+		    let seq = 1;
+		    let headingStack = [];
+		    let itemStack = [];
+		    let inFence = false;
+		    let fenceChar = "";
+		    for (let i = 0; i < lines.length; i += 1) {
+		      const raw = lines[i];
+		      const lineNo = i + 1;
+		      const fence = /^ {0,3}(`{3,}|~{3,})/.exec(raw);
+		      if (fence) {
+		        if (!inFence) {
+		          inFence = true;
+		          fenceChar = fence[1][0];
+		        } else if (raw.trim().startsWith(fenceChar)) {
+		          inFence = false;
+		        }
+		        continue;
+		      }
+		      if (inFence) continue;
+		      if (seq >= limit) break;
+
+		      const heading = /^(#{1,6})[ \t]+(.*)$/.exec(raw);
+		      if (heading) {
+		        const level = heading[1].length;
+		        const text = nodeLabel(heading[2].replace(/\s+#+\s*$/, ""));
+		        while (headingStack.length > 0 && headingStack[headingStack.length - 1].level >= level) headingStack.pop();
+		        itemStack = [];
+		        const parent = headingStack.length > 0 ? headingStack[headingStack.length - 1].node : root;
+		        const node = { id: `n${seq++}`, kind: "heading", level, text, line: lineNo, endLine: lineNo, children: [] };
+		        parent.children.push(node);
+		        headingStack.push({ node, level });
+		        continue;
+		      }
+
+		      const item = /^([ \t]*)([-*+]|\d{1,9}[.)])[ \t]+([\s\S]*)$/.exec(raw);
+		      if (item) {
+		        const indent = indentCols(item[1]);
+		        while (itemStack.length > 0 && itemStack[itemStack.length - 1].indent >= indent) itemStack.pop();
+		        const body = item[3].replace(/^\[[ xX]\][ \t]+/, "");
+		        const text = nodeLabel(body);
+		        const parent = itemStack.length > 0
+		          ? itemStack[itemStack.length - 1].node
+		          : headingStack.length > 0
+		            ? headingStack[headingStack.length - 1].node
+		            : root;
+		        if (text === "") continue;
+		        const node = { id: `n${seq++}`, kind: "item", level: 0, text, line: lineNo, endLine: lineNo, children: [] };
+		        parent.children.push(node);
+		        itemStack.push({ node, indent });
+		        continue;
+		      }
+
+		      // 空行结束当前列表；普通段落不是节点，但不清标题作用域。
+		      if (raw.trim() === "") itemStack = [];
+		    }
+
+		    const computeEnd = (node) => {
+		      let end = node.line;
+		      for (const child of node.children) end = Math.max(end, computeEnd(child));
+		      node.endLine = end;
+		      return end;
+		    };
+		    computeEnd(root);
+		    root.endLine = lines.length;
+		    return root;
+		  }
+
+		  /**
+		   * 横向树布局。
+		   * @param tree - {@link buildTree} 的根节点。
+		   * @param options - rowH/colW/padX/padY/nodeH 覆盖默认尺寸（测试可传小值）。
+		   * @returns `{ nodes, edges, width, height, byId }`；nodes 按 y/x 排序，byId 为 id → 节点。
+		   */
+		  function layout(tree, options = {}) {
+		    const rowH = options.rowH ?? 44;
+		    const colW = options.colW ?? 248;
+		    const padX = options.padX ?? 36;
+		    const padY = options.padY ?? 36;
+		    const nodeH = options.nodeH ?? 30;
+		    const nodes = [];
+		    const edges = [];
+		    let leafCursor = 0;
+
+		    const walk = (node, depth) => {
+		      let centerY;
+		      if (node.children.length === 0) {
+		        centerY = leafCursor * rowH;
+		        leafCursor += 1;
+		      } else {
+		        const centers = node.children.map((child) => walk(child, depth + 1));
+		        centerY = (centers[0] + centers[centers.length - 1]) / 2;
+		      }
+		      nodes.push({
+		        id: node.id,
+		        kind: node.kind,
+		        text: node.text,
+		        line: node.line,
+		        endLine: node.endLine,
+		        depth,
+		        x: padX + depth * colW,
+		        y: padY + centerY,
+		        w: colW - 40,
+		        h: nodeH,
+		      });
+		      for (const child of node.children) edges.push({ from: node.id, to: child.id });
+		      return centerY;
+		    };
+		    walk(tree, 0);
+
+		    const maxDepth = nodes.reduce((max, node) => Math.max(max, node.depth), 0);
+		    const byId = Object.fromEntries(nodes.map((node) => [node.id, node]));
+		    return {
+		      nodes: nodes.sort((a, b) => (a.y - b.y) || (a.x - b.x)),
+		      edges,
+		      byId,
+		      width: padX * 2 + maxDepth * colW + (colW - 40),
+		      height: Math.max(1, leafCursor) * rowH + padY * 2,
+		    };
+		  }
+
+		  /**
+		   * 把「某节点 + 全部后代」映射回源码区间，供「针对分支提问」使用。
+		   * @param markdown - 笔记源码。
+		   * @param node - 树节点（需要 line/endLine，1 起）。
+		   * @returns `{ start, end, text, startLine, endLine }`；start/end 是整篇源码的字符偏移。
+		   */
+		  function branchSpan(markdown, node) {
+		    const norm = String(markdown ?? "").replace(/\r\n/g, "\n");
+		    const lines = norm.split("\n");
+		    const startLine = Math.max(1, node && node.line ? node.line : 1);
+		    const endLine = Math.max(startLine, node && node.endLine ? node.endLine : startLine);
+		    let start = 0;
+		    for (let i = 1; i < startLine && i <= lines.length; i += 1) start += lines[i - 1].length + 1;
+		    let end = start;
+		    const lastLine = Math.min(endLine, lines.length);
+		    for (let i = startLine; i <= lastLine; i += 1) {
+		      end += lines[i - 1].length;
+		      if (i < lastLine) end += 1;
+		    }
+		    return { start, end, text: norm.slice(start, end), startLine, endLine };
+		  }
+
+		  return { buildTree, layout, branchSpan, nodeLabel, stripInlineMarkers, indentCols, MAX_NODES, MAX_LABEL };
+		})();
+
+		/**
+		 * 关系图谱（Obsidian Graph view 的产品化版本，纯函数、零依赖）：
+		 * - `layoutGraph(nodes, edges, opts)`：确定性力导向布局（同一 seed 结果可复现，
+		 *   便于截图/GIF 与测试）；
+		 * - `localSubgraph(graph, noteId, depth)`：以某篇笔记为中心截 N 跳子图（Obsidian 的 local graph）。
+		 *
+		 * 节点/连线由 host 侧 `/obsidian/graph` 计算（全库 .md + [[双链]] + 标签），
+		 * 这里只负责「怎么摆」和「怎么截」。布局在 >maxNodes 时按度数保留最重要的节点，
+		 * 避免一次渲染上千个圆点卡住 UI。
+		 */
+		const graphModule = (() => {
+		  /** 可复现的伪随机数（mulberry32）：同一 seed 得到同一布局。 */
+		  function rng(seed) {
+		    let state = seed >>> 0;
+		    return () => {
+		      state = (state + 0x6d2b79f5) >>> 0;
+		      let t = state;
+		      t = Math.imul(t ^ (t >>> 15), t | 1);
+		      t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+		      return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+		    };
+		  }
+
+		  /** 邻接表（双向），用于度数、局部子图与渲染高亮。 */
+		  function adjacency(nodes, edges) {
+		    const map = new Map(nodes.map((node) => [node.id, []]));
+		    for (const edge of edges) {
+		      if (!map.has(edge.source) || !map.has(edge.target)) continue;
+		      map.get(edge.source).push(edge.target);
+		      map.get(edge.target).push(edge.source);
+		    }
+		    return map;
+		  }
+
+		  /**
+		   * 力导向布局。
+		   * @param nodes - `[{ id, kind, label, path? }]`。
+		   * @param edges - `[{ source, target }]`（id 对）。
+		   * @param options - width/height/iterations/maxNodes/seed。
+		   * @returns `{ nodes: [{id,x,y,degree}], width, height, truncated }`。
+		   */
+		  function layoutGraph(nodes, edges, options = {}) {
+		    const width = options.width ?? 1400;
+		    const height = options.height ?? 960;
+		    const iterations = options.iterations ?? 220;
+		    const maxNodes = options.maxNodes ?? 500;
+		    const seed = options.seed ?? 1;
+		    const padding = options.padding ?? 60;
+		    const rand = rng(seed);
+
+		    const adj = adjacency(nodes, edges);
+		    let list = nodes;
+		    let links = edges;
+		    let truncated = false;
+		    if (nodes.length > maxNodes) {
+		      truncated = true;
+		      list = [...nodes]
+		        .sort((a, b) => (adj.get(b.id).length - adj.get(a.id).length) || String(a.id).localeCompare(String(b.id)))
+		        .slice(0, maxNodes);
+		    }
+		    const index = new Map(list.map((node, i) => [node.id, i]));
+		    links = links.filter((edge) => index.has(edge.source) && index.has(edge.target));
+
+		    const n = list.length;
+		    const xs = new Float64Array(n);
+		    const ys = new Float64Array(n);
+		    const vx = new Float64Array(n);
+		    const vy = new Float64Array(n);
+		    const cx = width / 2;
+		    const cy = height / 2;
+		    // 初始点：圆周分布 + 抖动，避免完全对称的力平衡（那样图形会挤成一团）
+		    for (let i = 0; i < n; i += 1) {
+		      const angle = (i / Math.max(1, n)) * Math.PI * 2;
+		      const radius = Math.min(width, height) * 0.36 * (0.55 + rand() * 0.45);
+		      xs[i] = cx + Math.cos(angle) * radius;
+		      ys[i] = cy + Math.sin(angle) * radius;
+		    }
+		    const linkIndex = links.map((edge) => ({ a: index.get(edge.source), b: index.get(edge.target) }));
+		    const degree = new Int32Array(n);
+		    for (const link of linkIndex) {
+		      degree[link.a] += 1;
+		      degree[link.b] += 1;
+		    }
+
+		    const repulse = 26000;
+		    const minDist = 26;
+		    const springLength = 120;
+		    const springK = 0.012;
+		    const gravity = 0.0035;
+		    for (let step = 0; step < iterations; step += 1) {
+		      // 斥力（O(n²)，n 已被 maxNodes 限制）
+		      for (let i = 0; i < n; i += 1) {
+		        for (let j = i + 1; j < n; j += 1) {
+		          let dx = xs[i] - xs[j];
+		          let dy = ys[i] - ys[j];
+		          let dist2 = dx * dx + dy * dy;
+		          if (dist2 < 0.01) {
+		            dx = (rand() - 0.5) * 0.6;
+		            dy = (rand() - 0.5) * 0.6;
+		            dist2 = dx * dx + dy * dy;
+		          }
+		          if (dist2 < minDist * minDist) dist2 = minDist * minDist;
+		          const force = repulse / dist2;
+		          const dist = Math.sqrt(dist2);
+		          const fx = (dx / dist) * force;
+		          const fy = (dy / dist) * force;
+		          vx[i] += fx;
+		          vy[i] += fy;
+		          vx[j] -= fx;
+		          vy[j] -= fy;
+		        }
+		      }
+		      // 弹簧（边）
+		      for (const link of linkIndex) {
+		        const dx = xs[link.b] - xs[link.a];
+		        const dy = ys[link.b] - ys[link.a];
+		        const dist = Math.sqrt(dx * dx + dy * dy) || 0.01;
+		        const force = (dist - springLength) * springK;
+		        const fx = (dx / dist) * force;
+		        const fy = (dy / dist) * force;
+		        vx[link.a] += fx;
+		        vy[link.a] += fy;
+		        vx[link.b] -= fx;
+		        vy[link.b] -= fy;
+		      }
+		      // 向心力 + 阻尼积分
+		      for (let i = 0; i < n; i += 1) {
+		        vx[i] += (cx - xs[i]) * gravity;
+		        vy[i] += (cy - ys[i]) * gravity;
+		        vx[i] *= 0.82;
+		        vy[i] *= 0.82;
+		        const maxStep = 28;
+		        if (vx[i] > maxStep) vx[i] = maxStep;
+		        if (vx[i] < -maxStep) vx[i] = -maxStep;
+		        if (vy[i] > maxStep) vy[i] = maxStep;
+		        if (vy[i] < -maxStep) vy[i] = -maxStep;
+		        xs[i] += vx[i];
+		        ys[i] += vy[i];
+		      }
+		    }
+
+		    // 归一化到画布（保留 padding），图形太小时水平居中撑开
+		    let minX = Infinity;
+		    let maxX = -Infinity;
+		    let minY = Infinity;
+		    let maxY = -Infinity;
+		    for (let i = 0; i < n; i += 1) {
+		      if (xs[i] < minX) minX = xs[i];
+		      if (xs[i] > maxX) maxX = xs[i];
+		      if (ys[i] < minY) minY = ys[i];
+		      if (ys[i] > maxY) maxY = ys[i];
+		    }
+		    const spanX = maxX - minX || 1;
+		    const spanY = maxY - minY || 1;
+		    const usableW = width - padding * 2;
+		    const usableH = height - padding * 2;
+		    const scale = Math.min(usableW / spanX, usableH / spanY, 1.8);
+		    const offsetX = padding + (usableW - spanX * scale) / 2;
+		    const offsetY = padding + (usableH - spanY * scale) / 2;
+		    const placed = list.map((node, i) => ({
+		      ...node,
+		      x: offsetX + (xs[i] - minX) * scale,
+		      y: offsetY + (ys[i] - minY) * scale,
+		      degree: degree[i],
+		    }));
+		    return { nodes: placed, width, height, truncated };
+		  }
+
+		  /**
+		   * 以某节点为中心截 N 跳子图（Obsidian 的 local graph）。
+		   * @param graph - `{ nodes, edges }`（host 返回）。
+		   * @param noteId - 中心节点 id（笔记节点是 `note:<rel>`）。
+		   * @param depth - 跳数（默认 2）。
+		   * @returns `{ nodes, edges, found }`。
+		   */
+		  function localSubgraph(graph, noteId, depth = 2) {
+		    const nodes = graph && Array.isArray(graph.nodes) ? graph.nodes : [];
+		    const edges = graph && Array.isArray(graph.edges) ? graph.edges : [];
+		    const byId = new Map(nodes.map((node) => [node.id, node]));
+		    if (!byId.has(noteId)) return { nodes: [], edges: [], found: false };
+		    const adj = adjacency(nodes, edges);
+		    const seen = new Set([noteId]);
+		    let frontier = [noteId];
+		    for (let hop = 0; hop < depth; hop += 1) {
+		      const next = [];
+		      for (const id of frontier) {
+		        for (const other of adj.get(id) ?? []) {
+		          if (seen.has(other)) continue;
+		          seen.add(other);
+		          next.push(other);
+		        }
+		      }
+		      frontier = next;
+		      if (frontier.length === 0) break;
+		    }
+		    const keep = new Set([...seen].filter((id) => byId.has(id)));
+		    return {
+		      nodes: nodes.filter((node) => keep.has(node.id)),
+		      edges: edges.filter((edge) => keep.has(edge.source) && keep.has(edge.target)),
+		      found: true,
+		    };
+		  }
+
+
+		  /** POSIX 风格拼接 + 折叠 `.`/`..`（客户端兜底构建时与 host 同一套链接解析）。 */
+		  function joinPosix(dir, rel) {
+		    const parts = dir === "" ? [] : dir.split("/");
+		    for (const seg of rel.split("/")) {
+		      if (seg === "" || seg === ".") continue;
+		      if (seg === "..") parts.pop();
+		      else parts.push(seg);
+		    }
+		    return parts.join("/");
+		  }
+
+		  /**
+		   * `[[链接目标]]` → 笔记相对路径（与 host 侧 / Obsidian 语义一致：精确路径 →
+		   * 相对当前笔记目录 → 文件名，多个候选取层数最浅再字母序）。
+		   * 客户端兜底构建图谱时用；解析不到返回 null。
+		   */
+		  function resolveGraphLink(target, fromRel, byPath, byBase) {
+		    let raw = String(target == null ? "" : target).trim();
+		    if (raw === "" || /^[a-z]+:\/\//i.test(raw)) return null;
+		    raw = raw.replace(/\\/g, "/");
+		    const stripExt = (value) => value.replace(/\.md$/i, "");
+		    const tryPath = (value) => byPath.get(stripExt(value).replace(/^\.\//, "").toLowerCase()) ?? null;
+		    let hit = tryPath(raw);
+		    if (hit !== null) return hit;
+		    if (raw.includes("/") || raw.startsWith(".")) {
+		      const dir = fromRel.includes("/") ? fromRel.slice(0, fromRel.lastIndexOf("/")) : "";
+		      hit = tryPath(joinPosix(dir, raw));
+		      if (hit !== null) return hit;
+		    }
+		    const base = stripExt(raw.split("/").pop()).toLowerCase();
+		    const list = byBase.get(base);
+		    if (list === undefined || list.length === 0) return null;
+		    if (list.length === 1) return list[0];
+		    return [...list].sort((a, b) => (a.split("/").length - b.split("/").length) || a.localeCompare(b))[0];
+		  }
+
+		  /**
+		   * 客户端兜底：用「笔记列表 + 每篇的 links/tags」构建与 host 相同形状的图。
+		   * 用途：插件升级后 host 还是旧版（没有 /obsidian/graph 路由）时，前端仍能
+		   * 通过旧接口自建图谱 —— 用户无感知、不用重启 DSH。
+		   * @param notes - `[{ path, links, tags }]`（path 为 vault 相对路径）。
+		   * @returns `{ nodes, edges, stats }`。
+		   */
+		  function buildGraphFromNotes(notes, options = {}) {
+		    const maxNotes = options.maxNotes ?? 1200;
+		    const maxEdges = options.maxEdges ?? 12000;
+		    const maxTags = options.maxTags ?? 800;
+		    const list = [...notes].slice(0, maxNotes);
+		    const byPath = new Map();
+		    const byBase = new Map();
+		    for (const note of list) {
+		      const noExt = note.path.replace(/\.md$/i, "");
+		      byPath.set(noExt.toLowerCase(), note.path);
+		      const base = (noExt.split("/").pop() || noExt).toLowerCase();
+		      const bucket = byBase.get(base);
+		      if (bucket === undefined) byBase.set(base, [note.path]);
+		      else bucket.push(note.path);
+		    }
+		    const nodes = new Map();
+		    for (const note of list) {
+		      nodes.set(`note:${note.path}`, {
+		        id: `note:${note.path}`,
+		        kind: "note",
+		        label: (note.path.split("/").pop() || note.path).replace(/\.md$/i, ""),
+		        path: note.path,
+		      });
+		    }
+		    const edges = [];
+		    const seen = new Set();
+		    const addEdge = (source, target) => {
+		      if (edges.length >= maxEdges) return;
+		      const key = `${source}\u0000${target}`;
+		      if (seen.has(key)) return;
+		      seen.add(key);
+		      edges.push({ source, target });
+		    };
+		    const tagIds = new Map();
+		    let unresolved = 0;
+		    for (const note of list) {
+		      const self = `note:${note.path}`;
+		      for (const link of note.links ?? []) {
+		        const target = resolveGraphLink(link, note.path, byPath, byBase);
+		        if (target === null) {
+		          unresolved += 1;
+		          continue;
+		        }
+		        if (target !== note.path) addEdge(self, `note:${target}`);
+		      }
+		      for (const tag of note.tags ?? []) {
+		        const key = String(tag).toLowerCase();
+		        let tagId = tagIds.get(key);
+		        if (tagId === undefined) {
+		          if (tagIds.size >= maxTags) continue;
+		          tagId = `tag:${key}`;
+		          tagIds.set(key, tagId);
+		          nodes.set(tagId, { id: tagId, kind: "tag", label: `#${tag}` });
+		        }
+		        addEdge(self, tagId);
+		      }
+		    }
+		    return {
+		      nodes: [...nodes.values()],
+		      edges,
+		      stats: {
+		        notes: list.length,
+		        tags: tagIds.size,
+		        edges: edges.length,
+		        unresolved,
+		        truncated: notes.length > maxNotes,
+		        source: "client",
+		      },
+		    };
+		  }
+
+
+		  /**
+		   * 从笔记内容 + frontmatter 提取标签（客户端兜底构建图谱时用；与 host 解析同语义）。
+		   * @param content - 笔记正文。
+		   * @param frontmatter - `{ tags: "..." }` 形态的 frontmatter 映射。
+		   * @returns 标签名数组（不含 `#`、去重）。
+		   */
+		  function extractTags(content, frontmatter) {
+		    const tags = new Set();
+		    const fm = frontmatter && frontmatter.tags;
+		    if (typeof fm === "string" && fm.trim() !== "") {
+		      for (const token of fm.replace(/^\[|\]$/g, "").split(/[,\s]+/)) {
+		        const tag = token.replace(/^#/, "").replace(/^["']|["']$/g, "").trim();
+		        if (tag !== "" && /^[\p{L}\p{N}_/-]{1,64}$/u.test(tag)) tags.add(tag);
+		      }
+		    }
+		    const body = String(content ?? "")
+		      .replace(/```[\s\S]*?```/g, " ")
+		      .replace(/~~~[\s\S]*?~~~/g, " ")
+		      .replace(/`[^`\n]*`/g, " ");
+		    const re = /(^|[\s(（\[【,，;；、>|])#([\p{L}\p{N}_/-]{1,64})/gu;
+		    for (const match of body.matchAll(re)) {
+		      const tag = match[2].replace(/\/+$/, "");
+		      if (tag !== "" && !/^\d+$/.test(tag)) tags.add(tag);
+		    }
+		    return [...tags];
+		  }
+
+		  return { layoutGraph, localSubgraph, adjacency, rng, resolveGraphLink, buildGraphFromNotes, extractTags };
+		})();
+
 		/**
 		 * dsh-obsidian-vault client 半边（侧边栏重构版）：
 		 *  - 常驻接管 sidebar.workspaces（priority:-100 阴影官方 WorkspaceBrowser）：
@@ -1209,6 +1854,44 @@ window.__ModuleLoader__.load({
 		    cancel: "取消",
 		    discard: "放弃未保存的修改？",
 		    cite: "引用到对话",
+		    mindMap: "思维导图",
+		    preview: "预览",
+		    mapEmpty: "这篇笔记还没有标题或列表，画不出思维导图",
+		    mapHint: "滚轮缩放 · 拖动平移 · 单击节点选中 · 双击跳到源码行",
+		    mapJump: "跳到源码行",
+		    mapAsk: "把分支插入对话",
+		    branchCited: "已把分支插入对话（{n} 行）",
+		    graph: "关系图谱",
+		    graphHint: "滚轮缩放 · 拖动平移 · 点击笔记打开 · 悬停看邻居",
+		    graphGlobal: "全库",
+		    graphLocal: "局部",
+		    graphLocalHint: "以当前打开的笔记为中心显示 2 跳邻居",
+		    graphRefresh: "重新读取 vault",
+		    graphRerun: "重新布局",
+		    graphClose: "关闭图谱",
+		    graphLoading: "正在构建关系图谱…",
+		    graphEmpty: "vault 里还没有可显示的笔记或双链",
+		    graphError: "关系图谱加载失败：{msg}",
+		    graphStats: "{notes} 篇笔记 · {tags} 个标签 · {edges} 条连线",
+		    graphTruncated: "笔记较多，图谱只画了最重要的 {n} 个节点",
+		    graphNoNote: "先在侧边栏打开一篇笔记，才能看局部图谱",
+		    graphOpen: "打开关系图谱",
+		    graphMove: "拖动移动面板",
+		    graphNeedsRestart: "关系图谱需要重启 DSH 后启用",
+		    graphRestartHint: "当前 DSH 进程里还是旧版 host（缺少 /obsidian/graph 路由）。完全退出 DSH（Cmd+Q）再打开，然后点「重试」。",
+		    graphErrorTitle: "关系图谱加载失败",
+		    graphBuilding: "正在从笔记构建图谱（{done}/{total}）…",
+		    graphFocus: "聚焦",
+		    graphFocusHint: "一键切到以当前打开笔记为中心的局部图谱（局部模式下再点 = 重新居中）",
+		    graphLegendNote: "笔记",
+		    graphLegendTag: "标签",
+		    graphLegendFocus: "当前笔记",
+		    graphLegendLink: "链接",
+		    graphDepth: "跳数",
+		    graphDepthHint: "局部图谱跳数，1–5 跳（与 Obsidian 局部图谱的 depth 范围一致）",
+		    graphRetry: "重试",
+		    graphDetails: "详细信息",
+		    graphDetailsHide: "收起详细信息",
 		    cited: "已引用到对话",
 		    copied: "已复制引用，可粘贴到输入框",
 		    noInput: "未找到对话输入框，引用已复制到剪贴板",
@@ -1346,6 +2029,44 @@ window.__ModuleLoader__.load({
 		    cancel: "Cancel",
 		    discard: "Discard unsaved changes?",
 		    cite: "Cite to chat",
+		    mindMap: "Mind map",
+		    preview: "Preview",
+		    mapEmpty: "No headings or list items yet — nothing to draw",
+		    mapHint: "Scroll to zoom · drag to pan · click a node to select · double-click to jump to its line",
+		    mapJump: "Jump to line",
+		    mapAsk: "Insert branch into chat",
+		    branchCited: "Branch inserted into the chat ({n} lines)",
+		    graph: "Graph view",
+		    graphHint: "Scroll to zoom · drag to pan · click a note to open it · hover to see neighbours",
+		    graphGlobal: "Vault",
+		    graphLocal: "Local",
+		    graphLocalHint: "Show the 2-hop neighbourhood of the note that is open",
+		    graphRefresh: "Re-read the vault",
+		    graphRerun: "Re-run the layout",
+		    graphClose: "Close the graph",
+		    graphLoading: "Building the graph…",
+		    graphEmpty: "No notes or links to draw yet",
+		    graphError: "Graph view failed: {msg}",
+		    graphStats: "{notes} notes · {tags} tags · {edges} links",
+		    graphTruncated: "Large vault: only the {n} most connected nodes are drawn",
+		    graphNoNote: "Open a note in the sidebar first to see the local graph",
+		    graphOpen: "Open the graph view",
+		    graphMove: "Drag to move the panel",
+		    graphNeedsRestart: "The graph view needs a DSH restart",
+		    graphRestartHint: "The running DSH host still predates the /obsidian/graph route. Quit DSH completely (Cmd+Q), reopen it, then press Retry.",
+		    graphErrorTitle: "The graph view failed to load",
+		    graphBuilding: "Building the graph from notes ({done}/{total})…",
+		    graphFocus: "Focus",
+		    graphFocusHint: "Jump to the local graph centred on the open note (click again to re-centre)",
+		    graphLegendNote: "note",
+		    graphLegendTag: "tag",
+		    graphLegendFocus: "current note",
+		    graphLegendLink: "link",
+		    graphDepth: "Depth",
+		    graphDepthHint: "Local graph depth, 1–5 hops (same range as Obsidian's local graph depth)",
+		    graphRetry: "Retry",
+		    graphDetails: "Details",
+		    graphDetailsHide: "Hide details",
 		    cited: "Cited to chat",
 		    copied: "Reference copied — paste it into the input",
 		    noInput: "No chat input found — reference copied to clipboard",
@@ -1396,6 +2117,8 @@ window.__ModuleLoader__.load({
 		  // ── 共享外部 store（跨槽位：侧边栏 / Dock / Toast）──────────────────────────
 		  const LS_NOTES_OPEN = "dsh-obsidian:notesOpen";
 		  const LS_DOCK_WIDTH = "dsh-obsidian:dockWidth";
+		  const LS_GRAPH_GEOMETRY = "dsh-obsidian:graphGeometry";
+		  const LS_LOCAL_DEPTH = "dsh-obsidian:localDepth";
 
 		  function readNotesOpen() {
 		    try {
@@ -1405,7 +2128,7 @@ window.__ModuleLoader__.load({
 		    }
 		  }
 
-		  let shared = { notesOpen: readNotesOpen(), openNote: null, vaultRev: 0, toast: null, noteCount: 0, prompt: null };
+		  let shared = { notesOpen: readNotesOpen(), openNote: null, graphOpen: false, vaultRev: 0, toast: null, noteCount: 0, prompt: null };
 		  const sharedListeners = new Set();
 
 		  function patchShared(patch) {
@@ -1847,7 +2570,69 @@ window.__ModuleLoader__.load({
 		    `.dsh-obs-md-lc{flex:1;min-width:0}`,
 		    `.dsh-obs-dock-body .dsh-obs-md-row .dsh-obs-md-lc p,.dsh-obs-dock-body .dsh-obs-md-row .dsh-obs-md-lc h1,.dsh-obs-dock-body .dsh-obs-md-row .dsh-obs-md-lc h2,.dsh-obs-dock-body .dsh-obs-md-row .dsh-obs-md-lc h3,.dsh-obs-dock-body .dsh-obs-md-row .dsh-obs-md-lc h4,.dsh-obs-dock-body .dsh-obs-md-row .dsh-obs-md-lc h5,.dsh-obs-dock-body .dsh-obs-md-row .dsh-obs-md-lc h6,.dsh-obs-dock-body .dsh-obs-md-row .dsh-obs-md-lc blockquote{margin:0;padding:0}`,
 		    `.dsh-obs-md-row.dsh-obs-md-heading .dsh-obs-md-lc{font-weight:600}`,
+		    // 行内 Obsidian 语法：==高亮== / ~~删除线~~ / 裸链接与自动链接
+		    `.dsh-obs-md mark,.dsh-obs-mark{background:rgba(255,208,0,.32);color:inherit;border-radius:2px;padding:0 1px}`,
+		    `.dsh-obs-md del{opacity:.62;text-decoration:line-through}`,
+		    `.dsh-obs-md .dsh-obs-autolink{color:var(--dsw-alias-brand-primary);text-decoration:underline;text-underline-offset:2px;word-break:break-all}`,
 		    `.dsh-obs-md-row.dsh-obs-md-quote .dsh-obs-md-lc{border-left:3px solid var(--dsw-alias-brand-primary);padding-left:10px;color:var(--dsw-alias-label-secondary)}`,
+		    // ── 思维导图视图（B1）──
+		    `.dsh-obs-dock-map{overflow:hidden;padding:0}`,
+		    `.dsh-obs-map{position:relative;display:block;width:100%;height:100%;min-height:300px;cursor:grab;overflow:hidden;user-select:none;-webkit-user-select:none}`,
+		    `.dsh-obs-map-svg{display:block;width:100%;height:100%}`,
+		    `.dsh-obs-map-edge{fill:none;stroke:var(--dsw-alias-border-l2);stroke-width:1.5}`,
+		    `.dsh-obs-map-node{cursor:pointer}`,
+		    `.dsh-obs-map-node rect{fill:var(--dsw-alias-bg-overlay);stroke:var(--dsw-alias-border-l2);stroke-width:1}`,
+		    `.dsh-obs-map-heading rect{stroke:var(--dsw-alias-brand-primary)}`,
+		    `.dsh-obs-map-root rect{fill:var(--dsw-alias-brand-primary);stroke:var(--dsw-alias-brand-primary)}`,
+		    `.dsh-obs-map-root text{fill:#fff;font-weight:600}`,
+		    `.dsh-obs-map-node text{font-size:12.5px;fill:var(--dsw-alias-label-primary);pointer-events:none}`,
+		    `.dsh-obs-map-sel rect{stroke:var(--dsw-alias-brand-primary);stroke-width:2}`,
+		    `.dsh-obs-map-hint{position:absolute;left:10px;bottom:8px;font-size:11px;color:var(--dsw-alias-label-tertiary);pointer-events:none}`,
+		    `.dsh-obs-map-actions{position:absolute;right:10px;top:8px;display:flex;align-items:center;gap:6px;padding:4px 6px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-overlay);font-size:12px}`,
+		    `.dsh-obs-map-actions .dsh-obs-map-line{color:var(--dsw-alias-label-tertiary);font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}`,
+		    `.dsh-obs-map-actions button{padding:3px 8px;font-size:12px}`,
+		    `.dsh-obs-map-empty{display:flex;align-items:center;justify-content:center;height:100%;min-height:220px;padding:24px;color:var(--dsw-alias-label-tertiary);text-align:center}`,
+		    `.dsh-obs-md-row.dsh-obs-md-flash{background:color-mix(in srgb,var(--dsw-alias-brand-primary) 16%,transparent);border-radius:4px}`,
+		    // ── 关系图谱（shell.overlay，vault 级独立视图）──
+		    `.dsh-obs-graph{position:fixed;z-index:40;display:flex;flex-direction:column;box-sizing:border-box;min-width:560px;min-height:360px;border:1px solid var(--dsw-alias-border-l2);border-radius:14px;background:var(--dsw-alias-bg-overlay);box-shadow:0 24px 64px rgba(0,0,0,.45);overflow:hidden;color:var(--dsw-alias-label-primary)}`,
+		    `.dsh-obs-graph-head{display:flex;align-items:center;gap:8px;padding:10px 14px;border-bottom:1px solid var(--dsw-alias-border-l2);flex-wrap:wrap;cursor:move;user-select:none;-webkit-user-select:none}`,
+		    `.dsh-obs-graph-resize{position:absolute;right:2px;bottom:2px;width:16px;height:16px;cursor:nwse-resize;border-right:2px solid var(--dsw-alias-border-l2);border-bottom:2px solid var(--dsw-alias-border-l2);opacity:.75}`,
+		    `.dsh-obs-graph-error{display:flex;flex-direction:column;align-items:center;justify-content:center;flex:1;gap:8px;padding:32px;text-align:center}`,
+		    `.dsh-obs-graph-error-icon{font-size:26px}`,
+		    `.dsh-obs-graph-error-title{font-size:14px;font-weight:600;color:var(--dsw-alias-label-primary)}`,
+		    `.dsh-obs-graph-error-text{font-size:12px;line-height:1.7;color:var(--dsw-alias-label-secondary);max-width:560px}`,
+		    `.dsh-obs-graph-error-actions{display:flex;gap:8px;margin-top:8px}`,
+		    `.dsh-obs-graph-error-actions button{padding:5px 12px;font-size:12px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary);cursor:pointer}`,
+		    `.dsh-obs-graph-error-actions button:hover{background:var(--dsw-alias-interactive-bg-hover)}`,
+		    `.dsh-obs-graph-error-actions button.dsh-obs-primary{background:var(--dsw-alias-button-primary-fill);border-color:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground)}`,
+		    `.dsh-obs-graph-error-details{max-width:560px;max-height:120px;overflow:auto;margin-top:6px;padding:8px;border-radius:6px;background:var(--dsw-alias-interactive-bg-hover);font-size:11px;color:var(--dsw-alias-label-tertiary);white-space:pre-wrap;word-break:break-all;text-align:left}`,
+		    `.dsh-obs-graph-title{font-weight:600;font-size:14px}`,
+		    `.dsh-obs-graph-stats{font-size:11px;color:var(--dsw-alias-label-tertiary)}`,
+		    `.dsh-obs-graph-modes{display:flex;gap:4px;margin-left:auto}`,
+		    `.dsh-obs-graph-modes button[disabled]{opacity:.45;cursor:not-allowed}`,
+		    `.dsh-obs-graph-depth{display:inline-flex;align-items:center;gap:2px;margin-left:6px;padding-left:8px;border-left:1px solid var(--dsw-alias-border-l2)}`,
+		    `.dsh-obs-graph-depth-label{font-size:11px;color:var(--dsw-alias-label-tertiary);margin-right:2px}`,
+		    `.dsh-obs-graph-depth button{min-width:20px;padding:0 4px}`,
+		    `.dsh-obs-graph-head button{white-space:nowrap;flex:none}`,
+		    `.dsh-obs-legend-dot{width:9px;height:9px;border-radius:50%;border:1.5px solid var(--dsw-alias-label-secondary);display:inline-block;box-sizing:border-box}`,
+		    `.dsh-obs-legend-tag{width:8px;height:8px;border-radius:2px;background:var(--dsw-alias-brand-primary);display:inline-block}`,
+		    `.dsh-obs-legend-focus{width:9px;height:9px;border-radius:50%;border:2px solid var(--dsw-alias-state-error-primary);display:inline-block;box-sizing:border-box}`,
+		    `.dsh-obs-legend-link{width:14px;height:1.5px;background:var(--dsw-alias-border-l2);display:inline-block}`,
+		    `.dsh-obs-graph-canvas{position:relative;flex:1;min-height:0;overflow:hidden;cursor:grab;user-select:none;-webkit-user-select:none}`,
+		    `.dsh-obs-graph-svg{display:block;width:100%;height:100%}`,
+		    `.dsh-obs-graph-edge{stroke:var(--dsw-alias-border-l2);stroke-width:1;opacity:.55}`,
+		    `.dsh-obs-graph-edge-on{stroke:var(--dsw-alias-brand-primary);opacity:.9;stroke-width:1.6}`,
+		    `.dsh-obs-graph-node{cursor:pointer}`,
+		    `.dsh-obs-graph-note circle{fill:var(--dsw-alias-bg-overlay);stroke:var(--dsw-alias-label-secondary);stroke-width:1.4}`,
+		    `.dsh-obs-graph-tag rect{fill:var(--dsw-alias-brand-primary);opacity:.75}`,
+		    `.dsh-obs-graph-sel circle,.dsh-obs-graph-sel rect{stroke:var(--dsw-alias-brand-primary);stroke-width:2.2}`,
+		    `.dsh-obs-graph-focus circle{stroke:var(--dsw-alias-state-error-primary);stroke-width:2.4}`,
+		    `.dsh-obs-graph-dim{opacity:.25}`,
+		    `.dsh-obs-graph-node text{font-size:11px;fill:var(--dsw-alias-label-primary);pointer-events:none}`,
+		    `.dsh-obs-graph-tag text{fill:var(--dsw-alias-label-secondary)}`,
+		    `.dsh-obs-graph-hint{padding:6px 14px;border-top:1px solid var(--dsw-alias-border-l2);font-size:11px;color:var(--dsw-alias-label-tertiary)}`,
+		    `.dsh-obs-graph-empty{display:flex;align-items:center;justify-content:center;flex:1;padding:32px;color:var(--dsw-alias-label-tertiary);text-align:center}`,
+		    `.dsh-obs-graph-error, .dsh-obs-graph-empty{flex:1;min-height:0}`,
 		    // ── Obsidian callout（`> [!type] 标题`）配色：类型在根节点上带 data-callout ──
 		    `[data-callout="note"]{--dsh-obs-callout-color:#448aff}`,
 		    `[data-callout="abstract"]{--dsh-obs-callout-color:#00b8d4}`,
@@ -2167,6 +2952,7 @@ window.__ModuleLoader__.load({
 		    // `![[附件/a.png]]` 会被当成 Vault 根下的 `附件/a.png` → 403 → 只剩断图。
 		    assetUrl: (rel, from) => `/obsidian/file?path=${encodeURIComponent(rel)}`
 		      + (from ? `&from=${encodeURIComponent(from)}` : ""),
+		    graph: () => api("/graph"),
 		    note: (rel) => api(`/note?path=${encodeURIComponent(rel)}`),
 		    save: (rel, content) => api("/note", {
 		      method: "POST",
@@ -2608,6 +3394,14 @@ window.__ModuleLoader__.load({
 		          onClick: (e) => { e.stopPropagation(); void newNote(""); },
 		        }, "＋"),
 		      ),
+		      rootInfo && rootInfo.exists && createElement("div", { className: "dsh-obs-root-row", title: t("graphOpen") },
+		        createElement("span", { className: "dsh-obs-root-path" }, `🕸 ${t("graph")}`),
+		        createElement("button", {
+		          className: "dsh-obs-mini",
+		          title: t("graphOpen"),
+		          onClick: (e) => { e.stopPropagation(); patchShared({ graphOpen: true }); },
+		        }, "↗"),
+		      ),
 		      rootInfo && rootInfo.exists && attachDir !== null && createElement("div", { className: "dsh-obs-root-row", title: t("attachSettings") },
 		        createElement("span", { className: "dsh-obs-root-path" },
 		          `📎 ${t("attachLocation")}: ${attachLocationLabel(attachCfg, attachDir, t)}`),
@@ -3680,12 +4474,663 @@ window.__ModuleLoader__.load({
 		    );
 		  }
 
+		  /**
+		   * 关系图谱视图：全库 .md + [[双链]] + 标签（host `/obsidian/graph` 计算，
+		   * 力导向布局在 src/graph.js）。可切到「局部」= 当前打开笔记的 2 跳邻居。
+		   */
+		  function GraphView({ t, currentNote, onOpenNote, onClose }) {
+		    const [data, setData] = useState(null);
+		    const [error, setError] = useState("");
+		    const [loading, setLoading] = useState(true);
+		    const [mode, setMode] = useState("global");
+		    // 局部图谱跳数：与 Obsidian 局部图谱的 depth 滑杆对齐（范围 1–5，默认 1）
+		    const [fitKey, setFitKey] = useState(0);
+		    const [localDepth, setLocalDepth] = useState(() => {
+		      try {
+		        const v = parseInt(localStorage.getItem(LS_LOCAL_DEPTH) ?? "", 10);
+		        if (Number.isFinite(v) && v >= 1 && v <= 5) return v;
+		      } catch { /* ignore */ }
+		      return 1;
+		    });
+		    const [seed, setSeed] = useState(1);
+		    const [hovered, setHovered] = useState(null);
+		    const [reloadKey, setReloadKey] = useState(0);
+		    const [transform, setTransform] = useState({ x: 0, y: 0, s: 1 });
+		    const [detailsOpen, setDetailsOpen] = useState(false);
+		    const [buildProgress, setBuildProgress] = useState(null);
+		    const dragRef = useRef(null);
+		    const wrapRef = useRef(null);
+		    const panelDragRef = useRef(null);
+		    const resizeRef = useRef(null);
+		    // 面板几何：可拖动、可缩放、可关闭（和笔记 Dock 同一套交互），位置/尺寸持久化
+		    const [geometry, setGeometry] = useState(() => {
+		      const fallback = { x: null, y: 64, width: 860, height: 600 };
+		      try {
+		        const raw = localStorage.getItem(LS_GRAPH_GEOMETRY);
+		        if (raw !== null) {
+		          const parsed = JSON.parse(raw);
+		          if (typeof parsed === "object" && parsed !== null) {
+		            return {
+		              x: typeof parsed.x === "number" ? parsed.x : null,
+		              y: typeof parsed.y === "number" ? parsed.y : 64,
+		              width: Number.isFinite(parsed.width) ? Math.min(Math.max(560, parsed.width), 1600) : 860,
+		              height: Number.isFinite(parsed.height) ? Math.min(Math.max(360, parsed.height), 1200) : 600,
+		            };
+		          }
+		        }
+		      } catch { /* 忽略坏掉的本地存储 */ }
+		      return fallback;
+		    });
+
+		    useEffect(() => {
+		      let cancelled = false;
+		      setLoading(true);
+		      setError("");
+		      setBuildProgress(null);
+		      // 旧 host 没有 /obsidian/graph 路由时的兜底：用已有的 tree/note 接口在浏览器里
+		      // 自建同一张图（插件升级后页面刷新即可用，不要求用户重启 DSH）。
+		      const buildFromClient = async () => {
+		        const dirs = [""];
+		        const notes = [];
+		        while (dirs.length > 0 && notes.length < 1200) {
+		          const rel = dirs.shift();
+		          let res;
+		          try {
+		            res = await treeApi.tree(rel);
+		          } catch {
+		            continue;
+		          }
+		          for (const entry of res.entries ?? []) {
+		            const path = rel === "" ? entry.name : `${rel}/${entry.name}`;
+		            if (entry.type === "dir") dirs.push(path);
+		            else if (entry.type === "note") notes.push({ path });
+		          }
+		        }
+		        const collected = new Array(notes.length).fill(null);
+		        let done = 0;
+		        let cursor = 0;
+		        setBuildProgress({ done, total: notes.length });
+		        const worker = async () => {
+		          while (cursor < notes.length && !cancelled) {
+		            const index = cursor;
+		            cursor += 1;
+		            try {
+		              const note = await treeApi.note(notes[index].path);
+		              collected[index] = {
+		                path: notes[index].path,
+		                links: Array.isArray(note.links) ? note.links : [],
+		                tags: graphModule.extractTags(note.content ?? "", note.frontmatter),
+		              };
+		            } catch { /* 单篇读失败不影响整张图 */ }
+		            done += 1;
+		            if ((done % 8 === 0 || done === notes.length) && !cancelled) setBuildProgress({ done, total: notes.length });
+		          }
+		        };
+		        await Promise.all(Array.from({ length: Math.min(6, Math.max(1, notes.length)) }, worker));
+		        if (cancelled) return null;
+		        return graphModule.buildGraphFromNotes(collected.filter(Boolean));
+		      };
+		      treeApi.root().then((root) => {
+		        if (cancelled) return null;
+		        const features = root && Array.isArray(root.features) ? root.features : [];
+		        if (!features.includes("graph")) return buildFromClient();
+		        return treeApi.graph();
+		      }).then((res) => {
+		        if (cancelled || res === null || res === undefined) return;
+		        setData(res);
+		        setLoading(false);
+		        setBuildProgress(null);
+		      }).catch((err) => {
+		        if (cancelled) return;
+		        setError(String(err && err.message ? err.message : err));
+		        setLoading(false);
+		      });
+		      return () => { cancelled = true; };
+		    }, [reloadKey]);
+
+		    // 位置/尺寸持久化
+		    useEffect(() => {
+		      try { localStorage.setItem(LS_GRAPH_GEOMETRY, JSON.stringify(geometry)); } catch { /* ignore */ }
+		    }, [geometry]);
+
+		    useEffect(() => {
+		      try { localStorage.setItem(LS_LOCAL_DEPTH, String(localDepth)); } catch { /* ignore */ }
+		    }, [localDepth]);
+
+		    // 拖动标题栏移动面板（按钮上不触发）
+		    const beginPanelDrag = useCallback((e) => {
+		      if (e.target && e.target.closest && e.target.closest("button")) return;
+		      e.preventDefault();
+		      const el = e.currentTarget && e.currentTarget.parentElement;
+		      const base = { x: geometry.x !== null ? geometry.x : (el && typeof el.getBoundingClientRect === "function" ? el.getBoundingClientRect().left : 80), y: geometry.y };
+		      panelDragRef.current = { startX: e.clientX, startY: e.clientY, base };
+		      const onMove = (ev) => {
+		        const st = panelDragRef.current;
+		        if (!st) return;
+		        setGeometry((prev) => ({
+		          ...prev,
+		          x: Math.min(Math.max(0, st.base.x + ev.clientX - st.startX), Math.max(0, window.innerWidth - 240)),
+		          y: Math.min(Math.max(8, st.base.y + ev.clientY - st.startY), Math.max(8, window.innerHeight - 120)),
+		        }));
+		      };
+		      const onUp = () => {
+		        panelDragRef.current = null;
+		        window.removeEventListener("mousemove", onMove);
+		        window.removeEventListener("mouseup", onUp);
+		      };
+		      window.addEventListener("mousemove", onMove);
+		      window.addEventListener("mouseup", onUp);
+		    }, [geometry.x, geometry.y]);
+
+		    // 右下角缩放面板
+		    const beginPanelResize = useCallback((e) => {
+		      e.preventDefault();
+		      e.stopPropagation();
+		      resizeRef.current = { startX: e.clientX, startY: e.clientY, baseW: geometry.width, baseH: geometry.height };
+		      const onMove = (ev) => {
+		        const st = resizeRef.current;
+		        if (!st) return;
+		        setGeometry((prev) => ({
+		          ...prev,
+		          width: Math.min(Math.max(560, st.baseW + ev.clientX - st.startX), Math.round(window.innerWidth * 0.96)),
+		          height: Math.min(Math.max(360, st.baseH + ev.clientY - st.startY), Math.round(window.innerHeight * 0.94)),
+		        }));
+		      };
+		      const onUp = () => {
+		        resizeRef.current = null;
+		        window.removeEventListener("mousemove", onMove);
+		        window.removeEventListener("mouseup", onUp);
+		      };
+		      window.addEventListener("mousemove", onMove);
+		      window.addEventListener("mouseup", onUp);
+		    }, [geometry.width, geometry.height]);
+
+		    const currentRel = currentNote && currentNote.rel ? currentNote.rel : null;
+		    const focusId = currentRel !== null ? `note:${currentRel}` : null;
+		    const localAvailable = data !== null && focusId !== null && data.nodes.some((node) => node.id === focusId);
+		    const shown = useMemo(() => {
+		      if (data === null) return { nodes: [], edges: [] };
+		      if (mode === "local" && localAvailable) {
+		        const sub = graphModule.localSubgraph(data, focusId, localDepth);
+		        return { nodes: sub.nodes, edges: sub.edges };
+		      }
+		      return { nodes: data.nodes, edges: data.edges };
+		    }, [data, mode, localAvailable, focusId, localDepth]);
+		    const plan = useMemo(
+		      () => graphModule.layoutGraph(shown.nodes, shown.edges, { seed, maxNodes: 420 }),
+		      [shown, seed],
+		    );
+
+		    // 打开 / 切换范围 / 重新布局后把整张图适配进画布
+		    useEffect(() => {
+		      const el = wrapRef.current;
+		      if (!el || plan.nodes.length === 0) return;
+		      const w = el.clientWidth || 900;
+		      const h = el.clientHeight || 560;
+		      const fit = Math.min((w - 30) / plan.width, (h - 30) / plan.height, 1);
+		      setTransform({ x: (w - plan.width * fit) / 2, y: (h - plan.height * fit) / 2, s: fit });
+		    }, [plan, fitKey]);
+
+		    const onWheel = useCallback((e) => {
+		      if (plan.nodes.length === 0) return;
+		      if (e.cancelable !== false && e.preventDefault) e.preventDefault();
+		      const rect = e.currentTarget && e.currentTarget.getBoundingClientRect
+		        ? e.currentTarget.getBoundingClientRect()
+		        : { left: 0, top: 0 };
+		      const px = (e.clientX || 0) - rect.left;
+		      const py = (e.clientY || 0) - rect.top;
+		      setTransform((prev) => {
+		        const next = Math.min(4, Math.max(0.18, prev.s * (e.deltaY > 0 ? 0.9 : 1.11)));
+		        const k = next / prev.s;
+		        return { s: next, x: px - (px - prev.x) * k, y: py - (py - prev.y) * k };
+		      });
+		    }, [plan.nodes.length]);
+		    const onMouseDown = useCallback((e) => {
+		      if (e.button !== undefined && e.button !== 0) return;
+		      dragRef.current = { x: e.clientX, y: e.clientY, ox: transform.x, oy: transform.y };
+		    }, [transform.x, transform.y]);
+		    const onMouseMove = useCallback((e) => {
+		      const drag = dragRef.current;
+		      if (!drag) return;
+		      setTransform((prev) => ({ ...prev, x: drag.ox + (e.clientX - drag.x), y: drag.oy + (e.clientY - drag.y) }));
+		    }, []);
+		    const endDrag = useCallback(() => { dragRef.current = null; }, []);
+
+		    const neighbourSet = useMemo(() => {
+		      if (hovered === null) return null;
+		      const set = new Set([hovered]);
+		      for (const edge of shown.edges) {
+		        if (edge.source === hovered) set.add(edge.target);
+		        if (edge.target === hovered) set.add(edge.source);
+		      }
+		      return set;
+		    }, [hovered, shown.edges]);
+
+		    const fitLabel = (text, maxUnits) => {
+		      let out = "";
+		      let units = 0;
+		      for (const ch of text) {
+		        const w = /[\u2E80-\u9FFF\uF900-\uFAFF\u3000-\u303F\uFF00-\uFFEF]/.test(ch) ? 2 : 1;
+		        if (units + w > maxUnits) return `${out}…`;
+		        out += ch;
+		        units += w;
+		      }
+		      return out;
+		    };
+		    const showAllLabels = plan.nodes.length <= 150;
+
+		    // 小按钮工厂：分段控件（全库/局部/聚焦）+ 右侧图标按钮，统一尺寸，永不换行
+		    const modeButton = (label, active, onClick, options = {}) => createElement("button", {
+		      className: "dsh-obs-mini",
+		      style: {
+		        flex: "none",
+		        width: "auto",
+		        height: 24,
+		        padding: "0 10px",
+		        border: "none",
+		        borderRight: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+		        borderRadius: 0,
+		        background: active ? "var(--dsw-alias-interactive-bg-hover-accent, rgba(99,102,241,.18))" : "transparent",
+		        color: active ? "var(--dsw-alias-brand-primary, #8b7cf6)" : "var(--dsw-alias-label-secondary, #b3b8c2)",
+		        whiteSpace: "nowrap",
+		        cursor: options.disabled === true ? "not-allowed" : "pointer",
+		        opacity: options.disabled === true ? 0.45 : 1,
+		      },
+		      disabled: options.disabled === true,
+		      title: options.title,
+		      onClick,
+		    }, label);
+		    const iconButton = (glyph, title, onClick) => createElement("button", {
+		      className: "dsh-obs-mini",
+		      style: { flex: "none", width: "auto", height: 24, minWidth: 24, padding: "0 4px" },
+		      title,
+		      onClick,
+		    }, glyph);
+
+		    const head = createElement("div", {
+		      className: "dsh-obs-graph-head",
+		      title: t("graphMove"),
+		      onMouseDown: beginPanelDrag,
+		      style: {
+		        display: "flex",
+		        alignItems: "center",
+		        gap: 10,
+		        padding: "8px 12px",
+		        borderBottom: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+		        cursor: "move",
+		        userSelect: "none",
+		        flex: "none",
+		      },
+		    },
+		      createElement("div", {
+		        className: "dsh-obs-graph-title",
+		        style: { whiteSpace: "nowrap", flex: "none" },
+		      }, `🕸 ${t("graph")}`),
+		      data !== null && createElement("div", {
+		        className: "dsh-obs-graph-stats",
+		        style: { minWidth: 0, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap", flex: "0 1 auto" },
+		      }, t("graphStats", { notes: data.stats.notes, tags: data.stats.tags, edges: data.stats.edges })),
+		      // 右侧控制区整体作为一块：分段按钮组（全库/局部/聚焦）+ 局部跳数 + 图标按钮
+		      createElement("div", {
+		        style: { display: "flex", alignItems: "center", gap: 10, marginLeft: "auto", flex: "none" },
+		      },
+		        createElement("div", {
+		          className: "dsh-obs-graph-modes",
+		          style: {
+		            display: "flex",
+		            alignItems: "center",
+		            flex: "none",
+		            border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+		            borderRadius: 8,
+		            overflow: "hidden",
+		            width: "auto",
+		          },
+		        },
+		          modeButton(t("graphGlobal"), mode === "global", () => setMode("global")),
+		          modeButton(t("graphLocal"), mode === "local", () => setMode("local"), {
+		            disabled: !localAvailable,
+		            title: localAvailable ? t("graphLocalHint") : t("graphNoNote"),
+		          }),
+		          modeButton(t("graphFocus"), false, () => {
+		            if (!localAvailable) return;
+		            setMode("local");
+		            setFitKey((v) => v + 1);
+		          }, {
+		            disabled: !localAvailable,
+		            title: localAvailable ? t("graphFocusHint") : t("graphNoNote"),
+		          }),
+		        ),
+		        // 局部模式：跳数（与 Obsidian 局部图谱 depth 滑杆同范围 1–5）
+		        mode === "local" && createElement("span", {
+		          className: "dsh-obs-graph-depth",
+		          style: { display: "flex", alignItems: "center", gap: 2, flex: "none" },
+		          title: t("graphDepthHint"),
+		        },
+		          createElement("span", {
+		            className: "dsh-obs-graph-depth-label",
+		            style: { fontSize: 11, marginRight: 2, whiteSpace: "nowrap" },
+		          }, t("graphDepth")),
+		          [1, 2, 3, 4, 5].map((depth) => createElement("button", {
+		            key: depth,
+		            className: `dsh-obs-mini${localDepth === depth ? " dsh-obs-on" : ""}`,
+		            style: { flex: "none", width: "auto", height: 24, minWidth: 22, padding: "0 5px", whiteSpace: "nowrap" },
+		            onClick: () => setLocalDepth(depth),
+		          }, String(depth))),
+		        ),
+		        createElement("div", { style: { display: "flex", alignItems: "center", gap: 2, flex: "none" } },
+		          iconButton("↻", t("graphRerun"), () => setSeed((v) => v + 1)),
+		          iconButton("⟳", t("graphRefresh"), () => setReloadKey((v) => v + 1)),
+		          iconButton("✕", t("graphClose"), onClose),
+		        ),
+		      ),
+		    );
+
+		    let body;
+		    if (loading) {
+		      body = createElement("div", { className: "dsh-obs-graph-empty" },
+		        buildProgress !== null
+		          ? t("graphBuilding", { done: buildProgress.done, total: buildProgress.total })
+		          : t("graphLoading"));
+		    } else if (error !== "") {
+		      body = createElement("div", { className: "dsh-obs-graph-error" },
+		        createElement("div", { className: "dsh-obs-graph-error-icon" }, "⚠️"),
+		        createElement("div", { className: "dsh-obs-graph-error-title" }, t("graphErrorTitle")),
+		        createElement("div", { className: "dsh-obs-graph-error-text" }, t("graphError", { msg: error })),
+		        createElement("div", { className: "dsh-obs-graph-error-actions" },
+		          createElement("button", { className: "dsh-obs-primary", onClick: () => setReloadKey((v) => v + 1) }, `↻ ${t("graphRetry")}`),
+		          createElement("button", {
+		            onClick: () => setDetailsOpen((v) => !v),
+		          }, detailsOpen ? t("graphDetailsHide") : t("graphDetails")),
+		        ),
+		        detailsOpen && createElement("pre", { className: "dsh-obs-graph-error-details" }, error),
+		      );
+		    } else if (plan.nodes.length === 0) {
+		      body = createElement("div", { className: "dsh-obs-graph-empty" },
+		        mode === "local" ? t("graphNoNote") : t("graphEmpty"));
+		    } else {
+		      const planById = new Map(plan.nodes.map((node) => [node.id, node]));
+		      body = createElement("div", {
+		        ref: wrapRef,
+		        className: "dsh-obs-graph-canvas",
+		        style: { position: "relative", flex: 1, minHeight: 0, overflow: "hidden", cursor: "grab" },
+		        onWheel,
+		        onMouseDown,
+		        onMouseMove,
+		        onMouseUp: endDrag,
+		        onMouseLeave: endDrag,
+		      },
+		        createElement("svg", { className: "dsh-obs-graph-svg" },
+		          createElement("g", { transform: `translate(${transform.x},${transform.y}) scale(${transform.s})` },
+		            shown.edges.map((edge) => {
+		              const a = planById.get(edge.source);
+		              const b = planById.get(edge.target);
+		              if (!a || !b) return null;
+		              const active = neighbourSet !== null && (neighbourSet.has(edge.source) || neighbourSet.has(edge.target));
+		              return createElement("line", {
+		                key: `${edge.source}-${edge.target}`,
+		                className: `dsh-obs-graph-edge${active ? " dsh-obs-graph-edge-on" : ""}`,
+		                x1: a.x,
+		                y1: a.y,
+		                x2: b.x,
+		                y2: b.y,
+		              });
+		            }),
+		            plan.nodes.map((node) => {
+		              const isTag = node.kind === "tag";
+		              const radius = isTag ? 7 : 4 + Math.min(9, node.degree * 1.5);
+		              const dim = neighbourSet !== null && !neighbourSet.has(node.id);
+		              const cls = `dsh-obs-graph-node ${isTag ? "dsh-obs-graph-tag" : "dsh-obs-graph-note"}`
+		                + `${node.id === hovered ? " dsh-obs-graph-sel" : ""}${dim ? " dsh-obs-graph-dim" : ""}`
+		                + `${focusId !== null && node.id === focusId ? " dsh-obs-graph-focus" : ""}`;
+		              const label = showAllLabels || node.degree >= 5 || node.id === hovered
+		                ? fitLabel(node.label, 26)
+		                : "";
+		              return createElement("g", {
+		                key: node.id,
+		                className: cls,
+		                transform: `translate(${node.x},${node.y})`,
+		                onMouseEnter: () => setHovered(node.id),
+		                onMouseLeave: () => setHovered(null),
+		                onClick: (e) => {
+		                  if (e && e.stopPropagation) e.stopPropagation();
+		                  if (!isTag && onOpenNote) onOpenNote(node.path, node.label);
+		                  else setHovered(node.id);
+		                },
+		              },
+		                createElement(isTag ? "rect" : "circle", isTag
+		                  ? { x: -radius, y: -radius, width: radius * 2, height: radius * 2, rx: 3 }
+		                  : { r: radius }),
+		                createElement("title", null, node.label),
+		                label !== "" && createElement("text", { x: radius + 6, y: 4 }, label),
+		              );
+		            }),
+		          ),
+		        ),
+		      );
+		    }
+
+		    const truncatedNote = plan.truncated ? t("graphTruncated", { n: plan.nodes.length }) : t("graphHint");
+		    // 关键布局全部走内联样式：即使插件的 <style> 注入失败（旧 bundle / 特殊宿主），
+		    // 面板也不会变成左上角裸文本；z-index 也内联，避免被宿主容器压住。
+		    const defaultX = typeof window !== "undefined"
+		      ? Math.max(16, Math.round((window.innerWidth - geometry.width) / 2))
+		      : 80;
+		    const style = {
+		      position: "fixed",
+		      left: geometry.x === null ? defaultX : geometry.x,
+		      top: geometry.y,
+		      width: geometry.width,
+		      height: geometry.height,
+		      zIndex: 2147483000,
+		      display: "flex",
+		      flexDirection: "column",
+		      boxSizing: "border-box",
+		      overflow: "hidden",
+		      background: "var(--dsw-alias-bg-overlay, #1f2328)",
+		      color: "var(--dsw-alias-label-primary, #e6e6e6)",
+		      border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.15))",
+		      borderRadius: 14,
+		      boxShadow: "0 24px 64px rgba(0,0,0,.45)",
+		    };
+		    return createElement("div", {
+		      className: "dsh-obs-graph",
+		      role: "dialog",
+		      "aria-label": t("graph"),
+		      style,
+		    },
+		      head,
+		      body,
+		      createElement("div", {
+		        className: "dsh-obs-graph-hint",
+		        style: {
+		          flex: "none",
+		          display: "flex",
+		          alignItems: "center",
+		          gap: 12,
+		          padding: "6px 14px",
+		          borderTop: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))",
+		          fontSize: 11,
+		          color: "var(--dsw-alias-label-tertiary, #9aa0aa)",
+		        },
+		      },
+		        createElement("span", {
+		          style: { minWidth: 0, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap", flex: "0 1 auto" },
+		        }, truncatedNote),
+		        createElement("span", {
+		          className: "dsh-obs-graph-legend",
+		          style: { display: "flex", alignItems: "center", gap: 10, flex: "none", marginLeft: "auto", whiteSpace: "nowrap" },
+		        },
+		          createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: 4 } },
+		            createElement("span", { className: "dsh-obs-legend-dot" }), t("graphLegendNote")),
+		          createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: 4 } },
+		            createElement("span", { className: "dsh-obs-legend-tag" }), t("graphLegendTag")),
+		          createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: 4 } },
+		            createElement("span", { className: "dsh-obs-legend-focus" }), t("graphLegendFocus")),
+		          createElement("span", { style: { display: "inline-flex", alignItems: "center", gap: 4 } },
+		            createElement("span", { className: "dsh-obs-legend-link" }), t("graphLegendLink")),
+		        ),
+		      ),
+		      createElement("div", { className: "dsh-obs-graph-resize", title: t("resize"), onMouseDown: beginPanelResize }),
+		    );
+		  }
+
+		  /** shell.overlay 包装：只有 shared.graphOpen 时才挂载 GraphView（关闭即卸载）。 */
+		  function GraphOverlay({ t }) {
+		    const { graphOpen, openNote } = useShared();
+		    if (!graphOpen) return null;
+		    return createElement(GraphView, {
+		      t,
+		      currentNote: openNote,
+		      onOpenNote: (rel, name) => patchShared({ openNote: { rel, name } }),
+		      onClose: () => patchShared({ graphOpen: false }),
+		    });
+		  }
+
 		  // ── 右侧笔记 Dock（shell.overlay）──────────────────────────────────────────
+
+		  /**
+		   * 思维导图视图（B1）：把 note.content 的标题/列表画成横向树。
+		   * - 滚轮缩放（以指针为中心）/ 拖动平移；
+		   * - 单击节点：选中并显示操作条（跳到源码行 / 把分支插入对话）；
+		   * - 双击节点：直接跳到该节点的源码行。
+		   */
+		  function MindMapView({ note, t, onJumpLine, onAskBranch }) {
+		    const tree = useMemo(
+		      () => mindMapModule.buildTree(note.content, { title: note.name.replace(/\.md$/i, "") }),
+		      [note.content, note.name],
+		    );
+		    const plan = useMemo(() => mindMapModule.layout(tree), [tree]);
+		    const [viewState, setViewState] = useState({ x: 0, y: 14, s: 1 });
+		    const [selected, setSelected] = useState(null);
+		    const dragRef = useRef(null);
+		    const wrapRef = useRef(null);
+		    const hasNodes = plan.nodes.length > 1;
+
+		    // 初始把整张导图缩放进 Dock 可视区（导图比面板宽，不 fit 只能看到最左一列）
+		    useEffect(() => {
+		      const el = wrapRef.current;
+		      if (!el || !hasNodes) return;
+		      const w = el.clientWidth || 480;
+		      const h = el.clientHeight || 320;
+		      // 横向导图比面板宽：只按高度适配（保持字号可读），横向靠拖动平移
+		      const fit = Math.min(1, (h - 28) / plan.height);
+		      setViewState({
+		        x: 10,
+		        y: Math.max(10, (h - plan.height * fit) / 2),
+		        s: fit,
+		      });
+		    }, [plan, hasNodes]);
+
+		    // SVG 无自动省略：按估算字宽截断，完整文本放 <title> 悬停显示
+		    const fitText = (text, width) => {
+		      const maxUnits = Math.max(6, Math.floor((width - 26) / 7.2));
+		      let out = "";
+		      let units = 0;
+		      for (const ch of text) {
+		        const u = /[\u2E80-\u9FFF\uF900-\uFAFF\u3000-\u303F\uFF00-\uFFEF]/.test(ch) ? 2 : 1;
+		        if (units + u > maxUnits) return `${out}…`;
+		        out += ch;
+		        units += u;
+		      }
+		      return out;
+		    };
+
+		    const onWheel = useCallback((e) => {
+		      if (!hasNodes) return;
+		      if (e.cancelable !== false && e.preventDefault) e.preventDefault();
+		      const rect = e.currentTarget && e.currentTarget.getBoundingClientRect
+		        ? e.currentTarget.getBoundingClientRect()
+		        : { left: 0, top: 0 };
+		      const px = (e.clientX || 0) - rect.left;
+		      const py = (e.clientY || 0) - rect.top;
+		      setViewState((prev) => {
+		        const next = Math.min(2.6, Math.max(0.35, prev.s * (e.deltaY > 0 ? 0.88 : 1.14)));
+		        const k = next / prev.s;
+		        return { s: next, x: px - (px - prev.x) * k, y: py - (py - prev.y) * k };
+		      });
+		    }, [hasNodes]);
+
+		    const onMouseDown = useCallback((e) => {
+		      if (e.button !== undefined && e.button !== 0) return;
+		      dragRef.current = { x: e.clientX, y: e.clientY, ox: viewState.x, oy: viewState.y };
+		    }, [viewState.x, viewState.y]);
+		    const onMouseMove = useCallback((e) => {
+		      const drag = dragRef.current;
+		      if (!drag) return;
+		      setViewState((prev) => ({ ...prev, x: drag.ox + (e.clientX - drag.x), y: drag.oy + (e.clientY - drag.y) }));
+		    }, []);
+		    const endDrag = useCallback(() => { dragRef.current = null; }, []);
+
+		    if (!hasNodes) {
+		      return createElement("div", { className: "dsh-obs-map-empty" }, t("mapEmpty"));
+		    }
+
+		    const selectedNode = selected !== null ? plan.byId[selected] : null;
+		    return createElement("div", {
+		      ref: wrapRef,
+		      className: "dsh-obs-map",
+		      onWheel,
+		      onMouseDown,
+		      onMouseMove,
+		      onMouseUp: endDrag,
+		      onMouseLeave: endDrag,
+		    },
+		      createElement("svg", { className: "dsh-obs-map-svg" },
+		        createElement("g", { transform: `translate(${viewState.x},${viewState.y}) scale(${viewState.s})` },
+		          plan.edges.map((edge) => {
+		            const a = plan.byId[edge.from];
+		            const b = plan.byId[edge.to];
+		            if (!a || !b) return null;
+		            const x1 = a.x + a.w;
+		            const x2 = b.x;
+		            const mx = (x1 + x2) / 2;
+		            return createElement("path", {
+		              key: `${edge.from}-${edge.to}`,
+		              className: "dsh-obs-map-edge",
+		              d: `M ${x1} ${a.y} C ${mx} ${a.y}, ${mx} ${b.y}, ${x2} ${b.y}`,
+		            });
+		          }),
+		          plan.nodes.map((node) => createElement("g", {
+		            key: node.id,
+		            className: `dsh-obs-map-node dsh-obs-map-${node.kind}${selected === node.id ? " dsh-obs-map-sel" : ""}`,
+		            transform: `translate(${node.x},${node.y - node.h / 2})`,
+		            onClick: (e) => {
+		              if (e && e.stopPropagation) e.stopPropagation();
+		              setSelected(node.id);
+		            },
+		            onDoubleClick: (e) => {
+		              if (e && e.stopPropagation) e.stopPropagation();
+		              if (node.line > 0) onJumpLine(node.line);
+		            },
+		          },
+		            createElement("rect", { width: node.w, height: node.h, rx: 9 }),
+		            createElement("text", { x: 13, y: node.h / 2 + 5 }, fitText(node.text, node.w)),
+		            createElement("title", null, node.text),
+		          )),
+		        ),
+		      ),
+		      selectedNode !== null && createElement("div", { className: "dsh-obs-map-actions" },
+		        createElement("span", { className: "dsh-obs-map-line" }, `L${selectedNode.line}`),
+		        createElement("button", {
+		          onClick: () => onJumpLine(selectedNode.line),
+		        }, `↩ ${t("mapJump")}`),
+		        createElement("button", {
+		          className: "dsh-obs-primary",
+		          onClick: () => onAskBranch(selectedNode),
+		        }, `⤴ ${t("mapAsk")}`),
+		      ),
+		      createElement("div", { className: "dsh-obs-map-hint" }, t("mapHint")),
+		    );
+		  }
+
 		  function Dock({ t, workspaces }) {
 		    const { openNote, vaultRev } = useShared();
 		    const [note, setNote] = useState(null);
 		    const [root, setRoot] = useState("");
 		    const [editing, setEditing] = useState(false);
+		    // 视图：预览（行号）/ 思维导图；编辑态始终是编辑器
+		    const [view, setView] = useState("preview");
+		    const [jumpLine, setJumpLine] = useState(null);
 		    const [draft, setDraft] = useState("");
 		    const [saving, setSaving] = useState(false);
 		    const [error, setError] = useState("");
@@ -3982,6 +5427,60 @@ window.__ModuleLoader__.load({
 		      patchShared({ openNote: { rel: found.path, name: found.name } });
 		    }, [editing, draft, note, t]);
 
+		    /** 思维导图 → 预览：跳到源码行并短暂高亮（行元素带 data-line）。 */
+		    const jumpToLine = useCallback((line) => {
+		      if (!line || line < 1) return;
+		      setView("preview");
+		      setJumpLine(line);
+		    }, []);
+
+		    /** 思维导图 → 对话：把「该节点 + 全部后代」的源码区间按选区提问同款 prompt 插入输入框。 */
+		    const askBranch = useCallback((node) => {
+		      if (!note) return;
+		      const span = mindMapModule.branchSpan(note.content, node);
+		      const prompt = buildPrompt(
+		        t,
+		        treeApi.absPath(note.path, root),
+		        note.content,
+		        { text: span.text, start: span.start, end: span.end, mode: "preview" },
+		        "",
+		      );
+		      if (injectPrompt(prompt)) {
+		        showToast(t("branchCited", { n: span.endLine - span.startLine + 1 }));
+		        return;
+		      }
+		      try {
+		        if (typeof navigator !== "undefined" && navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
+		          navigator.clipboard.writeText(prompt).then(() => showToast(t("noInput"))).catch(() => showToast(t("citeFail")));
+		        } else {
+		          showToast(t("citeFail"));
+		        }
+		      } catch {
+		        showToast(t("citeFail"));
+		      }
+		    }, [note, t, root]);
+
+		    // 切笔记时回到预览态（避免上一份笔记的导图/跳转状态残留）
+		    useEffect(() => {
+		      setView("preview");
+		      setJumpLine(null);
+		    }, [openNote]);
+
+		    // 预览行高亮：跳到行号后滚动到该行并闪一下（1.8s 后恢复）
+		    useEffect(() => {
+		      if (jumpLine === null || view !== "preview" || !previewRef.current) return undefined;
+		      const el = previewRef.current.querySelector(`[data-line="${jumpLine}"]`);
+		      if (el) {
+		        if (typeof el.scrollIntoView === "function") el.scrollIntoView({ block: "center" });
+		        el.classList.add("dsh-obs-md-flash");
+		      }
+		      const timer = window.setTimeout(() => {
+		        if (el) el.classList.remove("dsh-obs-md-flash");
+		        setJumpLine(null);
+		      }, 1800);
+		      return () => window.clearTimeout(timer);
+		    }, [jumpLine, view, note, vaultRev]);
+
 		    const dirty = editing && note !== null && draft !== note.content;
 
 		    // 编辑态行号（每行一个，对应源码行数；textarea 为 white-space:pre 无折行，行号与文本行一一对齐）
@@ -4005,6 +5504,11 @@ window.__ModuleLoader__.load({
 		          createElement("span", null, "📝"),
 		          createElement("span", null, note ? note.name : openNote.name),
 		        ),
+		        !editing && note && createElement("button", {
+		          className: view === "map" ? "dsh-obs-on" : undefined,
+		          title: view === "map" ? t("preview") : t("mindMap"),
+		          onClick: () => setView((prev) => (prev === "map" ? "preview" : "map")),
+		        }, view === "map" ? `📄 ${t("preview")}` : `🧠 ${t("mindMap")}`),
 		        !editing && note && createElement("button", { onClick: () => void cite() }, `⤴ ${t("cite")}`),
 		        !editing && note && createElement("button", { onClick: () => { setDraft(note.content); setEditing(true); } }, t("edit")),
 		        editing && createElement("button", {
@@ -4056,8 +5560,17 @@ window.__ModuleLoader__.load({
 		              },
 		            }),
 		          )
-		          : createElement("div", { className: "dsh-obs-dock-body" },
-		            createElement("div", { ref: previewRef, className: "dsh-obs-md" },
+		          : view === "map"
+		            ? createElement("div", { className: "dsh-obs-dock-body dsh-obs-dock-map" },
+		              createElement(MindMapView, {
+		                note,
+		                t,
+		                onJumpLine: jumpToLine,
+		                onAskBranch: askBranch,
+		              }),
+		            )
+		            : createElement("div", { className: "dsh-obs-dock-body" },
+		              createElement("div", { ref: previewRef, className: "dsh-obs-md" },
 		              renderNumbered(note.content, {
 		                onWikilink: (target) => void openWikilink(target),
 		                onText: () => {},
@@ -4346,10 +5859,15 @@ window.__ModuleLoader__.load({
 		        { name: "shell.overlay", id: "obsidian-prompt", order: 6, label: "Obsidian text prompt", locale: NS },
 		        Prompt,
 		      );
+		      const d4 = ctx.slots.register(
+		        { name: "shell.overlay", id: "obsidian-graph", order: 32, label: "Obsidian relation graph", locale: NS },
+		        GraphOverlay,
+		      );
 		      return () => {
 		        d1();
 		        d2();
 		        d3();
+		        d4();
 		      };
 		    });
 		  }