@lyhue1991/dsh-soup 0.3.0 → 0.4.0

package/README.md

@@ -97,7 +97,10 @@ dsh plugin add @lyhue1991/dsh-soup
 
 ## 更新日志
 
-- **0.3.0（当前）** —
+- **0.4.0（当前）** —
+  - **语言适配（i18n）**：dsh-soup 全部文案（资源管理器、预览页、右键菜单、上传/下载、速度徽标、GoalBar）跟随 DSH 通用设置的语言切换（zh/en），切换即时生效。
+  - **预览 tab 纯阅读模式**：激活预览时隐藏底部输入框、「N 轮 · M 步」统计行、GoalBar 与速度徽标——整屏干净内容区，切回对话/轨迹恢复。
+- **0.3.0** —
   - **Markdown 预览渲染相对路径图片**：`![x](view.jpg)` 经同源 `/api/dsh-soup/img` 端点内联加载（confine 围栏 + 仅图片类型 + 拒跨站）。
   - **自动刷新**：资源管理器与预览页每 3 秒轻量探测目录/文件签名（mtime），变了才重拉；面板关闭且无预览时零开销；宿主不可达时指数退避（封顶 60s）。
   - **顶部 ⟳ 刷新按钮**：重拉整棵树并保持已展开子目录不收起；空白右键「刷新」项同步升级为同一枚图标。

package/lib/client.js

@@ -180,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'
@@ -189,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 共享）
@@ -254,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) }) }
       })
     }
 
@@ -268,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 || []
@@ -599,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 })
@@ -620,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()
       })()
     }
@@ -641,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()
       })()
     }
@@ -661,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) {}
     }
@@ -703,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('；') })
@@ -716,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)
       })
     }
@@ -739,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)
@@ -760,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)
       }
     }
@@ -794,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)
@@ -807,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 另存（峰值≈文件体积）
@@ -836,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: [] })
       }
     }
 
@@ -852,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
@@ -901,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
@@ -939,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
@@ -1071,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 })) })
         }
@@ -1086,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: [create('span', { className: 'expl-menu-ico', dangerouslySetInnerHTML: { __html: ICON_REFRESH } }), '刷新'], 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
     }
@@ -1306,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,
       })
     }
@@ -1335,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'))
     }
 
     // ------------------------------------------------------------------
@@ -1395,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]) }))
@@ -1411,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 : []
@@ -1458,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) {
@@ -1467,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)))
@@ -1484,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]
@@ -1520,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' },
@@ -1539,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 })
@@ -1565,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', {
@@ -1587,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) },
           }, '✕'),
         )
@@ -1597,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' },
@@ -1607,18 +1787,18 @@ window.__ModuleLoader__.load({
             active.loaded ? create('button', {
               type: 'button',
               className: 'dfv-btn',
-              title: '从磁盘重新读取（刷新预览）',
+              title: T('files.reloadTitle'),
               onClick: function () { reloadFile(active.path) },
             },
               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,
       )
@@ -1758,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 })) })
       }
@@ -1775,19 +1955,19 @@ 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 () { refreshAll() },
-              title: '刷新（保持已展开目录）',
-              'aria-label': '刷新',
+              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: '上传文件',
-              'aria-label': '上传文件',
+              title: T('explorer.upload'),
+              'aria-label': T('explorer.upload'),
             }, '⬆'),
             create('button', {
               className: 'expl-btn',
@@ -1796,8 +1976,8 @@ window.__ModuleLoader__.load({
                 try { layout.closeDetails() } catch (e) {}
                 setHeroDetailsWidth(event.currentTarget, 0)
               },
-              title: '关闭',
-              'aria-label': '关闭资源管理器',
+              title: T('explorer.close'),
+              'aria-label': T('explorer.closePanel'),
             }, '✕'),
           ),
         ),
@@ -1809,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,
             )
@@ -1819,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,
@@ -1841,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'),
       }, '📁')
     }
 
@@ -1870,8 +2050,8 @@ window.__ModuleLoader__.load({
               try { layout.openDetails() } catch (e) {}
             }
           },
-          title: '项目资源管理器',
-          'aria-label': '项目资源管理器',
+          title: T('explorer.label'),
+          'aria-label': T('explorer.label'),
         }, '📁'))
     }
 
@@ -1938,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）时先不显示徽标，
@@ -2112,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
@@ -2230,6 +2410,11 @@ 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') {
@@ -2238,7 +2423,7 @@ window.__ModuleLoader__.load({
       }
       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) },
         ))
       })
@@ -2246,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) },
         ))
       })
@@ -2254,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) },
         ))
       })
@@ -2274,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) -> 遮蔽默认单行实现。
@@ -2310,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) },
         ))
       })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lyhue1991/dsh-soup",
   "description": "DSH 项目资源管理器：右侧 details 列文件树（并列网格、宽度与左侧工作区一致 264-420px），有 Session log 时在其右侧、空白新会话在输入框上方右端提供 📁 切换按钮；支持多选、双击展开/打开、右键菜单（打开/系统打开/重命名/废纸篓/新建/复制路径）、拖拽移动、上传。文件「打开」在会话区新增「文件」标签页（原生 conversation.view，与对话/轨迹同级）：文本可编辑 ⌘S 保存、图片预览、二进制提示。附带模型吞吐徽标：输入框正上方显示「正在等待模型...」与彩色 t/s 徽标（数据来自 llm/stream 真实流）。附带 GoalBar 多行展示：把原生单行截断 GoalBar 放开为多行完整显示，编辑用 textarea，工具与数据仍走原生 goal。",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {