dsh-vscode-mode 0.1.53 → 0.1.55

package/src/client/ui/EditorView.ts

@@ -9,6 +9,9 @@ import React from 'react'
 import { dbg, rpc } from '../rpc.js'
 import { emitRefresh } from '../events.js'
 import { langOf, loadMonaco } from '../monaco/loader.js'
+import { dataUrlOf, isImagePath, isSvgPath } from '../imagePreview.js'
+import { base64ToBytes, isPdfPath } from '../pdfPreview.js'
+import { createPdfPanel } from '../pdf/pdfPanel.js'
 import { applyTheme, registerThemes, themeNameOf } from '../monaco/theme.js'
 import { createDiffRenderer } from '../monaco/diffRender.js'
 import { ST, callIdAttr, noopHunk, summarize } from '../state/records.js'
@@ -53,6 +56,14 @@ export function EditorView(props) {
   const [dirtyMap, setDirtyMap] = React.useState({})
   const [content, setContent] = React.useState(null)
   const [contentPath, setContentPath] = React.useState(null)
+  const [imageSrc, setImageSrc] = React.useState(null) // 图片预览 data URL（图片 tab 专用，文本 tab 恒为 null）
+  const [imgSize, setImgSize] = React.useState(null) // 图片自然尺寸 { w, h }（路径栏 meta）
+  const [imgBroken, setImgBroken] = React.useState(false) // 图片解码失败（onError），显示占位与重试
+  const svgTextRef = React.useRef(new Set()) // 强制以文本打开的 SVG 路径集合（toggleSvgText 维护）
+  const [pdfBytes, setPdfBytes] = React.useState(null) // 当前 PDF tab 的原始字节（null=加载中/非 PDF）
+  const pdfB64CacheRef = React.useRef(new Map()) // path → base64（tab 切回免重读；FIFO 上限防内存膨胀）
+  const pdfCtlRef = React.useRef(new Map()) // path → PDF 面板控制器（mount 产出，关闭/卸载销毁）
+  const pdfHostRef = React.useRef(null) // PDF 面板外壳 div（命令式控制器接管）
   const [status, setStatus] = React.useState('')
   const [lspServers, setLspServers] = React.useState([])
   const [error, setError] = React.useState(null)
@@ -117,6 +128,10 @@ export function EditorView(props) {
   }, [records, active])
 
   const contentReady = content !== null && contentPath === active
+  // 当前 tab 是否处于图片预览模式（与 loadContent 的分派条件同源；SVG 文本模式时为 false）
+  const isImageActive = !!active && isImagePath(active) && !svgTextRef.current.has(active)
+  // 当前 tab 是否为 PDF 面板（与 loadContent 分派条件同源）
+  const isPdfActive = !!active && isPdfPath(active)
   const regions = React.useMemo(() => diffRegions(currentRecords, contentReady ? content : null).filter((r) => !r.superseded), [currentRecords, content, contentPath, active])
   // useMemo 稳定引用：否则 hover 等重渲染会让 view zone effect 反复重建（- 号闪烁）
   const pendingRegions = React.useMemo(() => regions.filter((r) => r.status === ST.PENDING && !r.stale), [regions])
