dsh-vscode-mode 0.23.4 → 0.24.0

package/package.json

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

package/src/client/loadFailure.ts

@@ -0,0 +1,84 @@
+/**
+ * dsh-vscode-mode client — 加载失败诊断（把「加载失败」拆成可定位的四类原因）。
+ *
+ * 为什么需要：宿主对非 loopback/bind/trustedHosts 的 Host 一律回 403（Host 围栏），
+ * 认证失效回 401，路由或资源缺失回 404，另有纯网络失败。此前 Monaco/pdf.js 的失败面板
+ * 一律提示「检查资源是否完整」，远程访问时会把 403 误报成资源缺失，误导排查方向。
+ *
+ * 文案只输出 pathname 与状态码，不含 origin、查询串、cookie 或任何凭据。
+ * @author ddj 2026年11月02号
+ */
+
+/** 状态码 0：请求未完成（网络错误 / 被拦截 / 离线）。 */
+const NETWORK_FAILED = 0
+
+/**
+ * 探测资源地址的真实响应状态。
+ * @author ddj 2026年11月02号
+ * @param url 已解析的绝对或根路径地址
+ * @returns HTTP 状态码；请求未完成时返回 0
+ */
+export async function probeStatus(url: string): Promise<number> {
+  try {
+    const res = await fetch(url, { method: 'HEAD', credentials: 'same-origin' })
+    return res.status
+  } catch (e) {
+    return NETWORK_FAILED
+  }
+}
+
+/**
+ * 取地址的 pathname（只用于诊断文案，避免暴露 origin 与查询串）。
+ * @author ddj 2026年11月02号
+ * @param url 绝对或根路径地址
+ * @returns pathname；无法解析时原样返回
+ */
+function pathOf(url: string): string {
+  try {
+    return new URL(url, 'http://localhost').pathname
+  } catch (e) {
+    return url
+  }
+}
+
+/**
+ * 状态码 → 可操作的原因说明（四类互不相同）。
+ * @author ddj 2026年11月02号
+ * @param status HTTP 状态码，0 表示请求未完成
+ * @returns 原因说明
+ */
+export function statusHint(status: number): string {
+  if (status === NETWORK_FAILED) return '请求未到达宿主（网络不可达、被浏览器或代理拦截、或宿主已停止）'
+  if (status === 403) return '宿主拒绝了当前页面（Host/Origin 校验未通过；远程访问需经远程访问插件的通道）'
+  if (status === 401) return '宿主登录态失效，请重新打开已登录的应用页面'
+  if (status === 404) return '路由或资源不存在（插件资源缺失或插件版本与宿主不匹配）'
+  return '宿主返回了非预期状态'
+}
+
+/**
+ * 组装加载失败文案：标签 + 资源路径 + 状态 + 原因。
+ * @author ddj 2026年11月02号
+ * @param label 失败对象（如 'Monaco loader 加载失败'）
+ * @param url 加载地址
+ * @param status 探测到的状态码（0=网络错误）
+ * @returns 用户可读的诊断文案
+ */
+export function loadFailureText(label: string, url: string, status: number): string {
+  const outcome = status === NETWORK_FAILED ? '请求未完成' : '返回 HTTP ' + status
+  return label + '：' + pathOf(url) + ' ' + outcome + '；' + statusHint(status)
+}
+
+/**
+ * Monaco 失败面板提示：按错误内容给出对应排查方向（不再一律提示「检查资源是否完整」）。
+ * @author ddj 2026年11月02号
+ * @param message 编辑器记录的失败原因
+ * @returns 排查建议
+ */
+export function monacoHint(message: string): string {
+  const text = String(message ?? '')
+  if (/403/.test(text)) return '宿主拒绝了本次请求：远程访问需经远程访问插件的通道（本页已自动接入）；本机访问请用 127.0.0.1 或 localhost 打开。'
+  if (/401/.test(text)) return '宿主登录态失效：请重新打开已登录的应用页面后再试。'
+  if (/404/.test(text)) return 'Monaco 静态资源未找到：插件包 assets/vendor/monaco 可能不完整，或插件版本与宿主不匹配。'
+  if (/请求未完成|Failed to fetch|NetworkError/i.test(text)) return '请求未能到达宿主：请检查网络、代理与宿主进程状态。'
+  return '请展开下方详情，并在浏览器控制台确认失败请求的地址与状态码。'
+}

