From 6f82299e90066bfa8ba059aa92082bc3f3313cbb Mon Sep 17 00:00:00 2001
From: zengjiayi819 <nxcore@nxcoredeMacBook-Pro.local>
Date: Fri, 23 Oct 2026 15:40:12 +0800
Subject: [PATCH 1/6] =?UTF-8?q?feat(desktop):=20=E8=AE=B0=E5=BF=86?=
 =?UTF-8?q?=E7=B2=BE=E9=80=89=E5=8D=A1=E5=9B=BA=E5=AE=9A=E4=B8=89=E8=A1=8C?=
 =?UTF-8?q?=E2=80=94=E2=80=94=E8=B6=85=E5=87=BA=E6=8A=98=E5=8F=A0=E3=80=81?=
 =?UTF-8?q?=E7=82=B9=E5=BC=80=E6=9F=A5=E7=9C=8B=E5=85=A8=E9=83=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 精选卡内容区预留三行，超出行数用 line-clamp 折叠
- 真被截断时才显示「展开/收起」按钮（aria-expanded 同步）
- 展开时卡片自然变高；折叠态就是最小三行状态
- zh-CN/en-US 文案 timeline.expandFeatured / timeline.collapseFeatured
- 新增 tests/memory-featured-expand.test.tsx（2 条，测溢出探测与展开切换）
---
 .../pages/memory/AtomicMemoryPane.tsx         |  41 ++++++-
 .../components/pages/memory/MemoryPage.css    |  60 ++++++++++-
 .../src/i18n/locales/en-US/memory.json        |   2 +
 .../src/i18n/locales/zh-CN/memory.json        |   2 +
 .../tests/memory-featured-expand.test.tsx     | 100 ++++++++++++++++++
 5 files changed, 203 insertions(+), 2 deletions(-)
 create mode 100644 apps/desktop/tests/memory-featured-expand.test.tsx

diff --git a/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx b/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
index 71aefcc6..00a59376 100644
--- a/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
+++ b/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
@@ -312,6 +312,10 @@ export function AtomicMemoryPane({ focusItemId, onOpenDocument, onOpenConversati
   const [expandedId, setExpandedId] = useState<string | null>(null)
   const [reloadTick, setReloadTick] = useState(0)
   const [featuredDismissed, setFeaturedDismissed] = useState(false)
+  // 精选正文固定占三行：超出三行折叠，点「展开」看全文（收起后回到三行状态）。
+  const [featuredExpanded, setFeaturedExpanded] = useState(false)
+  const [featuredClamped, setFeaturedClamped] = useState(false)
+  const featuredContentRef = useRef<HTMLParagraphElement | null>(null)
   // 动态类型 chips 从「累计见过的类型」推导而非当前 items：items 会被类型过滤收窄，
   // 否则一切换筛选，其余动态类型标签会跟着消失，看起来像标签栏自动收起。
   const [knownTypes, setKnownTypes] = useState<string[]>([])
@@ -388,6 +392,25 @@ export function AtomicMemoryPane({ focusItemId, onOpenDocument, onOpenConversati
     })[0]
   }, [filtered, items])
 
