dsh-vscode-mode 0.26.0 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车，界面状态（页签/光标/侧栏/编辑 Tab/导航历史）镜像到 DSH home 跨重启恢复",
   "icon": "assets/icon.svg",
   "keywords": [

package/src/client/compatSummary.ts

@@ -13,6 +13,8 @@ export interface ClientCompatState {
   fileClaim: boolean
   claimWanted: boolean
   selected: string
+  officialMenus?: boolean
+  forge?: boolean
 }
 
 /**
@@ -73,5 +75,7 @@ export function clientSummary(state: ClientCompatState, version = ''): CompatAda
   if (state.fileClaim || (state.claimWanted && (official || officialExpected !== false))) {
     items.push({ name: '文件链接官方认领（dsh-resource://file）', active: state.fileClaim, note: state.fileClaim ? '聊天文件链接转发进单一编辑器页签' : '官方文件链接认领未安装' })
   }
+  if (state.officialMenus !== undefined) items.push({ name: '官方右键菜单', active: state.officialMenus, note: state.officialMenus ? '插件动作接入共享菜单' : '服务缺失或装配失败，保留插件菜单' })
+  if (state.forge !== undefined) items.push({ name: 'Forge 导航', active: state.forge, note: state.forge ? '导航至官方面板与本地变更；PR 保持官方审查' : '官方 Forge 未安装或未启用，不自动启用' })
   return items
 }

package/src/client/contextMenusOfficial.ts

@@ -0,0 +1,80 @@
+/** Optional shared popup adapter retaining the plugin's action models. @author ddj 2026年11月04号 */
+export interface PopupItem {
+  id: string
+  label: string
+  disabled?: boolean
+  danger?: boolean
+  separator?: boolean
+  commandId?: string
+  run: () => void | Promise<void>
+}
+interface MenuTarget { kind: string; value: { owner: string; sessionId: string; path: string } }
+interface MenuService {
+  register(contribution: { id: string; target: string; order: number; resolve: (target: MenuTarget['value'], signal: AbortSignal) => unknown[] }): () => void
+  open(target: MenuTarget, point: { x: number; y: number }): void
+  close(): void
+  active?: { getSnapshot(): { kind?: string; value?: { owner?: string } } | null }
+}
+export interface OfficialMenuBridge {
+  open(kind: 'resource' | 'tab', sessionId: string, path: string, point: { x: number; y: number }, items: PopupItem[], valid: () => boolean): boolean
+  invalidate(valid: () => boolean): void
+  dispose(): void
+}
+let ownerSeq = 0
+
+/** @public @author ddj 2026年11月04号 @param ctx Optional service context. @returns Retry-on-use bridge for late service registration, with legacy fallback. */
+export function lazyMenus(ctx: { get(name: string): unknown }): OfficialMenuBridge {
+  let bridge: OfficialMenuBridge | undefined
+  let stopped = false
+  return {
+    open(...args) { if (stopped) return false; bridge ??= officialMenus(ctx); return bridge?.open(...args) ?? false },
+    invalidate(valid) { bridge?.invalidate(valid) },
+    dispose() { stopped = true; bridge?.dispose(); bridge = undefined },
+  }
+}
+
+/** @public @author ddj 2026年11月04号 @param ctx Optional service context. @returns Scoped bridge or no capability, preserving the existing popup. */
+export function officialMenus(ctx: { get(name: string): unknown }): OfficialMenuBridge | undefined {
+  let service: MenuService
+  try { service = ctx.get('contextMenus') as MenuService } catch { return undefined }
+  if (!service || typeof service.register !== 'function' || typeof service.open !== 'function' || typeof service.close !== 'function') return undefined
+  const owner = 'edrv-menu-' + ++ownerSeq
+  let current: { items: PopupItem[]; valid: () => boolean; revision: number } | undefined
+  let revision = 0
+  let stopped = false
+  const disposers: Array<() => void> = []
+  try {
+    for (const kind of ['resource', 'tab']) {
+      disposers.push(service.register({ id: owner + '-' + kind, target: 'edrv.' + kind, order: 30,
+        resolve: (target, signal) => {
+          const opening = current
+          if (stopped || target.owner !== owner || !opening || !opening.valid() || signal.aborted) return []
+          return opening.items.map((item) => ({ id: item.id, label: item.label, disabled: item.disabled,
+            danger: item.danger, separatorBefore: item.separator, commandId: item.commandId,
+            run: async () => {
+              if (stopped || opening.revision !== revision || !opening.valid() || item.disabled) return
+              await item.run()
+            } }))
+        },
+      }))
+    }
+  } catch { for (const dispose of disposers) dispose(); return undefined }
+  /** @private @author ddj 2026年11月04号 Close only this bridge's active shared popup. */
+  function closeOwned(): void {
+    const active = service.active?.getSnapshot()
+    if (active?.value?.owner === owner && (active.kind === 'edrv.resource' || active.kind === 'edrv.tab')) service.close()
+  }
+  return {
+    open(kind, sessionId, path, point, items, valid) {
+      if (stopped || !sessionId || !valid()) return false
+      current = { items, valid, revision: ++revision }
+      try { service.open({ kind: 'edrv.' + kind, value: { owner, sessionId, path } }, point); return true }
+      catch { current = undefined; return false }
+    },
+    invalidate(valid) {
+      if (current?.valid !== valid) return
+      revision++; current = undefined; closeOwned()
+    },
+    dispose() { stopped = true; revision++; current = undefined; closeOwned(); for (const dispose of disposers) dispose() },
+  }
+}

package/src/client/forgeBridge.ts

@@ -0,0 +1,28 @@
+/** Optional navigation only; remote snapshots never become local editable files. @author ddj 2026年11月04号 */
+export interface ForgeBridge { available(): boolean; open(sessionId: string, local?: boolean): boolean }
+
+/** @public @author ddj 2026年11月04号 @param ctx Client capabilities. @param current Current session reader. @returns Capability-gated official navigation, with no polling or writes. */
+export function forgeBridge(ctx: { get(name: string): unknown }, current: () => string | undefined): ForgeBridge {
+  const capabilities = () => {
+    try {
+      const tabs = ctx.get('sidebarRightTabs') as { get?(kind: string): unknown }
+      const service = ctx.get('sidebarRight') as { openTab?(kind: string): void; openResource?(address: string, options?: unknown): void }
+      return { tabs, service }
+    } catch { return undefined }
+  }
+  return {
+    available() {
+      const capabilitiesNow = capabilities()
+      return Boolean(capabilitiesNow?.tabs?.get?.('forge-panel') && capabilitiesNow.tabs.get('forge-changes') && capabilitiesNow.service?.openTab && capabilitiesNow.service.openResource)
+    },
+    open(sessionId, local = false) {
+      if (!sessionId || current() !== sessionId || !this.available()) return false
+      const service = capabilities()!.service
+      try {
+        if (local) service.openResource!('dsh-resource://forge-changes/' + encodeURIComponent(sessionId) + '/local', { kind: 'forge-changes' })
+        else service.openTab!('forge-panel')
+        return true
+      } catch { return false }
+    },
+  }
+}

package/src/client/index.ts

@@ -22,6 +22,9 @@ import { PerfSizeBadge } from './ui/PerfSizeBadge.js'
 import { ConversationDiffDock } from './ui/ConversationDiffDock.js'
 import { McpSettings } from './ui/McpSettings.js'
 import { mcpSessionState } from './mcpSessionState.js'
+import { forgeBridge } from './forgeBridge.js'
+import { lazyMenus } from './contextMenusOfficial.js'
+import { IconCodeOutline16 } from './ui/icons.js'
 import { McpSessionIcon, McpSessionDetail, type McpRowProps } from './ui/McpSessionStatus.js'
 import { PluginDetailSection } from './ui/PluginDetailSection.js'
 import { rpc } from './rpc.js'
@@ -442,6 +445,7 @@ export async function apply(ctx: any): Promise<void> {
     sidebarOpener: registry.get(SIDEBAR_PLUGIN) !== undefined,
     legacySidebar: sideService !== undefined, officialSidebar: officialService !== undefined,
     fileClaim: claimDisposer !== null, claimWanted: shouldClaimFiles(selected), selected,
+    officialMenus: Boolean(ctx.get('contextMenus')), forge: forge.available(),
   }, version)
 
   ctx.provide('fileOpeners', registry)
