dsh-vscode-mode 0.21.0 → 0.21.1

package/package.json

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

@@ -0,0 +1,40 @@
+import type { MissingReview } from '../shared/types.js'
+import { splitLines } from '../shared/diff.js'
+
+/** @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 {
+    callId: review.callIds[0], idx: 0, start: 1, end: 1, oldStart: 1,
+    oldLines: splitLines(review.content.replace(/\r\n/g, '\n')), newLines: [], whole: true,
+    status: 'pending', create: false, superseded: false, sourceKind: 'missing',
+  }
+}
+
+interface MissingBatchApi {
+  query(path: string): Promise<{ ok: true; review: MissingReview | null } | { ok: false; error: string }>
+  decide(review: MissingReview, operationId: string): Promise<{ ok: true; callIds: string[] } | { ok: false; error: string }>
+  guard(): void
+  operation(review: MissingReview): string
+  committed(review: MissingReview, callIds: string[]): void
+}
+
+/** @public @author ddj 2026年10月28号 @param paths Batch paths. @param api Guarded Host access. @returns Missing paths handled once; a partial failure stops before legacy hunk writes. @throws Missing evidence, changed lifecycle or Host decision failure. */
+export async function missingBatch(paths: string[], api: MissingBatchApi): Promise<Set<string>> {
+  const candidates: MissingReview[] = []
+  for (const path of new Set(paths)) {
+    api.guard()
+    const result = await api.query(path)
+    if (!result.ok) throw new Error(result.error)
+    if (result.review) candidates.push(result.review)
+  }
+
+  const completed = new Set<string>()
+  for (const review of candidates) {
+    api.guard()
+    const result = await api.decide(review, api.operation(review))
+    if (!result.ok) throw new Error(`已处理 ${completed.size} 个删除文件，其余未处理。${result.error}`)
+    completed.add(review.path)
+    api.committed(review, result.callIds)
+  }
+  return completed
+}

package/src/client/ui/EditorView.ts

@@ -61,6 +61,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 { QuickOpen } from './QuickOpen.js'
 import { attachHorizontalWheel } from './horizontalWheel.js'
 import { CommandPalette } from './CommandPalette.js'
@@ -319,6 +320,9 @@ export function EditorView(props) {
   const [dirtyMap, setDirtyMap] = React.useState({})
   const [content, setContent] = React.useState(null)
   const [contentPath, setContentPath] = React.useState(null)
+  const [missingPreview, setMissingPreview] = React.useState(null)
+  const missingRef = React.useRef(new Map())
+  const missingNow = missingPreview?.path === active && missingPreview?.sessionId === sessionId ? missingPreview : null
   const [receiptLoad, setReceiptLoad] = React.useState(null) // { sessionId, path, sequence, status, error }
   const [imageSrc, setImageSrc] = React.useState(null) // 图片预览 data URL（图片 tab 专用，文本 tab 恒为 null）
   const [imgSize, setImgSize] = React.useState(null) // 图片自然尺寸 { w, h }（路径栏 meta）
@@ -634,17 +638,25 @@ export function EditorView(props) {
     const trace = isDebug() && contentReady && currentRecords.length > 0
     const start = trace ? performance.now() : 0
     // #endregion
-    const next = officialDetail
-      ? reviewRegions(officialDetail.diff, officialDetail.item.id, officialDetail.blocks ?? [], contentReady ? content : null)
-      : diffRegions(currentRecords, contentReady ? content : null).filter((r) => !r.superseded)
+    let next
+    if (officialDetail) {
+      next = reviewRegions(officialDetail.diff, officialDetail.item.id, officialDetail.blocks ?? [], contentReady ? content : null)
+    } else if (missingNow && contentReady) {
+      next = missingNow.resolved ? [] : [missingRegion(missingNow)]
+    } else {
+      next = diffRegions(currentRecords, contentReady ? content : null).filter((r) => !r.superseded)
+    }
     // #region debug log
     if (trace) {
       try { dbg(sessionId, `[DEBUG diffRegions] records=${currentRecords.length} bytes=${content.length} regions=${next.length} ms=${(performance.now() - start).toFixed(1)}`) } catch (e) { /* 诊断不可影响渲染 */ }
     }
     // #endregion
     return next
-  }, [currentRecords, content, contentPath, active, officialDetail])
+  }, [currentRecords, content, contentPath, active, officialDetail, missingNow])
   // useMemo 稳定引用：否则 hover 等重渲染会让 view zone effect 反复重建（- 号闪烁）
