diff --git a/apps/desktop/src/main/gateway/document-gateway-bridge.ts b/apps/desktop/src/main/gateway/document-gateway-bridge.ts
index 157ead19..312554bc 100644
--- a/apps/desktop/src/main/gateway/document-gateway-bridge.ts
+++ b/apps/desktop/src/main/gateway/document-gateway-bridge.ts
@@ -18,6 +18,8 @@ import type {
   CompleteExternalDocumentPatchInput,
   ExternalDocumentProjectionBinding,
   ImportRoomDocumentInput,
+  MoveRoomDocumentsResult,
+  MovedRoomDocument,
   PreparedExternalDocumentPatch,
   ExternalDocumentSourceKind,
   PrepareExternalDocumentPatchInput,
@@ -297,6 +299,20 @@ export class DocumentGatewayBridge {
     }, true)
   }
 
+  move(documentId: string, fromRoomId: string, roomId: string): Promise<MovedRoomDocument> {
+    return this.request(`/v1/documents/${encodeURIComponent(documentId)}/move`, {
+      method: 'POST',
+      body: JSON.stringify({ fromRoomId, roomId }),
+    }, true)
+  }
+
+  moveMany(documentIds: string[], fromRoomId: string, roomId: string): Promise<MoveRoomDocumentsResult> {
+    return this.request('/v1/documents/move', {
+      method: 'POST',
+      body: JSON.stringify({ documentIds, fromRoomId, roomId }),
+    }, true)
+  }
+
   delete(documentId: string): Promise<void> {
     return this.request(`/v1/documents/${encodeURIComponent(documentId)}`, { method: 'DELETE' })
   }