package/src/client/monaco/loader.ts

@@ -6,9 +6,10 @@
  */
 import { applyOfficial, registerThemes } from './theme.js'
 
-import { appUrl } from '../../shared/appUrl.js'
+import { transportUrl } from '../../shared/remoteChannel.js'
+import { loadFailureText, probeStatus } from '../loadFailure.js'
 
-export const MONACO_BASE = appUrl('/edrv/vendor/monaco/vs')
+export const MONACO_BASE = transportUrl('/edrv/vendor/monaco/vs')
 let monacoPromise = null
 let monacoStage = { phase: 'idle', progress: 0, message: '准备加载 Monaco…' }
 const stageListeners = new Set()
@@ -154,10 +155,12 @@ export function loadMonaco(onProgress) {
         s.src = MONACO_BASE + '/loader.js'
         s.dataset.edrvMonacoLoader = '1'
         s.onload = boot
-        s.onerror = (event) => {
-          // 保留首次失败真实原因（网络/HTTP 层事件），不让后续 TypeError 覆盖
-          const hint = event && event.type ? '（' + event.type + '）' : ''
-          fail(new Error('Monaco loader 加载失败' + hint))
+        s.onerror = async () => {
+          // 保留首次失败真实原因（网络/HTTP 层），不让后续 TypeError 覆盖；
+          // 探测真实状态码，把 403（Host 围栏）/401/404/网络错误区分开，避免一律提示「资源不完整」
+          const loaderUrl = MONACO_BASE + '/loader.js'
+          const status = await probeStatus(loaderUrl)
+          fail(new Error(loadFailureText('Monaco loader 加载失败', loaderUrl, status)))
         }
         hideNodeGlobals()
         document.head.appendChild(s)

package/src/client/pdf/pdfLoader.ts

@@ -7,10 +7,11 @@
  * 作者 ddj 2026-09-22
  */
 
-import { appUrl } from '../../shared/appUrl.js'
+import { transportUrl } from '../../shared/remoteChannel.js'
+import { loadFailureText, probeStatus } from '../loadFailure.js'
 
-/** vendor 根，保留官方桌面协议及反向代理前缀。 */
-export const PDFJS_BASE = appUrl('/edrv/vendor/pdfjs')
+/** vendor 根，保留官方桌面协议、反向代理前缀与远程访问通道前缀。 */
+export const PDFJS_BASE = transportUrl('/edrv/vendor/pdfjs')
 /** pdf.js Worker 地址（GlobalWorkerOptions.workerSrc）。 */
 export const PDFJS_WORKER_SRC = PDFJS_BASE + '/build/pdf.worker.mjs'
 /** CJK 字符映射目录（中文 PDF 渲染必需，尾斜杠固定）。 */
@@ -76,7 +77,12 @@ export function loadPdfjs() {
         'document.querySelector("script[data-edrv-pdfjs-loader]")?.dispatchEvent(new Event("edrv-pdfjs-ready"));'
       s.dataset.edrvPdfjsLoader = '1'
       s.onload = boot
-      s.onerror = () => fail(new Error('pdf.js loader 脚本加载失败（检查 assets/vendor/pdfjs 完整 / /edrv/vendor 路由可达）'))
+      s.onerror = async () => {
+        // 探测真实状态码：403（Host 围栏）/401/404/网络错误各自给不同排查方向
+        const moduleUrl = PDFJS_BASE + '/build/pdf.mjs'
+        const status = await probeStatus(moduleUrl)
+        fail(new Error(loadFailureText('pdf.js 模块加载失败', moduleUrl, status)))
+      }
       document.head.appendChild(s)
     })
   }

package/src/client/rpc.ts

@@ -5,7 +5,7 @@
  * 作者 ddj 2026-08-20 / 2026-09-17
  */
 import { svnNotice } from './svnNotice.js'
