dsh-vscode-mode 0.23.3 → 0.23.5

package/package.json

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

@@ -44,7 +44,11 @@ function pendingRowsOf(page: ReviewPage | null): { rows: DiffFile[]; covered: Se
   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,

package/src/pending/decide.ts

@@ -206,8 +206,15 @@ export function capabilityOf(entry: PendingEntry, flags: PendingFlags): { keep:
  * @author ddj 2026年10月29号
  * @description: 供详情接口复用的差异构造。
  * @param entry 待审条目
+ * @param baselineEmpty 基线置空：文件由本次会话新建，旧基线只是会话自己的中间产物
  * @returns 官方差异
  */
-export function diffOf(entry: PendingEntry): OfficialDiff {
-  return textDiff(entry.path, entry.path, entry.oldText, entry.newText)
+export function diffOf(entry: PendingEntry, baselineEmpty = false): OfficialDiff {
+  if (!baselineEmpty) return textDiff(entry.path, entry.path, entry.oldText, entry.newText)
+  // 空基线在按行切分时会留下一个空行，差异里会多出一条「删空行」；新增文件应当只有新增行，
+  // 与官方整文件新增块（oldLines=0、全是 + 行）保持同一形状。
+  if (entry.newText === '') return textDiff(entry.path, entry.path, '', '')
+  const diff = textDiff(entry.path, entry.path, '', entry.newText)
+  if (diff.kind !== 'text') return diff
+  return { ...diff, hunks: diff.hunks.map((hunk) => ({ ...hunk, oldLines: 0, lines: hunk.lines.filter((line) => line !== '-') })) }
 }

package/src/pending/store.ts

@@ -25,10 +25,11 @@ import {
  * @author ddj 2026年10月29号
  * @description: 统计一次差异的增删行数；非文本差异统一记 0/0。
  * @param entry 待审条目
+ * @param baselineEmpty 基线置空（新建文件按全量新增计）
  * @returns 增删行数
  */
-function countsOf(entry: PendingEntry): { added: number; deleted: number } {
-  const diff = diffOf(entry)
+function countsOf(entry: PendingEntry, baselineEmpty = false): { added: number; deleted: number } {
+  const diff = diffOf(entry, baselineEmpty)
   if (diff.kind !== 'text') return { added: 0, deleted: 0 }
   let added = 0
   let deleted = 0
@@ -93,11 +94,12 @@ export function foldWrite(stored: StoredEntry | undefined, write: PendingWrite):
  * @author ddj 2026年10月29号
  * @description: 条目转列表投影，已解决条目仍保留但不可再决定。
  * @param stored 条目与标记
+ * @param baselineEmpty 基线置空（新建文件按全量新增计）
  * @returns 列表项
  */
-export function itemOf(stored: StoredEntry): PendingItem {
+export function itemOf(stored: StoredEntry, baselineEmpty = false): PendingItem {
   const { entry, flags } = stored
-  const counts = countsOf(entry)
+  const counts = countsOf(entry, baselineEmpty)
   const item: PendingItem = {
     id: entry.id,
     path: entry.path,
@@ -123,12 +125,13 @@ export function itemOf(stored: StoredEntry): PendingItem {
  * @description: 读一页待审条目，按更新时间升序；会话过滤走血缘集合。
  * @param cwd 工作区
  * @param sessionId 当前会话
+ * @param wholeAdd 本次会话新建的文件身份集合，命中时基线置空
  * @returns 列表
  */
-export function loadPage(cwd: string, sessionId?: string): PendingPage {
+export function loadPage(cwd: string, sessionId?: string, wholeAdd?: ReadonlySet<string>): PendingPage {
   const all = loadEntries(cwd)
   const visible = sessionId ? all.filter((stored) => stored.entry.sessionIds.includes(sessionId)) : all
-  const items = visible.map(itemOf)
+  const items = visible.map((stored) => itemOf(stored, wholeAdd?.has(stored.entry.id) === true))
   const gaps: string[] = []
   for (const stored of visible) {
     if (stored.flags.oversized) gaps.push(`${stored.entry.path}: 文本超出上限，仅保留标记`)
@@ -141,14 +144,15 @@ export function loadPage(cwd: string, sessionId?: string): PendingPage {
  * @description: 读单条详情，包含可交给现有面板渲染的差异与块决定。
  * @param cwd 工作区
  * @param id 条目身份
+ * @param baselineEmpty 基线置空（新建文件按全量新增渲染）
  * @returns 详情，条目不存在时 null
  */
-export function loadDetail(cwd: string, id: string): PendingDetail | null {
+export function loadDetail(cwd: string, id: string, baselineEmpty = false): PendingDetail | null {
   const stored = loadEntries(cwd).find((item) => item.entry.id === id)
   if (!stored) return null
-  const diff = diffOf(stored.entry)
+  const diff = diffOf(stored.entry, baselineEmpty)
   return {
-    item: itemOf(stored),
+    item: itemOf(stored, baselineEmpty),
     diff,
     blocks: blockStatesOf(stored.entry),
     capability: capabilityOf(stored.entry, stored.flags),

package/src/pendingCompat.ts

@@ -171,7 +171,13 @@ export function pendingCovers(cwd: string, path: string): boolean {
  * @returns 合并后的页
  */
 export function mergedPage(official: ReviewPage, pending: PendingPage, cwd?: string): ReviewPage {
-  const covered = new Set(pending.items.map((item) => pathKey(item.path)))
+  const covered = new Set<string>()
+  for (const item of pending.items) {
+    // 待审条目的 path 是写入时的原始写法（常为工作区相对路径），官方条目用绝对身份：
+    // 只按 path 建覆盖集时同一文件会同时留下待审行与官方行，差异栏把一份改动算成两条。
+    covered.add(pathKey(item.path))
+    covered.add(pathKey(item.id))
+  }
   const kept = official.items.filter((item) => !covered.has(pathKey(item.currentPath)) && !covered.has(pathKey(item.path)))
   const items = [...pending.items.map((item) => pendingItemOf(item, cwd)), ...kept]
   return {

package/src/pendingRpc.ts

@@ -8,6 +8,7 @@ import { readText } from './pending/capture.js'
 import { pendingRawId, trackPendingCover } from './pendingCompat.js'
 import { loadEntries, saveEntry } from './pending/persist.js'
 import { applyDecide, importFromVcs, itemOf, loadDetail, loadPage, refreshed, removeEntry, undoDecide } from './pending/store.js'
+import { addedFiles } from './reviewDb.js'
 import type { ShellLike } from './pending/vcs.js'
 import type { Ctx } from './store.js'
 import { policyOf } from './store.js'
@@ -82,14 +83,16 @@ function readHandlers(kit: ScopeKit): Partial<RpcHandlerMap> {
   return {
     'edrv.pending.list': async (args: PendingRequest) => {
       const cwd = await kit.read(args.sessionId)
-      const page = loadPage(cwd, args.sessionId)
+      // 与官方入口同口径：本会话新建的文件基线置空，列表里的增删行数才等于整文件行数
+      const page = loadPage(cwd, args.sessionId, addedFiles(cwd, args.sessionId))
       // 列表即登记接管关系；旧写入口守卫之后只读内存集合，不再产生数据库读
       for (const item of page.items) trackPendingCover(cwd, item.path, true)
       return { ok: true, page }
     },
     'edrv.pending.detail': async (args: PendingRequest & { id: string }) => {
       const cwd = await kit.read(args.sessionId)
-      const detail = loadDetail(cwd, pendingRawId(args.id))
+      const rawId = pendingRawId(args.id)
+      const detail = loadDetail(cwd, rawId, addedFiles(cwd, args.sessionId).has(rawId))
       return detail ? { ok: true, detail } : { ok: false, error: '待审条目不存在' }
     },
   }

package/src/reviewDb.ts

@@ -205,6 +205,31 @@ export function reviewPage(cwd: string, cursor = 0, history = false, path?: stri
 
 }
 
+/**
+ * @public
+ * @author ddj 2026年10月31号
+ * @description: 该会话里由官方记录判为「整文件新增」的文件身份集合。待审条目命中时基线要置空：
+ * 文件是本会话新建的，累计基线只是会话自己的中间产物，拿它做旧侧会把新增文件渲染成一堆修改块。
+ * @param cwd 迁移后的工作区
+ * @param sessionId 会话
+ * @returns 整文件新增的文件身份集合
+ */
+export function addedFiles(cwd: string, sessionId: string): Set<string> {
+  try {
+    const db = dbFor(cwd)
+    if (!db.prepare("SELECT 1 FROM sqlite_master WHERE name='review_files' AND type='table'").get()) return new Set()
+    // 先按会话收窄再取每个文件最早的那条官方记录：首个块是整文件新增（before=false）才说明文件
+    // 由本次会话创建，后续修改块不能反过来把新建成改写成「有旧基线的修改」。
+    const rows = db.prepare(`SELECT identity FROM (SELECT identity,
+      json_extract(diff,'$.before') AS before, ROW_NUMBER() OVER (PARTITION BY identity ORDER BY turn, seq) AS rank
+      FROM review_files WHERE session_id=?) WHERE rank=1 AND before=0`).all(sessionId) as Row[]
+    return new Set(rows.map((row) => String(row.identity)))
+  } catch {
+    // 判定失败只退回旧的累计基线口径，不影响列表与详情可用
+    return new Set()
+  }
+}
+
 /**
  * @public
  * @author ddj 2026年10月31号

package/src/reviewRpc.ts

@@ -2,7 +2,7 @@
 import type { RpcHandlerMap } from './shared/rpc.js'
 import type { ReviewDetail, ReviewItem, ReviewPage } from './shared/review.js'
 import type { PendingPage } from './shared/pendingReview.js'
-import { decideReview, reviewDetail, reviewPage } from './reviewDb.js'
+import { addedFiles, decideReview, reviewDetail, reviewPage } from './reviewDb.js'
 import { undoReview } from './reviewUndo.js'
 import { applyDecide, loadDetail, loadPage } from './pending/store.js'
 import { PENDING_PREFIX, mergedPage, pendingDetailOf, pendingItemOf, pendingSamePath } from './pendingCompat.js'
@@ -153,7 +153,9 @@ export function reviewHandlers(ctx: Ctx, registry: Registry): Partial<RpcHandler
    */
   function pendingPageOf(cwd: string, sessionId: string): PendingPage {
     try {
-      const page = loadPage(cwd, sessionId)
+      // 本会话新建的文件由官方首个块判为整文件新增，待审基线必须跟着置空：
+      // 否则同一次新建会同时存在「官方说全加 516 行」与「待审说改 8 处」两套相反口径。
+      const page = loadPage(cwd, sessionId, addedFiles(cwd, sessionId))
       // 已结算（老文本与新文本一致）的投影没有净变化可审：留着会顶掉同路径的官方待审记录，
       // 让差异栏选中一条 Keep 不可用的条目，表现为「按钮亮着却点不动」。
       return page.items.some((item) => item.settled === true)
@@ -192,7 +194,9 @@ export function reviewHandlers(ctx: Ctx, registry: Registry): Partial<RpcHandler
       const scope = await scopeOf(args.sessionId)
       const cwd = scope.cwd
       if (args.id.startsWith(PENDING_PREFIX)) {
-        const detail = loadDetail(cwd, args.id.slice(PENDING_PREFIX.length))
+        const entryId = args.id.slice(PENDING_PREFIX.length)
+        // 详情侧与列表侧必须同一口径：整文件新增的文件用空基线渲染，差异块才是全绿一整块
+        const detail = loadDetail(cwd, entryId, addedFiles(cwd, args.sessionId).has(entryId))
         if (!detail) return { ok: false, error: '待审条目不存在' }
 
         const mapped = pendingDetailOf(detail, new Date(detail.item.updatedAt).toISOString(), cwd)