dsh-vscode-mode 0.23.5 → 0.25.0

package/package.json

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

@@ -0,0 +1,208 @@
+/**
+ * dsh-vscode-mode client — 资源管理器「下载到本机」下载原语。
+ *
+ * 远程访问时工作区在远端机器上，浏览器拿不到本地落盘入口：本模块把
+ * 「相对路径 → 主机字节 → 浏览器下载」串成一条链，供右键菜单调用。
+ *
+ * 读取走 shared 的 readBinaryPreview：本机走 edrv.readBinary 原始字节，远程代理
+ * 会剥掉 x-edrv-* 响应头、自动回退 edrv.read 的 base64 分支（功能不降级，体积 +33%）。
+ *
+ * 约束：
+ * - 不打包、不新增主机 RPC；勾选多个文件时逐个下载原文件（串行，避免并发大文件
+ *   打爆 RPC 内存，也贴合「不打包」的产品决策）。
+ * - 单个文件失败不整批中断：失败条目记入结果，由调用方统一提示。
+ * 作者 ddj 2026年11月03号
+ */
+import { readBinaryPreview } from '../shared/rpc.js'
+import { baseNameOf } from '../shared/fsNames.js'
+import { rpc } from './rpc.js'
+import type { TreeMenuTarget } from './sidebar/contextMenu.js'
+import type { SidebarCtx } from './sidebar/types.js'
+import { openDownloader } from './ui/DownloadPicker.js'
+
+// --region 类型
+
+/** 单个文件的下载结果（字节数供提示用）。 */
+export interface DownloadedFile {
+  path: string
+  size: number
+}
+
+/** 批量下载结果：成功路径保持入参顺序，失败保留主机原文。 */
+export interface DownloadBatch {
+  ok: string[]
+  failed: Array<{ path: string; message: string }>
+}
+
+/** 批量下载选项。 */
+export interface DownloadOpts {
+  sessionId?: string
+  /** 取消信号：只在下个文件开始前检查（不中断进行中的请求）。 */
+  signal?: AbortSignal
+  /** 每完成一个文件回调一次（done 含成功与失败）。 */
+  onProgress?: (done: number, total: number, path: string) => void
+}
+
+// --endregion
+
+// --region 单文件
+
+/**
+ * 触发浏览器下载（Blob + 隐藏 <a download>），与 Excel 导出同一落盘范式。
+ * @author ddj 2026年11月03号
+ * @param bytes 原始字节
+ * @param fileName 保存文件名（浏览器重名时自动加序号）
+ * @param mime MIME 类型；空值退化为 application/octet-stream
+ * @sideEffects 创建并点击一个游离 <a> 节点，60 秒后释放 objectURL
+ */
+export function downloadBytes(bytes: Uint8Array, fileName: string, mime: string): void {
+  const type = mime || 'application/octet-stream'
+  const url = URL.createObjectURL(new Blob([bytes as BlobPart], { type }))
+  const anchor = document.createElement('a')
+
+  anchor.href = url
+  anchor.download = fileName
+  anchor.rel = 'noopener'
+  anchor.click()
+
+  setTimeout(() => URL.revokeObjectURL(url), 60000)
+}
+
+/**
+ * 读取单个文件的原始字节（二进制通道优先，base64 回退）。
+ * @author ddj 2026年11月03号
+ * @param path 工作区相对路径
+ * @param sessionId 会话 id（工作区解析用）
+ * @returns 字节 + MIME + 字节数（MIME 缺失按路径推断）
+ * @throws 主机拒绝或读取失败时抛出主机错误原文（如「文件过大（>32MB）…」）
+ */
+export async function fetchDownload(path: string, sessionId?: string): Promise<{ bytes: Uint8Array; mime: string; size: number }> {
+  const args = sessionId ? { sessionId, path } : { path }
+  const out = await readBinaryPreview(rpc, args)
+  if (!out.ok) throw new Error(out.error)
+  if (out.via === 'binary') return { bytes: out.bytes, mime: out.mime, size: out.size }
+  return { bytes: decodeBase64(out.content), mime: out.mime || 'application/octet-stream', size: out.size }
+}
+
+/**
+ * 下载单个文件并交给浏览器落盘。
+ * @author ddj 2026年11月03号
+ * @param path 工作区相对路径
+ * @param opts 会话 / 取消选项
+ * @returns 路径与字节数
+ * @throws 读取失败透传主机错误
+ */
+export async function downloadOne(path: string, opts: DownloadOpts = {}): Promise<DownloadedFile> {
+  const file = await fetchDownload(path, opts.sessionId)
+  downloadBytes(file.bytes, baseNameOf(path) || 'download', file.mime)
+  return { path, size: file.size }
+}
+
+// --endregion
+
+// --region 批量与入口
+
+/**
+ * 串行下载多个文件（逐个原文件，不打包）。
+ * @author ddj 2026年11月03号
+ * @param paths 工作区相对路径列表（按用户勾选顺序）
+ * @param opts 会话 / 取消 / 进度选项
+ * @returns 成功与失败清单；单项失败不中断后续
+ */
+export async function downloadMany(paths: string[], opts: DownloadOpts = {}): Promise<DownloadBatch> {
+  const ok: string[] = []
+  const failed: Array<{ path: string; message: string }> = []
+
+  for (const path of paths) {
+    if (opts.signal?.aborted) break
+    try {
+      await downloadOne(path, opts)
+      ok.push(path)
+    } catch (error) {
+      failed.push({ path, message: textOfError(error) })
+    }
+    opts.onProgress?.(ok.length + failed.length, paths.length, path)
+  }
+
+  return { ok, failed }
+}
+
+/**
+ * 右键菜单入口：文件直下，文件夹 / 工作区根打开勾选弹窗。
+ * @author ddj 2026年11月03号
+ * @param target 右键目标（根空白区为 path='' 的 directory）
+ * @param ctx 面板上下文（会话 id 与状态栏反馈）
+ * @sideEffects 触发浏览器下载或挂载弹窗；错误经 ctx.notify 透出
+ */
+export async function downloadTarget(target: TreeMenuTarget, ctx?: SidebarCtx): Promise<void> {
+  if (target.type === 'file') {
+    await runBatch([target.path], ctx)
+    return
+  }
+
+  openDownloader({
+    root: target.path,
+    sessionId: ctx?.sessionId,
+    onConfirm: (paths: string[]) => { void runBatch(paths, ctx) },
+  })
+}
+
+/**
+ * 批量下载并统一反馈（开始一条、结束一条，避免逐文件刷屏）。
+ * @author ddj 2026年11月03号
+ * @param paths 勾选路径
+ * @param ctx 面板上下文
+ */
+async function runBatch(paths: string[], ctx?: SidebarCtx): Promise<void> {
+  if (!paths.length) return
+  if (paths.length > 1) ctx?.notify?.('正在下载 ' + paths.length + ' 个文件…')
+  try {
+    const out = await downloadMany(paths, { sessionId: ctx?.sessionId })
+    ctx?.notify?.(batchText(out))
+  } catch (error) {
+    ctx?.notify?.('下载失败：' + textOfError(error))
+  }
+}
+
+/**
+ * 批量结果口播文案。
+ * @author ddj 2026年11月03号
+ * @param out 批量结果
+ * @returns 单行提示文案
+ */
+function batchText(out: DownloadBatch): string {
+  if (!out.failed.length) return '已下载 ' + out.ok.length + ' 个文件'
+  const first = out.failed[0]
+  const tail = '（' + first.path + '：' + first.message + '）'
+  if (!out.ok.length) return '下载失败：' + first.message + tail
+  return '已下载 ' + out.ok.length + ' 个，失败 ' + out.failed.length + ' 个' + tail
+}
+
+// --endregion
+
+// --region 工具
+
+/**
+ * base64 → 字节（回退通道解码；逐字节写入避免大文件二次拷贝放大）。
+ * @author ddj 2026年11月03号
+ * @param text base64 文本
+ * @returns 原始字节
+ */
+function decodeBase64(text: string): Uint8Array {
+  const binary = atob(text)
+  const bytes = new Uint8Array(binary.length)
+  for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index)
+  return bytes
+}
+
+/**
+ * 错误可读文案（Error.message 优先，其余 String 化）。
+ * @author ddj 2026年11月03号
+ * @param error 捕获值
+ * @returns 提示文案
+ */
+function textOfError(error: unknown): string {
+  return error instanceof Error ? error.message : String(error)
+}
+
+// --endregion

