dsh-vscode-mode 0.25.1 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.25.1",
+  "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/reviewBar.ts

@@ -126,6 +126,9 @@ export const SIDECAR_KEEP_TITLE = '标记这些历史改动为已看过：只改
 /** 非官方 Undo 的作用域说明：走原有回滚校验写回磁盘，但不影响官方记录。 */
 export const SIDECAR_UNDO_TITLE = '撤销这些历史改动（写回受回滚校验保护）：只影响这份历史记录，不影响官方审查。'
 
+/** 非官方 Keep 之后的完成态：该通道 Keep 不写盘，不能沿用「已采纳」这种会让人以为改过文件的措辞。 */
+export const SIDECAR_KEEP_DONE = '已标记为看过（未改动文件）'
+
 /** 当前端没有该会话时，差异栏里给中性说明而不是红色报错。 */
 export const SESSION_DOWN_NOTICE = '这个会话没在当前端激活，官方审查数据暂时读不到；下面的历史改动仍可查看、Keep、Undo。'
 

package/src/client/reviewBatch.ts

@@ -30,7 +30,15 @@ export async function loadPending(port: Pick<BatchPort, 'snapshot'>): Promise<Re
   return page.items
 }
 
-/** @public @author ddj 2026年10月27号 @param port Guarded existing per-file decision adapter. @param reject Undo instead of Keep. @returns Precise partial result; Undo stops at first conflict, never claims atomic multi-file rollback. */
+/**
+ * @public
+ * @author ddj 2026年10月27号
+ * @description: 逐条决策引擎，现仅供 Undo All 使用（Keep 已改走 `reviewKeepAll.ts` 的宿主批量通道）；
+ * 保留 reject 形态以便对照既有契约与测试。
+ * @param port Guarded existing per-file decision adapter.
+ * @param reject Undo instead of Keep.
+ * @returns Precise partial result; Undo stops at first conflict, never claims atomic multi-file rollback.
+ */
 export async function runReviewBatch(port: BatchPort, reject: boolean): Promise<BatchResult> {
   const result: BatchResult = { completed: 0, total: 0, paths: [], error: '' }
   try {

package/src/client/reviewKeepAll.ts

@@ -0,0 +1,72 @@
+/**
+ * 批量 Keep：一次完整快照 + 一次批量 RPC，单条基线问题只跳过自己，不再整批中止。
+ * Undo 仍走 reviewBatch.ts 的逐条通道（写盘要逐项校验并在冲突处停止）。
+ * @author ddj 2026年11月03号
+ */
+import type { KeepAllItem, KeepAllResult, ReviewItem, ReviewPage, ReviewResult } from '../shared/review.js'
+import { loadPending } from './reviewBatch.js'
+
+/** 批量 Keep 的 RPC 适配器；guard 在取快照前后各校验一次会话寿命。 */
+export interface KeepAllPort {
+  snapshot: () => Promise<ReviewPage>
+  keepAll: (items: KeepAllItem[], batchId: string) => Promise<ReviewResult<{ result: KeepAllResult }>>
+  guard: () => void
+}
+
+/**
+ * @private
+ * @author ddj 2026年11月03号
+ * @description: 取一次完整待审快照；完整性校验失败时重取一次，避免瞬时漂移被当成不可恢复错误。
+ * @param port 已鉴权的 RPC 适配器
+ * @returns 冻结的批量目标
+ * @throws 两次都取不到一致快照时抛出原始原因
+ */
+async function snapshotOnce(port: KeepAllPort): Promise<KeepAllItem[]> {
+  try {
+    return toItems(await loadPending(port))
+  } catch {
+    // 分页期间数量漂移多为瞬时：guard 仍有效就重新取一次，仍不一致才放弃
+    port.guard()
+    return toItems(await loadPending(port))
+  }
+}
+
+/**
+ * @private
+ * @author ddj 2026年11月03号
+ * @description: 把快照条目裁成批量目标，只带 host 需要的身份与版本线索。
+ * @param items 完整待审集
+ * @returns 批量目标
+ */
+function toItems(items: ReviewItem[]): KeepAllItem[] {
+  return items.map((item) => ({ id: item.id, display: item.display, seq: item.seq, revision: item.revision }))
+}
+
+/**
+ * @public
+ * @author ddj 2026年11月03号
+ * @description: 批量保留全部待审记录（Keep 不改写磁盘）。一次往返完成，跳过项只进 skipped，
+ * 段级异常才写 error；guard 失效时保留已完成计数交给调用方呈现。
+ * @param port 已鉴权的 RPC 适配器
+ * @returns 与 BatchResult 同构的批量结果（含跳过明细）
+ */
+export async function runKeepAll(port: KeepAllPort): Promise<KeepAllResult> {
+  const result: KeepAllResult = { completed: 0, total: 0, paths: [], skipped: [], error: '' }
+  try {
+    port.guard()
+    const items = await snapshotOnce(port)
+    result.total = items.length
+    if (!items.length) return result
+
+    port.guard()
+    const reply = await port.keepAll(items, crypto.randomUUID())
+    if (!reply.ok) {
+      result.error = reply.error
+      return result
+    }
+    return reply.result
+  } catch (cause) {
+    result.error = cause instanceof Error ? cause.message : String(cause)
+    return result
+  }
+}

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/diffSummary.ts

@@ -32,6 +32,39 @@ export function officialPath(path: string, page: ReviewPage | null): boolean {
   return !!page?.overview?.coveredPaths.some((candidate) => diffPathKey(candidate) === key)
 }
 
+/**
+ * @author ddj 2026年11月3号
+ * @description: 本页待审条目占用的路径键：路径本身与其身份各一份。
+ * @param page 审查页
+ * @returns 待审覆盖的路径键集合
+ */
+function pendingCoverKeys(page: ReviewPage | null): Set<string> {
+  const keys = new Set<string>()
+  for (const item of page?.items ?? []) {
+    if (!item.id.startsWith(PENDING_PREFIX)) continue
+    // 待审条目的 path 取自写入时的原始写法（agent 常用工作区相对路径），官方导航用的却是绝对身份：
+    // 只按 path 建覆盖集时，同一文件的官方汇总行不会被压掉，差异栏把 3 个文件算成 6 条。
+    // 身份（id 去掉待审前缀）与官方 identity 同源，必须一起入集。
+    keys.add(diffPathKey(item.currentPath || item.path))
+    keys.add(diffPathKey(item.id.slice(PENDING_PREFIX.length)))
+  }
+  return keys
+}
+
+/**
+ * @public
+ * @author ddj 2026年11月3号
+ * @description: 取本页"已有权威通道在管"的路径键：官方汇总覆盖集 + 待审条目。
+ * 编辑器与差异汇总必须同口径，否则同一改动在列表里被压掉、在编辑器里却仍然画得出来并可以点。
+ * @param page 审查页
+ * @returns 路径比较键集合
+ */
+export function coveredPathKeys(page: ReviewPage | null): Set<string> {
+  const keys = pendingCoverKeys(page)
+  for (const path of page?.overview?.coveredPaths ?? []) keys.add(diffPathKey(path))
+  return keys
+}
+
 /**
  * @author ddj 2026年10月30号
  * @description: 取出本页待审条目（id 带待审前缀）并折算成文件行。
@@ -40,15 +73,9 @@ export function officialPath(path: string, page: ReviewPage | null): boolean {
  */
 function pendingRowsOf(page: ReviewPage | null): { rows: DiffFile[]; covered: Set<string> } {
   const rows: DiffFile[] = []
-  const covered = new Set<string>()
   for (const item of page?.items ?? []) {
     if (!item.id.startsWith(PENDING_PREFIX)) continue
     const path = item.currentPath || item.path
-    // 待审条目的 path 取自写入时的原始写法（agent 常用工作区相对路径），官方导航用的却是绝对身份：
-    // 只按 path 建覆盖集时，同一文件的官方汇总行不会被压掉，差异栏把 3 个文件算成 6 条。
-    // 身份（id 去掉待审前缀）与官方 identity 同源，必须一起入集。
-    covered.add(diffPathKey(path))
-    covered.add(diffPathKey(item.id.slice(PENDING_PREFIX.length)))
     rows.push({
       path,
       label: item.display || path,
@@ -59,7 +86,7 @@ function pendingRowsOf(page: ReviewPage | null): { rows: DiffFile[]; covered: Se
       sourceKind: 'pending',
     })
   }
-  return { rows, covered }
+  return { rows, covered: pendingCoverKeys(page) }
 }
 
 /** @public @author ddj 2026年10月26号 @param records Tool-call history. @param page Official file navigation, never only its first 50 rows. @returns Pending first, then official; legacy paths remain explicitly labelled. */

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)
 }