dsh-vscode-mode 0.1.53 → 0.1.55

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/compat.ts

@@ -92,3 +92,34 @@ export function patchMethod<T extends object, K extends keyof T>(
     if (owner[key] === patched) owner[key] = original
   }
 }
+
+/** patchAccessor 的包装实现形状（original 为补丁前的实时实现）。 */
+export type PatchWrapper = (original: (...args: never[]) => unknown, ...args: never[]) => unknown
+
+/**
+ * accessor 感知的链式补丁：DSH 0.1.3+ 的 remote 命名空间方法（如
+ * remote.session.openWorkspacePath）是 getter-only accessor（Object.defineProperty
+ * 仅定义 get，直接赋值在严格模式下抛 TypeError），须整体替换属性描述符。
+ * 新 getter 每次访问现场调用原 getter 取最新一次性函数作 original，天然跟随
+ * DSH 内部 methods 表变化；data 属性降级走 patchMethod；属性缺失返回 null。
+ * @author ddj 2026年09月08号
+ * @param owner 目标对象
+ * @param key 属性名
+ * @param wrapper 包装实现（original 为补丁前的实时实现）
+ * @returns 恢复函数（幂等、带归属校验）；属性缺失时返回 null
+ */
+export function patchAccessor(owner: object, key: string, wrapper: PatchWrapper): (() => void) | null {
+  const descriptor = Object.getOwnPropertyDescriptor(owner, key)
+  if (!descriptor) return null
+  if (typeof descriptor.get !== 'function') return patchMethod(owner, key as never, wrapper as never)
+  const rawGet = descriptor.get as (this: object) => unknown
+  const patchedGet = function (): unknown {
+    const original = (...args: never[]) => (rawGet.call(owner) as (...args: never[]) => unknown)(...args)
+    return (...args: never[]) => wrapper(original, ...args)
+  }
+  Object.defineProperty(owner, key, { configurable: true, enumerable: descriptor.enumerable, get: patchedGet })
+  return () => {
+    const current = Object.getOwnPropertyDescriptor(owner, key)
+    if (current?.get === patchedGet) Object.defineProperty(owner, key, descriptor)
+  }
+}

package/src/client/imagePreview.ts

@@ -0,0 +1,45 @@
+/**
+ * dsh-vscode-mode client — 图片文件判定与 data URL 组装（编辑区图片预览面板用）。
+ * 纯函数、无 DOM 依赖，便于单测；MIME 表收敛在 shared/rpc.ts（host base64 响应同源）。
+ * @author ddj 2026年09月08号
+ */
+import { IMAGE_MIME } from '../shared/rpc.js'
+
+/** 可预览的图片扩展名集合（小写、无点）。 */
+const IMAGE_EXT_SET: Set<string> = new Set(Object.keys(IMAGE_MIME))
+
+/**
+ * 判断路径是否为可预览的图片文件（取 basename 扩展名，大小写不敏感）。
+ * @author ddj 2026年09月08号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 是否图片文件
+ */
+export function isImagePath(path: string): boolean {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  if (dot <= 0) return false
+  return IMAGE_EXT_SET.has(base.slice(dot + 1).toLowerCase())
+}
+
+/**
+ * 判断路径是否为 SVG 文件（唯一提供「以文本打开」切换的图片格式）。
+ * @author ddj 2026年09月08号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 是否 SVG
+ */
+export function isSvgPath(path: string): boolean {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  return dot > 0 && base.slice(dot + 1).toLowerCase() === 'svg'
+}
+
+/**
+ * base64 文本 → 可直接赋给 `<img src>` 的 data URL。
+ * @author ddj 2026年09月08号
+ * @param base64 base64 文本（不含 data: 前缀）
+ * @param mime MIME 类型（host edrv.read base64 响应携带）
+ * @returns data URL 字符串
+ */
+export function dataUrlOf(base64: string, mime: string): string {
+  return 'data:' + (mime || 'application/octet-stream') + ';base64,' + base64
+}

package/src/client/index.ts

@@ -25,6 +25,7 @@ import { loadMonaco } from './monaco/loader.js'
 import { createFileOpenerRegistry, scanSidebar, type FileOpenContext } from './fileOpeners.js'
 import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.js'
+import { patchRemoteOpen, probeRemoteOpen } from './remoteOpenRouter.js'
 import { setupExtOpen } from './externalOpen.js'
 import { SettingsContext } from './settingsContext.js'
 import { SIDEBAR_PLUGIN, pickSettingsBinder, registerSlotSafely } from './compat.js'