package/src/client/downloadPickerModel.ts

@@ -0,0 +1,335 @@
+/**
+ * dsh-vscode-mode client — 「下载到本机」弹窗的目录树与勾选模型（纯逻辑）。
+ *
+ * 与 React 解耦：组件只读 rowList 渲染、只调这里的函数改状态，因此本文件可在
+ * node 环境单测（vitest 无可视 DOM）。状态全部不可变返回，便于 React 直接替换。
+ *
+ * 设计决策（产品已确认「目录树 + 勾选、不打包」）：
+ * - 目录节点只负责展开，不带勾选框；勾选粒度是文件（避免「半选目录」的语义歧义）。
+ * - 懒加载：一次只 listDir 一层；「全选」只作用于已加载文件，不对未展开目录做
+ *   隐式整树拉取（否则 node_modules 级目录会把弹窗一次性拉爆）。
+ * 作者 ddj 2026年11月03号
+ */
+import type { TreeEntry } from '../shared/rpc.js'
+
+/** 单文件下载上限，与主机二进制读取上限（BINARY_READ_CAP）保持一致。 */
+export const DL_SIZE_CAP = 32 * 1024 * 1024
+
+/** 树节点：只保留文件与目录（主机的 'other' 不进弹窗）。 */
+export interface DlNode {
+  name: string
+  path: string
+  kind: 'file' | 'directory'
+  /** 主机的可选大小；缺失时界面不显示体积，也不做上限预判。 */
+  size?: number
+}
+
+/** 弹窗状态：目录树 + 展开态 + 加载态 + 勾选集合。 */
+export interface DlState {
+  /** 弹窗根（工作区相对路径；'' = 工作区根目录）。 */
+  root: string
+  nodes: Map<string, DlNode>
+  /** 目录路径 → 已加载子项（按目录优先 + 名称排序）。 */
+  children: Map<string, string[]>
+  expanded: Set<string>
+  loading: Set<string>
+  selected: Set<string>
+  /** 目录路径 → 该层加载失败的主机原文。 */
+  errors: Map<string, string>
+}
+
+/** 一行渲染数据（深度优先铺平当前可见节点）。 */
+export interface DlRow {
+  path: string
+  name: string
+  kind: 'file' | 'directory'
+  depth: number
+  expanded: boolean
+  checked: boolean
+  size?: number
+  loading: boolean
+  error?: string
+}
+
+/**
+ * 初始状态：根目录默认展开，等待首层 listDir 填充。
+ * @author ddj 2026年11月03号
+ * @param root 弹窗根（工作区相对路径，'' = 工作区根）
+ * @returns 空树状态
+ */
+export function createDlState(root: string): DlState {
+  return {
+    root,
+    nodes: new Map(),
+    children: new Map(),
+    expanded: new Set([root]),
+    loading: new Set(),
+    selected: new Set(),
+    errors: new Map(),
+  }
+}
+
+/**
+ * 合并某目录的 listDir 结果（替换该层子项，清理本次已不存在的旧子项）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径（'' = 工作区根）
+ * @param entries 主机返回的目录项
+ * @returns 新状态（loading / errors 中的该目录项被清除）
+ */
+export function mergeChildren(state: DlState, dirPath: string, entries: TreeEntry[]): DlState {
+  const nodes = new Map(state.nodes)
+  const children = new Map(state.children)
+  const expanded = new Set(state.expanded)
+  const loading = new Set(state.loading)
+  const selected = new Set(state.selected)
+  const errors = new Map(state.errors)
+  const previous = children.get(dirPath) ?? []
+  const nextPaths: string[] = []
+
+  for (const entry of entries) {
+    if (entry.type === 'other') continue
+    const kind: DlNode['kind'] = entry.type === 'directory' ? 'directory' : 'file'
+    nodes.set(entry.path, { name: entry.name, path: entry.path, kind, size: entry.size })
+    nextPaths.push(entry.path)
+  }
+  nextPaths.sort((left, right) => compareNodes(nodes, left, right))
+  children.set(dirPath, nextPaths)
+  loading.delete(dirPath)
+  errors.delete(dirPath)
+
+  // 本次列表里消失的旧子项整支清理：残留节点会让勾选命中幽灵路径，也会让弹窗显示已删文件。
+  for (const stale of previous) {
+    if (nextPaths.includes(stale)) continue
+    nodes.delete(stale)
+    selected.delete(stale)
+    children.delete(stale)
+    expanded.delete(stale)
+  }
+
+  return { root: state.root, nodes, children, expanded, loading, selected, errors }
+}
+
+/**
+ * 标记某目录正在加载（展开时先出「加载中…」行）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 新状态
+ */
+export function markLoading(state: DlState, dirPath: string): DlState {
+  const loading = new Set(state.loading)
+  loading.add(dirPath)
+  return { ...state, loading }
+}
+
+/**
+ * 标记某目录加载失败（保留错误原文供重试行显示）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @param message 主机错误原文
+ * @returns 新状态
+ */
+export function markError(state: DlState, dirPath: string, message: string): DlState {
+  const loading = new Set(state.loading)
+  const errors = new Map(state.errors)
+  loading.delete(dirPath)
+  errors.set(dirPath, message)
+  return { ...state, loading, errors }
+}
+
+/**
+ * 展开目录（不改 children，加载由调用方按 needLoad 判定）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 新状态
+ */
+export function expandDir(state: DlState, dirPath: string): DlState {
+  const expanded = new Set(state.expanded)
+  expanded.add(dirPath)
+  return { ...state, expanded }
+}
+
+/**
+ * 收起目录。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 新状态
+ */
+export function collapseDir(state: DlState, dirPath: string): DlState {
+  const expanded = new Set(state.expanded)
+  expanded.delete(dirPath)
+  return { ...state, expanded }
+}
+
+/**
+ * 目录是否已展开。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 是否展开
+ */
+export function isExpanded(state: DlState, dirPath: string): boolean {
+  return state.expanded.has(dirPath)
+}
+
+/**
+ * 某目录是否已拉取过子项（决定展开时要不要发 listDir）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 是否已加载
+ */
+export function hasLoaded(state: DlState, dirPath: string): boolean {
+  return state.children.has(dirPath)
+}
+
+/**
+ * 切换文件勾选（超过上限的文件不可勾选；目录与未知路径忽略）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param path 文件路径
+ * @returns 新状态
+ */
+export function toggleFile(state: DlState, path: string): DlState {
+  const node = state.nodes.get(path)
+  if (!node || node.kind !== 'file') return state
+  if (isOversized(node.size)) return state
+  const selected = new Set(state.selected)
+  if (selected.has(path)) selected.delete(path)
+  else selected.add(path)
+  return { ...state, selected }
+}
+
+/**
+ * 全选已加载文件（不含超限文件）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 新状态
+ */
+export function selectLoaded(state: DlState): DlState {
+  const selected = new Set<string>()
+  for (const path of loadedFiles(state)) {
+    const node = state.nodes.get(path)
+    if (node && !isOversized(node.size)) selected.add(path)
+  }
+  return { ...state, selected }
+}
+
+/**
+ * 清空勾选。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 新状态
+ */
+export function clearSelected(state: DlState): DlState {
+  return { ...state, selected: new Set<string>() }
+}
+
+/**
+ * 已勾选文件（按路径排序，保证下载顺序稳定可测）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 路径列表
+ */
+export function selectedFiles(state: DlState): string[] {
+  return Array.from(state.selected).sort()
+}
+
+/**
+ * 已加载的文件路径（全选的作用域就是它）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 路径列表
+ */
+export function loadedFiles(state: DlState): string[] {
+  const out: string[] = []
+  for (const node of state.nodes.values()) {
+    if (node.kind === 'file') out.push(node.path)
+  }
+  return out.sort()
+}
+
+/**
+ * 当前可见行（深度优先；只展开已展开目录）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 渲染行列表
+ */
+export function rowList(state: DlState): DlRow[] {
+  const rows: DlRow[] = []
+  appendRows(state, state.root, 0, rows)
+  return rows
+}
+
+/**
+ * 递归铺平子项（仅内部使用；深度受限于用户实际展开层数）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 当前目录
+ * @param depth 缩进层级
+ * @param rows 输出累积
+ */
+function appendRows(state: DlState, dirPath: string, depth: number, rows: DlRow[]): void {
+  if (!state.expanded.has(dirPath)) return
+  const childPaths = state.children.get(dirPath) ?? []
+  for (const path of childPaths) {
+    const node = state.nodes.get(path)
+    if (!node) continue
+    const expanded = node.kind === 'directory' && state.expanded.has(path)
+    rows.push({
+      path,
+      name: node.name,
+      kind: node.kind,
+      depth,
+      expanded,
+      checked: state.selected.has(path),
+      size: node.size,
+      loading: state.loading.has(path),
+      error: state.errors.get(path),
+    })
+    if (node.kind === 'directory') appendRows(state, path, depth + 1, rows)
+  }
+}
+
+/**
+ * 体积可读文案（列表右侧提示用）。
+ * @author ddj 2026年11月03号
+ * @param size 字节数
+ * @returns 如 `512 B` / `12 KB` / `3.4 MB`
+ */
+export function formatSize(size: number): string {
+  if (!Number.isFinite(size) || size < 0) return ''
+  if (size < 1024) return size + ' B'
+  if (size < 1024 * 1024) return Math.round(size / 1024) + ' KB'
+  return (size / (1024 * 1024)).toFixed(1) + ' MB'
+}
+
+/**
+ * 体积是否超过单文件上限（主机 >32MB 会直接拒绝，界面提前拦一层）。
+ * @author ddj 2026年11月03号
+ * @param size 字节数（主机未提供体积时为 undefined ⇒ 不预判）
+ * @returns 是否超限
+ */
+export function isOversized(size: number | undefined): boolean {
+  return typeof size === 'number' && size > DL_SIZE_CAP
+}
+
+/**
+ * 目录优先 + 名称排序的比较器（与资源管理器视觉一致）。
+ * @author ddj 2026年11月03号
+ * @param nodes 节点表
+ * @param left 左路径
+ * @param right 右路径
+ * @returns 比较结果
+ */
+function compareNodes(nodes: Map<string, DlNode>, left: string, right: string): number {
+  const one = nodes.get(left)
+  const two = nodes.get(right)
+  if (!one || !two) return 0
+  if (one.kind !== two.kind) return one.kind === 'directory' ? -1 : 1
+  return one.name.localeCompare(two.name)
+}

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