dsh-vscode-mode 0.23.2 → 0.23.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.23.2",
+  "version": "0.23.4",
   "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": [
@@ -84,7 +84,7 @@
     "vitest": "^3.2.4"
   },
   "scripts": {
-    "build": "tsdown",
+    "build": "tsdown && node scripts/check-client-artifacts.mjs lib",
     "build:client": "tsdown",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run && node --test tests/nativeOpen.test.mjs",

package/src/client/missingReview.ts

@@ -1,6 +1,30 @@
 import type { MissingReview } from '../shared/types.js'
 import { splitLines } from '../shared/diff.js'
 
+/** 缺失文件终态：文件已在磁盘删除，且没有可展示的整文件预览。 */
+export interface GoneState {
+  title: string
+  message: string
+  /** 该文件还有官方待审改动：Keep 可在差异栏结案，Undo 不可用。 */
+  official: boolean
+}
+
+/**
+ * @public
+ * @author ddj 2026年10月31号
+ * @description: 把 missingReview 的失败归并成「文件已删除」终态。只有确认删除的拒绝码才是终态；
+ * 会话缺失、权限、文件重新出现等失败返回 null，调用方继续走通用加载失败（可重试、保留跨端提示）。
+ * @param failure RPC 失败结果（error 必填，code 可选）
+ * @returns 终态信息或 null
+ */
+export function goneStateOf(failure: { error?: unknown; code?: unknown } | null | undefined): GoneState | null {
+  const code = failure?.code
+  const official = code === 'official-covered'
+  if (!official && code !== 'official-decided' && code !== 'no-records' && code !== 'no-evidence' && code !== 'too-large') return null
+  const message = String(failure?.error ?? '文件已在磁盘删除').replace(/^Error:\s*/, '')
+  return { title: official ? '文件已在磁盘删除 · 有官方待审改动' : '文件已在磁盘删除', message, official }
+}
+
 /** @public @author ddj 2026年10月28号 @param review Frozen complete snapshot. @returns One whole-file deletion, including empty files; no invented current lines. */
 export function missingRegion(review: MissingReview) {
   return {

package/src/client/openReceipt.ts

@@ -4,7 +4,7 @@ import { createRequestId } from './requestId.js'
 import type { PlanDocument } from './planState.js'
 
 export interface EditorRequest { requestId: string; sessionId: string; path: string | null; line?: number; column?: number; preview?: boolean; plan?: PlanDocument }
-export interface OpenOptions { preview?: boolean; plan?: PlanDocument; signal?: AbortSignal }
+export interface OpenOptions { preview?: boolean; plan?: PlanDocument; signal?: AbortSignal; timeoutMs?: number }
 interface Waiter { request: EditorRequest; finish: (success: boolean) => void; claimed?: boolean }
 const waiters = new Map<string, Waiter>()
 
@@ -37,7 +37,7 @@ export function finishOpen(requestId: string, success: boolean, error?: string):
  * @param line Optional target line.
  * @param column Optional target column.
  * @param sessionId Owning session, required for routing.
- * @param options Explicit preview, read-only plan document and optional cancellation signal.
+ * @param options Explicit preview, read-only plan document, cancellation signal and receipt deadline.
  * @returns Actual completion; timeout and disposal are false.
  */
 export function requestOpen(path: string | null, line?: number, column?: number, sessionId = '', options: OpenOptions = {}): Promise<boolean> {
@@ -60,7 +60,7 @@ export function requestOpen(path: string | null, line?: number, column?: number,
     function abort(): void { finish(false) }
     options.signal?.addEventListener('abort', abort, { once: true })
     waiters.set(request.requestId, { request, finish })
-    timer = setTimeout(() => finish(false), 20_000)
+    timer = setTimeout(() => finish(false), options.timeoutMs ?? 20_000)
     openEditorView(null)
     window.dispatchEvent(new CustomEvent('edrv:open-request', { detail: request }))
   })

package/src/client/planBridge.ts

@@ -2,6 +2,7 @@
 import React from 'react'
 import { requestOpen } from './openReceipt.js'
 import { createPlanFeed, clearPlanState, isPlanAddress, planDocument, type PlanWindow, type PlanOpen } from './planState.js'
+import { installPlanDirect, optionalService, type PlanOpenOptions } from './planDirect.js'
 import { detectOfficial, OFFICIAL_SLOT_NAME, type OfficialSidebar } from './officialSidebar.js'
 import { readSessionScope, subscribeScope } from './sessionScope.js'
 import { log } from './log.js'
@@ -22,16 +23,12 @@ const CLAIM_ID = 'dsh-vscode-mode/plan'
 const CLAIM_KIND = 'edrvPlan'
 const EMPTY_RESOURCE = { status: 'none' }
 
-/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param name Service name. @returns Service or undefined without gating plugin activation. */
-function optional(ctx: PlanContext, name: string): unknown {
-  try { return ctx.get(name) } catch { return undefined }
-}
 /** @private @author ddj 2026年10月08号 @param tab Current tab. @returns Native plan fallback options, preserving transient review parameters. */
 function nativeOptions(tab: PlanTab | undefined): { kind: string; params?: unknown } {
   return { kind: 'plan', params: tab?.navigation?.params }
 }
-/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param official Sidebar services. @returns Transfer component with native fallback and cancellable receipts. */
-function planRouter(ctx: PlanContext, official: OfficialSidebar) {
+/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param official Sidebar services. @param native Official openResource bypass. @returns Transfer component with native fallback and cancellable receipts. */
+function planRouter(ctx: PlanContext, official: OfficialSidebar, native: (address: string, options?: PlanOpenOptions) => void) {
   const transfers = new Map<string, { controller: AbortController; sessionId: string }>()
   /** @private @author ddj 2026年10月08号 @param all Plugin disposal. Cancel scope-stale transfers, not transfers merely hidden by the editor mount. */
   function cancel(all = false): void {
@@ -60,7 +57,7 @@ function planRouter(ctx: PlanContext, official: OfficialSidebar) {
     function openNative(): void {
       if (typeof official.service.openResource !== 'function') return
       try {
-        official.service.openResource(address, nativeOptions(tab))
+        native(address, nativeOptions(tab))
         tab?.actions?.close?.()
       } catch (error) { log.warn('计划官方查看器回退失败：' + String(error)) }
     }
@@ -99,11 +96,12 @@ function registerPlan(ctx: PlanContext, official: OfficialSidebar): () => void {
     patterns: ['dsh-resource://plan/**', 'dsh-resource://plan-review/**'],
     canOpen: isPlanAddress, title: () => '计划预览',
   })
-  const router = planRouter(ctx, official)
+  const direct = installPlanDirect(ctx, official.service)
+  const router = planRouter(ctx, official, direct.native)
   try {
     const offBody = ctx.slots.inject(OFFICIAL_SLOT_NAME, () => ctx.slots.register({ name: OFFICIAL_SLOT_NAME, key: CLAIM_ID }, router.body))
-    return () => { router.dispose(); if (typeof offBody === 'function') offBody(); offType() }
-  } catch (error) { router.dispose(); offType(); throw error }
+    return () => { direct.dispose(); router.dispose(); if (typeof offBody === 'function') offBody(); offType() }
+  } catch (error) { direct.dispose(); router.dispose(); offType(); throw error }
 }
 /** @private @author ddj 2026年10月08号 @param ctx Context. @returns Current-session feed subscription, cancelling pending opens on scope change. */
 function watchPlans(ctx: PlanContext): () => void {
@@ -116,7 +114,7 @@ function watchPlans(ctx: PlanContext): () => void {
   /** @private @author ddj 2026年10月08号 @param id Owning session. @returns Valid borrowed feed, or undefined on older/incompatible services. */
   function sourceOf(id: string): EventSource | undefined {
     try {
-      const sessions = optional(ctx, 'sessions') as Sessions | undefined
+      const sessions = optionalService(ctx, 'sessions') as Sessions | undefined
       if (!id || typeof sessions?.binding !== 'function') return undefined
       const feed = sessions.binding(id)?.eventSource
       return typeof feed?.getSnapshot === 'function' && typeof feed.subscribe === 'function' ? feed : undefined

package/src/client/planDirect.ts

@@ -0,0 +1,266 @@
+/**
+ * dsh-vscode-mode client — 计划地址直通。
+ *
+ * 背景：官方计划卡片「查看全文」调 `ctx.sidebarRight.openResource(planAddress)`，
+ * 侧栏会先创建计划页签、再由本插件认领并立刻关闭，桌面端表现为「快速打开又迅速关闭」。
+ * 本模块在装配时包装该服务方法：能直接拿到计划正文时改为把只读计划送进「文件编辑」，
+ * 不再创建侧栏页签；地址不属于在屏会话、正文暂不可得、编辑器未回执或包装未生效时
+ * 一律回落原方法，官方页签与原认领转交链路继续作为后备。
+ * 作者 ddj 2026年10月31号
+ */
+
+import { log } from './log.js'
+import { requestOpen } from './openReceipt.js'
+import { cachedPlan, isPlanAddress, planDocument, rememberPlan, type PlanDocument } from './planState.js'
+import { readSessionScope } from './sessionScope.js'
+
+//region 对外结构面
+
+/** 官方 openResource 的可选参数（临时回顾页签的正文在 params.planReview 里）。 */
+export interface PlanOpenOptions { kind?: string; params?: unknown }
+
+/** sidebarRight 的最小结构面：只接管 openResource 的调用。 */
+export interface PlanServiceLike { openResource?: (address: string, options?: PlanOpenOptions) => void }
+
+/** 直通装配结果：native 绕过包装回落原方法，dispose 中止在途并条件还原。 */
+export interface PlanDirect {
+  dispose: () => void
+  native: (address: string, options?: PlanOpenOptions) => void
+}
+
+/** 资源流最小结构面（@deepseek-ai/dsh-client-resources 为可选依赖）。 */
+interface ResourceStream { getSnapshot?: () => unknown; subscribe?: (listener: () => void) => unknown }
+
+/** resources 服务最小结构面。 */
+interface ResourcesLike { source?: (address: string) => ResourceStream | undefined }
+
+//endregion
+
+/** 正文解析上限：超过即回落官方页签，避免点击后长时间无反馈。 */
+const RESOLVE_MS = 1_500
+/** 编辑器回执上限：超过即回落官方页签。 */
+const ROUTE_MS = 5_000
+
+/** @public @author ddj 2026年10月31号
+ * 可选探测客户端服务，缺失或抛错时返回 undefined。
+ * @param ctx 客户端上下文（只需 get）。
+ * @param name 服务名。
+ * @returns 服务实例，或 undefined（不阻断装配）。
+ */
+export function optionalService(ctx: { get: (name: string) => unknown }, name: string): unknown {
+  try { return ctx.get(name) } catch { return undefined }
+}
+
+/** @public @author ddj 2026年10月31号
+ * 包装官方 openResource，把本会话的计划地址改为直通插件编辑器。
+ * @param ctx 客户端上下文（可选服务一律 ctx.get 探测）。
+ * @param service 官方 sidebarRight 服务；仅在赋值生效时留下包装。
+ * @returns 供路由回退使用的原方法，以及卸载时中止在途并还原的清理函数。
+ */
+export function installPlanDirect(ctx: { get: (name: string) => unknown }, service: PlanServiceLike): PlanDirect {
+  const original = service.openResource
+  const pending = new Map<string, () => void>()
+  let closed = false
+  let installed = false
+
+  //region 判定与参数
+
+  /** @private @author ddj 2026年10月31号
+   * 解码地址段（畸形编码一律视为不可接管）。
+   * @param address 官方资源地址。
+   * @returns 去掉协议前缀后的解码段。
+   */
+  function decode(address: string): string[] | undefined {
+    try { return address.split('/').slice(3).map(decodeURIComponent) } catch { return undefined }
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 判断该地址是否由本插件接管：只认两段式计划地址，且归属当前在屏会话。
+   * @param address 官方资源地址。
+   * @returns 可接管的会话 id，其他情况 undefined（回落原方法）。
+   */
+  function take(address: string): string | undefined {
+    if (closed || !isPlanAddress(address)) return undefined
+
+    const segments = decode(address)
+    if (segments?.length !== 2) return undefined
+
+    const current = readSessionScope(ctx).sessionId ?? ''
+    return current !== '' && segments[0] === current ? current : undefined
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 读官方参数里随页签携带的计划正文（临时回顾页签走这里）。
+   * @param address 官方资源地址。
+   * @param options 官方 openResource 参数。
+   * @returns 计划正文，或不带正文时 undefined。
+   */
+  function inline(address: string, options?: PlanOpenOptions): PlanDocument | undefined {
+    const params = options?.params
+    if (params === null || typeof params !== 'object') return undefined
+    return planDocument(address, (params as { planReview?: unknown }).planReview)
+  }
+
+  //endregion
+
+  //region 资源解析
+
+  /** @private @author ddj 2026年10月31号
+   * 打开计划资源流。
+   * @param services resources 服务。
+   * @param address 官方资源地址。
+   * @returns 资源流；服务缺失或抛错时 undefined。
+   */
+  function streamOf(services: ResourcesLike | undefined, address: string): ResourceStream | undefined {
+    try { return services?.source?.(address) } catch { return undefined }
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 从资源快照读已就绪的计划正文。
+   * @param address 官方资源地址。
+   * @param stream 计划资源流。
+   * @returns 计划正文；未就绪、失败或内容不完整时 undefined。
+   */
+  function planOf(address: string, stream: ResourceStream): PlanDocument | undefined {
+    let snapshot: unknown
+    try { snapshot = stream.getSnapshot?.() } catch { return undefined }
+
+    const state = snapshot !== null && typeof snapshot === 'object' ? snapshot as { status?: unknown; value?: unknown } : {}
+    return state.status === 'live' ? planDocument(address, state.value) : undefined
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 订阅资源快照变化。
+   * @param stream 计划资源流。
+   * @param listener 变更监听。
+   * @returns 退订函数；订阅面缺失或抛错时为 no-op。
+   */
+  function watchStream(stream: ResourceStream, listener: () => void): () => void {
+    try {
+      const off = stream.subscribe?.(listener)
+      return typeof off === 'function' ? off as () => void : () => undefined
+    } catch { return () => undefined }
+  }
+
+  //endregion
+
+  //region 直通与回落
+
+  /** @private @author ddj 2026年10月31号
+   * 回落官方方法（包装外的原入口）。
+   * @param address 官方资源地址。
+   * @param options 官方参数。
+   * @returns 无；失败只记日志，不影响点击链路。
+   */
+  function native(address: string, options?: PlanOpenOptions): void {
+    if (typeof original !== 'function') return
+    try { original.call(service, address, options) } catch (error) { log.warn('官方计划页签回退失败：' + String(error)) }
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 把已解析的计划送进插件编辑器；地址级在途合并，重复点击不叠开。
+   * @param plan 计划正文。
+   * @param session 归属会话。
+   * @param address 官方资源地址。
+   * @param options 官方参数（回落时原样透传）。
+   * @returns 无；未就绪或失败时回落官方页签，但不劫持已切换的会话。
+   */
+  function direct(plan: PlanDocument, session: string, address: string, options?: PlanOpenOptions): void {
+    if (closed || pending.has(address)) return
+
+    const controller = new AbortController()
+    pending.set(address, () => { pending.delete(address); controller.abort() })
+    rememberPlan(plan)
+
+    /** @private @author ddj 2026年10月31号 @param ok 编辑器是否就绪。 @returns 无；失败时回落官方页签。 */
+    function settle(ok: boolean): void {
+      pending.delete(address)
+      if (ok || closed || readSessionScope(ctx).sessionId !== session) return
+      native(address, options)
+    }
+    requestOpen(null, undefined, undefined, session, { preview: true, plan, signal: controller.signal, timeoutMs: ROUTE_MS })
+      .then(settle, (error: unknown) => { log.warn('计划直通失败：' + String(error)); settle(false) })
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 从计划资源异步解析正文，就绪后直通；超时或无法解析回落官方页签。
+   * @param address 官方资源地址。
+   * @param session 归属会话。
+   * @param options 官方参数。
+   * @returns 无。
+   */
+  function lookup(address: string, session: string, options?: PlanOpenOptions): void {
+    const stream = streamOf(optionalService(ctx, 'resources') as ResourcesLike | undefined, address)
+    if (stream === undefined) { native(address, options); return }
+
+    const early = planOf(address, stream)
+    if (early !== undefined) { direct(early, session, address, options); return }
+    if (closed || pending.has(address)) return
+
+    let timer: ReturnType<typeof setTimeout> | undefined
+    let stop: (() => void) | undefined
+    let done = false
+
+    /** @private @author ddj 2026年10月31号 @param ok 是否已拿到正文。 @returns 无；幂等收尾，清定时器、退订、释放地址。 */
+    function finish(ok: boolean): void {
+      if (done) return
+      done = true
+      if (timer !== undefined) clearTimeout(timer)
+      stop?.()
+      pending.delete(address)
+      if (!ok && !closed) native(address, options)
+    }
+    pending.set(address, () => finish(false))
+    timer = setTimeout(() => finish(false), RESOLVE_MS)
+    stop = watchStream(stream, () => {
+      const plan = planOf(address, stream)
+      if (plan === undefined) return
+      finish(true)
+      direct(plan, session, address, options)
+    })
+  }
+
+  //endregion
+
+  //region 装配
+
+  /** @private @author ddj 2026年10月31号 @param address 官方资源地址。 @param options 官方参数。 @returns 无；包装后的 openResource 入口。 */
+  function open(address: string, options?: PlanOpenOptions): void {
+    const session = take(address)
+    if (session === undefined) { native(address, options); return }
+
+    const known = inline(address, options) ?? cachedPlan(address)
+    if (known !== undefined) { direct(known, session, address, options); return }
+    lookup(address, session, options)
+  }
+
+  /** @private @author ddj 2026年10月31号 @returns 无；赋值后校验，未生效即降级为原认领转交链路。 */
+  function mount(): void {
+    if (typeof original !== 'function') return
+    try { service.openResource = open } catch (error) { log.warn('计划直通装配失败：' + String(error)) }
+    installed = service.openResource === open
+    if (installed) return
+    try { service.openResource = original } catch { /* 只读服务：保持原状 */ }
+  }
+
+  /** @private @author ddj 2026年10月31号 @returns 无；仅在包装仍是自己时还原（HMR 安全）。 */
+  function unmount(): void {
+    if (!installed || service.openResource !== open) return
+    try { service.openResource = original } catch (error) { log.warn('计划直通还原失败：' + String(error)) }
+    installed = false
+  }
+
+  /** @private @author ddj 2026年10月31号 @returns 无；卸载时先标记关闭，再中止在途并还原官方方法。 */
+  function dispose(): void {
+    if (closed) return
+    closed = true
+    for (const cancel of [...pending.values()]) { try { cancel() } catch { /* 收尾失败不影响卸载 */ } }
+    pending.clear()
+    unmount()
+  }
+
+  mount()
+  return { dispose, native }
+
+  //endregion
+}

package/src/client/planState.ts

@@ -4,6 +4,8 @@ export interface PlanOpen { path?: string; plan?: PlanDocument }
 export interface PlanEntry { type?: string; event: { type: string; seq?: number; data: unknown } }
 export interface PlanWindow { revision: number; entries: readonly PlanEntry[]; change: { kind: string; entries?: readonly PlanEntry[] } }
 const associated = new Map<string, Set<string>>()
+/** 地址 → 已解析计划正文（只留内存，供后续点击省掉一次资源解析）。 */
+const documents = new Map<string, PlanDocument>()
 
 /** @private @author ddj 2026年10月08号 @param value JSON candidate. @returns Object or empty record. */
 function record(value: unknown): Record<string, unknown> {
@@ -59,8 +61,24 @@ function associate(sessionId: string, path: string, cwd: string): void {
   associated.set(sessionId, paths)
   if (associated.size > 32) associated.delete(associated.keys().next().value!)
 }
+/** @public @author ddj 2026年10月31号
+ * 记住一份已解析计划，供「查看全文」时免去资源解析。
+ * @param plan 已解析计划。
+ * @returns 无；只缓存合法地址与正文，超过上限按插入序淘汰。
+ */
+export function rememberPlan(plan: PlanDocument): void {
+  const valid = planDocument(plan.address, plan)
+  if (valid === undefined) return
+
+  documents.set(valid.address, valid)
+  if (documents.size > 64) documents.delete(documents.keys().next().value!)
+}
+
+/** @public @author ddj 2026年10月31号 @param address 官方资源地址。 @returns 已缓存的计划正文。 */
+export function cachedPlan(address: string): PlanDocument | undefined { return documents.get(address) }
+
 /** @public @author ddj 2026年10月08号 Clear associations when the plugin unloads. */
-export function clearPlanState(): void { associated.clear() }
+export function clearPlanState(): void { associated.clear(); documents.clear() }
 
 /** @public @author ddj 2026年10月08号
  * Reduce only live append deltas; hydration, pagination, reconnect and duplicate sequences never open plans.
@@ -91,7 +109,7 @@ export function createPlanFeed(sessionId: string, cwd = '') {
       if (event.type === 'tool/result') return undefined
       const address = 'dsh-resource://plan/' + encodeURIComponent(sessionId) + '/' + encodeURIComponent(id)
       const plan = planDocument(address, { markdown: call.args.plan })
-      if (plan) { remember(id); return { plan } }
+      if (plan) { rememberPlan(plan); remember(id); return { plan } }
       return undefined
     }
     if (!settled || !['write', 'edit'].includes(call.name) || typeof call.args.file_path !== 'string') return undefined

package/src/client/ui/EditorView.ts

@@ -62,7 +62,7 @@ import { applyOfficial, editorFont, registerThemes, themeNameOf } from '../monac
 import { createDiffRenderer } from '../monaco/diffRender.js'
 import { ST, callIdAttr, noopHunk, summarize } from '../state/records.js'
 import { diffRegions } from '../state/regions.js'
-import { missingBatch, missingRegion } from '../missingReview.js'
+import { goneStateOf, missingBatch, missingRegion } from '../missingReview.js'
 import { QuickOpen } from './QuickOpen.js'
 import { attachHorizontalWheel } from './horizontalWheel.js'
 import { CommandPalette } from './CommandPalette.js'
@@ -343,6 +343,11 @@ export function EditorView(props) {
   const aiStatusTimer = React.useRef(null)
   const [error, setError] = React.useState(null)
   const [loadError, setLoadError] = React.useState(null)
+  // 缺失文件的终态：{ path, sessionId, title, message, official }。
+  // 与 loadError 区分开——加载失败可以重试，磁盘删除是终态，不能一直卡在进度条 0%。
+  const [goneFile, setGoneFile] = React.useState(null)
+  const missingReadRef = React.useRef(new Map()) // path → 已重读次数（防 文件缺失↔重现 抖动死循环）
+  const goneNow = goneFile && goneFile.path === active && goneFile.sessionId === sessionId ? goneFile : null
   const [largeCandidate, setLargeCandidate] = React.useState(null)
   const [pagedFile, setPagedFile] = React.useState(null)
   const [pageChanged, setPageChanged] = React.useState(null)
@@ -1173,17 +1178,49 @@ export function EditorView(props) {
    * @param force 强制走 RPC（reloadFile 用，跳过 model 复用）
    * @param version 已知磁盘版本（缺省走 RPC 返回值）
    */
-  /** @private @author ddj 2026年10月28号 @param path Missing text file. @param sid Owning session. @param seq Loader generation. @sideEffects Loads deletion evidence without creating or saving the file. */
+  /**
+   * 把「文件已在磁盘删除」记成终态面板：不占进度条、不反复重试，并允许直接关闭页签。
+   * 只有确认删除的原因才走终态；会话/权限类失败仍回退通用加载失败，保留跨端提示。
+   * @private @author ddj 2026年10月31号
+   * @param path 目标文件
+   * @param sid 会话 id
+   * @param seq 加载序号（过期响应丢弃）
+   * @param failure 宿主拒绝原因（可带稳定 code）
+   */
+  function settleGone(path, sid, seq, failure) {
+    if (!loadCurrent(path, seq)) return
+    const error = failure && typeof failure === 'object' ? failure : { error: failure }
+    const gone = goneStateOf(error)
+      ?? (error.deleted === true ? { title: '文件已在磁盘删除', official: false, message: String(error.error ?? '') } : null)
+    if (!gone) { failLoad(path, sid, seq, String(error.error ?? error)); return }
+    stampLoad(path, sid, seq, gone.message)
+    setLoadError(null)
+    setError(null)
+    setGoneFile({ ...gone, path, sessionId: sid })
+    setStatus(gone.official ? '文件已删除 · 差异栏可 Keep 结案' : '文件已删除')
+  }
+
+  /** @private @author ddj 2026年10月28号 / 2026年10月31号 @param path Missing text file. @param sid Owning session. @param seq Loader generation. @sideEffects Loads deletion evidence without creating or saving the file. */
   async function loadMissing(path, sid, seq) {
     try {
       const result = await rpc('edrv.missingReview', { sessionId: sid, path })
       if (!loadCurrent(path, seq)) return
-      if (!result.ok) { failLoad(path, sid, seq, result.error); return }
-      if (!result.review) { loadContent(path, sid, true); return }
+      if (!result.ok) { settleGone(path, sid, seq, result); return }
+      if (!result.review) {
+        // 宿主观测到文件仍在磁盘（与读取时的 file-missing 竞态）：重读一次即可；
+        // 同一文件反复抖动时收尾为终态，绝不再递归重读。
+        const attempts = (missingReadRef.current.get(path) ?? 0) + 1
+        missingReadRef.current.set(path, attempts)
+        if (attempts <= 2) { loadContent(path, sid, true); return }
+        settleGone(path, sid, seq, { deleted: true, error: '文件状态在磁盘上反复变化，请稍后重试，或关闭该标签页' })
+        return
+      }
+      missingReadRef.current.delete(path)
       if (dirtyRef.current[path] || savingRef.current.has(path)) { failLoad(path, sid, seq, '文件已删除，但有未保存编辑；请先处理本地缓冲'); return }
       const preview = { ...result.review, sessionId: sid, keepId: crypto.randomUUID(), undoId: crypto.randomUUID() }
       missingRef.current.set(path, preview)
       setMissingPreview(preview)
+      setGoneFile(null)
       setContent('')
       setContentPath(path)
       setLoadError(null)
@@ -1198,6 +1235,7 @@ export function EditorView(props) {
     const seq = ++loadSeqRef.current
     setReceiptLoad({ path, cwd, sessionId: sid, sequence: seq, status: 'loading' })
     setLoadError(null)
+    setGoneFile(null)
     setLargeCandidate(null)
     setPagedFile(null)
     setPageChanged(null)
@@ -4668,6 +4706,25 @@ export function EditorView(props) {
     React.createElement('div', { className: 'edrv-loading-percent' }, Math.round(progress) + '%'),
     retry ? React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: retry }, '重试') : null)
 
+  /**
+   * 渲染缺失文件终态面板：说明 + 重试 + 关闭页签（不显示进度条，避免卡在 0%）。
+   * @private @author ddj 2026年10月31号
+   * @param gone 终态信息
+   * @param retry 重新读取回调
+   * @param close 关闭该标签页回调
+   * @returns 终态面板 React 元素
+   */
+  const goneBody = (gone, retry, close) => React.createElement('div', { className: 'edrv-empty edrv-loading', 'aria-live': 'polite', role: 'status' },
+    React.createElement('div', { className: 'edrv-loading-title' }, gone.title),
+    React.createElement('div', { style: { fontSize: 12, maxWidth: 460, lineHeight: 1.6 } }, gone.message),
+    gone.official
+      ? React.createElement('div', { style: { fontSize: 12, maxWidth: 460, lineHeight: 1.6, opacity: 0.8 } },
+        '待审改动在差异栏：Keep 保留删除结果并结案；Undo 需要该文件的原始内容，磁盘已删除时不可用。')
+      : null,
+    React.createElement('div', { style: { display: 'flex', gap: 8 } },
+      React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: retry }, '重试'),
+      React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: close }, '关闭标签页')))
+
   let body
   if (activePlan) {
     const labels = PLAN_MD_LABELS
@@ -4696,6 +4753,12 @@ export function EditorView(props) {
     body = React.createElement('div', { className: 'edrv-empty' },
       React.createElement('div', null, '暂无打开的文件'),
       React.createElement('div', { style: { fontSize: 12 } }, '使用右上搜索框 (' + (chordOf('edrv.quickOpen') ?? 'Ctrl+P') + ') 打开工作区文件；' + (chordOf('edrv.showCommands') ?? 'Ctrl+Shift+P') + ' 打开命令栏；agent 修改文件后顶部会出现差异角标'))
+  } else if (goneNow) {
+    // 终态：文件已在磁盘删除且没有可用预览。不再显示 0% 进度条，也不无限重试。
+    body = goneBody(goneNow, () => {
+      missingReadRef.current.delete(goneNow.path)
+      loadContent(active, sessionId, true)
+    }, () => { void closeTab(goneNow.path) })
   } else if (content === null && loadError && isSessionMissingError(loadError)) {
     // 跨端会话缺失：终态提示而非加载失败卡死（会话仅在一端激活，本端 RPC 均被拒）
     body = React.createElement('div', { className: 'edrv-empty edrv-loading', 'aria-live': 'polite' },

package/src/missingReview.ts

@@ -2,9 +2,10 @@
 import { createHash, randomUUID } from 'node:crypto'
 import { resolve } from 'node:path'
 import type { DiffRecord, MissingReview } from './shared/types.js'
+import type { MissingRefusal } from './shared/rpc.js'
 import type { Ctx, Session } from './store.js'
 import { archiveRecords, policyOf, READ_CAP, resolveTargetIn, targetPathOf } from './store.js'
-import { hasOfficial } from './reviewDb.js'
+import { hasOfficial, officialPending } from './reviewDb.js'
 import { recordResolved } from './model.js'
 
 interface FrozenReview {
@@ -18,6 +19,32 @@ interface FrozenReview {
 const frozen = new Map<string, FrozenReview>()
 const locks = new Set<string>()
 
+/**
+ * @public
+ * @author ddj 2026年10月31号
+ * @description: 给缺失文件预览的可预期拒绝挂稳定错误码。客户端据此显示终态说明，
+ * 而不是把内部错误原文当「加载失败」反复重试；也不让上游把 SQLite 报错原文透给编辑器。
+ * @param code 稳定错误码（official-covered / no-records / no-evidence / too-large）
+ * @param message 可读原因
+ * @returns 带 code 的 Error
+ */
+export function refusal(code: MissingRefusal, message: string): Error {
+  return Object.assign(new Error(message), { code })
+}
+
+/**
+ * @public
+ * @author ddj 2026年10月31号
+ * @description: 从任意错误里取回缺失文件预览的稳定拒绝码；不是本模块抛出的错误一律返回 undefined。
+ * @param error 捕获到的错误
+ * @returns 稳定拒绝码或 undefined
+ */
+export function refusalCodeOf(error: unknown): MissingRefusal | undefined {
+  const code = (error as { code?: unknown } | null)?.code
+  return code === 'official-covered' || code === 'official-decided' || code === 'no-records'
+    || code === 'no-evidence' || code === 'too-large' ? code : undefined
+}
+
 /** @private @author ddj 2026年10月28号 @param target Resolved absolute path. @returns Platform file identity. */
 function fileKey(target: string): string {
   const normalized = resolve(target).replace(/\\/g, '/')
@@ -67,13 +94,25 @@ export async function missingReview(ctx: Ctx, session: Session, cwd: string, buc
   // 解析结果可能是不透明 FsTarget，凡按路径字符串使用的分支都必须先还原。
   const abs = targetPathOf(ctx, target)
   if (!abs) throw new Error('无法解析目标文件路径')
-  if (hasOfficial(cwd, path) || hasOfficial(cwd, abs)) throw new Error('该文件已有官方审查记录，请使用官方审查入口')
+  // 官方记录覆盖该文件时不再给整文件删除预览：删除内容只能用差异栏的 Keep 结案，
+  // 但必须带稳定错误码，客户端才能显示「已删除」终态而不是卡在加载失败。
+  if (hasOfficial(cwd, path) || hasOfficial(cwd, abs)) {
+    if (!officialPending(cwd, abs) && !officialPending(cwd, path)) {
+      throw refusal('official-decided', '该文件已在磁盘删除，官方审查记录均已处理：可直接关闭该标签页')
+    }
+    throw refusal('official-covered', '该文件已有官方审查记录（磁盘上已删除）：请在差异栏对该待审条目执行 Keep 结案；'
+      + '整文件删除预览只适用于待审历史记录')
+  }
   if (!await fileAbsent(ctx, cwd, abs)) throw new Error('文件已重新出现，请刷新')
   const records = await fileRecords(ctx, cwd, bucket, abs)
   const latest = records.at(-1)
-  if (!records.some((record) => !record.archived && !recordResolved(record))) throw new Error('没有待审历史记录')
-  if (!latest || typeof latest.after !== 'string') throw new Error('缺少可靠的完整历史快照，无法展示或恢复；不会用局部差异拼接文件')
-  if (Buffer.byteLength(latest.after, 'utf8') > READ_CAP) throw new Error('历史快照过大，无法整文件预览')
+  if (!records.some((record) => !record.archived && !recordResolved(record))) {
+    throw refusal('no-records', '磁盘上已没有该文件，且没有待审历史记录：可直接关闭该标签页')
+  }
+  if (!latest || typeof latest.after !== 'string') {
+    throw refusal('no-evidence', '磁盘上已没有该文件，且缺少可靠的完整历史快照，无法展示或恢复；不会用局部差异拼接文件')
+  }
+  if (Buffer.byteLength(latest.after, 'utf8') > READ_CAP) throw refusal('too-large', '磁盘上已没有该文件，且历史快照过大，无法整文件预览')
 
   for (const [token, item] of frozen) if (item.expires < Date.now()) frozen.delete(token)
   if (frozen.size >= 256) throw new Error('缺失文件预览过多，请稍后重试')