+  // 换一条精选（或收起）时回到三行态。
+  useEffect(() => {
+    setFeaturedExpanded(false)
+  }, [featured?.id])
+
+  // 只有真被截断时才给「展开」：量一次 scrollHeight vs clientHeight，
+  // 窗口宽度变化会改变折行，所以跟随 resize 复测。
+  useEffect(() => {
+    if (!featured || featuredExpanded) return
+    const measure = () => {
+      const element = featuredContentRef.current
+      if (!element || typeof element.scrollHeight !== 'number') return
+      setFeaturedClamped(element.scrollHeight > element.clientHeight + 1)
+    }
+    measure()
+    window.addEventListener?.('resize', measure)
+    return () => window.removeEventListener?.('resize', measure)
+  }, [featured?.id, featured?.content, featuredExpanded])
+
   const grouped = useMemo(() => {
     const groups: Array<{ id: TimelineBucketId; label: string; items: MemoryAtomicItemDto[] }> = []
     for (const bucket of TIMELINE_BUCKETS) {
@@ -423,9 +446,25 @@ export function AtomicMemoryPane({ focusItemId, onOpenDocument, onOpenConversati
               {featured.roomTitle ? <span className="mem-featured-scope">仅 Room: {featured.roomTitle}</span> : <span className="mem-featured-scope">全局</span>}
               <span className="mem-featured-flag"><Sparkles aria-hidden="true" />{t('memory:timeline.featured')}</span>
             </div>
-            <p className="mem-featured-content">{featured.content}</p>
+            <p
+              ref={featuredContentRef}
+              className="mem-featured-content"
+              data-expanded={featuredExpanded || undefined}
+            >
+              {featured.content}
+            </p>
             <div className="mem-featured-meta">
               <span>{formatDate(featured.updatedAt, locale)}</span>
+              {featuredClamped || featuredExpanded ? (
+                <button
+                  type="button"
+                  className="mem-featured-toggle"
+                  aria-expanded={featuredExpanded}
+                  onClick={() => setFeaturedExpanded((current) => !current)}
+                >
+                  {t(featuredExpanded ? 'memory:timeline.collapseFeatured' : 'memory:timeline.expandFeatured')}
+                </button>
+              ) : null}
             </div>
           </div>
           <span className="mem-featured-visual" aria-hidden="true">
diff --git a/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css b/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
index 2d1234be..76b5ebb4 100644
--- a/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
+++ b/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
@@ -2262,7 +2262,9 @@ button.mem-search-item:hover {
 .mem-featured-card {
   position: relative;
   display: flex;
-  align-items: flex-start;
+  /* 不写死高度：正文固定占三行 → 收起时卡片恒等于「最小三行状态」；
+     点「展开」看全文时卡片自然长高（超出三行的部分默认折叠）。 */
+  align-items: center;
   gap: 10px;
   margin-bottom: 14px;
   padding: 12px 14px;
@@ -2290,8 +2292,10 @@ button.mem-search-item:hover {
 .mem-featured-body {
   display: flex;
   min-width: 0;
+  min-height: 0;
   flex: 1;
   flex-direction: column;
+  justify-content: center;
   gap: 5px;
 }
 
@@ -2299,6 +2303,8 @@ button.mem-search-item:hover {
   display: flex;
   align-items: center;
   gap: 6px;
+  min-width: 0;
+  flex-wrap: nowrap;
 }
 
 .mem-featured-tags time {
@@ -2325,11 +2331,22 @@ button.mem-search-item:hover {
 
 .mem-featured-content {
   margin: 0;
+  /* 三行占位：内容不足三行也按三行算，卡片尺寸稳定在「最小三行状态」 */
+  min-height: calc(1.6em * 3);
   color: var(--cr-text, var(--text));
   font-size: 12.5px;
   line-height: 1.6;
 }
 
+/* 展开：解除三行截断，显示全文（卡片随内容长高） */
+.mem-featured-content[data-expanded] {
+  display: block;
+  min-height: 0;
+  overflow: visible;
+  -webkit-box-orient: initial;
+  -webkit-line-clamp: unset;
+}
+
 .mem-featured-dismiss {
   position: absolute;
   top: 8px;
@@ -2495,9 +2512,50 @@ button.mem-search-item:hover {
   z-index: 1;
 }
 
+.mem-featured-meta {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  /* 与「展开」按钮同高：有没有展开入口，这一行的高度都一致 → 卡片收起态恒为三行高度 */
+  min-height: 20px;
+  color: var(--cr-muted, var(--muted));
+  font-size: 10px;
+}
+
+/* 展开/收起：轻量文字按钮，不抢精选视觉 */
+.mem-featured-toggle {
+  display: inline-flex;
+  align-items: center;
+  height: 20px;
+  padding: 0 8px;
+  border: 1px solid color-mix(in srgb, var(--cr-blue, var(--accent)) 35%, transparent);
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--cr-blue, var(--accent)) 8%, transparent);
+  color: var(--cr-blue, var(--accent));
+  cursor: pointer;
+  font: inherit;
+  font-size: 10px;
+  font-weight: 600;
+  line-height: 1;
+}
+
+.mem-featured-toggle:hover {
+  background: color-mix(in srgb, var(--cr-blue, var(--accent)) 16%, transparent);
+}
+
+.mem-featured-toggle[aria-expanded='true'] {
+  border-color: color-mix(in srgb, var(--cr-blue, var(--accent)) 22%, transparent);
+  background: transparent;
+  color: var(--cr-muted, var(--muted));
+}
+
 .mem-featured-scope {
+  min-width: 0;
+  overflow: hidden;
   color: var(--cr-muted, var(--muted));
   font-size: 10px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
 /* 长内容截断：摘要两行，展开（AtomicDetail）看全文。 */
diff --git a/apps/desktop/src/renderer/src/i18n/locales/en-US/memory.json b/apps/desktop/src/renderer/src/i18n/locales/en-US/memory.json
index 1d602ae2..dde3bae6 100644
--- a/apps/desktop/src/renderer/src/i18n/locales/en-US/memory.json
+++ b/apps/desktop/src/renderer/src/i18n/locales/en-US/memory.json
@@ -410,6 +410,8 @@
   "timeline.last7days": "Last 7 days",
   "timeline.last30days": "Last 30 days",
   "timeline.featured": "Featured",
+  "timeline.expandFeatured": "Show all",
+  "timeline.collapseFeatured": "Collapse",
   "timeline.dismissFeatured": "Dismiss featured",
   "timeline.matches": "Match {score}",
   "timeline.detail": "Details",
diff --git a/apps/desktop/src/renderer/src/i18n/locales/zh-CN/memory.json b/apps/desktop/src/renderer/src/i18n/locales/zh-CN/memory.json
index 7dd3ec7e..c4fb30d4 100644
--- a/apps/desktop/src/renderer/src/i18n/locales/zh-CN/memory.json
+++ b/apps/desktop/src/renderer/src/i18n/locales/zh-CN/memory.json
@@ -410,6 +410,8 @@
   "timeline.last7days": "近 7 天",
   "timeline.last30days": "近 30 天",
   "timeline.featured": "精选",
+  "timeline.expandFeatured": "展开",
+  "timeline.collapseFeatured": "收起",
   "timeline.dismissFeatured": "暂不显示精选",
   "timeline.matches": "匹配度 {score}",
   "timeline.detail": "详情",
diff --git a/apps/desktop/tests/memory-featured-expand.test.tsx b/apps/desktop/tests/memory-featured-expand.test.tsx
new file mode 100644
index 00000000..d3c39810
--- /dev/null
+++ b/apps/desktop/tests/memory-featured-expand.test.tsx
@@ -0,0 +1,100 @@
+import TestRenderer, { act } from 'react-test-renderer'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import type { MemoryAtomicItemDto } from '../src/shared/memory'
+
+const listAtomicMock = vi.fn()
+
+import { AtomicMemoryPane } from '../src/renderer/src/components/pages/memory/AtomicMemoryPane'
+
+function item(overrides: Partial<MemoryAtomicItemDto> & Pick<MemoryAtomicItemDto, 'id'>): MemoryAtomicItemDto {
+  return {
+    type: 'episodic',
+    content: `记忆 ${overrides.id}`,
+    background: null,
+    createdAt: '2026-09-01T00:00:00.000Z',
+    updatedAt: '2026-09-01T00:00:00.000Z',
+    roomId: null,
+    roomTitle: null,
+    score: 0,
+    ...overrides,
+  }
+}
+
+function textOf(node: TestRenderer.ReactTestInstance): string {
+  return node.children.flatMap((child) => {
+    if (typeof child === 'string') return [child]
+    if (child && typeof child === 'object' && 'children' in child) return [textOf(child)]
+    return []
+  }).join('')
+}
+
+/**
+ * 精选正文的「三行折叠 + 展开」：
+ * 布局量（scrollHeight/clientHeight）在 react-test-renderer 里没有真实布局，
+ * 这里用 createNodeMock 给 <p> 造一个"被截断"的节点，驱动真实的溢出判定分支。
+ */
+async function renderPane(clamped: boolean) {
+  let renderer!: TestRenderer.ReactTestRenderer
+  await act(async () => {
+    renderer = TestRenderer.create(<AtomicMemoryPane />, {
+      createNodeMock: (element) => (
+        element.type === 'p'
+          ? { scrollHeight: clamped ? 240 : 60, clientHeight: 60 }
+          : null
+      ),
+    })
+  })
+  return renderer
+}
+
+describe('AtomicMemoryPane 精选三行折叠', () => {
+  beforeEach(() => {
+    listAtomicMock.mockReset()
+    listAtomicMock.mockResolvedValue({
+      items: [
+        item({ id: 'memory-long', content: '很长的一条精选记忆内容，'.repeat(40), score: 9 }),
+        item({ id: 'memory-short', content: '短记忆', score: 1 }),
+      ],
+      total: 2,
+    })
+    ;(globalThis as { window?: unknown }).window = {
+      nxcore: { memory: { listAtomic: listAtomicMock, setAtomicRoom: vi.fn() } },
+      dispatchEvent: vi.fn(),
+      addEventListener: vi.fn(),
+      removeEventListener: vi.fn(),
+    }
+  })
+
+  it('默认三行折叠，超出时给「展开」，点击后显示全文并可「收起」', async () => {
+    const renderer = await renderPane(true)
+    const content = renderer.root.findByProps({ className: 'mem-featured-content' })
+
+    // 收起态：没有 data-expanded，正文由 CSS 三行截断
+    expect(content.props['data-expanded']).toBeUndefined()
+    expect(content.children.join('')).toContain('很长的一条精选记忆内容')
+
+    const toggle = renderer.root.findAllByType('button')
+      .find((button) => textOf(button) === '展开')
+    expect(toggle).toBeTruthy()
+    expect(toggle!.props['aria-expanded']).toBe(false)
+
+    await act(async () => { toggle!.props.onClick() })
+
+    const expanded = renderer.root.findByProps({ className: 'mem-featured-content' })
+    expect(expanded.props['data-expanded']).toBe(true)
+    const collapse = renderer.root.findAllByType('button')
+      .find((button) => textOf(button) === '收起')
+    expect(collapse).toBeTruthy()
+    expect(collapse!.props['aria-expanded']).toBe(true)
+
+    await act(async () => { collapse!.props.onClick() })
+    expect(renderer.root.findByProps({ className: 'mem-featured-content' }).props['data-expanded']).toBeUndefined()
+  })
+
+  it('内容只有一行时不显示「展开」入口', async () => {
+    const renderer = await renderPane(false)
+
+    expect(renderer.root.findAllByType('button').some((button) => textOf(button) === '展开')).toBe(false)
+    expect(renderer.root.findAllByProps({ className: 'mem-featured-toggle' })).toHaveLength(0)
+  })
+})

From 0698af8392d48d0aaeb2dcc1c3c0491f78d75ec3 Mon Sep 17 00:00:00 2001
From: zengjiayi819 <nxcore@nxcoredeMacBook-Pro.local>
Date: Fri, 23 Oct 2026 15:40:55 +0800
Subject: [PATCH 2/6] =?UTF-8?q?feat(desktop):=20=E5=85=B3=E7=B3=BB?=
 =?UTF-8?q?=E5=9B=BE=E8=B0=B1=E7=A7=BB=E5=87=BA=E7=94=BB=E5=B8=83=205s=20?=
 =?UTF-8?q?=E8=87=AA=E5=8A=A8=E5=A4=8D=E4=BD=8D=E2=80=94=E2=80=941s=20?=
 =?UTF-8?q?=E6=85=A2=E5=BC=B9=E7=B0=A7=E5=9B=9E=E4=BD=8D=20+=20=E5=87=A0?=
 =?UTF-8?q?=E4=BD=95=E5=B1=85=E4=B8=AD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

触发（RoomGraphCanvas）：
- 鼠标在画布内图谱绝不动；移出画布满 5s 才回位（离开才开始倒计时）
- 拖拽/滚轮改过视口才武装；点节点、3px 内抖动不算改视口
- 移回画布取消待触发；补间播到一半回画布会立刻定住并重新武装
- autoFitOnIdleMs=0 关闭；老画布无补间能力时退回瞬时对准
- 移除右上角「适应画布」按钮，RelationsPane/HomeView 改传 autoFitOnIdleMs

补间（PixiForceGraphRenderer）：
- 弃用 pixi-viewport 的 Animate 插件：它按 Penner 签名 ease(elapsed,0,1,d)
  调用自定义 ease，且以世界宽度为插值量——之前的弹簧曲线实际被塌缩成瞬跳
- 改为由共享 ticker 逐帧驱动：scale 与画面中心按弹簧值线性插值，
  与预览页 scratch/spring-fit-demo.html 的数学一致
- F 慢弹簧（ζ0.38 / ω10，1s）：放大→缩小交替衰减后精确落定
- animateFitView/cancelFitAnimation 进句柄；cancel 返回是否真停了一段在播补间

居中修正：
- fitView 复位/居中改用节点几何中心；底边 24px 标签预留只参与算缩放
  （此前中心被标签预留带偏 12 世界像素，内容固定上偏）
- 补间终点即精确目标，无残留偏差

测试：
- room-graph-canvas-autofit 重写为离开触发语义（8 条全绿）
- pixi-force-graph-renderer 补真实轨迹断言（第一帧不瞬跳、峰值过冲、
  回摆、1s 末精确落位、取消即停）；25/28 过，3 条失败为 dev 基线
---
 .../ported/components/HomeView.tsx            |  16 +-
 .../ported/components/RoomGraphCanvas.tsx     |  98 +++++++-
 .../detail-panels/RelationsPane.tsx           |  37 ++-
 .../components/graph/PixiForceGraphCanvas.tsx |  10 +
 .../graph/pixi/PixiForceGraphRenderer.ts      | 157 +++++++++++-
 .../graph/pixi/pixiForceGraphTypes.ts         |  14 ++
 .../context-room-home-graph-fit.test.tsx      |  30 +--
 .../context-room-relations-pane.test.tsx      |  29 +--
 .../tests/pixi-force-graph-renderer.test.ts   | 155 +++++++++++-
 .../tests/room-graph-canvas-autofit.test.tsx  | 223 ++++++++++++++++++
 10 files changed, 679 insertions(+), 90 deletions(-)
 create mode 100644 apps/desktop/tests/room-graph-canvas-autofit.test.tsx

diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/HomeView.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/HomeView.tsx
index f92df9d9..cd90a53c 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/HomeView.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/HomeView.tsx
@@ -7,7 +7,7 @@ import {
   Search,
   Trash2,
 } from 'lucide-react';
-import { useEffect, useMemo, useRef, useState } from 'react';
+import { useEffect, useMemo, useState } from 'react';
 import { useLocale } from '../../../../i18n/LocaleContext';
 
 import type { ContextRoomRecord } from '../types';
@@ -18,13 +18,15 @@ import { RoomCard } from './RoomCard';
 import { RoomCreationStudio } from './RoomCreationStudio';
 import { RoomLifecycleDialogs } from './RoomDialogs';
 import { isMergeRecommendationCandidate, RoomDuplicateCenter } from './RoomDuplicateCenter';
-import { GraphFitButton } from './GraphFitButton';
-import { RoomGraphCanvas, type RoomGraphCanvasHandle } from './RoomGraphCanvas';
+import { RoomGraphCanvas } from './RoomGraphCanvas';
 import { RoomNodeInspector } from './RoomGraphInspector';
 import { RoomRelationInspector } from './RoomRelationControls';
 import { useRoomRelationGraph } from '../hooks/useRoomRelationGraph';
 import { roomKindIcon, roomKindTone } from './utils';
 
+/** 首页 Room 关系图谱：缩放/拖拽后鼠标静止多久自动复位到自适应视野。 */
+const HOME_GRAPH_AUTO_FIT_IDLE_MS = 5_000;
+
 function RoomGraph({
   rooms,
   onOpen,
@@ -38,11 +40,10 @@ function RoomGraph({
   const { error, graph, loading, reload } = useRoomRelationGraph(null);
   const selected = rooms.find((room) => room.id === selectedId);
   const selectedRelation = (graph?.edges ?? []).find((edge) => edge.id === selectedRelationId) ?? null;
-  const graphRef = useRef<RoomGraphCanvasHandle>(null);
 
   // 首页图谱对齐原型：无工具栏（搜索/筛选/关系管理收进 Room 详情的关系面板），
-  // 只保留标题 + 画布 + 点选节点/关系出检查器；另加一颗常驻画布的自适应按钮，
-  // 因为视口能自由缩放平移，缩到最小或拖走后整张图会看不见。
+  // 只保留标题 + 画布 + 点选节点/关系出检查器。视口可自由缩放平移，
+  // 不设「适应画布」按钮：缩放/拖拽后鼠标静止满 5 秒自动弹性复位。
   return (
     <section className="context-room-home-section context-room-home-graph-section">
       <div className="context-room-home-section-title context-room-graph-heading">
@@ -52,7 +53,7 @@ function RoomGraph({
         <div className="context-room-room-graph-canvas">
           {loading && !graph ? <div className="context-room-graph-state">{t('contextRoom:relations.loadingGraph')}</div> : (
             <RoomGraphCanvas
-              ref={graphRef}
+              autoFitOnIdleMs={HOME_GRAPH_AUTO_FIT_IDLE_MS}
               rooms={rooms}
               relations={graph?.edges ?? []}
               selectedId={selectedId}
@@ -62,7 +63,6 @@ function RoomGraph({
               onOpenRoom={onOpen}
             />
           )}
-          {graph ? <GraphFitButton onFit={() => void graphRef.current?.fitView()} /> : null}
           {error ? <div className="context-room-graph-degraded">{t('contextRoom:relations.degradedNoSyntheticEdges')}</div> : null}
         </div>
         {selectedRelation ? (
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
index 9e767a36..329daa2e 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
@@ -1,6 +1,7 @@
 import {
   forwardRef,
   useCallback,
+  useEffect,
   useImperativeHandle,
   useMemo,
   useRef,
@@ -37,6 +38,14 @@ interface RoomGraphCanvasProps {
   onOpenRoom: (roomId: string) => void
   onSelectRelation?: (relationId: string) => void
   onSelectRoom: (roomId: string | null) => void
+  /**
+   * 「无操作自动复位」的空闲阈值（毫秒）；不传 = 关闭。
+   *
+   * 语义：用户改过视口（缩放 / 平移拖拽）之后，鼠标在图谱上**静止**满 N 毫秒 →
+   * 弹性补间回到自适应视野。只点击节点（没移动、视口没变）不会复位；
+   * 鼠标离开画布立刻停表，不在后台触发；期间任何 mousemove 都重新计时。
+   */
+  autoFitOnIdleMs?: number
 }
 
 const ROOM_KIND_COLORS: Record<ContextRoomKind, number> = {
@@ -67,6 +76,7 @@ function RoomGraphCanvasComponent(
     onOpenRoom,
     onSelectRelation,
     onSelectRoom,
+    autoFitOnIdleMs = 0,
   }: RoomGraphCanvasProps,
   ref: React.ForwardedRef<RoomGraphCanvasHandle>,
 ) {
@@ -151,6 +161,78 @@ function RoomGraphCanvasComponent(
     canvasRef,
     settleFit,
   })
+  // 「无操作自动复位」：只有视口真被用户改动过（缩放 / 平移拖拽）才武装；
+  // 复位时机：鼠标**离开**关系图谱画布满 autoFitOnIdleMs → 弹性补间回自适应视野。
+  // 鼠标在画布内时图谱必须保持不动（不排倒计时）；回进画布会取消待触发的复位和正在播放的补间。
+  const autoFitTimer = useRef<number | null>(null)
+  const autoFitArmed = useRef(false)
+  const pointerInside = useRef(false)
+  const pointerStart = useRef<{ x: number; y: number } | null>(null)
+  const pointerMoved = useRef(false)
+  const draggingNode = useRef(false)
+  const autoFitFire = useCallback(() => {
+    autoFitTimer.current = null
+    autoFitArmed.current = false
+    const canvas = canvasRef.current
+    // 1s 慢弹簧（一大一小交替）补间归位；不支持补间的画布退回瞬时对准。
+    if (canvas?.animateFitView) canvas.animateFitView({ durationMs: 1000 })
+    else canvas?.fitView()
+  }, [])
+  const clearAutoFitTimer = useCallback(() => {
+    if (autoFitTimer.current === null) return
+    window.clearTimeout(autoFitTimer.current)
+    autoFitTimer.current = null
+  }, [])
+  const armAutoFit = useCallback(() => {
+    // 只武装，不排倒计时：倒计时一律等鼠标离开画布才开始
+    autoFitArmed.current = true
+  }, [])
+  useEffect(() => clearAutoFitTimer, [clearAutoFitTimer])
+
+  const handlePointerEnter = useCallback(() => {
+    pointerInside.current = true
+    // 鼠标回到画布内：取消待触发的复位；正在播放的补间也立刻停（画布内图谱必须静止）。
+    // 若确实停掉了一段在播的补间，重新武装——等下次离开时把它补完。
+    clearAutoFitTimer()
+    if (canvasRef.current?.cancelFitAnimation?.()) autoFitArmed.current = true
+  }, [clearAutoFitTimer])
+  const handlePointerLeave = useCallback(() => {
+    pointerInside.current = false
+    pointerStart.current = null
+    // 离开画布才开始倒计时（视口被改过才需要复位）
+    clearAutoFitTimer()
+    if (autoFitOnIdleMs <= 0 || !autoFitArmed.current) return
+    autoFitTimer.current = window.setTimeout(autoFitFire, autoFitOnIdleMs)
+  }, [autoFitFire, autoFitOnIdleMs, clearAutoFitTimer])
+  const handlePointerDown = useCallback((event: React.PointerEvent<HTMLDivElement>) => {
+    pointerInside.current = true
+    pointerStart.current = { x: event.clientX, y: event.clientY }
+    pointerMoved.current = false
+    draggingNode.current = false
+    // 用户伸手了：正在播放的复位补间立刻停（否则会跟拖拽抢镜头）
+    canvasRef.current?.cancelFitAnimation?.()
+  }, [])
+  const handlePointerMove = useCallback((event: React.PointerEvent<HTMLDivElement>) => {
+    pointerInside.current = true
+    const start = pointerStart.current
+    if (start && !pointerMoved.current) {
+      // 3px 死区：点击节点时的轻微抖动不算「改动视口」
+      if (Math.abs(event.clientX - start.x) > 3 || Math.abs(event.clientY - start.y) > 3) {
+        pointerMoved.current = true
+        // 拖的是节点（不是平移画布）→ 视口没变，不武装
+        if (!draggingNode.current) armAutoFit()
+      }
+    }
+  }, [armAutoFit])
+  const handlePointerEnd = useCallback(() => {
+    pointerStart.current = null
+  }, [])
+  const handleWheel = useCallback(() => {
+    // 滚轮 = 缩放，视口一定变了；正在播放的补间同样让位
+    canvasRef.current?.cancelFitAnimation?.()
+    armAutoFit()
+  }, [armAutoFit])
+
   const resizeLayout = useCallback((width: number, height: number) => {
     const dimensions = roomGraphLayoutDimensions({
       compact,
@@ -171,7 +253,16 @@ function RoomGraphCanvasComponent(
   }), [])
 
   return (
-    <div className="context-room-graph-shell nx-graph-shell">
+    <div
+      className="context-room-graph-shell nx-graph-shell"
+      onPointerEnter={handlePointerEnter}
+      onPointerLeave={handlePointerLeave}
+      onPointerDown={handlePointerDown}
+      onPointerMove={handlePointerMove}
+      onPointerUp={handlePointerEnd}
+      onPointerCancel={handlePointerEnd}
+      onWheel={handleWheel}
+    >
       <PixiForceGraphCanvas
         ref={canvasRef}
         ariaLabel={t('contextRoom:graphs.roomRelationsCanvas')}
@@ -186,7 +277,10 @@ function RoomGraphCanvasComponent(
         selectedEdgeId={selectedRelationId}
         onResize={resizeLayout}
         onUserGesture={layout.cancelAutoFit}
-        onDragNode={layout.drag}
+        onDragNode={(nodeId, x, y) => {
+          draggingNode.current = true
+          layout.drag(nodeId, x, y)
+        }}
         onReleaseNode={layout.release}
         onOpenNode={onOpenRoom}
         onSelectEdge={onSelectRelation}
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-panels/RelationsPane.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-panels/RelationsPane.tsx
index ce9e66ff..8f0ed9b9 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-panels/RelationsPane.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-panels/RelationsPane.tsx
@@ -1,5 +1,5 @@
 import { Link2, Network } from 'lucide-react'
-import { useEffect, useMemo, useRef, useState } from 'react'
+import { useEffect, useMemo, useState } from 'react'
 import { useLocale } from '../../../../../i18n/LocaleContext'
 import type { RoomDocument } from '@nxcore/agent-contract'
 
@@ -7,12 +7,14 @@ import type { KnowledgeFileDto } from '../../../../../../../shared/knowledge'
 import type { ContextRoomRecord, ContextRoomResource } from '../../types'
 import { createContextRoomResourceLibrary } from '../../resources'
 import { useRoomRelationGraph } from '../../hooks/useRoomRelationGraph'
-import { RoomGraphCanvas, type RoomGraphCanvasHandle } from '../RoomGraphCanvas'
+import { RoomGraphCanvas } from '../RoomGraphCanvas'
 import { RoomNodeInspector } from '../RoomGraphInspector'
 import { CreateRoomRelationDialog, relationTypeLabel, RoomRelationInspector } from '../RoomRelationControls'
-import { GraphFitButton } from '../GraphFitButton'
 import { PanelEmptyState } from './PanelEmptyState'
 
+/** 用户缩放/拖拽后，鼠标在关系图谱上静止多久自动弹性复位到自适应视野。 */
+const RELATIONS_AUTO_FIT_IDLE_MS = 5_000
+
 export function RelationsPane({
   room,
   rooms,
@@ -31,7 +33,6 @@ export function RelationsPane({
   const { locale, t } = useLocale()
   const [visibility, setVisibility] = useState<'active' | 'hidden'>('active')
   const { error, graph, loading, reload } = useRoomRelationGraph(room.id, visibility)
-  const graphRef = useRef<RoomGraphCanvasHandle>(null)
   const [selectedGraphRoomId, setSelectedGraphRoomId] = useState(room.id)
   const [selectedRelationId, setSelectedRelationId] = useState<string | null>(null)
   const [inspectorOpen, setInspectorOpen] = useState(true)
@@ -77,22 +78,18 @@ export function RelationsPane({
         </header>
         <div className="context-room-related-graph-canvas">
           {loading && !graph ? <div className="context-room-graph-state">{t('contextRoom:relations.loadingGraph')}</div> : hasRelations ? (
-            <>
-              <RoomGraphCanvas
-                ref={graphRef}
-                compact
-                rooms={graphRooms}
-                relations={graph?.edges ?? []}
-                selectedId={selectedGraphRoomId}
-                selectedRelationId={selectedRelationId}
-                onSelectRoom={(roomId) => { setSelectedRelationId(null); setSelectedGraphRoomId(roomId ?? room.id); setInspectorOpen(Boolean(roomId)) }}
-                onSelectRelation={(relationId) => { setSelectedRelationId(relationId); setSelectedGraphRoomId(room.id); setInspectorOpen(Boolean(relationId)) }}
-                onOpenRoom={onOpenRoom}
-              />
-              {/* 视口可自由缩放平移，缩到最小或拖出视野后图会看不见；
-                  浮层按钮常驻画布右上角，一键把图谱自适应缩放并居中。 */}
-              <GraphFitButton onFit={() => void graphRef.current?.fitView()} />
-            </>
+            <RoomGraphCanvas
+              compact
+              rooms={graphRooms}
+              relations={graph?.edges ?? []}
+              selectedId={selectedGraphRoomId}
+              selectedRelationId={selectedRelationId}
+              // 不设按钮：缩放/拖拽后鼠标静止满 5 秒，弹性补间回自适应视野。
+              autoFitOnIdleMs={RELATIONS_AUTO_FIT_IDLE_MS}
+              onSelectRoom={(roomId) => { setSelectedRelationId(null); setSelectedGraphRoomId(roomId ?? room.id); setInspectorOpen(Boolean(roomId)) }}
+              onSelectRelation={(relationId) => { setSelectedRelationId(relationId); setSelectedGraphRoomId(room.id); setInspectorOpen(Boolean(relationId)) }}
+              onOpenRoom={onOpenRoom}
+            />
           ) : (
             <PanelEmptyState
               icon={Network}
diff --git a/apps/desktop/src/renderer/src/components/graph/PixiForceGraphCanvas.tsx b/apps/desktop/src/renderer/src/components/graph/PixiForceGraphCanvas.tsx
index d8d3fa01..d8cab752 100644
--- a/apps/desktop/src/renderer/src/components/graph/PixiForceGraphCanvas.tsx
+++ b/apps/desktop/src/renderer/src/components/graph/PixiForceGraphCanvas.tsx
@@ -29,6 +29,10 @@ export interface PixiForceGraphCanvasNode extends PixiForceGraphNode {
 
 export interface PixiForceGraphCanvasHandle {
   fitView(minScale?: number): void
+  /** 带 1s 弹簧补间（一大一小交替衰减）回到自适应视野（关系图谱「无操作自动复位」用）。 */
+  animateFitView?(options?: { minScale?: number; durationMs?: number }): void
+  /** 用户接管画布（拖拽/滚轮/移回画布）时取消复位补间；返回是否真的取消了在播补间。 */
+  cancelFitAnimation?(): boolean
 }
 
 interface PixiForceGraphCanvasProps {
@@ -83,6 +87,12 @@ export const PixiForceGraphCanvas = forwardRef<PixiForceGraphCanvasHandle, PixiF
     fitView(minScale?: number) {
       rendererRef.current?.fitView(minScale)
     },
+    animateFitView(options?: { minScale?: number; durationMs?: number }) {
+      rendererRef.current?.animateFitView(options)
+    },
+    cancelFitAnimation() {
+      return rendererRef.current?.cancelFitAnimation() ?? false
+    },
   }), [])
 
   // 首帧遮罩：Worker 发布首个有效布局（revision > 0）前盖住画布，避免
diff --git a/apps/desktop/src/renderer/src/components/graph/pixi/PixiForceGraphRenderer.ts b/apps/desktop/src/renderer/src/components/graph/pixi/PixiForceGraphRenderer.ts
index ce7bc086..4a828db2 100644
--- a/apps/desktop/src/renderer/src/components/graph/pixi/PixiForceGraphRenderer.ts
+++ b/apps/desktop/src/renderer/src/components/graph/pixi/PixiForceGraphRenderer.ts
@@ -10,6 +10,19 @@ import type {
   PixiSprite,
   PixiTexture,
 } from './pixiForceGraphTypes'
+/** 复位补间的运行态（scale 与中心按弹簧曲线线性插值）。 */
+interface FitTween {
+  startedAt: number
+  durationMs: number
+  ease: (progress: number) => number
+  fromScale: number
+  fromCenterX: number
+  fromCenterY: number
+  toScale: number
+  toCenterX: number
+  toCenterY: number
+}
+
 
 export type * from './pixiForceGraphTypes'
 
@@ -483,8 +496,66 @@ export function createPixiForceGraphRenderer(
   // Claim node presses before the drag plugin handles subsequent movement.
   viewport.drag().wheel().pinch()
 
+  /**
+   * 复位补间：由共享 ticker 逐帧驱动，按「scale 与中心线性插值 × 弹簧曲线」推进。
+   *
+   * 不用 pixi-viewport 的 Animate 插件是有原因的：它按 `ease(elapsed, 0, 1, duration)`
+   * （Penner 签名）调用、并且以「世界宽度」为插值量，曲线和"一大一小交替"的手感都会被改写。
+   * 这里自己插值，与预览页（scratch/spring-fit-demo.html）的数学完全一致。
+   */
+  const FIT_SPRING_DAMPING = 0.38
+  const FIT_SPRING_OMEGA = 10
+  /** 欠阻尼二阶阶跃响应（初速度 0）：1 − e^(−ζωt)(cos(ω_d t) + ζω/ω_d·sin(ω_d t)) */
+  function createFitEase(durationMs: number) {
+    const dampingRatio = FIT_SPRING_DAMPING
+    const omega = FIT_SPRING_OMEGA
+    const dampedOmega = omega * Math.sqrt(1 - dampingRatio ** 2)
+    const shape = (time: number) => {
+      const decay = Math.exp(-dampingRatio * omega * time)
+      return 1 - decay * (
+        Math.cos(dampedOmega * time)
+        + ((dampingRatio * omega) / dampedOmega) * Math.sin(dampedOmega * time)
+      )
+    }
+    const seconds = Math.max(0.001, durationMs / 1000)
+    const settled = shape(seconds) || 1
+    return (progress: number) => {
+      if (progress <= 0) return 0
+      if (progress >= 1) return 1
+      return shape(progress * seconds) / settled
+    }
+  }
+
+  let fitTween: FitTween | null = null
+  const nowMs = () => dependencies.now?.() ?? (
+    typeof performance !== 'undefined' && typeof performance.now === 'function'
+      ? performance.now()
+      : Date.now()
+  )
+
+  function stepFitTween() {
+    if (!fitTween) return
+    const elapsed = nowMs() - fitTween.startedAt
+    const progress = fitTween.durationMs <= 0 ? 1 : Math.min(1, elapsed / fitTween.durationMs)
+    const value = fitTween.ease(progress)
+    const scale = fitTween.fromScale + (fitTween.toScale - fitTween.fromScale) * value
+    const centerX = fitTween.fromCenterX + (fitTween.toCenterX - fitTween.fromCenterX) * value
+    const centerY = fitTween.fromCenterY + (fitTween.toCenterY - fitTween.fromCenterY) * value
+    viewport.setZoom?.(Math.max(0.02, scale), false)
+    viewport.moveCenter?.(centerX, centerY)
+    if (progress >= 1) fitTween = null
+  }
+
+  function cancelFitAnimation() {
+    const wasPlaying = fitTween !== null
+    fitTween = null
+    return wasPlaying
+  }
+
   const drawFrame = () => {
     if (destroyed) return
+    // 补间推进放在最前面：它改了视口 x/y/scale，下面的脏检查就会重绘这一帧。
+    stepFitTween()
     if (anchors.length > 0) syncAnchorPositions()
     const startRevision = effectiveRevision()
     if ((startRevision & 1) === 1) return
@@ -586,11 +657,21 @@ export function createPixiForceGraphRenderer(
   dependencies.Ticker.shared.add(drawFrame)
   drawFrame()
 
-  const contentBounds = () => {
+  /**
+   * 两套包围盒，各司其职：
+   * - `bounds`：节点半径 + 底边 24px 标签预留 —— 只用于算缩放（标签不能被裁）；
+   * - `center`：只用节点半径的几何中心 —— 用于居中。
+   * 只居中的话必须用后者：标签预留只加在底边，用它求中心会让整块内容固定上偏 12px。
+   */
+  const contentMetrics = () => {
     let minX = Number.POSITIVE_INFINITY
     let minY = Number.POSITIVE_INFINITY
     let maxX = Number.NEGATIVE_INFINITY
     let maxY = Number.NEGATIVE_INFINITY
+    let coreMinX = Number.POSITIVE_INFINITY
+    let coreMinY = Number.POSITIVE_INFINITY
+    let coreMaxX = Number.NEGATIVE_INFINITY
+    let coreMaxY = Number.NEGATIVE_INFINITY
     nodes.forEach((node, index) => {
       const x = positions[index * 2]
       const y = positions[index * 2 + 1]
@@ -603,15 +684,24 @@ export function createPixiForceGraphRenderer(
       minY = Math.min(minY, y! - radius)
       maxX = Math.max(maxX, x! + radius)
       maxY = Math.max(maxY, y! + radius + 24)
+      coreMinX = Math.min(coreMinX, x! - radius)
+      coreMinY = Math.min(coreMinY, y! - radius)
+      coreMaxX = Math.max(coreMaxX, x! + radius)
+      coreMaxY = Math.max(coreMaxY, y! + radius)
     })
     if (!Number.isFinite(minX)) return null
-    return { minX, minY, maxX, maxY }
+    return {
+      bounds: { minX, minY, maxX, maxY },
+      center: { x: (coreMinX + coreMaxX) / 2, y: (coreMinY + coreMaxY) / 2 },
+    }
   }
 
+  const contentCenter = () => contentMetrics()?.center ?? null
+
   const centerOnContent = () => {
-    const bounds = contentBounds()
-    if (!bounds) return
-    viewport.moveCenter?.((bounds.minX + bounds.maxX) / 2, (bounds.minY + bounds.maxY) / 2)
+    const center = contentCenter()
+    if (!center) return
+    viewport.moveCenter?.(center.x, center.y)
   }
 
   // 面板只决定视口：世界大于面板时初始视野对准内容中心、保持原始缩放，
@@ -634,10 +724,12 @@ export function createPixiForceGraphRenderer(
     centerOnLayoutPending = !(hostWidth > 0 && hostHeight > 0)
   }
 
-  const fitView = (minScale = 0.2) => {
-    if (destroyed || nodes.length === 0) return
-    const bounds = contentBounds()
-    if (!bounds) return
+  /** 自适应目标：缩放取带标签预留的包围盒，居中取节点几何中心；与 fitView 共用。 */
+  const fitTarget = (minScale = 0.2) => {
+    if (destroyed || nodes.length === 0) return null
+    const metrics = contentMetrics()
+    if (!metrics) return null
+    const { bounds, center } = metrics
     const boundsWidth = Math.max(1, bounds.maxX - bounds.minX)
     const boundsHeight = Math.max(1, bounds.maxY - bounds.minY)
     const scale = Math.min(4, Math.max(minScale, Math.min(
@@ -650,8 +742,49 @@ export function createPixiForceGraphRenderer(
     const degenerate = nodes.length > 1
       && boundsWidth < textureRadius * 4
       && boundsHeight < textureRadius * 4 + 24
-    viewport.setZoom?.(degenerate ? Math.min(scale, 1) : scale, false)
-    viewport.moveCenter?.((bounds.minX + bounds.maxX) / 2, (bounds.minY + bounds.maxY) / 2)
+    return {
+      scale: degenerate ? Math.min(scale, 1) : scale,
+      centerX: center.x,
+      centerY: center.y,
+    }
+  }
+
+  const fitView = (minScale = 0.2) => {
+    const target = fitTarget(minScale)
+    if (!target) return
+    viewport.setZoom?.(target.scale, false)
+    viewport.moveCenter?.(target.centerX, target.centerY)
+  }
+
+  /**
+   * 带补间的自适应：从当前视野弹回内容（默认 1s，慢弹簧：放大→缩小交替衰减后落定）。
+   * 用户中途拖拽/缩放时调用 cancelFitAnimation() 立刻交还控制权。
+   */
+  const animateFitView = ({ minScale = 0.2, durationMs = 1000 }: {
+    minScale?: number
+    durationMs?: number
+  } = {}) => {
+    const target = fitTarget(minScale)
+    if (!target) return
+    if (durationMs <= 0 || destroyed) {
+      cancelFitAnimation()
+      viewport.setZoom?.(target.scale, false)
+      viewport.moveCenter?.(target.centerX, target.centerY)
+      return
+    }
+    fitTween = {
+      startedAt: nowMs(),
+      durationMs,
+      ease: createFitEase(durationMs),
+      fromScale: viewport.scale?.x ?? target.scale,
+      fromCenterX: viewport.center?.x ?? target.centerX,
+      fromCenterY: viewport.center?.y ?? target.centerY,
+      toScale: target.scale,
+      toCenterX: target.centerX,
+      toCenterY: target.centerY,
+    }
+    // 立刻推进一帧，避免"点了没反应"的第一帧空档
+    stepFitTween()
   }
 
   return {
@@ -665,6 +798,8 @@ export function createPixiForceGraphRenderer(
     activeLabelCount: () => labelManager.activeCount(),
     createdLabelCount: () => labelManager.createdCount(),
     fitView,
+    animateFitView,
+    cancelFitAnimation,
     hitTest,
     resize(nextWidth, nextHeight) {
       if (destroyed) return
diff --git a/apps/desktop/src/renderer/src/components/graph/pixi/pixiForceGraphTypes.ts b/apps/desktop/src/renderer/src/components/graph/pixi/pixiForceGraphTypes.ts
index 36452c39..06c10852 100644
--- a/apps/desktop/src/renderer/src/components/graph/pixi/pixiForceGraphTypes.ts
+++ b/apps/desktop/src/renderer/src/components/graph/pixi/pixiForceGraphTypes.ts
@@ -99,6 +99,11 @@ export interface PixiViewport extends PixiContainer {
   getVisibleBounds?(): { x: number; y: number; width: number; height: number }
   moveCenter?(x: number, y: number): PixiViewport
   setZoom?(scale: number, center?: boolean): PixiViewport
+  /** 画面尺寸（世界坐标插值要用：中心 = toWorld(screen/2)）。 */
+  readonly screenWidth?: number
+  readonly screenHeight?: number
+  /** 当前画面中心（世界坐标）：pixi-viewport 的 getter，复位补间的插值起点。 */
+  readonly center?: { x: number; y: number }
   toWorld?(x: number, y: number): { x: number; y: number }
   on?(event: string, callback: (event: PixiPointerEvent) => void): void
   off?(event: string, callback: (event: PixiPointerEvent) => void): void
@@ -138,6 +143,8 @@ export interface PixiForceGraphDependencies {
     autoResize?: boolean,
   ) => PixiParticleContainer
   Ticker: { shared: PixiTicker }
+  /** 时钟（测试注入用）；缺省 performance.now()。复位补间用它算进度。 */
+  now?: () => number
   Viewport: PixiViewportConstructor
 }
 
@@ -249,6 +256,13 @@ export interface PixiForceGraphRenderer {
   createdLabelCount(): number
   /** 缩放至内容恰好入屏；minScale 为缩放下限（如 1 = 只居中不缩小）。 */
   fitView(minScale?: number): void
+  /**
+   * 带补间（默认 1s，慢弹簧：放大→缩小交替衰减）回到自适应视野；用户手势可中途打断。
+   * 视口不支持 animate 时内部退化为瞬时对准。
+   */
+  animateFitView(options?: { minScale?: number; durationMs?: number }): void
+  /** 立刻取消复位补间，停在当前视野；返回是否真的取消了一段在播的补间。 */
+  cancelFitAnimation(): boolean
   hitTest(x: number, y: number): number | null | undefined
   resize(width: number, height: number): void
   setHoveredIndex(index: number | null): void
diff --git a/apps/desktop/tests/context-room-home-graph-fit.test.tsx b/apps/desktop/tests/context-room-home-graph-fit.test.tsx
index 8391fc18..41dc5778 100644
--- a/apps/desktop/tests/context-room-home-graph-fit.test.tsx
+++ b/apps/desktop/tests/context-room-home-graph-fit.test.tsx
@@ -3,20 +3,16 @@
 import TestRenderer, { act } from 'react-test-renderer'
 import { afterEach, describe, expect, it, vi } from 'vitest'
 
-const fitViewCalls = { count: 0 }
+const homeGraphProps: Array<{ autoFitOnIdleMs?: number }> = []
 
 vi.mock('../src/renderer/src/components/context-room/ported/components/RoomGraphCanvas', async () => {
   const { forwardRef, useImperativeHandle } = await import('react')
   return {
     RoomGraphCanvas: forwardRef(function MockRoomGraphCanvas(
-      _props: Record<string, unknown>,
-      ref,
+      props: { autoFitOnIdleMs?: number },
+      _ref,
     ) {
-      useImperativeHandle(ref, () => ({
-        fitView: async () => {
-          fitViewCalls.count += 1
-        },
-      }), [])
+      homeGraphProps.push(props)
       return null
     }),
   }
@@ -91,30 +87,24 @@ function renderHome() {
 
 describe('首页 Room 关系图谱的自适应按钮', () => {
   afterEach(() => {
-    fitViewCalls.count = 0
+    homeGraphProps.length = 0
     delete (window as unknown as { nxcore?: unknown }).nxcore
   })
 
-  // 首页画布可自由缩放平移：缩到最小或拖走后全图看不见，浮层按钮必须常驻并可点。
-  it('keeps an always-visible fit control that re-fits the whole graph', async () => {
+  // 首页画布不再有「适应画布」浮层按钮：改成鼠标离开图谱满 5 秒自动缩放居中。
+  it('drives the graph by idle auto-fit instead of a fit button', async () => {
     stubRoomGraph([])
     let renderer: TestRenderer.ReactTestRenderer | null = null
     await act(async () => {
       renderer = renderHome()
     })
 
-    const fitButton = renderer!.root.findByProps({ className: 'context-room-graph-fit' })
-    expect(fitButton.props['aria-label']).toBe('自适应图谱：缩放并居中')
-
-    await act(async () => {
-      fitButton.props.onClick()
-    })
-
-    expect(fitViewCalls.count).toBe(1)
+    expect(homeGraphProps.at(-1)!.autoFitOnIdleMs).toBe(5000)
+    expect(renderer!.root.findAllByProps({ className: 'context-room-graph-fit' })).toHaveLength(0)
     renderer!.unmount()
   })
 
-  it('does not offer the fit control before the graph has loaded', async () => {
+  it('renders no graph (and no fit control) before the graph has loaded', async () => {
     stubKnowledge({
       getRoomRelations: vi.fn(),
       // 永不 resolve：停在加载态，画布还没渲染。
diff --git a/apps/desktop/tests/context-room-relations-pane.test.tsx b/apps/desktop/tests/context-room-relations-pane.test.tsx
index 2ad06513..6fd8d5e0 100644
--- a/apps/desktop/tests/context-room-relations-pane.test.tsx
+++ b/apps/desktop/tests/context-room-relations-pane.test.tsx
@@ -6,10 +6,10 @@ import type { ContextRoomRecord } from '../src/renderer/src/components/context-r
 
 const graphProps: Array<{
   rooms: unknown[]
+  autoFitOnIdleMs?: number
   onSelectRelation: (relationId: string | null) => void
   onSelectRoom: (roomId: string | null) => void
 }> = []
-const fitViewCalls = { count: 0 }
 
 vi.mock('../src/renderer/src/components/context-room/ported/components/RoomGraphCanvas', async () => {
   const { forwardRef, useImperativeHandle } = await import('react')
@@ -17,17 +17,13 @@ vi.mock('../src/renderer/src/components/context-room/ported/components/RoomGraph
     RoomGraphCanvas: forwardRef(function MockRoomGraphCanvas(
       props: {
         rooms: unknown[]
+        autoFitOnIdleMs?: number
         onSelectRelation: (relationId: string | null) => void
         onSelectRoom: (roomId: string | null) => void
       },
-      ref,
+      _ref,
     ) {
       graphProps.push(props)
-      useImperativeHandle(ref, () => ({
-        fitView: async () => {
-          fitViewCalls.count += 1
-        },
-      }), [])
       return (
         <>
           <button type="button" onClick={() => props.onSelectRoom('room-b')}>select room-b</button>
@@ -247,12 +243,11 @@ describe('RelationsPane graph fit control', () => {
 
   afterEach(() => {
     graphProps.length = 0
-    fitViewCalls.count = 0
     vi.unstubAllGlobals()
   })
 
-  // 画布可自由缩放平移：缩到最小或拖走后图看不见，浮层按钮必须始终可点。
-  it('keeps an always-visible fit control that re-fits the graph', async () => {
+  // 自适应不再做成按钮：拖歪/缩太小之后停手 5 秒，画布自己缩放居中回内容。
+  it('hands the graph a 5s idle auto-fit instead of a fit button', async () => {
     const current = room('room-a', '项目', 'Current Room')
     const related = room('room-b', '项目', 'Related Room')
     stubRelations([edge])
@@ -262,17 +257,12 @@ describe('RelationsPane graph fit control', () => {
       renderer = TestRenderer.create(<RelationsPane room={current} rooms={[current, related]} onOpenRoom={vi.fn()} />)
     })
 
-    const fitButton = renderer!.root.findByProps({ className: 'context-room-graph-fit' })
-    expect(fitButton.props['aria-label']).toBe('自适应图谱：缩放并居中')
-
-    await act(async () => {
-      fitButton.props.onClick()
-    })
-
-    expect(fitViewCalls.count).toBe(1)
+    expect(graphProps.at(-1)!.autoFitOnIdleMs).toBe(5000)
+    // 画布上不再有自适应按钮
+    expect(renderer!.root.findAllByProps({ className: 'context-room-graph-fit' })).toHaveLength(0)
   })
 
-  it('hides the fit control when there is no graph to fit', async () => {
+  it('renders no graph (and no fit control) when there are no relations', async () => {
     const current = room('room-a', '项目', 'Current Room')
     stubRelations([])
     let renderer: TestRenderer.ReactTestRenderer
@@ -281,6 +271,7 @@ describe('RelationsPane graph fit control', () => {
       renderer = TestRenderer.create(<RelationsPane room={current} rooms={[current]} onOpenRoom={vi.fn()} />)
     })
 
+    expect(graphProps).toHaveLength(0)
     expect(renderer!.root.findAllByProps({ className: 'context-room-graph-fit' })).toHaveLength(0)
   })
 })
diff --git a/apps/desktop/tests/pixi-force-graph-renderer.test.ts b/apps/desktop/tests/pixi-force-graph-renderer.test.ts
index b08ca0b9..c6cb7a23 100644
--- a/apps/desktop/tests/pixi-force-graph-renderer.test.ts
+++ b/apps/desktop/tests/pixi-force-graph-renderer.test.ts
@@ -179,6 +179,14 @@ class FakeViewport extends FakeContainer implements PixiViewport {
     super()
   }
 
+  get screenWidth() {
+    return this.options.screenWidth
+  }
+
+  get screenHeight() {
+    return this.options.screenHeight
+  }
+
   drag() {
     this.calls.push('drag')
     this.on('pointerdown', () => {
@@ -206,12 +214,32 @@ class FakeViewport extends FakeContainer implements PixiViewport {
     return this.visibleBounds
   }
 
+  centerX = 0
+  centerY = 0
+
+  /** 复位补间读取的「当前画面中心」快照（由 moveCenter 更新）。 */
+  get center() {
+    return { x: this.centerX, y: this.centerY }
+  }
+
   moveCenter(x: number, y: number) {
+    this.centerX = x
+    this.centerY = y
     this.calls.push(`moveCenter:${String(x)},${String(y)}`)
     return this
   }
 
-  setZoom(scale: number) {
+  animateOptions: { position?: { x: number; y: number }; scale?: number; time?: number; ease?: (t: number) => number; removeOnInterrupt?: boolean; callbackOnComplete?: (viewport: PixiViewport) => void } | null = null
+
+  animate(options: { position?: { x: number; y: number }; scale?: number; time?: number; ease?: (t: number) => number; removeOnInterrupt?: boolean; callbackOnComplete?: (viewport: PixiViewport) => void }) {
+    this.animateOptions = options
+    this.calls.push(`animate:${String(options.time)}`)
+    this.scale.x = options.scale ?? this.scale.x
+    this.scale.y = options.scale ?? this.scale.y
+    return this
+  }
+
+  setZoom(scale: number, _center?: boolean) {
     this.scale.x = scale
     this.scale.y = scale
     this.calls.push(`setZoom:${String(scale)}`)
@@ -249,6 +277,12 @@ class FakeViewport extends FakeContainer implements PixiViewport {
 
 function createFakes() {
   const ticker = new FakeTicker()
+  let nowMs = 0
+  const clock = {
+    /** 推进注入时钟（毫秒）。 */
+    advance: (ms: number) => { nowMs += ms },
+    read: () => nowMs,
+  }
   const textures: FakeTexture[] = []
   const graphics: FakeGraphics[] = []
   const particles: FakeParticleContainer[] = []
@@ -314,6 +348,7 @@ function createFakes() {
       }
     },
     Ticker: { shared: ticker },
+    now: clock.read,
     Viewport: class extends FakeViewport {
       constructor(options: { screenWidth: number; screenHeight: number; worldWidth: number; worldHeight: number; events?: unknown }) {
         super(options)
@@ -321,7 +356,7 @@ function createFakes() {
       }
     },
   }
-  return { appDestroy, containers, dependencies, graphics, particles, renderer, texts, textures, ticker, view, viewports }
+  return { appDestroy, clock, containers, dependencies, graphics, particles, renderer, texts, textures, ticker, view, viewports }
 }
 
 function createHost() {
@@ -854,9 +889,10 @@ describe('PixiForceGraphRenderer', () => {
       positions: new Float32Array([100, 200, 300, 240]),
     })
     const viewport = fakes.viewports[0]!
-    // 内容包围盒（含半径 18 与标签预留 24）：(82,182)-(318,282)，中心 (200,232)。
+    // 居中按节点几何中心：(82,182)-(318,258) → (200,220)。
+    // 底边 24px 标签预留只参与缩放，不参与居中（否则整体固定上偏 12px）。
     // 只居中、不缩放：世界大于面板时通过视口平移浏览，而不是压进面板。
-    expect(viewport.calls).toContain('moveCenter:200,232')
+    expect(viewport.calls).toContain('moveCenter:200,220')
     expect(viewport.calls.some((call) => call.startsWith('setZoom:'))).toBe(false)
   })
 
@@ -872,7 +908,7 @@ describe('PixiForceGraphRenderer', () => {
     })
     const viewport = fakes.viewports[0]!
     // 宿主 0×0（隐藏 tab / 入场动画容器）：构造时按 640×420 兜底居中一次。
-    expect(viewport.calls.filter((call) => call.startsWith('moveCenter:'))).toEqual(['moveCenter:200,232'])
+    expect(viewport.calls.filter((call) => call.startsWith('moveCenter:'))).toEqual(['moveCenter:200,220'])
 
     // 真实尺寸到来 → 补居中一次；之后的面板微调不再抢用户的平移。
     renderer.resize(400, 300)
@@ -900,11 +936,11 @@ describe('PixiForceGraphRenderer', () => {
     fakes.ticker.tick()
     expect(viewport.calls.some((call) => call.startsWith('moveCenter:'))).toBe(false)
 
-    // Worker 首帧坐标写入（revision 为偶数）后，下一帧对准内容中心。
+    // Worker 首帧坐标写入（revision 为偶数）后，下一帧对准节点几何中心 (200,220)。
     positions.set([100, 200, 300, 240])
     revision = 2
     fakes.ticker.tick()
-    expect(viewport.calls).toContain('moveCenter:200,232')
+    expect(viewport.calls).toContain('moveCenter:200,220')
     // 只补一次：后续帧不再重复居中。
     fakes.ticker.tick()
     expect(viewport.calls.filter((call) => call.startsWith('moveCenter:'))).toHaveLength(1)
@@ -924,7 +960,7 @@ describe('PixiForceGraphRenderer', () => {
     renderer.fitView(1)
     // minScale 1：内容超出屏幕时保持原始缩放、只居中（紧凑面板语义）。
     expect(viewport.scale.x).toBe(1)
-    expect(viewport.calls).toContain('moveCenter:1000,712')
+    expect(viewport.calls).toContain('moveCenter:1000,700')
 
     renderer.fitView()
     // 缺省 minScale 0.2：整体可见优先，允许缩小到内容入屏。
@@ -932,6 +968,105 @@ describe('PixiForceGraphRenderer', () => {
     expect(viewport.scale.x).toBeLessThan(1)
   })
 
+  // 复位补间：不再用 pixi-viewport 的 Animate 插件（它按 Penner 签名调用 ease、
+  // 且以「世界宽度」为插值量，弹簧手感会被改写）——我们自己逐帧插值 scale 与中心，
+  // 与预览页 scratch/spring-fit-demo.html 的数学一致。
+  it('animates the fit as a 1s spring tween driven by the ticker', async () => {
+    const fakes = createFakes()
+    const renderer = await createPixiForceGraphRenderer({
+      dependencies: fakes.dependencies,
+      edges: [],
+      host: createHost(),
+      nodes: [{}, {}],
+      positions: new Float32Array([0, 0, 400, 400]),
+    })
+    const viewport = fakes.viewports[0]!
+    const targetScale = 372 / 460
+
+    // 模拟用户已放大（scale 2）并平移到 (0,0)
+    viewport.setZoom(2)
+    viewport.moveCenter(0, 0)
+
+    renderer.animateFitView()
+
+    // 第一帧是起点本身：不能瞬时跳到目标
+    expect(viewport.scale.x).toBe(2)
+    expect(viewport.center.x).toBe(0)
+
+    // ~340ms：弹簧第一次冲过头（缩得比目标更小）
+    fakes.clock.advance(340)
+    fakes.ticker.tick()
+    const peakScale = viewport.scale.x
+    expect(peakScale).toBeLessThan(targetScale)
+
+    // ~700ms：往回摆（比目标更大）
+    fakes.clock.advance(360)
+    fakes.ticker.tick()
+    const troughScale = viewport.scale.x
+    expect(troughScale).toBeGreaterThan(targetScale)
+    expect(viewport.scale.x).toBeGreaterThan(peakScale)
+
+    // 中心：从 0 出发朝 200 走，spring 过冲把中心推过了目标（>200）
+    expect(viewport.center.x).toBeGreaterThan(0)
+    expect(viewport.center.x).toBeGreaterThan(200 - (200 - 0) * 0.2)
+
+    // 1s 末：scale 与中心都精确落在目标（无需额外校正）
+    fakes.clock.advance(300)
+    fakes.ticker.tick()
+    expect(viewport.scale.x).toBeCloseTo(targetScale, 6)
+    expect(viewport.center.x).toBeCloseTo(200, 6)
+    expect(viewport.center.y).toBeCloseTo(200, 6)
+    // 补间结束：再来一帧也不再变化
+    const callsBefore = viewport.calls.length
+    fakes.clock.advance(16)
+    fakes.ticker.tick()
+    expect(viewport.scale.x).toBeCloseTo(targetScale, 6)
+    expect(viewport.calls.length).toBe(callsBefore)
+  })
+
+  it('cancels the fit tween as soon as the user grabs the canvas', async () => {
+    const fakes = createFakes()
+    const renderer = await createPixiForceGraphRenderer({
+      dependencies: fakes.dependencies,
+      edges: [],
+      host: createHost(),
+      nodes: [{}, {}],
+      positions: new Float32Array([0, 0, 400, 400]),
+    })
+    const viewport = fakes.viewports[0]!
+    viewport.setZoom(2)
+    viewport.moveCenter(0, 0)
+
+    renderer.animateFitView()
+    fakes.clock.advance(200)
+    fakes.ticker.tick()
+    const scaleMidway = viewport.scale.x
+    expect(scaleMidway).not.toBe(2)
+
+    // 用户接管：取消后视口停在被取消的那一帧，不再被补间拖动
+    renderer.cancelFitAnimation()
+    fakes.clock.advance(800)
+    fakes.ticker.tick()
+    expect(viewport.scale.x).toBeCloseTo(scaleMidway, 6)
+  })
+
+  it('applies the fit instantly when the tween duration is zero', async () => {
+    const fakes = createFakes()
+    const renderer = await createPixiForceGraphRenderer({
+      dependencies: fakes.dependencies,
+      edges: [],
+      host: createHost(),
+      nodes: [{}, {}],
+      positions: new Float32Array([0, 0, 400, 400]),
+    })
+    const viewport = fakes.viewports[0]!
+
+    renderer.animateFitView({ durationMs: 0 })
+
+    expect(viewport.scale.x).toBeCloseTo(372 / 460, 6)
+    expect(viewport.calls).toContain('moveCenter:200,200')
+  })
+
   it('caps the zoom at 1 when every node is stacked at a single point', async () => {
     const fakes = createFakes()
     const renderer = await createPixiForceGraphRenderer({
@@ -947,7 +1082,7 @@ describe('PixiForceGraphRenderer', () => {
     renderer.fitView()
     // 不把这叠节点放大成满屏重叠大饼：只居中、缩放收敛到 ≤1。
     expect(viewport.calls).toContain('setZoom:1')
-    expect(viewport.calls).toContain('moveCenter:0,12')
+    expect(viewport.calls).toContain('moveCenter:0,0')
   })
 
   it('resizes viewport and releases ticker, texture, viewport, sprites, and app resources', async () => {
@@ -967,7 +1102,7 @@ describe('PixiForceGraphRenderer', () => {
     renderer.fitView()
     // 两节点近距重叠（56×80 包围盒）属退化内容：只居中、不放大。
     expect(fakes.viewports[0]?.calls).toContain('setZoom:1')
-    expect(fakes.viewports[0]?.calls).toContain('moveCenter:20,42')
+    expect(fakes.viewports[0]?.calls).toContain('moveCenter:20,30')
 
     renderer.destroy()
     renderer.destroy()
diff --git a/apps/desktop/tests/room-graph-canvas-autofit.test.tsx b/apps/desktop/tests/room-graph-canvas-autofit.test.tsx
new file mode 100644
index 00000000..7531782b
--- /dev/null
+++ b/apps/desktop/tests/room-graph-canvas-autofit.test.tsx
@@ -0,0 +1,223 @@
+/** @vitest-environment happy-dom */
+
+import TestRenderer, { act } from 'react-test-renderer'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+import { createContextRoomFixture } from './context-room-fixture'
+
+const fitViewCalls: number[] = []
+const animateFitCalls: number[] = []
+let cancelCalls = 0
+const canvasProps: Array<Record<string, (value?: unknown) => void>> = []
+/** true = 模拟老画布（没有 animateFitView），验证退回瞬时对准。 */
+let canvasWithoutAnimate = false
+
+// node 环境没有 canvas/Worker：画布与力导向布局都换成探针，只验证「无操作自动复位」接线。
+vi.mock('@/components/graph', async () => {
+  const { forwardRef, useImperativeHandle } = await import('react')
+  return {
+    PixiForceGraphCanvas: forwardRef(function MockPixiForceGraphCanvas(
+      props: Record<string, (value?: unknown) => void>,
+      ref,
+    ) {
+      canvasProps.push(props)
+      useImperativeHandle(ref, () => ({
+        fitView: () => {
+          fitViewCalls.push(Date.now())
+        },
+        ...(canvasWithoutAnimate
+          ? {}
+          : {
+              animateFitView: (options?: { durationMs?: number }) => { animateFitCalls.push(options?.durationMs ?? 0) },
+              cancelFitAnimation: () => { cancelCalls += 1 },
+            }),
+      }), [])
+      return null
+    }),
+    PixiForceGraphCanvasNode: undefined,
+    PixiForceGraphEdge: undefined,
+    useForceGraphLayout: () => ({
+      controller: null,
+      positions: null,
+      revision: 0,
+      resize: vi.fn(),
+      cancelAutoFit: vi.fn(),
+      drag: vi.fn(),
+      release: vi.fn(),
+    }),
+  }
+})
+
+import { RoomGraphCanvas } from '../src/renderer/src/components/context-room/ported/components/RoomGraphCanvas'
+
+const ROOMS = [
+  createContextRoomFixture('room-a', 'Room A'),
+  createContextRoomFixture('room-b', 'Room B'),
+]
+
+function renderCanvas(autoFitOnIdleMs?: number) {
+  return TestRenderer.create(
+    <RoomGraphCanvas
+      compact
+      rooms={ROOMS}
+      relations={[]}
+      selectedId={null}
+      autoFitOnIdleMs={autoFitOnIdleMs}
+      onOpenRoom={vi.fn()}
+      onSelectRoom={vi.fn()}
+    />,
+  )
+}
+
+function shell(renderer: TestRenderer.ReactTestRenderer) {
+  return renderer.root.findByProps({ className: 'context-room-graph-shell nx-graph-shell' })
+}
+
+/** 组件只读 clientX/clientY，这里造一个最小指针事件。 */
+function pointer(x: number, y: number) {
+  return { clientX: x, clientY: y } as unknown as React.PointerEvent<HTMLDivElement>
+}
+
+/** 进入画布 → 按住拖 40px（= 改动视口）→ 松手。 */
+async function pan(renderer: TestRenderer.ReactTestRenderer) {
+  await act(async () => { shell(renderer).props.onPointerEnter() })
+  await act(async () => { shell(renderer).props.onPointerDown(pointer(100, 100)) })
+  await act(async () => { shell(renderer).props.onPointerMove(pointer(140, 130)) })
+  await act(async () => { shell(renderer).props.onPointerUp(pointer(140, 130)) })
+}
+
+describe('RoomGraphCanvas 离开画布自动复位', () => {
+  beforeEach(() => {
+    vi.useFakeTimers()
+    fitViewCalls.length = 0
+    animateFitCalls.length = 0
+    canvasProps.length = 0
+    canvasWithoutAnimate = false
+  })
+
+  afterEach(() => {
+    vi.useRealTimers()
+    vi.clearAllTimers()
+  })
+
+  it('未武装（没改过视口）时，离开画布也不复位', async () => {
+    let renderer!: TestRenderer.ReactTestRenderer
+    await act(async () => { renderer = renderCanvas(5000) })
+    // 只是悬停+轻微移动（3px 死区内），没改视口
+    await act(async () => { shell(renderer).props.onPointerEnter() })
+    await act(async () => { shell(renderer).props.onPointerDown(pointer(100, 100)) })
+    await act(async () => { shell(renderer).props.onPointerMove(pointer(101, 100)) })
+    await act(async () => { shell(renderer).props.onPointerUp(pointer(101, 100)) })
+    await act(async () => { shell(renderer).props.onPointerLeave() })
+    await act(async () => { vi.advanceTimersByTime(30_000) })
+    expect(animateFitCalls).toHaveLength(0)
+    expect(fitViewCalls).toHaveLength(0)
+  })
+
+  it('鼠标在画布内：改过视口也不动，图谱保持静止', async () => {
+    let renderer!: TestRenderer.ReactTestRenderer
+    await act(async () => { renderer = renderCanvas(5000) })
+    await pan(renderer)  // 拖拽 40px = 改过视口（已武装）
+    await act(async () => { vi.advanceTimersByTime(60_000) })
+    expect(animateFitCalls).toHaveLength(0)
+    expect(fitViewCalls).toHaveLength(0)
+  })
+
+  it('离开画布满 5s 才弹回（1s 补间）', async () => {
+    let renderer!: TestRenderer.ReactTestRenderer
+    await act(async () => { renderer = renderCanvas(5000) })
+    await pan(renderer)
+    await act(async () => { shell(renderer).props.onPointerLeave() })
+
+    await act(async () => { vi.advanceTimersByTime(4_999) })
+    expect(animateFitCalls).toHaveLength(0)
+    await act(async () => { vi.advanceTimersByTime(1) })
+    expect(animateFitCalls).toEqual([1000])
+  })
+
+  it('离开后 5s 内回到画布：取消待触发的复位', async () => {
+    let renderer!: TestRenderer.ReactTestRenderer
+    await act(async () => { renderer = renderCanvas(5000) })
+    await pan(renderer)
+    await act(async () => { shell(renderer).props.onPointerLeave() })
+    await act(async () => { vi.advanceTimersByTime(2_000) })
+    await act(async () => { shell(renderer).props.onPointerEnter() })
+    await act(async () => { vi.advanceTimersByTime(30_000) })
+    expect(animateFitCalls).toHaveLength(0)
+    expect(fitViewCalls).toHaveLength(0)
+  })
+
+  it('复位后再次改视口：再次离开才会再复位（一次性武装）', async () => {
+    let renderer!: TestRenderer.ReactTestRenderer
+    await act(async () => { renderer = renderCanvas(5000) })
+    await pan(renderer)
+    await act(async () => { shell(renderer).props.onPointerLeave() })
+    await act(async () => { vi.advanceTimersByTime(5_000) })
+    expect(animateFitCalls).toEqual([1000])
+
+    // 复位后没再改视口 → 再离开也不复位
+    await act(async () => { shell(renderer).props.onPointerEnter() })
+    await act(async () => { shell(renderer).props.onPointerLeave() })
+    await act(async () => { vi.advanceTimersByTime(30_000) })
+    expect(animateFitCalls).toEqual([1000])
+
+    // 再拖一次 → 再离开 → 再复位
+    await act(async () => { shell(renderer).props.onPointerEnter() })
+    await pan(renderer)
+    await act(async () => { shell(renderer).props.onPointerLeave() })
+    await act(async () => { vi.advanceTimersByTime(5_000) })
+    expect(animateFitCalls).toEqual([1000, 1000])
+  })
+
+  it('滚轮缩放也武装；autoFitOnIdleMs=0 时功能关闭', async () => {
+    let renderer!: TestRenderer.ReactTestRenderer
+    await act(async () => { renderer = renderCanvas(5000) })
+    await act(async () => { shell(renderer).props.onWheel() })
+    await act(async () => { shell(renderer).props.onPointerLeave() })
+    await act(async () => { vi.advanceTimersByTime(5_000) })
+    expect(animateFitCalls).toEqual([1000])
+
+    // 关闭：不传 autoFitOnIdleMs
+    animateFitCalls.length = 0
+    let off!: TestRenderer.ReactTestRenderer
+    await act(async () => { off = renderCanvas(undefined) })
+    await act(async () => { shell(off).props.onWheel() })
+    await act(async () => { shell(off).props.onPointerLeave() })
+    await act(async () => { vi.advanceTimersByTime(60_000) })
+    expect(animateFitCalls).toHaveLength(0)
+    expect(fitViewCalls).toHaveLength(0)
+  })
+
+  it('老画布没有 animateFitView：退回瞬时对准，别静默不动作。', async () => {
+    canvasWithoutAnimate = true
+    let renderer!: TestRenderer.ReactTestRenderer
+    await act(async () => { renderer = renderCanvas(5000) })
+    await pan(renderer)
+    await act(async () => { shell(renderer).props.onPointerLeave() })
+    await act(async () => { vi.advanceTimersByTime(5000) })
+    expect(animateFitCalls).toHaveLength(0)
+    expect(fitViewCalls).toHaveLength(1)
+  })
+
+  it('用户手势立刻取消正在播放的复位补间', async () => {
+    const renderer = renderCanvas(5_000)
+    animateFitCalls.length = 0
+    cancelCalls = 0
+    const canvas = canvasProps[canvasProps.length - 1] as unknown as {
+      animateFitView?: (options?: { durationMs?: number }) => void
+    }
+
+    // 模拟补间在播（画布句柄被上层调用过），此时用户按下鼠标
+    await act(async () => { canvas.animateFitView?.({ durationMs: 1000 }) })
+    expect(cancelCalls).toBe(0)
+
+    await act(async () => { shell(renderer).props.onPointerDown(pointer(100, 100)) })
+    expect(cancelCalls).toBe(1)
+
+    // 滚轮同样取消
+    await act(async () => { canvas.animateFitView?.({ durationMs: 1000 }) })
+    cancelCalls = 0
+    await act(async () => { shell(renderer).props.onWheel() })
+    expect(cancelCalls).toBe(1)
+  })
+})

From 2d4d2fd0f6cf121f05ee8dacf12913a3bc392c18 Mon Sep 17 00:00:00 2001
From: zengjiayi819 <nxcore@nxcoredeMacBook-Pro.local>
Date: Fri, 23 Oct 2026 17:00:41 +0800
Subject: [PATCH 3/6] =?UTF-8?q?feat(desktop):=20=E8=AE=B0=E5=BF=86?=
 =?UTF-8?q?=E6=97=B6=E9=97=B4=E8=BD=B4=E6=94=B9=E4=B8=BA=E6=B0=94=E6=B3=A1?=
 =?UTF-8?q?=E5=AF=B9=E8=AF=9D=E5=BC=8F=E2=80=94=E2=80=94=E6=97=B6=E9=97=B4?=
 =?UTF-8?q?=E5=9C=A8=E5=B7=A6=E3=80=81=E6=B0=94=E6=B3=A1=E5=8D=A1=E7=89=87?=
 =?UTF-8?q?=E5=9C=A8=E5=8F=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 一行改为 [时间 | 连接件 | 气泡] 三列网格：时间右对齐与节点同水平线，
  中列短横线 + 发光圆点连接到卡片
- 气泡卡片沿用原摘要卡，仅加「左上切角」的气泡圆角（4/10/10/10）
- 详情面板展开时落在气泡列，不压连接件
- 移除原左侧贯穿直线与 ::before 圆点方案
- 新增 mem-tl-link 装饰节点（aria-hidden）
---
 .../ported/components/RoomGraphCanvas.tsx     |  2 +-
 .../pages/memory/AtomicMemoryPane.tsx         |  1 +
 .../components/pages/memory/MemoryPage.css    | 56 ++++++++++++++-----
 submodules/nxcoreasr                          |  1 +
 4 files changed, 46 insertions(+), 14 deletions(-)
 create mode 160000 submodules/nxcoreasr

diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
index 329daa2e..95bb3562 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
@@ -41,7 +41,7 @@ interface RoomGraphCanvasProps {
   /**
    * 「无操作自动复位」的空闲阈值（毫秒）；不传 = 关闭。
    *
-   * 语义：用户改过视口（缩放 / 平移拖拽）之后，鼠标在图谱上**静止**满 N 毫秒 →
+   * 语义：用户改过视口（缩放 / 平移拖拽）之后，鼠标在图谱上停留一段时间（离开画布才开始计时）
    * 弹性补间回到自适应视野。只点击节点（没移动、视口没变）不会复位；
    * 鼠标离开画布立刻停表，不在后台触发；期间任何 mousemove 都重新计时。
    */
diff --git a/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx b/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
index 00a59376..9b759f5b 100644
--- a/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
+++ b/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
@@ -539,6 +539,7 @@ export function AtomicMemoryPane({ focusItemId, onOpenDocument, onOpenConversati
                 {group.items.map((item) => (
                   <li key={item.id} className="mem-atomic-item mem-tl-item" data-memory-id={item.id}>
                     <time className="mem-tl-time">{formatDate(item.updatedAt, locale)}</time>
+                    <span className="mem-tl-link" aria-hidden="true" />
                     <button
                       type="button"
                       className="mem-atomic-summary"
diff --git a/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css b/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
index 76b5ebb4..1d1a295a 100644
--- a/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
+++ b/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
@@ -2159,7 +2159,7 @@ button.mem-search-item:hover {
   font-size: 12px;
 }
 
-/* 记忆时间轴（原型 mem-timeline 移植）：分桶分组 + 左侧节点线。 */
+/* 记忆时间轴（H 气泡对话式）：时间在左、气泡卡片在右，中间节点短横线连接。 */
 .mem-timeline {
   display: flex;
   flex-direction: column;
@@ -2196,38 +2196,68 @@ button.mem-search-item:hover {
 }
 
 .mem-tl-list {
-  position: relative;
   display: flex;
   flex-direction: column;
-  gap: 8px;
+  gap: 10px;
   margin: 0;
-  padding: 2px 0 2px 18px;
-  border-left: 2px solid var(--cr-border, var(--border));
+  padding: 0;
   list-style: none;
 }
 
+/* 一行 = [时间 | 连接件 | 气泡卡片] 三列网格 */
 .mem-tl-item {
   position: relative;
+  display: grid;
+  grid-template-columns: 46px 16px minmax(0, 1fr);
+  align-items: stretch;
 }
 
-.mem-tl-item::before {
+/* 中列：短横线 + 节点圆点（垂直居中于时间文字行） */
+.mem-tl-link {
+  position: relative;
+}
+
+.mem-tl-link::before {
   position: absolute;
   top: 14px;
-  left: -23px;
-  width: 8px;
-  height: 8px;
-  border: 2px solid var(--cr-blue, var(--accent));
+  right: 0;
+  left: 0;
+  height: 1.5px;
+  background: var(--cr-border, var(--border));
+  content: "";
+}
+
+.mem-tl-link::after {
+  position: absolute;
+  top: 10.5px;
+  left: 50%;
+  width: 9px;
+  height: 9px;
+  margin-left: -4.5px;
   border-radius: 50%;
-  background: var(--cr-surface, var(--surface));
+  background: var(--cr-blue, var(--accent));
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--cr-blue, var(--accent)) 14%, transparent);
   content: "";
 }
 
+/* 时间列：右对齐，与节点同一水平线 */
 .mem-tl-time {
-  display: block;
-  margin-bottom: 3px;
+  padding-top: 7px;
   color: var(--cr-muted, var(--muted));
   font-size: 10px;
   font-variant-numeric: tabular-nums;
+  text-align: right;
+  white-space: nowrap;
+}
+
+/* 气泡卡片：复用原摘要卡样式，只加气泡圆角的不对称切角 */
+.mem-tl-item .mem-atomic-summary {
+  border-radius: 4px 10px 10px 10px;
+}
+
+/* 展开 详情面板：跨到气泡列对齐（不压连接件） */
+.mem-tl-item .mem-atomic-detail {
+  grid-column: 3;
 }
 
 .mem-tl-item .mem-atomic-item {
diff --git a/submodules/nxcoreasr b/submodules/nxcoreasr
new file mode 160000
index 00000000..49e513e8
--- /dev/null
+++ b/submodules/nxcoreasr
@@ -0,0 +1 @@
+Subproject commit 49e513e8b4f05c794ae17ce7eb7c18f38cf0e2f8

From 6ee02486ae78b9bace8c7f476b9bba00baac2f2a Mon Sep 17 00:00:00 2001
From: zengjiayi819 <nxcore@nxcoredeMacBook-Pro.local>
Date: Fri, 23 Oct 2026 17:01:47 +0800
Subject: [PATCH 4/6] =?UTF-8?q?docs(desktop):=20=E4=BF=AE=E6=AD=A3=20RoomG?=
 =?UTF-8?q?raphCanvas=20autoFitOnIdleMs=20=E6=B3=A8=E9=87=8A=E4=B8=BA?=
 =?UTF-8?q?=E7=A6=BB=E5=BC=80=E7=94=BB=E5=B8=83=E8=A7=A6=E5=8F=91=E8=AF=AD?=
 =?UTF-8?q?=E4=B9=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../context-room/ported/components/RoomGraphCanvas.tsx      | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
index 95bb3562..d5e95476 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/RoomGraphCanvas.tsx
@@ -41,9 +41,9 @@ interface RoomGraphCanvasProps {
   /**
    * 「无操作自动复位」的空闲阈值（毫秒）；不传 = 关闭。
    *
-   * 语义：用户改过视口（缩放 / 平移拖拽）之后，鼠标在图谱上停留一段时间（离开画布才开始计时）
-   * 弹性补间回到自适应视野。只点击节点（没移动、视口没变）不会复位；
-   * 鼠标离开画布立刻停表，不在后台触发；期间任何 mousemove 都重新计时。
+   * 语义：用户改过视口（缩放 / 平移拖拽）之后，鼠标**离开画布**满 N 毫秒 →
+   * 弹性补间回到自适应视野。画布内图谱保持不动；只点击节点（没移动、视口没变）
+   * 不会武装；移回画布会取消待触发的复位并停掉在播补间。
    */
   autoFitOnIdleMs?: number
 }

From 70e69241e62c35117f7a7de5fe558acf6979419a Mon Sep 17 00:00:00 2001
From: zengjiayi819 <nxcore@nxcoredeMacBook-Pro.local>
Date: Fri, 23 Oct 2026 17:02:30 +0800
Subject: [PATCH 5/6] =?UTF-8?q?fix(repo):=20=E8=AF=AF=E6=8F=90=E4=BA=A4?=
 =?UTF-8?q?=E7=9A=84=20submodules/nxcoreasr=20gitlink=20=E7=A7=BB=E9=99=A4?=
 =?UTF-8?q?=EF=BC=88=E6=97=A0=20.gitmodules=20=E5=A3=B0=E6=98=8E=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 submodules/nxcoreasr | 1 -
 1 file changed, 1 deletion(-)
 delete mode 160000 submodules/nxcoreasr

diff --git a/submodules/nxcoreasr b/submodules/nxcoreasr
deleted file mode 160000
index 49e513e8..00000000
--- a/submodules/nxcoreasr
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 49e513e8b4f05c794ae17ce7eb7c18f38cf0e2f8

From 94394fdef15daaf98cb4e81e43b662e57f9dc237 Mon Sep 17 00:00:00 2001
From: zengjiayi819 <nxcore@nxcoredeMacBook-Pro.local>
Date: Fri, 23 Oct 2026 17:09:48 +0800
Subject: [PATCH 6/6] =?UTF-8?q?fix(desktop):=20=E6=97=B6=E9=97=B4=E8=BD=B4?=
 =?UTF-8?q?=E6=97=B6=E9=97=B4=E5=88=97=E8=A2=AB=E8=8A=82=E7=82=B9=E5=9C=86?=
 =?UTF-8?q?=E7=82=B9=E9=81=AE=E6=8C=A1=E2=80=94=E2=80=94=E5=B7=A6=E5=88=97?=
 =?UTF-8?q?=E5=8F=AA=E6=94=BE=20HH:mm=20=E5=B9=B6=E7=95=99=E5=87=BA?=
 =?UTF-8?q?=E7=A9=BA=E9=9A=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 时间列改用 formatTimeShort（HH:mm）：完整日期悬停 title 可见、dateTime 语义保留
  （此前完整「YYYY/MM/DD HH:mm」在 44px 列里 nowrap 溢出，被中列圆点压住）
- 连接件横线右侧缩进 5px、时间列右内边距 4px：线与文字不再相接
- 圆点列 16→18px，圆点垂直对齐到时间文字行中心
---
 .../src/components/pages/memory/AtomicMemoryPane.tsx  | 10 ++++++++--
 .../src/components/pages/memory/MemoryPage.css        | 11 +++++++----
 .../src/components/pages/memory/useMemoryData.ts      |  8 ++++++++
 3 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx b/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
index 9b759f5b..ee3d04c6 100644
--- a/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
+++ b/apps/desktop/src/renderer/src/components/pages/memory/AtomicMemoryPane.tsx
@@ -6,7 +6,7 @@ import type { MemoryAtomicItemDto, MemoryAtomicProvenanceDto, MemoryAtomicType }
 import { dispatchRoomMemoryChanged } from '@/components/context-room/roomMemoryChange'
 import { RoomAssignControl } from './RoomAssignControl'
 import { MemoryEmptyView } from './MemoryStatusViews'
-import { formatDate, memoryFailureText, toMemoryFailure, type MemoryFailure } from './useMemoryData'
+import { formatDate, formatTimeShort, memoryFailureText, toMemoryFailure, type MemoryFailure } from './useMemoryData'
 
 const PAGE_SIZE = 50
 
@@ -538,7 +538,13 @@ export function AtomicMemoryPane({ focusItemId, onOpenDocument, onOpenConversati
               <ul className="mem-tl-list">
                 {group.items.map((item) => (
                   <li key={item.id} className="mem-atomic-item mem-tl-item" data-memory-id={item.id}>
-                    <time className="mem-tl-time">{formatDate(item.updatedAt, locale)}</time>
+                    <time
+                      className="mem-tl-time"
+                      dateTime={item.updatedAt ?? undefined}
+                      title={formatDate(item.updatedAt, locale)}
+                    >
+                      {formatTimeShort(item.updatedAt, locale)}
+                    </time>
                     <span className="mem-tl-link" aria-hidden="true" />
                     <button
                       type="button"
diff --git a/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css b/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
index 1d1a295a..94e850f0 100644
--- a/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
+++ b/apps/desktop/src/renderer/src/components/pages/memory/MemoryPage.css
@@ -2208,7 +2208,7 @@ button.mem-search-item:hover {
 .mem-tl-item {
   position: relative;
   display: grid;
-  grid-template-columns: 46px 16px minmax(0, 1fr);
+  grid-template-columns: 44px 18px minmax(0, 1fr);
   align-items: stretch;
 }
 
@@ -2217,10 +2217,11 @@ button.mem-search-item:hover {
   position: relative;
 }
 
+/* 短横线：左接气泡、右侧留 5px 空隙，不与时间文字相接 */
 .mem-tl-link::before {
   position: absolute;
   top: 14px;
-  right: 0;
+  right: 5px;
   left: 0;
   height: 1.5px;
   background: var(--cr-border, var(--border));
@@ -2229,7 +2230,7 @@ button.mem-search-item:hover {
 
 .mem-tl-link::after {
   position: absolute;
-  top: 10.5px;
+  top: 11.5px;
   left: 50%;
   width: 9px;
   height: 9px;
@@ -2240,9 +2241,11 @@ button.mem-search-item:hover {
   content: "";
 }
 
-/* 时间列：右对齐，与节点同一水平线 */
+/* 时间列：短时间（HH:mm）右对齐；完整日期悬停可见 */
 .mem-tl-time {
   padding-top: 7px;
+  padding-right: 4px;
+  overflow: visible;
   color: var(--cr-muted, var(--muted));
   font-size: 10px;
   font-variant-numeric: tabular-nums;
diff --git a/apps/desktop/src/renderer/src/components/pages/memory/useMemoryData.ts b/apps/desktop/src/renderer/src/components/pages/memory/useMemoryData.ts
index 00800b33..f0b9accf 100644
--- a/apps/desktop/src/renderer/src/components/pages/memory/useMemoryData.ts
+++ b/apps/desktop/src/renderer/src/components/pages/memory/useMemoryData.ts
@@ -198,6 +198,14 @@ export function useMemoryOverview() {
   )
 }
 
+/** 时间轴左列用的短时间（HH:mm）；完整日期由分组标题与详情面板表达。 */
+export function formatTimeShort(value: string | null | undefined, locale: string): string {
+  if (!value) return '—'
+  const date = new Date(value)
+  if (Number.isNaN(date.getTime())) return '—'
+  return date.toLocaleTimeString(locale, { hour: '2-digit', minute: '2-digit' })
+}
+
 export function formatDate(value: string | null | undefined, locale: string): string {
   if (!value) return '—'
   const date = new Date(value)