+  React.useEffect(() => {
+    editorRef.current?.updateOptions({ readOnly: !!missingNow })
+  }, [missingNow, active, content, monaco])
   const pendingRegions = React.useMemo(() => regions.filter((r) => r.status === ST.PENDING && !r.stale), [regions])
   const staleRegions = React.useMemo(() => regions.filter((r) => r.status === ST.PENDING && r.stale), [regions])
   const staleMissing = staleRegions.filter((region) => region.staleReason === 'missing').length
@@ -1109,7 +1121,10 @@ export function EditorView(props) {
     /** @author ddj 2026年09月28号 @param res Disk content for a still-clean cached model. */
     const accept = (res) => {
       if (!loadCurrent(path, sequence) || dirtyRef.current[path] || model.getValue() !== before) return
+      if (res?.code === 'file-missing') { void loadMissing(path, sid, sequence); return }
       if (!res?.ok) return
+      missingRef.current.delete(path)
+      setMissingPreview(null)
       mark(res.version)
       if (res.content === before) return
       saveViewState(path)
@@ -1130,6 +1145,27 @@ 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. */
+  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 (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)
+      setContent('')
+      setContentPath(path)
+      setLoadError(null)
+      setError(null)
+      stampLoad(path, sid, seq)
+      setLoadStage({ progress: 100, message: '文件已删除 · 展示最后记录快照' })
+      setStatus('文件已删除 · 展示最后记录快照（只读）')
+    } catch (cause) { if (loadCurrent(path, seq)) failLoad(path, sid, seq, String(cause)) }
+  }
+
   const loadContent = (path, sid, force, version) => {
     const seq = ++loadSeqRef.current
     setReceiptLoad({ path, cwd, sessionId: sid, sequence: seq, status: 'loading' })
@@ -1176,7 +1212,7 @@ export function EditorView(props) {
       loadPdf(path, sid, seq, force === true, version)
       return
     }
-    const cachedModel = force ? null : modelsRef.current.get(path)
+    const cachedModel = force || missingRef.current.has(path) ? null : modelsRef.current.get(path)
     if (cachedModel) {
       // model 命中：直接显示其内容（切 tab 零等待），后台静默校验
       setContent(cachedModel.getValue())
@@ -1199,6 +1235,8 @@ export function EditorView(props) {
       // #endregion
       if (!loadCurrent(path, seq)) return
       if (res && res.ok) {
+        missingRef.current.delete(path)
+        setMissingPreview(null)
         mark(res.version, true)
         setContent(res.content)
         setContentPath(path)
@@ -1206,6 +1244,7 @@ export function EditorView(props) {
         setLoadStage((prev) => ({ progress: Math.max(84, prev.progress), message: '文件已读取，准备创建编辑器…' }))
         setStatus('已加载')
       } else {
+        if (res?.code === 'file-missing') { void loadMissing(path, sid, seq); return }
         if (res?.code === 'file-too-large') setLargeCandidate(JSON.stringify([scope, sid, path]))
         const base = res?.error ? String(res.error) : '读取失败'
         dapTrace('read-failed', { path, error: base, resolvedPath: res?.resolvedPath, cwd })
@@ -1409,6 +1448,9 @@ export function EditorView(props) {
       emitRefresh({ scope, paths: [change.path], kind: 'text', eventId })
       return
     }
+    if (change.kind === 'deleted' && change.path === activeRef.current && !dirtyRef.current[change.path] && !savingRef.current.has(change.path)) {
+      loadContent(change.path, sessionId, true)
+    }
     const kind = change.kind === 'deleted' ? 'deleted' : 'conflict'
     markDiskFlag(readSync(scope, change.path) ?? { path: change.path, kind, at: Date.now() })
     setStatus(kind === 'deleted' ? '文件已被外部删除' : '外部已修改（未保存的编辑保留）')
@@ -2351,6 +2393,7 @@ export function EditorView(props) {
   /** @private @author ddj 2026年10月14号 @param path Canonical path. @param manual Explicit save. @returns Guarded save, never another pane's content. */
   function saveDocument(path, manual) {
     if (isExcelPath(path)) return Promise.resolve({ ok: false })
+    if (missingRef.current.has(path)) { setStatus('删除预览只读；请使用 Keep / Undo'); return Promise.resolve({ ok: false }) }
     const model = modelsRef.current.get(path)
     if (!model) return Promise.resolve({ ok: false })
     const store = documents()
@@ -2409,7 +2452,7 @@ export function EditorView(props) {
     const ed = editorRef.current
     const model = ed?.getModel()
     const path = [...modelsRef.current].find(([, item]) => item === model)?.[0]
-    if (!ed || !path) return
+    if (!ed || !path || missingRef.current.has(path)) return
     setDirtyMap((d) => Object.assign({}, d, { [path]: true }))
     // 编辑即「使用」：需求 2 的淘汰口径是「最近没有改动」，故有改动时刷新 LRU 序号，
     // 使长时间只在某文件里编辑的页签不会被其它文件的打开动作挤出。
@@ -2533,6 +2576,7 @@ export function EditorView(props) {
     const side = layoutRef.current === 'side'
     const ed = m.editor.create(node, {
       value: '',
+      readOnly: missingRef.current.has(activeRef.current),
       language: 'plaintext',
       theme: themeNameOf(),
       fontFamily: 'var(--ds-font-family-code, ui-monospace, monospace)',
@@ -3149,6 +3193,7 @@ export function EditorView(props) {
    * @returns Promise<boolean> 是否成功
    */
   const actHunk = (region, reject, silent) => {
+    if (region.sourceKind === 'missing') return decideMissing(reject)
     if (region.sourceKind === 'official') return decideOfficial(reject, region.id)
     const method = reject ? 'edrv.reject' : 'edrv.accept'
     // #region debug log
@@ -3280,7 +3325,35 @@ export function EditorView(props) {
     finally { batchBusyRef.current = false }
   }
 
+  /** @private @author ddj 2026年10月28号 @param reject Restore the shown snapshot instead of keeping absence. @returns Safe whole-file decision, never a hunk reversal. */
+  async function decideMissing(reject) {
+    if (batchBusyRef.current || !missingNow || missingNow.resolved) return false
+    const preview = missingNow
+    const lifetime = reviewLifeRef.current
+    batchBusyRef.current = true
+    setReviewBatchBusy(true)
+    try {
+      guardReviewAll(reject, lifetime)
+      const result = await rpc('edrv.missingDecide', { sessionId, token: preview.token, operationId: reject ? preview.undoId : preview.keepId, undo: reject })
+      if (!lifetime?.live) return false
+      if (!result.ok) { setError(result.error); return false }
+      setRecords((previous) => Object.fromEntries(Object.entries(previous).filter(([id]) => !result.callIds.includes(id))))
+      missingRef.current.set(preview.path, { ...preview, resolved: true })
+      if (activeRef.current === preview.path) {
+        if (reject) loadContent(preview.path, sessionId, true)
+        else setMissingPreview({ ...preview, resolved: true })
+      }
+      refreshRecords()
+      emitRefresh({ scope, paths: [preview.path], kind: 'structure' })
+      setStatus(reject ? '已恢复展示的完整历史快照' : '已保留文件删除')
+      setError(null)
+      return true
+    } catch (cause) { if (lifetime?.live) setError(String(cause)); return false }
+    finally { batchBusyRef.current = false; if (lifetime?.live) setReviewBatchBusy(false) }
+  }
+
   const acceptFile = () => {
+    if (missingNow && !officialDetail) return decideMissing(false)
     if (officialDetail) return decideOfficial(false)
     if (batchBusyRef.current || !decideRegions.length) return
     batchBusyRef.current = true
@@ -3293,6 +3366,7 @@ export function EditorView(props) {
     }).catch(() => { batchBusyRef.current = false })
   }
   const undoFile = () => {
+    if (missingNow && !officialDetail) return decideMissing(true)
     if (officialDetail) return decideOfficial(true)
     if (batchBusyRef.current || !decideRegions.length) return
     batchBusyRef.current = true
@@ -3325,18 +3399,47 @@ export function EditorView(props) {
    * @author ddj 2026年08月20号
    * @param reject true=全部不采纳（回滚），false=全部采纳
    */
-  const actAllPending = (reject) => {
+  const actAllPending = async (reject) => {
     if (batchBusyRef.current || !allPending.length) return
+    const lifetime = reviewLifeRef.current
     batchBusyRef.current = true
     const list = reject ? [...allPending].sort((a, b) => (a.at < b.at ? 1 : a.at > b.at ? -1 : b.idx - a.idx)) : allPending
     const paths = [...new Set(list.map((r) => records[r.callId]?.path).filter(Boolean))]
-    return actMany(list.map((r) => itemOf(r, reject))).then((result) => {
-      batchBusyRef.current = false
-      reloadFile(true)
-      emitRefresh({ scope, paths: paths.length ? paths : undefined, kind: 'structure' })
-      setStatus(decideStatus(reject ? '已不采纳 ' : '已采纳 ', result))
-      if (result.fail) setError(result.fail + ' 处差异处理失败（可能已被后续修改影响），可刷新后重试')
-    }).catch(() => { batchBusyRef.current = false })
+    try {
+      const handled = await missingBatch(paths, {
+        query: async (path) => {
+          // The active deletion must use exactly the evidence the user saw.
+          const cached = missingRef.current.get(path)
+          if (cached?.sessionId === sessionId && !cached.resolved) return { ok: true, review: cached }
+          const result = await rpc('edrv.missingReview', { sessionId, path })
+          if (result.ok && result.review) {
+            const preview = { ...result.review, sessionId, keepId: crypto.randomUUID(), undoId: crypto.randomUUID() }
+            missingRef.current.set(path, preview)
+            return { ok: true, review: preview }
+          }
+          return result
+        },
+        decide: (preview, operationId) => rpc('edrv.missingDecide', { sessionId, token: preview.token, operationId, undo: reject }),
+        guard: () => guardReviewAll(reject, lifetime),
+        operation: (preview) => reject ? preview.undoId : preview.keepId,
+        committed: (preview, callIds) => {
+          if (!lifetime?.live) return
+          missingRef.current.set(preview.path, { ...preview, resolved: true })
+          setRecords((previous) => Object.fromEntries(Object.entries(previous).filter(([id]) => !callIds.includes(id))))
+          if (!reject && sameFile(activeRef.current, preview.path)) setMissingPreview({ ...preview, path: activeRef.current, sessionId, resolved: true })
+          emitRefresh({ scope, paths: [preview.path], kind: 'structure' })
+        },
+      })
+      guardReviewAll(reject, lifetime)
+      const remaining = list.filter((item) => !handled.has(records[item.callId]?.path))
+      const result = await actMany(remaining.map((item) => itemOf(item, reject)))
+      if (!lifetime?.live) return
+      if (reject || !missingNow) reloadFile(true)
+      emitRefresh({ scope, paths, kind: 'structure' })
+      setStatus(decideStatus(reject ? '已不采纳 ' : '已采纳 ', result) + `；删除文件 ${handled.size} 个`)
+      if (result.fail) setError(result.fail + ' 处差异处理失败，可刷新后重试')
+    } catch (cause) { if (lifetime?.live) setError(String(cause)) }
+    finally { batchBusyRef.current = false; if (lifetime?.live) refreshRecords() }
   }
   /** @private @author ddj 2026年10月27号 @param reject Undo requires every local buffer to be saved. @param token Starting session lifetime. @returns Throws before the next mutation when unsafe. */
   function guardReviewAll(reject, token) {
@@ -4584,6 +4687,7 @@ export function EditorView(props) {
   const reviewErrorText = !rawReviewError ? undefined : sessionDown ? SESSION_DOWN_NOTICE : sessionErrorText(rawReviewError)
   const buildDockSnapshot = () => ({
     mode: editorDockMode(active),
+    missingDeletion: !!missingNow,
     official: officialFile ? { sessionId, page: review.page, path: officialFile,
       pending: sum.files.find((file) => sameFile(file.path, active))?.pending ?? 0,
       detail: officialDetail, records: officialRecords, onSelect: setSelectedReview } : null,

package/src/client/ui/SidecarDiffBar.tsx

@@ -22,6 +22,7 @@ export interface SidecarRegion {
 /** 侧车栏输入：字段与官方栏对齐，缺的是官方记录元数据，多的是侧车区域的 keep/undo 能力。 */
 export interface SidecarBarProps {
   activePath?: string
+  missingDeletion?: boolean
   pendingRegions?: SidecarRegion[]
   staleRegions?: SidecarRegion[]
   diffIdx?: number
@@ -115,6 +116,7 @@ export function SidecarDiffBar(props: SidecarBarProps): React.ReactElement {
       keepTitle="把这批历史改动全部标记为已看过（只改记录，不动磁盘文件）"
       undoTitle="逐项撤销这些历史改动；缺少证据或遇到冲突即停止"
     />
+    {props.missingDeletion ? <div className="edrv-review-notice" role="status">文件已删除 · 展示最后记录快照。Keep 保留删除；Undo 恢复展示的完整快照。</div> : null}
     {busy ? <div className="edrv-review-notice" role="status">正在处理历史改动…</div> : null}
     {down ? <div className="edrv-review-notice edrv-review-notice-warn edrv-sidecar-down" role="status">
       <span className="edrv-sidecar-down-text">{down.text}</span>
@@ -137,8 +139,8 @@ export function SidecarDiffBar(props: SidecarBarProps): React.ReactElement {
         {navButton('down', '下一个差异', props.onNextDiff, !count, view.navNextTitle)}
       </div>
       <div className="edrv-review-actions">
-        <Button size="sm" variant="ghost" className="edrv-review-undo" icon={barIcon('undo')} onClick={props.onUndoFile} disabled={!canDecide} title={SIDECAR_UNDO_TITLE}>Undo</Button>
-        <Button size="sm" variant="primary" className="edrv-review-keep" icon={barIcon('check')} onClick={props.onAcceptFile} disabled={!canDecide} title={SIDECAR_KEEP_TITLE}>Keep</Button>
+        <Button size="sm" variant="ghost" className="edrv-review-undo" icon={barIcon('undo')} onClick={props.onUndoFile} disabled={!canDecide} title={props.missingDeletion ? '恢复展示的完整历史快照（不会覆盖重新出现的文件）' : SIDECAR_UNDO_TITLE}>Undo</Button>
+        <Button size="sm" variant="primary" className="edrv-review-keep" icon={barIcon('check')} onClick={props.onAcceptFile} disabled={!canDecide} title={props.missingDeletion ? '保持文件删除并结清覆盖的待审历史记录，不写文件' : SIDECAR_KEEP_TITLE}>Keep</Button>
         <Button size="sm" variant="ghost" className="edrv-review-details" onClick={() => setExpanded(!expanded)} aria-expanded={expanded} aria-label={expanded ? '收起差异' : '展开差异'} title={expanded ? '收起差异' : '展开差异'}>详情{barIcon(expanded ? 'up' : 'down')}</Button>
         <Menu open={menu === 'more'} anchor={moreTrigger} items={[{ id: 'pending', label: '差异总览' }, { id: 'archive', label: '归档 / 历史' }, { id: 'rollback', label: '回滚当前文件' }, { id: 'refresh', label: '刷新' }]} onSelect={(id: string) => {
           if (id === 'rollback') { setMenu(null); props.onRollback?.(); return }

package/src/missingReview.ts

@@ -0,0 +1,127 @@
+/** Missing historical files: frozen, whole-file deletion reviews. */
+import { createHash, randomUUID } from 'node:crypto'
+import { resolve } from 'node:path'
+import type { DiffRecord, MissingReview } from './shared/types.js'
+import type { Ctx, Session } from './store.js'
+import { archiveRecords, policyOf, READ_CAP, resolveTargetIn } from './store.js'
+import { hasOfficial } from './reviewDb.js'
+import { recordResolved } from './model.js'
+
+interface FrozenReview {
+  view: MissingReview
+  cwd: string
+  session: Session
+  revision: string
+  expires: number
+  operation?: { id: string; undo: boolean; restored: boolean; done: boolean }
+}
+const frozen = new Map<string, FrozenReview>()
+const locks = new Set<string>()
+
+/** @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, '/')
+  return process.platform === 'win32' ? normalized.toLowerCase() : normalized
+}
+
+/** @private @author ddj 2026年10月28号 @param records Ordered records. @returns Full evidence and decision revision, excluding transient conflict flags. */
+function revisionOf(records: DiffRecord[]): string {
+  const evidence = records.map(({ callId, path, at, after, hunks, decisions, archived, superseded }) =>
+    ({ callId, path, at, after, hunks, decisions, archived, superseded }))
+  return createHash('sha256').update(JSON.stringify(evidence)).digest('hex')
+}
+
+/** @private @author ddj 2026年10月28号 @param ctx Host capability. @param cwd Workspace. @param bucket Records. @param target Resolved file. @returns Records for the same physical path spelling, oldest first. */
+async function fileRecords(ctx: Ctx, cwd: string, bucket: Map<string, DiffRecord>, target: string): Promise<DiffRecord[]> {
+  const matches: DiffRecord[] = []
+  const identity = fileKey(target)
+  for (const record of bucket.values()) {
+    if (record.superseded) continue
+    if (fileKey(await resolveTargetIn(ctx, cwd, record.path)) === identity) matches.push(record)
+  }
+  return matches.sort((left, right) => left.at.localeCompare(right.at))
+}
+
+/** @public @author ddj 2026年10月28号 @param ctx Host. @param cwd Workspace. @param path Requested file. @returns True only for confirmed absence; directories and IO failures are not missing files. */
+export async function fileAbsent(ctx: Ctx, cwd: string, path: string): Promise<boolean> {
+  const fs = ctx.get('fs')
+  if (!fs) throw new Error('缺少 fs')
+  const target = await resolveTargetIn(ctx, cwd, path)
+  try { return !(await fs.stat(target)) }
+  catch (error) {
+    if (['ENOENT', 'FS_NOT_FOUND'].includes(String((error as { code?: string }).code))) return true
+    throw error
+  }
+}
+
+/** @public @author ddj 2026年10月28号 @param ctx Host. @param session Live session. @param cwd Workspace. @param bucket Records. @param path Requested file. @returns Frozen complete snapshot; never constructs text from hunks or writes files. @throws Missing evidence or nonmissing target. */
+export async function missingReview(ctx: Ctx, session: Session, cwd: string, bucket: Map<string, DiffRecord>, path: string): Promise<MissingReview> {
+  const target = await resolveTargetIn(ctx, cwd, path)
+  if (hasOfficial(cwd, path) || hasOfficial(cwd, target)) throw new Error('该文件已有官方审查记录，请使用官方审查入口')
+  if (!await fileAbsent(ctx, cwd, target)) throw new Error('文件已重新出现，请刷新')
+  const records = await fileRecords(ctx, cwd, bucket, target)
+  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('历史快照过大，无法整文件预览')
+
+  for (const [token, item] of frozen) if (item.expires < Date.now()) frozen.delete(token)
+  if (frozen.size >= 256) throw new Error('缺失文件预览过多，请稍后重试')
+  const view: MissingReview = { token: randomUUID(), path, content: latest.after, callIds: records.filter((record) => !record.archived && !recordResolved(record)).map((record) => record.callId), at: latest.at }
+  frozen.set(view.token, { view, cwd, session, revision: revisionOf(records), expires: Date.now() + 30 * 60_000 })
+  return view
+}
+
+/** @private @author ddj 2026年10月28号 @param ctx Host. @param item Frozen evidence. @param target Resolved path. @param undo Restore instead of keeping absence. @sideEffects Atomically creates absent file, verifies exact bytes; retries never overwrite an existing file. */
+async function applyDisk(ctx: Ctx, item: FrozenReview, target: string, undo: boolean): Promise<void> {
+  const fs = ctx.get('fs')
+  const absent = await fileAbsent(ctx, item.cwd, target)
+  if (!undo) { if (!absent) throw new Error('文件已重新出现，未执行 Keep'); return }
+  const operation = item.operation!
+  if (!absent && !operation.restored) throw new Error('文件已重新出现，未执行 Undo')
+  if (absent && !operation.restored) {
+    // Publish through the official capability and session sandbox, never unconditional overwrite.
+    await fs.writeText(target, item.view.content, { kind: 'createIfAbsent' }, undefined, policyOf(ctx, item.session))
+    operation.restored = true
+  }
+  if (absent && operation.restored && !await fs.stat(target)) throw new Error('恢复后的文件再次缺失，未结清记录')
+  if (await fs.readText(target) !== item.view.content) throw new Error('恢复内容校验失败，未结清记录')
+}
+
+/** @public @author ddj 2026年10月28号 @param ctx Host. @param session Requesting session. @param cwd Workspace. @param bucket Records. @param token Frozen preview token. @param operationId Stable retry ID. @param undo True restores shown snapshot; false keeps deletion. @returns Covered call IDs. @throws Changed evidence, concurrent action or sandbox/IO failure. */
+export async function missingDecide(ctx: Ctx, session: Session, cwd: string, bucket: Map<string, DiffRecord>, token: string, operationId: string, undo: boolean): Promise<string[]> {
+  const item = frozen.get(token)
+  if (!item || item.expires < Date.now() || item.cwd !== cwd || item.session.id !== session.id) throw new Error('删除预览已过期，请刷新后重试')
+  if (!operationId || operationId.length > 128) throw new Error('缺少有效操作 ID')
+  const target = await resolveTargetIn(ctx, cwd, item.view.path)
+  const key = JSON.stringify([cwd, fileKey(target)])
+  if (locks.has(key)) throw new Error('该文件正在处理，请稍后重试')
+  locks.add(key)
+  item.session = session
+  try { return await commitMissing(ctx, item, bucket, target, operationId, undo) }
+  finally { locks.delete(key) }
+}
+
+/** @private @author ddj 2026年10月28号 @param ctx Host. @param item Frozen preview. @param bucket Live records. @param target Resolved target. @param operationId Retry identity. @param undo Restore action. @returns Archived pending call IDs; disk success survives bookkeeping failure in the same Host lifetime. */
+async function commitMissing(ctx: Ctx, item: FrozenReview, bucket: Map<string, DiffRecord>, target: string, operationId: string, undo: boolean): Promise<string[]> {
+  const previous = item.operation
+  if (previous && (previous.id !== operationId || previous.undo !== undo)) throw new Error('已有不同操作，请刷新后重试')
+  if (previous?.done) return item.view.callIds
+  if (hasOfficial(item.cwd, target) || hasOfficial(item.cwd, item.view.path)) throw new Error('该文件已有官方审查记录，请刷新')
+  const records = await fileRecords(ctx, item.cwd, bucket, target)
+  if (revisionOf(records) !== item.revision) throw new Error('历史记录已变化，请刷新删除预览')
+  item.operation ??= { id: operationId, undo, restored: false, done: false }
+  await applyDisk(ctx, item, target, undo)
+
+  // Recheck after awaited IO: capture/another review must not silently join this decision.
+  const current = await fileRecords(ctx, item.cwd, bucket, target)
+  if (revisionOf(current) !== item.revision) throw new Error('历史记录已变化，未结清记录，请刷新')
+  const pending = current.filter((record) => item.view.callIds.includes(record.callId))
+  const decisions = pending.map((record) => record.decisions)
+  const decision = undo ? 'rejected' : 'accepted'
+  for (const record of pending) record.decisions = { call: decision, perHunk: record.hunks.map(() => decision) }
+  try { await archiveRecords(ctx, item.session, item.cwd, bucket, pending, undo ? '已恢复删除文件快照' : '已保留文件删除') }
+  catch (error) { pending.forEach((record, index) => { record.decisions = decisions[index] }); throw error }
+  item.operation.done = true
+  return item.view.callIds
+}

package/src/rpc.ts

@@ -60,6 +60,7 @@ import type { FileVersions } from './fileVersions.js'
 import { settingsDocPath } from './settingsDocPath.js'
 import { createTextPages } from './textPages.js'
 import { reviewHandlers } from './reviewRpc.js'
+import { fileAbsent, missingReview, missingDecide } from './missingReview.js'
 
 /** Process-local cursor signer; reads must stay on the Host filesystem capability. */
 const readTextPage = createTextPages()
@@ -169,20 +170,19 @@ async function readTargetOf(
   ctx: Ctx,
   sc: SessionScope,
   path: string,
-): Promise<ReadTargetOk | { err: string; resolvedPath?: string; code?: 'file-too-large' }> {
+): Promise<ReadTargetOk | { err: string; resolvedPath?: string; code?: 'file-too-large' | 'file-missing' }> {
   const fs = ctx.get('fs')
   if (!fs) return { err: '缺少 fs' }
   try {
     const target = await resolveTargetIn(ctx, sc.cwd, path)
     debugRecord(ctx, sc.cwd, '[DEBUG path.resolve] input=' + String(path ?? '') + ' resolved=' + fs.processPath(target), 'debug')
     const info = await fs.stat(target)
-    if (!info || info.type !== 'file') {
-      // 带上解析后的真实路径：跳转失败时可直接看出是路径解析错还是目标本身不存在
-      return { err: '文件不存在', resolvedPath: fs.processPath(target) }
-    }
+    if (!info) return { err: '文件不存在', resolvedPath: fs.processPath(target), code: 'file-missing' }
+    if (info.type !== 'file') return { err: '目标不是文件', resolvedPath: fs.processPath(target) }
     if ((info.size ?? 0) > BINARY_READ_CAP) return { err: '文件过大（>32MB），不支持整文件预览', code: 'file-too-large' }
     return { target, fs, info }
   } catch (error) {
+    if (['ENOENT', 'FS_NOT_FOUND'].includes(String((error as { code?: string }).code))) return { err: '文件不存在', code: 'file-missing' }
     return { err: '读取失败：' + String(error) }
   }
 }
@@ -193,7 +193,7 @@ async function readTargetOf(
  * @param prep readTargetOf 的失败分支
  * @returns { ok:false } 形态载荷
  */
-function targetErrOf(prep: { err: string; resolvedPath?: string; code?: 'file-too-large' }): { ok: false; error: string; resolvedPath?: string; code?: 'file-too-large' } {
+function targetErrOf(prep: { err: string; resolvedPath?: string; code?: 'file-too-large' | 'file-missing' }): { ok: false; error: string; resolvedPath?: string; code?: 'file-too-large' | 'file-missing' } {
   return { ok: false, error: prep.err,
     ...(prep.resolvedPath !== undefined ? { resolvedPath: prep.resolvedPath } : {}),
     ...(prep.code ? { code: prep.code } : {}) }
@@ -290,6 +290,15 @@ async function applyDecisions(
       results.push({ callId: item.callId, ok: false, error: '记录已归档，无法重复决策' })
       continue
     }
+    try {
+      if (await fileAbsent(ctx, cwd, record.path)) {
+        results.push({ callId: item.callId, ok: false, error: '文件已删除，请刷新后按整文件删除预览执行 Keep / Undo' })
+        continue
+      }
+    } catch (error) {
+      results.push({ callId: item.callId, ok: false, error: '无法确认文件状态：' + String(error) })
+      continue
+    }
     // 重试已执行的决定只补持久化，不能再次修改磁盘上的同一个 hunk。
     const previous = item.scope === 'hunk'
       ? record.decisions.perHunk[item.hunkIndex ?? -1] : record.decisions.call
@@ -693,6 +702,23 @@ export function buildHandlers(
       if (!item?.ok) return { ok: false, error: item?.error ?? '操作失败' }
       return { ok: true, record: item.record! }
     },
+    'edrv.missingReview': async (args) => {
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      try {
+        const bucket = await bucketOf(registry, ctx, sc.cwd)
+        if (!await fileAbsent(ctx, sc.cwd, args.path)) return { ok: true, review: null }
+        return { ok: true, review: await missingReview(ctx, sc.session, sc.cwd, bucket, args.path) }
+      } catch (error) { return { ok: false, error: String(error) } }
+    },
+    'edrv.missingDecide': async (args) => {
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      try {
+        const bucket = await bucketOf(registry, ctx, sc.cwd)
+        return { ok: true, callIds: await missingDecide(ctx, sc.session, sc.cwd, bucket, args.token, args.operationId, args.undo === true) }
+      } catch (error) { return { ok: false, error: String(error) } }
+    },
     'edrv.decideBatch': async (args) => {
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }

package/src/shared/rpc.ts

@@ -377,6 +377,8 @@ export interface RpcRequestMap {
   'edrv.reject': { sessionId?: string; callId: string; scope?: RpcScope; hunkIndex?: number }
   'edrv.decideBatch': { sessionId?: string; items: DecideItem[] }
   'edrv.textPage': import('./textPages.js').TextPageArgs
+  'edrv.missingReview': { sessionId?: string; path: string }
+  'edrv.missingDecide': { sessionId?: string; token: string; operationId: string; undo: boolean }
   'edrv.read': { sessionId?: string; path: string; encoding?: 'base64' }
   'edrv.readBinary': { sessionId?: string; path: string }
   'edrv.versions': { sessionId?: string; paths: string[] }
@@ -549,6 +551,8 @@ export interface RpcOkMap {
   'edrv.reject': { record: RecordView }
   'edrv.decideBatch': { results: DecideResult[] }
   'edrv.textPage': Extract<import('./textPages.js').TextPageResult, { ok: true }>
+  'edrv.missingReview': { review: import('./types.js').MissingReview | null }
+  'edrv.missingDecide': { callIds: string[] }
   'edrv.read': { content: string; size: number; encoding?: 'base64'; mime?: string; version?: string }
   'edrv.readBinary': { binary: BinaryReadPayload }
   'edrv.versions': { items: FileVersionItem[] }
@@ -707,7 +711,7 @@ export interface RpcOkMap {
 /** 统一响应：{ok:true, ...payload} 或 {ok:false, error}。 */
 export type RpcResult<M extends RpcMethod> =
   | ({ ok: true } & RpcOkMap[M])
-  | { ok: false; error: string; code?: 'file-too-large'; reason?: Extract<import('./textPages.js').TextPageResult, { ok: false }>['reason'] }
+  | { ok: false; error: string; code?: 'file-too-large' | 'file-missing'; reason?: Extract<import('./textPages.js').TextPageResult, { ok: false }>['reason'] }
 
 /** 每个方法的 handler 签名（host 分发表与 client 类型检查共用）。 */
 export type RpcHandler<M extends RpcMethod> = (

package/src/shared/types.ts

@@ -8,6 +8,15 @@
  * 作者 ddj 2026-08-20
  */
 
+/** Frozen whole-file deletion preview, backed by a complete Host snapshot. */
+export interface MissingReview {
+  token: string
+  path: string
+  content: string
+  callIds: string[]
+  at: string
+}
+
 /** 单条差异块的决策状态。 */
 export type Decision = 'pending' | 'accepted' | 'rejected'