dsh-vscode-mode 0.23.5 → 0.25.0

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/sidebar/menuItems.ts

@@ -23,6 +23,8 @@ import { rpc } from '../rpc.js'
 import { absoluteOf, relativeOf } from '../tabActions.js'
 import { copyText } from '../copyText.js'
 import { clearFileClip, fileClipOf, setFileClip } from '../fileClipboard.js'
+import { downloadTarget } from '../downloadFile.js'
+import { isRemoteChannel } from '../../shared/remoteChannel.js'
 import type { TreeMenuItem } from './contextMenu.js'
 import type { SidebarCtx } from './types.js'
 import type { TreeMenuTarget } from './contextMenu.js'
@@ -39,6 +41,8 @@ const ORDER_COPY = 80
 const ORDER_PASTE = 90
 const ORDER_COPY_PATH = 110
 const ORDER_COPY_REL = 120
+/** 远程下载（仅远程访问可见）落在复制路径段之后、重命名段之前，不新起视觉块。 */
+const ORDER_DOWNLOAD = 125
 const ORDER_RENAME = 140
 const ORDER_DELETE = 150
 const SVN_ORDER_BASE = 200
@@ -454,6 +458,28 @@ function editGroupItems(): TreeMenuItem[] {
 
 // --endregion
 
+// --region 远程下载（仅远程访问可见）
+
+/**
+ * 「下载到本机」菜单项：远程访问时把工作区文件拉回浏览器所在机器。
+ * 可见性唯一判据是通道 seat（{@link isRemoteChannel}）——本机回环页面完全看不到该项，
+ * 也不因打开菜单发出任何请求；文件目标直下，文件夹 / 根空白区弹勾选弹窗。
+ * @author ddj 2026年11月03号
+ * @returns 菜单项数组（固定 1 项，显隐交给 visible）
+ */
+function downloadItems(): TreeMenuItem[] {
+  return [{
+    id: 'remote-download',
+    label: (target) => (target.type === 'file' ? '下载到本机' : '下载到本机…'),
+    order: ORDER_DOWNLOAD,
+    group: GROUP_COPY_PATH,
+    visible: () => isRemoteChannel(),
+    run: (target, ctx) => { void downloadTarget(target, ctx) },
+  }]
+}
+
+// --endregion
+
 // --region SVN 组（动作清单来自 shared/svnActions.ts）
 
 /** 目标路径对应的变更条目（不在清单里返回 undefined）。 */
@@ -559,6 +585,7 @@ export function createDefaultFileMenuItems(): TreeMenuItem[] {
     ...refGroupItems(),
     ...clipGroupItems(),
     ...copyPathItems(),
+    ...downloadItems(),
     ...editGroupItems(),
     ...svnMenuItems(),
   ]

package/src/client/styles/editor.css

@@ -899,6 +899,30 @@
 
 
 
+/* 远程下载确认框（仅远程访问时由资源管理器右键打开）：懒加载目录树 + 文件勾选。
+   卡片与遮罩由 ModalShell 提供（vsm-mcp-dialog / edrv-modal-mask，z-index 190），
+   此处只补树列表与底栏布局。⚠️ 规则一律以 [data-edrv-view] 开头，否则整块失配。 */
+[data-edrv-view] .edrv-dl-dialog { display: flex; flex-direction: column; gap: 10px; }
+[data-edrv-view] .edrv-dl-sub { margin: -6px 0 2px; font-size: 12px; color: var(--dsw-alias-label-tertiary, #9aa5b1); word-break: break-all; }
+[data-edrv-view] .edrv-dl-tree { display: flex; flex-direction: column; gap: 1px; min-height: 120px; max-height: min(48vh, 420px); overflow: auto; padding: 4px; border: 1px solid var(--dsw-alias-border-l1, #3a3a3a); border-radius: 8px; background: var(--dsw-alias-bg-layer-1, #262626); }
+[data-edrv-view] .edrv-dl-row { display: flex; align-items: center; gap: 6px; min-height: 26px; padding: 2px 6px; border-radius: 6px; font-size: 13px; color: var(--dsw-alias-label-primary, #e6e6e6); }
+[data-edrv-view] .edrv-dl-row:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(255, 255, 255, .06)); }
+[data-edrv-view] .edrv-dl-row.is-dir { cursor: pointer; }
+[data-edrv-view] .edrv-dl-twist { flex: 0 0 auto; width: 18px; height: 18px; color: var(--dsw-alias-label-secondary, #aaa); font-size: 11px; line-height: 18px; text-align: center; }
+[data-edrv-view] .edrv-dl-name { flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; cursor: pointer; }
+[data-edrv-view] .edrv-dl-dir { font-weight: 600; }
+[data-edrv-view] .edrv-dl-size { flex: 0 0 auto; font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); }
+[data-edrv-view] .edrv-dl-size.is-large { color: var(--dsw-alias-state-warn-primary, #e5b93f); }
+[data-edrv-view] .edrv-dl-hint { padding: 3px 8px; font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); }
+[data-edrv-view] .edrv-dl-hint.is-error { display: flex; align-items: center; gap: 8px; color: var(--dsw-alias-state-error-primary, #f07878); }
+[data-edrv-view] .edrv-dl-hint button { padding: 2px 8px; border: 1px solid var(--dsw-alias-border-l2, #555); border-radius: 5px; background: none; color: var(--dsw-alias-label-primary, #eee); font-size: 11px; cursor: pointer; }
+[data-edrv-view] .edrv-dl-foot { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+[data-edrv-view] .edrv-dl-count { margin-right: auto; font-size: 12px; color: var(--dsw-alias-label-secondary, #aaa); }
+[data-edrv-view] .edrv-dl-foot button { padding: 6px 12px; border: 1px solid var(--dsw-alias-border-l2, #555); border-radius: 6px; background: none; color: var(--dsw-alias-label-primary, #eee); font-size: 12px; cursor: pointer; }
+[data-edrv-view] .edrv-dl-foot button:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover, rgba(255, 255, 255, .06)); }
+[data-edrv-view] .edrv-dl-foot button:disabled { opacity: .55; cursor: default; }
+[data-edrv-view] .edrv-dl-go { border-color: var(--dsw-alias-brand-primary, #6d55ff); }
+
 /* 调试（DAP）：断点圆点 / 停帧行 / 浮动调试工具条。
    圆点挂在 Monaco glyphMargin（glyphMarginClassName），行背景为 isWholeLine className；
    工具条绝对定位于编辑区右上（editorArea relative 由 .edrv-editor-area 自身定位）。 */

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/DownloadPicker.ts

@@ -0,0 +1,305 @@
+/**
+ * dsh-vscode-mode client — 「下载到本机」确认框（仅远程访问时由右键菜单打开）。
+ *
+ * 形态：ModalShell 居中卡片 + 懒加载目录树 + 文件勾选。产品决策是「不打包」：
+ * 这里只收集勾选，由调用方（downloadFile.ts）逐个下载原文件。
+ *
+ * 目录节点只负责展开、不带勾选框：勾选粒度是文件，避免半选目录的语义歧义；
+ * 「全选」只覆盖已展开（已加载）的文件，不会为了全选把整棵树拉一遍。
+ * 样式见 editor.css 的 `[data-edrv-view] .edrv-dl-*`；本组件不新建 portal，
+ * 因此自动满足 tests/overlayScope.test.ts 的 data-edrv-view 契约。
+ * 作者 ddj 2026年11月03号
+ */
+import React from 'react'
+import { createRoot } from 'react-dom/client'
+import { rpc } from '../rpc.js'
+import type { TreeEntry } from '../../shared/rpc.js'
+import { ModalShell } from './ModalShell.js'
+import {
+  clearSelected, collapseDir, createDlState, expandDir, formatSize, hasLoaded, isOversized, markError, markLoading,
+  mergeChildren, rowList, selectLoaded, selectedFiles, toggleFile,
+} from '../downloadPickerModel.js'
+import type { DlRow, DlState } from '../downloadPickerModel.js'
+
+/** 弹窗属性：只做「选文件」这件事，下载编排由调用方负责。 */
+export interface DownloadPickerProps {
+  /** 弹窗根：工作区相对路径；'' = 整个工作区。 */
+  root: string
+  /** 会话 id（工作区解析用）。 */
+  sessionId?: string
+  /** 取消（Esc / 遮罩 / 取消按钮）。 */
+  onClose: () => void
+  /** 确认：传勾选的文件路径（至少 1 个）。 */
+  onConfirm: (paths: string[]) => void
+}
+
+/**
+ * 「下载到本机」确认框。
+ * @author ddj 2026年11月03号
+ * @param props 弹窗属性
+ * @returns 弹窗元素
+ */
+export function DownloadPicker(props: DownloadPickerProps): React.ReactElement {
+  const { root, sessionId, onClose, onConfirm } = props
+  const [state, setState] = React.useState<DlState>(() => createDlState(root))
+  const aliveRef = React.useRef(true)
+
+  React.useEffect(() => () => { aliveRef.current = false }, [])
+
+  /**
+   * 拉取某目录一层子项（懒加载的唯一入口）。
+   * @author ddj 2026年11月03号
+   * @param dirPath 目录路径（'' = 工作区根）
+   */
+  const loadDir = React.useCallback(async (dirPath: string): Promise<void> => {
+    setState((prev) => markLoading(prev, dirPath))
+    try {
+      const args = sessionId ? { sessionId, path: dirPath } : { path: dirPath }
+      const out = await rpc('edrv.listDir', args)
+      if (!aliveRef.current) return
+      if (!out.ok) {
+        setState((prev) => markError(prev, dirPath, out.error))
+        return
+      }
+      setState((prev) => mergeChildren(prev, dirPath, out.entries))
+    } catch (error) {
+      if (!aliveRef.current) return
+      setState((prev) => markError(prev, dirPath, textOfError(error)))
+    }
+  }, [sessionId])
+
+  React.useEffect(() => { void loadDir(root) }, [loadDir, root])
+
+  /**
+   * 展开 / 收起目录；首次展开才发 listDir。
+   * @author ddj 2026年11月03号
+   * @param path 目录路径
+   */
+  function onToggleDir(path: string): void {
+    const expanded = state.expanded.has(path)
+    setState((prev) => (expanded ? collapseDir(prev, path) : expandDir(prev, path)))
+    if (expanded || hasLoaded(state, path) || state.loading.has(path)) return
+    void loadDir(path)
+  }
+
+  /**
+   * 勾选 / 取消勾选单个文件。
+   * @author ddj 2026年11月03号
+   * @param path 文件路径
+   */
+  function onToggleFile(path: string): void {
+    setState((prev) => toggleFile(prev, path))
+  }
+
+  const rows = rowList(state)
+  const picked = selectedFiles(state)
+  const empty = hasLoaded(state, root) && rows.length === 0 && !state.loading.has(root)
+
+  /**
+   * 单行渲染（目录出三角、文件出勾选框；超限文件置灰不可勾）。
+   * @author ddj 2026年11月03号
+   * @param row 行数据
+   * @returns 行元素
+   */
+  function renderRow(row: DlRow): React.ReactElement {
+    const indent = { paddingLeft: 6 + row.depth * 14 }
+    if (row.kind === 'directory') return renderDirRow(row, indent, onToggleDir, loadDir)
+    return renderFileRow(row, indent, onToggleFile)
+  }
+
+  return React.createElement(ModalShell, {
+    dialogClass: 'edrv-dl-dialog',
+    width: 'min(640px, calc(100vw - 40px))',
+    onClose,
+  },
+    React.createElement('h3', null, '下载到本机'),
+    React.createElement('div', { className: 'edrv-dl-sub' }, root ? '/' + root : '工作区根目录'),
+    renderTree({ state, root, rows, empty, loadDir, renderRow, onToggleDir, onToggleFile }),
+    renderFoot({
+      picked,
+      rows,
+      onSelectAll: () => setState(selectLoaded),
+      onClear: () => setState(clearSelected),
+      onClose,
+      onConfirm,
+    }),
+  )
+}
+
+/** 目录树区域属性（全部由组件传入，渲染函数本身不持有状态）。 */
+interface TreeOpts {
+  state: DlState
+  root: string
+  rows: DlRow[]
+  empty: boolean
+  loadDir: (dirPath: string) => Promise<void>
+  renderRow: (row: DlRow) => React.ReactElement
+  onToggleDir: (path: string) => void
+  onToggleFile: (path: string) => void
+}
+
+/**
+ * 目录树区域：行列表 + 根加载态 + 根错误重试 + 空态。
+ * @author ddj 2026年11月03号
+ * @param opts 树区域属性
+ * @returns 树区域元素
+ */
+function renderTree(opts: TreeOpts): React.ReactElement {
+  const { state, root, rows, empty, loadDir, renderRow } = opts
+  return React.createElement('div', { className: 'edrv-dl-tree' },
+    rows.length ? rows.map(renderRow) : null,
+    state.loading.has(root) ? React.createElement('div', { className: 'edrv-dl-hint' }, '加载中…') : null,
+    state.errors.has(root) ? renderRetry(root, state.errors.get(root) || '', loadDir) : null,
+    empty ? React.createElement('div', { className: 'edrv-dl-hint' }, '此文件夹内没有可下载的文件') : null,
+  )
+}
+
+/** 底栏属性：已选数量、批量勾选动作与确认/取消回调。 */
+interface FootOpts {
+  picked: string[]
+  rows: DlRow[]
+  onSelectAll: () => void
+  onClear: () => void
+  onClose: () => void
+  onConfirm: (paths: string[]) => void
+}
+
+/**
+ * 底栏：已选数量 + 全选已展开 / 清空 / 取消 / 下载。
+ * @author ddj 2026年11月03号
+ * @param opts 底栏属性
+ * @returns 底栏元素
+ */
+function renderFoot(opts: FootOpts): React.ReactElement {
+  const { picked, rows, onSelectAll, onClear, onClose, onConfirm } = opts
+  return React.createElement('div', { className: 'edrv-dl-foot' },
+    React.createElement('span', { className: 'edrv-dl-count' }, '已选 ' + picked.length + ' 个文件'),
+    React.createElement('button', { type: 'button', disabled: !rows.length, onClick: onSelectAll }, '全选已展开'),
+    React.createElement('button', { type: 'button', disabled: !picked.length, onClick: onClear }, '清空'),
+    React.createElement('button', { type: 'button', onClick: onClose }, '取消'),
+    React.createElement('button', {
+      type: 'button',
+      className: 'edrv-dl-go',
+      disabled: !picked.length,
+      onClick: () => onConfirm(picked),
+    }, '下载 ' + picked.length + ' 个文件'),
+  )
+}
+
+/**
+ * 目录行：三角展开 / 收起，名称后带加载或错误提示。
+ * @author ddj 2026年11月03号
+ * @param row 行数据
+ * @param indent 缩进样式
+ * @param onToggle 展开回调
+ * @param retry 重试加载回调
+ * @returns 目录行元素
+ */
+function renderDirRow(
+  row: DlRow,
+  indent: React.CSSProperties,
+  onToggle: (path: string) => void,
+  retry: (path: string) => Promise<void>,
+): React.ReactElement {
+  // 整行可点（三角与名称都展开），避免只有三角能点导致误以为无子项
+  return React.createElement('div', {
+    key: row.path,
+    className: 'edrv-dl-row is-dir',
+    style: indent,
+    onClick: () => onToggle(row.path),
+  },
+    React.createElement('span', { className: 'edrv-dl-twist' }, row.expanded ? '▾' : '▸'),
+    React.createElement('span', { className: 'edrv-dl-name edrv-dl-dir' }, row.name),
+    row.loading ? React.createElement('span', { className: 'edrv-dl-hint' }, '加载中…') : null,
+    row.error ? renderRetry(row.path, row.error, retry) : null,
+  )
+}
+
+/**
+ * 文件行：勾选框 + 名称 + 体积；超限文件禁用勾选并标注原因。
+ * @author ddj 2026年11月03号
+ * @param row 行数据
+ * @param indent 缩进样式
+ * @param onToggle 勾选回调
+ * @returns 文件行元素
+ */
+function renderFileRow(
+  row: DlRow,
+  indent: React.CSSProperties,
+  onToggle: (path: string) => void,
+): React.ReactElement {
+  const oversized = isOversized(row.size)
+  return React.createElement('div', { key: row.path, className: 'edrv-dl-row', style: indent },
+    React.createElement('input', {
+      type: 'checkbox',
+      checked: row.checked,
+      disabled: oversized,
+      onChange: () => onToggle(row.path),
+    }),
+    React.createElement('span', { className: 'edrv-dl-name', onClick: () => onToggle(row.path) }, row.name),
+    oversized
+      ? React.createElement('span', { className: 'edrv-dl-size is-large' }, '超过 32MB')
+      : (typeof row.size === 'number' ? React.createElement('span', { className: 'edrv-dl-size' }, formatSize(row.size)) : null),
+  )
+}
+
+/**
+ * 错误行 + 重试按钮（保留主机错误原文）。
+ * @author ddj 2026年11月03号
+ * @param path 目录路径
+ * @param message 错误原文
+ * @param retry 重试回调
+ * @returns 提示行元素
+ */
+function renderRetry(path: string, message: string, retry: (path: string) => Promise<void>): React.ReactElement {
+  return React.createElement('div', { key: 'err:' + path, className: 'edrv-dl-hint is-error' },
+    React.createElement('span', null, message),
+    React.createElement('button', {
+      type: 'button',
+      onClick: (event: React.MouseEvent) => {
+        // 错误行嵌在目录行内，重试不应顺带切换该目录的展开态
+        event.stopPropagation()
+        void retry(path)
+      },
+    }, '重试'),
+  )
+}
+
+/**
+ * 挂载弹窗：临时宿主 + createRoot，关闭时卸载并移除（与工作区选择弹窗同一范式）。
+ * @author ddj 2026年11月03号
+ * @param opts 根目录 / 会话 / 确认回调
+ * @sideEffects 向 body 追加一个宿主节点，关闭时移除
+ */
+export function openDownloader(opts: { root: string; sessionId?: string; onConfirm: (paths: string[]) => void }): void {
+  const host = document.createElement('div')
+  document.body.appendChild(host)
+  const mount = createRoot(host)
+
+  function close(): void {
+    mount.unmount()
+    host.remove()
+  }
+
+  function confirm(paths: string[]): void {
+    close()
+    opts.onConfirm(paths)
+  }
+
+  mount.render(React.createElement(DownloadPicker, {
+    root: opts.root,
+    sessionId: opts.sessionId,
+    onClose: close,
+    onConfirm: confirm,
+  }))
+}
+
+/**
+ * 错误可读文案（Error.message 优先，其余 String 化）。
+ * @author ddj 2026年11月03号
+ * @param error 捕获值
+ * @returns 提示文案
+ */
+function textOfError(error: unknown): string {
+  return error instanceof Error ? error.message : String(error)
+}

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/shared/remoteChannel.ts

@@ -0,0 +1,70 @@
+/**
+ * 远程访问通道适配：插件内部路径 → 远程传输可达路径。
+ *
+ * 背景：宿主 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 ''
+  }
+}
+
+/**
+ * 本页是否经远程访问通道接入（远程 vs 本机回环）。
+ * 与 {@link import('../client/rpc.js').channelNote} 同口径：只认通道 seat，不解析地址。
+ * 用于「仅远程可用」能力的显隐，例如资源管理器的「下载到本机」。
+ * @author ddj 2026年11月03号
+ * @returns 已接入远程通道为 true；本机、桌面 dsh-app:、未装该插件均为 false
+ */
+export function isRemoteChannel(): boolean {
+  return channelPrefix() !== ''
+}
+
+/**
+ * 给插件内部路径加通道前缀。
+ * @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 }),