@@ -98,6 +99,17 @@ export function apply(ctx: any): void {
   const binder = pickSettingsBinder(ctx)
   const settings = binder.scope
   let selected = autoValue('auto')
+  /** 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）是否已安装（compatSummary 展示用）。 */
+  let remoteOpenInstalled = false
+  /** 两条文件链接路由共用的路由日志（openPathRouter / remoteOpenRouter）。 */
+  const routeLogger = (message: string): void => console.warn('[dsh-vscode-mode] ' + message)
+  /** 两条路由共用的 FileOpenContext：当前会话 id 与工作区 cwd。 */
+  const openContext = (): FileOpenContext => {
+    const current = sessions?.list?.getSnapshot?.()
+    const sessionId = current?.current
+    const summary = sessionId ? current?.byId?.[sessionId] : undefined
+    return { sessionId, cwd: summary?.cwd } as FileOpenContext
+  }
   /** 可选探测 betterSidebar 服务（不进 inject：缺失会让插件停靠等待，杀死回退路径）。 */
   let sideService = detectSidebarService(ctx)
   /** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
@@ -106,7 +118,8 @@ export function apply(ctx: any): void {
   /** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
   const compatSummary = (): CompatAdapter[] => [
     { name: '设置桥', active: settings !== undefined, note: settings !== undefined ? '使用 ' + binder.service + ' 桥' : '未绑定设置服务（fileOpenTool 持久化不可用）' },
-    { name: '文件打开路由（workspaces.openPath）', active: Boolean(workspaces?.openPath), note: 'vscode 打开器优先，失败回退系统打开' },
+    { name: '文件打开路由（workspaces.openPath）', active: Boolean(workspaces?.openPath), note: 'vscode 打开器优先，失败回退系统打开（0.1.2 及更早 DSH 的对话文件链接主路径）' },
+    { name: '会话文件链接路由（remote.session.openWorkspacePath）', active: remoteOpenInstalled, note: '0.1.3+ 对话文件引用/产物打开优先走插件打开器，失败回退系统打开' },
     { name: '侧边栏打开器（' + SIDEBAR_PLUGIN + '）', active: registry.get(SIDEBAR_PLUGIN) !== undefined, note: registry.get(SIDEBAR_PLUGIN) !== undefined ? '已注册（优先级 80）' : '未检测到侧边栏打开能力' },
     { name: '侧边栏编辑区（' + SIDEBAR_PLUGIN + '）', active: sideService !== undefined, note: sideService !== undefined ? '编辑区=侧边栏 Tab（对话+编辑同屏）' : '未检测到；安装 dsh-better-sidebar 后刷新启用侧边栏形态（' + SIDEBAR_INSTALL_CMD + '）' },
   ]
@@ -173,15 +186,40 @@ export function apply(ctx: any): void {
       workspaces,
       registry,
       selected: () => selected,
-      context: () => {
-        const current = sessions?.list?.getSnapshot?.()
-        const sessionId = current?.current
-        const summary = sessionId ? current?.byId?.[sessionId] : undefined
-        return { sessionId, cwd: summary?.cwd } as FileOpenContext
-      },
-      logger: (message: string) => console.warn('[dsh-vscode-mode] ' + message),
+      context: openContext,
+      logger: routeLogger,
     }), 'vscode-mode: file link routing')
   }
+  // 0.1.3+ 会话文件链接主路径：dsh-client-ui-chat 的 openFile 直接调
+  // remote.session.openWorkspacePath（session/openWorkspacePath RPC），绕开
+  // workspaces.openPath；该 namespace 由 api-remotes 在 loader.await 后挂载，
+  // 晚于本插件 apply，且旧版 DSH 可能整段不存在——不加 inject（避免旧版停等
+  // 永不激活），改为定时探测有界重试（与侧栏服务探测同款节奏）。
+  let remoteRetries = 0
+  const retryRemoteOpen = (): void => {
+    if (remoteOpenInstalled || remoteRetries >= 15) {
+      if (!remoteOpenInstalled) console.warn('[dsh-vscode-mode] 未探测到 remote.session.openWorkspacePath，0.1.3+ 会话文件链接路由未安装')
+      return
+    }
+    remoteRetries += 1
+    schedule(() => {
+      if (remoteOpenInstalled) return
+      const service = probeRemoteOpen(ctx)
+      if (!service) {
+        retryRemoteOpen()
+        return
+      }
+      const disposer = patchRemoteOpen(service, { registry, selected: () => selected, context: openContext, logger: routeLogger })
+      if (!disposer) {
+        console.warn('[dsh-vscode-mode] remote.session 存在但 openWorkspacePath 不可补丁，会话文件链接路由未安装')
+        return
+      }
+      remoteOpenInstalled = true
+      ctx.effect(() => disposer, 'vscode-mode: remote file link routing')
+      console.info('[dsh-vscode-mode] 已安装 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）')
+    }, 2000)
+  }
+  retryRemoteOpen()
 
   // 中央「文件编辑」页签（旧形态回退）：类 VSCode 编辑器；侧边栏形态可用时编辑器住 betterSidebar Tab，
   // 本页签不注册（避免双实例：Monaco×2 + diff dock 每会话单源抢占）。

package/src/client/pdf/pdfLoader.ts

@@ -0,0 +1,82 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — pdf.js 加载器（vendor 产物离线随包，/edrv/vendor/pdfjs/*）。
+ * 加载链：module script 内按序动态 import build/pdf.mjs（自挂 globalThis.pdfjsLib）→
+ * web/pdf_viewer.mjs（从 globalThis.pdfjsLib 解构）→ window.__edrvPdfjs handoff。
+ * 用 script 注入而非打包内 import()：客户端包是 CJS，bundler 会改写动态 import 破坏 URL 语义。
+ * 作者 ddj 2026-09-22
+ */
+
+/** vendor 根（routes.ts /edrv/vendor 前缀路由分发 assets/vendor/*）。 */
+export const PDFJS_BASE = '/edrv/vendor/pdfjs'
+/** pdf.js Worker 地址（GlobalWorkerOptions.workerSrc）。 */
+export const PDFJS_WORKER_SRC = PDFJS_BASE + '/build/pdf.worker.mjs'
+/** CJK 字符映射目录（中文 PDF 渲染必需，尾斜杠固定）。 */
+export const PDFJS_CMAP_URL = PDFJS_BASE + '/cmaps/'
+/** 标准字体目录（未嵌字体 PDF 兜底，尾斜杠固定）。 */
+export const PDFJS_FONT_URL = PDFJS_BASE + '/standard_fonts/'
+/** 组件层样式（pdfViewer/textLayer/annotationEditor 布局）。 */
+const PDFJS_CSS_URL = PDFJS_BASE + '/web/pdf_viewer.css'
+
+let pdfjsPromise = null
+
+/**
+ * 注入 pdf_viewer.css（幂等；vendor 路由带 etag 协商缓存，重复挂载走 304）。
+ * @author ddj 2026年09月22号
+ */
+function ensurePdfCss() {
+  if (typeof document === 'undefined') return
+  if (document.querySelector('link[data-edrv-pdfjs-css]')) return
+  const link = document.createElement('link')
+  link.rel = 'stylesheet'
+  link.href = PDFJS_CSS_URL
+  link.dataset.edrvPdfjsCss = '1'
+  document.head.appendChild(link)
+}
+
+/**
+ * 加载 pdf.js（core + viewer 组件层）：去重 promise，失败重置允许重试（对齐 monaco loader）。
+ * @author ddj 2026年09月22号
+ * @returns Promise<{lib, viewer}> lib=build/pdf.mjs（getDocument/GlobalWorkerOptions/编辑器枚举等），viewer=web/pdf_viewer.mjs（PDFViewer/EventBus 等）
+ */
+export function loadPdfjs() {
+  if (!pdfjsPromise) {
+    pdfjsPromise = new Promise((resolve, reject) => {
+      ensurePdfCss()
+      const boot = () => {
+        const handoff = window.__edrvPdfjs
+        if (handoff && handoff.lib && handoff.viewer) {
+          try {
+            handoff.lib.GlobalWorkerOptions.workerSrc = PDFJS_WORKER_SRC
+          } catch (error) { /* worker 配置失败留给 getDocument 报错 */ }
+          resolve(handoff)
+          return
+        }
+        reject(new Error('pdf.js 模块加载失败：handoff 缺失'))
+      }
+      const fail = (error) => {
+        pdfjsPromise = null
+        reject(error instanceof Error ? error : new Error(String(error)))
+      }
+      const existing = document.querySelector('script[data-edrv-pdfjs-loader]')
+      if (existing) {
+        // 前一次注入仍在执行：等 handoff 出现（module 评估完即写入）
+        existing.addEventListener('edrv-pdfjs-ready', boot, { once: true })
+        if (window.__edrvPdfjs) boot()
+        return
+      }
+      const s = document.createElement('script')
+      s.type = 'module'
+      s.textContent =
+        'import * as lib from "' + PDFJS_BASE + '/build/pdf.mjs";\n' +
+        'import * as viewer from "' + PDFJS_BASE + '/web/pdf_viewer.mjs";\n' +
+        'window.__edrvPdfjs = { lib, viewer };\n' +
+        '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 路由可达）'))
+      document.head.appendChild(s)
+    })
+  }
+  return pdfjsPromise
+}