-import { appUrl } from '../shared/appUrl.js'
+import { channelPrefix, transportUrl } from '../shared/remoteChannel.js'
 import { RPC_PATH } from '../shared/rpc.js'
 import type { RpcMethod, RpcRequestMap, RpcResult } from '../shared/rpc.js'
 import type { LoggerLevel } from '../shared/logger.js'
@@ -55,21 +55,14 @@ export async function rpc<M extends RpcMethod>(method: M, args: RpcRequestMap[M]
 
 /** @private @author ddj 2026年10月10号 @param method Typed method. @param args Request. @param signal Fetch lifetime. @returns Validated authenticated business response. @throws Transport/format errors. */
 async function rpcFetch<M extends RpcMethod>(method: M, args: RpcRequestMap[M], signal?: AbortSignal): Promise<RpcResult<M>> {
-  const res = await fetch(appUrl(RPC_PATH), {
+  const res = await fetch(transportUrl(RPC_PATH), {
     method: 'POST',
     credentials: 'same-origin',
     headers: { 'content-type': 'application/json' },
     body: JSON.stringify({ method, args }),
     signal,
   })
-  if (!res.ok) {
-    const message = res.status === 401 ? 'DSH 登录已失效，请重新打开已登录的应用页面'
-      : res.status === 403 ? 'DSH 拒绝了当前页面的访问'
-      : res.status === 413 ? '请求超过支持的文件大小'
-      : res.status === 503 ? 'DSH 认证服务尚未就绪'
-      : 'DSH 请求失败（HTTP ' + res.status + '）'
-    throw new Error(message)
-  }
+  if (!res.ok) throw new Error(await failureMessage(res))
   if (!/^application\/json(?:\s*;|\s*$)/i.test(res.headers.get('content-type') ?? '')) {
     throw new Error('DSH 返回了非 JSON 响应，请检查应用地址和代理配置')
   }
@@ -80,6 +73,57 @@ async function rpcFetch<M extends RpcMethod>(method: M, args: RpcRequestMap[M],
   return value as RpcResult<M>
 }
 
+/**
+ * 非 2xx 响应 → 可读失败原因：403 再区分「远程设备未配对」与「Host 围栏拒绝」。
+ * @author ddj 2026年11月02号
+ * @param res 失败响应
+ * @returns 用户可读原因
+ */
+async function failureMessage(res: Response): Promise<string> {
+  if (res.status === 403) {
+    if (await unpairedDenied(res)) return '远程访问设备尚未配对：请在远程访问面板完成配对后重试（HTTP 403）'
+    return 'DSH 拒绝了当前页面的访问（HTTP 403，Host 校验未通过）' + channelNote()
+  }
+  if (res.status === 401) return 'DSH 登录已失效，请重新打开已登录的应用页面'
+  if (res.status === 404) return '插件路由不存在（HTTP 404），请确认 dsh-vscode-mode 与宿主版本匹配'
+  if (res.status === 413) return '请求超过支持的文件大小'
+  if (res.status === 503) return 'DSH 认证服务尚未就绪'
+  return 'DSH 请求失败（HTTP ' + res.status + '）'
+}
+
+/**
+ * 403 是否为远程访问通道的「未配对」拒绝（远程插件以 `{result:{ok:false,error:{code}}}` 回）。
+ * @author ddj 2026年11月02号
+ * @param res 403 响应
+ * @returns 是否为未配对拒绝
+ */
+async function unpairedDenied(res: Response): Promise<boolean> {
+  try {
+    const body = (await res.clone().json()) as { result?: { error?: { code?: unknown } }; error?: { code?: unknown } } | null
+    const code = body?.result?.error?.code ?? body?.error?.code
+    return code === 'unpaired'
+  } catch (e) {
+    return false
+  }
+}
+
+/**
+ * 网络来源页面却未接入远程通道时的补充提示（本机页面不追加）。
+ * @author ddj 2026年11月02号
+ * @returns 提示后缀；无需提示时为空串
+ */
+function channelNote(): string {
+  if (channelPrefix() !== '') return ''
+  try {
+    if (typeof location === 'undefined') return ''
+    const host = location.hostname
+    if (host === 'localhost' || host === '::1' || host === '[::1]' || /^127(\.\d{1,3}){3}$/.test(host)) return ''
+    return '；本页未接入远程访问通道（远程访问插件未安装或未完成配对）'
+  } catch (e) {
+    return ''
+  }
+}
+
 /**
  * 诊断日志：开关关闭时直接返回（零 RPC 零落盘）；开启时走 host edrv.debug 落盘。
  * @author ddj 2026年08月26号 / 2026年09月17号

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/client/ui/DiffBadge.ts

@@ -5,7 +5,7 @@
  * 作者 ddj 2026-08-20
  */
 import React from 'react'
-import { appUrl } from '../../shared/appUrl.js'
+import { transportUrl } from '../../shared/remoteChannel.js'
 import { openEditorView, emitShowLauncher } from '../events.js'
 import { diffSummary } from '../state/diffSummary.js'
 import { subscribeReview } from '../state/reviewFeed.js'
@@ -44,6 +44,6 @@ export function DiffBadge(props) {
     title: '差异审查：' + n + ' 个待处理文件；点击查看总览与历史',
     style: { position: 'relative', display: 'inline-flex', alignItems: 'center', justifyContent: 'center', width: 30, height: 30, padding: 0, background: 'transparent', border: 'none', borderRadius: 6, cursor: 'pointer' },
   },
-    React.createElement('img', { src: appUrl('/edrv/assets/compare-select.png'), alt: '差异', style: { width: 22, height: 22, display: 'block' } }),
+    React.createElement('img', { src: transportUrl('/edrv/assets/compare-select.png'), alt: '差异', style: { width: 22, height: 22, display: 'block' } }),
     React.createElement('span', { style: { position: 'absolute', top: 1, right: 0, minWidth: 15, height: 15, padding: '0 3px', borderRadius: 8, background: 'var(--dsw-alias-state-warn-primary,#d97706)', color: '#fff', fontSize: 10, lineHeight: '15px', textAlign: 'center', fontWeight: 700, boxSizing: 'border-box' } }, String(n)))
 }

package/src/client/ui/EditorView.ts

@@ -46,6 +46,7 @@ import { base64ToBytes, bytesToBase64, isPdfPath } from '../pdfPreview.js'
 import { inNativePath, tryNativeOpen } from '../nativeOpenStore.js'
 import { clearPendingNav, putPendingNav, readPendingNav } from '../pendingNav.js'
 import { readBinaryPreview } from '../../shared/rpc.js'
+import { monacoHint } from '../loadFailure.js'
 import {
   clearBaseline,
   clearReadVersion,
@@ -4747,7 +4748,7 @@ export function EditorView(props) {
   } else if (monacoErr) {
     body = React.createElement('div', { className: 'edrv-empty' },
       React.createElement('div', null, 'Monaco 编辑器加载失败：' + String(monacoErr)),
-      React.createElement('div', { style: { fontSize: 11 } }, '请确认插件包 assets/vendor/monaco 完整（/edrv/vendor 路由可达）'),
+      React.createElement('div', { style: { fontSize: 11 } }, monacoHint(String(monacoErr))),
       React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: () => { setMonacoErr(null); setLoadStage({ progress: 0, message: '准备重试 Monaco…' }) } }, '重试'))
   } else if (!active) {
     body = React.createElement('div', { className: 'edrv-empty' },

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)

package/src/shared/remoteChannel.ts

@@ -0,0 +1,59 @@
+/**
+ * 远程访问通道适配：插件内部路径 → 远程传输可达路径。
+ *
+ * 背景：宿主 connection 插件对 Host 不是 loopback / bind 地址 / trustedHosts 的请求一律回 403
+ * （Host 围栏先于任何 cookie 校验），因此 /edrv/rpc 与 /edrv/vendor/** 在局域网 IP 或隧道域名
+ * 页面上必然被拒。第三方远程访问插件（@linxin666/dsh-remote-web-ui）提供 /remote/<内部路径>
+ * 的 catch-all 代理：校验配对设备后回环重发到本进程，本插件自身的准入照旧执行。
+ *
+ * 该插件在 <head> 首部内联一段 classic script（解析期同步执行，早于任何 module script），并在
+ * window 上安装 seat 对象作为「本页已接入通道」的唯一标记。本模块据此选前缀：
+ * 有标记 ⇒ '/remote' + 原路径；无标记 ⇒ 原路径（本机、桌面 dsh-app:、未装该插件均不受影响）。
+ * 只决定 URL 前缀，不读取、不写入、不转发任何 cookie 或凭据。
+ *
+ * Purity rule: no node/react imports（与 appUrl.ts 一致）。
+ * @author ddj 2026年11月02号
+ */
+import { appUrl } from './appUrl.js'
+
+/** 远程访问插件在解析期安装的通道 seat 全局名（其 REMOTE_CHANNEL_BOOT_GLOBAL）。 */
+export const CHANNEL_SEAT = '__DSH_REMOTE_CHANNEL_BOOT__'
+
+/** 远程访问插件接管的前缀：/remote/<内部路径> 由服务端回环转发。 */
+export const CHANNEL_PREFIX = '/remote'
+
+/**
+ * 当前页面的通道前缀。
+ * @author ddj 2026年11月02号
+ * @returns 本页已接入远程通道时为 '/remote'，否则空串（保持既有本地路径）。
+ */
+export function channelPrefix(): string {
+  if (typeof window === 'undefined') return ''
+  try {
+    const seat = (window as unknown as Record<string, unknown>)[CHANNEL_SEAT]
+    return seat && typeof seat === 'object' ? CHANNEL_PREFIX : ''
+  } catch (e) {
+    return ''
+  }
+}
+
+/**
+ * 给插件内部路径加通道前缀。
+ * @author ddj 2026年11月02号
+ * @param path 以 '/' 开头的插件内部路径（合法性由 {@link transportUrl} 内的 appUrl 兜底校验）
+ * @returns 带通道前缀的路径；本机页面原样返回
+ */
+export function transportPath(path: string): string {
+  return channelPrefix() + path
+}
+
+/**
+ * 把插件内部路径解析为当前页面可请求的地址（继承通道前缀、反向代理前缀与桌面协议）。
+ * @author ddj 2026年11月02号
+ * @param path 以 '/' 开头的插件内部路径
+ * @param base 测试用显式 document base；缺省同 appUrl（document.baseURI → location.href）
+ * @returns 应用地址；无浏览器环境时返回原根路径
+ */
+export function transportUrl(path: string, base?: string): string {
+  return appUrl(transportPath(path), base)
+}

package/src/shared/rpc.ts

@@ -24,7 +24,7 @@ import type { AiConfigPatch, AiConfigView, AiDirectoryView, AiInlineRequest, AiI
 import type { SvnAction, SvnAiPlan, SvnChangeEntry, SvnConflictArtifact, SvnDiffRevResult, SvnIgnoreItem, SvnLogEntry, SvnRemoteOutdatedEntry, SvnStatusPayload, SvnSumEntry, SvnUpdatePoll, SvnUpdateResult, SvnUpdateState } from './svn.js'
 import type { DapAction, DapAdapterInfo, DapBreakpointAck, DapBreakpointInput, DapConfigSnippet, DapConfigSource, DapDebugConfig, DapFrameView, DapPhase, DapPollResult, DapProcessInfo, DapScopeView, DapVariableView } from './dap.js'
 import { DAP_ACTIONS } from './dap.js'
-import { appUrl } from './appUrl.js'
+import { transportUrl } from './remoteChannel.js'
 import type { LoggerLevel } from './logger.js'
 import type { SvnViewRequest, SvnViewPayload } from './svnExplorer.js'
 import type { DecideReview, ReviewDetail, ReviewPage, ReviewRequest } from './review.js'
@@ -153,7 +153,7 @@ export async function readBinaryPreview(
  */
 async function tryBinaryRead(args: RpcRequestMap['edrv.readBinary']): Promise<PreviewRead | null> {
   try {
-    const res = await fetch(appUrl(RPC_PATH), {
+    const res = await fetch(transportUrl(RPC_PATH), {
       method: 'POST',
       headers: { 'content-type': 'application/json' },
       body: JSON.stringify({ method: 'edrv.readBinary', args }),