@@ -484,7 +488,10 @@ export async function apply(ctx: any): Promise<void> {
     return sidebar ? registry.register(sidebar) : undefined
   }, 'vscode-mode: sidebar file opener')
   // 官方侧边栏正文组件装配（页类型正文；兼作 file 认领转发失败时的兜底正文）
-  const officialRenderTab = (props: Record<string, unknown>) => React.createElement(OfficialSideTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, fileOpeners: registry, sessions, readSessionScope: () => readSessionScope(ctx) }))
+  const forge = forgeBridge(ctx, () => readSessionScope(ctx).sessionId ?? undefined)
+  const menuBridge = lazyMenus(ctx)
+  if (menuBridge) ctx.effect(() => () => menuBridge.dispose(), 'vscode-mode: official menus')
+  const officialRenderTab = (props: Record<string, unknown>) => React.createElement(OfficialSideTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, officialMenus: menuBridge, forge, fileOpeners: registry, sessions, readSessionScope: () => readSessionScope(ctx) }))
   /** 官方 file 地址认领同步：自动/VSCodeMode 档认领（转发进单一编辑器页签），其余交官方查看器。 */
   const syncFileClaim = (): void => {
     const official = officialService
@@ -669,7 +676,7 @@ export async function apply(ctx: any): Promise<void> {
       order: 5,
       label: () => t('slot.fileEditor'),
       inject: (sessionId: string) => ({ sessionId }),
-    }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, fileOpeners: registry, sessions })))
+    }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, officialMenus: menuBridge, forge, fileOpeners: registry, sessions })))
   }
 
   // 侧边栏三形态互斥切换：官方（DSH 0.1.5+）> better-sidebar（归档，仅旧版回退）> 中央页签。