package/src/client/pdf/pdfPanel.ts

@@ -0,0 +1,239 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — PDF 面板控制器（命令式 DOM，React 只渲染外壳 div）。
+ * 浏览：PDFViewer 组件（虚拟化渲染 + 文本层）；编辑：内置注释编辑器
+ * （FreeText 文本框 / Ink 画笔 / Highlight 高亮），保存经 pdfDocument.saveDocument()
+ * → base64 → edrv.saveBinary 回写原文件。接线方式对齐官方 viewer（web/app.js）。
+ * 作者 ddj 2026-09-22
+ */
+import { rpc } from '../rpc.js'
+import { bytesToBase64 } from '../pdfPreview.js'
+import { loadPdfjs, PDFJS_CMAP_URL, PDFJS_FONT_URL } from './pdfLoader.js'
+
+/** 无障碍占位 l10n：组件内 translate 为 fire-and-forget，stub 避免触发 locale 404。 */
+const L10N_STUB = {
+  get: async (key) => key,
+  translate: async () => {},
+  getDirection: () => 'ltr',
+}
+
+/**
+ * PDF 面板控制器工厂。
+ * @author ddj 2026年09月22号
+ * @param deps 依赖：sessionId/path（保存回写目标）+ 状态栏回调
+ * @returns 控制器：mount/destroy/savePdf/setMode/isDirty
+ */
+export function createPdfPanel(deps) {
+  const status = (t) => { try { deps.setStatus(t) } catch { /* 状态栏回调异常忽略 */ } }
+
+  let stage = null
+  let pageLabel = null
+  let eventBus = null
+  let busAbort = null
+  let editorTypes = null
+  let pdfViewer = null
+  let pdfDocument = null
+  let loadingTask = null
+  let modeButtons = null
+  let destroyed = false
+  let dirty = false
+  let saving = false
+
+  /** 脏状态上抛（tab 脏点）+ 本地记忆。 */
+  const setDirty = (value) => {
+    dirty = value
+    if (modeButtons) modeButtons.save.classList.toggle('edrv-pdf-dirty', value)
+    try { deps.onDirtyChange(value) } catch { /* 脏点回调异常忽略 */ }
+  }
+
+  /** 页码指示更新（pagechanging/pagesinit 事件）。 */
+  const updatePageLabel = () => {
+    if (!pageLabel || !pdfViewer) return
+    pageLabel.textContent = pdfViewer.currentPageNumber + ' / ' + pdfViewer.pagesCount
+  }
+
+  /** 编辑模式按钮高亮同步（annotationeditormodechanged 事件；evt.mode 为枚举数值）。 */
+  const syncModeButtons = (mode) => {
+    if (!modeButtons || !editorTypes) return
+    const byValue = { [editorTypes.NONE]: 'none', [editorTypes.FREETEXT]: 'freetext', [editorTypes.INK]: 'ink', [editorTypes.HIGHLIGHT]: 'highlight' }
+    const key = byValue[mode] ?? 'none'
+    for (const k of Object.keys(modeButtons.modes)) {
+      modeButtons.modes[k].classList.toggle('edrv-pdf-mode-on', k === key)
+    }
+  }
+
+  /** 编辑模式符号键 → AnnotationEditorType 数值（版本间枚举值有差异，禁止硬编码）。 */
+  const modeValueOf = (key) => {
+    if (!editorTypes) return null
+    return { none: editorTypes.NONE, freetext: editorTypes.FREETEXT, ink: editorTypes.INK, highlight: editorTypes.HIGHLIGHT }[key] ?? null
+  }
+
+  /**
+   * 切换编辑模式（进入注释编辑器某模式或退出回 NONE）。
+   * @author ddj 2026年09月22号
+   * @param key 模式符号键：none/freetext/ink/highlight
+   */
+  const applyMode = (key) => {
+    if (!pdfViewer || !pdfDocument) { status('PDF 未就绪'); return }
+    const mode = modeValueOf(key)
+    if (mode === null) return
+    try {
+      pdfViewer.annotationEditorMode = { mode }
+      status(key === 'none' ? '已退出编辑' : '编辑模式：' + (key === 'freetext' ? '文本框' : key === 'ink' ? '画笔' : '高亮'))
+    } catch (error) {
+      status('切换编辑模式失败：' + String(error))
+    }
+  }
+
+  /**
+   * 保存编辑：saveDocument 导出 → base64 → edrv.saveBinary 回写。
+   * @author ddj 2026年09月22号
+   * @returns Promise<boolean> 是否成功
+   */
+  const savePdf = async () => {
+    if (saving) return false
+    if (!pdfDocument) { status('PDF 未就绪'); return false }
+    if (!dirty) { status('PDF 无未保存修改'); return true }
+    saving = true
+    status('正在保存 PDF…')
+    try {
+      const data = await pdfDocument.saveDocument()
+      const res = await rpc('edrv.saveBinary', { sessionId: deps.sessionId, path: deps.path, content: bytesToBase64(data), encoding: 'base64' })
+      if (res && res.ok) {
+        setDirty(false)
+        try { pdfDocument.annotationStorage.resetModified() } catch { /* 重置失败仅影响下次保存判定 */ }
+        status('已保存 ' + new Date().toTimeString().slice(0, 8))
+        return true
+      }
+      status('保存失败')
+      try { deps.setError(res?.error ? String(res.error) : '保存失败') } catch { /* 错误回调异常忽略 */ }
+      return false
+    } catch (error) {
+      status('保存失败')
+      try { deps.setError('PDF 保存异常:' + String(error)) } catch { /* 错误回调异常忽略 */ }
+      return false
+    } finally {
+      saving = false
+    }
+  }
+
+  /** 工具条 DOM（页码/缩放/编辑模式/保存/刷新）。 */
+  const buildToolbar = (root) => {
+    const bar = document.createElement('div')
+    bar.className = 'edrv-pdf-bar'
+    const mkBtn = (text, title, onClick, cls) => {
+      const b = document.createElement('button')
+      b.className = cls || 'edrv-pill edrv-pill-ghost'
+      b.textContent = text
+      b.title = title
+      b.addEventListener('click', onClick)
+      bar.appendChild(b)
+      return b
+    }
+    mkBtn('◀', '上一页', () => { if (pdfViewer) pdfViewer.currentPageNumber = Math.max(1, pdfViewer.currentPageNumber - 1) })
+    pageLabel = document.createElement('span')
+    pageLabel.className = 'edrv-pdf-page'
+    pageLabel.textContent = '…'
+    bar.appendChild(pageLabel)
+    mkBtn('▶', '下一页', () => { if (pdfViewer) pdfViewer.currentPageNumber = Math.min(pdfViewer.pagesCount, pdfViewer.currentPageNumber + 1) })
+    mkBtn('−', '缩小', () => { try { pdfViewer.decreaseScale() } catch { /* 缩放失败忽略 */ } }, 'edrv-pill edrv-pill-ghost edrv-pdf-zoom')
+    mkBtn('＋', '放大', () => { try { pdfViewer.increaseScale() } catch { /* 缩放失败忽略 */ } }, 'edrv-pill edrv-pill-ghost edrv-pdf-zoom')
+    bar.appendChild(document.createElement('span')).className = 'edrv-pdf-sep'
+    const modes = {}
+    modes.freetext = mkBtn('✎ 文本框', '插入文本框注释', () => applyMode('freetext'))
+    modes.ink = mkBtn('🖌 画笔', '手绘画笔注释', () => applyMode('ink'))
+    modes.highlight = mkBtn('🖍 高亮', '高亮选中文本', () => applyMode('highlight'))
+    modes.none = mkBtn('☐ 选择', '退出编辑模式', () => applyMode('none'))
+    modeButtons = { modes, save: null }
+    bar.appendChild(document.createElement('span')).className = 'edrv-pdf-sep'
+    mkBtn('⟳', '重新加载文件', () => { try { deps.onReload() } catch { /* 刷新回调异常忽略 */ } })
+    modeButtons.save = mkBtn('💾 保存', '保存修改到文件 (Ctrl+S)', () => { void savePdf() })
+    root.appendChild(bar)
+  }
+
+  /**
+   * 挂载面板并加载 PDF 字节。
+   * @author ddj 2026年09月22号
+   * @param host React 渲染的外壳 div（挂载后保持引用稳定）
+   * @param bytes PDF 原始字节
+   * @returns Promise<void> 渲染就绪或失败（失败置 deps.setError）
+   */
+  const mount = async (host, bytes) => {
+    try {
+      const pdfjs = await loadPdfjs()
+      if (destroyed) return
+      editorTypes = pdfjs.lib.AnnotationEditorType
+      busAbort = new AbortController()
+      const onBus = (name, fn) => eventBus.on(name, fn, { signal: busAbort.signal })
+      const root = document.createElement('div')
+      root.className = 'edrv-pdf'
+      buildToolbar(root)
+      stage = document.createElement('div')
+      stage.className = 'edrv-pdf-stage'
+      const viewerDiv = document.createElement('div')
+      viewerDiv.className = 'pdfViewer edrv-pdf-viewer'
+      stage.appendChild(viewerDiv)
+      root.appendChild(stage)
+      host.textContent = ''
+      host.appendChild(root)
+
+      eventBus = new pdfjs.viewer.EventBus()
+      const linkService = new pdfjs.viewer.PDFLinkService({ eventBus })
+      pdfViewer = new pdfjs.viewer.PDFViewer({
+        container: stage,
+        viewer: viewerDiv,
+        eventBus,
+        linkService,
+        l10n: L10N_STUB,
+        textLayerMode: 1,
+        annotationEditorMode: editorTypes.NONE,
+      })
+      linkService.setViewer(pdfViewer)
+      onBus('pagechanging', updatePageLabel)
+      onBus('pagesinit', () => {
+        try { pdfViewer.currentScaleValue = 'page-width' } catch { /* 初始缩放失败用默认值 */ }
+        updatePageLabel()
+      })
+      onBus('annotationeditormodechanged', (evt) => syncModeButtons(evt?.mode))
+
+      loadingTask = pdfjs.lib.getDocument({ data: bytes, cMapUrl: PDFJS_CMAP_URL, cMapPacked: true, standardFontDataUrl: PDFJS_FONT_URL })
+      pdfDocument = await loadingTask.promise
+      if (destroyed) { void loadingTask.destroy(); return }
+      const storage = pdfDocument.annotationStorage
+      storage.onSetModified = () => setDirty(true)
+      storage.onResetModified = () => setDirty(false)
+      pdfViewer.setDocument(pdfDocument)
+      linkService.setDocument(pdfDocument)
+      status('PDF 已就绪（' + pdfDocument.numPages + ' 页）')
+    } catch (error) {
+      if (destroyed) return
+      const message = String((error && (error.message || error.name)) || error)
+      const friendly = message.includes('password') ? '不支持加密 PDF' : 'PDF 加载失败：' + message
+      status('PDF 加载失败')
+      try { deps.setError(friendly) } catch { /* 错误回调异常忽略 */ }
+    }
+  }
+
+  /** 是否有未保存修改（EditorView Ctrl+S 分派用）。 */
+  const isDirty = () => dirty
+
+  /** 销毁：解绑事件、销毁文档与 DOM（重复调用安全）。 */
+  const destroy = () => {
+    destroyed = true
+    try { busAbort?.abort() } catch { /* 已中止 */ }
+    try { pdfViewer?.cleanup() } catch { /* 视图已销毁 */ }
+    try { void loadingTask?.destroy() } catch { /* 任务已销毁 */ }
+    try { void pdfDocument?.destroy() } catch { /* 文档已销毁 */ }
+    if (stage?.parentNode) stage.parentNode.removeChild(stage)
+    stage = null
+    eventBus = null
+    busAbort = null
+    editorTypes = null
+    pdfViewer = null
+    pdfDocument = null
+    loadingTask = null
+    modeButtons = null
+  }
+
+  return { mount, destroy, savePdf, isDirty }
+}