@@ -267,6 +282,10 @@ export function EditorView(props) {
   const closeTab = (path) => {
     flushSave()
     if (path === active) { saveViewState(path); recordNav() }
+    // PDF tab 关闭：销毁面板控制器并清缓存（未保存注释随之丢弃，脏点已提示）
+    const pdfCtl = pdfCtlRef.current.get(path)
+    if (pdfCtl) { pdfCtl.destroy(); pdfCtlRef.current.delete(path) }
+    pdfB64CacheRef.current.delete(path)
     setTabs((prev) => {
       const idx = prev.findIndex((t) => t.path === path)
       if (idx < 0) return prev
@@ -318,6 +337,16 @@ export function EditorView(props) {
    */
   const loadContent = (path, sid, force) => {
     const seq = ++loadSeqRef.current
+    // 图片文件走专用通道：base64 → data URL 预览，不建 Monaco model、不进文本/差异流程
+    if (isImagePath(path) && !svgTextRef.current.has(path)) {
+      loadImage(path, sid, seq)
+      return
+    }
+    // PDF 文件走专用通道：base64 → PDF 面板（浏览 + 注释编辑），不建 Monaco model
+    if (isPdfPath(path)) {
+      loadPdf(path, sid, seq, force === true)
+      return
+    }
     const cachedModel = force ? null : modelsRef.current.get(path)
     if (cachedModel) {
       // model 命中：直接显示其内容（切 tab 零等待），后台静默校验
@@ -361,6 +390,94 @@ export function EditorView(props) {
     })
   }
 
+  /**
+   * 加载图片文件为 data URL（编辑区只读预览）；失败走 loadError 面板（重试经 loadContent 分派回此）。
+   * @author ddj 2026年09月08号
+   * @param path 图片文件路径
+   * @param sid 会话 id
+   * @param seq 加载序号（过期响应丢弃）
+   */
+  const loadImage = (path, sid, seq) => {
+    setImageSrc(null)
+    setImgSize(null)
+    setImgBroken(false)
+    setLoadStage({ progress: monaco ? 72 : 12, message: '读取图片…' })
+    rpc('edrv.read', { sessionId: sid, path, encoding: 'base64' }).then((res) => {
+      if (seq !== loadSeqRef.current || path !== active) return
+      if (res && res.ok && res.encoding === 'base64') {
+        if (!res.mime) {
+          setLoadError('host 版本过旧：图片响应缺少 mime')
+          setError('host 版本过旧：图片响应缺少 mime')
+          setStatus('读取失败')
+          return
+        }
+        setImageSrc(dataUrlOf(res.content, res.mime))
+        setLoadStage({ progress: 100, message: '图片已就绪' })
+        setStatus('已加载')
+        return
+      }
+      const base = res?.error ? String(res.error) : '读取失败'
+      // 带出 host 解析后的真实路径：跳转失败时一眼看出是路径解析错还是目标不存在
+      const message = res?.resolvedPath ? base + '：' + String(res.resolvedPath) : base
+      setLoadError(message)
+      setError(message)
+      setStatus('读取失败')
+    }).catch((e) => {
+      if (seq !== loadSeqRef.current) return
+      const message = 'read异常:' + String(e)
+      setLoadError(message)
+      setError(message)
+      setStatus('读取失败')
+    })
+  }
+
+  /**
+   * 加载 PDF 文件为原始字节（编辑区 PDF 面板）；命中 base64 缓存秒切，force 绕过缓存重读。
+   * 面板控制器由 pdf host mount effect 产出（per-path，关闭/卸载销毁）。
+   * @author ddj 2026年09月22号
+   * @param path PDF 文件路径
+   * @param sid 会话 id
+   * @param seq 加载序号（过期响应丢弃）
+   * @param force true=绕过缓存强制 RPC 重读（刷新按钮）
+   */
+  const loadPdf = (path, sid, seq, force) => {
+    setPdfBytes(null)
+    setLoadStage({ progress: monaco ? 72 : 12, message: '读取 PDF…' })
+    const cache = pdfB64CacheRef.current
+    const hit = !force ? cache.get(path) : undefined
+    if (typeof hit === 'string' && hit) {
+      // 刷新插入序（Map 按插入序 FIFO 驱逐）后秒切
+      cache.delete(path)
+      cache.set(path, hit)
+      setPdfBytes(base64ToBytes(hit))
+      setLoadStage({ progress: 100, message: 'PDF 已就绪' })
+      setStatus('已加载')
+      return
+    }
+    rpc('edrv.read', { sessionId: sid, path, encoding: 'base64' }).then((res) => {
+      if (seq !== loadSeqRef.current || path !== active) return
+      if (res && res.ok && res.encoding === 'base64') {
+        cache.set(path, res.content)
+        while (cache.size > 6) cache.delete(cache.keys().next().value)
+        setPdfBytes(base64ToBytes(res.content))
+        setLoadStage({ progress: 100, message: 'PDF 已就绪' })
+        setStatus('已加载')
+        return
+      }
+      const base = res?.error ? String(res.error) : '读取失败'
+      const message = res?.resolvedPath ? base + '：' + String(res.resolvedPath) : base
+      setLoadError(message)
+      setError(message)
+      setStatus('读取失败')
+    }).catch((e) => {
+      if (seq !== loadSeqRef.current) return
+      const message = 'read异常:' + String(e)
+      setLoadError(message)
+      setError(message)
+      setStatus('读取失败')
+    })
+  }
+
   // 挂载轮询 + 事件订阅
   React.useEffect(() => {
     if (!sessionId) return
@@ -633,6 +750,10 @@ export function EditorView(props) {
     if (!active) return
     setContent(null)
     setContentPath(null)
+    setImageSrc(null)
+    setImgSize(null)
+    setImgBroken(false)
+    setPdfBytes(null)
     setLoadError(null)
     setLoadStage({ progress: 10, message: '准备读取文件…' })
     setStatus('加载中…')
@@ -701,8 +822,18 @@ export function EditorView(props) {
   }
 
   const doSave = (silent) => {
+    if (!active) return
+    // PDF tab：保存委托给面板控制器（saveDocument → base64 → edrv.saveBinary）
+    if (isPdfPath(active)) {
+      const ctl = pdfCtlRef.current.get(active)
+      if (!ctl) { if (!silent) setStatus('PDF 未就绪'); return }
+      if (!ctl.isDirty()) { if (!silent) setStatus('PDF 无未保存修改'); return }
+      void ctl.savePdf()
+      return
+    }
     const ed = editorRef.current
-    if (!active || !ed) return
+    if (!ed) return
+    if (isImageActive) { setStatus('图片只读预览'); return }
     const text = ed.getValue()
     if (!silent) setStatus('保存中…')
     rpc('edrv.save', { sessionId, path: active, content: text }).then((res) => {
@@ -737,6 +868,30 @@ export function EditorView(props) {
     setLoadStage((prev) => ({ progress: Math.max(96, prev.progress), message: '创建编辑器视图…' }))
   }, [monaco, active, content])
 
+  // PDF 面板外壳 ref 回调（div 仅在 PDF 分支渲染，refs 先于 effect 就绪）
+  const ensurePdfHost = (node) => { pdfHostRef.current = node }
+
+  // PDF 面板装配：控制器挂进外壳 div，切换 tab/卸载即销毁（重开重挂，base64 缓存兜底秒切）
+  React.useEffect(() => {
+    const host = pdfHostRef.current
+    if (!isPdfActive || !pdfBytes || !host) return
+    const path = active
+    const ctl = createPdfPanel({
+      sessionId,
+      path,
+      setStatus,
+      setError,
+      onDirtyChange: (d) => setDirtyMap((prev) => Object.assign({}, prev, { [path]: d })),
+      onReload: () => loadContent(path, sessionId, true),
+    })
+    pdfCtlRef.current.set(path, ctl)
+    void ctl.mount(host, pdfBytes)
+    return () => {
+      ctl.destroy()
+      if (pdfCtlRef.current.get(path) === ctl) pdfCtlRef.current.delete(path)
+    }
+  }, [isPdfActive, pdfBytes, active])
+
   // 行内差异自绘（decorations / view zones / minus overlay）→ diffRenderer
   React.useEffect(() => {
     if (!monaco || !editorRef.current || !active || content === null) return
@@ -752,6 +907,8 @@ export function EditorView(props) {
     if (editorRef.current) { editorRef.current.dispose(); editorRef.current = null }
     for (const m of modelsRef.current.values()) m.dispose()
     modelsRef.current.clear()
+    for (const ctl of pdfCtlRef.current.values()) ctl.destroy()
+    pdfCtlRef.current.clear()
     const root = editorRef.current && editorRef.current.getDomNode ? editorRef.current.getDomNode() : null
     if (root) {
       const ov = root.querySelector('.edrv-minus-overlay')
@@ -975,6 +1132,53 @@ export function EditorView(props) {
     refreshRecords(skipStale === true)
   }
 
+  /**
+   * SVG 在图片预览与文本编辑间切换（按路径记忆；重载分派随集合状态自动路由）。
+   * @author ddj 2026年09月08号
+   * @param path SVG 文件路径
+   */
+  const toggleSvgText = (path) => {
+    const next = new Set(svgTextRef.current)
+    if (next.has(path)) next.delete(path)
+    else next.add(path)
+    svgTextRef.current = next
+    setContent(null)
+    setContentPath(null)
+    setImageSrc(null)
+    setImgSize(null)
+    setImgBroken(false)
+    setLoadError(null)
+    setStatus(next.has(path) ? '已切换为文本模式' : '已切换为图片预览')
+    loadContent(path, sessionId, true)
+  }
+
+  /**
+   * 图片预览面板：工具条（尺寸 meta / SVG 文本切换 / 刷新）+ 棋盘底自适应图片。
+   * @author ddj 2026年09月08号
+   */
+  const imagePanel = () => React.createElement('div', { className: 'edrv-imgview' },
+    React.createElement('div', { className: 'edrv-imgview-bar' },
+      React.createElement('span', { className: 'edrv-imgview-meta' },
+        imgBroken ? '图片无法显示' : (imgSize ? imgSize.w + '×' + imgSize.h : '…')),
+      React.createElement('span', { style: { flex: 1 } }),
+      (isSvgPath(active) ? React.createElement('button', {
+        className: 'edrv-pill edrv-pill-ghost', title: '以文本方式查看/编辑（SVG 为文本格式）',
+        onClick: () => toggleSvgText(active),
+      }, '以文本打开') : null),
+      React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', title: '重新加载图片', onClick: () => reloadFile() }, '⟳ 刷新')),
+    React.createElement('div', { className: 'edrv-imgview-stage' },
+      (imgBroken
+        ? React.createElement('div', { className: 'edrv-imgview-broken' },
+            React.createElement('div', null, '图片解码失败，文件可能已损坏'),
+            React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: () => reloadFile() }, '重试'))
+        : React.createElement('img', {
+            className: 'edrv-imgview-img',
+            src: imageSrc,
+            alt: active || '',
+            onLoad: (e) => { setImgBroken(false); setImgSize({ w: e.target.naturalWidth, h: e.target.naturalHeight }) },
+            onError: () => setImgBroken(true),
+          }))))
+
   /**
    * 关闭当前差异浮窗并清理 hover 锚点。
    * @author ddj 2026年08月21号
@@ -1183,6 +1387,12 @@ export function EditorView(props) {
   const openPath = () => {
     const p = (pathDraft || '').trim()
     if (!p) return
+    // 图片/PDF 文件跳过文本读探测（二进制会被 host 拒绝），直接进 tab 由专用预览接管
+    if (isImagePath(p) || isPdfPath(p)) {
+      openFile(p, false)
+      setOpenInput(false); setPathDraft(''); setStatus('已打开'); setError(null)
+      return
+    }
     setStatus('打开中…')
     rpc('edrv.read', { sessionId, path: p }).then((res) => {
       if (res && res.ok) {
@@ -1214,7 +1424,8 @@ export function EditorView(props) {
   const pathBar = React.createElement('div', { className: 'edrv-pathbar', title: active || '' },
     React.createElement('span', { className: 'edrv-pb-name' }, active ? String(active).split(/[\\/]/).pop() : '未打开文件'),
     React.createElement('span', { className: 'edrv-pb-full' }, active || '使用右上搜索框 (' + (chordOf('edrv.quickOpen') ?? 'Ctrl+P') + ') 打开文件'),
-    (active && langOf(active) ? React.createElement('span', { className: 'edrv-pb-meta' }, langOf(active)) : null),
+    (active && !isImageActive && langOf(active) ? React.createElement('span', { className: 'edrv-pb-meta' }, langOf(active)) : null),
+    (isImageActive && imgSize ? React.createElement('span', { className: 'edrv-pb-meta' }, imgSize.w + '×' + imgSize.h) : null),
     (cursor ? React.createElement('span', { className: 'edrv-pb-meta' }, cursor) : null),
     (status ? React.createElement('span', { className: 'edrv-pb-meta edrv-pb-status' }, status) : null))
 
@@ -1304,6 +1515,14 @@ export function EditorView(props) {
       setLoadStage({ progress: 10, message: '重新读取文件…' })
       loadContent(active, sessionId)
     })
+  } else if (isImageActive && imageSrc) {
+    body = imagePanel()
+  } else if (isImageActive) {
+    body = loadingBody(loadStage.message || '读取图片…', loadStage.progress)
+  } else if (isPdfActive && pdfBytes) {
+    body = React.createElement('div', { className: 'edrv-pdf-host', ref: ensurePdfHost, key: active })
+  } else if (isPdfActive) {
+    body = loadingBody(loadStage.message || '读取 PDF…', loadStage.progress)
   } else if (content === null) {
     body = loadingBody(loadStage.message || '读取文件内容…', loadStage.progress)
   } else {

package/src/compat.ts

@@ -129,7 +129,7 @@ export function detectGuards(ctx: Ctx): CompatAdapter[] {
 }
 
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = '0.1.2-alpha.4'
+const TESTED_DSH_MAX = '0.1.3-alpha.2'
 
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 export function versionAdapters(dshVersion: string): CompatAdapter[] {

package/src/dshVersion.ts

@@ -86,6 +86,7 @@ export function inDshRange(version: DshVersion | null | undefined, range: DshRan
 export function familyLabel(input: string): string {
   const version = parseDshVersion(input)
   if (!version) return '未知'
+  if (inDshRange(version, { from: '0.1.3-alpha.1' })) return '0.1.3-alpha 及更新（对话文件链接=remote.session.openWorkspacePath）'
   if (inDshRange(version, { from: '0.1.2-alpha.1' })) return '0.1.2-alpha 及更新（设置 API=settings.installSection）'
   return '0.1.0/0.1.1 rc 线（设置 API=installSettingsSection）'
 }

package/src/routes.ts

@@ -19,6 +19,7 @@ const IMG_ROUTES = [
 /** Monaco AMD 构建静态资源（随包发布，离线可用；前缀路由 /edrv/vendor/*）。 */
 const VENDOR_MIME: Record<string, string> = {
   '.js': 'text/javascript; charset=utf-8',
+  '.mjs': 'text/javascript; charset=utf-8',
   '.css': 'text/css; charset=utf-8',
   '.json': 'application/json',
   '.map': 'application/json',
@@ -32,6 +33,8 @@ const VENDOR_MIME: Record<string, string> = {
   '.ttf': 'font/ttf',
   '.html': 'text/html; charset=utf-8',
   '.md': 'text/markdown',
+  '.bcmap': 'application/octet-stream',
+  '.pfb': 'application/octet-stream',
 }
 
 /** 图标目录（paths.ts 统一解析：config.imageDir 覆盖优先，否则插件包 assets/）。 */

package/src/rpc.ts

@@ -5,9 +5,11 @@
  * 作者 ddj 2026-08-20
  */
 import type { DecideItem, DecideResult, RpcHandlerMap, RpcMethod, RpcRequestMap, RpcResult, RpcScope } from './shared/rpc.js'
+import { binaryMimeOf } from './shared/rpc.js'
 import type { DiffRecord, RecordView } from './shared/types.js'
 import type { Ctx, Session } from './store.js'
 import {
+  BINARY_READ_CAP,
   READ_CAP,
   appendArchiveEntries,
   archiveRecords,
@@ -152,6 +154,36 @@ async function requireSession(ctx: Ctx, sessionId: string | undefined): Promise<
   return { session, cwd }
 }
 
+/**
+ * 手动保存收尾（edrv.save / edrv.saveBinary 共用）：目录树失效 + 该路径 pending
+ * 文本差异记录标记 superseded 并归档（旧文本 diff 不得再应用到新内容上）。
+ * @author ddj 2026年09月22号
+ * @param ctx DSH 上下文
+ * @param registry 差异记录桶注册表
+ * @param sc requireSession 成功结果（session + cwd）
+ * @param path 保存的文件路径
+ */
+async function afterManualSave(
+  ctx: Ctx,
+  registry: Registry,
+  sc: { session: Session; cwd: string },
+  path: string,
+): Promise<void> {
+  // 手动保存后目录树可能变化（新建/删除文件）：父目录+祖先进失效，后台自愈。
+  invalidateIndex(ctx, sc.cwd, path)
+  const bucket = await bucketOf(registry, ctx, sc.cwd)
+  let changed = false
+  for (const rec of bucket.values()) {
+    if (rec.path === path && rec.superseded !== true) { rec.superseded = true; rec.at = new Date().toISOString(); changed = true }
+  }
+  if (changed) {
+    const done: DiffRecord[] = []
+    for (const rec of bucket.values()) if (rec.path === path && rec.superseded) done.push(rec)
+    if (done.length) await archiveRecords(ctx, sc.session, sc.cwd, bucket, done, '被手动编辑覆盖')
+    else await saveBucket(ctx, sc.cwd, bucket, sc.session)
+  }
+}
+
 /**
  * 批量决策核心：一次会话/桶解析 + 逐项处理 + 统一落盘（accept/reject 单条与 decideBatch 共用）。
  * rejected 项先做回滚，失败记入该项 error 且不改决策；本批次新增"已解决"记录一次性归档，
@@ -302,6 +334,13 @@ export function buildHandlers(
           // 带上解析后的真实路径：跳转失败时可直接看出是路径解析错还是目标本身不存在
           return { ok: false, error: '文件不存在', resolvedPath: fs.processPath(target) }
         }
+        if ((info.size ?? 0) > BINARY_READ_CAP) return { ok: false, error: '文件过大（>32MB），不支持整文件预览' }
+        if (args.encoding === 'base64') {
+          // 图片/PDF 等二进制预览：readBytes 无解码、无二进制拒绝；超上限已由上方 stat 拦截
+          const bytes = await fs.readBytes(target, undefined, BINARY_READ_CAP)
+          const content = Buffer.from(bytes).toString('base64')
+          return { ok: true, content, size: bytes.byteLength, encoding: 'base64', mime: binaryMimeOf(args.path) }
+        }
         if ((info.size ?? 0) > READ_CAP) return { ok: false, error: '文件过大（>8MB），不支持整文件预览' }
         const content = await fs.readText(target)
         return { ok: true, content, size: content.length }
@@ -342,24 +381,37 @@ export function buildHandlers(
       try {
         const target = await resolveTarget(ctx, sc.session, args.path)
         await fs.writeText(target, args.content, void 0, void 0, policyOf(ctx, sc.session))
-        // 手动保存后目录树可能变化（新建/删除文件）：父目录+祖先进失效，后台自愈。
-        invalidateIndex(ctx, sc.cwd, args.path)
-        const bucket = await bucketOf(registry, ctx, sc.cwd)
-        let changed = false
-        for (const rec of bucket.values()) {
-          if (rec.path === args.path && rec.superseded !== true) { rec.superseded = true; rec.at = new Date().toISOString(); changed = true }
-        }
-        if (changed) {
-          const done: DiffRecord[] = []
-          for (const rec of bucket.values()) if (rec.path === args.path && rec.superseded) done.push(rec)
-          if (done.length) await archiveRecords(ctx, sc.session, sc.cwd, bucket, done, '被手动编辑覆盖')
-          else await saveBucket(ctx, sc.cwd, bucket, sc.session)
-        }
+        await afterManualSave(ctx, registry, sc, args.path)
         return { ok: true }
       } catch (error) {
         return { ok: false, error: '保存失败：' + String(error) }
       }
     },
+    'edrv.saveBinary': async (args) => {
+      if (args.encoding !== 'base64') return { ok: false, error: '仅支持 base64 编码' }
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const fs = ctx.get('fs')
+      if (!fs) return { ok: false, error: '缺少 fs' }
+      try {
+        const target = await resolveTarget(ctx, sc.session, args.path)
+        const info = await fs.stat(target)
+        if (!info || info.type !== 'file') return { ok: false, error: '文件不存在' }
+        // fs 服务仅提供文本写（writeText/editText），二进制回写经 node:fs 直写解析后的
+        // 真实路径；以工作区边界 + 大小上限 + 用户显式保存动作三重约束兜底（对齐
+        // revert.ts deleteCreated 的 contains 用法）。
+        const rootTarget = await fs.resolve(policyOf(ctx, sc.session)?.workspaceRoot ?? '.', {})
+        if (!fs.contains(rootTarget, target)) return { ok: false, error: '拒绝保存：目标不在会话工作区内' }
+        const bytes = Buffer.from(args.content, 'base64')
+        if (bytes.byteLength === 0) return { ok: false, error: '内容为空，拒绝写回' }
+        if (bytes.byteLength > BINARY_READ_CAP) return { ok: false, error: '内容过大（>32MB），拒绝写回' }
+        await writeFile(fs.processPath(target), bytes)
+        await afterManualSave(ctx, registry, sc, args.path)
+        return { ok: true }
+      } catch (error) {
+        return { ok: false, error: '二进制保存失败：' + String(error) }
+      }
+    },
     'edrv.archiveList': async (args) => {
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }

package/src/shared/rpc.ts

@@ -21,6 +21,52 @@ import type { LspEnvInstallState, LspExtInfo, LspExtUpdate, LspHover, LspLocatio
 /** webServer 精确路由。 */
 export const RPC_PATH = '/edrv/rpc'
 
+/**
+ * 图片扩展名（小写、无点）→ MIME。edrv.read base64 响应与 client 图片预览共用，
+ * 收敛在此避免 host/client 两处漂移。
+ * @author ddj 2026年09月08号
+ */
+export const IMAGE_MIME: Record<string, string> = {
+  png: 'image/png',
+  jpg: 'image/jpeg',
+  jpeg: 'image/jpeg',
+  gif: 'image/gif',
+  webp: 'image/webp',
+  bmp: 'image/bmp',
+  ico: 'image/x-icon',
+  avif: 'image/avif',
+  svg: 'image/svg+xml',
+}
+
+/**
+ * 路径 → 图片 MIME：按 basename 扩展名小写查 {@link IMAGE_MIME}，未命中回退 application/octet-stream。
+ * @author ddj 2026年09月08号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns MIME 字符串
+ */
+export function imageMimeOf(path: string): string {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  const ext = dot > 0 ? base.slice(dot + 1).toLowerCase() : ''
+  return IMAGE_MIME[ext] ?? 'application/octet-stream'
+}
+
+/** PDF 统一 MIME（host base64 响应与 client PDF 面板同源，避免两处漂移）。 */
+export const PDF_MIME = 'application/pdf'
+
+/**
+ * 路径 → 二进制预览 MIME：PDF 特判 {@link PDF_MIME}，其余走图片表回退 octet-stream。
+ * @author ddj 2026年09月22号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns MIME 字符串
+ */
+export function binaryMimeOf(path: string): string {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  if (dot > 0 && base.slice(dot + 1).toLowerCase() === 'pdf') return PDF_MIME
+  return imageMimeOf(path)
+}
+
 /** 决策作用域：call=整条记录，hunk=单个差异块。 */
 export type RpcScope = 'call' | 'hunk'
 
@@ -111,9 +157,10 @@ export interface RpcRequestMap {
   'edrv.accept': { sessionId?: string; callId: string; scope?: RpcScope; hunkIndex?: number }
   'edrv.reject': { sessionId?: string; callId: string; scope?: RpcScope; hunkIndex?: number }
   'edrv.decideBatch': { sessionId?: string; items: DecideItem[] }
-  'edrv.read': { sessionId?: string; path: string }
+  'edrv.read': { sessionId?: string; path: string; encoding?: 'base64' }
   'edrv.original': { sessionId?: string; path: string }
   'edrv.save': { sessionId?: string; path: string; content: string }
+  'edrv.saveBinary': { sessionId?: string; path: string; content: string; encoding: 'base64' }
   'edrv.archiveList': { sessionId?: string }
   'edrv.archiveRead': { sessionId?: string; path?: string }
   'edrv.rollback': { sessionId?: string; path: string; batch?: number }
@@ -194,9 +241,10 @@ export interface RpcOkMap {
   'edrv.accept': { record: RecordView }
   'edrv.reject': { record: RecordView }
   'edrv.decideBatch': { results: DecideResult[] }
-  'edrv.read': { content: string; size: number }
+  'edrv.read': { content: string; size: number; encoding?: 'base64'; mime?: string }
   'edrv.original': { content: string; size: number; stale: StaleHunk[]; fallback: boolean }
   'edrv.save': object
+  'edrv.saveBinary': object
   'edrv.archiveList': { entries: ArchiveEntry[] }
   'edrv.archiveRead': { batches: ArchiveBatch[] }
   'edrv.rollback': { path: string; batch: number | null }

package/src/store.ts

@@ -11,6 +11,8 @@ import { SIDECAR, SIDECAR_ARCHIVE } from './paths.js'
 
 export { SIDECAR, SIDECAR_ARCHIVE }
 export const READ_CAP = 8 * 1024 * 1024
+/** 二进制预览/写回上限（PDF 等整文件 base64 传输；文本侧仍用 READ_CAP）。 */
+export const BINARY_READ_CAP = 32 * 1024 * 1024
 
 /** DSH 上下文与会话类型较宽松：本地无 dsh 类型声明，显式 any + 文档约束。 */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any