diff --git a/apps/desktop/src/main/index.ts b/apps/desktop/src/main/index.ts
index a63e38ac..3cd6983b 100644
--- a/apps/desktop/src/main/index.ts
+++ b/apps/desktop/src/main/index.ts
@@ -452,6 +452,8 @@ const DOCUMENT_CHANNELS = {
   import: 'documents:import',
   save: 'documents:save',
   delete: 'documents:delete',
+  move: 'documents:move',
+  moveMany: 'documents:move-many',
   restore: 'documents:restore',
   deletePermanently: 'documents:delete-permanently',
   emptyTrash: 'documents:empty-trash',
@@ -2713,6 +2715,8 @@ function registerDocumentHandlers(
       if (vaultSyncDeps) await trashDocumentInVault(vaultSyncDeps, documentId)
       return deleted
     },
+    move: (_event, documentId, fromRoomId, roomId) => bridge.move(documentId, fromRoomId, roomId),
+    moveMany: (_event, documentIds, fromRoomId, roomId) => bridge.moveMany(documentIds, fromRoomId, roomId),
     restore: (_event, documentId) => bridge.restore(documentId),
     deletePermanently: async (_event, documentId) => {
       if (vaultSyncDeps) await trashDocumentInVault(vaultSyncDeps, documentId)
diff --git a/apps/desktop/src/main/office/office-preview-registry.ts b/apps/desktop/src/main/office/office-preview-registry.ts
index b8290a87..2c84a73c 100644
--- a/apps/desktop/src/main/office/office-preview-registry.ts
+++ b/apps/desktop/src/main/office/office-preview-registry.ts
@@ -2,6 +2,7 @@ import type { BrowserWindow } from 'electron'
 import { webContents } from 'electron'
 
 import type { OfficeAgentFileEvent } from '../../shared/office'
+import { logDesktop } from '../logging/desktop-logger'
 import {
   officePreviewKindForFileName,
   type OfficePreviewKind,
@@ -160,6 +161,16 @@ export class OfficePreviewRegistry {
   private wireDocsThesisHook(runtime: PreparedGenOfficeRuntime): void {
     const bridge = this.thesisBridge
     if (!bridge) return
+    // 运行时能力守卫：论文排版桥是 genoffice 后加的导出，带着旧运行时启动时它是 undefined。
+    // 缺了只跳过这个桥（AI 页签排版面板不可用），不能让 ensureRuntime 抛错——那会让
+    // 整条 open() 失败，Room 里的 Office 产物全部退回「用系统默认应用打开」。
+    if (typeof runtime.docs.setDocsThesisPanelHook !== 'function') {
+      logDesktop('office', 'warn', {
+        event: 'office.thesis-bridge-unavailable',
+        message: 'genoffice runtime 缺少 setDocsThesisPanelHook，跳过论文排版桥',
+      })
+      return
+    }
     runtime.docs.setDocsThesisPanelHook(async (wcId, action) => {
       const instance = this.findByWebContentsId(wcId)
       const roomId = instance?.roomId ?? null
diff --git a/apps/desktop/src/preload/index.ts b/apps/desktop/src/preload/index.ts
index 0f827e5f..e28b41e1 100644
--- a/apps/desktop/src/preload/index.ts
+++ b/apps/desktop/src/preload/index.ts
@@ -821,6 +821,8 @@ const api: NxcoreDesktopApi = {
     import: (input) => invoke('documents:import', input),
     save: (documentId, input) => invoke('documents:save', documentId, input),
     delete: (documentId) => invoke('documents:delete', documentId),
+    move: (documentId, fromRoomId, roomId) => invoke('documents:move', documentId, fromRoomId, roomId),
+    moveMany: (documentIds, fromRoomId, roomId) => invoke('documents:move-many', documentIds, fromRoomId, roomId),
     restore: (documentId) => invoke('documents:restore', documentId),
     deletePermanently: (documentId) => invoke('documents:delete-permanently', documentId),
     emptyTrash: (roomId) => invoke('documents:empty-trash', roomId),
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/ContextRoom.css b/apps/desktop/src/renderer/src/components/context-room/ported/ContextRoom.css
index 765cc80a..96084009 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/ContextRoom.css
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/ContextRoom.css
@@ -3690,15 +3690,18 @@
   --cr-border: #e5e7eb;
   --cr-blue: #408cf0;
   --cr-blue-soft: rgba(64, 140, 240, 0.14);
-  z-index: 1050;
+  z-index: 60;
+  box-sizing: border-box;
   width: min(320px, calc(100vw - 24px));
+  min-width: min(200px, calc(100vw - 24px));
+  max-width: calc(100vw - 24px);
   padding: 20px;
-  border: 1px solid var(--cr-border);
-  border-radius: 16px;
+  border: 1px solid rgba(17, 24, 39, 0.06);
+  border-radius: 18px;
   background: var(--cr-surface);
   box-shadow:
-    0 24px 70px rgba(21, 26, 34, 0.24),
-    0 2px 8px rgba(21, 26, 34, 0.06);
+    0 24px 60px rgba(17, 24, 39, 0.16),
+    0 6px 18px rgba(17, 24, 39, 0.06);
   color: var(--cr-text);
   font-family: 'Context Room Inter', 'HarmonyOS Sans SC', 'PingFang SC', sans-serif;
 }
@@ -3714,9 +3717,10 @@
 .context-room-document-create-popover input {
   width: 100%;
   height: 40px;
-  padding: 0 12px;
+  padding: 0 14px;
   border: 1px solid var(--cr-border);
-  border-radius: 10px;
+  border-radius: 12px;
+  line-height: 1;
   outline: none;
   background: var(--cr-surface-secondary);
   color: var(--cr-text);
@@ -3744,7 +3748,7 @@
   gap: 7px;
   margin-top: 12px;
   border: 1px solid var(--cr-border);
-  border-radius: 10px;
+  border-radius: 12px;
   background: var(--cr-surface);
   color: var(--cr-blue);
   font-size: 12.5px;
@@ -3786,11 +3790,12 @@
 }
 
 .context-room-document-create-popover footer button {
-  min-width: 64px;
-  height: 34px;
-  padding: 0 14px;
+  min-width: 72px;
+  height: 38px;
+  padding: 0 16px;
   border: 1px solid var(--cr-border);
-  border-radius: 9px;
+  border-radius: 10px;
+  line-height: 1;
   background: var(--cr-surface);
   color: var(--cr-muted);
   font-size: 12.5px;
@@ -3894,30 +3899,45 @@
 .context-room-artifact-toolbar {
   display: flex;
   flex: 0 0 auto;
+  flex-wrap: wrap;
   align-items: center;
   justify-content: space-between;
   gap: 8px;
-  padding: 10px 10px 8px;
+  row-gap: 8px;
+  padding: 12px 12px 10px;
   border-bottom: 1px solid var(--cr-border);
 }
 
+/* 工具条右侧动作组：整体不可压缩，窄面板时整组换行而不是把「新建产物」挤成竖排。 */
+.context-room-artifact-toolbar-actions {
+  display: flex;
+  min-width: 0;
+  flex: 1 1 auto;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 6px;
+  margin-left: auto;
+}
+
 /* 统一下拉筛选（FilterSelect）：胶囊触发器 + 自绘菜单；选中非默认值转蓝。 */
 .context-room-filter-select {
   display: inline-flex;
-  max-width: 180px;
-  height: 26px;
+  max-width: 190px;
+  height: 36px;
   align-items: center;
-  gap: 5px;
-  padding: 0 9px 0 12px;
+  gap: 6px;
+  padding: 0 12px 0 14px;
   border: 1px solid var(--cr-border);
-  border-radius: 999px;
+  border-radius: 10px;
   background: var(--cr-surface);
   color: var(--cr-muted);
-  font-size: 11px;
+  font-size: 12px;
   font-family: inherit;
+  line-height: 1;
   white-space: nowrap;
   cursor: pointer;
-  transition: border-color 0.15s ease, color 0.15s ease;
+  transition: border-color 0.15s ease, color 0.15s ease, background-color 0.15s ease;
 }
 
 .context-room-filter-select:hover {
@@ -3938,8 +3958,8 @@
 
 .context-room-filter-select svg {
   flex: none;
-  width: 12px;
-  height: 12px;
+  width: 14px;
+  height: 14px;
   color: var(--cr-tertiary);
 }
 
@@ -3956,22 +3976,26 @@
 /* 下拉菜单弹层：与卡片菜单同底（card-menu 提供白底/阴影/变量域），补齐布局与选中态。 */
 .context-room-filter-menu {
   --cr-blue: #3d6ff6;
-  min-width: 136px;
-  padding: 5px;
-  border: 1px solid var(--cr-border, #e5e7eb);
-  border-radius: 10px;
+  min-width: 150px;
+  padding: 7px;
+  border: 1px solid rgba(17, 24, 39, 0.06);
+  border-radius: 12px;
+  box-shadow:
+    0 16px 40px rgba(17, 24, 39, 0.14),
+    0 4px 12px rgba(17, 24, 39, 0.05);
   animation: context-room-filter-menu-in 0.16s ease;
 }
 
 .context-room-filter-menu-item {
   display: flex;
+  min-height: 36px;
   align-items: center;
-  gap: 8px;
-  padding: 6px 8px;
-  border-radius: 6px;
+  gap: 9px;
+  padding: 8px 10px;
+  border-radius: 8px;
   background: transparent;
   color: #1f1f1f;
-  font-size: 12px;
+  font-size: 12.5px;
   cursor: pointer;
   outline: none;
   user-select: none;
@@ -4014,30 +4038,40 @@
 
 .context-room-artifact-new {
   display: inline-flex;
+  min-width: 92px;
+  height: 36px;
+  flex: 0 0 auto;
   align-items: center;
-  gap: 4px;
-  padding: 3px 9px;
+  justify-content: center;
+  gap: 6px;
+  padding: 0 14px;
   border: 1px solid var(--cr-border);
-  border-radius: 6px;
+  border-radius: 10px;
+  background: var(--cr-surface);
   color: var(--cr-text);
-  font-size: 11px;
+  font-size: 12px;
+  font-weight: 500;
+  line-height: 1;
+  white-space: nowrap;
+  transition: border-color 0.15s ease, color 0.15s ease, background-color 0.15s ease;
 }
 
 .context-room-artifact-new:hover {
   border-color: var(--cr-blue);
+  background: var(--cr-blue-soft);
   color: var(--cr-blue);
 }
 
 .context-room-artifact-new svg {
-  width: 12px;
-  height: 12px;
+  width: 14px;
+  height: 14px;
 }
 
 .context-room-artifact-list {
   min-height: 0;
   flex: 1;
   overflow-y: auto;
-  padding: 6px 8px 12px;
+  padding: 8px 10px 14px;
 }
 
 .context-room-artifact-row {
@@ -4050,12 +4084,14 @@
   display: flex;
   width: 100%;
   min-width: 0;
+  min-height: 44px;
   align-items: center;
-  gap: 9px;
-  padding: 8px 26px 8px 8px;
-  border-radius: 8px;
+  gap: 10px;
+  padding: 8px 34px 8px 10px;
+  border-radius: 10px;
   text-align: left;
   cursor: pointer;
+  transition: background-color 0.12s ease;
 }
 
 .context-room-artifact-item:hover {
@@ -4082,19 +4118,19 @@
 
 .context-room-artifact-ico {
   display: inline-flex;
-  width: 30px;
-  height: 30px;
+  width: 34px;
+  height: 34px;
   flex: 0 0 auto;
   align-items: center;
   justify-content: center;
-  border-radius: 7px;
+  border-radius: 9px;
   background: var(--cr-surface-sunken);
   color: var(--cr-muted);
 }
 
 .context-room-artifact-ico svg {
-  width: 15px;
-  height: 15px;
+  width: 16px;
+  height: 16px;
 }
 
 .context-room-artifact-body {
@@ -4114,7 +4150,7 @@
 
 .context-room-artifact-body b {
   color: var(--cr-text);
-  font-size: 12px;
+  font-size: 12.5px;
   font-weight: 500;
 }
 
@@ -4131,7 +4167,7 @@
 }
 
 .context-room-artifact-tag {
-  padding: 1px 6px;
+  padding: 2px 8px;
   border: 1px solid var(--cr-border);
   border-radius: 999px;
   color: var(--cr-muted);
@@ -4147,9 +4183,9 @@
 .context-room-artifact-acts {
   position: absolute;
   top: 50%;
-  right: 6px;
+  right: 8px;
   display: inline-flex;
-  gap: 2px;
+  gap: 4px;
   opacity: 0;
   transition: opacity 0.15s ease;
 }
@@ -9144,6 +9180,7 @@
 }
 
 .context-room-related-graph-canvas {
+  position: relative;
   height: auto;
   min-height: 0;
   min-width: 0;
@@ -9155,6 +9192,42 @@
   background-size: 24px 24px;
 }
 
+/* 「自适应」浮层：视口可自由缩放平移，图缩小到看不见或拖走后，
+   这颗按钮仍钉在画布右上角，一键把节点整体缩放居中回来。
+   Context Room 各力导向图谱（首页全图/Room 关系/实体事实/建联/Wiki）共用同一套样式。 */
+.context-room-graph-fit {
+  position: absolute;
+  top: 10px;
+  right: 10px;
+  z-index: 2;
+  display: inline-flex;
+  height: 26px;
+  align-items: center;
+  gap: 5px;
+  padding: 0 9px;
+  border: 1px solid var(--cr-border);
+  border-radius: 6px;
+  background: color-mix(in srgb, var(--cr-surface) 92%, transparent);
+  color: var(--cr-muted);
+  font-size: 11px;
+  line-height: 1;
+  white-space: nowrap;
+  box-shadow: 0 1px 4px rgb(15 23 42 / 8%);
+  backdrop-filter: blur(4px);
+}
+
+.context-room-graph-fit:hover {
+  border-color: var(--cr-border-strong);
+  background: var(--cr-surface);
+  color: var(--cr-text);
+}
+
+.context-room-graph-fit svg {
+  width: 13px;
+  height: 13px;
+  flex: 0 0 auto;
+}
+
 .context-room-related-rooms-pane > .context-room-room-graph-inspector {
   height: auto;
   min-height: 0;
@@ -15338,6 +15411,7 @@ button.eg-walk.is-next:hover {
 /* 新建产物：类型选择网格（轻文档 / Word / PPT / Excel）。 */
 .context-room-document-create-popover.is-chooser {
   width: min(400px, calc(100vw - 24px));
+  min-width: min(300px, calc(100vw - 24px));
 }
 
 .context-room-document-create-types {
@@ -15351,9 +15425,9 @@ button.eg-walk.is-next:hover {
   align-items: center;
   gap: 10px;
   min-width: 0;
-  padding: 12px 14px;
+  padding: 13px 15px;
   border: 1px solid var(--cr-border);
-  border-radius: 10px;
+  border-radius: 12px;
   background: var(--cr-surface);
   color: var(--cr-text);
   cursor: pointer;
@@ -15372,8 +15446,8 @@ button.eg-walk.is-next:hover {
 }
 
 .context-room-document-create-type > svg {
-  width: 18px;
-  height: 18px;
+  width: 20px;
+  height: 20px;
   flex: none;
   color: var(--cr-blue);
 }
@@ -15388,6 +15462,7 @@ button.eg-walk.is-next:hover {
 .context-room-document-create-type-body b {
   font-size: 13px;
   font-weight: 600;
+  white-space: nowrap;
 }
 
 .context-room-document-create-type-body small {
@@ -15805,3 +15880,364 @@ button.eg-walk.is-next:hover {
   right: 0;
   text-align: center;
 }
+
+/* ── 产物行 ⋯ 操作菜单（移动到其他 Room / 删除） ── */
+.context-room-artifact-acts .context-room-resource-more {
+  display: inline-flex;
+  width: 26px;
+  height: 26px;
+  align-items: center;
+  justify-content: center;
+  border-radius: 8px;
+  color: var(--cr-muted);
+  opacity: 1;
+  transition:
+    background-color 120ms ease,
+    color 120ms ease;
+}
+
+.context-room-artifact-acts .context-room-resource-more:hover:not(:disabled),
+.context-room-artifact-acts .context-room-resource-more:focus-visible {
+  background: var(--cr-surface-hover);
+  color: var(--cr-text);
+}
+
+.context-room-artifact-acts .context-room-resource-more svg {
+  width: 16px;
+  height: 16px;
+}
+
+/* ── 移动到其他 Room 目标选择器 ── */
+.context-room-move-dialog {
+  display: flex;
+  width: min(480px, 100%);
+  max-width: 100%;
+  flex-direction: column;
+  gap: 14px;
+  margin: 0 auto;
+  padding: 22px 20px 20px;
+}
+
+.context-room-move-dialog header {
+  display: flex;
+  align-items: flex-start;
+  gap: 12px;
+  padding-right: 44px;
+}
+
+.context-room-move-dialog h2 {
+  margin: 0;
+  color: var(--cr-text);
+  font-size: 16px;
+  font-weight: 600;
+  line-height: 1.35;
+}
+
+.context-room-move-dialog header p {
+  margin: 3px 0 0;
+  color: var(--cr-muted);
+  font-size: 12px;
+  line-height: 1.5;
+}
+
+.context-room-move-symbol {
+  display: inline-flex;
+  width: 40px;
+  height: 40px;
+  flex: 0 0 auto;
+  align-items: center;
+  justify-content: center;
+  border-radius: 12px;
+  background: var(--cr-blue-soft);
+  color: var(--cr-blue);
+}
+
+.context-room-move-symbol svg {
+  width: 19px;
+  height: 19px;
+}
+
+.context-room-move-search {
+  display: flex;
+  height: 40px;
+  align-items: center;
+  gap: 9px;
+  padding: 0 13px;
+  border: 1px solid var(--cr-border);
+  border-radius: 12px;
+  background: var(--cr-surface);
+  transition: border-color 0.15s ease, box-shadow 0.15s ease;
+}
+
+.context-room-move-search:focus-within {
+  border-color: var(--cr-blue);
+  box-shadow: 0 0 0 3px var(--cr-blue-soft);
+}
+
+.context-room-move-search svg {
+  width: 15px;
+  height: 15px;
+  flex: 0 0 auto;
+  color: var(--cr-tertiary);
+}
+
+.context-room-move-search input {
+  width: 100%;
+  min-width: 0;
+  border: 0;
+  outline: none;
+  background: transparent;
+  color: var(--cr-text);
+  font-size: 13px;
+  line-height: 1;
+}
+
+.context-room-move-list {
+  display: flex;
+  max-height: min(320px, 46vh);
+  flex-direction: column;
+  gap: 2px;
+  overflow-y: auto;
+  padding: 6px;
+  border: 1px solid var(--cr-border);
+  border-radius: 12px;
+  background: var(--cr-surface);
+}
+
+.context-room-move-group {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin: 8px 8px 4px;
+  color: var(--cr-tertiary);
+  font-size: 11px;
+}
+
+.context-room-move-group svg {
+  width: 11px;
+  height: 11px;
+}
+
+.context-room-move-room {
+  display: flex;
+  width: 100%;
+  min-height: 40px;
+  align-items: center;
+  padding: 9px 12px;
+  border-radius: 9px;
+  text-align: left;
+  transition: background-color 0.12s ease;
+}
+
+.context-room-move-room:hover {
+  background: var(--cr-surface-hover);
+}
+
+.context-room-move-room[data-selected] {
+  background: var(--cr-blue-soft);
+}
+
+.context-room-move-room-body {
+  display: flex;
+  min-width: 0;
+  flex-direction: column;
+  gap: 1px;
+}
+
+.context-room-move-room-body b {
+  overflow: hidden;
+  color: var(--cr-text);
+  font-size: 13px;
+  font-weight: 500;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.context-room-move-room[data-selected] .context-room-move-room-body b {
+  color: var(--cr-blue);
+}
+
+.context-room-move-room-body small {
+  color: var(--cr-tertiary);
+  font-size: 11px;
+}
+
+.context-room-move-hint {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin: 0;
+  padding: 10px;
+  color: var(--cr-tertiary);
+  font-size: 12px;
+}
+
+.context-room-move-hint svg {
+  width: 13px;
+  height: 13px;
+}
+
+.context-room-move-error {
+  margin: 0;
+  color: #b54732;
+  font-size: 11px;
+  line-height: 1.5;
+}
+
+.context-room-move-dialog footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: 10px;
+}
+
+.context-room-action-confirm-note {
+  margin: 0;
+  color: var(--cr-tertiary);
+  font-size: 11px;
+  line-height: 1.5;
+}
+
+/* 产物相关的弹窗：16px 大圆角 + 柔和分层阴影（rounded-2xl 档）。 */
+.context-room-dialog-content.context-room-move-dialog-shell {
+  width: min(520px, calc(100vw - 32px));
+  border: 1px solid rgba(17, 24, 39, 0.06);
+  border-radius: 16px;
+  box-shadow:
+    0 24px 60px rgba(17, 24, 39, 0.16),
+    0 6px 18px rgba(17, 24, 39, 0.06);
+}
+
+.context-room-dialog-content.context-room-artifact-delete-shell {
+  width: min(480px, calc(100vw - 32px));
+  border: 1px solid rgba(17, 24, 39, 0.06);
+  border-radius: 16px;
+  box-shadow:
+    0 24px 60px rgba(17, 24, 39, 0.16),
+    0 6px 18px rgba(17, 24, 39, 0.06);
+}
+
+.context-room-artifact-delete-shell .context-room-action-confirm {
+  width: 100%;
+}
+
+/* 弹窗底部按钮统一 40px 高、12px 圆角，图标/文字垂直居中。 */
+.context-room-move-dialog footer button,
+.context-room-artifact-delete-shell .context-room-action-confirm footer button {
+  min-height: 40px;
+  padding: 0 16px;
+  border-radius: 12px;
+  font-size: 13px;
+  line-height: 1;
+}
+
+/* ── 产物库多选整理 ── */
+.context-room-artifact-select-toggle,
+.context-room-artifact-selection-move,
+.context-room-artifact-selection-cancel {
+  display: inline-flex;
+  flex: 0 0 auto;
+  align-items: center;
+  gap: 6px;
+  height: 36px;
+  padding: 0 13px;
+  border: 1px solid var(--cr-border);
+  border-radius: 10px;
+  background: var(--cr-surface);
+  color: var(--cr-text);
+  font-size: 12px;
+  font-weight: 500;
+  line-height: 1;
+  white-space: nowrap;
+  transition: border-color 0.15s ease, color 0.15s ease, background-color 0.15s ease;
+}
+
+.context-room-artifact-select-toggle:hover,
+.context-room-artifact-selection-cancel:hover {
+  border-color: var(--cr-blue);
+  color: var(--cr-blue);
+}
+
+.context-room-artifact-select-toggle svg,
+.context-room-artifact-selection-move svg {
+  width: 14px;
+  height: 14px;
+}
+
+.context-room-artifact-selection {
+  display: inline-flex;
+  min-width: 0;
+  align-items: center;
+  gap: 6px;
+}
+
+.context-room-artifact-selection > span {
+  color: var(--cr-muted);
+  font-size: 12px;
+  white-space: nowrap;
+}
+
+.context-room-artifact-selection-move {
+  border-color: var(--cr-blue);
+  background: var(--cr-blue-soft);
+  color: var(--cr-blue);
+}
+
+.context-room-artifact-selection-move:disabled {
+  border-color: var(--cr-border);
+  background: transparent;
+  color: var(--cr-tertiary);
+  cursor: not-allowed;
+}
+
+.context-room-artifact-check {
+  display: inline-flex;
+  width: 18px;
+  height: 18px;
+  flex: 0 0 auto;
+  align-items: center;
+  justify-content: center;
+  margin-left: 6px;
+  border: 1px solid var(--cr-border);
+  border-radius: 5px;
+  background: var(--cr-surface);
+  color: #fff;
+}
+
+.context-room-artifact-check[aria-checked='true'] {
+  border-color: var(--cr-blue);
+  background: var(--cr-blue);
+}
+
+.context-room-artifact-check svg {
+  width: 12px;
+  height: 12px;
+}
+
+.context-room-artifact-row[data-selecting] .context-room-artifact-item {
+  padding-left: 4px;
+}
+
+/* 产物行 ⋯ 菜单：12px 圆角 + 柔和阴影 + 36px 行高，与浮层/弹窗同一视觉档。 */
+.context-room-artifact-menu {
+  z-index: 60;
+  min-width: 200px;
+  padding: 8px;
+  border-color: rgba(17, 24, 39, 0.06);
+  border-radius: 12px;
+  box-shadow:
+    0 16px 40px rgba(17, 24, 39, 0.14),
+    0 4px 12px rgba(17, 24, 39, 0.05);
+}
+
+.context-room-artifact-menu [role='menuitem'] {
+  min-height: 36px;
+  gap: 9px;
+  padding: 8px 10px;
+  border-radius: 8px;
+  font-size: 12.5px;
+}
+
+.context-room-artifact-menu svg {
+  width: 15px;
+  height: 15px;
+}
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/EntityFactGraphCanvas.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/EntityFactGraphCanvas.tsx
index cbbbe589..a4de7302 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/EntityFactGraphCanvas.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/EntityFactGraphCanvas.tsx
@@ -11,6 +11,7 @@ import {
   useForceGraphLayout,
 } from '@/components/graph'
 import { useLocale } from '../../../../i18n/LocaleContext'
+import { GraphFitButton } from './GraphFitButton'
 import type { EntityFactGraphData, EntityFactGraphNode } from './entityFactGraphModel'
 
 /** 详情面板小视口：布局稳定后只居中、不缩小；收敛期间相机逐帧跟随内容。 */
@@ -158,6 +159,7 @@ export function EntityFactGraphCanvas({ data, onSelect, selectedId }: EntityFact
         onReleaseNode={layout.release}
         onSelectNode={onSelect}
       />
+      {data.nodes.length > 0 ? <GraphFitButton onFit={() => canvasRef.current?.fitView()} /> : null}
       <div className="context-room-visually-hidden" aria-label={t('contextRoom:graphs.entityFactNodes')}>
         {data.nodes.map((node: EntityFactGraphNode) => (
           <button
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/GraphFitButton.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/GraphFitButton.tsx
new file mode 100644
index 00000000..a0c4fa80
--- /dev/null
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/GraphFitButton.tsx
@@ -0,0 +1,33 @@
+import { Maximize2 } from 'lucide-react'
+
+import { useLocale } from '../../../../i18n/LocaleContext'
+import { cn } from '../adapters'
+
+/**
+ * 图谱「自适应」浮层按钮。
+ *
+ * 力导向画布的视口可以自由缩放平移，缩到最小或拖出视野后整张图会看不见；
+ * 这颗按钮钉在画布右上角（宿主容器 position: relative），一键把节点整体缩放居中回来。
+ * 各图谱只负责传入自己的 fitView 回调。
+ */
+export function GraphFitButton({
+  onFit,
+  className,
+}: {
+  onFit: () => void
+  className?: string
+}) {
+  const { t } = useLocale()
+  return (
+    <button
+      type="button"
+      className={cn('context-room-graph-fit', className)}
+      aria-label={t('contextRoom:graphs.fitCanvasHint')}
+      title={t('contextRoom:graphs.fitToCanvas')}
+      onClick={onFit}
+    >
+      <Maximize2 aria-hidden="true" />
+      {t('contextRoom:graphs.fitToCanvas')}
+    </button>
+  )
+}
\ No newline at end of file
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 cbde5a8b..f92df9d9 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, useState } from 'react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 import { useLocale } from '../../../../i18n/LocaleContext';
 
 import type { ContextRoomRecord } from '../types';
@@ -18,7 +18,8 @@ import { RoomCard } from './RoomCard';
 import { RoomCreationStudio } from './RoomCreationStudio';
 import { RoomLifecycleDialogs } from './RoomDialogs';
 import { isMergeRecommendationCandidate, RoomDuplicateCenter } from './RoomDuplicateCenter';
-import { RoomGraphCanvas } from './RoomGraphCanvas';
+import { GraphFitButton } from './GraphFitButton';
+import { RoomGraphCanvas, type RoomGraphCanvasHandle } from './RoomGraphCanvas';
 import { RoomNodeInspector } from './RoomGraphInspector';
 import { RoomRelationInspector } from './RoomRelationControls';
 import { useRoomRelationGraph } from '../hooks/useRoomRelationGraph';
@@ -37,9 +38,11 @@ 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 详情的关系面板），
-  // 只保留标题 + 画布 + 点选节点/关系出检查器。
+  // 只保留标题 + 画布 + 点选节点/关系出检查器；另加一颗常驻画布的自适应按钮，
+  // 因为视口能自由缩放平移，缩到最小或拖走后整张图会看不见。
   return (
     <section className="context-room-home-section context-room-home-graph-section">
       <div className="context-room-home-section-title context-room-graph-heading">
@@ -49,6 +52,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}
               rooms={rooms}
               relations={graph?.edges ?? []}
               selectedId={selectedId}
@@ -58,6 +62,7 @@ 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/LinkGraphCanvas.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/LinkGraphCanvas.tsx
index 04d8d192..2cdd2035 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/LinkGraphCanvas.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/LinkGraphCanvas.tsx
@@ -12,6 +12,7 @@ import {
   type ForceGraphEdge,
 } from '@/components/graph'
 import { useLocale } from '../../../../i18n/LocaleContext'
+import { GraphFitButton } from './GraphFitButton'
 import {
   LINK_GRAPH_ROOT_ID,
   linkGraphBlockNodeId,
@@ -353,6 +354,7 @@ export function LinkGraphCanvas({
         onReleaseNode={layout.release}
         onSelectNode={onSelect}
       />
+      {data.nodes.length > 0 ? <GraphFitButton onFit={() => canvasRef.current?.fitView()} /> : null}
       <div className="context-room-visually-hidden" aria-label={t('contextRoom:graphs.linkGraphNodes')}>
         {data.nodes.map((node: LinkGraphNode) => (
           <button
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/MoveDocumentToRoomDialog.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/MoveDocumentToRoomDialog.tsx
new file mode 100644
index 00000000..cac2e2ab
--- /dev/null
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/MoveDocumentToRoomDialog.tsx
@@ -0,0 +1,259 @@
+import type { MovedRoomDocument } from '@nxcore/agent-contract'
+import { Clock, FolderInput, LoaderCircle, Search } from 'lucide-react'
+import { useEffect, useMemo, useState } from 'react'
+
+import { showToast } from '@/state/toast'
+import { useLocale } from '../../../../i18n/LocaleContext'
+import { ReferenceDialog } from './shared'
+
+export interface MovableDocumentSummary {
+  id: string
+  title: string
+  /** 文档当前所属 Room（源房）。 */
+  roomId: string
+}
+
+interface RoomOption {
+  id: string
+  title: string
+  kind?: string
+}
+
+const RECENT_KEY = 'everroom:move-document-recent-rooms'
+const RECENT_LIMIT = 5
+
+function readRecentRoomIds(): string[] {
+  try {
+    const raw = window.localStorage.getItem(RECENT_KEY)
+    if (!raw) return []
+    const parsed: unknown = JSON.parse(raw)
+    return Array.isArray(parsed)
+      ? parsed.filter((value): value is string => typeof value === 'string').slice(0, RECENT_LIMIT)
+      : []
+  } catch {
+    return []
+  }
+}
+
+function rememberRecentRoomId(roomId: string): void {
+  try {
+    const next = [roomId, ...readRecentRoomIds().filter((id) => id !== roomId)].slice(0, RECENT_LIMIT)
+    window.localStorage.setItem(RECENT_KEY, JSON.stringify(next))
+  } catch {
+    // 隐私模式/配额受限时静默降级：最近使用只是快捷入口，不阻断移动。
+  }
+}
+
+/**
+ * 「移动到其他 Room」目标选择器：搜索过滤 + 最近使用置顶 + 单选确认。
+ *
+ * 房间清单每次打开都从网关快照取（避免本地快照滞后），排除文档当前所在房。
+ * 批量（多选）与单个走同一弹层：documents.length > 1 时调用批量移动接口。
+ */
+export function MoveDocumentToRoomDialog({
+  open,
+  onOpenChange,
+  documents,
+  onMoved,
+}: {
+  open: boolean
+  onOpenChange: (open: boolean) => void
+  documents: MovableDocumentSummary[]
+  onMoved?: (moved: MovedRoomDocument[]) => void
+}) {
+  const { t } = useLocale()
+  const [rooms, setRooms] = useState<RoomOption[]>([])
+  const [loading, setLoading] = useState(false)
+  const [loadError, setLoadError] = useState<string | null>(null)
+  const [query, setQuery] = useState('')
+  const [selectedRoomId, setSelectedRoomId] = useState<string | null>(null)
+  const [moving, setMoving] = useState(false)
+  const [moveError, setMoveError] = useState<string | null>(null)
+
+  const sourceRoomId = documents[0]?.roomId ?? null
+  const documentKey = documents.map((document) => document.id).join('\u0000')
+
+  useEffect(() => {
+    if (!open) return
+    setQuery('')
+    setSelectedRoomId(null)
+    setMoveError(null)
+    setLoadError(null)
+    const api = window.nxcore?.contextRooms
+    if (!api) {
+      setRooms([])
+      setLoadError(t('contextRoom:moveDocument.roomsUnavailable'))
+      return
+    }
+    let cancelled = false
+    setLoading(true)
+    void api.list()
+      .then((snapshot) => {
+        if (cancelled) return
+        setRooms((snapshot?.rooms ?? []).map((room) => ({
+          id: room.id,
+          title: room.title,
+          kind: room.kind,
+        })))
+      })
+      .catch((error: unknown) => {
+        if (cancelled) return
+        setLoadError(error instanceof Error ? error.message : t('contextRoom:moveDocument.roomsUnavailable'))
+      })
+      .finally(() => {
+        if (!cancelled) setLoading(false)
+      })
+    return () => {
+      cancelled = true
+    }
+  }, [open, documentKey])
+
+  const candidates = useMemo(
+    () => rooms.filter((room) => room.id !== sourceRoomId),
+    [rooms, sourceRoomId],
+  )
+  const keyword = query.trim().toLocaleLowerCase()
+  const matches = useMemo(
+    () => (keyword
+      ? candidates.filter((room) =>
+        room.title.toLocaleLowerCase().includes(keyword)
+        || (room.kind ?? '').toLocaleLowerCase().includes(keyword))
+      : candidates),
+    [candidates, keyword],
+  )
+  const recentIds = open ? readRecentRoomIds() : []
+  const recentRooms = matches.filter((room) => recentIds.includes(room.id))
+  const otherRooms = matches.filter((room) => !recentIds.includes(room.id))
+  const targetRoom = rooms.find((room) => room.id === selectedRoomId) ?? null
+  const isBatch = documents.length > 1
+
+  const submit = async () => {
+    const target = selectedRoomId
+    if (!target || documents.length === 0) return
+    const api = window.nxcore?.documents
+    if (!api) {
+      setMoveError(t('contextRoom:moveDocument.documentsUnavailable'))
+      return
+    }
+    setMoving(true)
+    setMoveError(null)
+    try {
+      const moved = documents.length > 1
+        ? (await api.moveMany(documents.map((document) => document.id), documents[0]!.roomId, target)).items
+        : [await api.move(documents[0]!.id, documents[0]!.roomId, target)]
+      rememberRecentRoomId(target)
+      const roomTitle = rooms.find((room) => room.id === target)?.title ?? target
+      showToast({
+        title: t('contextRoom:moveDocument.moved'),
+        message: isBatch
+          ? t('contextRoom:moveDocument.movedManyToRoom', { count: documents.length, room: roomTitle })
+          : t('contextRoom:moveDocument.movedToRoom', { name: documents[0]!.title, room: roomTitle }),
+      })
+      onMoved?.(moved)
+      onOpenChange(false)
+    } catch (error: unknown) {
+      setMoveError(error instanceof Error && error.message
+        ? error.message
+        : t('contextRoom:moveDocument.moveFailed'))
+    } finally {
+      setMoving(false)
+    }
+  }
+
+  const renderRoom = (room: RoomOption) => (
+    <button
+      key={room.id}
+      type="button"
+      className="context-room-move-room"
+      data-selected={room.id === selectedRoomId || undefined}
+      aria-pressed={room.id === selectedRoomId}
+      onClick={() => setSelectedRoomId(room.id)}
+    >
+      <span className="context-room-move-room-body">
+        <b>{room.title}</b>
+        {room.kind ? <small>{room.kind}</small> : null}
+      </span>
+    </button>
+  )
+
+  return (
+    <ReferenceDialog
+      open={open}
+      onOpenChange={onOpenChange}
+      title={t('contextRoom:moveDocument.title')}
+      contentClassName="context-room-move-dialog-shell"
+    >
+      <div className="context-room-move-dialog">
+        <header>
+          <span className="context-room-move-symbol">
+            <FolderInput aria-hidden="true" strokeWidth={1.8} />
+          </span>
+          <div>
+            <h2>{t('contextRoom:moveDocument.title')}</h2>
+            <p>
+              {isBatch
+                ? t('contextRoom:moveDocument.subtitleBatch', { count: documents.length })
+                : t('contextRoom:moveDocument.subtitle', { name: documents[0]?.title ?? '' })}
+            </p>
+          </div>
+        </header>
+
+        <label className="context-room-move-search">
+          <Search aria-hidden="true" strokeWidth={1.8} />
+          <input
+            type="text"
+            autoFocus
+            value={query}
+            placeholder={t('contextRoom:moveDocument.searchPlaceholder')}
+            aria-label={t('contextRoom:moveDocument.searchPlaceholder')}
+            onChange={(event) => setQuery(event.target.value)}
+          />
+        </label>
+
+        <div className="context-room-move-list" role="listbox" aria-label={t('contextRoom:moveDocument.targetRoom')}>
+          {loading ? (
+            <p className="context-room-move-hint">
+              <LoaderCircle className="is-spinning" aria-hidden="true" />
+              {t('contextRoom:moveDocument.loadingRooms')}
+            </p>
+          ) : null}
+          {loadError ? <p className="context-room-move-error" role="alert">{loadError}</p> : null}
+          {!loading && !loadError && recentRooms.length > 0 ? (
+            <p className="context-room-move-group">
+              <Clock aria-hidden="true" strokeWidth={1.8} />
+              {t('contextRoom:moveDocument.recent')}
+            </p>
+          ) : null}
+          {!loading && !loadError ? recentRooms.map(renderRoom) : null}
+          {!loading && !loadError && otherRooms.length > 0 && recentRooms.length > 0 ? (
+            <p className="context-room-move-group">{t('contextRoom:moveDocument.allRooms')}</p>
+          ) : null}
+          {!loading && !loadError ? otherRooms.map(renderRoom) : null}
+          {!loading && !loadError && matches.length === 0 ? (
+            <p className="context-room-move-hint">{t('contextRoom:moveDocument.noMatch')}</p>
+          ) : null}
+        </div>
+
+        {moveError ? <p className="context-room-move-error" role="alert">{moveError}</p> : null}
+
+        <footer>
+          <button type="button" className="context-room-ghost" onClick={() => onOpenChange(false)}>
+            {t('contextRoom:moveDocument.cancel')}
+          </button>
+          <button
+            type="button"
+            className="context-room-primary"
+            disabled={!targetRoom || moving}
+            onClick={() => void submit()}
+          >
+            {moving
+              ? t('contextRoom:moveDocument.moving')
+              : targetRoom
+                ? t('contextRoom:moveDocument.moveToRoom', { room: targetRoom.title })
+                : t('contextRoom:moveDocument.move')}
+          </button>
+        </footer>
+      </div>
+    </ReferenceDialog>
+  )
+}
\ No newline at end of file
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/WikiGraphCanvas.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/WikiGraphCanvas.tsx
index af2f32ff..bfd5a404 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/WikiGraphCanvas.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/WikiGraphCanvas.tsx
@@ -1,4 +1,4 @@
-import { useMemo, useRef } from 'react'
+import { forwardRef, useImperativeHandle, useMemo, useRef } from 'react'
 
 import type { KnowledgeWikiGraphDto } from '../../../../../../shared/knowledge'
 import {
@@ -10,6 +10,7 @@ import {
   useForceGraphLayout,
 } from '@/components/graph'
 import { useLocale } from '../../../../i18n/LocaleContext'
+import { GraphFitButton } from './GraphFitButton'
 
 /** 详情面板小视口：布局稳定后只居中、不缩小；收敛期间相机逐帧跟随内容。 */
 const SETTLE_FIT = { minScale: 1, follow: true }
@@ -60,12 +61,28 @@ function initialPositions(count: number, width: number, height: number) {
   return positions
 }
 
-/** Wiki 内链图谱：Worker 计算 d3-force，画布只读取 SharedArrayBuffer 坐标。 */
-export function WikiGraphCanvas({ graph, selectedPath, onSelectPage }: {
+export interface WikiGraphCanvasHandle {
+  fitView(): void
+}
+
+interface WikiGraphCanvasProps {
   graph: KnowledgeWikiGraphDto
   selectedPath: string | null
   onSelectPage: (path: string) => void
-}) {
+  /**
+   * 是否在画布右上角挂内置的自适应浮层。宿主自己有图谱工具栏时关掉，
+   * 改成在工具栏里放一颗，避免和工具栏的按钮叠在一起。
+   */
+  showFitButton?: boolean
+}
+
+/** Wiki 内链图谱：Worker 计算 d3-force，画布只读取 SharedArrayBuffer 坐标。 */
+function WikiGraphCanvasComponent({
+  graph,
+  selectedPath,
+  onSelectPage,
+  showFitButton = true,
+}: WikiGraphCanvasProps, ref: React.ForwardedRef<WikiGraphCanvasHandle>) {
   const { t } = useLocale()
   const canvasRef = useRef<PixiForceGraphCanvasHandle>(null)
   const nodeIndex = useMemo(
@@ -120,6 +137,11 @@ export function WikiGraphCanvas({ graph, selectedPath, onSelectPage }: {
   const selectedId = selectedPath
     ? graph.nodes.find((node) => node.path === selectedPath)?.id ?? null
     : null
+  useImperativeHandle(ref, () => ({
+    fitView() {
+      canvasRef.current?.fitView()
+    },
+  }), [])
 
   return (
     <div className="context-room-graph-shell context-room-wiki-graph nx-graph-shell">
@@ -144,6 +166,9 @@ export function WikiGraphCanvas({ graph, selectedPath, onSelectPage }: {
           if (path) onSelectPage(path)
         }}
       />
+      {showFitButton && graph.nodes.length > 0
+        ? <GraphFitButton onFit={() => canvasRef.current?.fitView()} />
+        : null}
       <div className="context-room-visually-hidden" aria-label={t('contextRoom:graphs.wikiNodes')}>
         {graph.nodes.map((node) => (
           <button
@@ -160,3 +185,5 @@ export function WikiGraphCanvas({ graph, selectedPath, onSelectPage }: {
     </div>
   )
 }
+
+export const WikiGraphCanvas = forwardRef(WikiGraphCanvasComponent)
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-editor/TiptapDocumentActions.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-editor/TiptapDocumentActions.tsx
index bce4453f..d9082c66 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-editor/TiptapDocumentActions.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-editor/TiptapDocumentActions.tsx
@@ -1,7 +1,7 @@
 import * as DropdownMenu from '@radix-ui/react-dropdown-menu'
 import type { DocumentDiffResult, DocumentVersionSnapshot, RoomDocument } from '@nxcore/agent-contract'
 import type { Editor } from '@tiptap/react'
-import { ChevronRight, Download, Ellipsis, ExternalLink, FileDown, FileText, MessageSquare, Trash2 } from 'lucide-react'
+import { ChevronRight, Download, Ellipsis, ExternalLink, FileDown, FileText, FolderInput, MessageSquare, Trash2 } from 'lucide-react'
 import { useEffect, useState } from 'react'
 import { useLocale } from '../../../../../i18n/LocaleContext'
 
@@ -9,6 +9,7 @@ import { showToast } from '../../../../../state/toast'
 import { ActionConfirmDialog } from '../../components/shared'
 import { createDocxBlob, docxExportFileName } from './tiptapDocxExport'
 import { exportEditorPdf } from './tiptapPdfExport'
+import { MoveDocumentToRoomDialog } from '../MoveDocumentToRoomDialog'
 import { DocumentHistoryPanel } from './DocumentHistoryPanel'
 import { ExternalExportDialog } from './ExternalExportDialog'
 import { ExternalImportDialog } from './ExternalImportDialog'
@@ -77,6 +78,7 @@ export function TiptapDocumentActions({
 }) {
   const { t } = useLocale()
   const [deleteDialogOpen, setDeleteDialogOpen] = useState(false)
+  const [moveDialogOpen, setMoveDialogOpen] = useState(false)
   const [exportingPdf, setExportingPdf] = useState(false)
   const [exportProvider, setExportProvider] = useState<'feishu' | 'notion' | null>(null)
   const [importOpen, setImportOpen] = useState(false)
@@ -151,6 +153,7 @@ export function TiptapDocumentActions({
   }
 
   const deleteDisabled = writing || saving || !backendDocument || !onDeleteDocument
+  const moveDisabled = writing || saving || !backendDocument
   return (
     <div className="context-room-document-actions">
       <DocumentHistoryPanel
@@ -226,6 +229,17 @@ export function TiptapDocumentActions({
               </DropdownMenu.Item>
             )}
             <DropdownMenu.Separator className="context-room-document-actions-separator" />
+            <DropdownMenu.Item
+              disabled={moveDisabled}
+              title={!backendDocument
+                ? t('contextRoom:tiptapDocumentActions.saveBeforeMoving')
+                : undefined}
+              onSelect={() => setMoveDialogOpen(true)}
+            >
+              <FolderInput aria-hidden="true" />
+              {t('contextRoom:tiptapDocumentActions.moveToAnotherRoom')}
+            </DropdownMenu.Item>
+            <DropdownMenu.Separator className="context-room-document-actions-separator" />
             <DropdownMenu.Item
               className="danger"
               disabled={deleteDisabled}
@@ -242,6 +256,13 @@ export function TiptapDocumentActions({
           </DropdownMenu.Content>
         </DropdownMenu.Portal>
       </DropdownMenu.Root>
+      <MoveDocumentToRoomDialog
+        open={moveDialogOpen}
+        onOpenChange={setMoveDialogOpen}
+        documents={backendDocument
+          ? [{ id: backendDocument.id, title: documentName || backendDocument.title, roomId: backendDocument.roomId }]
+          : []}
+      />
       <ActionConfirmDialog
         open={deleteDialogOpen}
         onOpenChange={setDeleteDialogOpen}
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-panels/ArtifactLibraryPane.tsx b/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-panels/ArtifactLibraryPane.tsx
index 0472bae1..148af34e 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-panels/ArtifactLibraryPane.tsx
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/components/detail-panels/ArtifactLibraryPane.tsx
@@ -1,5 +1,6 @@
+import * as DropdownMenu from '@radix-ui/react-dropdown-menu';
 import * as Popover from '@radix-ui/react-popover';
-import { FileText, FileSpreadsheet, FileUp, FolderOpen, Presentation, FileText as WordIcon, LoaderCircle, Package, Plus, Trash2 } from 'lucide-react';
+import { Check, Ellipsis, FileText, FileSpreadsheet, FileUp, FolderInput, FolderOpen, ListChecks, Presentation, FileText as WordIcon, LoaderCircle, Package, Plus, Trash2 } from 'lucide-react';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { useLocale } from '../../../../../i18n/LocaleContext';
 import type { RoomDocument, TiptapJsonContent } from '@nxcore/agent-contract';
@@ -17,7 +18,8 @@ import { markdownDocumentTitle, parseMarkdownDocument } from '../detail-editor/m
 import { ARTIFACT_IMPORT_EXTENSIONS, isArtifactImportFileName } from '../../../../../../../shared/sources';
 import { buildLinkGraphData } from '../linkGraphModel';
 import { PanelEmptyState } from './PanelEmptyState';
-import { FilterSelect } from '../shared';
+import { FilterSelect, ReferenceDialog } from '../shared';
+import { MoveDocumentToRoomDialog } from '../MoveDocumentToRoomDialog';
 
 type ArtifactFilter = 'all' | 'clouddoc' | 'office';
 type CreateType = 'doc' | 'word' | 'ppt' | 'xlsx';
@@ -84,6 +86,27 @@ export function ArtifactLibraryPane({
   >(null);
   const [deletingArtifact, setDeletingArtifact] = useState(false);
   const [deleteError, setDeleteError] = useState<string | null>(null);
+  // 移动目标：空数组 = 弹层关闭；单个/批量共用同一目标选择器。
+  const [moveTargets, setMoveTargets] = useState<Array<{ id: string; title: string; roomId: string }>>([]);
+  // 多选整理：开启后云文档行进入勾选态，工具条提供批量「移动到其他 Room」。
+  const [selectionMode, setSelectionMode] = useState(false);
+  const [selectedDocumentIds, setSelectedDocumentIds] = useState<Set<string>>(() => new Set());
+
+  const exitSelection = () => {
+    setSelectionMode(false);
+    setSelectedDocumentIds(new Set());
+  };
+
+  const toggleDocumentSelection = (documentId: string) => {
+    setSelectedDocumentIds((current) => {
+      const next = new Set(current);
+      if (next.has(documentId)) next.delete(documentId);
+      else next.add(documentId);
+      return next;
+    });
+  };
+
+  const selectedDocuments = backendDocuments.filter((document) => selectedDocumentIds.has(document.id));
 
   // 文稿页「+新建文档」进入本 Room 的一次性意图：自动展开「+新建产物」面板，
   // 直接停在创建类型选择界面（轻文档 / Word / PPT / Excel）。
@@ -273,140 +296,239 @@ export function ArtifactLibraryPane({
           onChange={setFilter}
           ariaLabel={t('contextRoom:boardTab.library')}
         />
-        <Popover.Root
-          open={createPopoverOpen}
-          onOpenChange={(nextOpen) => {
-            if (!nextOpen && creatingDocument) return;
-            setCreateError(null);
-            setCreatePopoverOpen(nextOpen);
-            if (!nextOpen) { setNewDocumentTitle(''); setCreateType(null); }
-          }}
-        >
-          <Popover.Trigger asChild>
+        <div className="context-room-artifact-toolbar-actions">
+          {selectionMode ? (
+            <div className="context-room-artifact-selection" role="group" aria-label={t('contextRoom:artifactLibrary.selectedCount', { count: selectedDocumentIds.size })}>
+              <span>{t('contextRoom:artifactLibrary.selectedCount', { count: selectedDocumentIds.size })}</span>
+              <button
+                type="button"
+                className="context-room-artifact-selection-move"
+                disabled={selectedDocuments.length === 0}
+                onClick={() => setMoveTargets(selectedDocuments.map((document) => ({
+                  id: document.id,
+                  title: document.title,
+                  roomId: document.roomId,
+                })))}
+              >
+                <FolderInput aria-hidden="true" />
+                {t('contextRoom:artifactLibrary.moveSelected')}
+              </button>
+              <button type="button" className="context-room-artifact-selection-cancel" onClick={exitSelection}>
+                {t('contextRoom:artifactLibrary.cancelSelection')}
+              </button>
+            </div>
+          ) : (
             <button
               type="button"
-              className="context-room-artifact-new"
-              aria-label={t('contextRoom:artifactLibrary.newArtifact')}
-              disabled={creatingDocument}
+              className="context-room-artifact-select-toggle"
+              aria-pressed={false}
+              onClick={() => setSelectionMode(true)}
             >
-              {creatingDocument
-                ? <LoaderCircle aria-hidden="true" className="is-spinning" />
-                : <Plus aria-hidden="true" />}
-              {t('contextRoom:artifactLibrary.newArtifact')}
+              <ListChecks aria-hidden="true" />
+              {t('contextRoom:artifactLibrary.select')}
             </button>
-          </Popover.Trigger>
-          <Popover.Portal>
-            <Popover.Content
-              className={`context-room-document-create-popover${createType === null ? ' is-chooser' : ''}`}
-              side="right"
-              align="start"
-              sideOffset={8}
-              collisionPadding={12}
-              aria-label={t('contextRoom:artifactLibrary.newArtifact')}
-            >
-              {createType === null ? (
-                <div className="context-room-document-create-types">
-                  {CREATE_TYPES.map(({ id, label, hint, icon: Icon }) => (
-                    <button key={id} type="button" className="context-room-document-create-type" onClick={() => setCreateType(id)}>
-                      <Icon aria-hidden="true" />
-                      <span className="context-room-document-create-type-body">
-                        <b>{label}</b>
-                        <small>{hint}</small>
-                      </span>
-                    </button>
-                  ))}
-                </div>
-              ) : createType === 'doc' ? (
-                <form onSubmit={(event) => { event.preventDefault(); void createDocument(); }}>
-                  <label htmlFor="context-room-new-artifact-title">{t('contextRoom:resource.documentName')}</label>
-                  <input
-                    id="context-room-new-artifact-title"
-                    autoFocus
-                    maxLength={120}
-                    value={newDocumentTitle}
-                    placeholder={t('contextRoom:resource.untitledDocument')}
-                    onChange={(event) => setNewDocumentTitle(event.target.value)}
-                    disabled={creatingDocument}
-                  />
-                  <input
-                    ref={markdownInputRef}
-                    className="context-room-document-import-input"
-                    type="file"
-                    accept=".md,.markdown,text/markdown"
-                    tabIndex={-1}
-                    aria-hidden="true"
-                    onChange={(event) => {
-                      const file = event.currentTarget.files?.[0];
-                      event.currentTarget.value = '';
-                      if (file) void importMarkdownDocument(file);
-                    }}
-                  />
-                  <button
-                    type="button"
-                    className="context-room-document-import"
-                    disabled={creatingDocument}
-                    onClick={() => markdownInputRef.current?.click()}
-                  >
-                    <FileUp aria-hidden="true" />
-                    {t(creatingDocument ? 'contextRoom:resource.processing' : 'contextRoom:resource.importLocalMarkdown')}
-                  </button>
-                  {createError ? <small role="alert">{createError}</small> : null}
-                  <footer>
-                    <button type="button" disabled={creatingDocument} onClick={() => setCreateType(null)}>
-                      {t('contextRoom:resource.cancel')}
+          )}
+          <Popover.Root
+            open={createPopoverOpen}
+            onOpenChange={(nextOpen) => {
+              if (!nextOpen && creatingDocument) return;
+              setCreateError(null);
+              setCreatePopoverOpen(nextOpen);
+              if (!nextOpen) { setNewDocumentTitle(''); setCreateType(null); }
+            }}
+          >
+            <Popover.Trigger asChild>
+              <button
+                type="button"
+                className="context-room-artifact-new"
+                aria-label={t('contextRoom:artifactLibrary.newArtifact')}
+                disabled={creatingDocument}
+              >
+                {creatingDocument
+                  ? <LoaderCircle aria-hidden="true" className="is-spinning" />
+                  : <Plus aria-hidden="true" />}
+                {t('contextRoom:artifactLibrary.newArtifact')}
+              </button>
+            </Popover.Trigger>
+            <Popover.Portal>
+              <Popover.Content
+                className={`context-room-document-create-popover${createType === null ? ' is-chooser' : ''}`}
+                side="bottom"
+                align="end"
+                sideOffset={6}
+                collisionPadding={10}
+                aria-label={t('contextRoom:artifactLibrary.newArtifact')}
+              >
+                {createType === null ? (
+                  <div className="context-room-document-create-types">
+                    {CREATE_TYPES.map(({ id, label, hint, icon: Icon }) => (
+                      <button key={id} type="button" className="context-room-document-create-type" onClick={() => setCreateType(id)}>
+                        <Icon aria-hidden="true" />
+                        <span className="context-room-document-create-type-body">
+                          <b>{label}</b>
+                          <small>{hint}</small>
+                        </span>
+                      </button>
+                    ))}
+                  </div>
+                ) : createType === 'doc' ? (
+                  <form onSubmit={(event) => { event.preventDefault(); void createDocument(); }}>
+                    <label htmlFor="context-room-new-artifact-title">{t('contextRoom:resource.documentName')}</label>
+                    <input
+                      id="context-room-new-artifact-title"
+                      autoFocus
+                      maxLength={120}
+                      value={newDocumentTitle}
+                      placeholder={t('contextRoom:resource.untitledDocument')}
+                      onChange={(event) => setNewDocumentTitle(event.target.value)}
+                      disabled={creatingDocument}
+                    />
+                    <input
+                      ref={markdownInputRef}
+                      className="context-room-document-import-input"
+                      type="file"
+                      accept=".md,.markdown,text/markdown"
+                      tabIndex={-1}
+                      aria-hidden="true"
+                      onChange={(event) => {
+                        const file = event.currentTarget.files?.[0];
+                        event.currentTarget.value = '';
+                        if (file) void importMarkdownDocument(file);
+                      }}
+                    />
+                    <button
+                      type="button"
+                      className="context-room-document-import"
+                      disabled={creatingDocument}
+                      onClick={() => markdownInputRef.current?.click()}
+                    >
+                      <FileUp aria-hidden="true" />
+                      {t(creatingDocument ? 'contextRoom:resource.processing' : 'contextRoom:resource.importLocalMarkdown')}
                     </button>
-                    <button type="submit" className="is-primary" disabled={creatingDocument}>
-                      {t(creatingDocument ? 'contextRoom:resource.creating' : 'contextRoom:resource.create')}
+                    {createError ? <small role="alert">{createError}</small> : null}
+                    <footer>
+                      <button type="button" disabled={creatingDocument} onClick={() => setCreateType(null)}>
+                        {t('contextRoom:resource.cancel')}
+                      </button>
+                      <button type="submit" className="is-primary" disabled={creatingDocument}>
+                        {t(creatingDocument ? 'contextRoom:resource.creating' : 'contextRoom:resource.create')}
+                      </button>
+                    </footer>
+                  </form>
+                ) : (
+                  <form onSubmit={(event) => { event.preventDefault(); dispatchOfficeCreate(createType); }}>
+                    <label htmlFor="context-room-new-artifact-title">{t('contextRoom:resource.documentName')}</label>
+                    <input
+                      id="context-room-new-artifact-title"
+                      autoFocus
+                      maxLength={120}
+                      value={newDocumentTitle}
+                      placeholder={t('contextRoom:resource.untitledDocument')}
+                      onChange={(event) => setNewDocumentTitle(event.target.value)}
+                    />
+                    <input
+                      ref={officeImportInputRef}
+                      className="context-room-document-import-input"
+                      type="file"
+                      accept={ARTIFACT_IMPORT_EXTENSIONS.join(',')}
+                      multiple
+                      tabIndex={-1}
+                      aria-hidden="true"
+                      onChange={(event) => {
+                        const files = Array.from(event.currentTarget.files ?? []);
+                        event.currentTarget.value = '';
+                        if (files.length > 0) void importOfficeFiles(files);
+                      }}
+                    />
+                    <button
+                      type="button"
+                      className="context-room-document-import"
+                      disabled={creatingDocument}
+                      onClick={() => officeImportInputRef.current?.click()}
+                    >
+                      <FileUp aria-hidden="true" />
+                      {t(creatingDocument ? 'contextRoom:resource.processing' : 'contextRoom:artifactLibrary.importOffice')}
                     </button>
-                  </footer>
-                </form>
-              ) : (
-                <form onSubmit={(event) => { event.preventDefault(); dispatchOfficeCreate(createType); }}>
-                  <label htmlFor="context-room-new-artifact-title">{t('contextRoom:resource.documentName')}</label>
-                  <input
-                    id="context-room-new-artifact-title"
-                    autoFocus
-                    maxLength={120}
-                    value={newDocumentTitle}
-                    placeholder={t('contextRoom:resource.untitledDocument')}
-                    onChange={(event) => setNewDocumentTitle(event.target.value)}
-                  />
-                  <input
-                    ref={officeImportInputRef}
-                    className="context-room-document-import-input"
-                    type="file"
-                    accept={ARTIFACT_IMPORT_EXTENSIONS.join(',')}
-                    multiple
-                    tabIndex={-1}
-                    aria-hidden="true"
-                    onChange={(event) => {
-                      const files = Array.from(event.currentTarget.files ?? []);
-                      event.currentTarget.value = '';
-                      if (files.length > 0) void importOfficeFiles(files);
-                    }}
-                  />
-                  <button
-                    type="button"
-                    className="context-room-document-import"
-                    disabled={creatingDocument}
-                    onClick={() => officeImportInputRef.current?.click()}
-                  >
-                    <FileUp aria-hidden="true" />
-                    {t(creatingDocument ? 'contextRoom:resource.processing' : 'contextRoom:artifactLibrary.importOffice')}
-                  </button>
-                  {createError ? <small role="alert">{createError}</small> : null}
-                  <small className="context-room-document-create-hint">{t('contextRoom:artifactLibrary.officeCreateHint')}</small>
-                  <footer>
-                    <button type="button" onClick={() => setCreateType(null)}>{t('contextRoom:resource.cancel')}</button>
-                    <button type="submit" className="is-primary">{t('contextRoom:artifactLibrary.createOffice')}</button>
-                  </footer>
-                </form>
-              )}
-              <Popover.Arrow className="context-room-document-create-arrow" />
-            </Popover.Content>
-          </Popover.Portal>
-        </Popover.Root>
+                    {createError ? <small role="alert">{createError}</small> : null}
+                    <small className="context-room-document-create-hint">{t('contextRoom:artifactLibrary.officeCreateHint')}</small>
+                    <footer>
+                      <button type="button" onClick={() => setCreateType(null)}>{t('contextRoom:resource.cancel')}</button>
+                      <button type="submit" className="is-primary">{t('contextRoom:artifactLibrary.createOffice')}</button>
+                    </footer>
+                  </form>
+                )}
+                <Popover.Arrow className="context-room-document-create-arrow" />
+              </Popover.Content>
+            </Popover.Portal>
+          </Popover.Root>
+        </div>
       </div>
+      <MoveDocumentToRoomDialog
+        open={moveTargets.length > 0}
+        onOpenChange={(open) => {
+          if (!open) setMoveTargets([]);
+        }}
+        documents={moveTargets}
+        onMoved={() => exitSelection()}
+      />
+      <ReferenceDialog
+        open={pendingDelete !== null}
+        onOpenChange={(open) => {
+          if (!open && deletingArtifact) return;
+          if (!open) {
+            setPendingDelete(null);
+            setDeleteError(null);
+          }
+        }}
+        title={pendingDelete
+          ? pendingDelete.kind === 'file'
+            ? t('contextRoom:artifactLibrary.confirmDeleteFileName', { name: pendingDelete.name })
+            : t('contextRoom:resource.confirmMovingDocumentNameToTrash', { name: pendingDelete.name })
+          : ''}
+        contentClassName="context-room-artifact-delete-shell"
+      >
+        <div className="context-room-action-confirm">
+          <header>
+            <h2>{pendingDelete?.kind === 'file'
+              ? t('contextRoom:artifactLibrary.deleteFile')
+              : t('contextRoom:resource.moveToTrash')}</h2>
+          </header>
+          <div className="context-room-action-confirm-body">
+            <p>{pendingDelete?.kind === 'file'
+              ? t('contextRoom:artifactLibrary.confirmDeleteFile')
+              : t('contextRoom:resource.confirmMoveToTrash')}</p>
+            <p className="context-room-action-confirm-note">
+              {pendingDelete
+                ? pendingDelete.kind === 'file'
+                  ? t('contextRoom:artifactLibrary.deleteFileIrreversible')
+                  : t('contextRoom:resource.nameCanBeRestoredFromTrash', { name: pendingDelete.name })
+                : null}
+            </p>
+            {deleteError ? <p className="context-room-move-error" role="alert">{deleteError}</p> : null}
+          </div>
+          <footer>
+            <button
+              type="button"
+              className="context-room-ghost"
+              disabled={deletingArtifact}
+              onClick={() => {
+                setPendingDelete(null);
+                setDeleteError(null);
+              }}
+            >
+              {t('contextRoom:resource.cancel')}
+            </button>
+            <button
+              type="button"
+              className="context-room-danger-button"
+              disabled={deletingArtifact}
+              onClick={() => void confirmArtifactDelete()}
+            >
+              {t(deletingArtifact ? 'contextRoom:artifactLibrary.deleting' : 'contextRoom:artifactLibrary.delete')}
+            </button>
+          </footer>
+        </div>
+      </ReferenceDialog>
       <div className="context-room-artifact-list">
         {visibleArtifacts.map(({ key, resource }) => {
           const office = resource.kind === 'knowledge-file' ? resource : null;
@@ -414,12 +536,34 @@ export function ArtifactLibraryPane({
           const backendDocument = cloud ? backendDocuments.find((document) => document.id === cloud.binding.docId) ?? null : null;
           const citations = backendDocument ? citationCounts.get(backendDocument.id) ?? 0 : 0;
           return (
-            <div className="context-room-artifact-row" key={key}>
+            <div
+              className="context-room-artifact-row"
+              data-selecting={selectionMode && Boolean(backendDocument) || undefined}
+              key={key}
+            >
+              {selectionMode && backendDocument ? (
+                <button
+                  type="button"
+                  role="checkbox"
+                  className="context-room-artifact-check"
+                  aria-checked={selectedDocumentIds.has(backendDocument.id)}
+                  aria-label={t('contextRoom:artifactLibrary.selectDocument', { name: resource.name })}
+                  onClick={() => toggleDocumentSelection(backendDocument.id)}
+                >
+                  {selectedDocumentIds.has(backendDocument.id) ? <Check aria-hidden="true" /> : null}
+                </button>
+              ) : null}
               <button
                 type="button"
                 className="context-room-artifact-item"
                 aria-selected={selectedId === resource.id}
-                onClick={() => onSelect(resource)}
+                onClick={() => {
+                  if (selectionMode && backendDocument) {
+                    toggleDocumentSelection(backendDocument.id);
+                    return;
+                  }
+                  onSelect(resource);
+                }}
               >
                 <span className="context-room-artifact-ico"><FileText aria-hidden="true" /></span>
                 <span className="context-room-artifact-body">
@@ -442,87 +586,71 @@ export function ArtifactLibraryPane({
               </button>
               {office || backendDocument ? (
                 <span className="context-room-artifact-acts">
-                  {office ? (
-                    <button
-                      type="button"
-                      className="context-room-artifact-reveal"
-                      aria-label={t('contextRoom:artifactLibrary.revealInFolder')}
-                      title={t('contextRoom:artifactLibrary.revealInFolder')}
-                      onClick={async () => {
-                        try {
-                          await window.nxcore?.files?.exportReveal(office.fileId, office.originalName)
-                        } catch (error) {
-                          showToast({
-                            title: t('contextRoom:artifactLibrary.revealFailed'),
-                            message: error instanceof Error ? error.message : String(error),
-                            variant: 'error',
-                          })
-                        }
-                      }}
-                    >
-                      <FolderOpen aria-hidden="true" />
-                    </button>
-                  ) : null}
-                  <Popover.Root
-                    open={pendingDelete?.key === key}
-                    onOpenChange={(open) => {
-                      if (!open && deletingArtifact && pendingDelete?.key === key) return;
-                      setDeleteError(null);
-                      setPendingDelete(open
-                        ? office
-                          ? { key, kind: 'file', fileId: office.fileId, name: resource.name }
-                          : backendDocument
-                            ? { key, kind: 'document', document: backendDocument, name: resource.name }
-                            : null
-                        : null);
-                    }}
-                  >
-                    <Popover.Trigger asChild>
+                  <DropdownMenu.Root>
+                    <DropdownMenu.Trigger asChild>
                       <button
                         type="button"
-                        className="context-room-resource-delete"
-                        aria-label={office
-                          ? t('contextRoom:artifactLibrary.confirmDeleteFileName', { name: resource.name })
-                          : t('contextRoom:resource.confirmMovingDocumentNameToTrash', { name: resource.name })}
-                        title={office ? t('contextRoom:artifactLibrary.deleteFile') : t('contextRoom:resource.moveToTrash')}
-                        disabled={deletingArtifact && pendingDelete?.key === key}
+                        className="context-room-resource-more"
+                        aria-label={t('contextRoom:artifactLibrary.moreActions')}
+                        title={t('contextRoom:artifactLibrary.moreActions')}
                       >
-                        <Trash2 aria-hidden="true" />
+                        <Ellipsis aria-hidden="true" />
                       </button>
-                    </Popover.Trigger>
-                    <Popover.Portal>
-                      <Popover.Content
-                        className="context-room-document-delete-popover"
-                        side="left"
-                        align="center"
-                        sideOffset={8}
-                        collisionPadding={12}
-                        aria-label={office
-                          ? t('contextRoom:artifactLibrary.confirmDeleteFileName', { name: resource.name })
-                          : t('contextRoom:resource.confirmMovingDocumentNameToTrash', { name: resource.name })}
+                    </DropdownMenu.Trigger>
+                    <DropdownMenu.Portal>
+                      <DropdownMenu.Content
+                        className="context-room-card-menu context-room-artifact-menu"
+                        align="end"
+                        sideOffset={6}
                       >
-                        <p>{office ? t('contextRoom:artifactLibrary.confirmDeleteFile') : t('contextRoom:resource.confirmMoveToTrash')}</p>
-                        <span>{office
-                          ? t('contextRoom:artifactLibrary.deleteFileIrreversible')
-                          : t('contextRoom:resource.nameCanBeRestoredFromTrash', { name: resource.name })}</span>
-                        {deleteError ? <small role="alert">{deleteError}</small> : null}
-                        <footer>
-                          <Popover.Close asChild>
-                            <button type="button">{t('contextRoom:resource.cancel')}</button>
-                          </Popover.Close>
-                          <button
-                            type="button"
-                            className="is-danger"
-                            disabled={deletingArtifact}
-                            onClick={() => void confirmArtifactDelete()}
+                        {backendDocument ? (
+                          <DropdownMenu.Item
+                            onSelect={() => setMoveTargets([{
+                              id: backendDocument.id,
+                              title: backendDocument.title || resource.name,
+                              roomId: backendDocument.roomId,
+                            }])}
+                          >
+                            <FolderInput aria-hidden="true" />
+                            {t('contextRoom:artifactLibrary.moveToAnotherRoom')}
+                          </DropdownMenu.Item>
+                        ) : null}
+                        {office ? (
+                          <DropdownMenu.Item
+                            onSelect={() => {
+                              void window.nxcore?.files?.exportReveal(office.fileId, office.originalName).catch((error: unknown) => {
+                                showToast({
+                                  title: t('contextRoom:artifactLibrary.revealFailed'),
+                                  message: error instanceof Error ? error.message : String(error),
+                                  variant: 'error',
+                                });
+                              });
+                            }}
                           >
-                            {t(deletingArtifact ? 'contextRoom:artifactLibrary.deleting' : 'contextRoom:artifactLibrary.delete')}
-                          </button>
-                        </footer>
-                        <Popover.Arrow className="context-room-document-delete-arrow" />
-                      </Popover.Content>
-                    </Popover.Portal>
-                  </Popover.Root>
+                            <FolderOpen aria-hidden="true" />
+                            {t('contextRoom:artifactLibrary.revealInFolder')}
+                          </DropdownMenu.Item>
+                        ) : null}
+                        <DropdownMenu.Separator className="context-room-document-actions-separator" />
+                        <DropdownMenu.Item
+                          className="danger"
+                          onSelect={() => {
+                            setDeleteError(null);
+                            setPendingDelete(office
+                              ? { key, kind: 'file', fileId: office.fileId, name: resource.name }
+                              : backendDocument
+                                ? { key, kind: 'document', document: backendDocument, name: resource.name }
+                                : null);
+                          }}
+                        >
+                          <Trash2 aria-hidden="true" />
+                          {office
+                            ? t('contextRoom:artifactLibrary.deleteFile')
+                            : t('contextRoom:resource.moveToTrash')}
+                        </DropdownMenu.Item>
+                      </DropdownMenu.Content>
+                    </DropdownMenu.Portal>
+                  </DropdownMenu.Root>
                 </span>
               ) : null}
             </div>
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 e43e1c39..ce9e66ff 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,4 +1,4 @@
-import { Link2, Maximize2, Network } from 'lucide-react'
+import { Link2, Network } from 'lucide-react'
 import { useEffect, useMemo, useRef, useState } from 'react'
 import { useLocale } from '../../../../../i18n/LocaleContext'
 import type { RoomDocument } from '@nxcore/agent-contract'
@@ -10,6 +10,7 @@ import { useRoomRelationGraph } from '../../hooks/useRoomRelationGraph'
 import { RoomGraphCanvas, type RoomGraphCanvasHandle } from '../RoomGraphCanvas'
 import { RoomNodeInspector } from '../RoomGraphInspector'
 import { CreateRoomRelationDialog, relationTypeLabel, RoomRelationInspector } from '../RoomRelationControls'
+import { GraphFitButton } from '../GraphFitButton'
 import { PanelEmptyState } from './PanelEmptyState'
 
 export function RelationsPane({
@@ -72,22 +73,26 @@ export function RelationsPane({
               {t(visibility === 'hidden' ? 'contextRoom:relations.showActive' : 'contextRoom:relations.showHidden')}
             </button>
             <button type="button" aria-label={t('contextRoom:relations.newRelation')} title={t('contextRoom:relations.newRelation')} onClick={() => setCreateRelationOpen(true)}><Link2 aria-hidden="true" /></button>
-            <button type="button" aria-label={t('contextRoom:relations.fitRelatedRoomGraph')} title={t('contextRoom:relations.fitToCanvas')} onClick={() => void graphRef.current?.fitView()}><Maximize2 aria-hidden="true" /></button>
           </div>
         </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}
-            />
+            <>
+              <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()} />
+            </>
           ) : (
             <PanelEmptyState
               icon={Network}
diff --git a/apps/desktop/src/renderer/src/components/context-room/ported/hooks/useRoomDocuments.ts b/apps/desktop/src/renderer/src/components/context-room/ported/hooks/useRoomDocuments.ts
index 2666516e..91c6a9e3 100644
--- a/apps/desktop/src/renderer/src/components/context-room/ported/hooks/useRoomDocuments.ts
+++ b/apps/desktop/src/renderer/src/components/context-room/ported/hooks/useRoomDocuments.ts
@@ -1,4 +1,4 @@
-import type { DocumentEvent, RoomDocument, TiptapJsonContent } from '@nxcore/agent-contract'
+import type { DocumentEvent, DocumentMovedPayload, RoomDocument, TiptapJsonContent } from '@nxcore/agent-contract'
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import i18n from '@/i18n/i18next'
 
@@ -36,6 +36,7 @@ const DOCUMENT_STATE_EVENT_TYPES = new Set<DocumentEvent['type']>([
   'document.changed',
   'document.operation.changed',
   'document.deleted',
+  'document.moved',
 ])
 
 export function useRoomDocuments(roomIds: string[]) {
@@ -105,6 +106,30 @@ export function useRoomDocuments(roomIds: string[]) {
     const unsubscribeEvents = documents.onEvent(({ event }) => {
       if (!DOCUMENT_STATE_EVENT_TYPES.has(event.type)) return
 
+      // 跨 Room 移动：事件发往源房，先摘除再拉一次目标房基线（目标房另有
+      // document.changed 增量，重复合并按 id 去重，幂等）。
+      if (event.type === 'document.moved') {
+        const payload = event.payload && typeof event.payload === 'object'
+          ? event.payload as Partial<DocumentMovedPayload>
+          : null
+        setDocumentsByRoom((current) => ({
+          ...current,
+          [event.roomId]: (current[event.roomId] ?? []).filter((candidate) => candidate.id !== event.documentId),
+        }))
+        setTrashedDocumentsByRoom((current) => ({
+          ...current,
+          [event.roomId]: (current[event.roomId] ?? []).filter((candidate) => candidate.id !== event.documentId),
+        }))
+        setFocusedDocumentByRoom((current) => current[event.roomId] === event.documentId
+          ? { ...current, [event.roomId]: null }
+          : current)
+        invalidateDocumentBlockReferences({ roomId: event.roomId, documentId: event.documentId })
+        if (typeof payload?.toRoomId === 'string' && payload.toRoomId) {
+          void refreshRoom(payload.toRoomId).catch(() => undefined)
+        }
+        return
+      }
+
       const document = documentFromEvent(event)
       if (document) {
         upsertDocument(document)
diff --git a/apps/desktop/src/renderer/src/components/pages/AgentConnectionsPage.css b/apps/desktop/src/renderer/src/components/pages/AgentConnectionsPage.css
index 993e60b4..42465dc3 100644
--- a/apps/desktop/src/renderer/src/components/pages/AgentConnectionsPage.css
+++ b/apps/desktop/src/renderer/src/components/pages/AgentConnectionsPage.css
@@ -1,104 +1,197 @@
 /* Agent 连接页：布局与页面特有样式。控件基底复用全局类
- * （.page/.page-header/.primary-button/.secondary-button/.icon-button），
- * 表单控件配方与 AgentSchedulesPage / source-connect-form 对齐。 */
+ * （.page / .page-header / .primary-button / .secondary-button / .icon-button），
+ * 本页把它们统一抬到 40px 高、10px 圆角，图标与文字垂直居中；
+ * 面板用大圆角 + 柔和分层阴影，间距留白拉开 —— 现代、干净、有呼吸感。 */
 
 .agent-connections-page {
+  /* 全页公共度量：改这两个值即可整体收放控件与面板 */
+  --ac-control-height: 40px;
+  --ac-control-radius: 10px;
+  --ac-panel-radius: 16px;
+  --ac-shadow-card: 0 1px 2px rgba(21, 26, 34, 0.04), 0 10px 26px -20px rgba(21, 26, 34, 0.2);
+  --ac-shadow-float: 0 2px 8px rgba(21, 26, 34, 0.05), 0 32px 64px -36px rgba(21, 26, 34, 0.32);
   display: flex;
   flex-direction: column;
-  gap: 14px;
-  max-width: 980px;
+  gap: 20px;
+  max-width: 1000px;
+}
+
+/* 页头与正文用统一节奏：间距全部交给 .agent-connections-page 的 gap */
+.agent-connections-page .page-header {
+  margin-bottom: 0;
+}
+
+.agent-connections-page .page-header-actions {
+  align-items: center;
+}
+
+/* ── 控件基底：本页所有按钮/输入都 40px 高、10px 圆角、内容垂直居中 ── */
+
+.agent-connections-page :is(.primary-button, .secondary-button) {
+  min-height: var(--ac-control-height);
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  padding: 0 14px;
+  border-radius: var(--ac-control-radius);
+  font-size: 12.5px;
+  line-height: 1;
+  white-space: nowrap;
+  transition: background-color 0.16s ease, border-color 0.16s ease, box-shadow 0.16s ease;
+}
+
+.agent-connections-page :is(.primary-button, .secondary-button) svg {
+  width: 15px;
+  height: 15px;
+  flex: 0 0 auto;
+}
+
+.agent-connections-page .secondary-button:hover {
+  border-color: var(--border-strong);
+  background: var(--surface-alt);
+}
+
+.agent-connections-page .icon-button {
+  width: var(--ac-control-height);
+  height: var(--ac-control-height);
+  flex: 0 0 var(--ac-control-height);
+  border: 1px solid var(--border);
+  border-radius: var(--ac-control-radius);
+  background: var(--surface);
+}
+
+.agent-connections-page .icon-button:hover {
+  border-color: var(--border-strong);
+  background: var(--surface-alt);
 }
 
 .agent-connections-subtitle {
   display: flex;
   align-items: center;
-  gap: 7px;
-  margin: -6px 0 4px;
+  gap: 8px;
+  margin: -6px 0 0;
   color: var(--muted);
   font-size: 12px;
+  line-height: 1.5;
 }
 
 .agent-connections-subtitle svg {
   width: 14px;
   height: 14px;
+  flex: 0 0 auto;
 }
 
 .agent-connections-error {
-  border: 1px solid color-mix(in srgb, #b5493a 35%, var(--border));
-  border-radius: 6px;
-  padding: 11px 14px;
+  border: 1px solid color-mix(in srgb, #b5493a 32%, var(--border));
+  border-radius: var(--ac-control-radius);
+  background: color-mix(in srgb, #b5493a 6%, var(--surface));
+  padding: 12px 16px;
   font-size: 12px;
+  line-height: 1.5;
   color: #b5493a;
 }
 
-/* 固定端口设置卡 */
+/* ── 固定端口设置卡 ── */
+
 .agent-connections-port {
   display: flex;
+  align-items: center;
   justify-content: space-between;
-  gap: 16px;
+  gap: 24px;
   border: 1px solid var(--border);
-  border-radius: 8px;
+  border-radius: var(--ac-panel-radius);
   background: var(--surface);
-  padding: 14px 18px;
+  box-shadow: var(--ac-shadow-card);
+  padding: 20px 22px;
 }
 
 .agent-connections-port-copy h2 {
   display: flex;
   align-items: center;
-  gap: 6px;
+  gap: 8px;
   font-size: 14px;
-  margin: 0 0 4px;
+  margin: 0 0 6px;
 }
 
 .agent-connections-port-copy h2 svg {
   width: 15px;
   height: 15px;
+  flex: 0 0 auto;
 }
 
 .agent-connections-port-copy p {
-  margin: 0 0 4px;
+  margin: 0 0 8px;
   color: var(--muted);
-  font-size: 11px;
+  font-size: 11.5px;
+  line-height: 1.6;
   max-width: 560px;
 }
 
 .agent-connections-port-copy small {
   color: var(--subtle);
-  font-size: 10px;
+  font-size: 10.5px;
+  line-height: 1.5;
 }
 
 .agent-connections-port-controls {
   display: flex;
   align-items: center;
-  gap: 8px;
+  gap: 10px;
   flex-wrap: wrap;
   justify-content: flex-end;
-  max-width: 360px;
+  max-width: 380px;
 }
 
 .agent-connections-port-controls input {
-  width: 96px;
+  width: 110px;
+  box-sizing: border-box;
+  height: var(--ac-control-height);
+  /* 等高 + 零纵向 padding：占位符与输入值都严格垂直居中 */
+  padding: 0 12px;
+  border: 1px solid var(--border);
+  border-radius: var(--ac-control-radius);
+  background: var(--surface);
+  color: var(--text);
+  font: inherit;
+  font-size: 12.5px;
+  line-height: calc(var(--ac-control-height) - 2px);
+  transition: border-color 0.16s ease, box-shadow 0.16s ease;
+}
+
+.agent-connections-port-controls input::placeholder {
+  color: var(--subtle);
+}
+
+.agent-connections-port-controls input:focus {
+  outline: none;
+  border-color: var(--accent);
+  box-shadow: 0 0 0 3px var(--accent-soft);
 }
 
 .agent-connections-port-message {
   flex-basis: 100%;
   text-align: right;
   color: var(--muted);
-  font-size: 10px;
+  font-size: 10.5px;
+  line-height: 1.5;
 }
 
-/* 新建表单（配方同 schedule-form） */
+/* ── 新建连接表单：当作一颗浮起的面板（大圆角 + 柔和阴影） ── */
+
 .agent-connections-form {
-  border: 1px solid var(--border-strong);
+  border: 1px solid var(--border);
+  border-radius: 20px;
   background: var(--surface);
-  padding: 18px;
+  box-shadow: var(--ac-shadow-float);
+  padding: 24px;
 }
 
 .agent-connections-form-header {
   display: flex;
   justify-content: space-between;
   align-items: center;
-  margin-bottom: 16px;
+  gap: 12px;
+  margin-bottom: 20px;
 }
 
 .agent-connections-form-header h2 {
@@ -109,29 +202,33 @@
 .agent-connections-form-grid {
   display: grid;
   grid-template-columns: repeat(2, minmax(0, 1fr));
-  gap: 12px;
+  gap: 16px;
 }
 
 .agent-connections-form-grid label {
   display: grid;
-  gap: 6px;
+  gap: 8px;
   color: var(--muted);
-  font-size: 11px;
+  font-size: 11.5px;
+  line-height: 1.4;
 }
 
 .agent-connections-form-grid fieldset {
   display: grid;
-  gap: 6px;
+  gap: 8px;
   margin: 0;
   border: 1px solid var(--border);
-  border-radius: 6px;
-  padding: 10px;
-  font-size: 11px;
+  border-radius: 14px;
+  background: var(--surface-alt);
+  padding: 14px;
+  font-size: 11.5px;
   color: var(--muted);
 }
 
 .agent-connections-form-grid legend {
-  padding: 0 4px;
+  padding: 0 6px;
+  color: var(--muted);
+  font-size: 11px;
 }
 
 .agent-connections-form-grid input:not([type='checkbox']):not([type='radio']),
@@ -139,17 +236,48 @@
 .agent-connections-form-grid textarea {
   width: 100%;
   box-sizing: border-box;
-  padding: 8px 9px;
   border: 1px solid var(--border);
-  border-radius: 6px;
-  background: var(--background);
+  border-radius: var(--ac-control-radius);
+  background: var(--surface);
   color: var(--text);
   font: inherit;
-  font-size: 12px;
+  font-size: 12.5px;
+  transition: border-color 0.16s ease, box-shadow 0.16s ease;
+}
+
+.agent-connections-form-grid input:not([type='checkbox']):not([type='radio']),
+.agent-connections-form-grid select {
+  height: var(--ac-control-height);
+  /* 等高 + 零纵向 padding：文字与占位符都严格垂直居中 */
+  padding: 0 12px;
+  line-height: calc(var(--ac-control-height) - 2px);
+}
+
+.agent-connections-form-grid textarea {
+  min-height: 96px;
+  padding: 10px 12px;
+  line-height: 1.6;
+  resize: vertical;
+}
+
+.agent-connections-form-grid input::placeholder,
+.agent-connections-form-grid textarea::placeholder {
+  color: var(--subtle);
+}
+
+.agent-connections-form-grid input:not([type='checkbox']):not([type='radio']):focus,
+.agent-connections-form-grid select:focus,
+.agent-connections-form-grid textarea:focus {
+  outline: none;
+  border-color: var(--accent);
+  box-shadow: 0 0 0 3px var(--accent-soft);
 }
 
 .agent-connections-form-grid input[type='checkbox'],
 .agent-connections-form-grid input[type='radio'] {
+  width: 15px;
+  height: 15px;
+  flex: 0 0 15px;
   accent-color: var(--accent);
   margin: 0;
 }
@@ -161,20 +289,31 @@
 .agent-connections-check {
   display: flex;
   align-items: center;
-  gap: 6px;
-  font-size: 12px;
+  gap: 8px;
+  min-height: 34px;
+  padding: 0 10px;
+  border-radius: 9px;
   color: var(--text);
+  font-size: 12px;
+  line-height: 1.4;
+  cursor: pointer;
+  transition: background-color 0.14s ease;
+}
+
+.agent-connections-check:hover {
+  background: color-mix(in srgb, var(--hover) 70%, transparent);
 }
 
 .agent-connections-room-picker {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
   gap: 4px;
-  max-height: 148px;
+  max-height: 168px;
   overflow-y: auto;
   border: 1px solid var(--border);
-  border-radius: 6px;
-  padding: 6px 8px;
+  border-radius: 12px;
+  background: var(--surface);
+  padding: 8px;
 }
 
 .agent-connections-capabilities {
@@ -186,23 +325,35 @@
 .agent-connections-form-actions {
   display: flex;
   justify-content: flex-end;
-  gap: 8px;
-  margin-top: 16px;
+  align-items: center;
+  gap: 10px;
+  margin-top: 22px;
+  padding-top: 18px;
+  border-top: 1px solid var(--border);
 }
 
-/* 连接卡片（版式同 schedule-card） */
+/* ── 连接卡片 ── */
+
 .agent-connections-list {
   display: grid;
-  gap: 10px;
+  gap: 14px;
 }
 
 .agent-connections-card {
   display: flex;
   flex-direction: column;
-  gap: 8px;
+  gap: 14px;
   border: 1px solid var(--border);
+  border-radius: var(--ac-panel-radius);
   background: var(--surface);
-  padding: 16px 18px;
+  box-shadow: var(--ac-shadow-card);
+  padding: 20px 22px;
+  transition: border-color 0.18s ease, box-shadow 0.18s ease;
+}
+
+.agent-connections-card:hover {
+  border-color: var(--border-strong);
+  box-shadow: 0 2px 4px rgba(21, 26, 34, 0.04), 0 16px 36px -24px rgba(21, 26, 34, 0.26);
 }
 
 .agent-connections-card[data-status='revoked'] {
@@ -212,54 +363,65 @@
 .agent-connections-card-copy {
   display: flex;
   justify-content: space-between;
-  gap: 12px;
+  gap: 16px;
 }
 
 .agent-connections-card-title {
   display: flex;
   align-items: center;
-  gap: 8px;
+  gap: 10px;
+  flex-wrap: wrap;
 }
 
 .agent-connections-card-title h2 {
-  font-size: 14px;
+  font-size: 14.5px;
   margin: 0;
 }
 
 .agent-connections-card-copy p {
-  margin: 7px 0 5px;
+  margin: 9px 0 7px;
   color: var(--muted);
-  font-size: 11px;
+  font-size: 11.5px;
+  line-height: 1.6;
 }
 
 .agent-connections-card-copy small {
   color: var(--subtle);
-  font-size: 10px;
+  font-size: 10.5px;
+  line-height: 1.5;
 }
 
 .agent-connections-card-copy code {
-  padding: 2px 6px;
+  padding: 3px 8px;
   border: 1px solid var(--border);
+  border-radius: 6px;
+  background: var(--surface-alt);
   color: var(--muted);
-  font: 10px ui-monospace, monospace;
+  font: 10.5px ui-monospace, monospace;
 }
 
-/* 徽标/状态（配方同 schedule-badge） */
+/* 徽标 / 状态胶囊 */
 .agent-connections-badge {
-  padding: 2px 6px;
+  padding: 3px 9px;
   border: 1px solid var(--border);
+  border-radius: 999px;
+  background: var(--surface-alt);
   color: var(--muted);
-  font-size: 10px;
+  font-size: 10.5px;
+  line-height: 1.5;
 }
 
 .agent-connections-status {
-  padding: 2px 6px;
+  padding: 3px 9px;
   border: 1px solid var(--border);
-  font-size: 10px;
+  border-radius: 999px;
+  font-size: 10.5px;
+  line-height: 1.5;
 }
 
 .agent-connections-status.status-active {
-  border-color: color-mix(in srgb, var(--accent) 45%, var(--border));
+  border-color: color-mix(in srgb, var(--accent) 38%, var(--border));
+  background: color-mix(in srgb, var(--accent) 8%, var(--surface));
   color: var(--accent);
 }
 
@@ -274,67 +436,87 @@
 .agent-connections-card-actions {
   display: flex;
   align-items: center;
-  gap: 6px;
+  gap: 8px;
   justify-content: flex-end;
   flex-wrap: wrap;
+  padding-top: 2px;
 }
 
-/* 动作按钮：复用 .secondary-button 基底，仅做紧凑修饰 */
+/* 卡片内动作按钮：与页面级按钮同高（40px），只把字号与内边距收一档 */
 .agent-connections-action {
-  min-height: 28px;
-  padding: 4px 10px;
-  gap: 5px;
-  font-size: 11px;
+  min-height: var(--ac-control-height);
+  padding: 0 13px;
+  gap: 7px;
+  font-size: 11.5px;
+  line-height: 1;
 }
 
 .agent-connections-action svg {
-  width: 13px;
-  height: 13px;
+  width: 14px;
+  height: 14px;
+  flex: 0 0 auto;
 }
 
 .agent-connections-action.danger {
   color: #b5493a;
 }
 
-/* token 一次性展示 */
+.agent-connections-action.danger:hover {
+  border-color: color-mix(in srgb, #b5493a 40%, var(--border));
+  background: color-mix(in srgb, #b5493a 6%, var(--surface));
+}
+
+/* ── token 一次性展示 ── */
+
 .agent-connections-token {
   display: flex;
   flex-direction: column;
-  gap: 4px;
-  border: 1px solid var(--border-strong);
-  border-radius: 6px;
-  padding: 8px 10px;
-  background: var(--background);
+  gap: 8px;
+  border: 1px solid color-mix(in srgb, var(--accent) 26%, var(--border));
+  border-radius: 14px;
+  padding: 16px 18px;
+  background: color-mix(in srgb, var(--accent) 4%, var(--surface));
+  box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.6);
 }
 
 .agent-connections-token strong {
-  font-size: 12px;
+  font-size: 12.5px;
 }
 
 .agent-connections-token small {
   color: var(--muted);
-  font-size: 10px;
+  font-size: 10.5px;
+  line-height: 1.5;
 }
 
 .agent-connections-token-row {
   display: flex;
   align-items: center;
-  gap: 8px;
+  gap: 10px;
+  margin-top: 2px;
 }
 
 .agent-connections-token-row code {
   flex: 1;
   word-break: break-all;
-  font-size: 11px;
+  padding: 10px 12px;
+  border: 1px solid var(--border);
+  border-radius: var(--ac-control-radius);
+  background: var(--surface);
+  font: 11.5px ui-monospace, monospace;
+  line-height: 1.5;
 }
 
-/* 结果面板（自检/示例/安装/调试） */
+/* ── 结果面板（自检 / 示例 / 安装 / 调试） ── */
+
 .agent-connections-panel {
   display: flex;
   flex-direction: column;
-  gap: 6px;
-  border-top: 1px dashed var(--border);
-  padding-top: 8px;
+  gap: 10px;
+  border: 1px solid var(--border);
+  border-radius: 14px;
+  background: var(--surface-alt);
+  padding: 16px 18px;
 }
 
 .agent-connections-panel h3 {
@@ -343,6 +525,16 @@
   color: var(--muted);
 }
 
+.agent-connections-panel > div {
+  display: grid;
+  gap: 6px;
+}
+
+.agent-connections-panel > strong {
+  font-size: 11.5px;
+  color: var(--muted);
+}
+
 .agent-connections-steps,
 .agent-connections-hits,
 .agent-connections-files,
@@ -352,14 +544,15 @@
   list-style: none;
   display: flex;
   flex-direction: column;
-  gap: 4px;
+  gap: 6px;
   font-size: 12px;
+  line-height: 1.5;
 }
 
 .agent-connections-steps li {
   display: flex;
   align-items: baseline;
-  gap: 8px;
+  gap: 10px;
 }
 
 .agent-connections-steps li[data-tone='ok'] code { color: #1c7d4d; }
@@ -369,13 +562,16 @@
 .agent-connections-hits li {
   display: flex;
   align-items: baseline;
-  gap: 8px;
+  gap: 10px;
   flex-wrap: wrap;
+  padding: 2px 0;
 }
 
 .agent-connections-hit-kind {
-  padding: 0 5px;
+  padding: 1px 7px;
   border: 1px solid var(--border);
+  border-radius: 999px;
+  background: var(--surface);
   font-size: 10px;
   color: var(--muted);
 }
@@ -388,35 +584,76 @@
 
 .agent-connections-panel pre {
   margin: 0;
-  padding: 8px 10px;
+  padding: 12px 14px;
   border: 1px solid var(--border);
-  border-radius: 6px;
-  background: var(--background);
+  border-radius: 12px;
+  background: var(--surface);
   overflow-x: auto;
-  font-size: 11px;
+  font-size: 11.5px;
+  line-height: 1.6;
 }
 
 .agent-connections-notes {
   color: var(--subtle);
-  font-size: 10px;
+  font-size: 10.5px;
 }
 
+.agent-connections-panel > .secondary-button {
+  align-self: flex-end;
+}
+
+/* ── 空状态 ── */
+
 .agent-connections-empty {
   display: flex;
   flex-direction: column;
   align-items: center;
   justify-content: center;
-  gap: 6px;
-  min-height: 150px;
+  gap: 10px;
+  min-height: 180px;
+  border: 1px dashed var(--border-strong);
+  border-radius: var(--ac-panel-radius);
+  background: color-mix(in srgb, var(--surface-alt) 70%, transparent);
   color: var(--muted);
   font-size: 12px;
-  border: 1px dashed var(--border);
+  line-height: 1.6;
+  text-align: center;
+  padding: 24px;
+}
+
+.agent-connections-empty p {
+  margin: 0;
+}
+
+.agent-connections-empty small {
+  color: var(--subtle);
+  font-size: 11px;
+  max-width: 420px;
 }
 
 @media (max-width: 760px) {
+  .agent-connections-page {
+    gap: 16px;
+  }
+
   .agent-connections-port,
   .agent-connections-card-copy {
     flex-direction: column;
+    align-items: stretch;
+  }
+
+  .agent-connections-port {
+    gap: 16px;
+  }
+
+  .agent-connections-port-controls {
+    justify-content: flex-start;
+    max-width: none;
+  }
+
+  .agent-connections-form {
+    border-radius: 16px;
+    padding: 18px;
   }
 
   .agent-connections-form-grid {
@@ -426,4 +663,8 @@
   .agent-connections-form-wide {
     grid-column: auto;
   }
+
+  .agent-connections-card-actions {
+    justify-content: flex-start;
+  }
 }
diff --git a/apps/desktop/src/renderer/src/components/pages/AgentStatusPage.tsx b/apps/desktop/src/renderer/src/components/pages/AgentStatusPage.tsx
index 8560cad0..6815df01 100644
--- a/apps/desktop/src/renderer/src/components/pages/AgentStatusPage.tsx
+++ b/apps/desktop/src/renderer/src/components/pages/AgentStatusPage.tsx
@@ -141,6 +141,20 @@ function orbPoint(t: number) {
   return { x: 50 + t * 1340, y: 210 - Math.sin(t * Math.PI) * 160 }
 }
 
+const FAILED_RUN_STATUSES = new Set<AgentWorkspaceRunStatus>(['failed', 'interrupted', 'timed_out'])
+
+/**
+ * 「最近活动」的圆点跟着那一次运行的结果走。
+ * 办公室的实时状态一次运行结束就回海（恢复初始状态），失败的痕迹只留在这条记录里，
+ * 所以这里不能再读 agent.state（那会把刚失败的记录显示成绿灯）。
+ */
+function runMarkState(agent: AgentWorkspaceStatus): AgentWorkspaceState {
+  const status = agent.lastRun?.status
+  if (!status) return 'idle'
+  if (FAILED_RUN_STATUSES.has(status)) return 'error'
+  return status === 'accepted' || status === 'running' ? 'running' : 'idle'
+}
+
 function StateMark({ state }: { state: AgentWorkspaceState }) {
   if (state === 'running') return <LoaderCircle aria-hidden="true" />
   if (state === 'error') return <CircleAlert aria-hidden="true" />
@@ -170,7 +184,7 @@ function CoastRider({
 }) {
   const { x: slotX, depth, scale, mode } = slot
   const color = SPRITE_COLORS[seed % SPRITE_COLORS.length]!
-  const buttonRef = useRef<HTMLButtonElement>(null!)
+  const buttonRef = useRef<HTMLButtonElement | null>(null)
   const rideX = useRef(slotX)
   const transiting = useRef(false)
   const lastTime = useRef<number | null>(null)
@@ -186,6 +200,8 @@ function CoastRider({
       rideX.current += (target - rideX.current) * Math.min(1, k * dt)
 
       const button = buttonRef.current
+      // 卸载后仍可能收到最后一帧（rAF 与 React 提交交错）：引用已置空，跳过这一帧。
+      if (!button) return
       const parent = button.parentElement
       if (parent) {
         const dx = ((rideX.current - slotX) / 100) * parent.clientWidth
@@ -547,7 +563,7 @@ export function AgentStatusPage() {
         <div>
           {recentRuns.map((agent) => (
             <button type="button" key={agent.agentId} onClick={() => setSelectedAgentId(agent.agentId)}>
-              <i data-state={agent.state}><StateMark state={agent.state} /></i>
+              <i data-state={runMarkState(agent)}><StateMark state={runMarkState(agent)} /></i>
               <span><strong>{agent.lastRun?.task}</strong><small>{agent.name} · {agent.workspace.id}</small></span>
               <em>{agent.lastRun ? runStatusLabel(agent.lastRun.status, t) : ''}</em>
               <time><Clock3 aria-hidden="true" />{elapsedLabel(agent.updatedAt, t)}</time>
diff --git a/apps/desktop/src/renderer/src/components/pages/SettingsPage.css b/apps/desktop/src/renderer/src/components/pages/SettingsPage.css
index 85450da8..725a4df4 100644
--- a/apps/desktop/src/renderer/src/components/pages/SettingsPage.css
+++ b/apps/desktop/src/renderer/src/components/pages/SettingsPage.css
@@ -1683,3 +1683,293 @@
   .screen-permission-card { flex-direction: column; align-items: stretch; }
   .screen-permission-card > button { width: 100%; }
 }
+
+/* —— 控制件规范：与「+新建文档」弹窗（.room-picker-*）保持一致 ——
+   参考值：40px 控件高度、10px 控件圆角、24px 级内边距、柔和阴影、浅蓝强调。
+   全部规则限定在 .settings-page 内，避免波及应用其它页面。 */
+.settings-page {
+  --settings-control-height: 40px;
+  --settings-control-radius: 10px;
+  --settings-card-radius: 16px;
+  --settings-soft-shadow: 0 1px 2px rgba(21, 26, 34, 0.05), 0 12px 32px rgba(21, 26, 34, 0.05);
+}
+
+/* 主/次按钮：统一 40px 高、10px 圆角、13px 字，图标与文字垂直居中。 */
+.settings-page .primary-button,
+.settings-page .secondary-button {
+  min-height: var(--settings-control-height);
+  gap: 8px;
+  padding: 0 14px;
+  border-radius: var(--settings-control-radius);
+  font-size: 13px;
+  transition: background-color 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease, color 0.15s ease;
+}
+
+.settings-page .primary-button svg,
+.settings-page .secondary-button svg {
+  width: 16px;
+  height: 16px;
+}
+
+/* 文本类控件：同高同圆角，聚焦给和搜索框一致的柔和外圈。 */
+.settings-page input[type='text'],
+.settings-page input[type='search'],
+.settings-page input[type='password'],
+.settings-page input[type='number'],
+.settings-page input[type='time'],
+.settings-page input[type='url'],
+.settings-page input[type='email'],
+.settings-page select {
+  min-height: var(--settings-control-height);
+  padding: 0 12px;
+  border: 1px solid var(--border-strong);
+  border-radius: var(--settings-control-radius);
+  background: var(--surface-alt);
+  color: var(--text);
+  font: inherit;
+  font-size: 13px;
+  outline: none;
+  transition: border-color 0.15s ease, background-color 0.15s ease, box-shadow 0.15s ease;
+}
+
+.settings-page input[type='text']:focus-visible,
+.settings-page input[type='search']:focus-visible,
+.settings-page input[type='password']:focus-visible,
+.settings-page input[type='number']:focus-visible,
+.settings-page input[type='time']:focus-visible,
+.settings-page input[type='url']:focus-visible,
+.settings-page input[type='email']:focus-visible,
+.settings-page select:focus-visible,
+.settings-page textarea:focus-visible {
+  border-color: var(--accent);
+  background: var(--surface);
+  box-shadow: 0 0 0 3px var(--accent-soft);
+}
+
+/* 按钮聚焦圈：与弹窗输入框同款，键盘操作时可见。 */
+.settings-page button:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px var(--accent-soft);
+}
+
+/* 分段控件：外壳 12px、内部 9px，跟弹窗里 10px 的控件圆角同一档；
+   3px 内衬 + 32px 按钮 + 1px 边框 = 整条 40px，与 h-10 控件高度对齐。 */
+.settings-page .segmented-control {
+  padding: 3px;
+  border-radius: 12px;
+}
+
+.settings-page .segmented-control button {
+  min-height: 32px;
+  padding: 0 14px;
+  border-radius: 9px;
+  font-size: 12px;
+}
+
+/* 左侧导航：行高对齐弹窗列表行（实际 46px）、10px 圆角；选中态改浅蓝底 + 蓝字。 */
+.settings-navigation {
+  gap: 4px;
+  padding: 0;
+}
+
+.settings-navigation-item {
+  min-height: var(--settings-control-height);
+  grid-template-columns: 28px minmax(0, 1fr);
+  gap: 10px;
+  padding: 8px 12px;
+  border-radius: var(--settings-control-radius);
+}
+
+.settings-navigation-item strong {
+  font-size: 12.5px;
+}
+
+.settings-navigation-icon {
+  width: 28px;
+  height: 28px;
+  border-radius: 8px;
+}
+
+.settings-navigation-item[data-active='true'] {
+  border-color: transparent;
+  background: var(--accent-soft);
+  box-shadow: none;
+  color: var(--accent-strong);
+}
+
+.settings-navigation-item[data-active='true'] .settings-navigation-icon {
+  background: rgba(255, 255, 255, 0.72);
+  color: var(--accent-strong);
+}
+
+/* 连接模式选项：本质是可点列表行，对齐弹窗里 46px / 10px 的列表行规格。 */
+.settings-page .connector-mode-option {
+  min-height: 46px;
+  padding: 10px 14px;
+  border-radius: var(--settings-control-radius);
+}
+
+.settings-page .connector-mode-option-icon {
+  width: 28px;
+  height: 28px;
+  border-radius: 8px;
+}
+
+/* 「用量与预算」：胶囊 Tab 与下方内容卡片是两个独立模块，中间留 16px，
+   否则两个圆角块会直接贴合、视觉上糊成一团。 */
+.settings-page .settings-content[data-active-setting='settings-token-usage'] > #settings-token-usage {
+  display: grid;
+  gap: 16px;
+}
+
+.settings-page .usage-budget-switcher {
+  margin: 0;
+  background: var(--surface-alt);
+}
+
+/* 转写语言：多选。分段控件是单选语义，两个都能同时点亮时用户分不清含义，
+   改成彼此分开、带勾选框的芯片——靠形状和勾选状态说明“可多选”，不加任何小字。 */
+.settings-page .language-toggles {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  gap: 8px;
+}
+
+.settings-page .language-toggle {
+  display: inline-flex;
+  min-height: var(--settings-control-height);
+  align-items: center;
+  gap: 8px;
+  padding: 0 14px;
+  border: 1px solid var(--border);
+  border-radius: var(--settings-control-radius);
+  background: var(--surface);
+  color: var(--text);
+  cursor: pointer;
+  font: inherit;
+  font-size: 13px;
+  font-weight: 600;
+  white-space: nowrap;
+  transition: background-color 0.15s ease, border-color 0.15s ease, color 0.15s ease, box-shadow 0.15s ease;
+}
+
+.settings-page .language-toggle:hover {
+  border-color: var(--border-strong);
+  background: var(--hover);
+}
+
+.settings-page .language-toggle[data-active='true'] {
+  border-color: var(--accent);
+  background: var(--accent-soft);
+  color: var(--accent-strong);
+}
+
+.settings-page .language-toggle:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px var(--accent-soft);
+}
+
+.settings-page .language-toggle-box {
+  display: inline-grid;
+  width: 16px;
+  height: 16px;
+  flex: 0 0 16px;
+  place-items: center;
+  border: 1.5px solid var(--border-strong);
+  border-radius: 5px;
+  background: var(--surface);
+  color: transparent;
+  transition: background-color 0.15s ease, border-color 0.15s ease;
+}
+
+.settings-page .language-toggle[data-active='true'] .language-toggle-box {
+  border-color: var(--accent);
+  background: var(--accent);
+  color: #fff;
+}
+
+.settings-page .language-toggle-box svg {
+  width: 11px;
+  height: 11px;
+  stroke-width: 3.2;
+}
+
+/* 卡片：16px 圆角 + 柔和阴影 + 更松的行内边距，撑出呼吸感。
+   注意只描真实卡片（section / .reality-settings-section）：models 与 token-usage
+   两组只是透明栅格容器，给它们加阴影会凭空多出一个矩形。 */
+.settings-content > section,
+.settings-page .reality-settings-section,
+.settings-page .cloud-account-section {
+  border-radius: var(--settings-card-radius);
+  box-shadow: var(--settings-soft-shadow);
+}
+
+/* 卡片头部：左侧图标 + 标题撑开、右侧操作靠右。原来 30px + 1fr 的两列栅格
+   会把第三个子元素（操作按钮）挤到第二行第一列的 30px 里，文字只能逐字竖排。 */
+.settings-page .reality-settings-section > header {
+  display: flex;
+  flex-wrap: nowrap;
+  align-items: center;
+  gap: 12px;
+  padding: 15px 20px;
+  border-bottom: 1px solid var(--border);
+  background: transparent;
+}
+
+.settings-page .reality-settings-section > header > span {
+  width: 32px;
+  height: 32px;
+  flex: 0 0 32px;
+  border-radius: 9px;
+}
+
+.settings-page .reality-settings-section > header > div:not(.rc-header-actions) {
+  flex: 1 1 auto;
+  min-width: 0;
+}
+
+.settings-page .reality-settings-section > header h2 {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.settings-page .reality-settings-section > header > .rc-header-actions {
+  flex: 0 0 auto;
+}
+
+/* 头部任何按钮都不许被挤窄；纯图标按钮（刷新/测试）保持原有方形尺寸。 */
+.settings-page .reality-settings-section > header > button {
+  flex: 0 0 auto;
+}
+
+/* 带文字的操作按钮：轻量次级样式——浅灰底、极细描边、32px 高，
+   宽度随文字、绝不折行。 */
+.settings-page .reality-settings-section > header > button:not(.cloud-account-refresh):not(.rc-icon-button) {
+  width: auto;
+  min-height: 32px;
+  padding: 0 12px;
+  white-space: nowrap;
+  border: 1px solid transparent;
+  border-radius: var(--settings-control-radius);
+  background: var(--surface-alt);
+  color: var(--text);
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.settings-page .reality-settings-section > header > button:not(.cloud-account-refresh):not(.rc-icon-button):hover:not(:disabled) {
+  border-color: var(--border);
+  background: var(--hover);
+}
+
+.settings-page .reality-settings-section h2 {
+  font-size: 14.5px;
+}
+
+.settings-page .reality-setting-row {
+  min-height: 58px;
+  gap: 16px;
+  padding: 14px 20px;
+}
diff --git a/apps/desktop/src/renderer/src/components/pages/SettingsPage.tsx b/apps/desktop/src/renderer/src/components/pages/SettingsPage.tsx
index 7fb46a0b..11fe89fb 100644
--- a/apps/desktop/src/renderer/src/components/pages/SettingsPage.tsx
+++ b/apps/desktop/src/renderer/src/components/pages/SettingsPage.tsx
@@ -4,6 +4,7 @@ import {
   Brain,
   Camera,
   CalendarClock,
+  Check,
   Cloud,
   LoaderCircle,
   Languages,
@@ -924,10 +925,32 @@ export function SettingsPage({ onStartFullOnboarding }: { onStartFullOnboarding?
         </div>
         <div className="reality-setting-row">
           <div><strong>{t('surface:settings.transcriptionLanguages')}</strong></div>
-          <div className="segmented-control" aria-label={t('surface:settings.realityPerceptionTranscriptionLanguages')}>
+          {/* 多选：用带勾选框的独立芯片表达，不用分段控件（那是单选语义）。 */}
+          <div className="language-toggles" role="group" aria-label={t('surface:settings.realityPerceptionTranscriptionLanguages')}>
             {([['zh', 'surface:settings.chinese'], ['en', 'surface:settings.english']] as const).map(([value, label]) => {
               const active = realitySettings.languages.includes(value)
-              return <button key={value} type="button" data-active={String(active)} onClick={() => updateRealitySettings({ languages: active && realitySettings.languages.length > 1 ? realitySettings.languages.filter((item) => item !== value) : active ? realitySettings.languages : [...realitySettings.languages, value] })}>{t(label)}</button>
+              return (
+                <button
+                  key={value}
+                  type="button"
+                  role="checkbox"
+                  aria-checked={active}
+                  className="language-toggle"
+                  data-active={String(active)}
+                  onClick={() => updateRealitySettings({
+                    languages: active && realitySettings.languages.length > 1
+                      ? realitySettings.languages.filter((item) => item !== value)
+                      : active
+                        ? realitySettings.languages
+                        : [...realitySettings.languages, value],
+                  })}
+                >
+                  <span className="language-toggle-box" aria-hidden="true">
+                    {active ? <Check aria-hidden="true" /> : null}
+                  </span>
+                  {t(label)}
+                </button>
+              )
             })}
           </div>
         </div>
diff --git a/apps/desktop/src/renderer/src/components/pages/WikiPage.css b/apps/desktop/src/renderer/src/components/pages/WikiPage.css
index b0945268..d139d6c2 100644
--- a/apps/desktop/src/renderer/src/components/pages/WikiPage.css
+++ b/apps/desktop/src/renderer/src/components/pages/WikiPage.css
@@ -699,6 +699,17 @@
   color: var(--text);
 }
 
+/* 自适应：与「仅核心/显示全部」同排同款，图标 + 文案不要贴在一起 */
+.wiki-graph-fit {
+  gap: 6px;
+}
+
+.wiki-graph-fit svg {
+  width: 13px;
+  height: 13px;
+  flex: 0 0 auto;
+}
+
 /* 搜索无命中：替换画布的占位 */
 .wiki-graph-no-match {
   display: grid;
diff --git a/apps/desktop/src/renderer/src/components/pages/WikiPage.tsx b/apps/desktop/src/renderer/src/components/pages/WikiPage.tsx
index 7c9ccd11..732e394d 100644
--- a/apps/desktop/src/renderer/src/components/pages/WikiPage.tsx
+++ b/apps/desktop/src/renderer/src/components/pages/WikiPage.tsx
@@ -1,9 +1,10 @@
-import { BookOpenText, ChevronDown, ChevronRight, FileText, ListTree, Network, PanelLeftClose, PanelLeftOpen, RefreshCw, Search, X } from 'lucide-react'
+import { BookOpenText, ChevronDown, ChevronRight, FileText, ListTree, Maximize2, Network, PanelLeftClose, PanelLeftOpen, RefreshCw, Search, X } from 'lucide-react'
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 
 import {
   WikiGraphCanvas,
   WIKI_CLUSTERS,
+  type WikiGraphCanvasHandle,
 } from '../context-room/ported/components/WikiGraphCanvas'
 import { MarkdownBody, resolveWikiLinkTarget } from '../context-room/ported/components/detail-panels/MarkdownBody'
 import { FOLDER_LABEL_KEYS, WRAPPER_DIR_NAMES, WIKI_TREE_CARET_SLOT, WikiTree } from '../context-room/ported/components/detail-panels/WikiTree'
@@ -88,6 +89,7 @@ export function WikiPage() {
   const [revealPath, setRevealPath] = useState<string | null>(null)
   const switcherRef = useRef<HTMLDivElement | null>(null)
   const sidebarRef = useRef<HTMLElement | null>(null)
+  const graphCanvasRef = useRef<WikiGraphCanvasHandle | null>(null)
 
   useEffect(() => {
     const timer = setTimeout(() => setGraphFilter(graphQuery), 200)
@@ -622,8 +624,10 @@ export function WikiPage() {
                     <>
                       {displayGraph && displayGraph.nodes.length > 0 ? (
                         <WikiGraphCanvas
+                          ref={graphCanvasRef}
                           graph={displayGraph}
                           selectedPath={selectedPage?.path ?? null}
+                          showFitButton={false}
                           onSelectPage={(path) => {
                             const page = pages.find((candidate) => candidate.path === path)
                             if (page) openPage(page)
@@ -667,6 +671,18 @@ export function WikiPage() {
                         >
                           {coreOnly ? t('surface:wiki.graphShowAll') : t('surface:wiki.graphCoreOnly')}
                         </button>
+                        {/* 自适应按钮放在工具条里（原来浮在画布右上角会压住「显示全部」），
+                            画布自带的那颗在这里关掉，避免同屏两个。 */}
+                        <button
+                          type="button"
+                          className="wiki-graph-mode wiki-graph-fit"
+                          title={t('surface:wiki.graphFitHint')}
+                          aria-label={t('surface:wiki.graphFitHint')}
+                          onClick={() => graphCanvasRef.current?.fitView()}
+                        >
+                          <Maximize2 aria-hidden="true" />
+                          {t('surface:wiki.graphFitToCanvas')}
+                        </button>
                       </div>
                       <div className="wiki-graph-stats" aria-label={t('surface:wiki.graphStatistics')}>
                         <span>{t('surface:wiki.countPages', { count: (displayGraph ?? graph).nodes.length })}</span>
diff --git a/apps/desktop/src/renderer/src/i18n/locales/en-US/contextRoom.json b/apps/desktop/src/renderer/src/i18n/locales/en-US/contextRoom.json
index 2883b4f3..19170ef9 100644
--- a/apps/desktop/src/renderer/src/i18n/locales/en-US/contextRoom.json
+++ b/apps/desktop/src/renderer/src/i18n/locales/en-US/contextRoom.json
@@ -87,6 +87,13 @@
   "artifactLibrary.agentGenerated": "AI generated",
   "artifactLibrary.revealInFolder": "Reveal in Folder",
   "artifactLibrary.revealFailed": "Could not reveal in folder",
+  "artifactLibrary.moreActions": "More actions",
+  "artifactLibrary.moveToAnotherRoom": "Move to another Room",
+  "artifactLibrary.select": "Select",
+  "artifactLibrary.cancelSelection": "Cancel selection",
+  "artifactLibrary.selectedCount": "{count} selected",
+  "artifactLibrary.moveSelected": "Move to another Room",
+  "artifactLibrary.selectDocument": "Select “{name}”",
   "artifactLibrary.newArtifact": "New artifact",
   "artifactLibrary.newLightDoc": "Light document",
   "artifactLibrary.newLightDocHint": "Markdown syntax, great for notes and co-editing",
@@ -619,6 +626,8 @@
   "graphs.entityFactNodes": "Entity and fact nodes",
   "graphs.entityNode": "Entity: {label}",
   "graphs.factNode": "Fact: {label}",
+  "graphs.fitCanvasHint": "Fit graph: zoom and center",
+  "graphs.fitToCanvas": "Fit to canvas",
   "graphs.linkBlockNode": "Text block: {label}",
   "graphs.linkDocumentNode": "Document: {label}",
   "graphs.linkGraphCanvas": "Room link graph canvas",
@@ -1196,7 +1205,6 @@
   "relations.evidenceKind.shared_source": "Shared source",
   "relations.filterStrength": "Filter by relation strength",
   "relations.filterType": "Filter by relation type",
-  "relations.fitRelatedRoomGraph": "Fit related Room graph",
   "relations.fitToCanvas": "Fit to canvas",
   "relations.hide": "Hide",
   "relations.indexBuilding": "Indexing {count} items",
@@ -1355,6 +1363,25 @@
   "selectionRewriteAgent.noReplacementText": "Agent did not return replacement text.",
   "selectionRewriteAgent.timedOut": "Agent rewrite timed out.",
   "shared.cancel": "Cancel",
+  "moveDocument.title": "Move to another Room",
+  "moveDocument.subtitle": "Choose the Room to move “{name}” into.",
+  "moveDocument.subtitleBatch": "Choose the Room to move {count} artifacts into.",
+  "moveDocument.searchPlaceholder": "Search Rooms",
+  "moveDocument.targetRoom": "Target Room",
+  "moveDocument.recent": "Recently used",
+  "moveDocument.allRooms": "All Rooms",
+  "moveDocument.noMatch": "No matching Rooms",
+  "moveDocument.loadingRooms": "Loading Rooms…",
+  "moveDocument.roomsUnavailable": "Room list is unavailable. Try again later.",
+  "moveDocument.documentsUnavailable": "Document service is unavailable. Try again later.",
+  "moveDocument.moved": "Artifact moved",
+  "moveDocument.movedToRoom": "“{name}” has been moved to “{room}”. Both Room lists and indexes are updated.",
+  "moveDocument.movedManyToRoom": "{count} artifacts moved to “{room}”. Both Room lists and indexes are updated.",
+  "moveDocument.moveFailed": "Move failed. Try again later.",
+  "moveDocument.cancel": "Cancel",
+  "moveDocument.move": "Move",
+  "moveDocument.moving": "Moving…",
+  "moveDocument.moveToRoom": "Move to “{room}”",
   "shared.closeDialog": "Close dialog",
   "shared.completeTheCurrentContextRoomAction": "Complete the current Context Room action",
   "shared.confirmAction": "Confirm action",
@@ -1465,6 +1492,8 @@
   "tiptapDocumentActions.importFromExternal": "Import from Feishu/Notion…",
   "tiptapDocumentActions.markdownExported": "Markdown exported",
   "tiptapDocumentActions.moreActions": "More actions",
+  "tiptapDocumentActions.moveToAnotherRoom": "Move to another Room",
+  "tiptapDocumentActions.saveBeforeMoving": "Finish saving before moving the document",
   "tiptapDocumentActions.moreDocumentActions": "More document actions",
   "tiptapDocumentActions.moveToTrash": "Move to Trash",
   "tiptapDocumentActions.nameWillBeMovedToTrashYouCan": "“{name}” will be moved to Trash. You can restore it later.",
diff --git a/apps/desktop/src/renderer/src/i18n/locales/en-US/surface.json b/apps/desktop/src/renderer/src/i18n/locales/en-US/surface.json
index c67529b8..5cb3d6d3 100644
--- a/apps/desktop/src/renderer/src/i18n/locales/en-US/surface.json
+++ b/apps/desktop/src/renderer/src/i18n/locales/en-US/surface.json
@@ -1154,6 +1154,8 @@
   "wiki.graphSearchPlaceholder": "Search nodes…",
   "wiki.graphShowAll": "Show all",
   "wiki.graphCoreOnly": "Core only",
+  "wiki.graphFitHint": "Fit graph: zoom and center",
+  "wiki.graphFitToCanvas": "Fit to canvas",
   "wiki.graphNoMatches": "No matching nodes",
   "wiki.graphLegend": "Legend",
   "wiki.selectWiki": "Select a wiki",
diff --git a/apps/desktop/src/renderer/src/i18n/locales/zh-CN/contextRoom.json b/apps/desktop/src/renderer/src/i18n/locales/zh-CN/contextRoom.json
index 287c3101..dcb4f398 100644
--- a/apps/desktop/src/renderer/src/i18n/locales/zh-CN/contextRoom.json
+++ b/apps/desktop/src/renderer/src/i18n/locales/zh-CN/contextRoom.json
@@ -87,6 +87,13 @@
   "artifactLibrary.agentGenerated": "AI 生成",
   "artifactLibrary.revealInFolder": "在文件夹中显示",
   "artifactLibrary.revealFailed": "在文件夹中显示失败",
+  "artifactLibrary.moreActions": "更多操作",
+  "artifactLibrary.moveToAnotherRoom": "移动到其他 Room",
+  "artifactLibrary.select": "多选",
+  "artifactLibrary.cancelSelection": "退出多选",
+  "artifactLibrary.selectedCount": "已选 {count} 项",
+  "artifactLibrary.moveSelected": "移动到其他 Room",
+  "artifactLibrary.selectDocument": "选择「{name}」",
   "artifactLibrary.newArtifact": "新建产物",
   "artifactLibrary.newLightDoc": "轻文档",
   "artifactLibrary.newLightDocHint": "Markdown 语法，适合笔记与协作编辑",
@@ -619,6 +626,8 @@
   "graphs.entityFactNodes": "实体与事实节点",
   "graphs.entityNode": "实体：{label}",
   "graphs.factNode": "事实：{label}",
+  "graphs.fitCanvasHint": "自适应图谱：缩放并居中",
+  "graphs.fitToCanvas": "适应画布",
   "graphs.linkBlockNode": "文本块：{label}",
   "graphs.linkDocumentNode": "文档：{label}",
   "graphs.linkGraphCanvas": "Room 建联关系图画布",
@@ -1196,7 +1205,6 @@
   "relations.evidenceKind.shared_source": "共享资料",
   "relations.filterStrength": "按关系强度筛选",
   "relations.filterType": "按关系类型筛选",
-  "relations.fitRelatedRoomGraph": "适应关联 Room 图谱",
   "relations.fitToCanvas": "适应画布",
   "relations.hide": "隐藏",
   "relations.indexBuilding": "正在索引 {count} 项",
@@ -1355,6 +1363,25 @@
   "selectionRewriteAgent.noReplacementText": "Agent 没有返回可替换的文本。",
   "selectionRewriteAgent.timedOut": "Agent 重写超时。",
   "shared.cancel": "取消",
+  "moveDocument.title": "移动到其他 Room",
+  "moveDocument.subtitle": "选择「{name}」要迁入的 Room。",
+  "moveDocument.subtitleBatch": "选择 {count} 个产物要迁入的 Room。",
+  "moveDocument.searchPlaceholder": "搜索 Room 名称",
+  "moveDocument.targetRoom": "目标 Room",
+  "moveDocument.recent": "最近使用",
+  "moveDocument.allRooms": "全部 Room",
+  "moveDocument.noMatch": "没有匹配的 Room",
+  "moveDocument.loadingRooms": "正在加载 Room…",
+  "moveDocument.roomsUnavailable": "Room 清单暂不可用，请稍后重试。",
+  "moveDocument.documentsUnavailable": "文档服务暂不可用，请稍后重试。",
+  "moveDocument.moved": "已移动产物",
+  "moveDocument.movedToRoom": "「{name}」已移动到「{room}」，两侧清单与索引已同步更新。",
+  "moveDocument.movedManyToRoom": "{count} 个产物已移动到「{room}」，两侧清单与索引已同步更新。",
+  "moveDocument.moveFailed": "移动失败，请稍后重试。",
+  "moveDocument.cancel": "取消",
+  "moveDocument.move": "移动",
+  "moveDocument.moving": "正在移动…",
+  "moveDocument.moveToRoom": "移动到「{room}」",
   "shared.closeDialog": "关闭对话框",
   "shared.completeTheCurrentContextRoomAction": "完成当前 Context Room 操作",
   "shared.confirmAction": "确认执行",
@@ -1465,6 +1492,8 @@
   "tiptapDocumentActions.importFromExternal": "从飞书/Notion 导入…",
   "tiptapDocumentActions.markdownExported": "已导出 Markdown",
   "tiptapDocumentActions.moreActions": "更多操作",
+  "tiptapDocumentActions.moveToAnotherRoom": "移动到其他 Room",
+  "tiptapDocumentActions.saveBeforeMoving": "保存完成后再移动文档",
   "tiptapDocumentActions.moreDocumentActions": "文档更多操作",
   "tiptapDocumentActions.moveToTrash": "移到回收站",
   "tiptapDocumentActions.nameWillBeMovedToTrashYouCan": "“{name}”将移到回收站，你仍可以在回收站中恢复。",
diff --git a/apps/desktop/src/renderer/src/i18n/locales/zh-CN/surface.json b/apps/desktop/src/renderer/src/i18n/locales/zh-CN/surface.json
index 13e16d20..23ea8db1 100644
--- a/apps/desktop/src/renderer/src/i18n/locales/zh-CN/surface.json
+++ b/apps/desktop/src/renderer/src/i18n/locales/zh-CN/surface.json
@@ -1156,6 +1156,8 @@
   "wiki.graphSearchPlaceholder": "搜索节点…",
   "wiki.graphShowAll": "显示全部",
   "wiki.graphCoreOnly": "只看核心",
+  "wiki.graphFitHint": "自适应图谱：缩放并居中",
+  "wiki.graphFitToCanvas": "适应画布",
   "wiki.graphNoMatches": "没有匹配的节点",
   "wiki.graphLegend": "图例",
   "wiki.selectWiki": "选择 wiki",
diff --git a/apps/desktop/src/shared/sources.ts b/apps/desktop/src/shared/sources.ts
index a5fbba24..1da36055 100644
--- a/apps/desktop/src/shared/sources.ts
+++ b/apps/desktop/src/shared/sources.ts
@@ -33,6 +33,8 @@ import type {
   RoomDuplicateCheckResult,
   RoomAppliedEntitiesResult,
   RoomOverviewProjection,
+  MovedRoomDocument,
+  MoveRoomDocumentsResult,
   RoomMergeOperation,
   RoomMergePreview,
   RoomMail,
@@ -1487,6 +1489,8 @@ export interface NxcoreDesktopApi {
     import(input: ImportRoomDocumentInput): Promise<RoomDocument>
     save(documentId: string, input: SaveRoomDocumentInput): Promise<RoomDocument>
     delete(documentId: string): Promise<void>
+    move(documentId: string, fromRoomId: string, roomId: string): Promise<MovedRoomDocument>
+    moveMany(documentIds: string[], fromRoomId: string, roomId: string): Promise<MoveRoomDocumentsResult>
     restore(documentId: string): Promise<RoomDocument>
     deletePermanently(documentId: string): Promise<void>
     emptyTrash(roomId: string): Promise<void>
diff --git a/apps/desktop/tests/agent-status-page-pelican-reset.test.tsx b/apps/desktop/tests/agent-status-page-pelican-reset.test.tsx
new file mode 100644
index 00000000..79b7fd78
--- /dev/null
+++ b/apps/desktop/tests/agent-status-page-pelican-reset.test.tsx
@@ -0,0 +1,97 @@
+/** @vitest-environment happy-dom */
+
+import TestRenderer, { act } from 'react-test-renderer'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+import type { AgentStatusSnapshot } from '@nxcore/agent-contract'
+
+import { AgentStatusPage } from '../src/renderer/src/components/pages/AgentStatusPage'
+
+function snapshotWith(state: 'idle' | 'running' | 'error'): AgentStatusSnapshot {
+  return {
+    generatedAt: '2026-08-25T01:03:00.000Z',
+    summary: {
+      total: 1,
+      running: state === 'running' ? 1 : 0,
+      idle: state === 'idle' ? 1 : 0,
+      error: state === 'error' ? 1 : 0,
+    },
+    agents: [{
+      agentId: 'main',
+      name: '主 Agent',
+      description: '整理资料',
+      kind: 'builtin',
+      // 失败之后再拿到的快照：状态已经回海（idle），失败只留在 lastRun。
+      state,
+      activeRunCount: state === 'running' ? 1 : 0,
+      workspace: { id: 'agent://main', isolation: 'dedicated', revisionId: null },
+      currentRun: state === 'running'
+        ? { id: 'run-2', task: '整理今天的会议记录', pageLabel: '办公室', status: 'running', startedAt: '2026-08-25T01:04:00.000Z', completedAt: null }
+        : null,
+      lastRun: {
+        id: 'run-1',
+        task: '整理今天的会议记录',
+        pageLabel: '办公室',
+        status: state === 'running' ? 'running' : 'failed',
+        startedAt: '2026-08-25T01:00:00.000Z',
+        completedAt: state === 'running' ? null : '2026-08-25T01:02:00.000Z',
+      },
+      updatedAt: '2026-08-25T01:02:00.000Z',
+    }],
+  }
+}
+
+function stubAgentStatus(snapshot: AgentStatusSnapshot) {
+  ;(window as unknown as { nxcore?: unknown }).nxcore = {
+    agent: { getStatus: vi.fn().mockResolvedValue(snapshot) },
+  }
+}
+
+async function renderPage() {
+  let renderer: TestRenderer.ReactTestRenderer
+  await act(async () => {
+    renderer = TestRenderer.create(<AgentStatusPage />)
+  })
+  return renderer!
+}
+
+describe('办公室：运行失败后鹈鹕回海', () => {
+  afterEach(() => {
+    delete (window as unknown as { nxcore?: unknown }).nxcore
+    vi.unstubAllGlobals()
+  })
+
+  it('失败的 agent 待在海里游泳，不再停在路肩', async () => {
+    stubAgentStatus(snapshotWith('idle'))
+    const renderer = await renderPage()
+
+    const [rider] = renderer.root.findAllByProps({ className: 'coast-rider' })
+    expect(rider!.props['data-state']).toBe('idle')
+    expect(rider!.props['data-mode']).toBe('swimming')
+    expect(String(rider!.props['data-lane'])).toMatch(/^sea-/)
+    // 初始状态：海面两排深度之一。
+    expect(['sea-front', 'sea-back']).toContain(rider!.props['data-lane'])
+    renderer.unmount()
+  })
+
+  it('最近活动那条记录仍然显示失败', async () => {
+    stubAgentStatus(snapshotWith('idle'))
+    const renderer = await renderPage()
+
+    const activity = renderer.root.findByProps({ className: 'agent-recent-activity' })
+    const [mark] = activity.findAllByType('i')
+    expect(mark!.props['data-state']).toBe('error')
+    expect(activity.findAllByType('em').map((node) => node.children)).toEqual([['失败']])
+    renderer.unmount()
+  })
+
+  it('运行中照旧骑在公路上', async () => {
+    stubAgentStatus(snapshotWith('running'))
+    const renderer = await renderPage()
+
+    const [rider] = renderer.root.findAllByProps({ className: 'coast-rider' })
+    expect(rider!.props['data-state']).toBe('running')
+    expect(rider!.props['data-mode']).toBe('riding')
+    renderer.unmount()
+  })
+})
diff --git a/apps/desktop/tests/context-room-graph-fit-buttons.test.tsx b/apps/desktop/tests/context-room-graph-fit-buttons.test.tsx
new file mode 100644
index 00000000..a167016a
--- /dev/null
+++ b/apps/desktop/tests/context-room-graph-fit-buttons.test.tsx
@@ -0,0 +1,109 @@
+/** @vitest-environment happy-dom */
+
+import TestRenderer, { act } from 'react-test-renderer'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+const fitViewCalls = { count: 0 }
+
+// node 环境没有 window/canvas/Worker：pixi 画布与力导向布局都换成轻量替身，
+// 只验证「自适应按钮 → 画布 fitView」这条接线。
+vi.mock('../src/renderer/src/components/graph/useForceGraphLayout', () => ({
+  useForceGraphLayout: () => ({
+    controller: null,
+    positions: null,
+    revision: 0,
+    resize: vi.fn(),
+    cancelAutoFit: vi.fn(),
+    drag: vi.fn(),
+    release: vi.fn(),
+  }),
+}))
+
+vi.mock('../src/renderer/src/components/graph/PixiForceGraphCanvas', async () => {
+  const { forwardRef, useImperativeHandle } = await import('react')
+  return {
+    PixiForceGraphCanvas: forwardRef(function MockPixiForceGraphCanvas(
+      _props: Record<string, unknown>,
+      ref,
+    ) {
+      useImperativeHandle(ref, () => ({
+        fitView: () => {
+          fitViewCalls.count += 1
+        },
+      }), [])
+      return null
+    }),
+  }
+})
+
+import { EntityFactGraphCanvas } from '../src/renderer/src/components/context-room/ported/components/EntityFactGraphCanvas'
+import { LinkGraphCanvas } from '../src/renderer/src/components/context-room/ported/components/LinkGraphCanvas'
+import { WikiGraphCanvas } from '../src/renderer/src/components/context-room/ported/components/WikiGraphCanvas'
+
+/** 关系板块下的三张力导向图谱都应带一颗常驻的自适应按钮。 */
+describe('关系板块各图谱的自适应按钮', () => {
+  afterEach(() => {
+    fitViewCalls.count = 0
+  })
+
+  async function renderAndFit(element: React.ReactElement) {
+    let renderer: TestRenderer.ReactTestRenderer
+    await act(async () => {
+      renderer = TestRenderer.create(element)
+    })
+    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)
+    renderer!.unmount()
+  }
+
+  it('实体与事实图谱可自适应缩放居中', async () => {
+    await renderAndFit(
+      <EntityFactGraphCanvas
+        data={{
+          rootId: 'root',
+          nodes: [
+            { id: 'root', kind: 'entity', label: 'Room 本身', description: '', entityType: '主题' },
+            { id: 'fact-1', kind: 'fact', label: '一条事实', description: '' },
+          ],
+          edges: [{ id: 'edge-1', relation: 'about', source: 'fact-1', target: 'root' }],
+        }}
+        selectedId="root"
+        onSelect={vi.fn()}
+      />,
+    )
+  })
+
+  it('内容建联图谱可自适应缩放居中', async () => {
+    await renderAndFit(
+      <LinkGraphCanvas
+        data={{
+          rootId: 'root',
+          nodes: [
+            { id: 'root', kind: 'root', documentId: null, memoryId: null, parentDocumentId: null, blockId: null, label: '本 Room', description: '', stale: false },
+          ],
+          edges: [],
+          totals: { documents: 0, memories: 0, links: 0, dangling: 0 },
+        }}
+        selectedId="root"
+        onSelect={vi.fn()}
+      />,
+    )
+  })
+
+  it('Wiki 图谱可自适应缩放居中', async () => {
+    await renderAndFit(
+      <WikiGraphCanvas
+        graph={{
+          nodes: [{ id: 'page-a', title: '页 A', path: 'a.md', inLinks: 0 }],
+          edges: [],
+        }}
+        selectedPath={null}
+        onSelectPage={vi.fn()}
+      />,
+    )
+  })
+})
\ No newline at end of file
diff --git a/apps/desktop/tests/context-room-home-graph-fit.test.tsx b/apps/desktop/tests/context-room-home-graph-fit.test.tsx
new file mode 100644
index 00000000..8391fc18
--- /dev/null
+++ b/apps/desktop/tests/context-room-home-graph-fit.test.tsx
@@ -0,0 +1,131 @@
+/** @vitest-environment happy-dom */
+
+import TestRenderer, { act } from 'react-test-renderer'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+const fitViewCalls = { count: 0 }
+
+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,
+    ) {
+      useImperativeHandle(ref, () => ({
+        fitView: async () => {
+          fitViewCalls.count += 1
+        },
+      }), [])
+      return null
+    }),
+  }
+})
+
+vi.mock('../src/renderer/src/i18n/LocaleContext', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('../src/renderer/src/i18n/LocaleContext')>()
+  return {
+    ...actual,
+    useLocale: () => ({
+      locale: 'zh-CN',
+      t: (message: string, values?: Record<string, string | number>) => actual.translate('zh-CN', message, values),
+    }),
+  }
+})
+
+vi.mock('../src/renderer/src/components/context-room/ContextRoomStateProvider', () => ({
+  // 面板只消费 refreshFromBackend（创建后重拉推荐池）；测试无需真实 Provider。
+  useContextRoomState: () => ({
+    state: null,
+    setState: () => {},
+    backendReady: true,
+    refreshFromBackend: async () => null,
+  }),
+}))
+
+import { createContextRoomFixture } from './context-room-fixture'
+import { HomeView } from '../src/renderer/src/components/context-room/ported/components/HomeView'
+
+const handlers = {
+  onRenameRoom: vi.fn(),
+  onDeleteRoom: vi.fn(),
+  onRestoreRoom: vi.fn(),
+  onOpenDetail: vi.fn(),
+  onShowAll: vi.fn(),
+  onFocusAgent: vi.fn(),
+  onRefreshRooms: vi.fn().mockResolvedValue(undefined),
+}
+
+type KnowledgeStub = { getRoomGraph: ReturnType<typeof vi.fn>; getRoomRelations: ReturnType<typeof vi.fn> }
+
+/** 只挂 nxcore.knowledge：happy-dom 的其余 window 能力（定时器/事件）要保留。 */
+function stubKnowledge(knowledge: KnowledgeStub) {
+  ;(window as unknown as { nxcore?: unknown }).nxcore = { knowledge }
+}
+
+function stubRoomGraph(edges: unknown[]) {
+  stubKnowledge({
+    getRoomRelations: vi.fn(),
+    getRoomGraph: vi.fn().mockResolvedValue({
+      revision: 1,
+      generatedAt: '2026-08-25T00:00:00.000Z',
+      indexing: { status: 'ready', pendingSources: 0 },
+      nodes: [
+        { id: 'room-a', title: 'Room A', kind: '项目', origin: 'user', updatedAt: '2026-08-25T00:00:00.000Z' },
+        { id: 'room-b', title: 'Room B', kind: '主题', origin: 'user', updatedAt: '2026-08-25T00:00:00.000Z' },
+      ],
+      edges,
+    }),
+  })
+}
+
+function renderHome() {
+  return TestRenderer.create(
+    <HomeView
+      rooms={[createContextRoomFixture('room-a', 'Room A'), createContextRoomFixture('room-b', 'Room B')]}
+      deletedRooms={[]}
+      {...handlers}
+    />,
+  )
+}
+
+describe('首页 Room 关系图谱的自适应按钮', () => {
+  afterEach(() => {
+    fitViewCalls.count = 0
+    delete (window as unknown as { nxcore?: unknown }).nxcore
+  })
+
+  // 首页画布可自由缩放平移：缩到最小或拖走后全图看不见，浮层按钮必须常驻并可点。
+  it('keeps an always-visible fit control that re-fits the whole graph', 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)
+    renderer!.unmount()
+  })
+
+  it('does not offer the fit control before the graph has loaded', async () => {
+    stubKnowledge({
+      getRoomRelations: vi.fn(),
+      // 永不 resolve：停在加载态，画布还没渲染。
+      getRoomGraph: vi.fn(() => new Promise(() => {})),
+    })
+    let renderer: TestRenderer.ReactTestRenderer | null = null
+    await act(async () => {
+      renderer = renderHome()
+    })
+
+    expect(renderer!.root.findAllByProps({ className: 'context-room-graph-fit' })).toHaveLength(0)
+    renderer!.unmount()
+  })
+})
diff --git a/apps/desktop/tests/context-room-relations-pane.test.tsx b/apps/desktop/tests/context-room-relations-pane.test.tsx
index cb180eed..63f221ec 100644
--- a/apps/desktop/tests/context-room-relations-pane.test.tsx
+++ b/apps/desktop/tests/context-room-relations-pane.test.tsx
@@ -9,9 +9,10 @@ const graphProps: Array<{
   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 } = await import('react')
+  const { forwardRef, useImperativeHandle } = await import('react')
   return {
     RoomGraphCanvas: forwardRef(function MockRoomGraphCanvas(
       props: {
@@ -19,9 +20,14 @@ vi.mock('../src/renderer/src/components/context-room/ported/components/RoomGraph
         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>
@@ -194,3 +200,86 @@ describe('RelationsPane graph selection', () => {
     expect(renderer!.root.findByProps({ 'data-relation-type': 'supports' }).props.className).toBe('context-room-room-graph-inspector')
   })
 })
+
+describe('RelationsPane graph fit control', () => {
+  const edge = {
+    id: 'relation-a-b',
+    sourceRoomId: 'room-a',
+    targetRoomId: 'room-b',
+    directed: false,
+    type: 'shared_evidence',
+    origin: 'auto',
+    score: 1.2,
+    strength: 'weak',
+    sharedSourceCount: 1,
+    sharedEntityCount: 0,
+    directMentionCount: 0,
+    pinned: false,
+    hidden: false,
+    label: null,
+    note: null,
+    topReasons: [],
+    updatedAt: '2026-08-25T00:00:00.000Z',
+  }
+
+  function stubRelations(edges: unknown[]) {
+    vi.stubGlobal('window', {
+      nxcore: {
+        knowledge: {
+          getRoomGraph: vi.fn(),
+          getRoomRelations: vi.fn().mockResolvedValue({
+            revision: 1,
+            generatedAt: '2026-08-25T00:00:00.000Z',
+            indexing: { status: 'ready', pendingSources: 0 },
+            nodes: [
+              { id: 'room-a', title: 'Current Room', kind: '项目', origin: 'user', updatedAt: '2026-08-25T00:00:00.000Z' },
+              { id: 'room-b', title: 'Related Room', kind: '项目', origin: 'user', updatedAt: '2026-08-25T00:00:00.000Z' },
+            ],
+            edges,
+          }),
+        },
+      },
+      addEventListener: vi.fn(),
+      removeEventListener: vi.fn(),
+    })
+  }
+
+  afterEach(() => {
+    graphProps.length = 0
+    fitViewCalls.count = 0
+    vi.unstubAllGlobals()
+  })
+
+  // 画布可自由缩放平移：缩到最小或拖走后图看不见，浮层按钮必须始终可点。
+  it('keeps an always-visible fit control that re-fits the graph', async () => {
+    const current = room('room-a', '项目', 'Current Room')
+    const related = room('room-b', '项目', 'Related Room')
+    stubRelations([edge])
+    let renderer: TestRenderer.ReactTestRenderer
+
+    await act(async () => {
+      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)
+  })
+
+  it('hides the fit control when there is no graph to fit', async () => {
+    const current = room('room-a', '项目', 'Current Room')
+    stubRelations([])
+    let renderer: TestRenderer.ReactTestRenderer
+
+    await act(async () => {
+      renderer = TestRenderer.create(<RelationsPane room={current} rooms={[current]} onOpenRoom={vi.fn()} />)
+    })
+
+    expect(renderer!.root.findAllByProps({ className: 'context-room-graph-fit' })).toHaveLength(0)
+  })
+})
diff --git a/apps/desktop/tests/context-room-resource-import.test.tsx b/apps/desktop/tests/context-room-resource-import.test.tsx
index 88064b17..cfa3f2ba 100644
--- a/apps/desktop/tests/context-room-resource-import.test.tsx
+++ b/apps/desktop/tests/context-room-resource-import.test.tsx
@@ -1,3 +1,4 @@
+/** @vitest-environment happy-dom */
 import TestRenderer, { act } from 'react-test-renderer'
 import { describe, expect, it, vi } from 'vitest'
 
@@ -14,6 +15,37 @@ vi.mock('../src/renderer/src/i18n/LocaleContext', async (importOriginal) => {
 })
 
 import { ArtifactLibraryPane } from '../src/renderer/src/components/context-room/ported/components/detail-panels/ArtifactLibraryPane'
+import type { RoomDocument } from '@nxcore/agent-contract'
+
+const nativeDocument: RoomDocument = {
+  id: 'doc-artifact-1',
+  roomId: 'room-test',
+  title: '季度总结',
+  contentJson: { type: 'doc', content: [{ type: 'paragraph' }] },
+  contentSchemaVersion: 1,
+  version: 2,
+  status: 'active',
+  origin: 'native',
+  activeTransactionId: null,
+  createdAt: '2026-01-01T00:00:00.000Z',
+  updatedAt: '2026-01-02T00:00:00.000Z',
+}
+
+function renderArtifactLibraryWith(backendDocuments: RoomDocument[]) {
+  return TestRenderer.create(
+    <ArtifactLibraryPane
+      room={createContextRoomFixture()}
+      backendDocuments={backendDocuments}
+      trashedDocuments={[]}
+      selectedId={null}
+      onSelect={() => {}}
+      onCreateDocument={vi.fn().mockResolvedValue(undefined)}
+      onDeleteDocument={() => Promise.resolve()}
+      onRestoreDocument={() => Promise.resolve()}
+      onDeleteDocumentPermanently={() => Promise.resolve()}
+    />,
+  )
+}
 
 function renderArtifactLibrary() {
   return TestRenderer.create(
@@ -54,3 +86,55 @@ describe('产物库：文件导入入口只在新建产物弹层内', () => {
     expect(newArtifact).toBeTruthy()
   })
 })
+
+describe('产物库：产物操作菜单与多选整理', () => {
+  it('每个产物行都有 ⋯ 操作菜单入口（移动/删除收纳其中）', async () => {
+    let renderer: TestRenderer.ReactTestRenderer | null = null
+    await act(async () => {
+      renderer = renderArtifactLibraryWith([nativeDocument])
+    })
+    const more = renderer!.root.findAllByType('button')
+      .filter((node) => node.props.className === 'context-room-resource-more')
+    expect(more).toHaveLength(1)
+    // 行内不再常驻独立删除钮（删除收进 ⋯ 菜单）
+    expect(renderer!.root.findAllByType('button')
+      .some((node) => node.props.className === 'context-room-resource-delete')).toBe(false)
+  })
+
+  it('工具条右侧动作组同时容纳多选与新建产物（不被挤成竖排）', async () => {
+    let renderer: TestRenderer.ReactTestRenderer | null = null
+    await act(async () => {
+      renderer = renderArtifactLibrary()
+    })
+    const actions = renderer!.root.findAllByProps({ className: 'context-room-artifact-toolbar-actions' })
+    expect(actions).toHaveLength(1)
+    const buttons = actions[0]!.findAllByType('button')
+    expect(buttons.some((node) => node.props.className === 'context-room-artifact-new')).toBe(true)
+    expect(buttons.some((node) => node.props.className === 'context-room-artifact-select-toggle')).toBe(true)
+  })
+
+  it('多选模式勾选产物后批量移动入口可用', async () => {
+    let renderer: TestRenderer.ReactTestRenderer | null = null
+    await act(async () => {
+      renderer = renderArtifactLibraryWith([nativeDocument])
+    })
+    const toggle = renderer!.root.findAllByType('button')
+      .find((node) => node.props.className === 'context-room-artifact-select-toggle')
+    expect(toggle).toBeTruthy()
+    await act(async () => {
+      toggle!.props.onClick()
+    })
+
+    const checkbox = renderer!.root.findAllByType('button')
+      .find((node) => node.props.className === 'context-room-artifact-check')
+    expect(checkbox?.props['aria-checked']).toBe(false)
+    await act(async () => {
+      checkbox!.props.onClick()
+    })
+    expect(renderer!.root.findAllByType('button')
+      .find((node) => node.props.className === 'context-room-artifact-check')?.props['aria-checked']).toBe(true)
+    const moveSelected = renderer!.root.findAllByType('button')
+      .find((node) => node.props.className === 'context-room-artifact-selection-move')
+    expect(moveSelected?.props.disabled).toBe(false)
+  })
+})
diff --git a/apps/desktop/tests/move-document-to-room-dialog.test.tsx b/apps/desktop/tests/move-document-to-room-dialog.test.tsx
new file mode 100644
index 00000000..cee25b71
--- /dev/null
+++ b/apps/desktop/tests/move-document-to-room-dialog.test.tsx
@@ -0,0 +1,157 @@
+import TestRenderer, { act } from 'react-test-renderer'
+import type { ReactNode } from 'react'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+import type { MovedRoomDocument, RoomDocument } from '@nxcore/agent-contract'
+
+// 无 DOM 环境：Radix Portal 不渲染，替换成透传容器只测弹窗内部状态机。
+vi.mock('../src/renderer/src/components/context-room/ported/components/shared', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('../src/renderer/src/components/context-room/ported/components/shared')>()
+  return {
+    ...actual,
+    ReferenceDialog: function MockReferenceDialog({ open, children }: {
+      open: boolean
+      children: ReactNode
+    }) {
+      return open ? <div>{children}</div> : null
+    },
+  }
+})
+
+import { MoveDocumentToRoomDialog } from '../src/renderer/src/components/context-room/ported/components/MoveDocumentToRoomDialog'
+
+const document: RoomDocument = {
+  id: 'doc-1',
+  roomId: 'room-a',
+  title: '季度复盘',
+  contentJson: { type: 'doc', content: [] },
+  contentSchemaVersion: 1,
+  version: 3,
+  status: 'active',
+  origin: 'native',
+  activeTransactionId: null,
+  createdAt: '2026-01-01T00:00:00.000Z',
+  updatedAt: '2026-01-02T00:00:00.000Z',
+}
+
+const moved: MovedRoomDocument = {
+  documentId: 'doc-1',
+  fromRoomId: 'room-a',
+  toRoomId: 'room-b',
+  title: '季度复盘',
+  document: { ...document, roomId: 'room-b' },
+}
+
+function installWindow() {
+  const list = vi.fn().mockResolvedValue({
+    rooms: [
+      { id: 'room-a', title: '甲房', kind: '项目' },
+      { id: 'room-b', title: '乙房', kind: '主题' },
+      { id: 'room-c', title: '丙房', kind: '议题' },
+    ],
+    deletedRooms: [],
+    updatedAt: null,
+  })
+  const move = vi.fn().mockResolvedValue(moved)
+  const moveMany = vi.fn().mockResolvedValue({ items: [moved] })
+  ;(globalThis as { window?: unknown }).window = {
+    nxcore: { contextRooms: { list }, documents: { move, moveMany } },
+    localStorage: {
+      store: new Map<string, string>(),
+      getItem(key: string) {
+        return this.store.get(key) ?? null
+      },
+      setItem(key: string, value: string) {
+        this.store.set(key, value)
+      },
+    },
+    dispatchEvent: vi.fn(),
+  }
+  return { list, move, moveMany }
+}
+
+function findButtonWithText(renderer: TestRenderer.ReactTestRenderer, text: string) {
+  return renderer.root.findAllByType('button').find((node) =>
+    node.findAllByType('b').some((label) => label.children.join('') === text)
+    || node.children.some((child) => typeof child === 'string' && child.includes(text)))
+}
+
+describe('移动到其他 Room 弹层', () => {
+  beforeEach(() => {
+    installWindow()
+  })
+
+  afterEach(() => {
+    delete (globalThis as { window?: unknown }).window
+  })
+
+  it('列出可迁入 Room、排除源房，选中后按目标房移动', async () => {
+    const api = installWindow()
+    const onMoved = vi.fn()
+    const onOpenChange = vi.fn()
+    let renderer: TestRenderer.ReactTestRenderer | null = null
+    await act(async () => {
+      renderer = TestRenderer.create(
+        <MoveDocumentToRoomDialog
+          open
+          onOpenChange={onOpenChange}
+          documents={[{ id: document.id, title: document.title, roomId: document.roomId }]}
+          onMoved={onMoved}
+        />,
+      )
+    })
+
+    const buttons = renderer!.root.findAllByType('button')
+    const target = buttons.find((node) =>
+      node.findAllByType('b').some((label) => label.children.join('') === '乙房'))
+    expect(target).toBeTruthy()
+    // 源房不出现在候选清单里
+    expect(buttons.some((node) =>
+      node.findAllByType('b').some((label) => label.children.join('') === '甲房'))).toBe(false)
+
+    await act(async () => {
+      target!.props.onClick()
+    })
+
+    const confirm = renderer!.root.findAllByType('button')
+      .find((node) => node.props.className === 'context-room-primary')
+    expect(confirm).toBeTruthy()
+    await act(async () => {
+      confirm!.props.onClick()
+    })
+
+    expect(api.move).toHaveBeenCalledWith('doc-1', 'room-a', 'room-b')
+    expect(onMoved).toHaveBeenCalledWith([moved])
+    expect(onOpenChange).toHaveBeenCalledWith(false)
+  })
+
+  it('多个产物走批量移动接口', async () => {
+    const api = installWindow()
+    let renderer: TestRenderer.ReactTestRenderer | null = null
+    await act(async () => {
+      renderer = TestRenderer.create(
+        <MoveDocumentToRoomDialog
+          open
+          onOpenChange={() => {}}
+          documents={[
+            { id: 'doc-1', title: '一', roomId: 'room-a' },
+            { id: 'doc-2', title: '二', roomId: 'room-a' },
+          ]}
+        />,
+      )
+    })
+
+    const target = findButtonWithText(renderer!, '丙房')
+    await act(async () => {
+      target!.props.onClick()
+    })
+    const confirm = renderer!.root.findAllByType('button')
+      .find((node) => node.props.className === 'context-room-primary')
+    await act(async () => {
+      confirm!.props.onClick()
+    })
+
+    expect(api.moveMany).toHaveBeenCalledWith(['doc-1', 'doc-2'], 'room-a', 'room-c')
+    expect(api.move).not.toHaveBeenCalled()
+  })
+})
\ No newline at end of file
diff --git a/apps/desktop/tests/office-preview-registry.test.ts b/apps/desktop/tests/office-preview-registry.test.ts
index ab1af413..42b84581 100644
--- a/apps/desktop/tests/office-preview-registry.test.ts
+++ b/apps/desktop/tests/office-preview-registry.test.ts
@@ -136,6 +136,49 @@ describe('officePreviewKindFor', () => {
 })
 
 describe('OfficePreviewRegistry', () => {
+  // 论文排版桥是 genoffice 后加的导出：旧运行时（vendored 子模块还没升到含该导出的提交）
+  // 缺这个函数时，曾把整个 ensureRuntime 打挂，Room 内所有 Office 内嵌预览一起退回
+  // 「用系统默认应用打开」。这里钉住「缺能力只跳过桥、预览照开」。
+  describe('thesis panel bridge', () => {
+    type DocsWithThesisHook = { setDocsThesisPanelHook?: (hook: (wcId: number, action: unknown) => Promise<unknown>) => void }
+
+    afterEach(() => {
+      delete (runtime.docs as DocsWithThesisHook).setDocsThesisPanelHook
+    })
+
+    it('keeps Office previews working when the runtime has no thesis hook', async () => {
+      const window = makeWindow()
+      registry.setThesisPanelBridge({
+        listCards: vi.fn(async () => []),
+        pickAndSet: vi.fn(async () => null),
+        removeCard: vi.fn(async () => undefined),
+        reformat: vi.fn(async () => null),
+      })
+
+      const descriptor = await registry.open(window, file('file-1', 'file-1.docx'))
+
+      expect(descriptor).toMatchObject({ id: 'file-1', kind: 'docx' })
+      expect(viewCalls).toHaveLength(1)
+    })
+
+    it('wires the hook when the runtime provides it', async () => {
+      const hook = vi.fn()
+      ;(runtime.docs as DocsWithThesisHook).setDocsThesisPanelHook = hook
+      const window = makeWindow()
+      registry.setThesisPanelBridge({
+        listCards: vi.fn(async () => []),
+        pickAndSet: vi.fn(async () => null),
+        removeCard: vi.fn(async () => undefined),
+        reformat: vi.fn(async () => null),
+      })
+
+      await registry.open(window, file('file-1', 'file-1.docx'))
+
+      expect(hook).toHaveBeenCalledTimes(1)
+      expect(typeof hook.mock.calls[0]![0]).toBe('function')
+    })
+  })
+
   let registry: OfficePreviewRegistry
 
   beforeEach(() => {
diff --git a/apps/desktop/tests/wiki-page-graph-fit.test.tsx b/apps/desktop/tests/wiki-page-graph-fit.test.tsx
new file mode 100644
index 00000000..332a85dd
--- /dev/null
+++ b/apps/desktop/tests/wiki-page-graph-fit.test.tsx
@@ -0,0 +1,100 @@
+/** @vitest-environment happy-dom */
+
+import TestRenderer, { act } from 'react-test-renderer'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+const fitViewCalls = { count: 0 }
+
+// node 环境没有 window/canvas/Worker：画布与力导向布局换成轻量替身，
+// 只验证「Wiki 页图谱工具条里的自适应按钮 → 画布 fitView」这条接线。
+vi.mock('../src/renderer/src/components/graph/PixiForceGraphCanvas', async () => {
+  const { forwardRef, useImperativeHandle } = await import('react')
+  return {
+    PixiForceGraphCanvas: forwardRef(function MockPixiForceGraphCanvas(
+      _props: Record<string, unknown>,
+      ref,
+    ) {
+      useImperativeHandle(ref, () => ({
+        fitView: () => {
+          fitViewCalls.count += 1
+        },
+      }), [])
+      return null
+    }),
+  }
+})
+
+vi.mock('../src/renderer/src/components/graph/useForceGraphLayout', () => ({
+  useForceGraphLayout: () => ({
+    controller: null,
+    positions: null,
+    revision: 0,
+    resize: vi.fn(),
+    cancelAutoFit: vi.fn(),
+    drag: vi.fn(),
+    release: vi.fn(),
+  }),
+}))
+
+vi.mock('@/state/toast', () => ({ showToast: vi.fn() }))
+
+import { WikiPage } from '../src/renderer/src/components/pages/WikiPage'
+
+function stubKnowledge() {
+  const knowledge = {
+    listWikis: vi.fn().mockResolvedValue({ items: [{ roomId: 'room-a', status: 'ready', pageCount: 1 }] }),
+    listRooms: vi.fn().mockResolvedValue({ items: [{ id: 'room-a', title: 'Room A', kind: '项目' }] }),
+    listWikiPages: vi.fn().mockResolvedValue({
+      status: 'ready',
+      items: [{ path: 'overview.md', title: '概览', description: '', updatedAt: '2026-08-25T00:00:00.000Z' }],
+    }),
+    readWikiPage: vi.fn().mockResolvedValue({ markdown: '# 概览' }),
+    getWikiGraph: vi.fn().mockResolvedValue({
+      nodes: [{ id: 'page-a', title: '页 A', path: 'a.md', inLinks: 0 }],
+      edges: [],
+    }),
+  }
+  ;(window as unknown as { nxcore?: unknown }).nxcore = { knowledge }
+  return knowledge
+}
+
+describe('Wiki 页图谱的「适应画布」按钮', () => {
+  afterEach(() => {
+    fitViewCalls.count = 0
+    delete (window as unknown as { nxcore?: unknown }).nxcore
+  })
+
+  // 曾经挂在画布右上角的自适应浮层会压住工具条上的「显示全部」；
+  // 现在统一收进工具条，一处一颗、互不重叠。
+  it('sits in the graph toolbar instead of floating over the canvas', async () => {
+    const knowledge = stubKnowledge()
+    let renderer: TestRenderer.ReactTestRenderer
+    await act(async () => {
+      renderer = TestRenderer.create(<WikiPage />)
+    })
+
+    const graphTab = renderer!.root.findAllByType('button')
+      .find((button) => button.props.role === 'tab' && button.children.includes('图谱'))!
+    await act(async () => {
+      graphTab.props.onClick()
+    })
+
+    expect(knowledge.getWikiGraph).toHaveBeenCalledWith('room-a')
+    // 浮层版不再出现（此前与「显示全部」重叠的就是它）。
+    expect(renderer!.root.findAllByProps({ className: 'context-room-graph-fit' })).toHaveLength(0)
+
+    const modeButton = renderer!.root.findAllByType('button')
+      .find((button) => button.props.className === 'wiki-graph-mode')!
+    expect(modeButton.children).toEqual(['显示全部'])
+
+    const fitButton = renderer!.root.findByProps({ className: 'wiki-graph-mode wiki-graph-fit' })
+    expect(fitButton.props['aria-label']).toBe('自适应图谱：缩放并居中')
+
+    await act(async () => {
+      fitButton.props.onClick()
+    })
+    expect(fitViewCalls.count).toBe(1)
+
+    renderer!.unmount()
+  })
+})
\ No newline at end of file
diff --git a/apps/gateway/src/modules/agent/status-service.ts b/apps/gateway/src/modules/agent/status-service.ts
index 61c5cbd9..e5b02526 100644
--- a/apps/gateway/src/modules/agent/status-service.ts
+++ b/apps/gateway/src/modules/agent/status-service.ts
@@ -1,6 +1,5 @@
 import type {
   AgentStatusSnapshot,
-  AgentWorkspaceRunStatus,
   AgentWorkspaceRunSummary,
   AgentWorkspaceState,
   AgentWorkspaceStatus,
@@ -9,8 +8,6 @@ import type {
 import type { SubagentOrchestrator } from "../subagents/orchestrator.js";
 import type { AgentResolver, AgentRuntimeRunActivity } from "./resolver.js";
 
-const TERMINAL_ERRORS = new Set<AgentWorkspaceRunStatus>(["failed", "interrupted", "timed_out"]);
-
 function runtimeRun(run: AgentRuntimeRunActivity | null): AgentWorkspaceRunSummary | null {
   if (!run) return null;
   return {
@@ -35,9 +32,14 @@ function invocationRun(invocation: SubagentInvocation | null): AgentWorkspaceRun
   };
 }
 
-function state(activeRunCount: number, lastStatus: AgentWorkspaceRunStatus | null): AgentWorkspaceState {
+/**
+ * 运行一结束就回海：办公室只区分「运行中」和「待命」。
+ * 失败的运行已经落进「最近活动」（lastRun.status 仍是 failed），
+ * 不能再把 Agent 长期挂在 error 上、让鹈鹕一直停在路肩。
+ */
+function state(activeRunCount: number): AgentWorkspaceState {
   if (activeRunCount > 0) return "running";
-  return lastStatus && TERMINAL_ERRORS.has(lastStatus) ? "error" : "idle";
+  return "idle";
 }
 
 function runTimestamp(run: AgentWorkspaceRunSummary | null): string | null {
@@ -67,7 +69,7 @@ export class AgentStatusService {
           name: definition.name,
           description: definition.description,
           kind: definition.kind,
-          state: state(activeInvocations.length, lastRun?.status ?? null),
+          state: state(activeInvocations.length),
           activeRunCount: activeInvocations.length,
           workspace: {
             id: `agent://${definition.id}`,
@@ -88,7 +90,7 @@ export class AgentStatusService {
         name: definition.name,
         description: definition.description,
         kind: definition.kind,
-        state: state(activity.activeRuns.length, lastRun?.status ?? null),
+        state: state(activity.activeRuns.length),
         activeRunCount: activity.activeRuns.length,
         workspace: {
           id: `agent://${definition.id}`,
diff --git a/apps/gateway/src/modules/documents/core/index.ts b/apps/gateway/src/modules/documents/core/index.ts
index 6f1d53cb..ada0958f 100644
--- a/apps/gateway/src/modules/documents/core/index.ts
+++ b/apps/gateway/src/modules/documents/core/index.ts
@@ -1,6 +1,7 @@
 export * from "./commit-service.js";
 export * from "./content-engine.js";
 export * from "./lifecycle-service.js";
+export * from "./move-service.js";
 export * from "./query-service.js";
 export * from "./repository.js";
 export * from "./yjs-history-service.js";
diff --git a/apps/gateway/src/modules/documents/core/move-service.ts b/apps/gateway/src/modules/documents/core/move-service.ts
new file mode 100644
index 00000000..471346c6
--- /dev/null
+++ b/apps/gateway/src/modules/documents/core/move-service.ts
@@ -0,0 +1,162 @@
+import type { MovedRoomDocument } from "@nxcore/agent-contract";
+import { and, eq } from "drizzle-orm";
+import type { GatewayDatabase } from "../../../infrastructure/database/client.js";
+import {
+  contextRooms,
+  documentRoomImports,
+  documents,
+  externalDocumentBindings,
+  roomDocumentLinks,
+} from "../../../infrastructure/database/schema.js";
+import { DocumentServiceError } from "../errors.js";
+import { toRoomDocument } from "./repository.js";
+
+/**
+ * Room 产物跨 Room 移动（restructure：产物放错房/主题更适合其它房）。
+ *
+ * 归属的唯一事实源是 room_doc_links：移动 = 删源房链接 + 建目标房链接。
+ * 文档正文、版本、评论、块引用都跟文档 id 走，不做副本；这样原房清单立即
+ * 少一条、目标房清单立即多一条，且文档 id 保持不变（深链/引用不失效）。
+ *
+ * 知识侧投影（room_source_memberships / room_entity_mentions /
+ * room_entity_facts / route_decisions）与搜索索引由 knowledge 模块的
+ * document.moved 钩子同步，本服务不直接写知识表。
+ */
+export class DocumentRoomMoveService {
+  constructor(private readonly db: GatewayDatabase) {}
+
+  move(documentId: string, fromRoomId: string, targetRoomId: string): MovedRoomDocument {
+    const from = fromRoomId.trim();
+    const to = targetRoomId.trim();
+    if (!from || !to) throw new DocumentServiceError("INVALID_ROOM", "Room id is required", 400);
+    if (from === to) {
+      throw new DocumentServiceError("SAME_ROOM", "Document already belongs to this Room", 409);
+    }
+    this.requireActiveRoom(to);
+
+    const moved = this.db.transaction((tx) => {
+      const row = tx.select().from(documents).where(eq(documents.id, documentId)).get();
+      if (!row) throw new DocumentServiceError("NOT_FOUND", "Document not found", 404);
+      if (row.deletedAt) {
+        throw new DocumentServiceError(
+          "DOCUMENT_TRASHED",
+          "Restore the document from trash before moving it",
+          409,
+        );
+      }
+      if (row.activeTransactionId) {
+        throw new DocumentServiceError("DOCUMENT_BUSY", "Agent is writing this document", 409);
+      }
+      const sourceLink = tx.select().from(roomDocumentLinks)
+        .where(and(eq(roomDocumentLinks.roomId, from), eq(roomDocumentLinks.documentId, documentId)))
+        .get();
+      if (!sourceLink) {
+        throw new DocumentServiceError(
+          "ROOM_MISMATCH",
+          "Document does not belong to the source Room",
+          409,
+        );
+      }
+
+      const now = new Date();
+      const targetLink = tx.select().from(roomDocumentLinks)
+        .where(and(eq(roomDocumentLinks.roomId, to), eq(roomDocumentLinks.documentId, documentId)))
+        .get();
+      tx.delete(roomDocumentLinks)
+        .where(and(eq(roomDocumentLinks.roomId, from), eq(roomDocumentLinks.documentId, documentId)))
+        .run();
+      if (targetLink) {
+        // 目标房已有链接（多房归属）：源链接摘除即可，目标链接刷新为最近挂载。
+        tx.update(roomDocumentLinks).set({ linkedAt: now })
+          .where(and(eq(roomDocumentLinks.roomId, to), eq(roomDocumentLinks.documentId, documentId)))
+          .run();
+      } else {
+        tx.insert(roomDocumentLinks).values({
+          roomId: to,
+          documentId,
+          folderId: null,
+          linkedAt: now,
+        }).run();
+      }
+      // 导入台账 / 外部投影绑定跟随归属，避免「移动后仍按源房同步」。
+      tx.update(documentRoomImports).set({ roomId: to })
+        .where(and(eq(documentRoomImports.roomId, from), eq(documentRoomImports.documentId, documentId)))
+        .run();
+      tx.update(externalDocumentBindings).set({ roomId: to, updatedAt: now })
+        .where(and(eq(externalDocumentBindings.roomId, from), eq(externalDocumentBindings.documentId, documentId)))
+        .run();
+
+      return {
+        documentId,
+        fromRoomId: from,
+        toRoomId: to,
+        title: row.title,
+        document: toRoomDocument(row, to),
+      } satisfies MovedRoomDocument;
+    });
+    return moved;
+  }
+
+  /**
+   * 批量移动：先整批预检（文档存在、未入回收站、无进行中的 Agent 写入、
+   * 确实属于源房、目标房有效），再逐文档独立事务搬运。预检把「一半成功一半
+   * 失败」压缩到数据库异常的极小概率；真遇到异常时已完成的项保持移动结果
+   * （事件已广播，两侧清单自洽），调用方按错误提示重试剩余项即可。
+   */
+  moveMany(documentIds: string[], fromRoomId: string, targetRoomId: string): MovedRoomDocument[] {
+    const unique = [...new Set(documentIds.map((id) => id.trim()).filter(Boolean))];
+    if (unique.length === 0) {
+      throw new DocumentServiceError("INVALID_DOCUMENT_IDS", "Select at least one document", 400);
+    }
+    if (unique.length > 100) {
+      throw new DocumentServiceError("TOO_MANY_DOCUMENTS", "Move at most 100 documents at once", 400);
+    }
+    const from = fromRoomId.trim();
+    const to = targetRoomId.trim();
+    if (!from || !to) throw new DocumentServiceError("INVALID_ROOM", "Room id is required", 400);
+    if (from === to) {
+      throw new DocumentServiceError("SAME_ROOM", "Document already belongs to this Room", 409);
+    }
+    this.requireActiveRoom(to);
+    for (const documentId of unique) this.assertMovable(documentId, from);
+    return unique.map((documentId) => this.move(documentId, from, to));
+  }
+
+  /** 预检（只读）：批量入口在写入前一次性暴露可预期错误。 */
+  private assertMovable(documentId: string, fromRoomId: string): void {
+    const row = this.db.select().from(documents).where(eq(documents.id, documentId)).get();
+    if (!row) throw new DocumentServiceError("NOT_FOUND", "Document not found", 404);
+    if (row.deletedAt) {
+      throw new DocumentServiceError(
+        "DOCUMENT_TRASHED",
+        "Restore the document from trash before moving it",
+        409,
+      );
+    }
+    if (row.activeTransactionId) {
+      throw new DocumentServiceError("DOCUMENT_BUSY", "Agent is writing this document", 409);
+    }
+    const sourceLink = this.db.select({ documentId: roomDocumentLinks.documentId })
+      .from(roomDocumentLinks)
+      .where(and(eq(roomDocumentLinks.roomId, fromRoomId), eq(roomDocumentLinks.documentId, documentId)))
+      .get();
+    if (!sourceLink) {
+      throw new DocumentServiceError(
+        "ROOM_MISMATCH",
+        "Document does not belong to the source Room",
+        409,
+      );
+    }
+  }
+
+  private requireActiveRoom(roomId: string): void {
+    const room = this.db.select({
+      id: contextRooms.id,
+      lifecycle: contextRooms.lifecycle,
+      deletedAt: contextRooms.deletedAt,
+    }).from(contextRooms).where(eq(contextRooms.id, roomId)).get();
+    if (!room || room.deletedAt || room.lifecycle !== "active") {
+      throw new DocumentServiceError("TARGET_ROOM_NOT_FOUND", "Target Room not found", 404);
+    }
+  }
+}
diff --git a/apps/gateway/src/modules/documents/routes.ts b/apps/gateway/src/modules/documents/routes.ts
index c223ad95..df3e6f44 100644
--- a/apps/gateway/src/modules/documents/routes.ts
+++ b/apps/gateway/src/modules/documents/routes.ts
@@ -1,4 +1,5 @@
 import type { FastifyPluginAsyncTypebox } from "@fastify/type-provider-typebox";
+import type { MoveRoomDocumentInput } from "@nxcore/agent-contract";
 import { Type } from "@sinclair/typebox";
 import { agentDocumentMarkdown } from "./agent-markdown.js";
 import { documentBodyContent } from "./content-model.js";
@@ -6,6 +7,10 @@ import { DocumentServiceError, type DocumentService } from "./service.js";
 import type { DocumentIndexBackfillReadTrigger } from "./index-backfill/read-trigger.js";
 import type { TaskFolderService } from "./task-folders.js";
 const IdParams = Type.Object({ id: Type.String({ minLength: 1, maxLength: 128 }) });
+const MoveRoomBody = Type.Object({
+  fromRoomId: Type.String({ minLength: 1, maxLength: 128 }),
+  roomId: Type.String({ minLength: 1, maxLength: 128 }),
+});
 const JsonDocument = Type.Object({ type: Type.Literal("doc") }, { additionalProperties: true });
 const BlockReference = Type.Object({
   roomId: Type.String({ minLength: 1, maxLength: 128 }),
@@ -304,6 +309,59 @@ export function documentRoutes(
       },
     );
 
+    // 产物移动到其它 Room：归属切换 + 两房清单事件 + 知识侧索引/记忆投影同步。
+    app.post(
+      "/v1/documents/:id/move",
+      {
+        schema: {
+          tags: ["documents"],
+          params: IdParams,
+          body: MoveRoomBody,
+        },
+      },
+      async (request, reply) => {
+        try {
+          return await service.moveToRoom(request.params.id, request.body as MoveRoomDocumentInput);
+        } catch (error) {
+          if (error instanceof DocumentServiceError) {
+            return reply.code(error.statusCode).send(errorPayload(error));
+          }
+          throw error;
+        }
+      },
+    );
+
+    // 多选批量移动：同源房的一批文档迁入同一目标 Room。
+    app.post(
+      "/v1/documents/move",
+      {
+        schema: {
+          tags: ["documents"],
+          body: Type.Object({
+            documentIds: Type.Array(Type.String({ minLength: 1, maxLength: 128 }), {
+              minItems: 1,
+              maxItems: 100,
+            }),
+            fromRoomId: Type.String({ minLength: 1, maxLength: 128 }),
+            roomId: Type.String({ minLength: 1, maxLength: 128 }),
+          }),
+        },
+      },
+      async (request, reply) => {
+        try {
+          return await service.moveManyToRoom(request.body.documentIds, {
+            fromRoomId: request.body.fromRoomId,
+            roomId: request.body.roomId,
+          });
+        } catch (error) {
+          if (error instanceof DocumentServiceError) {
+            return reply.code(error.statusCode).send(errorPayload(error));
+          }
+          throw error;
+        }
+      },
+    );
+
     app.post(
       "/v1/documents/import",
       {
diff --git a/apps/gateway/src/modules/documents/service.ts b/apps/gateway/src/modules/documents/service.ts
index a7f63b2f..fb568a9f 100644
--- a/apps/gateway/src/modules/documents/service.ts
+++ b/apps/gateway/src/modules/documents/service.ts
@@ -12,6 +12,9 @@ import type {
   DocumentVersionSnapshot,
   DocumentDiffResult,
   ImportRoomDocumentInput,
+  MoveRoomDocumentInput,
+  MoveRoomDocumentsResult,
+  MovedRoomDocument,
   ResolveDocumentBlockReferencesInput,
   RoomDocument,
   SaveRoomDocumentInput,
@@ -42,6 +45,7 @@ import {
   DocumentLifecycleService,
   DocumentQueryService,
   DocumentRepository,
+  DocumentRoomMoveService,
   YjsHistoryService,
   type AtomicDocumentCreateInput,
   type AtomicDocumentCommitInput,
@@ -236,6 +240,7 @@ export class DocumentService {
   private readonly commitService: DocumentCommitService;
   private readonly queryService: DocumentQueryService;
   private readonly lifecycleService: DocumentLifecycleService;
+  private readonly moveService: DocumentRoomMoveService;
   private readonly yjsHistory: YjsHistoryService;
 
   /**
@@ -253,6 +258,14 @@ export class DocumentService {
    */
   resolveDocWriterDraft: DocWriterDraftResolver | null = null;
 
+  /**
+   * Room 产物移动完成后的知识侧同步钩子（create-server 装配注入）：
+   * 迁移 room_source_memberships / room_entity_mentions / room_entity_facts /
+   * route_decisions 投影，重排搜索索引并触发两房概览再生成。
+   * documents 模块不直接依赖 knowledge。
+   */
+  onDocumentMoved: ((moved: MovedRoomDocument) => void) | null = null;
+
   constructor(
     private readonly db: GatewayDatabase,
     readonly broker: DocumentEventBroker,
@@ -268,6 +281,7 @@ export class DocumentService {
     this.yjsHistory = new YjsHistoryService();
     this.commitService = new DocumentCommitService(db, this.repository, this.contentEngine, {}, this.yjsHistory);
     this.queryService = new DocumentQueryService(db, this.repository, this.contentEngine);
+    this.moveService = new DocumentRoomMoveService(db);
     this.lifecycleService = new DocumentLifecycleService(db, this.repository, {
       trashed: (document) => this.publish(
         document.roomId,
@@ -298,6 +312,48 @@ export class DocumentService {
     return this.queryService.list(roomId, trashed, origin);
   }
 
+  /**
+   * 单个产物移动到其它 Room：改属归属链接后，向源房广播 document.moved
+   * （清单摘除）与向目标房广播 document.changed（清单新增），再交知识侧
+   * 钩子同步索引与记忆投影。
+   */
+  moveToRoom(documentId: string, input: MoveRoomDocumentInput): Promise<MovedRoomDocument> {
+    return this.queue.enqueue(() => {
+      const moved = this.moveService.move(documentId, input.fromRoomId, input.roomId);
+      this.publishMoved(moved);
+      return moved;
+    });
+  }
+
+  /** 批量移动（同源房多选 → 同一目标房）：逐条发事件，失败整体回滚到调用方提示。 */
+  moveManyToRoom(
+    documentIds: string[],
+    input: MoveRoomDocumentInput,
+  ): Promise<MoveRoomDocumentsResult> {
+    return this.queue.enqueue(() => {
+      const items = this.moveService.moveMany(documentIds, input.fromRoomId, input.roomId);
+      for (const moved of items) this.publishMoved(moved);
+      return { items };
+    });
+  }
+
+  private publishMoved(moved: MovedRoomDocument): void {
+    this.publish(moved.fromRoomId, moved.documentId, null, "document.moved", {
+      documentId: moved.documentId,
+      fromRoomId: moved.fromRoomId,
+      toRoomId: moved.toRoomId,
+      title: moved.title,
+    });
+    this.publish(moved.toRoomId, moved.documentId, null, "document.changed", {
+      document: moved.document,
+    });
+    try {
+      this.onDocumentMoved?.(moved);
+    } catch {
+      // 知识侧同步失败不回滚移动（清单归属已正确），索引在下次重排时自愈。
+    }
+  }
+
   get(documentId: string): RoomDocument | null {
     return this.queryService.get(documentId);
   }
diff --git a/apps/gateway/src/modules/knowledge/service.ts b/apps/gateway/src/modules/knowledge/service.ts
index a2c4af1a..6f9d5450 100644
--- a/apps/gateway/src/modules/knowledge/service.ts
+++ b/apps/gateway/src/modules/knowledge/service.ts
@@ -14,6 +14,7 @@ import {
   ingestEvents,
   jobs,
   roomDocumentLinks,
+  roomEntityFacts,
   roomEntityMentions,
   roomSourceMemberships,
   roomWikis,
@@ -1042,6 +1043,141 @@ export class KnowledgeService {
     this.pendingSchedules.set(document.id, { timer, version: document.version });
   }
 
+  /**
+   * 产物跨 Room 移动后的知识侧同步（documents 模块 document.moved 钩子）：
+   * 迁移来源成员关系、实体提及与事实投影，改写历史路由决策指向目标房（避免
+   * 启动回填把旧房归属复活），重算 Room 关系图、重排搜索索引并触发两房概览再生。
+   * 只做投影搬运，不复制文档本体。
+   */
+  handleDocumentMoved(input: { documentId: string; fromRoomId: string; toRoomId: string }): void {
+    const { documentId, fromRoomId, toRoomId } = input;
+    if (!documentId || !fromRoomId || !toRoomId || fromRoomId === toRoomId) return;
+    let movedMemberships = 0;
+    try {
+      this.db.transaction((tx) => {
+        const now = new Date();
+        // 1) 来源成员关系：目标已有则折叠版本/权重，否则整行改挂。
+        const sourceMemberships = tx.select().from(roomSourceMemberships).where(and(
+          eq(roomSourceMemberships.roomId, fromRoomId),
+          eq(roomSourceMemberships.sourceKind, "everroom-doc"),
+          eq(roomSourceMemberships.sourceId, documentId),
+        )).all();
+        const targetMembership = tx.select().from(roomSourceMemberships).where(and(
+          eq(roomSourceMemberships.roomId, toRoomId),
+          eq(roomSourceMemberships.sourceKind, "everroom-doc"),
+          eq(roomSourceMemberships.sourceId, documentId),
+        )).get();
+        for (const row of sourceMemberships) {
+          movedMemberships += 1;
+          if (targetMembership) {
+            tx.update(roomSourceMemberships).set({
+              sourceVersion: Math.max(targetMembership.sourceVersion, row.sourceVersion),
+              sourceTitle: row.sourceTitle ?? targetMembership.sourceTitle,
+              effectiveWeight: Math.max(targetMembership.effectiveWeight, row.effectiveWeight),
+              trusted: targetMembership.trusted || row.trusted,
+              entityIndexed: targetMembership.entityIndexed || row.entityIndexed,
+              updatedAt: now,
+            }).where(eq(roomSourceMemberships.id, targetMembership.id)).run();
+            tx.delete(roomSourceMemberships).where(eq(roomSourceMemberships.id, row.id)).run();
+          } else {
+            tx.update(roomSourceMemberships).set({ roomId: toRoomId, updatedAt: now })
+              .where(eq(roomSourceMemberships.id, row.id)).run();
+          }
+        }
+
+        // 2) 实体提及：按 (room, entity, source) 唯一键折叠。
+        for (const mention of tx.select().from(roomEntityMentions).where(and(
+          eq(roomEntityMentions.roomId, fromRoomId),
+          eq(roomEntityMentions.sourceKind, "everroom-doc"),
+          eq(roomEntityMentions.sourceId, documentId),
+        )).all()) {
+          const existing = tx.select().from(roomEntityMentions).where(and(
+            eq(roomEntityMentions.roomId, toRoomId),
+            eq(roomEntityMentions.entityId, mention.entityId),
+            eq(roomEntityMentions.sourceKind, "everroom-doc"),
+            eq(roomEntityMentions.sourceId, documentId),
+          )).get();
+          if (existing) {
+            tx.update(roomEntityMentions).set({
+              sourceVersion: Math.max(existing.sourceVersion, mention.sourceVersion),
+              salience: Math.max(existing.salience, mention.salience),
+              relevanceFactor: Math.max(existing.relevanceFactor, mention.relevanceFactor),
+              trusted: existing.trusted || mention.trusted,
+              evidence: existing.evidence ?? mention.evidence,
+              updatedAt: now,
+            }).where(eq(roomEntityMentions.id, existing.id)).run();
+            tx.delete(roomEntityMentions).where(eq(roomEntityMentions.id, mention.id)).run();
+          } else {
+            tx.update(roomEntityMentions).set({ roomId: toRoomId, updatedAt: now })
+              .where(eq(roomEntityMentions.id, mention.id)).run();
+          }
+        }
+
+        // 3) 事实记忆：按 (room, source, factId) 唯一键折叠。
+        for (const fact of tx.select().from(roomEntityFacts).where(and(
+          eq(roomEntityFacts.roomId, fromRoomId),
+          eq(roomEntityFacts.sourceKind, "everroom-doc"),
+          eq(roomEntityFacts.sourceId, documentId),
+        )).all()) {
+          const existing = tx.select().from(roomEntityFacts).where(and(
+            eq(roomEntityFacts.roomId, toRoomId),
+            eq(roomEntityFacts.sourceKind, "everroom-doc"),
+            eq(roomEntityFacts.sourceId, documentId),
+            eq(roomEntityFacts.factId, fact.factId),
+          )).get();
+          if (existing) {
+            tx.update(roomEntityFacts).set({
+              sourceVersion: Math.max(existing.sourceVersion, fact.sourceVersion),
+              updatedAt: now,
+            }).where(eq(roomEntityFacts.id, existing.id)).run();
+            tx.delete(roomEntityFacts).where(eq(roomEntityFacts.id, fact.id)).run();
+          } else {
+            tx.update(roomEntityFacts).set({ roomId: toRoomId, updatedAt: now })
+              .where(eq(roomEntityFacts.id, fact.id)).run();
+          }
+        }
+
+        // 4) 历史路由决策改指目标房：启动/实体合并后的 rebuildFromFacts 只认
+        //    最新决策，若仍记旧房会把已移动的文档重新投影回旧房（记忆复活）。
+        for (const decision of tx.select().from(routeDecisions).where(and(
+          eq(routeDecisions.sourceKind, "everroom-doc"),
+          eq(routeDecisions.sourceId, documentId),
+        )).all()) {
+          if (decision.status === "reverted") continue;
+          const evidence = decision.evidence && typeof decision.evidence === "object"
+            ? { ...(decision.evidence as Record<string, unknown>) }
+            : {};
+          evidence.rooms = [{ roomId: toRoomId }];
+          evidence.linkOnlyRooms = [];
+          tx.update(routeDecisions).set({
+            primaryRoomId: toRoomId,
+            linkedRoomIds: [],
+            evidence,
+            updatedAt: now,
+          }).where(eq(routeDecisions.id, decision.id)).run();
+        }
+      });
+    } catch (error) {
+      this.logger.warn(
+        { event: "knowledge.document-move.failed", documentId, fromRoomId, toRoomId, error },
+        "document move knowledge sync failed",
+      );
+    }
+
+    try {
+      if (movedMemberships === 0) this.relationRegistry.rebuildFromFacts();
+      else this.relationRegistry.recomputeAll();
+    } catch (error) {
+      this.logger.warn({ event: "knowledge.document-move.relations", documentId, error }, "relation recompute failed");
+    }
+    enqueueSearchIndex(this.db, { itemType: "document", refId: documentId, priority: "high" });
+    this.roomOverviewRefreshTrigger?.([fromRoomId, toRoomId], "document-moved");
+    this.logger.info(
+      { event: "knowledge.document-moved", documentId, fromRoomId, toRoomId, movedMemberships },
+      "document moved between rooms",
+    );
+  }
+
   /** 手动"立即沉淀"入口（REST route/manual）：绕过防抖直接入队。 */
   routeDocumentNow(documentId: string): { queued: boolean; roomId: string | null } {
     const target = this.getDocumentWithRoom(documentId);
diff --git a/apps/gateway/src/server/create-server.ts b/apps/gateway/src/server/create-server.ts
index 077662a8..17f07637 100644
--- a/apps/gateway/src/server/create-server.ts
+++ b/apps/gateway/src/server/create-server.ts
@@ -799,6 +799,15 @@ export async function createServer(config: GatewayConfig, overrides: ServerOverr
   });
   contextRoomService.setDuplicateService(roomDuplicateService);
   knowledgeService.setRoomDuplicateIndexTrigger(() => roomDuplicateService.requestRebuild());
+  // 产物跨 Room 移动：documents 只改归属链接并广播事件，知识侧投影（成员关系/
+  // 实体提及/事实/路由决策）、搜索索引与两房概览在此跟随同步。
+  documentService.onDocumentMoved = (moved) => {
+    knowledgeService.handleDocumentMoved({
+      documentId: moved.documentId,
+      fromRoomId: moved.fromRoomId,
+      toRoomId: moved.toRoomId,
+    });
+  };
   // 知识涌现（思路板块）：漫步的四源投影，只读不写回基础图谱。
   // 聚焦模式由 RouteMindmapService（写作路线导图）承接。
   const emergenceService = new EmergenceService({
diff --git a/apps/gateway/tests/agent-status-service.test.ts b/apps/gateway/tests/agent-status-service.test.ts
new file mode 100644
index 00000000..bb0166bd
--- /dev/null
+++ b/apps/gateway/tests/agent-status-service.test.ts
@@ -0,0 +1,62 @@
+import { describe, expect, it } from "vitest";
+
+import type { AgentRuntimeActivity } from "../src/modules/agent/resolver.js";
+import type { AgentResolver } from "../src/modules/agent/resolver.js";
+import { AgentStatusService } from "../src/modules/agent/status-service.js";
+import type { SubagentOrchestrator } from "../src/modules/subagents/orchestrator.js";
+
+const FAILED_RUN = {
+  id: "run-1",
+  task: "整理今天的会议记录",
+  pageLabel: "办公室",
+  status: "failed" as const,
+  startedAt: "2026-08-25T01:00:00.000Z",
+  completedAt: "2026-08-25T01:02:00.000Z",
+};
+
+function serviceWith(activity: AgentRuntimeActivity): AgentStatusService {
+  const resolver = {
+    list: () => [{ id: "main", name: "主 Agent", description: "整理资料", kind: "builtin", configDirectory: "/tmp/main" }],
+    getActivity: () => activity,
+  } as unknown as AgentResolver;
+  const subagents = {
+    listInvocations: () => [],
+    listDefinitions: () => [],
+  } as unknown as SubagentOrchestrator;
+  return new AgentStatusService(resolver, subagents);
+}
+
+describe("AgentStatusService 办公室骑手状态", () => {
+  // 失败一次不该让鹈鹕无限期停在路肩：运行一结束就回海，失败只留在「最近活动」里。
+  it("运行失败后 Agent 回海待命，但最近活动仍保留失败记录", () => {
+    const snapshot = serviceWith({ activeRuns: [], lastRun: FAILED_RUN }).snapshot();
+    const [agent] = snapshot.agents;
+
+    expect(agent!.state).toBe("idle");
+    expect(snapshot.summary.idle).toBe(1);
+    expect(snapshot.summary.error).toBe(0);
+    // 记录层面仍是失败：状态文案、时间戳都给得到。
+    expect(agent!.lastRun?.status).toBe("failed");
+    expect(agent!.currentRun).toBeNull();
+    expect(agent!.updatedAt).toBe("2026-08-25T01:02:00.000Z");
+  });
+
+  it("仍在跑的运行照旧是 running", () => {
+    const snapshot = serviceWith({
+      activeRuns: [{ ...FAILED_RUN, status: "running", completedAt: null }],
+      lastRun: FAILED_RUN,
+    }).snapshot();
+    const [agent] = snapshot.agents;
+
+    expect(agent!.state).toBe("running");
+    expect(agent!.activeRunCount).toBe(1);
+    expect(snapshot.summary.running).toBe(1);
+    expect(snapshot.summary.idle).toBe(0);
+  });
+
+  it("没有运行历史时也是待命", () => {
+    const snapshot = serviceWith({ activeRuns: [], lastRun: null }).snapshot();
+    expect(snapshot.agents[0]!.state).toBe("idle");
+    expect(snapshot.agents[0]!.updatedAt).toBeNull();
+  });
+});
diff --git a/apps/gateway/tests/document-move.test.ts b/apps/gateway/tests/document-move.test.ts
new file mode 100644
index 00000000..009ad53a
--- /dev/null
+++ b/apps/gateway/tests/document-move.test.ts
@@ -0,0 +1,287 @@
+import { mkdtemp, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { afterEach, describe, expect, it } from 'vitest'
+import { and, eq } from 'drizzle-orm'
+import type { DocumentEvent, TiptapJsonContent } from '@nxcore/agent-contract'
+import { createDatabase } from '../src/infrastructure/database/client.js'
+import {
+  contextRooms,
+  jobs,
+  roomDocumentLinks,
+  roomEntityFacts,
+  roomEntityMentions,
+  rooms,
+  roomSourceMemberships,
+  routeDecisions,
+  documents,
+} from '../src/infrastructure/database/schema.js'
+import Fastify from 'fastify'
+import { DocumentEventBroker } from '../src/modules/documents/event-broker.js'
+import { documentRoutes } from '../src/modules/documents/routes.js'
+import { DocumentService } from '../src/modules/documents/service.js'
+import { KnowledgeService, type KnowledgeServiceConfig } from '../src/modules/knowledge/service.js'
+
+const temporaryDirectories: string[] = []
+const disposables: Array<() => void | Promise<void>> = []
+
+const contentJson: TiptapJsonContent = {
+  type: 'doc',
+  content: [{ type: 'paragraph', content: [{ type: 'text', text: '季度复盘草稿' }] }],
+}
+
+async function createHarness() {
+  const dataDir = await mkdtemp(join(tmpdir(), 'nxcore-document-move-test-'))
+  temporaryDirectories.push(dataDir)
+  const { db, sqlite } = createDatabase(join(dataDir, 'gateway.sqlite'), resolve('drizzle'))
+  for (const [id, title] of [['room-1', '旧房'], ['room-2', '新房']] as const) {
+    db.insert(contextRooms).values({ id, title, data: {}, position: 0 }).run()
+    db.insert(rooms).values({ id, title, kind: '议题' }).run()
+  }
+  const broker = new DocumentEventBroker()
+  const service = new DocumentService(db, broker)
+  const events: DocumentEvent[] = []
+  broker.listen((event) => events.push(event))
+  const knowledge = new KnowledgeService(db, {
+    baseUrl: '',
+    serviceId: 'everroom',
+    teamId: 'everroom',
+    dataDir,
+    roomWikisEnabled: false,
+    ingestDebounceMs: 600_000,
+    routerEnabled: false,
+    entityPromoteScore: 2.4,
+    entityPromoteSources: 3,
+    mergeAutoDice: 0.75,
+    mergeJudgeDice: 0.6,
+    llm: null,
+    embeddingLlm: null,
+    embeddingModel: '',
+  } satisfies KnowledgeServiceConfig, { info: () => undefined, warn: () => undefined, error: () => undefined })
+  service.onDocumentMoved = (moved) => knowledge.handleDocumentMoved({
+    documentId: moved.documentId,
+    fromRoomId: moved.fromRoomId,
+    toRoomId: moved.toRoomId,
+  })
+  disposables.push(() => {
+    sqlite.close()
+  })
+  return { db, service, events }
+}
+
+afterEach(async () => {
+  await Promise.all(disposables.splice(0).map((dispose) => dispose()))
+  await Promise.all(temporaryDirectories.splice(0).map((path) => rm(path, { recursive: true, force: true })))
+})
+
+describe('Room 产物移动到其他 Room', () => {
+  it('切换归属链接并广播两房事件：源房摘除、目标房新增', async () => {
+    const { db, service, events } = await createHarness()
+    const document = await service.import({
+      id: 'doc-move-1',
+      roomId: 'room-1',
+      title: '季度复盘',
+      contentJson,
+      origin: 'native',
+    })
+
+    const moved = await service.moveToRoom(document.id, { fromRoomId: 'room-1', roomId: 'room-2' })
+
+    expect(moved.fromRoomId).toBe('room-1')
+    expect(moved.toRoomId).toBe('room-2')
+    expect(moved.document.roomId).toBe('room-2')
+    expect(service.list('room-1').map((item) => item.id)).not.toContain(document.id)
+    expect(service.list('room-2').map((item) => item.id)).toContain(document.id)
+    expect(service.get(document.id)?.roomId).toBe('room-2')
+
+    const movedEvent = events.find((event) => event.type === 'document.moved')
+    expect(movedEvent?.roomId).toBe('room-1')
+    expect((movedEvent?.payload as { toRoomId?: string }).toRoomId).toBe('room-2')
+    const targetEvent = events.find((event) =>
+      event.type === 'document.changed' && event.roomId === 'room-2')
+    expect((targetEvent?.payload as { document?: { roomId?: string } }).document?.roomId).toBe('room-2')
+  })
+
+  it('同步迁移来源成员关系、实体提及、事实与路由决策', async () => {
+    const { db, service } = await createHarness()
+    const document = await service.import({
+      id: 'doc-move-2',
+      roomId: 'room-1',
+      title: '客户访谈纪要',
+      contentJson,
+      origin: 'native',
+    })
+    db.insert(roomSourceMemberships).values({
+      id: 'membership-1',
+      roomId: 'room-1',
+      sourceKind: 'everroom-doc',
+      sourceId: document.id,
+      sourceVersion: document.version,
+      evidenceGroupKey: 'everroom-doc:doc-move-2',
+      role: 'entry',
+      effectiveWeight: 1,
+      qualityLevel: 'high',
+      trusted: true,
+      entityIndexed: true,
+    }).run()
+    db.insert(roomEntityMentions).values({
+      id: 'mention-1',
+      roomId: 'room-1',
+      entityId: 'entity-customer',
+      sourceKind: 'everroom-doc',
+      sourceId: document.id,
+      sourceVersion: document.version,
+      evidenceGroupKey: 'everroom-doc:doc-move-2',
+      salience: 0.9,
+      relevanceFactor: 1,
+      qualityLevel: 'high',
+      trusted: true,
+    }).run()
+    db.insert(roomEntityFacts).values({
+      id: 'fact-1',
+      roomId: 'room-1',
+      factId: 'fact-customer-renewal',
+      content: '客户计划续约',
+      type: '属性',
+      sourceKind: 'everroom-doc',
+      sourceId: document.id,
+      sourceVersion: document.version,
+      evidenceGroupKey: 'everroom-doc:doc-move-2',
+    }).run()
+    db.insert(routeDecisions).values({
+      id: 'decision-1',
+      sourceKind: 'everroom-doc',
+      sourceId: document.id,
+      sourceVersion: document.version,
+      primaryRoomId: 'room-1',
+      confidence: 1,
+      decidedBy: 'entry',
+      evidence: { rooms: [{ roomId: 'room-1' }] },
+      status: 'auto',
+    }).run()
+
+    await service.moveToRoom(document.id, { fromRoomId: 'room-1', roomId: 'room-2' })
+
+    const memberships = db.select().from(roomSourceMemberships)
+      .where(and(
+        eq(roomSourceMemberships.sourceKind, 'everroom-doc'),
+        eq(roomSourceMemberships.sourceId, document.id),
+      )).all()
+    expect(memberships.map((row) => row.roomId)).toEqual(['room-2'])
+
+    const mentions = db.select().from(roomEntityMentions)
+      .where(and(
+        eq(roomEntityMentions.sourceKind, 'everroom-doc'),
+        eq(roomEntityMentions.sourceId, document.id),
+      )).all()
+    expect(mentions.map((row) => row.roomId)).toEqual(['room-2'])
+
+    const facts = db.select().from(roomEntityFacts)
+      .where(and(
+        eq(roomEntityFacts.sourceKind, 'everroom-doc'),
+        eq(roomEntityFacts.sourceId, document.id),
+      )).all()
+    expect(facts.map((row) => row.roomId)).toEqual(['room-2'])
+
+    const decision = db.select().from(routeDecisions).where(eq(routeDecisions.id, 'decision-1')).get()
+    expect(decision?.primaryRoomId).toBe('room-2')
+    expect(decision?.linkedRoomIds ?? []).toEqual([])
+    expect((decision?.evidence as { rooms?: Array<{ roomId: string }> }).rooms).toEqual([{ roomId: 'room-2' }])
+
+    // 搜索索引重排入队（worker 从新归属重建 search_index_rooms）。
+    const searchJobs = db.select().from(jobs).all()
+      .filter((job) => JSON.stringify(job.payload).includes(document.id))
+    expect(searchJobs.length).toBeGreaterThan(0)
+  })
+
+  it('拒绝同房移动、缺失目标房与回收站文档', async () => {
+    const { service } = await createHarness()
+    const document = await service.import({
+      id: 'doc-move-3',
+      roomId: 'room-1',
+      title: '待整理',
+      contentJson,
+      origin: 'native',
+    })
+
+    await expect(service.moveToRoom(document.id, { fromRoomId: 'room-1', roomId: 'room-1' }))
+      .rejects.toMatchObject({ code: 'SAME_ROOM' })
+    await expect(service.moveToRoom(document.id, { fromRoomId: 'room-1', roomId: 'room-missing' }))
+      .rejects.toMatchObject({ code: 'TARGET_ROOM_NOT_FOUND' })
+
+    await service.delete(document.id)
+    await expect(service.moveToRoom(document.id, { fromRoomId: 'room-1', roomId: 'room-2' }))
+      .rejects.toMatchObject({ code: 'DOCUMENT_TRASHED' })
+  })
+
+  it('批量预检发现未知文档时整批不执行', async () => {
+    const { service } = await createHarness()
+    await service.import({ id: 'doc-batch-ok', roomId: 'room-1', title: '可移动', contentJson, origin: 'native' })
+
+    await expect(service.moveManyToRoom(['doc-batch-ok', 'doc-batch-missing'], {
+      fromRoomId: 'room-1',
+      roomId: 'room-2',
+    })).rejects.toMatchObject({ code: 'NOT_FOUND' })
+
+    expect(service.list('room-1').map((item) => item.id)).toContain('doc-batch-ok')
+    expect(service.list('room-2')).toHaveLength(0)
+  })
+
+  it('批量移动同源房多个产物到同一目标房', async () => {
+    const { db, service } = await createHarness()
+    const ids = ['doc-batch-1', 'doc-batch-2']
+    for (const id of ids) {
+      await service.import({ id, roomId: 'room-1', title: id, contentJson, origin: 'native' })
+    }
+
+    const result = await service.moveManyToRoom(ids, { fromRoomId: 'room-1', roomId: 'room-2' })
+
+    expect(result.items.map((item) => item.documentId)).toEqual(ids)
+    const links = db.select().from(roomDocumentLinks).all()
+      .filter((link) => ids.includes(link.documentId))
+    expect(links.map((link) => link.roomId)).toEqual(['room-2', 'room-2'])
+    const stillOnSource = db.select().from(documents).all()
+      .filter((row) => ids.includes(row.id) && row.deletedAt !== null)
+    expect(stillOnSource).toHaveLength(0)
+  })
+})
+
+describe('POST /v1/documents/:id/move', () => {
+  it('按 REST 契约移动并返回移动后的文档；目标房缺失返回 404', async () => {
+    const { service } = await createHarness()
+    const document = await service.import({
+      id: 'doc-route-1',
+      roomId: 'room-1',
+      title: '路由移动',
+      contentJson,
+      origin: 'native',
+    })
+    const app = Fastify()
+    await app.register(documentRoutes(service))
+
+    const response = await app.inject({
+      method: 'POST',
+      url: `/v1/documents/${document.id}/move`,
+      payload: { fromRoomId: 'room-1', roomId: 'room-2' },
+    })
+    expect(response.statusCode).toBe(200)
+    expect(response.json().toRoomId).toBe('room-2')
+    expect(response.json().document.roomId).toBe('room-2')
+
+    const missing = await app.inject({
+      method: 'POST',
+      url: `/v1/documents/${document.id}/move`,
+      payload: { fromRoomId: 'room-2', roomId: 'room-missing' },
+    })
+    expect(missing.statusCode).toBe(404)
+
+    const batch = await app.inject({
+      method: 'POST',
+      url: '/v1/documents/move',
+      payload: { documentIds: [document.id], fromRoomId: 'room-2', roomId: 'room-1' },
+    })
+    expect(batch.statusCode).toBe(200)
+    expect(batch.json().items).toHaveLength(1)
+    await app.close()
+  })
+})
diff --git a/packages/agent-contract/src/index.ts b/packages/agent-contract/src/index.ts
index 153a16fd..d10bcb7c 100644
--- a/packages/agent-contract/src/index.ts
+++ b/packages/agent-contract/src/index.ts
@@ -1141,6 +1141,34 @@ export interface RoomDocument {
   updatedAt: string;
 }
 
+/** Room 产物跨 Room 移动（产物放错房或主题更适合其它房时的整理动作）。 */
+export interface MoveRoomDocumentInput {
+  /** 文档当前所属 Room（只移除这一条归属，文档在其它 Room 的链接不受影响）。 */
+  fromRoomId: string;
+  /** 目标 Room。 */
+  roomId: string;
+}
+
+/** 批量移动：一次选择多个产物迁往同一目标 Room。 */
+export interface MoveRoomDocumentsInput {
+  documentIds: string[];
+  fromRoomId: string;
+  roomId: string;
+}
+
+export interface MovedRoomDocument {
+  documentId: string;
+  fromRoomId: string;
+  toRoomId: string;
+  title: string;
+  /** 移动后的文档（roomId 已指向目标 Room）。 */
+  document: RoomDocument;
+}
+
+export interface MoveRoomDocumentsResult {
+  items: MovedRoomDocument[];
+}
+
 export interface RoomTaskFolder {
   id: string;
   roomId: string;
@@ -1511,6 +1539,7 @@ export type DocumentEventType =
   | "document.changed"
   | "document.operation.changed"
   | "document.deleted"
+  | "document.moved"
   | "document.comments.changed";
 
 export interface DocumentEvent<T = unknown> {
@@ -1529,6 +1558,17 @@ export interface DocumentEventFrame {
   event: DocumentEvent;
 }
 
+/**
+ * document.moved 的负载：事件发往源 Room（`roomId` = 源房），接收端据此从
+ * 源房清单摘除该文档；目标房另行收到 document.changed（携带移动后的文档）。
+ */
+export interface DocumentMovedPayload {
+  documentId: string;
+  fromRoomId: string;
+  toRoomId: string;
+  title: string;
+}
+
 export interface ImportRoomDocumentInput {
   id: string;
   roomId: string;