package/src/client/pdfPreview.ts

@@ -0,0 +1,48 @@
+/**
+ * dsh-vscode-mode client — PDF 文件判定与 base64 编解码（编辑区 PDF 面板用）。
+ * 纯函数、无 DOM 依赖，便于单测；PDF_MIME 收敛在 shared/rpc.ts（host base64 响应同源）。
+ * @author ddj 2026年09月22号
+ */
+import { PDF_MIME } from '../shared/rpc.js'
+
+export { PDF_MIME }
+
+/**
+ * 判断路径是否为 PDF 文件（取 basename 扩展名，大小写不敏感）。
+ * @author ddj 2026年09月22号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 是否 PDF 文件
+ */
+export function isPdfPath(path: string): boolean {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  return dot > 0 && base.slice(dot + 1).toLowerCase() === 'pdf'
+}
+
+/**
+ * base64 文本 → 二进制字节（喂给 pdf.js getDocument 的 data 入参）。
+ * @author ddj 2026年09月22号
+ * @param base64 base64 文本（不含 data: 前缀，host edrv.read base64 响应携带）
+ * @returns 原始字节
+ */
+export function base64ToBytes(base64: string): Uint8Array {
+  const bin = atob(String(base64 || ''))
+  const bytes = new Uint8Array(bin.length)
+  for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i)
+  return bytes
+}
+
+/**
+ * 二进制字节 → base64 文本（编辑保存回传 host 前的编码步骤）。
+ * @author ddj 2026年09月22号
+ * @param bytes 原始字节
+ * @returns base64 文本
+ */
+export function bytesToBase64(bytes: Uint8Array): string {
+  let bin = ''
+  const chunk = 0x8000
+  for (let i = 0; i < bytes.length; i += chunk) {
+    bin += String.fromCharCode(...bytes.subarray(i, i + chunk))
+  }
+  return btoa(bin)
+}