@@ -748,7 +755,7 @@ export async function apply(ctx: any): Promise<void> {
       if (legacyDisposer !== null) { legacyDisposer(); legacyDisposer = null }
       sideDisposer = ctx.effect(() => installSideEditor({
         service: sideService as NonNullable<typeof sideService>,
-        renderTab: (props: Record<string, unknown>) => React.createElement(SideEditorTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, fileOpeners: registry, sessions })),
+        renderTab: (props: Record<string, unknown>) => React.createElement(SideEditorTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, officialMenus: menuBridge, forge, fileOpeners: registry, sessions })),
         activeSession: () => {
           const scope = readSessionScope(ctx)
           if (!scope.sessionId) return undefined
@@ -833,6 +840,14 @@ export async function apply(ctx: any): Promise<void> {
     getShortcuts: () => detectShortcuts(ctx),
   })))
 
+  registerSlotSafely(ctx, { name: 'settings.section.icon', id: 'vscode-mode', order: 30 },
+    (input: unknown) => {
+      const props = input as { size?: number; active?: boolean }
+      return React.createElement(IconCodeOutline16 as React.ComponentType<{ size?: number; className?: string }>, {
+        size: props.size ?? 16, className: props.active ? 'edrv-settings-active' : undefined,
+      })
+    })
+
   // 官方插件管理器详情页的只读状态段（DSH 0.2.1 新增扩展位）：非本插件页返回 null。
   // 该 slot 在旧版 DSH 不存在，slots.inject 会一直等待（不报错），故无需版本判断。
   registerSlotSafely(ctx, {

package/src/client/monaco/lsp/lspClient.ts

@@ -32,6 +32,8 @@ const docVersions = new Map()
 let statusCache = { servers: [], at: 0 }
 let progressListeners = new Set()
 let ready = false
+let statusRequest = null
+let statusEpoch = 0
 
 /** 会话 id 变更通知（EditorView 持有权威 sessionId，经窗口事件回填）。 */
 const SESSION_EVENT = 'edrv:lsp-session'
@@ -54,6 +56,9 @@ export function setLspSession(id) {
   syncTimers.clear()
   docVersions.clear()
   sessionId = id
+  statusEpoch++
+  statusCache = { servers: [], at: 0 }
+  ready = false
   void refreshStatus()
 }
 
@@ -308,15 +313,28 @@ export async function fetchSemanticTokens(path, text) {
   return res.tokens
 }
 
-/** 拉取服务器状态（带 5s 缓存）。 */
+/** @public @author ddj 2026年11月04号 @param force Bypass cached data, not the in-flight guard. @returns Current-session server status; stale responses never publish. */
 export async function refreshStatus(force = false) {
+  if (statusRequest) {
+    const pending = statusRequest
+    await pending.promise
+    if (pending.epoch !== statusEpoch) return refreshStatus(force)
+    return statusCache.servers
+  }
+  if (typeof document !== 'undefined' && document.hidden) return statusCache.servers
   if (!force && Date.now() - statusCache.at < 1500) return statusCache.servers
-  const res = await rpc('edrv.lsp.status', { sessionId }).catch(() => null)
-  const servers = res && res.ok && Array.isArray(res.servers) ? res.servers : []
-  statusCache = { servers, at: Date.now() }
-  ready = true
-  publishProgress()
-  return servers
+  const epoch = statusEpoch, owner = sessionId
+  const request = { epoch, promise: rpc('edrv.lsp.status', { sessionId: owner }).catch(() => null) }
+  statusRequest = request
+  try {
+    const res = await request.promise
+    if (epoch !== statusEpoch || owner !== sessionId) return statusCache.servers
+    const servers = res && res.ok && Array.isArray(res.servers) ? res.servers : []
+    statusCache = { servers, at: Date.now() }
+    ready = true
+    publishProgress()
+    return servers
+  } finally { if (statusRequest === request) statusRequest = null }
 }
 
 export function lspReady() {

package/src/client/officialSidebar.ts

@@ -64,6 +64,7 @@ export interface OfficialTabParams {
   preview?: boolean
   /** 目标行号（行引用/工具行跳转透传；缺省仅打开文件）。 */
   line?: number
+  column?: number
 }
 
 /** sidebarRightTabs 服务的最小结构面（结构性探测，不 import 官方类型）。 */
@@ -133,10 +134,17 @@ export function resolveNavOpen(params: unknown): { path: string | null; focusDif
 export function resolveNavLine(params: unknown): number | undefined {
   const value = (params ?? {}) as OfficialTabParams
   const line = value?.line
-  if (typeof line !== 'number' || !Number.isFinite(line) || line <= 0) return undefined
+  if (typeof line !== 'number' || !Number.isFinite(line) || line < 1) return undefined
   return Math.floor(line)
 }
 
+/** @public @author ddj 2026年11月04号 @param params Plugin navigation extension. @returns Positive column only alongside a valid line; official line-only callers remain unchanged. */
+export function resolveNavColumn(params: unknown): number | undefined {
+  if (!resolveNavLine(params)) return undefined
+  const column = (params as OfficialTabParams)?.column
+  return typeof column === 'number' && Number.isFinite(column) && column >= 1 ? Math.floor(column) : undefined
+}
+
 /** 逐段 component 解码（失败返回 null，对齐官方 parseFileAddress 的容错语义）。 */
 function decodeSegment(raw: string | undefined): string | null {
   if (raw === undefined) return null
@@ -158,7 +166,7 @@ function decodeSegment(raw: string | undefined): string | null {
  */
 export function parseOfficialFileAddress(address: unknown): { path: string; sessionId?: string } | null {
   if (typeof address !== 'string' || !address.startsWith(OFFICIAL_FILE_PREFIX)) return null
-  const [scope, ...tail] = address.slice(OFFICIAL_FILE_PREFIX.length).split('/')
+  const [scope, ...tail] = address.split(/[?#]/, 1)[0].slice(OFFICIAL_FILE_PREFIX.length).split('/')
   const kind = decodeSegment(scope)
   if (kind === 'session') {
     const sessionId = decodeSegment(tail[0])
@@ -236,10 +244,14 @@ export function forwardToEditor(
   path: string | null,
   line?: number,
   preview?: boolean,
+  column?: number,
 ): boolean {
   if (!service || typeof service.openTab !== 'function' || !path) return false
   const params: OfficialTabParams = { openPath: path }
-  if (line !== undefined) params.line = line
+  const validLine = resolveNavLine({ line })
+  if (validLine !== undefined) params.line = validLine
+  const validColumn = resolveNavColumn({ line: validLine, column })
+  if (validColumn !== undefined) params.column = validColumn
   if (preview !== undefined) params.preview = preview
   try {
     // 官方语义：页类型恒去重，故转发只会聚焦既有编辑器页签，不产生新实例

package/src/client/sidebar/menuItems.ts

@@ -581,6 +581,12 @@ function svnMenuItems(): TreeMenuItem[] {
 export function createDefaultFileMenuItems(): TreeMenuItem[] {
   return [
     ...openGroupItems(),
+    { id: 'forge-open', label: '打开 Forge', order: 6, group: GROUP_OPEN,
+      visible: (_target, ctx) => ctx.forge?.available() === true,
+      run: (_target, ctx) => { if (ctx.sessionId) ctx.forge?.open(ctx.sessionId) } },
+    { id: 'forge-local', label: '查看本地变更（Forge）', order: 7, group: GROUP_OPEN,
+      visible: (_target, ctx) => ctx.forge?.available() === true,
+      run: (_target, ctx) => { if (ctx.sessionId) ctx.forge?.open(ctx.sessionId, true) } },
     ...revealGroupItems(),
     ...refGroupItems(),
     ...clipGroupItems(),

package/src/client/sidebar/panels/FileExplorer.ts

@@ -84,11 +84,17 @@ function rowView(props) {
   function select() { onSelect(path, isDir) }
   /** @private @author ddj 2026年10月10号 @param event Context trigger. */
   function menu(event) { onContext(path, type, event) }
+  /** @private @author ddj 2026年11月04号 @param event Keyboard context trigger anchored to the focused row. */
+  function menuKey(event) {
+    if (event.key !== 'ContextMenu' && !(event.shiftKey && event.key === 'F10')) return
+    const rect = event.currentTarget.getBoundingClientRect()
+    onContext(path, type, { preventDefault: () => event.preventDefault(), stopPropagation: () => event.stopPropagation(), clientX: rect.left, clientY: rect.bottom })
+  }
   return React.createElement('div', {
     className: 'edrv-tree-row' + (active ? ' edrv-tree-active' : '') + (context ? ' edrv-tree-context' : '')
       + (reveal ? ' edrv-tree-reveal' : '') + (mark?.stale ? ' edrv-tree-stale' : ''),
     title: path + (mark?.stale ? '；SVN 状态陈旧，等待确认' : ''), 'data-edrv-path': path,
-    style: { paddingLeft: 6 + depth * 14 }, onClick: select, onContextMenu: menu,
+    style: { paddingLeft: 6 + depth * 14 }, tabIndex: 0, onClick: select, onContextMenu: menu, onKeyDown: menuKey,
   },
     React.createElement('span', { className: 'edrv-tree-chev' }, isDir ? (isOpen ? '▾' : '▸') : ''),
     React.createElement('span', { className: 'edrv-tree-iconbox' }, rowIconEl({ name }, isDir, isOpen), svnOverlayEl(viewOverlayOf(mark), remote)),
@@ -480,6 +486,25 @@ export function FileExplorer(props) {
   /** @private @author ddj 2026年10月22号 Close stale path menus instead of rebinding recycled rows. */
   function closeLostMenu() { if (menu && !menuValid) setMenu(null) }
   React.useEffect(closeLostMenu, [menu, menuValid])
+  const liveMenu = React.useRef({ scope, treeRows, sessionId: ctx?.sessionId, alive: true })
+  const openingValid = React.useRef(null)
+  liveMenu.current = { scope, treeRows, sessionId: ctx?.sessionId, alive: liveMenu.current.alive }
+  React.useEffect(() => {
+    liveMenu.current.alive = ctx?.visible !== false
+    return () => { liveMenu.current.alive = false; if (openingValid.current) ctx?.officialMenus?.invalidate(openingValid.current) }
+  }, [scope, ctx?.sessionId, ctx?.officialMenus, ctx?.visible])
+  React.useEffect(() => {
+    if (!menuValid || !ctx?.officialMenus || !ctx.sessionId) return
+    const target = { ...menu.target }
+    const sessionId = ctx.sessionId
+    const valid = () => liveMenu.current.alive && liveMenu.current.sessionId === sessionId && liveMenu.current.scope === menu.scope && (target.path === '' || liveMenu.current.treeRows.some((row) => row.e?.path === target.path))
+    openingValid.current = valid
+    const items = buildTreeMenu(ctx.fileMenuItems, target, ctx).map((item) => ({
+      id: item.id, label: item.label, disabled: item.disabled, danger: item.danger, separator: item.separator,
+      run: () => item.run(target, ctx),
+    }))
+    if (ctx.officialMenus.open('resource', ctx.sessionId, target.path, { x: menu.x, y: menu.y }, items, valid)) setMenu(null)
+  }, [menu, menuValid, ctx?.officialMenus])
   // 当前右键目标的可视菜单项（构建时过滤/排序，registry 变化下次打开生效）。
   const menuEntries = menuValid
     ? buildTreeMenu(ctx?.fileMenuItems, menu.target, ctx).map((item) => ({

package/src/client/sidebar/types.ts

@@ -11,6 +11,7 @@ import type { TreeMenuRegistry } from './contextMenu.js'
 /** 面板可用的共享上下文（由 SidebarView 从 EditorView 注入，面板不直碰其内部）。 */
 export interface SidebarCtx {
   sessionId?: string
+  visible?: boolean
   /** 当前会话工作区 cwd（来自 sessions 快照；规则面板项目 Tab 自动匹配用）。 */
   cwd?: string | null
   /** 状态作用域键（工作区优先，无 cwd 回退会话；面板持久化统一走它，scopeStore 产出）。 */
@@ -31,6 +32,8 @@ export interface SidebarCtx {
   outlineSources?: OutlineSourceRegistry
   /** 文件右键菜单项注册表（公开 provide 为 edrvFileContextMenuItems；文件管理面板构建菜单用）。 */
   fileMenuItems?: TreeMenuRegistry
+  officialMenus?: import('../contextMenusOfficial.js').OfficialMenuBridge
+  forge?: import('../forgeBridge.js').ForgeBridge
   /** 「添加到对话」动作集（文件/文件夹引用注入对话输入框；缺省时菜单项降级提示）。 */
   addToConversation?: AddToConversation
   /** SVN 能力状态（未加载/未检出为 null；SVN 菜单项显隐判定）。 */

package/src/client/state/recordsFeed.ts

@@ -30,6 +30,11 @@ interface FeedEntry {
   onRefresh: (() => void) | null
   seq: number
   inflight: boolean
+  queued?: boolean
+  queuedSkipStale?: boolean
+  request?: Promise<void>
+  controller?: AbortController
+  onVisible?: () => void
 }
 
 const feeds = new Map<string, FeedEntry>()
@@ -80,12 +85,21 @@ function notifyRecords(entry: FeedEntry): void {
  */
 export function refreshFeed(sessionId: string, skipStale = false): Promise<void> {
   const entry = entryOf(sessionId)
+  entry.queuedSkipStale = entry.queuedSkipStale === undefined ? skipStale : entry.queuedSkipStale && skipStale
+  if (typeof document !== 'undefined' && document.hidden) { entry.queued = true; return Promise.resolve() }
+  if (entry.inflight) {
+    entry.queued = true
+    return entry.request ?? Promise.resolve()
+  }
+  skipStale = entry.queuedSkipStale ?? skipStale
+  entry.queuedSkipStale = undefined
   const current = ++entry.seq
   entry.inflight = true
+  entry.controller = new AbortController()
   const payload: { sessionId: string; skipStale?: boolean } = { sessionId }
   if (skipStale) payload.skipStale = true
 
-  return rpc('edrv.list', payload)
+  entry.request = rpc('edrv.list', payload, entry.controller.signal)
     .then((res) => {
       if (current !== entry.seq) return
       if (!res || !res.ok || !Array.isArray(res.records)) return
@@ -105,8 +119,14 @@ export function refreshFeed(sessionId: string, skipStale = false): Promise<void>
       }
     })
     .finally(() => {
-      if (current === entry.seq) entry.inflight = false
+      if (current !== entry.seq) return
+      entry.inflight = false
+      if (entry.queued) {
+        entry.queued = false
+        if (feeds.get(sessionId) === entry) return refreshFeed(sessionId, entry.queuedSkipStale ?? false)
+      }
     })
+  return entry.request
 }
 
 /**
@@ -118,6 +138,7 @@ export function refreshFeed(sessionId: string, skipStale = false): Promise<void>
 function ensureTimer(sessionId: string, entry: FeedEntry): void {
   if (entry.timer === null) {
     entry.timer = setInterval(() => {
+      if (typeof document !== 'undefined' && document.hidden) return
       const tickers = Array.from(entry.tickers)
       for (const tick of tickers) {
         try {
@@ -130,6 +151,14 @@ function ensureTimer(sessionId: string, entry: FeedEntry): void {
       if (entry.listeners.size > 0 || entry.errorListeners.size > 0) void refreshFeed(sessionId)
     }, FEED_INTERVAL_MS)
   }
+  if (!entry.onVisible && typeof document !== 'undefined') {
+    entry.onVisible = () => {
+      if (document.hidden) return
+      for (const tick of entry.tickers) { try { tick() } catch { /* Isolated observer. */ } }
+      if (entry.listeners.size || entry.errorListeners.size) { entry.queued = false; void refreshFeed(sessionId) }
+    }
+    document.addEventListener('visibilitychange', entry.onVisible)
+  }
   if (entry.onRefresh === null) {
     const handler = () => {
       void refreshFeed(sessionId)
@@ -147,12 +176,16 @@ function ensureTimer(sessionId: string, entry: FeedEntry): void {
  * @param entry 订阅槽位
  */
 function releaseIfIdle(sessionId: string, entry: FeedEntry): void {
-  if (entry.listeners.size || entry.tickers.size || entry.errorListeners.size) return
+  if (feeds.get(sessionId) !== entry || entry.listeners.size || entry.tickers.size || entry.errorListeners.size) return
   if (entry.timer !== null) clearInterval(entry.timer)
   if (entry.onRefresh !== null) {
     const target = win()
     if (target) target.removeEventListener('edrv:refresh', entry.onRefresh)
   }
+  entry.seq++
+  entry.queued = false
+  entry.controller?.abort()
+  if (entry.onVisible && typeof document !== 'undefined') document.removeEventListener('visibilitychange', entry.onVisible)
   feeds.delete(sessionId)
 }
 
@@ -237,5 +270,9 @@ export function disposeFeed(sessionId: string): void {
     const target = win()
     if (target) target.removeEventListener('edrv:refresh', entry.onRefresh)
   }
+  entry.seq++
+  entry.queued = false
+  entry.controller?.abort()
+  if (entry.onVisible && typeof document !== 'undefined') document.removeEventListener('visibilitychange', entry.onVisible)
   feeds.delete(sessionId)
 }

package/src/client/state/reviewFeed.ts

@@ -4,7 +4,7 @@ import type { ReviewPage } from '../../shared/review.js'
 
 export interface ReviewFeed { page: ReviewPage | null; error: string }
 type Listener = (feed: ReviewFeed) => void
-interface Entry { listeners: Set<Listener>; value: ReviewFeed; controller: AbortController; timer?: ReturnType<typeof setTimeout>; loading: boolean; again: boolean; onRefresh: () => void }
+interface Entry { listeners: Set<Listener>; value: ReviewFeed; controller: AbortController; timer?: ReturnType<typeof setTimeout>; loading: boolean; again: boolean; onRefresh: () => void; onVisible?: () => void }
 const feeds = new Map<string, Entry>()
 
 /** @private @author ddj 2026年10月26号 @param entry Shared feed. Notify mounted observers only. */
@@ -13,6 +13,7 @@ function notify(entry: Entry): void { for (const listener of entry.listeners) li
 /** @private @author ddj 2026年10月26号 @param sessionId Scope. @param entry Current generation. @returns First-page metadata update; no overlap or late publication. */
 async function refresh(sessionId: string, entry: Entry, force = false): Promise<void> {
   if (entry.controller.signal.aborted) return
+  if (typeof document !== 'undefined' && document.hidden) { entry.again = true; return }
   if (entry.loading) { entry.again = true; return }
   clearTimeout(entry.timer)
   entry.loading = true
@@ -46,14 +47,20 @@ export function subscribeReview(sessionId: string, listener: Listener): () => vo
     entry = { listeners: new Set(), value: { page: null, error: '' }, controller: new AbortController(), loading: false, again: false, onRefresh }
     feeds.set(sessionId, entry)
     if (typeof window !== 'undefined') window.addEventListener('edrv:refresh', onRefresh)
+    if (typeof document !== 'undefined') {
+      const current = entry
+      entry.onVisible = () => { if (!document.hidden) void refresh(sessionId, current) }
+      document.addEventListener('visibilitychange', entry.onVisible)
+    }
     void refresh(sessionId, entry)
   }
   entry.listeners.add(listener); listener(entry.value)
   return () => {
     entry.listeners.delete(listener)
-    if (entry.listeners.size) return
+    if (entry.listeners.size || feeds.get(sessionId) !== entry) return
     entry.controller.abort(); clearTimeout(entry.timer); feeds.delete(sessionId)
     if (typeof window !== 'undefined') window.removeEventListener('edrv:refresh', entry.onRefresh)
+    if (entry.onVisible && typeof document !== 'undefined') document.removeEventListener('visibilitychange', entry.onVisible)
   }
 }
 

package/src/client/tabMenu.ts

@@ -48,6 +48,7 @@ export interface TabMenuState {
   canSplit?: boolean
   canFloat?: boolean
   canReturn?: boolean
+  forgeReady?: boolean
 }
 
 /** 一条页签菜单项（ContextMenu 的展示形状 + 动作 id）。 */
@@ -122,6 +123,10 @@ export function buildTabMenu(state: TabMenuState): TabMenuEntry[] {
       label: '添加到对话',
       disabled: !(hasSession && canAddToConversation),
     },
+    ...(state.forgeReady ? [
+      { id: 'forge-open', label: '打开 Forge' },
+      { id: 'forge-local', label: '查看本地变更（Forge）' },
+    ] : []),
     { id: 'close', label: '关闭', separator: true, ...(closeChord ? { hint: closeChord } : {}) },
     { id: 'close-others', label: '关闭其他', disabled: nothingToClose(closeOthers(tabs, path, active), tabs) },
     { id: 'close-right', label: '关闭右侧标签页', disabled: nothingToClose(closeRight(tabs, path, active), tabs) },

package/src/client/ui/ClaimRouter.ts

@@ -8,7 +8,7 @@
  * 作者 ddj 2026年09月10号
  */
 import React from 'react'
-import { forwardToEditor, parseOfficialFileAddress, resolveNavLine } from '../officialSidebar.js'
+import { forwardToEditor, parseOfficialFileAddress, resolveNavLine, resolveNavColumn } from '../officialSidebar.js'
 import { log } from '../log.js'
 
 /** 转发尝试次数（含首次）与重试间隔。 */
@@ -68,17 +68,22 @@ export function createClaimRouter(spec) {
     const doneRef = React.useRef(-1)
 
     React.useEffect(() => {
-      if (revision === doneRef.current) return
-      doneRef.current = revision
+      const intent = JSON.stringify([props?.sessionId, tab?.id, revision, navigation?.address])
+      if (intent === doneRef.current) return
       const parsed = parseOfficialFileAddress(navigation?.address)
       if (!parsed) {
         setFailed(true)
         return
       }
       const line = resolveNavLine(navigation?.params)
+      const column = resolveNavColumn(navigation?.params)
+      let alive = true
+      setFailed(false)
       let left = FORWARD_ATTEMPTS
       const attempt = () => {
-        if (forwardToEditor(service, parsed.path, line, navigation?.params?.preview)) {
+        if (!alive || tab?.signal?.aborted) return
+        if (forwardToEditor(typeof tab?.actions?.openTab === 'function' ? tab.actions : service, parsed.path, line, navigation?.params?.preview, column)) {
+          doneRef.current = intent
           closeTab(tab)
           return
         }
@@ -87,7 +92,8 @@ export function createClaimRouter(spec) {
         else setFailed(true)
       }
       attempt()
-    }, [revision])
+      return () => { alive = false }
+    }, [revision, props?.sessionId, tab?.id, navigation?.address])
 
     if (!failed || typeof fallback !== 'function') return null
     return React.createElement(fallback, props)

package/src/client/ui/EditorPane.ts

@@ -43,7 +43,15 @@ export function EditorPane(props: PaneProps): React.ReactElement {
     /** @private @author ddj 2026年10月14号 @param event Close press. Never start a drag. */
     function stop(event: React.PointerEvent): void { event.stopPropagation() }
     /** @private @author ddj 2026年10月14号 @param event Keyboard activation. */
-    function key(event: React.KeyboardEvent): void { if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); props.onSelect(group.id, tab.path) } }
+    function key(event: React.KeyboardEvent): void {
+      if (event.key === 'ContextMenu' || (event.shiftKey && event.key === 'F10')) {
+        event.preventDefault(); event.stopPropagation()
+        const rect = event.currentTarget.getBoundingClientRect()
+        props.onMenu(tab.path, { clientX: rect.left, clientY: rect.bottom } as React.MouseEvent)
+        return
+      }
+      if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); props.onSelect(group.id, tab.path) }
+    }
     return React.createElement('div', {
       key: tab.path, 'data-edrv-tab-path': tab.path, role: 'tab', tabIndex: 0, 'aria-selected': selected,
       className: 'edrv-tab' + (selected ? ' edrv-tab-active' : '') + (tab.pinned ? ' edrv-tab-pinned' : ''),