dsh-vscode-mode 0.23.5 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.23.5",
+  "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/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/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 }),