package/src/client/remoteOpenRouter.ts

@@ -0,0 +1,78 @@
+/**
+ * dsh-vscode-mode client — DSH 对话文件链接的 0.1.3+ 路由（remote.session 面）。
+ * 0.1.3 起 dsh-client-ui-chat 的 openFile 直接调 ctx.remote.session.openWorkspacePath
+ * （浏览器→host RPC session/openWorkspacePath），不再经过 workspaces.openPath，
+ * 旧路由补丁因此落空；该方法是 getter-only accessor，补丁经 compat.patchAccessor
+ * 换描述符安装。行为与 openPathRouter 对齐：插件打开器优先，"."（打开工作区文件夹）、
+ * 无可用打开器或打开失败时透传原实现（系统默认应用打开）。
+ * 纯逻辑，node 环境可单测（不依赖 DOM / events 模块）。
+ * 作者 ddj 2026年09月08号
+ */
+import { patchAccessor } from './compat.js'
+import { isAvailable, selectOpener, type FileOpenContext, type FileOpenerRegistry } from './fileOpeners.js'
+
+/** session.openWorkspacePath 的结果形状（host 返回 { opened: true }；客户端不做输出校验）。 */
+export interface OpenPathResult {
+  ok: boolean
+  value?: { opened: boolean }
+}
+
+/** openWorkspacePath 的请求形状；path 为 "." 时表示打开工作区文件夹。 */
+export interface OpenPathRequest {
+  path?: unknown
+}
+
+/** 补丁前 openWorkspacePath 的实时实现形状。 */
+type RemoteOpen = (request: OpenPathRequest) => Promise<OpenPathResult>
+
+/** 插件打开器接管成功时返回给调用方（chat 只看 ok，产物区读 value）。 */
+const OPENED_RESULT: OpenPathResult = { ok: true, value: { opened: true } }
+
+export interface RemoteOpenRouterOptions {
+  registry: FileOpenerRegistry
+  selected: () => string
+  context: () => FileOpenContext
+  logger?: (message: string) => void
+}
+
+/**
+ * 结构化探测 remote.session 命名空间服务及其 openWorkspacePath 方法。
+ * 旧版 DSH 无该 namespace、或 api-remotes 尚未挂载时返回 undefined。
+ * @author ddj 2026年09月08号
+ * @param ctx 客户端服务上下文
+ * @returns 命名空间服务实例；不可用返回 undefined
+ */
+export function probeRemoteOpen(ctx: { get: (name: string) => unknown }): object | undefined {
+  try {
+    const service = ctx.get('remote.session') as { openWorkspacePath?: unknown } | undefined
+    if (!service || typeof service.openWorkspacePath !== 'function') return undefined
+    return service
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 安装可卸载的 remote.session.openWorkspacePath 路由（0.1.3+ 会话文件链接主路径）。
+ * @author ddj 2026年09月08号
+ * @param service probeRemoteOpen 命中的命名空间服务
+ * @param options 路由依赖
+ * @returns 恢复函数；目标属性缺失时返回 null（调用方停止安装并告警）
+ */
+export function patchRemoteOpen(service: object, options: RemoteOpenRouterOptions): (() => void) | null {
+  return patchAccessor(service, 'openWorkspacePath', async (original, ...args) => {
+    const fallback = original as unknown as RemoteOpen
+    const request = (args[0] ?? {}) as OpenPathRequest
+    const path = typeof request.path === 'string' ? request.path : ''
+    if (!path || path === '.') return fallback(request)
+    const opener = selectOpener(options.registry, options.selected())
+    if (!opener || !isAvailable(opener)) return fallback(request)
+    try {
+      await opener.open(path, options.context())
+      return OPENED_RESULT
+    } catch (error) {
+      options.logger?.('文件打开器 ' + opener.id + ' 失败，回退系统打开: ' + String(error))
+      return fallback(request)
+    }
+  })
+}

package/src/client/styles/editor.css

@@ -58,6 +58,23 @@
 [data-edrv-view] .edrv-minus-item::before { content: ''; position: absolute; left: 4px; top: 50%; width: 8px; height: 2px; transform: translateY(-50%); border-radius: 2px; background: #d9534f; }
 [data-edrv-view] .edrv-monaco-host { flex: 1 1 auto; min-width: 0; min-height: 0; position: relative; overflow: hidden; }
 [data-edrv-view] .edrv-monaco-host > div { position: absolute; inset: 0; min-width: 0; min-height: 0; }
+[data-edrv-view] .edrv-imgview { flex: 1 1 auto; min-width: 0; min-height: 0; display: flex; flex-direction: column; overflow: hidden; }
+[data-edrv-view] .edrv-imgview-bar { display: flex; align-items: center; gap: 8px; height: 34px; padding: 0 10px; flex-shrink: 0; border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); background: var(--dsw-alias-bg-layer-1, transparent); }
+[data-edrv-view] .edrv-imgview-meta { font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); white-space: nowrap; }
+[data-edrv-view] .edrv-imgview-stage { flex: 1 1 auto; min-height: 0; display: flex; align-items: center; justify-content: center; overflow: auto; padding: 14px; background-color: var(--dsw-alias-bg-layer-1, #f0f4f4); background-image: conic-gradient(rgba(128,128,128,.14) 25%, transparent 0 50%, rgba(128,128,128,.14) 0 75%, transparent 0); background-size: 16px 16px; }
+[data-edrv-view] .edrv-imgview-img { max-width: 100%; max-height: 100%; object-fit: contain; border-radius: 4px; box-shadow: 0 2px 12px rgba(31,41,51,.18); }
+[data-edrv-view] .edrv-imgview-broken { display: flex; flex-direction: column; align-items: center; gap: 10px; font-size: 13px; color: var(--dsw-alias-label-tertiary, #777); }
+[data-edrv-view] .edrv-pdf-host { flex: 1 1 auto; min-width: 0; min-height: 0; position: relative; overflow: hidden; }
+[data-edrv-view] .edrv-pdf-host > .edrv-pdf { position: absolute; inset: 0; }
+[data-edrv-view] .edrv-pdf { min-width: 0; min-height: 0; display: flex; flex-direction: column; overflow: hidden; }
+[data-edrv-view] .edrv-pdf-bar { display: flex; align-items: center; gap: 8px; height: 34px; padding: 0 10px; flex-shrink: 0; border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); background: var(--dsw-alias-bg-layer-1, transparent); }
+[data-edrv-view] .edrv-pdf-page { font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); white-space: nowrap; min-width: 52px; text-align: center; }
+[data-edrv-view] .edrv-pdf-zoom { min-width: 26px; text-align: center; padding: 3px 7px; }
+[data-edrv-view] .edrv-pdf-sep { width: 1px; height: 16px; background: var(--dsw-alias-border-l1, #e0e6e8); margin: 0 2px; }
+[data-edrv-view] .edrv-pdf-mode-on { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.12)); color: var(--dsw-alias-brand-primary, #0f9d58); border-color: var(--dsw-alias-brand-primary, #0f9d58); }
+[data-edrv-view] .edrv-pdf-dirty { color: var(--dsw-alias-state-warn-primary, #d97706); border-color: var(--dsw-alias-state-warn-primary, #d97706); }
+[data-edrv-view] .edrv-pdf-stage { position: absolute; top: 34px; left: 0; right: 0; bottom: 0; overflow: auto; }
+[data-edrv-view] .edrv-pdf-stage .edrv-pdf-viewer { margin: 0 auto; }
 [data-edrv-view] .edrv-empty { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 10px; height: 100%; color: var(--dsw-alias-label-tertiary, #777); font-size: 13px; }
 [data-edrv-view] .edrv-diffbar { position: absolute; left: 0; right: 0; bottom: 10px; margin: 0 auto; z-index: 25; width: fit-content; max-width: calc(100% - 20px); border-radius: 12px; background: var(--dsw-specific-tip, var(--dsw-alias-bg-layer-2, #f0f4f4)); border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); box-shadow: none; overflow: visible; display: flex; flex-direction: column; }
 [data-edrv-view] .edrv-editor-area > .edrv-diffbar { max-height: calc(100% - 20px); }