@lyhue1991/dsh-soup 0.2.0 → 0.4.0

package/lib/client.js

@@ -53,8 +53,9 @@ window.__ModuleLoader__.load({
       '.expl-head{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:12px 14px;border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;}' +
       '.expl-title{font-weight:600;color:var(--dsw-alias-label-primary);white-space:nowrap;font-size:14px;}' +
       '.expl-head-btns{display:flex;gap:2px;flex-wrap:nowrap;}' +
-      '.expl-btn{background:transparent;border:none;color:var(--dsw-alias-label-secondary);font-size:15px;cursor:pointer;padding:3px 7px;border-radius:8px;}' +
+      '.expl-btn{width:26px;height:26px;display:flex;align-items:center;justify-content:center;background:transparent;border:none;color:var(--dsw-alias-label-secondary);font-size:15px;cursor:pointer;padding:0;border-radius:8px;flex:none;}' +
       '.expl-btn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary);}' +
+      '.expl-btn svg{width:16px;height:16px;display:block;}' +
       '.expl-path{font-size:11px;color:var(--dsw-alias-label-secondary);padding:7px 14px;border-bottom:1px solid var(--dsw-alias-border-l1);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;direction:rtl;text-align:left;flex:none;cursor:default;}' +
       '.expl-error{color:var(--dsw-alias-state-error-primary);padding:6px 14px;font-size:12px;border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;}' +
       '.expl-notice{color:var(--dsw-alias-state-success-primary);padding:6px 14px;font-size:12px;border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;}' +
@@ -78,7 +79,8 @@ window.__ModuleLoader__.load({
       '.expl-muted{color:var(--dsw-alias-label-tertiary);padding:4px 14px;font-size:12px;}' +
       '.expl-menu-mask{position:fixed;inset:0;z-index:1980;}' +
       '.expl-menu{position:fixed;z-index:1990;min-width:172px;background:var(--dsw-specific-menu);border:1px solid var(--dsw-alias-border-inverted);border-radius:12px;padding:4px;box-shadow:var(--dsw-shadow-lv3);pointer-events:auto;}' +
-      '.expl-menu-item{display:block;width:100%;text-align:left;background:transparent;border:none;color:var(--dsw-alias-label-primary);font-size:13px;padding:6px 10px;border-radius:8px;cursor:pointer;line-height:1.4;}' +
+      '.expl-menu-item{display:flex;align-items:center;gap:7px;width:100%;text-align:left;background:transparent;border:none;color:var(--dsw-alias-label-primary);font-size:13px;padding:6px 10px;border-radius:8px;cursor:pointer;line-height:1.4;}' +
+      '.expl-menu-ico{flex:none;display:inline-flex;align-items:center;}.expl-menu-ico svg{width:14px;height:14px;display:block;}' +
       '.expl-menu-item:hover{background:var(--dsw-alias-interactive-bg-hover);}' +
       '.expl-danger{color:var(--dsw-alias-state-error-primary);} .expl-menu-item.expl-danger:hover{background:var(--dsw-alias-interactive-bg-hover-danger);}' +
       '.expl-menu-sep{height:1px;margin:4px 6px;background:var(--dsw-alias-border-l1);}' +
@@ -97,6 +99,14 @@ window.__ModuleLoader__.load({
       document.head.appendChild(tag)
     }
 
+    // ------------------------------------------------------------------
+    // 工具栏图标：取自 JupyterLab ui-components（BSD-3-Clause，与文件类型
+    // 图标同源的引用方式），fill 改为 currentColor 以跟随 DSH 主题 token。
+    // 注意：只引入刷新图标——ICON_CLOSE / ICON_UPLOAD 与 GoalBar 段的
+    // 同名 React 元素常量冲突（var 提升覆盖），字符样式反而更稳。
+    // ------------------------------------------------------------------
+    var ICON_REFRESH = '<svg xmlns="http://www.w3.org/2000/svg" width="16" viewBox="0 0 18 18"><path fill="currentColor" d="M9 13.5c-2.49 0-4.5-2.01-4.5-4.5S6.51 4.5 9 4.5c1.24 0 2.36.52 3.17 1.33L10 8h5V3l-1.76 1.76A6 6 0 0 0 9 3C5.69 3 3.01 5.69 3.01 9S5.69 15 9 15a5.98 5.98 0 0 0 5.9-5h-1.52c-.46 2-2.24 3.5-4.38 3.5"/></svg>'
+
     // GoalBar 多行版：沿用 DSH 原生 GoalBar 的结构和主题，仅放开单行截断。
     // 布局分两行：head 行（图标 + 相位标签 + 操作按钮），body 行（objective 多行）。
     var GOAL_CSS =
@@ -137,8 +147,9 @@ window.__ModuleLoader__.load({
       '.dfv-body{flex:1;min-height:0;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);}' +
       '.dfv-toolbar{display:flex;align-items:center;gap:8px;flex:none;padding:6px 12px;border-bottom:1px solid var(--dsw-alias-border-l1);font-size:11px;color:var(--dsw-alias-label-secondary);}' +
       '.dfv-toolbar-path{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;direction:rtl;text-align:left;font-family:var(--ds-font-family-code);}' +
-      '.dfv-btn{flex:none;background:transparent;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);font-size:11px;line-height:1;padding:4px 9px;border-radius:7px;cursor:pointer;}' +
+      '.dfv-btn{flex:none;display:inline-flex;align-items:center;gap:5px;height:26px;box-sizing:border-box;background:transparent;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);font-size:12px;line-height:1;padding:0 10px;border-radius:7px;cursor:pointer;}' +
       '.dfv-btn:hover{background:var(--dsw-alias-interactive-bg-hover);}' +
+      '.dfv-btn svg{width:14px;height:14px;display:block;flex:none;}' +
       '.dfv-error{padding:8px 14px;font-size:12px;color:var(--dsw-alias-state-error-primary);flex:none;}' +
       '.dfv-muted{padding:24px 14px;font-size:13px;color:var(--dsw-alias-label-tertiary);text-align:center;}' +
       '.dfv-cap{padding:5px 14px;font-size:11px;color:var(--dsw-alias-label-caption);border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;}' +
@@ -169,7 +180,13 @@ window.__ModuleLoader__.load({
       '.dfv-table-wrap{flex:1;min-height:0;overflow:auto;}' +
       '.dfv-table{border-collapse:collapse;font-size:12px;font-family:var(--ds-font-family-code);}' +
       '.dfv-th{position:sticky;top:0;z-index:1;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font-weight:600;text-align:left;padding:5px 10px;border-bottom:1px solid var(--dsw-alias-border-l2);border-right:1px solid var(--dsw-alias-border-l1);white-space:nowrap;}' +
-      '.dfv-td{padding:4px 10px;border-bottom:1px solid var(--dsw-alias-border-l1);border-right:1px solid var(--dsw-alias-border-l1);color:var(--dsw-alias-label-primary);white-space:pre-wrap;overflow-wrap:anywhere;max-width:360px;}'
+      '.dfv-td{padding:4px 10px;border-bottom:1px solid var(--dsw-alias-border-l1);border-right:1px solid var(--dsw-alias-border-l1);color:var(--dsw-alias-label-primary);white-space:pre-wrap;overflow-wrap:anywhere;max-width:360px;}' +
+      // 纯阅读模式：预览 tab 激活时隐藏整个输入区（composerSeat：输入框 +
+      // GoalBar + 速度徽标所在的 input.dock）与轮次统计行（StatsLine）。
+      // class 来自 DSH 客户端编译产物（CSS module hash），升级后若失效仅
+      // 表现为「预览页仍显示输入区」，不影响其它功能——属可接受的降级。
+      '[data-dsh-soup-preview="1"] .wSkVaW_composerSeat{display:none !important;}' +
+      '[data-dsh-soup-preview="1"] .FJxK0a_root{display:none !important;}'
     if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css="@lyhue1991/dsh-soup/fileview.css"]') === null) {
       var fileviewTag = document.createElement('style')
       fileviewTag.dataset.plugin = '@lyhue1991/dsh-soup'
@@ -178,8 +195,146 @@ window.__ModuleLoader__.load({
       document.head.appendChild(fileviewTag)
     }
 
-    /** 需要的客户端服务：slots、layout、timer、sessions + remote.goals（goal 动作动词）。 */
-    var inject = ['slots', 'layout', 'timer', 'sessions', 'remote', 'remote.goals']
+    /** 需要的客户端服务：slots、layout、timer、sessions、locale（i18n 词典）+ remote.goals（goal 动作动词）。 */
+    var inject = ['slots', 'layout', 'timer', 'sessions', 'locale', 'remote', 'remote.goals']
+
+    // ------------------------------------------------------------------
+    // i18n：走 DSH 官方插件词典机制（ui-cordis / ui-conversation 同款）——
+    // ctx.locale.register(NS, DICT) 注册；槽位配置加 locale: NS 后组件 props
+    // 获得 t（语言切换铸造新 t 引用，靠浅比较自动重渲染整棵子树）；组件外
+    // 回调（菜单 label、错误横幅）用模块级 T（bind 的 t 每次调用解析当前语言）。
+    // ------------------------------------------------------------------
+    var NS = 'dsh-soup'
+    var DICT = {
+      zh: {
+        'explorer.title': '📁 资源管理器',
+        'explorer.label': '资源管理器',
+        'explorer.refresh': '刷新',
+        'explorer.refreshTitle': '刷新（保持已展开目录）',
+        'explorer.upload': '上传文件',
+        'explorer.close': '关闭',
+        'explorer.closePanel': '关闭资源管理器',
+        'explorer.emptyDir': '（空目录）',
+        'explorer.bulkSelected': '已选 {n} 项 · 拖到文件夹可移动',
+        'explorer.readFail': '读取失败',
+        'explorer.actionFail': '失败',
+        'explorer.uploading': '上传中 ',
+        'explorer.downloading': '下载中 ',
+        'explorer.uploaded': '已上传 {n} 个文件',
+        'explorer.filesCount': '{n} 个文件',
+        'explorer.filesCountPartial': '{ok}/{total} 个文件',
+        'explorer.downloaded': '已下载 {n} 个文件',
+        'explorer.uploadFail': '上传失败',
+        'explorer.downloadFail': '下载失败',
+        'explorer.downloadFailWith': '下载失败: {reason}',
+        'explorer.downloadStart': '已开始下载 {name}（大文件，由浏览器接管）',
+        'explorer.renamed': '已复制路径',
+        'explorer.renameFail': '重命名失败',
+        'explorer.createFail': '创建失败',
+        'explorer.moveIntoSelf': '不能把文件夹移入自身: {path}',
+        'explorer.hostUnreachable': '宿主不可达: {reason}',
+        'explorer.hostBadResponse': '宿主响应解析失败',
+        'menu.preview': '👁 预览',
+        'menu.open': '🖥 用系统打开',
+        'menu.rename': '✎ 重命名',
+        'menu.trash': '🗑 移到废纸篓',
+        'menu.trashMulti': '🗑 移到废纸篓 ({n} 项)',
+        'menu.newFile': '📄 新建文件',
+        'menu.newFolder': '📁 新建文件夹',
+        'menu.copyPath': '⧉ 复制路径',
+        'menu.download': '⬇ 下载',
+        'menu.deselect': '取消选择',
+        'files.tab': '预览',
+        'files.emptyHint': '在右侧资源管理器中双击或右键「预览」文件',
+        'files.loading': '加载中…',
+        'files.readFail': '读取文件失败',
+        'files.reload': '重载',
+        'files.reloadTitle': '从磁盘重新读取（刷新预览）',
+        'files.binary': '二进制文件（{size}），请在资源管理器中用系统打开',
+        'files.imageTooLarge': '图片过大（{size}，上限 {limit}）',
+        'files.pdfTooLarge': 'PDF 过大（{size}，上限 {limit}），请用系统打开',
+        'files.truncated': '文件超过 2 MB，仅预览前 2 MB；完整内容请用系统编辑器打开。',
+        'files.jsonFail': 'JSON 解析失败，按纯文本显示',
+        'files.nbFail': 'ipynb 解析失败，按纯文本显示',
+        'files.nbEmpty': '（空笔记本）',
+        'files.nbCells': '共 {n} 个单元格',
+        'files.csvTruncated': '共 {total} 行，仅预览前 {n} 行',
+        'files.htmlFrame': 'HTML 预览',
+        'files.pdfFrame': 'PDF 预览',
+        'files.pdfLoading': 'PDF 加载中…',
+        'files.pdfFail': 'PDF 预览失败: {reason}',
+        'files.pdfUnsupported': '当前浏览器无法内嵌预览 PDF，请右键用系统打开。',
+        'files.nbHtmlOut': 'HTML 输出',
+        'speed.label': '速度徽标',
+        'speed.waiting': '正在等待模型',
+        'speed.operateFail': '操作失败',
+      },
+      en: {
+        'explorer.title': '📁 Explorer',
+        'explorer.label': 'Explorer',
+        'explorer.refresh': 'Refresh',
+        'explorer.refreshTitle': 'Refresh (keeps expanded folders)',
+        'explorer.upload': 'Upload files',
+        'explorer.close': 'Close',
+        'explorer.closePanel': 'Close explorer',
+        'explorer.emptyDir': '(empty)',
+        'explorer.bulkSelected': '{n} selected · drag onto a folder to move',
+        'explorer.readFail': 'Failed to read',
+        'explorer.actionFail': 'Failed',
+        'explorer.uploading': 'Uploading ',
+        'explorer.downloading': 'Downloading ',
+        'explorer.uploaded': 'Uploaded {n} file(s)',
+        'explorer.filesCount': '{n} file(s)',
+        'explorer.filesCountPartial': '{ok}/{total} file(s)',
+        'explorer.downloaded': 'Downloaded {n} file(s)',
+        'explorer.uploadFail': 'Upload failed',
+        'explorer.downloadFail': 'Download failed',
+        'explorer.downloadFailWith': 'Download failed: {reason}',
+        'explorer.downloadStart': 'Downloading {name} (large file, handled by the browser)',
+        'explorer.renamed': 'Path copied',
+        'explorer.renameFail': 'Rename failed',
+        'explorer.createFail': 'Create failed',
+        'explorer.moveIntoSelf': 'Cannot move a folder into itself: {path}',
+        'explorer.hostUnreachable': 'Host unreachable: {reason}',
+        'explorer.hostBadResponse': 'Failed to parse host response',
+        'menu.preview': '👁 Preview',
+        'menu.open': '🖥 Open with system',
+        'menu.rename': '✎ Rename',
+        'menu.trash': '🗑 Move to trash',
+        'menu.trashMulti': '🗑 Move to trash ({n})',
+        'menu.newFile': '📄 New file',
+        'menu.newFolder': '📁 New folder',
+        'menu.copyPath': '⧉ Copy path',
+        'menu.download': '⬇ Download',
+        'menu.deselect': 'Clear selection',
+        'files.tab': 'Preview',
+        'files.emptyHint': 'Double-click a file (or right-click → Preview) in the explorer',
+        'files.loading': 'Loading…',
+        'files.readFail': 'Failed to read file',
+        'files.reload': 'Reload',
+        'files.reloadTitle': 'Re-read from disk (refresh preview)',
+        'files.binary': 'Binary file ({size}) — open with the system explorer',
+        'files.imageTooLarge': 'Image too large ({size}, limit {limit})',
+        'files.pdfTooLarge': 'PDF too large ({size}, limit {limit}) — open with the system viewer',
+        'files.truncated': 'File exceeds 2 MB — showing the first 2 MB; open in a system editor for the full content.',
+        'files.jsonFail': 'JSON parse failed — shown as plain text',
+        'files.nbFail': 'ipynb parse failed — shown as plain text',
+        'files.nbEmpty': '(empty notebook)',
+        'files.nbCells': '{n} cells',
+        'files.csvTruncated': '{total} rows — showing the first {n}',
+        'files.htmlFrame': 'HTML preview',
+        'files.pdfFrame': 'PDF preview',
+        'files.pdfLoading': 'Loading PDF…',
+        'files.pdfFail': 'PDF preview failed: {reason}',
+        'files.pdfUnsupported': 'This browser cannot embed PDF previews — right-click and open with the system viewer.',
+        'files.nbHtmlOut': 'HTML output',
+        'speed.label': 'Speed badge',
+        'speed.waiting': 'Waiting for the model',
+        'speed.operateFail': 'Action failed',
+      },
+    }
+    /** 模块级翻译函数（apply 里由 ctx.locale.bind 填充）。 */
+    var T = function (key, params) { return key }
 
     // ------------------------------------------------------------------
     // 状态存储（模块级，供 Panel 与 HeaderAction 共享）
@@ -243,9 +398,9 @@ window.__ModuleLoader__.load({
         headers: { 'content-type': 'application/json', 'x-dsh-soup': '1' },
         body: JSON.stringify({ action: action, args: args || {} }),
       }).then(function (res) {
-        return res.json().catch(function () { return { ok: false, error: '宿主响应解析失败' } })
+        return res.json().catch(function () { return { ok: false, error: T('explorer.hostBadResponse') } })
       }).catch(function (err) {
-        return { ok: false, error: '宿主不可达: ' + String((err && err.message) || err) }
+        return { ok: false, error: T('explorer.hostUnreachable', { reason: String((err && err.message) || err) }) }
       })
     }
 
@@ -257,7 +412,7 @@ window.__ModuleLoader__.load({
         return loadDir(path, (attempt || 0) + 1)
       }
       if (!res || !res.ok) {
-        setState({ error: (res && res.error) || '读取失败' })
+        setState({ error: (res && res.error) || T('explorer.readFail') })
         return null
       }
       return res.entries || []
@@ -281,6 +436,7 @@ window.__ModuleLoader__.load({
       var cwd = await defaultCwd(sessionId, cwdHint)
       // 会话切换：预览列表按新 cwd 裁剪（范围外自动关闭），并清掉上一路径的旧错误横幅
       var files = pruneFilesToScope(state.files, cwd)
+      lastMtimes = {} // 换了目录，旧 mtime 基线全部作废（首轮 tick 重建基线）
       setState({ cwd: cwd, selected: new Set(), renaming: null, newItem: null, menu: null, error: '', notice: '', files: files })
       var items = await loadDir(cwd)
       if (items) setState({ error: '', tree: items })
@@ -292,6 +448,150 @@ window.__ModuleLoader__.load({
       if (items) setState({ error: '', tree: items })
     }
 
+    // ------------------------------------------------------------------
+    // 自动刷新：低频轮询宿主 mtime 探测（3s 一次），签名变了才真正重拉。
+    // watch 范围 = 当前 cwd + 已展开目录 + 打开的预览文件；面板关闭且无
+    // 预览时整个 tick 直接返回（零请求）。不做文件 watcher——fs.watch
+    // 递归语义跨平台不一致且大工作区开销高，stat 几个路径便宜得多。
+    // ------------------------------------------------------------------
+    var AUTO_REFRESH_MS = 3000
+    var AUTO_WATCH_MAX = 64
+    var lastMtimes = {}   // path -> {m,s,d}|null；undefined = 尚无基线（首轮只建基线不触发）
+    var autoTicking = false
+
+    function collectWatchPaths() {
+      var paths = []
+      if (state.cwd) paths.push(state.cwd)
+      var walk = function (nodes) {
+        for (var i = 0; i < nodes.length; i++) {
+          var n = nodes[i]
+          if (n.type === 'directory' && n.children != null) {
+            paths.push(n.path)
+            if (n.open && n.children.length) walk(n.children)
+          }
+        }
+      }
+      walk(state.tree)
+      for (var j = 0; j < state.files.list.length; j++) {
+        var e = state.files.list[j]
+        if (e.path && paths.indexOf(e.path) < 0) paths.push(e.path)
+      }
+      return paths.slice(0, AUTO_WATCH_MAX)
+    }
+
+    /** 预览文件在磁盘上变了：静默重读该 entry（不动激活状态、不闪 tab）。 */
+    async function silentReloadEntry(entry) {
+      var res = await rpc('read', { path: entry.path, sessionId: activeSessionId })
+      if (!res || !res.ok) return
+      entry.kind = res.kind
+      entry.size = res.size || 0
+      if (res.kind === 'text') { entry.content = res.content; entry.truncated = !!res.truncated }
+      else if (res.kind === 'image') { entry.dataUrl = 'data:' + res.mime + ';base64,' + res.data }
+      else if (res.kind === 'pdf') { entry.data = res.data }
+      setFiles({ list: state.files.list.slice() })
+    }
+
+    /** 已展开目录的子项变了：重拉该目录（保持展开态）。 */
+    async function reloadDirNode(node) {
+      var items = await loadDir(node.path)
+      if (items) items.forEach(function (c) { c.parent = node })
+      node.children = items || []
+      node.open = true
+      setState({ tree: state.tree })
+    }
+
+    /**
+     * 探一轮。返回 'idle'（本轮没发请求）/ true（探测成功）/ false（请求失败）。
+     * 只有真正发出去且失败的请求才累积退避；空闲不累积——面板重开时本就有
+     * 一次全量 loadDir，无需为"关着的时候宿主是否恢复"操心。
+     */
+    async function autoRefreshTick() {
+      if (autoTicking) return 'idle'
+      if (!state.open && state.files.list.length === 0) return 'idle'
+      // 用户正在操作（重命名/新建/右键菜单）时跳过本轮，避免打断输入
+      if (state.renaming || state.newItem || state.menu) return 'idle'
+      var paths = collectWatchPaths()
+      if (!paths.length) return 'idle'
+      autoTicking = true
+      try {
+        var res = await rpc('mtime', { paths: paths })
+        if (!res || !res.ok) return false
+        var mtimes = res.mtimes || {}
+        var dirtyDirs = []
+        var dirtyFiles = []
+        for (var i = 0; i < paths.length; i++) {
+          var p = paths[i]
+          var now = Object.prototype.hasOwnProperty.call(mtimes, p) ? mtimes[p] : null
+          var prev = Object.prototype.hasOwnProperty.call(lastMtimes, p) ? lastMtimes[p] : undefined
+          lastMtimes[p] = now
+          if (prev === undefined || prev === null || now === null) continue
+          if (now.m === prev.m && now.s === prev.s) continue
+          if (now.d) dirtyDirs.push(p)
+          else dirtyFiles.push(p)
+        }
+        for (var d = 0; d < dirtyDirs.length; d++) {
+          var dp = dirtyDirs[d]
+          if (dp === state.cwd) { await refresh(); continue }
+          var node = findNode(state.tree, dp)
+          if (node && node.children != null) await reloadDirNode(node)
+        }
+        for (var f = 0; f < dirtyFiles.length; f++) {
+          var entry = findFileEntry(dirtyFiles[f])
+          if (entry && entry.loaded) await silentReloadEntry(entry)
+        }
+        return true
+      } finally {
+        autoTicking = false
+      }
+    }
+
+    // 失败退避：宿主不可达（DSH 重启中 / 插件重载 / 断连）时别每 3s 硬打——
+    // 指数退避 3s→6s→12s→24s→48s，封顶 60s；一旦成功回到 3s。
+    // （JupyterLab FileBrowserModel 的 Poll 同思路：backoff + max 封顶。）
+    // 实现：1s 固定心跳 + 「到期才探测」，而不是变间隔定时器——宿主提供的
+    // timer 服务可 dispose，测试环境（interval 为 no-op mock）也不会挂住进程。
+    var AUTO_HEARTBEAT_MS = 1000
+    var AUTO_BACKOFF_MAX_MS = 60000
+    var autoFailCount = 0
+    var autoLastProbeAt = 0
+
+    function autoDelayMs() {
+      if (autoFailCount <= 0) return AUTO_REFRESH_MS
+      return Math.min(AUTO_REFRESH_MS * Math.pow(2, autoFailCount), AUTO_BACKOFF_MAX_MS)
+    }
+
+    function autoHeartbeat() {
+      var now = Date.now()
+      if (now - autoLastProbeAt < autoDelayMs()) return
+      autoLastProbeAt = now
+      autoRefreshTick().then(function (outcome) {
+        if (outcome === false) autoFailCount++
+        else autoFailCount = 0
+      })
+    }
+
+    /** 手动刷新：重拉根目录，已展开的子目录逐个重拉、保持展开不收起。 */
+    async function refreshAll() {
+      if (!state.cwd) return
+      var expanded = []
+      var walk = function (nodes) {
+        for (var i = 0; i < nodes.length; i++) {
+          var n = nodes[i]
+          if (n.type === 'directory' && n.children != null) {
+            if (n.path !== state.cwd) expanded.push({ path: n.path, open: !!n.open })
+            if (n.open && n.children.length) walk(n.children)
+          }
+        }
+      }
+      walk(state.tree)
+      await refresh()
+      for (var j = 0; j < expanded.length; j++) {
+        if (!expanded[j].open) continue
+        var node = findNode(state.tree, expanded[j].path)
+        if (node) await reloadDirNode(node)
+      }
+    }
+
     async function toggleNode(node) {
       if (node.type !== 'directory') return
       if (node.children == null) {
@@ -443,7 +743,7 @@ window.__ModuleLoader__.load({
       var errors = []
       for (var i = 0; i < paths.length; i++) {
         var res = await rpc('trash', { path: paths[i] })
-        if (!res || !res.ok) errors.push(baseName(paths[i]) + ': ' + ((res && res.error) || '失败') + ((res && res.hint) ? '（' + res.hint + '）' : ''))
+        if (!res || !res.ok) errors.push(baseName(paths[i]) + ': ' + ((res && res.error) || T('explorer.actionFail')) + ((res && res.hint) ? '（' + res.hint + '）' : ''))
       }
       if (errors.length) setState({ error: errors.join('；') })
       setState({ selected: new Set(), lastIndex: null })
@@ -464,7 +764,7 @@ window.__ModuleLoader__.load({
       setState({ renaming: null, selected: sel })
       ;(async function () {
         var res = await rpc('move', { from: path, to: dest })
-        if (!res || !res.ok) setState({ error: (res && res.error) || '重命名失败' })
+        if (!res || !res.ok) setState({ error: (res && res.error) || T('explorer.renameFail') })
         await refresh()
       })()
     }
@@ -485,7 +785,7 @@ window.__ModuleLoader__.load({
       setState({ newItem: null })
       ;(async function () {
         var res = await rpc('create', { dir: parent, name: name, isDir: isDir })
-        if (!res || !res.ok) setState({ error: (res && res.error) || '创建失败' })
+        if (!res || !res.ok) setState({ error: (res && res.error) || T('explorer.createFail') })
         await refresh()
       })()
     }
@@ -505,7 +805,7 @@ window.__ModuleLoader__.load({
       setState({ menu: null })
       try {
         if (navigator && navigator.clipboard && navigator.clipboard.writeText) {
-          navigator.clipboard.writeText(p).then(function () { showNotice('已复制路径') }).catch(function () {})
+          navigator.clipboard.writeText(p).then(function () { showNotice(T('explorer.renamed')) }).catch(function () {})
         }
       } catch (err) {}
     }
@@ -547,9 +847,9 @@ window.__ModuleLoader__.load({
         var name = baseName(p)
         var dest = pathJoin(targetDir, name)
         if (dest === p) continue
-        if (targetDir === p || targetDir.startsWith(p + '/')) { errors.push('不能把文件夹移入自身: ' + name); continue }
+        if (targetDir === p || targetDir.startsWith(p + '/')) { errors.push(T('explorer.moveIntoSelf', { path: name })); continue }
         var res = await rpc('move', { from: p, to: dest })
-        if (!res || !res.ok) errors.push(name + ': ' + ((res && res.error) || '失败'))
+        if (!res || !res.ok) errors.push(name + ': ' + ((res && res.error) || T('explorer.actionFail')))
       }
       setState({ dragPaths: null })
       if (errors.length) setState({ error: errors.join('；') })
@@ -560,7 +860,7 @@ window.__ModuleLoader__.load({
       return new Promise(function (resolve, reject) {
         var r = new FileReader()
         r.onload = function () { var s = String(r.result || ''); var i = s.indexOf(','); resolve(i >= 0 ? s.slice(i + 1) : s) }
-        r.onerror = function () { reject(new Error('读取文件失败')) }
+        r.onerror = function () { reject(new Error(T('files.readFail'))) }
         r.readAsDataURL(file)
       })
     }
@@ -583,9 +883,9 @@ window.__ModuleLoader__.load({
     }
 
     function finishUploads(count, okCount, failedName, down) {
-      var verb = down ? '已下载' : '已上传'
+      var verb = down ? T('explorer.downloaded') : T('explorer.uploaded')
       setUploadEntry({
-        name: '✓ ' + verb + ' ' + (okCount === count ? count + ' 个文件' : okCount + '/' + count + ' 个文件' + (failedName ? '（' + failedName + ' 失败）' : '')),
+        name: '✓ ' + verb + ' ' + (okCount === count ? T('explorer.filesCount', { n: count }) : T('explorer.filesCountPartial', { ok: okCount, total: count }) + (failedName ? '（' + failedName + '）' : '')),
         loaded: 0, total: 0, idx: 0, totalFiles: 0, done: true, down: !!down,
       })
       window.setTimeout(function () { setState({ uploads: [] }) }, 1600)
@@ -604,7 +904,7 @@ window.__ModuleLoader__.load({
           dir: dir, name: f.name, data: b64,
           chunk: chunked ? c + 1 : undefined,
         })
-        if (!res || !res.ok) throw new Error((res && res.error) || '上传失败')
+        if (!res || !res.ok) throw new Error((res && res.error) || T('explorer.uploadFail'))
         updateUpload(f.name, Math.min(f.size, start + UPLOAD_CHUNK_SIZE), f.size, idx, totalFiles)
       }
     }
@@ -638,7 +938,7 @@ window.__ModuleLoader__.load({
         res = await rpc('download', { path: path, sessionId: activeSessionId })
       }
       if (!res || !res.ok) {
-        setState({ error: (res && res.error) || '下载失败' })
+        setState({ error: (res && res.error) || T('explorer.downloadFail') })
         return
       }
       var name = res.name || baseName(path)
@@ -651,7 +951,7 @@ window.__ModuleLoader__.load({
         document.body.appendChild(a)
         a.click()
         a.remove()
-        showNotice('已开始下载 ' + name + '（大文件，由浏览器接管）')
+        showNotice(T('explorer.downloadStart', { name: name }))
         return
       }
       // 中小文件：fetch 流式读字节计进度，完成后 Blob 另存（峰值≈文件体积）
@@ -680,7 +980,7 @@ window.__ModuleLoader__.load({
         window.setTimeout(function () { URL.revokeObjectURL(blobUrl) }, 5000)
         finishUploads(1, 1, '', true)
       } catch (err) {
-        setState({ error: '下载失败: ' + String((err && err.message) || err), uploads: [] })
+        setState({ error: T('explorer.downloadFailWith', { reason: String((err && err.message) || err) }), uploads: [] })
       }
     }
 
@@ -696,7 +996,7 @@ window.__ModuleLoader__.load({
     // markdown/html/json/csv 有专属渲染器；图片预览；其余按纯文本。
     // 状态存模块级 store，切走 tab 再切回来内容不丢。
     // ------------------------------------------------------------------
-    var FILES_TAB_LABEL = '预览'
+    var FILES_TAB_LABEL = function () { return T('files.tab') }
 
     /** 当前活跃会话：list/read/download 携带给宿主，供围栏直查该会话 cwd。 */
     var activeSessionId = null
@@ -745,7 +1045,7 @@ window.__ModuleLoader__.load({
       try {
         var tabs = document.querySelectorAll('[role="tab"]')
         for (var i = 0; i < tabs.length; i++) {
-          if (tabs[i].textContent === FILES_TAB_LABEL) { tabs[i].click(); return true }
+          if (tabs[i].textContent === FILES_TAB_LABEL()) { tabs[i].click(); return true }
         }
       } catch (err) {}
       return false
@@ -783,7 +1083,7 @@ window.__ModuleLoader__.load({
       if (!cur) return
       cur.loading = false
       if (!res || !res.ok) {
-        cur.error = (res && res.error) || '读取失败'
+        cur.error = (res && res.error) || T('explorer.readFail')
       } else {
         cur.error = ''
         cur.loaded = true
@@ -915,7 +1215,7 @@ window.__ModuleLoader__.load({
       }
       if (isDir && node.open) {
         if (node.loading) {
-          children.push(create('div', { key: '__loading__', className: 'expl-muted', style: { paddingLeft: 8 + (depth + 1) * 16 } }, '加载中…'))
+          children.push(create('div', { key: '__loading__', className: 'expl-muted', style: { paddingLeft: 8 + (depth + 1) * 16 } }, T('files.loading')))
         } else {
           ;(node.children || []).forEach(function (c) { children.push(create(Row, { key: c.path, node: c, depth: depth + 1 })) })
         }
@@ -930,29 +1230,29 @@ window.__ModuleLoader__.load({
       if (node) {
         if (!multi) {
           if (node.type !== 'directory') {
-            items.push({ key: 'open-tab', label: '👁 预览', onClick: function () { openFileInTab(node.path) } })
-            items.push({ key: 'open', label: '🖥 用系统打开', onClick: openSelection, separatorAfter: true })
+            items.push({ key: 'open-tab', label: T('menu.preview'), onClick: function () { openFileInTab(node.path) } })
+            items.push({ key: 'open', label: T('menu.open'), onClick: openSelection, separatorAfter: true })
           } else {
-            items.push({ key: 'open', label: '🖥 用系统打开', onClick: openSelection, separatorAfter: true })
+            items.push({ key: 'open', label: T('menu.open'), onClick: openSelection, separatorAfter: true })
           }
-          items.push({ key: 'rename', label: '✎ 重命名', onClick: function () { startRename(node) } })
-          items.push({ key: 'trash', label: '🗑 移到废纸篓', danger: true, onClick: trashSelection, separatorAfter: true })
+          items.push({ key: 'rename', label: T('menu.rename'), onClick: function () { startRename(node) } })
+          items.push({ key: 'trash', label: T('menu.trash'), danger: true, onClick: trashSelection, separatorAfter: true })
         } else {
-          items.push({ key: 'trash', label: '🗑 移到废纸篓 (' + state.selected.size + ' 项)', danger: true, onClick: trashSelection, separatorAfter: true })
+          items.push({ key: 'trash', label: T('menu.trashMulti', { n: state.selected.size }), danger: true, onClick: trashSelection, separatorAfter: true })
         }
         if (node.type === 'directory') {
-          items.push({ key: 'newfile', label: '📄 新建文件', onClick: function () { startNew(node.path, false) } })
-          items.push({ key: 'newfolder', label: '📁 新建文件夹', onClick: function () { startNew(node.path, true) }, separatorAfter: true })
+          items.push({ key: 'newfile', label: T('menu.newFile'), onClick: function () { startNew(node.path, false) } })
+          items.push({ key: 'newfolder', label: T('menu.newFolder'), onClick: function () { startNew(node.path, true) }, separatorAfter: true })
         }
-        items.push({ key: 'copy', label: '⧉ 复制路径', onClick: function () { copyPath(node) } })
+        items.push({ key: 'copy', label: T('menu.copyPath'), onClick: function () { copyPath(node) } })
         if (node.type !== 'directory') {
-          items.push({ key: 'download', label: '⬇ 下载', onClick: function () { downloadFile(node.path) } })
+          items.push({ key: 'download', label: T('menu.download'), onClick: function () { downloadFile(node.path) } })
         }
       } else {
-        items.push({ key: 'newfile', label: '📄 新建文件', onClick: function () { startNew(state.cwd, false) } })
-        items.push({ key: 'newfolder', label: '📁 新建文件夹', onClick: function () { startNew(state.cwd, true) } })
-        items.push({ key: 'refresh', label: '⟳ 刷新', onClick: refresh, separatorAfter: true })
-        if (state.selected.size > 0) items.push({ key: 'none', label: '取消选择', onClick: function () { setState({ selected: new Set(), lastIndex: null }) } })
+        items.push({ key: 'newfile', label: T('menu.newFile'), onClick: function () { startNew(state.cwd, false) } })
+        items.push({ key: 'newfolder', label: T('menu.newFolder'), onClick: function () { startNew(state.cwd, true) } })
+        items.push({ key: 'refresh', label: [create('span', { className: 'expl-menu-ico', dangerouslySetInnerHTML: { __html: ICON_REFRESH } }), T('explorer.refresh')], onClick: refresh, separatorAfter: true })
+        if (state.selected.size > 0) items.push({ key: 'none', label: T('menu.deselect'), onClick: function () { setState({ selected: new Set(), lastIndex: null }) } })
       }
       return items
     }
@@ -1100,13 +1400,46 @@ window.__ModuleLoader__.load({
     var CSV_MAX_ROWS = 500
     var CSV_MAX_COLS = 64
 
+    // ------------------------------------------------------------------
+    // Markdown 相对图片 → dsh-soup 同源 img 端点绝对 URL。
+    // 预览 markdown 时，DSH 的 MarkdownText 渲染器「禁相对链接/相对资源」，
+    // `![x](view.jpg)` 这类相对路径图片会被直接丢弃。因此把 src 改写成
+    // 本插件同名端点（GET /api/dsh-soup/img）的同源绝对地址，交给 <img>
+    // 从磁盘内联加载。绝对（http/https/data 等）与根相对路径放行不处理。
+    // ------------------------------------------------------------------
+    var MD_IMG_RE = /!\[([^\]]*)\]\(([^)\s]+)(?:\s+["'][^"']*["'])?\)/g
+    function posixResolve(dir, rel) {
+      var combined = (String(dir || '/').replace(/\/+$/, '') || '/') + '/' + String(rel)
+      var out = []
+      combined.split('/').forEach(function (seg) {
+        if (seg === '' || seg === '.') return
+        if (seg === '..') { if (out.length) out.pop(); return }
+        out.push(seg)
+      })
+      return '/' + out.join('/')
+    }
+    function imgUrl(absPath) {
+      return hostBase() + '/api/dsh-soup/img?p=' + encodeURIComponent(absPath)
+    }
+    function absolutizeMarkdownImages(text, baseDir) {
+      if (!text) return text
+      var dir = baseDir || '/'
+      return text.replace(MD_IMG_RE, function (m0, alt, src) {
+        var s = String(src || '').trim()
+        if (/^(?:[a-z][a-z0-9+.-]*:|#|\/)/i.test(s)) return m0
+        return '![' + alt + '](' + imgUrl(posixResolve(dir, s)) + ')'
+      })
+    }
+
     function MarkdownPreview(props) {
+      var text = props.text
       if (MarkdownText) {
+        var md = props.baseDir ? absolutizeMarkdownImages(text, props.baseDir) : text
         return create('div', { className: 'dfv-md-wrap' },
-          create('div', { className: 'dfv-md' }, create(MarkdownText, { text: props.text })))
+          create('div', { className: 'dfv-md' }, create(MarkdownText, { text: md })))
       }
       // 回退：宿主缺 ui-primitives 时按纯文本展示
-      return create('pre', { className: 'dfv-code' }, props.text)
+      return create('pre', { className: 'dfv-code' }, text)
     }
 
     function HtmlPreview(props) {
@@ -1117,7 +1450,7 @@ window.__ModuleLoader__.load({
         className: 'dfv-frame',
         sandbox: 'allow-scripts allow-popups allow-forms allow-modals',
         referrerPolicy: 'no-referrer',
-        title: props.title || 'HTML 预览',
+        title: props.title || T('files.htmlFrame'),
         srcDoc: props.text,
       })
     }
@@ -1146,14 +1479,14 @@ window.__ModuleLoader__.load({
           if (made) URL.revokeObjectURL(made)
         }
       }, [props.data])
-      if (state.error) return create('div', { className: 'dfv-error' }, 'PDF 预览失败: ' + state.error)
-      if (!state.url) return create('div', { className: 'dfv-empty' }, 'PDF 加载中…')
+      if (state.error) return create('div', { className: 'dfv-error' }, T('files.pdfFail', { reason: state.error }))
+      if (!state.url) return create('div', { className: 'dfv-empty' }, T('files.pdfLoading'))
       return create('object', {
         className: 'dfv-frame dfv-pdf',
         type: 'application/pdf',
         data: state.url,
-        'aria-label': 'PDF 预览',
-      }, '当前浏览器无法内嵌预览 PDF，请右键用系统打开。')
+        'aria-label': T('files.pdfFrame'),
+      }, T('files.pdfUnsupported'))
     }
 
     // ------------------------------------------------------------------
@@ -1206,7 +1539,7 @@ window.__ModuleLoader__.load({
           return create('img', { className: 'dfv-nb-img', src: 'data:image/svg+xml;base64,' + btoa(unescape(encodeURIComponent(nbSource(out.data[mime])))), alt: 'notebook output svg' })
         }
         if (mime === 'text/html') {
-          return create('iframe', { className: 'dfv-nb-html', sandbox: '', title: 'HTML 输出', srcDoc: nbSource(out.data[mime]) })
+          return create('iframe', { className: 'dfv-nb-html', sandbox: '', title: T('files.nbHtmlOut'), srcDoc: nbSource(out.data[mime]) })
         }
         if (mime === 'text/markdown' && MarkdownText) {
           return create('div', { className: 'dfv-md-wrap dfv-nb-md' }, create(MarkdownText, { text: nbSource(out.data[mime]) }))
@@ -1222,7 +1555,7 @@ window.__ModuleLoader__.load({
       try { nb = JSON.parse(props.text) } catch (err) { nb = undefined }
       if (nb === undefined || typeof nb !== 'object' || nb === null) {
         return create(React.Fragment, null,
-          create('div', { className: 'dfv-cap' }, 'ipynb 解析失败，按纯文本显示'),
+          create('div', { className: 'dfv-cap' }, T('files.nbFail')),
           create('pre', { className: 'dfv-code' }, props.text))
       }
       var cells = Array.isArray(nb.cells) ? nb.cells : []
@@ -1269,8 +1602,8 @@ window.__ModuleLoader__.load({
 
       return create('div', { className: 'dfv-nb' },
         create('div', { className: 'dfv-cap' },
-          'Jupyter Notebook' + (kernelName ? ' · ' + kernelName : '') + ' · ' + cells.length + ' 个单元格'),
-        cellEls.length ? cellEls : create('div', { className: 'dfv-muted' }, '（空笔记本）'))
+          'Jupyter Notebook' + (kernelName ? ' · ' + kernelName : '') + ' · ' + T('files.nbCells', { n: cells.length })),
+        cellEls.length ? cellEls : create('div', { className: 'dfv-muted' }, T('files.nbEmpty')))
     }
 
     function JsonPreview(props) {
@@ -1278,7 +1611,7 @@ window.__ModuleLoader__.load({
       try { JSON.parse(props.text) } catch (err) { failed = true }
       if (failed) {
         return create(React.Fragment, null,
-          create('div', { className: 'dfv-cap' }, 'JSON 解析失败，按纯文本显示'),
+          create('div', { className: 'dfv-cap' }, T('files.jsonFail')),
           create('pre', { className: 'dfv-code' }, props.text))
       }
       return create('pre', { className: 'dfv-json dfv-code' }, jsonColorNodes(JSON.stringify(JSON.parse(props.text), null, 2)))
@@ -1295,7 +1628,7 @@ window.__ModuleLoader__.load({
         cols = Math.max(cols, Math.min(rows[r].length, CSV_MAX_COLS))
       }
       var caps = []
-      if (totalRows > CSV_MAX_ROWS + 1) caps.push('共 ' + totalRows + ' 行，仅预览前 ' + CSV_MAX_ROWS + ' 行')
+      if (totalRows > CSV_MAX_ROWS + 1) caps.push(T('files.csvTruncated', { total: totalRows, n: CSV_MAX_ROWS }))
       var trs = []
       for (var ri = 1; ri <= Math.min(totalRows - 1, CSV_MAX_ROWS); ri++) {
         var cells = rows[ri]
@@ -1331,18 +1664,18 @@ window.__ModuleLoader__.load({
     function FileContent(props) {
       var entry = props.entry
       if (entry.loading) {
-        return create('div', { className: 'dfv-empty' }, '加载中…')
+        return create('div', { className: 'dfv-empty' }, T('files.loading'))
       }
       if (entry.error) {
         return create('div', { className: 'dfv-error' }, entry.error)
       }
       if (entry.kind === 'binary') {
         return create('div', { className: 'dfv-muted' },
-          '二进制文件（' + formatBytes(entry.size) + '），请在资源管理器中用系统打开')
+          T('files.binary', { size: formatBytes(entry.size) }))
       }
       if (entry.kind === 'image-too-large') {
         return create('div', { className: 'dfv-muted' },
-          '图片过大（' + formatBytes(entry.size) + '，上限 ' + formatBytes(entry.limit) + '）')
+          T('files.imageTooLarge', { size: formatBytes(entry.size), limit: formatBytes(entry.limit) }))
       }
       if (entry.kind === 'image') {
         return create('div', { className: 'dfv-image-wrap' },
@@ -1350,7 +1683,7 @@ window.__ModuleLoader__.load({
       }
       if (entry.kind === 'pdf-too-large') {
         return create('div', { className: 'dfv-muted' },
-          'PDF 过大（' + formatBytes(entry.size) + '，上限 ' + formatBytes(entry.limit) + '），请用系统打开')
+          T('files.pdfTooLarge', { size: formatBytes(entry.size), limit: formatBytes(entry.limit) }))
       }
       if (entry.kind === 'pdf') {
         return create(PdfPreview, { data: entry.data })
@@ -1358,7 +1691,7 @@ window.__ModuleLoader__.load({
       // 文本类：按扩展名选预览渲染器（纯只读，无编辑）
       var pk = previewKind(entry.path)
       var view = null
-      if (pk === 'markdown') view = create(MarkdownPreview, { text: entry.content })
+      if (pk === 'markdown') view = create(MarkdownPreview, { text: entry.content, baseDir: parentOf(entry.path) })
       else if (pk === 'html') view = create(HtmlPreview, { text: entry.content, title: entry.name })
       else if (pk === 'json') view = create(JsonPreview, { text: entry.content })
       else if (pk === 'notebook') view = create(NotebookPreview, { text: entry.content })
@@ -1376,15 +1709,51 @@ window.__ModuleLoader__.load({
       }
       return create(React.Fragment, null,
         entry.truncated ? create('div', { className: 'dfv-cap' },
-          '文件超过 2 MB，仅预览前 2 MB；完整内容请用系统编辑器打开。') : null,
+          T('files.truncated')) : null,
         view,
       )
     }
 
+    /**
+     * 纯阅读模式标记：在会话根（含 composerSeat 的最近祖先，即 DSH
+     * ConversationRoot 的 root 节点）上打 data-dsh-soup-preview，由上面
+     * 注入的 CSS 隐藏输入区与轮次统计行。DSH 重渲染可能重建该节点——
+     * MutationObserver 在 FilesView 存活期间持续确保标记存在。
+     */
+    function usePreviewReadingMode(rootRef) {
+      React.useEffect(function () {
+        var observer = null
+        var marked = null
+        function apply() {
+          var el = rootRef.current
+          if (!el) return
+          if (marked && marked.contains(el) && marked.getAttribute('data-dsh-soup-preview') === '1') return
+          var host = el.parentElement
+          while (host) {
+            if (host.querySelector && host.querySelector('.wSkVaW_composerSeat')) break
+            host = host.parentElement
+          }
+          if (!host) return
+          host.setAttribute('data-dsh-soup-preview', '1')
+          marked = host
+        }
+        apply()
+        observer = new MutationObserver(function () { apply() })
+        observer.observe(document.body, { childList: true, subtree: true })
+        return function () {
+          if (observer) observer.disconnect()
+          if (marked) marked.removeAttribute('data-dsh-soup-preview')
+          marked = null
+        }
+      }, [])
+    }
+
     function FilesView(props) {
       var s = useStore()
       var files = s.files
       var active = files.active ? findFileEntry(files.active) : null
+      var rootRef = React.useRef(null)
+      usePreviewReadingMode(rootRef)
 
       var tabs = files.list.map(function (entry) {
         return create('button', {
@@ -1398,7 +1767,7 @@ window.__ModuleLoader__.load({
           create('span', {
             className: 'dfv-close',
             role: 'button',
-            title: '关闭',
+            title: T('explorer.close'),
             onClick: function (e) { e.stopPropagation(); closeFileTab(entry.path) },
           }, '✕'),
         )
@@ -1408,7 +1777,7 @@ window.__ModuleLoader__.load({
       if (!active) {
         body = create('div', { className: 'dfv-empty' },
           create('span', { style: { fontSize: 22 } }, '📄'),
-          '在右侧资源管理器中双击或右键「预览」文件',
+          T('files.emptyHint'),
         )
       } else {
         body = create('div', { className: 'dfv-body' },
@@ -1418,15 +1787,18 @@ window.__ModuleLoader__.load({
             active.loaded ? create('button', {
               type: 'button',
               className: 'dfv-btn',
-              title: '从磁盘重新读取（刷新预览）',
+              title: T('files.reloadTitle'),
               onClick: function () { reloadFile(active.path) },
-            }, '⟳ 重载') : null,
+            },
+              create('span', { className: 'expl-icon', dangerouslySetInnerHTML: { __html: ICON_REFRESH } }),
+              T('files.reload'),
+            ) : null,
           ),
           create(FileContent, { key: active.path, entry: active }),
         )
       }
 
-      return create('div', { className: 'dfv-root' },
+      return create('div', { className: 'dfv-root', ref: rootRef },
         files.list.length > 0 ? create('div', { className: 'dfv-tabbar' }, tabs) : null,
         body,
       )
@@ -1566,7 +1938,7 @@ window.__ModuleLoader__.load({
         ))
       }
       if (s.tree.length === 0 && !(state.newItem && state.newItem.parent === state.cwd)) {
-        bodyChildren.push(create('div', { key: '__empty__', className: 'expl-muted' }, '（空目录）'))
+        bodyChildren.push(create('div', { key: '__empty__', className: 'expl-muted' }, T('explorer.emptyDir')))
       } else {
         s.tree.forEach(function (node) { bodyChildren.push(create(Row, { key: node.path, node: node, depth: 0 })) })
       }
@@ -1583,17 +1955,29 @@ window.__ModuleLoader__.load({
       return create('div', { ref: panelRef, className: 'expl-panel' },
         create('div', { className: 'expl-resize', onPointerDown: onResizeDown, onPointerMove: onResizeMove, onPointerUp: onResizeUp, onPointerCancel: onResizeUp }),
         create('div', { className: 'expl-head' },
-          create('span', { className: 'expl-title' }, '📁 资源管理器'),
+          create('span', { className: 'expl-title' }, T('explorer.title')),
           create('div', { className: 'expl-head-btns' },
-            create('button', { className: 'expl-btn', onClick: function () { if (uploadInputEl) uploadInputEl.click() }, title: '上传文件' }, '⬆'),
             create('button', {
               className: 'expl-btn',
+              onClick: function () { refreshAll() },
+              title: T('explorer.refreshTitle'),
+              'aria-label': T('explorer.refresh'),
+            }, create('span', { className: 'expl-icon', dangerouslySetInnerHTML: { __html: ICON_REFRESH } })),
+            create('button', {
+              className: 'expl-btn',
+              onClick: function () { if (uploadInputEl) uploadInputEl.click() },
+              title: T('explorer.upload'),
+              'aria-label': T('explorer.upload'),
+            }, '⬆'),
+            create('button', {
+              className: 'expl-btn',
+              style: { fontSize: '18px' },
               onClick: function (event) {
                 try { layout.closeDetails() } catch (e) {}
                 setHeroDetailsWidth(event.currentTarget, 0)
               },
-              title: '关闭',
-              'aria-label': '关闭资源管理器',
+              title: T('explorer.close'),
+              'aria-label': T('explorer.closePanel'),
             }, '✕'),
           ),
         ),
@@ -1605,7 +1989,7 @@ window.__ModuleLoader__.load({
               create('span', { className: 'expl-upload-glyph' }, u.done ? '✓' : (u.down ? '⬇' : '⬆')),
               create('span', { className: 'expl-upload-text' },
                 u.done ? u.name
-                  : (u.down ? '下载中 ' : '上传中 ') + (u.totalFiles > 1 ? '(' + u.idx + '/' + u.totalFiles + ') ' : '') + u.name,
+                  : (u.down ? T('explorer.downloading') : T('explorer.uploading')) + (u.totalFiles > 1 ? '(' + u.idx + '/' + u.totalFiles + ') ' : '') + u.name,
               ),
               !u.done && u.total ? create('span', { className: 'expl-upload-pct' }, pct + '%') : null,
             )
@@ -1615,7 +1999,7 @@ window.__ModuleLoader__.load({
         s.error ? create('div', { className: 'expl-error' }, s.error) : null,
         s.notice ? create('div', { className: 'expl-notice' }, s.notice) : null,
         s.selected.size > 1
-          ? create('div', { className: 'expl-bulk' }, '已选 ' + s.selected.size + ' 项 · 拖到文件夹可移动')
+          ? create('div', { className: 'expl-bulk' }, T('explorer.bulkSelected', { n: s.selected.size }))
           : null,
         container,
         s.menu ? create('div', { className: 'expl-menu-mask', onMouseDown: function () { setState({ menu: null }) }, onContextMenu: function (e) { e.preventDefault(); setState({ menu: null }) } }) : null,
@@ -1637,8 +2021,8 @@ window.__ModuleLoader__.load({
         type: 'button',
         className: 'expl-toggle expl-tool' + (s.open ? ' expl-active' : ''),
         onClick: function () { try { if (s.open) layout.closeDetails(); else layout.openDetails() } catch (e) {} },
-        title: '项目资源管理器',
-        'aria-label': '项目资源管理器',
+        title: T('explorer.label'),
+        'aria-label': T('explorer.label'),
       }, '📁')
     }
 
@@ -1666,8 +2050,8 @@ window.__ModuleLoader__.load({
               try { layout.openDetails() } catch (e) {}
             }
           },
-          title: '项目资源管理器',
-          'aria-label': '项目资源管理器',
+          title: T('explorer.label'),
+          'aria-label': T('explorer.label'),
         }, '📁'))
     }
 
@@ -1734,7 +2118,7 @@ window.__ModuleLoader__.load({
           el.style.cssText = 'display:inline-flex;align-items:center;margin-left:10px;font-weight:400;font-size:13px;color:var(--dsw-alias-label-caption);'
           el.style.setProperty('color', 'var(--dsw-alias-label-caption)', 'important')
           el.style.setProperty('-webkit-text-fill-color', 'var(--dsw-alias-label-caption)', 'important')
-          el.textContent = '正在等待模型' + new Array(dotsRef.current + 1).join('.')
+          el.textContent = T('speed.waiting') + new Array(dotsRef.current + 1).join('.')
           return
         }
         // 流式阶段：token 计数立即显示；瞬时速率窗口未满（tps=0）时先不显示徽标，
@@ -1908,7 +2292,7 @@ window.__ModuleLoader__.load({
           pendingRef.current = false
           pending[1](false)
           if (!result || !result.ok) {
-            var err = result && result.error ? (result.error.message + ' (' + result.error.code + ')') : '操作失败'
+            var err = result && result.error ? (result.error.message + ' (' + result.error.code + ')') : T('speed.operateFail')
             actionError[1](err)
           }
           return result
@@ -2026,9 +2410,20 @@ window.__ModuleLoader__.load({
       var sessions = ctx.sessions
       var remoteGoals = ctx.remote.goals
       var disposers = []
+      // i18n：注册双语词典；模块级 T 供组件外回调（菜单/错误横幅）取当前语言文案。
+      if (ctx.locale && typeof ctx.locale.register === 'function') {
+        ctx.effect(function () { return ctx.locale.register(NS, DICT) }, 'dsh-soup: dictionaries')
+        if (typeof ctx.locale.bind === 'function') T = ctx.locale.bind(NS)
+      }
+      // 自动刷新心跳：1s 固定心跳 + 到期才探测（基础 3s；宿主不可达时指数退避，封顶 60s）。
+      // 面板关且无预览时 tick 内直接返回（零请求）；首个 tick 只建基线。
+      if (timerRef && typeof timerRef.interval === 'function') {
+        var stopAuto = timerRef.interval(function () { autoHeartbeat() }, AUTO_HEARTBEAT_MS)
+        disposers.push(function () { try { stopAuto() } catch (e) {} })
+      }
       slots.inject('conversation.session.header.utilities', function () {
         disposers.push(slots.register(
-          { name: 'conversation.session.header.utilities', id: 'dsh-soup-toggle', order: 10, label: '资源管理器' },
+          { name: 'conversation.session.header.utilities', id: 'dsh-soup-toggle', order: 10, locale: NS, label: function () { return T('explorer.label') } },
           function (props) { return create(HeaderAction, props) },
         ))
       })
@@ -2036,7 +2431,7 @@ window.__ModuleLoader__.load({
         disposers.push(slots.register(
           // `details` is a single slot occupied by the shell at priority 0.
           // Lower priorities render first, so this intentionally shadows it.
-          { name: 'details', priority: -1 },
+          { name: 'details', priority: -1, locale: NS },
           function (props) { return create(Panel, props) },
         ))
       })
@@ -2044,7 +2439,7 @@ window.__ModuleLoader__.load({
       // 槽位 entry 是静态的，多文件由 FilesView 内部子 tab 条管理。
       slots.inject('conversation.view', function () {
         disposers.push(slots.register(
-          { name: 'conversation.view', id: 'dsh-soup-files', order: 20, label: FILES_TAB_LABEL },
+          { name: 'conversation.view', id: 'dsh-soup-files', order: 20, locale: NS, label: function () { return T('files.tab') } },
           function (props) { return create(FilesView, props) },
         ))
       })
@@ -2064,7 +2459,7 @@ window.__ModuleLoader__.load({
       }
       slots.inject('conversation.input.dock', function () {
         disposers.push(slots.register(
-          { name: 'conversation.input.dock', id: 'dsh-soup-hero-toggle', order: -10 },
+          { name: 'conversation.input.dock', id: 'dsh-soup-hero-toggle', order: -10, locale: NS },
           function (props) { return create(HeroAction, props) },
         ))
         // GoalBar 多行版：同 id 'goal'、更低 priority (-1) -> 遮蔽默认单行实现。
@@ -2100,7 +2495,7 @@ window.__ModuleLoader__.load({
           function (props) { return create(GoalDock, props) },
         ))
         disposers.push(slots.register(
-          { name: 'conversation.input.dock', id: 'dsh-speed-badge', order: 30, label: '速度徽标' },
+          { name: 'conversation.input.dock', id: 'dsh-speed-badge', order: 30, locale: NS, label: function () { return T('speed.label') } },
           function (props) { return create(SpeedBadge, props) },
         ))
       })