@deepseek-ai/dsh-client-ui-sidebar-documentpreview 0.1.7-rc.1 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -1,6 +1,46 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-sidebar-documentpreview/README.md
-README.md: 03e25deb27591fb5b8864b48a5a0b44da854eb54
-README.zh.md: d90d4932f210e9cff2275bdbadd5d35c1edea860
+/:
+  en: ef50065f5ff17aa1
+  zh: ee5d2b7986739fca
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview:
+  en: 5168e03d461318f5
+  zh: 7ad97d70ee331bfd
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/summary:
+  en: a74c16667d0baada
+  zh: 4fd709ff9f98b84f
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/table-of-contents:
+  en: 0dd8c3a22e28aacf
+  zh: c27c11bf4b5cceba
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/what-it-registers:
+  en: a8eaf01a3a3390ee
+  zh: ddea36dbcc4a0159
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/addresses:
+  en: 949156aa02ec8b07
+  zh: d3675754e2a37b5d
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/how-it-reads:
+  en: 5cdbd4a218315e70
+  zh: d5054f541e0e0275
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/excel-preview:
+  en: b99b0e0b8efc2853
+  zh: 4327352d1334fc6b
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/office-preview:
+  en: 372d8ce6492e6896
+  zh: 912f613bc9221aa3
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/navigation:
+  en: 5cd81a7b3cdc83bd
+  zh: 4cdd1b7ede497925
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/model-experience:
+  en: ca1deb99d0e44755
+  zh: f285fc56cee669ec
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/model-experience/kv-cache-effect:
+  en: 7edb4c0bb5f13847
+  zh: ae5d0bbebe4aa563
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/known-limitations-and-deferred-work:
+  en: 7be2ad2e198131f8
+  zh: 21b35eae72a49ad2
+/deepseek-ai-dsh-client-ui-sidebar-documentpreview/known-limitations-and-deferred-work/dev-note:
+  en: 3d8904cb970145a3
+  zh: a0c0cddcfedf9e42

package/README.md

@@ -46,7 +46,9 @@ After all text pages load, Markdown images use the authenticated `/api/file` rou
 <a id="how-it-reads"></a>
 ## How it reads
 
-Developer tools selects the HTML preview policy in both Web and desktop. The renderer receives `interactivePreview` from plugin assembly. Off uses a DOMPurify-sanitized complete static document in an iframe with no sandbox permissions: CSP blocks scripts, external resources, connections, forms, and nested frames; all `href` and `xlink:href` attributes, refresh directives, and declarative shadow roots are removed before reparsing. Inline styles and data images remain visible, and related files are not read. On uses the scripted Blob preview described below. A mode change unmounts the previous frame and aborts its pending related-file reads. Static preview releases CSS/JS resource subscriptions and keeps the root file watched. Other document formats retain their own policies.
+Coding Tools selects the HTML preview policy in both Web and desktop. The renderer receives `interactivePreview` from plugin assembly. Off uses a DOMPurify-sanitized complete static document in an iframe with no sandbox permissions: CSP blocks scripts, external resources, connections, forms, and nested frames; all `href` and `xlink:href` attributes, refresh directives, and declarative shadow roots are removed before reparsing. Inline styles and data images remain visible, and related files are not read. On uses the scripted Blob preview described below. A mode change unmounts the previous frame and aborts its pending related-file reads. Static preview releases CSS/JS resource subscriptions and keeps the root file watched. Other document formats retain their own policies.
+
+Both HTML modes set the initial iframe name to `dsh-sidebar-html-<tab-id>` for Desktop shortcut routing. This correlation does not grant the preview access to the parent document.
 
 The body reads its record, navigation and lifetime through `useTabInfo().tab`. `useResource<'file'>(tab.contentId)` supplies metadata; ordinary inject callbacks supply content reads:
 
@@ -55,22 +57,22 @@ The body reads its record, navigation and lifetime through `useTabInfo().tab`. `
 - **Complete bytes** — PDF, HTML, common images, and spreadsheets call `remote.workspaceFiles.readBytes(sessionId, path, {}, signal)`. The binary Remote returns `data: Uint8Array<ArrayBuffer>` directly for `{ kind: 'bytes', data }`. The Host's `maxFileBytes` cap rejects oversized files rather than truncating them. PDF and spreadsheet renderers copy retained bytes before Worker transfer, keeping the Preview buffer usable. Bytes stay in transient view state, never persisted layouts or Session JSONL. Loading-mode changes retire previous results.
 - **Reload** — manual reload rereads only the current Preview tab through its Remote callbacks, preserving its scroll preference and retiring older requests. Automatic refresh uses the same callbacks after a `ResourceGroup` member changes. Each member's first metadata establishes a baseline without triggering reload or first-read version reconciliation; later changes received during a read remain pending for another refresh. Reads neither refresh shared metadata nor clear another tab's notice.
 
-When Developer tools is enabled, HTML fills the body edge to edge in a Blob iframe with exactly `sandbox="allow-scripts"`, without `allow-same-origin`; scripts cannot access the parent application's origin or file reader. The renderer loads directly declared relative `.js` classic scripts and `.css` stylesheets through its injected Remote callback, with fixed safety limits of 4 MiB per asset, 32 MiB total, and 64 distinct assets. Host code resolves the related path, and `readBytes` with `baseFile` returns native bytes. The dependency Resource is added after the read returns, using its `absolutePath` or a string `error.details.path` on failure; without a Host path, the Client does not guess one. Inside the renderer, base64 is used only to embed the iframe bootstrap payload in script text. A `<base href>` leaves dependency resolution to the browser, as do HTTPS resources. Local module imports, CSS `url()`/`@import`, and dynamic `fetch` do not use Host file access. Read failures, invalid UTF-8, or exceeded limits fail the preview rather than publishing a partial asset package. Replacing or unmounting the document releases its Blob URL.
+When Coding Tools is enabled, HTML fills the body edge to edge in a Blob iframe with exactly `sandbox="allow-scripts"`, without `allow-same-origin`; scripts cannot access the parent application's origin or file reader. The renderer loads directly declared relative `.js` classic scripts and `.css` stylesheets through its injected Remote callback, with fixed safety limits of 4 MiB per asset, 32 MiB total, and 64 distinct assets. Host code resolves the related path, and `readBytes` with `baseFile` returns native bytes. The dependency Resource is added after the read returns, using its `absolutePath` or a string `error.details.path` on failure; without a Host path, the Client does not guess one. Inside the renderer, base64 is used only to embed the iframe bootstrap payload in script text. A `<base href>` leaves dependency resolution to the browser, as do HTTPS resources. Local module imports, CSS `url()`/`@import`, and dynamic `fetch` do not use Host file access. Read failures, invalid UTF-8, or exceeded limits fail the preview rather than publishing a partial asset package. Replacing or unmounting the document releases its Blob URL.
 
 PNG, JPEG, GIF, WebP, BMP, ICO, and SVG render through Blob URLs in an `<img>` static-image context, rounded inside a 12px inset. Images default to fit width without enlarging content smaller than the pane; 100% uses the image's intrinsic CSS-pixel width. The shared zoom controls can produce horizontal and vertical scrolling, but do not provide drag-to-pan. Zoom changes retain the same `<img>` and Blob URL, so animated images continue playing. Raster formats can soften above their intrinsic size, while SVG remains on the browser's vector rendering path. SVG markup never enters the application DOM or an iframe, so its scripts cannot execute or reach the parent page. Replacing or unmounting the image revokes its Blob URL.
 
-Shared copy comes from `sidebarDocumentPreview`; each builtin renderer owns its localized labels. PDF and converted Office previews use a graphite background in light mode and a matte-black background in dark mode, with subtle page shadows and original document colors. PDF and image previews share a floating control with **Fit width**, 25%, 50%, 100%, 150%, and 200% choices plus 25% incremental zoom across the 25%–400% fixed range. Fit width is the default and tracks pane resizing; 100% means the PDF's 96-DPI page size or the image's intrinsic CSS-pixel size. On fine pointers, the control starts hidden, slides up when the pointer enters the bottom 72 CSS pixels, and slides down after a 420 ms leave delay; hover, keyboard focus, an open menu, and an active gesture keep it visible, while devices without hover keep it visible continuously. Chromium maps a macOS trackpad pinch to the same live, pointer-anchored path as Ctrl+wheel; the control displays the gesture percentage, and the settled value survives body remounts until the tab closes. HTML previews do not expose zoom controls. After zoom settles or fit width changes, nearby PDF pages redraw at the resolved scale multiplied by the device pixel ratio. The previous bitmap and selectable text stay visible until the replacement bitmap is ready; offscreen pages refresh when they approach the viewport.
+Shared copy comes from `sidebarDocumentPreview`; each builtin renderer owns its localized labels. PDF and converted Office previews use a cool light-grey background in light mode and a matte-black background in dark mode, with subtle page shadows and original document colors. PDF and image previews share a floating control with **Fit width**, 25%, 50%, 100%, 150%, and 200% choices plus 25% incremental zoom across the 25%–400% fixed range. Fit width is the default and tracks pane resizing; 100% means the PDF's 96-DPI page size or the image's intrinsic CSS-pixel size. On fine pointers, the control starts hidden, slides up when the pointer enters the bottom 72 CSS pixels, and slides down after a 420 ms leave delay; hover, keyboard focus, an open menu, and an active gesture keep it visible, while devices without hover keep it visible continuously. Chromium maps a macOS trackpad pinch to the same live, pointer-anchored path as Ctrl+wheel; the control displays the gesture percentage, and the settled value survives body remounts until the tab closes. HTML previews do not expose zoom controls. After zoom settles or fit width changes, nearby PDF pages redraw at the resolved scale multiplied by the device pixel ratio. The previous bitmap and selectable text stay visible until the replacement bitmap is ready; offscreen pages refresh when they approach the viewport.
 
-Initial reads, additional pages, and HTML/PDF/image preparation share the ongoing `StateDot` loader, which exposes its label to assistive technology and respects reduced-motion preferences; every wait before content exists centres the loader in the pane, so opening a file shows one indicator in one position until the body appears. Loaded pages stay visible while another page loads. The PDF body loads its package-local `client.pdf.js` chunk only when a PDF preview mounts; PDF.js, its Worker source, and embedded support data stay out of the startup `client.js`. PDF pages fill the pane's width edge to edge as one vertical sequence and render lazily near the viewport; an unrendered page holds its place as a quiet 3:4 placeholder block. PDF.js’s official TextLayerBuilder manages selection boundaries and normalized copying over an aligned text layer. Its companion styles keep blank line breaks unhighlighted; alignment accounts for PDF page units, page rotation, and viewport resizing, and page disposal cancels both layers. Image-only PDFs contain no selectable text. Code previews show a tertiary-colored language label and a copy icon with a tooltip; wrapping remains in the document toolbar. They show source line numbers by default without including them in copied text; plain text uses the same font size and line height as code. Code sits on the pane's own background rather than the chat card's fill; its banner is adjacent to a full-height inner scrollport, so both scrollbars begin below the copy control.
+Initial reads and renderer preparation, including Office conversion, share a centered 28px ongoing `StateDot` with the visible localized status “Rendering document...”. The status exposes the same accessible name and respects reduced-motion preferences. Additional text pages keep a compact inline spinner while loaded content stays visible. The PDF body loads its package-local `client.pdf.js` chunk only when a PDF preview mounts; PDF.js, its Worker source, and embedded support data stay out of the startup `client.js`. PDF and converted Word/PowerPoint pages form a vertical sequence with 12px page gaps and a 12px outer inset showing the theme-specific document background; fit width reserves this inset, and pages render lazily near the viewport; an unrendered page holds its place as a quiet 3:4 placeholder block. PDF.js’s official TextLayerBuilder manages selection boundaries and normalized copying over an aligned text layer. Selections use translucent blue in both themes while the canvas retains the document text; blank line breaks remain unhighlighted; alignment accounts for PDF page units, page rotation, and viewport resizing, and page disposal cancels both layers. Image-only PDFs contain no selectable text. Code previews show a tertiary-colored language label and a copy icon with a tooltip; wrapping remains in the document toolbar. They show source line numbers by default without including them in copied text; plain text uses the same font size and line height as code. Code sits on the pane's own background rather than the chat card's fill; its banner is adjacent to a full-height inner scrollport, so both scrollbars begin below the copy control.
 
 <a id="excel-preview"></a>
 ## Excel preview
 
-Open `.xlsx`, `.xls`, `.csv`, and `.tsv` directly in the browser with worksheet tabs, cell selection, copying, and a read-only formula bar. XLSX retains fonts, solid fills, borders, number formats, rich text, merged cells, row and column sizes, hidden rows/columns/sheets, and frozen headings. XLS retains saved values, formulas, number formats, merges, and available row/column metadata; fonts, borders, and frozen panes are unsupported. Workbooks display saved formula results without recalculating; missing results remain blank, and a compact formula-bar warning marks workbooks whose displayed results may be incomplete or inaccurate. The workbook viewport fills the preview pane and follows its size changes without reloading its sheets or selection. Worksheet tabs start at the left edge; overflowing tabs scroll with horizontal trackpad gestures or left/right navigation beside a separate zoom control. Spreadsheet controls retain dark text on their light background in both app themes. Pixel-based trackpad gestures pan the grid on both axes together, including diagonally, at the gesture’s speed; frozen headings stay fixed. Selection statistics and inactive worksheet menu arrows are hidden. Frozen headings remain fixed while scrolling, without freeze dividers or drag handles. Spreadsheet preview does not call the Office conversion service.
+Open `.xlsx`, `.xls`, `.csv`, and `.tsv` directly in the browser with worksheet tabs, cell selection, copying, and a read-only formula bar. XLSX retains fonts, solid fills, borders, number formats, rich text, merged cells, row and column sizes, hidden rows/columns/sheets, and frozen headings. XLS retains saved values, formulas, number formats, merges, and available row/column metadata; fonts, borders, and frozen panes are unsupported. Workbooks display saved formula results without recalculating; missing results remain blank, and a compact formula-bar warning marks workbooks whose displayed results may be incomplete or inaccurate. The workbook viewport fills the preview pane and follows its size changes without reloading its sheets or selection. Worksheet tabs start at the left edge; overflowing tabs scroll with horizontal trackpad gestures or left/right navigation beside a separate zoom control. Spreadsheet controls retain dark text on their light background in both app themes. Pixel-based trackpad gestures pan the grid on both axes together, including diagonally, at the gesture’s speed; frozen headings stay fixed. Reversing direction at a sheet edge retains the next gesture’s movement. Selection statistics and inactive worksheet menu arrows are hidden. Frozen headings remain fixed while scrolling, without freeze dividers or drag handles. Spreadsheet preview does not call the Office conversion service.
 
 XLSX preview omits DrawingML parts from an in-memory copy before parsing and ignores worksheet drawing references. The original file and worksheet XML remain unchanged. A notice above the table lists detected charts, images, shapes, and conditional formatting that are not displayed, and recommends opening the workbook in a system application. Files without these detected features have no notice; formula warnings remain separate.
 
-CSV and TSV default to the spreadsheet viewer and also offer Plain text. Commas and tabs delimit their fields respectively; quoted separators, escaped quotes, multiline fields, empty fields, and unequal row lengths are supported. The first row remains data. Values remain literal strings, including leading zeros, dates, booleans, and formula-looking text. Text files accept UTF-8 or BOM-marked UTF-16; invalid encoding receives conversion guidance. Malformed quoted fields fail the table preview rather than silently dropping data.
+CSV and TSV default to the spreadsheet viewer and also offer Plain text; CSV additionally offers syntax-highlighted Code. Commas and tabs delimit their fields respectively; quoted separators, escaped quotes, multiline fields, empty fields, and unequal row lengths are supported. The first row remains data. Values remain literal strings, including leading zeros, dates, booleans, and formula-looking text. Text files accept UTF-8 or BOM-marked UTF-16; invalid encoding receives conversion guidance. Malformed quoted fields fail the table preview rather than silently dropping data.
 
 Configure `excel` on the same `ui-sidebar-documentpreview` entry. These limits complement the Host's complete-file read limit; they do not cap browser process memory or decompression allocations.
 
@@ -112,6 +114,8 @@ Office registration, loading, caching, and font notices live in `src/client/offi
 
 The Office Remote returns converted PDFs as native `Uint8Array` values through Connection's multipart binary transport. Renderers borrow retained bytes read-only and copy them before Worker transfer.
 
+The page refresh shortcut reuses the selected preview’s reload operation, including its request retirement and scroll retention. The header reload tooltip and ARIA combination follow the effective shortcut binding.
+
 </details>
 
 <a id="navigation"></a>

package/README.zh.md

@@ -46,7 +46,9 @@ tab 使用 `fileAddressFor` 构造的 Session 地址，携带相对或绝对路
 <a id="how-it-reads"></a>
 ## 怎么读
 
-Web 和桌面端均通过开发者工具选择 HTML 预览策略。渲染器从插件组装层接收 `interactivePreview`。关闭时，将经 DOMPurify 清理的完整静态文档放入不授予沙箱权限的 iframe：CSP 禁止脚本、外部资源、连接、表单和嵌套框架；所有 `href` 和 `xlink:href` 属性、刷新指令及声明式 Shadow DOM 均在重新解析前被移除。行内样式和 data 图片仍可显示，不读取关联文件。开启时使用下述支持脚本的 Blob 预览。切换模式会卸载之前的框架并中止其待处理关联文件读取。静态预览释放 CSS/JS 的 Resource 订阅，根文件继续监听。其他文档格式保持各自策略。
+Web 和桌面端均通过代码工作工具选择 HTML 预览策略。渲染器从插件组装层接收 `interactivePreview`。关闭时，将经 DOMPurify 清理的完整静态文档放入不授予沙箱权限的 iframe：CSP 禁止脚本、外部资源、连接、表单和嵌套框架；所有 `href` 和 `xlink:href` 属性、刷新指令及声明式 Shadow DOM 均在重新解析前被移除。行内样式和 data 图片仍可显示，不读取关联文件。开启时使用下述支持脚本的 Blob 预览。切换模式会卸载之前的框架并中止其待处理关联文件读取。静态预览释放 CSS/JS 的 Resource 订阅，根文件继续监听。其他文档格式保持各自策略。
+
+两种 HTML 模式均将 iframe 初始名称设为 `dsh-sidebar-html-<tab-id>`，供 Desktop 快捷键路由关联目标。这种关联不授予预览访问父文档的权限。
 
 正文通过 `useTabInfo().tab` 读取记录、导航和生命周期。`useResource<'file'>(tab.contentId)` 提供元数据，普通 inject 回调提供内容读取：
 
@@ -55,22 +57,22 @@ Web 和桌面端均通过开发者工具选择 HTML 预览策略。渲染器从
 - **完整字节** —— PDF、HTML、常见图片和表格调用 `remote.workspaceFiles.readBytes(sessionId, path, {}, signal)`。二进制 Remote 直接返回 `data: Uint8Array<ArrayBuffer>`，供 `{ kind: 'bytes', data }` 使用。Host 的 `maxFileBytes` 上限拒绝超大文件，不截断。PDF 和表格渲染器在传给 Worker 前复制保留的字节，使 Preview 缓冲区仍可使用。字节仅保存在临时视图状态中，绝不进入持久布局或 Session JSONL。加载模式变化会淘汰先前结果。
 - **重新载入** —— 手动重新载入仅让当前 Preview tab 通过自己的 Remote 回调重读，保留滚动偏好并淘汰旧请求。`ResourceGroup` 成员变化后，自动刷新使用相同回调。各成员首次元数据仅建立基线，不触发重新载入或首读版本对账；后续在读取期间收到的变化仍会留待下一次刷新。读取既不刷新共享元数据，也不清除其它 tab 的提示。
 
-开启开发者工具时，HTML 以贴合正文四边的 Blob iframe 运行，沙箱属性严格为 `sandbox="allow-scripts"`，不含 `allow-same-origin`；脚本无法访问父应用的源或文件读取接口。渲染器通过注入的 Remote 回调，加载直接声明的相对 `.js` 经典脚本和 `.css` 样式表；固定安全上限为单个资源 4 MiB、总计 32 MiB、64 个不同资源。Host 代码解析关联路径，带 `baseFile` 的 `readBytes` 返回原生字节。依赖 Resource 在读取返回后加入，使用返回的 `absolutePath`，失败时则使用字符串类型的 `error.details.path`；没有 Host 路径时，Client 不自行猜测。在渲染器内部，base64 仅用于把 iframe 引导载荷嵌入脚本文本。`<base href>` 将依赖解析交给浏览器，HTTPS 资源也由浏览器处理。本地模块 import、CSS `url()`/`@import` 和动态 `fetch` 不使用 Host 文件访问。读取失败、无效 UTF-8 或超出上限都使预览失败，不发布部分资源包。替换或卸载文档会释放其 Blob URL。
+开启代码工作工具时，HTML 以贴合正文四边的 Blob iframe 运行，沙箱属性严格为 `sandbox="allow-scripts"`，不含 `allow-same-origin`；脚本无法访问父应用的源或文件读取接口。渲染器通过注入的 Remote 回调，加载直接声明的相对 `.js` 经典脚本和 `.css` 样式表；固定安全上限为单个资源 4 MiB、总计 32 MiB、64 个不同资源。Host 代码解析关联路径，带 `baseFile` 的 `readBytes` 返回原生字节。依赖 Resource 在读取返回后加入，使用返回的 `absolutePath`，失败时则使用字符串类型的 `error.details.path`；没有 Host 路径时，Client 不自行猜测。在渲染器内部，base64 仅用于把 iframe 引导载荷嵌入脚本文本。`<base href>` 将依赖解析交给浏览器，HTTPS 资源也由浏览器处理。本地模块 import、CSS `url()`/`@import` 和动态 `fetch` 不使用 Host 文件访问。读取失败、无效 UTF-8 或超出上限都使预览失败，不发布部分资源包。替换或卸载文档会释放其 Blob URL。
 
 PNG、JPEG、GIF、WebP、BMP、ICO 和 SVG 通过 Blob URL 在 `<img>` 静态图片上下文中渲染，带 12px 内边距和圆角。图片默认适应宽度，但不会放大小于面板的内容；100% 使用图片的固有 CSS 像素宽度。共享缩放控件可产生横向和纵向滚动，但不提供拖拽平移。缩放不会替换 `<img>` 或 Blob URL，因此动画图片会继续播放。位图超过固有尺寸后可能变虚，SVG 则继续使用浏览器的矢量渲染路径。SVG 标记绝不进入应用 DOM 或 iframe，因此其中的脚本无法执行，也无法访问父页面。替换或卸载图片会撤销其 Blob URL。
 
-共享文案来自 `sidebarDocumentPreview`；各内置渲染器拥有自己的本地化标签。PDF 与转换后的 Office 预览在浅色模式下使用石墨灰底色，在深色模式下使用哑黑底色，页面带有轻微阴影并保留文档原色。PDF 与图片预览共用浮动控件，提供**适应宽度**、25%、50%、100%、150% 和 200% 选项，并在 25%–400% 固定范围内按 25% 逐级缩放。适应宽度是默认模式并跟随面板尺寸；100% 表示 PDF 的 96 DPI 页面尺寸或图片的固有 CSS 像素尺寸。在精细指针设备上，控件初始隐藏；指针进入底部 72 个 CSS 像素时向上滑入，离开 420 ms 后向下退出；控件悬停、键盘焦点、菜单展开和手势进行期间保持显示，无 hover 的设备则始终显示。Chromium 将 macOS 触控板捏合映射到与 Ctrl+滚轮相同的实时指针锚定路径；控件同步显示手势比例，静止后的值在正文重新挂载后继续保留，直至 tab 关闭。HTML 预览不显示缩放控件。缩放稳定或适应宽度发生变化后，视口附近的 PDF 页面按最终缩放比例乘以设备像素比重绘。新位图完成前保留原有画面和可选文字层；屏幕外的页面在接近视口时更新。
+共享文案来自 `sidebarDocumentPreview`；各内置渲染器拥有自己的本地化标签。PDF 与转换后的 Office 预览在浅色模式下使用冷调浅灰底色，在深色模式下使用哑黑底色，页面带有轻微阴影并保留文档原色。PDF 与图片预览共用浮动控件，提供**适应宽度**、25%、50%、100%、150% 和 200% 选项，并在 25%–400% 固定范围内按 25% 逐级缩放。适应宽度是默认模式并跟随面板尺寸；100% 表示 PDF 的 96 DPI 页面尺寸或图片的固有 CSS 像素尺寸。在精细指针设备上，控件初始隐藏；指针进入底部 72 个 CSS 像素时向上滑入，离开 420 ms 后向下退出；控件悬停、键盘焦点、菜单展开和手势进行期间保持显示，无 hover 的设备则始终显示。Chromium 将 macOS 触控板捏合映射到与 Ctrl+滚轮相同的实时指针锚定路径；控件同步显示手势比例，静止后的值在正文重新挂载后继续保留，直至 tab 关闭。HTML 预览不显示缩放控件。缩放稳定或适应宽度发生变化后，视口附近的 PDF 页面按最终缩放比例乘以设备像素比重绘。新位图完成前保留原有画面和可选文字层；屏幕外的页面在接近视口时更新。
 
-首次读取、追加页及 HTML/PDF/图片准备共用 ongoing `StateDot` loading，其标签暴露给辅助技术，并遵循减少动态效果偏好；内容出现前的每个等待都把 loading 居中在面板中，打开文件到正文出现始终是同一位置的一个标记。下一页加载期间保留已显示的内容。PDF 正文仅在 PDF 预览挂载时加载包内 `client.pdf.js` chunk；PDF.js、Worker 源码和内嵌支持数据不会进入启动 `client.js`。PDF 页面贴边占满面板宽度，组成一个纵向连续序列并在接近视口时惰性渲染；未渲染的页以安静的 3:4 占位块保持位置。PDF.js 官方 TextLayerBuilder 在与画面重合的文字层上管理选区边界和复制文本规范化。配套样式不高亮空白换行；对齐同时考虑 PDF 页面单位、页面旋转与视口宽度变化，页面释放时取消两层渲染。纯图片 PDF 不包含可选取的文字。代码预览使用 tertiary 色的语言名称和带提示的复制图标；换行仍由文档工具栏控制。默认显示源码行号，但复制文本不包含行号；纯文本与代码使用相同字号和行高。代码直接坐在分栏自身的背景上，而不是会话卡片的填充色；复制条与占满剩余高度的内部滚动区相邻，因此横纵滚动条都从复制控件下方开始。
+首次读取及渲染器准备（包括 Office 转换）共用居中的 28px ongoing `StateDot`，下方显示本地化状态文字“文档渲染中...”。状态向辅助技术提供相同的名称，并遵循减少动态效果偏好。追加文本页时使用紧凑的行内转圈，同时保留已显示的内容。PDF 正文仅在 PDF 预览挂载时加载包内 `client.pdf.js` chunk；PDF.js、Worker 源码和内嵌支持数据不会进入启动 `client.js`。PDF 与转换后的 Word/PowerPoint 页面组成纵向序列，页间距与四周留白均为 12px，露出当前主题的文档背景色；适应宽度会预留此留白，页面在接近视口时惰性渲染；未渲染的页以安静的 3:4 占位块保持位置。PDF.js 官方 TextLayerBuilder 在与画面重合的文字层上管理选区边界和复制文本规范化。两种主题均使用半透明蓝色选区，画布保留文档文字，空白换行不高亮；对齐同时考虑 PDF 页面单位、页面旋转与视口宽度变化，页面释放时取消两层渲染。纯图片 PDF 不包含可选取的文字。代码预览使用 tertiary 色的语言名称和带提示的复制图标；换行仍由文档工具栏控制。默认显示源码行号，但复制文本不包含行号；纯文本与代码使用相同字号和行高。代码直接坐在分栏自身的背景上，而不是会话卡片的填充色；复制条与占满剩余高度的内部滚动区相邻，因此横纵滚动条都从复制控件下方开始。
 
 <a id="excel-preview"></a>
 ## Excel 预览
 
-直接在浏览器中打开 `.xlsx`、`.xls`、`.csv` 和 `.tsv`，支持工作表标签、单元格选择、复制和只读公式栏。XLSX 保留字体、纯色填充、边框、数字格式、富文本、合并单元格、行列尺寸、隐藏行列及工作表，以及冻结标题。XLS 保留已保存的值、公式、数字格式、合并及可用的行列元数据；不支持字体、边框和冻结窗格。工作簿显示已保存的公式结果而不重新计算；缺少的结果保持为空，公式栏旁的紧凑提示会标记显示结果可能不完整或不准确的工作簿。工作簿视图填满预览面板，并随面板尺寸变化自动调整，无需重新加载工作表或选择状态。工作表标签从左侧边缘开始排列；标签溢出时可用触控板横向手势或左右按钮滚动，缩放控件独立占位。表格控件在应用的明暗两种主题下均保持浅色背景和深色文字。触控板的像素位移可同时平移表格的横纵两个方向，包括斜向平移，移动距离跟随手势；冻结标题保持固定。隐藏选区统计栏及无效的工作表菜单箭头。冻结标题在滚动时保持固定，不显示冻结分隔线和拖拽条。表格预览不调用 Office 转换服务。
+直接在浏览器中打开 `.xlsx`、`.xls`、`.csv` 和 `.tsv`，支持工作表标签、单元格选择、复制和只读公式栏。XLSX 保留字体、纯色填充、边框、数字格式、富文本、合并单元格、行列尺寸、隐藏行列及工作表，以及冻结标题。XLS 保留已保存的值、公式、数字格式、合并及可用的行列元数据；不支持字体、边框和冻结窗格。工作簿显示已保存的公式结果而不重新计算；缺少的结果保持为空，公式栏旁的紧凑提示会标记显示结果可能不完整或不准确的工作簿。工作簿视图填满预览面板，并随面板尺寸变化自动调整，无需重新加载工作表或选择状态。工作表标签从左侧边缘开始排列；标签溢出时可用触控板横向手势或左右按钮滚动，缩放控件独立占位。表格控件在应用的明暗两种主题下均保持浅色背景和深色文字。触控板的像素位移可同时平移表格的横纵两个方向，包括斜向平移，移动距离跟随手势；冻结标题保持固定。到达工作表边缘后反向移动，仍会保留下一次手势的位移。隐藏选区统计栏及无效的工作表菜单箭头。冻结标题在滚动时保持固定，不显示冻结分隔线和拖拽条。表格预览不调用 Office 转换服务。
 
 XLSX 预览在解析前从内存副本中移除 DrawingML 部件，并忽略工作表的绘图引用。原文件和工作表 XML 保持不变。表格上方的提示列出实际检测到但未展示的图表、图片、形状和条件格式，并建议使用系统应用打开工作簿。未检测到这些内容的文件不显示此提示；公式提示保持独立。
 
-CSV 和 TSV 默认使用表格查看器，也可选择纯文本。两者分别以逗号和制表符分隔字段，支持引号内分隔符、转义引号、多行字段、空字段和不等长行。首行仍作为数据。值保持为字面字符串，包括前导零、日期、布尔值和类似公式的文本。文本文件支持 UTF-8 或带 BOM 的 UTF-16；无效编码会显示转换提示。引号字段格式错误会使表格预览失败，不会静默丢弃数据。
+CSV 和 TSV 默认使用表格查看器，也可选择纯文本；CSV 还提供带语法高亮的 Code 预览。两者分别以逗号和制表符分隔字段，支持引号内分隔符、转义引号、多行字段、空字段和不等长行。首行仍作为数据。值保持为字面字符串，包括前导零、日期、布尔值和类似公式的文本。文本文件支持 UTF-8 或带 BOM 的 UTF-16；无效编码会显示转换提示。引号字段格式错误会使表格预览失败，不会静默丢弃数据。
 
 在同一个 `ui-sidebar-documentpreview` 条目上配置 `excel`。这些限制补充 Host 的完整文件读取限制，但不限制浏览器进程内存或解压分配量。
 
@@ -112,6 +114,8 @@ Office 注册、加载、缓存和字体提示位于 `src/client/office/`。注
 
 Office Remote 通过 Connection 的 multipart 二进制传输返回原生 `Uint8Array` PDF。渲染器以只读方式借用保留的字节，并在传给 Worker 前复制。
 
+页面刷新快捷键复用所选预览的重载操作，包括旧请求失效与滚动位置保留。头部重载 Tooltip 和 ARIA 组合随有效快捷键绑定更新。
+
 </details>
 
 <a id="navigation"></a>

package/lib/client.excel.js

@@ -28117,7 +28117,7 @@ window.__ModuleLoader__.load({
 			return stringify(rnds);
 		}
 		//#endregion
-		//#region ../../../node_modules/.pnpm/@fortune-sheet+core@1.0.4_patch_hash=886223a70a0cf76d4fa174608852763fe76bbdc9374db127665024c8c150dd68/node_modules/@fortune-sheet/core/dist/index.esm.js
+		//#region ../../../node_modules/.pnpm/@fortune-sheet+core@1.0.4_patch_hash=8791a230763dbf853fd65d627c68c31de37209992851377855e16cf08ea70532/node_modules/@fortune-sheet/core/dist/index.esm.js
 		function _arrayLikeToArray$1(r, a) {
 			(null == a || a > r.length) && (a = r.length);
 			for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
@@ -119987,6 +119987,8 @@ window.__ModuleLoader__.load({
 			if (ctx.allowEdit === false && e.deltaMode === 0) {
 				scrollbarX.scrollLeft += e.deltaX;
 				scrollbarY.scrollTop += e.deltaY;
+				ctx.scrollLeft = scrollbarX.scrollLeft;
+				ctx.scrollTop = scrollbarY.scrollTop;
 				e.preventDefault();
 				return;
 			}
@@ -133666,7 +133668,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/excel/ExcelBody.module.css.mjs
-		const css = "._3HaaOG_body{white-space:normal;height:100%;min-height:0;font-family:var(--dsw-font,sans-serif);flex-direction:column;display:flex;overflow:hidden}._3HaaOG_workbook{color-scheme:light;color:canvastext;flex:1;min-width:0;min-height:0;position:relative}._3HaaOG_workbook .fortune-stat-area,._3HaaOG_workbook .luckysheet-sheets-item-function,._3HaaOG_workbook .fortune-cols-freeze-handle,._3HaaOG_workbook .fortune-rows-freeze-handle{display:none}._3HaaOG_workbook .luckysheet-sheet-area div.luckysheet-sheets-item{padding-right:5px}._3HaaOG_workbook .luckysheet-sheet-area{padding:0}._3HaaOG_workbook #luckysheet-sheet-content{flex:1;min-width:0}._3HaaOG_workbook .fortune-sheettab-container{flex:1;min-width:0;max-width:100%}._3HaaOG_workbook .fortune-sheettab-container .fortune-sheettab-container-c{overscroll-behavior-x:contain;scrollbar-width:none;overflow:auto hidden}._3HaaOG_workbook .fortune-sheettab-scroll,._3HaaOG_workbook .fortune-sheet-area-right{flex:none}._3HaaOG_workbook .fortune-fx-input-container{min-width:0}._3HaaOG_workbook .fortune-fx-input{white-space:nowrap;scrollbar-width:none;min-width:0;overflow:auto hidden}._3HaaOG_notice{color:var(--dsw-alias-state-warn-label);background:var(--dsw-alias-state-warn-tertiary);font-size:var(--dsh-content-font-size-secondary,13px);overflow-wrap:anywhere;flex:none;align-items:flex-start;gap:8px;padding:8px 12px;line-height:1.5;display:flex}._3HaaOG_notice>svg{flex:none;margin-top:2px}._3HaaOG_formulaWarning{z-index:3;width:20px;height:20px;color:var(--dsw-alias-state-warn-label);background:0 0;border:0;border-radius:4px;padding:3px;display:flex;position:absolute;top:4px;left:142px}._3HaaOG_formulaWarning:hover,._3HaaOG_formulaWarning:focus-visible{background:var(--dsw-alias-state-warn-tertiary);outline:none}._3HaaOG_withFormulaWarning .fortune-fx-input{padding-left:24px}._3HaaOG_status{height:100%;color:var(--dsw-alias-label-secondary);justify-content:center;align-items:center;gap:8px;padding:16px;display:flex}";
+		const css = "._3HaaOG_body{white-space:normal;height:100%;min-height:0;font-family:var(--dsw-font,sans-serif);flex-direction:column;display:flex;overflow:hidden}._3HaaOG_workbook{color-scheme:light;color:canvastext;flex:1;min-width:0;min-height:0;position:relative}._3HaaOG_workbook .fortune-stat-area,._3HaaOG_workbook .luckysheet-sheets-item-function,._3HaaOG_workbook .fortune-cols-freeze-handle,._3HaaOG_workbook .fortune-rows-freeze-handle{display:none}._3HaaOG_workbook .luckysheet-sheet-area div.luckysheet-sheets-item{padding-right:5px}._3HaaOG_workbook .luckysheet-sheet-area{padding:0}._3HaaOG_workbook #luckysheet-sheet-content{flex:1;min-width:0}._3HaaOG_workbook .fortune-sheettab-container{flex:1;min-width:0;max-width:100%}._3HaaOG_workbook .fortune-sheettab-container .fortune-sheettab-container-c{overscroll-behavior-x:contain;scrollbar-width:none;overflow:auto hidden}._3HaaOG_workbook .fortune-sheettab-scroll,._3HaaOG_workbook .fortune-sheet-area-right{flex:none}._3HaaOG_workbook .fortune-fx-input-container{min-width:0}._3HaaOG_workbook .fortune-fx-input{white-space:nowrap;scrollbar-width:none;min-width:0;overflow:auto hidden}._3HaaOG_notice{color:var(--dsw-alias-state-warn-label);background:var(--dsw-alias-state-warn-tertiary);font-size:var(--dsh-content-font-size-secondary,13px);overflow-wrap:anywhere;flex:none;align-items:flex-start;gap:8px;padding:8px 12px;line-height:1.5;display:flex}._3HaaOG_notice>svg{flex:none;margin-top:2px}._3HaaOG_formulaWarning{z-index:3;width:20px;height:20px;color:var(--dsw-alias-state-warn-label);border-radius:var(--dsw-radius-sm);background:0 0;border:0;padding:3px;display:flex;position:absolute;top:4px;left:142px}._3HaaOG_formulaWarning:hover,._3HaaOG_formulaWarning:focus-visible{background:var(--dsw-alias-state-warn-tertiary);outline:none}._3HaaOG_withFormulaWarning .fortune-fx-input{padding-left:24px}._3HaaOG_status{height:100%;color:var(--dsw-alias-label-secondary);justify-content:center;align-items:center;gap:8px;padding:16px;display:flex}";
 		const tagId = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/ExcelBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -133693,7 +133695,7 @@ window.__ModuleLoader__.load({
 		* @param props - Complete workbook bytes, limits, and locale.
 		* @returns An isolated spreadsheet surface with cancellable loading.
 		*/
-		function ExcelBody({ content, format, limits, t }) {
+		function ExcelBody({ content, format, limits, t, loading }) {
 			const data = content.kind === "bytes" ? content.data : void 0;
 			const [state, setState] = (0, react.useState)();
 			const [attempt, setAttempt] = (0, react.useState)(0);
@@ -133740,13 +133742,7 @@ window.__ModuleLoader__.load({
 				role: "alert",
 				children: t("invalid")
 			});
-			if (state?.data !== data || state.format !== format) return (0, react_jsx_runtime.jsx)("span", {
-				className: ExcelBody_module_css_default.status,
-				role: "status",
-				"aria-label": t("loading"),
-				"data-document-loading": true,
-				children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "ongoing" })
-			});
+			if (state?.data !== data || state.format !== format) return loading;
 			if ("error" in state) return (0, react_jsx_runtime.jsxs)("div", {
 				className: ExcelBody_module_css_default.status,
 				role: "alert",

package/lib/client.js

@@ -132,12 +132,12 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* Address a decoded absolute file path through the authenticated file route.
-		* @param base - HTTP(S) application base, including its deployment prefix.
+		* @param base - HTTP(S) application base, including its deployment prefix, or `dsh-app://app/`.
 		* @param path - Native file path; URL escapes in authored Markdown must already be decoded.
 		* @returns File URL, or undefined for unsupported transports and non-absolute paths.
 		*/
 		function fileMediaUrl(base, path) {
-			if (!/^https?:/u.test(base) || !isAbsoluteWorkspacePath(path) || /^[/\\]{2}/u.test(path) || /[\u0000-\u001f\u007f]/u.test(path)) return void 0;
+			if (!/^https?:/u.test(base) && !base.startsWith("dsh-app://app/") || !isAbsoluteWorkspacePath(path) || /^[/\\]{2}/u.test(path) || /[\u0000-\u001f\u007f]/u.test(path)) return void 0;
 			return new URL(`api/file?path=${encodeURIComponent(path)}`, base).href;
 		}
 		//#endregion
@@ -181,7 +181,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/LoadingIndicator.module.css.mjs
-		const css$9 = ".tKrPPq_loading{vertical-align:middle;white-space:normal;align-items:center;gap:8px;display:inline-flex}";
+		const css$9 = ".tKrPPq_loading{box-sizing:border-box;width:100%;height:100%;min-height:0;color:var(--dsw-alias-label-secondary);font-family:var(--dsw-font,sans-serif);font-size:var(--dsh-content-font-size,14px);text-align:center;white-space:normal;flex-direction:column;justify-content:center;align-items:center;gap:12px;padding:24px;line-height:1.5;display:flex}.tKrPPq_inline{vertical-align:middle;flex-direction:row;gap:8px;width:auto;height:auto;padding:0;display:inline-flex}";
 		const tagId$9 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/LoadingIndicator.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$9) + "]") === null) {
 			const tag = document.createElement("style");
@@ -190,21 +190,26 @@ window.__ModuleLoader__.load({
 			tag.textContent = css$9;
 			document.head.appendChild(tag);
 		}
-		var LoadingIndicator_module_css_default = { "loading": "tKrPPq_loading" };
+		var LoadingIndicator_module_css_default = {
+			"inline": "tKrPPq_inline",
+			"loading": "tKrPPq_loading"
+		};
 		//#endregion
 		//#region lib/types/client/LoadingIndicator.js
 		/**
-		* @param props - localized status label, carried as the accessible name with
-		* no visible text, and optional placement style.
-		* @returns an animated, accessible loading status.
+		* @param props - localized status label and compact inline placement for additional pages.
+		* @returns a centered document loading status or an accessible inline spinner.
 		*/
-		function LoadingIndicator({ label, className }) {
-			return (0, react_jsx_runtime.jsx)("span", {
-				className: clsx(LoadingIndicator_module_css_default.loading, className),
+		function LoadingIndicator({ label, inline = false }) {
+			return (0, react_jsx_runtime.jsxs)("span", {
+				className: clsx(LoadingIndicator_module_css_default.loading, inline && LoadingIndicator_module_css_default.inline),
 				role: "status",
 				"aria-label": label,
 				"data-document-loading": true,
-				children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "ongoing" })
+				children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, {
+					state: "ongoing",
+					size: inline ? 14 : 28
+				}), !inline && (0, react_jsx_runtime.jsx)("span", { children: label })]
 			});
 		}
 		//#endregion
@@ -483,7 +488,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/TextPreview.module.css.mjs
-		const css$8 = ".dhJKeW_preview{flex-direction:column;flex:auto;height:100%;min-height:0;display:flex}.dhJKeW_header{box-sizing:border-box;border-bottom:.5px solid var(--dsw-alias-border-l3);flex:none;align-items:center;gap:4px;height:38px;padding:0 6px 0 16px;display:flex}.dhJKeW_path{margin-right:12px}.dhJKeW_changed{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2);border-bottom:.5px solid var(--dsw-alias-border-l1);flex:none;align-items:center;gap:10px;margin:0;padding:6px 10px;font-size:12px;display:flex}.dhJKeW_body{--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);min-height:0;color:var(--dsw-alias-label-primary);font-size:var(--dsh-content-font-size-secondary,13px);font-family:var(--dsw-font-mono,ui-monospace, monospace);white-space:pre;flex:auto;margin:0;padding:0;line-height:1.6;position:relative;overflow:auto}.dhJKeW_body::-webkit-scrollbar-track{margin:2px}.dhJKeW_body:has([data-code-preview]){flex-direction:column;display:flex;overflow:hidden}.dhJKeW_body:has([data-pdf-preview]){background:var(--dsw-alias-bg-document-preview)}.dhJKeW_wrap{white-space:pre-wrap;word-break:break-word}.dhJKeW_textDocument{box-sizing:border-box;min-width:100%;min-height:100%;padding:8px}.dhJKeW_page{font:var(--dsw-font-markdown-code-block);white-space:inherit;margin:0}.dhJKeW_line{padding:0 10px}.dhJKeW_lineTarget{background:var(--dsw-alias-interactive-bg-hover)}.dhJKeW_empty{box-sizing:border-box;height:100%;color:var(--dsw-alias-label-secondary);font-size:var(--dsh-content-font-size-secondary,13px);font-family:var(--dsw-font-family);text-align:center;white-space:normal;flex-direction:column;justify-content:center;align-items:center;gap:16px;padding:0 24px;line-height:1.6;display:flex}.dhJKeW_empty:after{content:\"\";flex:0 12%}.dhJKeW_emptyIcon{opacity:.6;filter:grayscale();flex:none}.dhJKeW_emptyLine{margin:0}.dhJKeW_retry{height:32px;color:var(--dsw-alias-label-primary);font-size:var(--dsh-content-font-size-secondary,13px);border:.5px solid var(--dsw-alias-border-l2);cursor:pointer;background:0 0;border-radius:16px;flex:none;align-items:center;gap:6px;padding:0 14px 0 12px;font-family:inherit;display:inline-flex}.dhJKeW_retry:hover{background:var(--dsw-alias-interactive-bg-hover)}.dhJKeW_titleIcon{flex:none}.dhJKeW_statusLine{color:var(--dsw-alias-label-secondary);font-size:var(--dsh-content-font-size-secondary,13px);white-space:normal;align-items:center;gap:10px;margin:0;padding:6px 10px;line-height:1.6;display:flex}.dhJKeW_status{box-sizing:border-box;flex-direction:column;justify-content:center;align-items:center;gap:8px;height:100%;padding:12px 10px;display:flex}.dhJKeW_bodyLoading{box-sizing:border-box;justify-content:center;width:100%;height:100%}.dhJKeW_action{color:var(--dsw-alias-label-primary);font-size:var(--dsh-content-font-size-secondary,13px);font-family:var(--dsw-font,inherit);white-space:normal;background:var(--dsw-alias-bg-layer-2);border:.5px solid var(--dsw-alias-border-l2);cursor:pointer;border-radius:6px;padding:4px 10px}.dhJKeW_action:hover{background:var(--dsw-alias-bg-layer-3)}.dhJKeW_more{color:var(--dsw-alias-label-secondary);font-size:12px;font-family:var(--dsw-font,inherit);white-space:normal;background:var(--dsw-alias-bg-layer-2);border:.5px solid var(--dsw-alias-border-l2);cursor:pointer;border-radius:6px;margin:8px 10px;padding:4px 10px;display:block}.dhJKeW_more:hover:not(:disabled){color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-3)}.dhJKeW_more:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}.dhJKeW_tool{width:28px;height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;border-radius:28px;flex:none;justify-content:center;align-items:center;padding:6px;line-height:1;display:inline-flex}.dhJKeW_tool svg{width:15px;height:15px}.dhJKeW_tool:hover,.dhJKeW_tool[data-textpreview-tool=auto-refresh][aria-pressed=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}.dhJKeW_viewerTool{width:auto;max-width:160px;color:var(--dsw-alias-label-secondary);white-space:nowrap;text-overflow:ellipsis;flex:none;padding:0 6px;font-size:12px;overflow:hidden}";
+		const css$8 = ".dhJKeW_preview{flex-direction:column;flex:auto;height:100%;min-height:0;display:flex}.dhJKeW_header{box-sizing:border-box;border-bottom:.5px solid var(--dsw-alias-border-l3);flex:none;align-items:center;gap:4px;height:38px;padding:0 6px 0 16px;display:flex}.dhJKeW_path{margin-right:12px}.dhJKeW_changed{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2);border-bottom:.5px solid var(--dsw-alias-border-l1);flex:none;align-items:center;gap:10px;margin:0;padding:6px 10px;font-size:12px;display:flex}.dhJKeW_body{--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);min-height:0;color:var(--dsw-alias-label-primary);font-size:var(--dsh-content-font-size-secondary,13px);font-family:var(--dsw-font-mono,ui-monospace, monospace);white-space:pre;flex:auto;margin:0;padding:0;line-height:1.6;position:relative;overflow:auto}.dhJKeW_body::-webkit-scrollbar-track{margin:2px}.dhJKeW_body:has([data-code-preview]){flex-direction:column;display:flex;overflow:hidden}.dhJKeW_body:has([data-pdf-preview]){background:var(--dsw-alias-bg-document-preview)}.dhJKeW_wrap{white-space:pre-wrap;word-break:break-word}.dhJKeW_textDocument{box-sizing:border-box;min-width:100%;min-height:100%;padding:8px}.dhJKeW_page{font:var(--dsw-font-markdown-code-block);white-space:inherit;margin:0}.dhJKeW_line{padding:0 10px}.dhJKeW_lineTarget{background:var(--dsw-alias-interactive-bg-hover)}.dhJKeW_empty{box-sizing:border-box;height:100%;color:var(--dsw-alias-label-secondary);font-size:var(--dsh-content-font-size-secondary,13px);font-family:var(--dsw-font-family);text-align:center;white-space:normal;flex-direction:column;justify-content:center;align-items:center;gap:16px;padding:0 24px;line-height:1.6;display:flex}.dhJKeW_empty:after{content:\"\";flex:0 12%}.dhJKeW_emptyIcon{opacity:.6;filter:grayscale();flex:none}.dhJKeW_emptyLine{margin:0}.dhJKeW_retry{height:32px;color:var(--dsw-alias-label-primary);font-size:var(--dsh-content-font-size-secondary,13px);border:.5px solid var(--dsw-alias-border-l2);border-radius:var(--dsw-radius-md);cursor:pointer;background:0 0;flex:none;align-items:center;gap:6px;padding:0 14px 0 12px;font-family:inherit;display:inline-flex}.dhJKeW_retry:hover{background:var(--dsw-alias-interactive-bg-hover)}.dhJKeW_titleIcon{flex:none}.dhJKeW_statusLine{color:var(--dsw-alias-label-secondary);font-size:var(--dsh-content-font-size-secondary,13px);white-space:normal;align-items:center;gap:10px;margin:0;padding:6px 10px;line-height:1.6;display:flex}.dhJKeW_status{box-sizing:border-box;flex-direction:column;justify-content:center;align-items:center;gap:8px;height:100%;padding:12px 10px;display:flex}.dhJKeW_action{color:var(--dsw-alias-label-primary);font-size:var(--dsh-content-font-size-secondary,13px);font-family:var(--dsw-font,inherit);white-space:normal;background:var(--dsw-alias-bg-layer-2);border:.5px solid var(--dsw-alias-border-l2);border-radius:var(--dsw-radius-sm);cursor:pointer;padding:4px 10px}.dhJKeW_action:hover{background:var(--dsw-alias-bg-layer-3)}.dhJKeW_more{color:var(--dsw-alias-label-secondary);font-size:12px;font-family:var(--dsw-font,inherit);white-space:normal;background:var(--dsw-alias-bg-layer-2);border:.5px solid var(--dsw-alias-border-l2);border-radius:var(--dsw-radius-sm);cursor:pointer;margin:8px 10px;padding:4px 10px;display:block}.dhJKeW_more:hover:not(:disabled){color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-3)}.dhJKeW_more:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}.dhJKeW_tool{width:28px;height:28px;color:var(--dsw-alias-label-secondary);border-radius:var(--dsw-radius-sm);cursor:pointer;background:0 0;border:none;flex:none;justify-content:center;align-items:center;padding:6px;line-height:1;display:inline-flex}.dhJKeW_tool svg{width:15px;height:15px}.dhJKeW_tool:hover,.dhJKeW_tool[data-textpreview-tool=auto-refresh][aria-pressed=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}.dhJKeW_viewerTool{width:auto;max-width:160px;color:var(--dsw-alias-label-secondary);white-space:nowrap;text-overflow:ellipsis;flex:none;padding:0 6px;font-size:12px;overflow:hidden}";
 		const tagId$8 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/TextPreview.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$8) + "]") === null) {
 			const tag = document.createElement("style");
@@ -495,7 +500,6 @@ window.__ModuleLoader__.load({
 		var TextPreview_module_css_default = {
 			"action": "dhJKeW_action",
 			"body": "dhJKeW_body",
-			"bodyLoading": "dhJKeW_bodyLoading",
 			"changed": "dhJKeW_changed",
 			"empty": "dhJKeW_empty",
 			"emptyIcon": "dhJKeW_emptyIcon",
@@ -732,6 +736,7 @@ window.__ModuleLoader__.load({
 				signal,
 				observedVersion
 			]);
+			(0, react.useEffect)(() => tab.actions.bindCommands({ refresh: reload }), [tab.actions, reload]);
 			(0, react.useEffect)(() => {
 				if (state?.autoRefresh && changed && current !== void 0 && !current.loading && meta.status === "live") reload();
 			}, [
@@ -819,10 +824,7 @@ window.__ModuleLoader__.load({
 				children: meta.status === "none" ? (0, react_jsx_runtime.jsx)("p", {
 					className: TextPreview_module_css_default.statusLine,
 					children: t("resourceUnavailable")
-				}) : (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-					className: TextPreview_module_css_default.statusLine,
-					label: t("loading")
-				})
+				}) : (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: t("loading") })
 			});
 			const next = loadedThrough + 1;
 			const { name } = pathPartsOf(displayPath);
@@ -935,6 +937,7 @@ window.__ModuleLoader__.load({
 							}),
 							(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
 								label: t("reload"),
+								shortcutKeys: tab.refreshShortcut?.keys,
 								side: "bottom",
 								delayMs: 500,
 								children: (0, react_jsx_runtime.jsx)("button", {
@@ -942,6 +945,7 @@ window.__ModuleLoader__.load({
 									className: TextPreview_module_css_default.tool,
 									"aria-label": t("reload"),
 									"data-textpreview-tool": "reload",
+									"aria-keyshortcuts": tab.refreshShortcut?.aria,
 									onClick: reload,
 									children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutlineRegular, {})
 								})
@@ -963,10 +967,7 @@ window.__ModuleLoader__.load({
 							if (mode === "text-pages" && current?.failure === void 0 && body.clientHeight > 0 && body.scrollTop + body.clientHeight >= body.scrollHeight - 1) loadNext();
 						},
 						children: [
-							mode !== "renderer" && !hasContent && current?.failure === void 0 && (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-								className: clsx(TextPreview_module_css_default.statusLine, TextPreview_module_css_default.bodyLoading),
-								label: t("loading")
-							}),
+							mode !== "renderer" && !hasContent && current?.failure === void 0 && (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: t("loading") }),
 							content !== void 0 && renderSlot("sidebar.right.tab.document", {
 								resourceAddress: tab.contentId,
 								content,
@@ -1021,7 +1022,10 @@ window.__ModuleLoader__.load({
 								disabled: current.loading,
 								"data-textpreview-more": true,
 								onClick: loadNext,
-								children: current.loading ? (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: t("loading") }) : t("loadMore")
+								children: current.loading ? (0, react_jsx_runtime.jsx)(LoadingIndicator, {
+									inline: true,
+									label: t("loading")
+								}) : t("loadMore")
 							})
 						]
 					})
@@ -1444,7 +1448,7 @@ window.__ModuleLoader__.load({
 		*/
 		/** Simplified Chinese dictionary and key-set source of truth. */
 		const zh$7 = {
-			loading: "正在读取…",
+			loading: "文档渲染中...",
 			loadMore: "加载更多",
 			changed: "文件已更新，当前显示为旧内容",
 			reloadNow: "重新载入",
@@ -1469,7 +1473,7 @@ window.__ModuleLoader__.load({
 		};
 		/** English dictionary, checked against the Chinese key set. */
 		const en$7 = {
-			loading: "Reading…",
+			loading: "Rendering document...",
 			loadMore: "Load more",
 			changed: "The file has changed, showing the previous content.",
 			reloadNow: "Reload",
@@ -1509,7 +1513,7 @@ window.__ModuleLoader__.load({
 		* @param base - document base URI, including any deployment prefix.
 		* @param documentPath - absolute source path reported by the Host, when available.
 		* @param destination - authored Markdown image URL; query and fragment are not filename components.
-		* @returns an HTTP(S) file URL, or undefined for unsupported or malformed destinations.
+		* @returns a Web or Desktop file URL, or undefined for unsupported or malformed destinations.
 		*/
 		function markdownImageUrl(base, documentPath, destination) {
 			const suffix = destination.search(/[?#]/u);
@@ -3940,7 +3944,7 @@ document.open();document.write(html);document.close();
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/html/HtmlBody.module.css.mjs
-		const css$6 = ".HyIruq_frame{background:var(--dsw-alias-bg-base);border:none;width:100%;height:100%;min-height:240px;display:block}.HyIruq_status{color:var(--dsw-alias-label-secondary);white-space:normal;margin:0;padding:10px}.HyIruq_opening{box-sizing:border-box;justify-content:center;width:100%;min-height:100%}";
+		const css$6 = ".HyIruq_frame{background:var(--dsw-alias-bg-base);border:none;width:100%;height:100%;min-height:240px;display:block}.HyIruq_status{color:var(--dsw-alias-label-secondary);white-space:normal;margin:0;padding:10px}";
 		const tagId$6 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/HtmlBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$6) + "]") === null) {
 			const tag = document.createElement("style");
@@ -3951,14 +3955,13 @@ document.open();document.write(html);document.close();
 		}
 		var HtmlBody_module_css_default = {
 			"frame": "HyIruq_frame",
-			"opening": "HyIruq_opening",
 			"status": "HyIruq_status"
 		};
 		//#endregion
 		//#region lib/types/client/html/HtmlBody.js
 		/** Static or interactive HTML in an opaque iframe, without parent application access. */
 		/** One mounted file owns its root Blob; replacing content also replaces the browsing context. */
-		function HtmlFrame({ data, resourceAddress, readRelated, addResource, setResources, signal, t }) {
+		function HtmlFrame({ data, resourceAddress, readRelated, addResource, setResources, signal, frameName, t }) {
 			const [frame, setFrame] = (0, react.useState)();
 			(0, react.useEffect)(() => {
 				const controller = new AbortController();
@@ -4001,16 +4004,14 @@ document.open();document.write(html);document.close();
 				setResources,
 				signal
 			]);
-			if (frame?.data !== data || frame.readRelated !== readRelated) return (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-				className: clsx(HtmlBody_module_css_default.status, HtmlBody_module_css_default.opening),
-				label: t("loading")
-			});
+			if (frame?.data !== data || frame.readRelated !== readRelated) return (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: t("loading") });
 			if (frame.url === void 0) return (0, react_jsx_runtime.jsx)("p", {
 				className: HtmlBody_module_css_default.status,
 				role: "alert",
 				children: t("failed")
 			});
 			return (0, react_jsx_runtime.jsx)("iframe", {
+				name: frameName,
 				className: HtmlBody_module_css_default.frame,
 				src: frame.url,
 				sandbox: "allow-scripts",
@@ -4030,8 +4031,10 @@ document.open();document.write(html);document.close();
 				if (!interactivePreview) setResources([]);
 			}, [interactivePreview, setResources]);
 			if (content.kind !== "bytes") return null;
+			const frameName = `dsh-sidebar-html-${tab.id}`;
 			if (!interactivePreview) return (0, react_jsx_runtime.jsx)(BasicHtmlFrame, {
 				data: content.data,
+				frameName,
 				t
 			});
 			return (0, react_jsx_runtime.jsx)(HtmlFrame, {
@@ -4039,13 +4042,14 @@ document.open();document.write(html);document.close();
 				resourceAddress,
 				readRelated,
 				signal: tab.signal,
+				frameName,
 				addResource,
 				setResources,
 				t
 			}, resourceAddress);
 		}
 		/** Static preview mounts a separate browsing context so a mode change retires running scripts. */
-		function BasicHtmlFrame({ data, t }) {
+		function BasicHtmlFrame({ data, frameName, t }) {
 			const html = (0, react.useMemo)(() => {
 				try {
 					return createBasicHtmlDocument(data);
@@ -4059,6 +4063,7 @@ document.open();document.write(html);document.close();
 				children: t("failed")
 			});
 			return (0, react_jsx_runtime.jsx)("iframe", {
+				name: frameName,
 				className: HtmlBody_module_css_default.frame,
 				srcDoc: html,
 				sandbox: "",
@@ -4072,14 +4077,14 @@ document.open();document.write(html);document.close();
 		const zh$5 = {
 			title: "HTML",
 			frame: "HTML 文档预览",
-			loading: "正在读取…",
+			loading: "文档渲染中...",
 			failed: "无法预览这份 HTML 文档"
 		};
 		/** English dictionary with the same keys as the Chinese dictionary. */
 		const en$5 = {
 			title: "HTML",
 			frame: "HTML document preview",
-			loading: "Reading…",
+			loading: "Rendering document...",
 			failed: "This HTML document could not be previewed."
 		};
 		//#endregion
@@ -4193,7 +4198,7 @@ document.open();document.write(html);document.close();
 		const DEFAULT_ZOOM = FIT_WIDTH;
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/zoom/ZoomControls.module.css.mjs
-		const css$5 = ".lyqg2a_panel{z-index:2;inset-inline-start:50%;box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);opacity:0;pointer-events:none;will-change:opacity, transform;border-radius:12px;align-items:center;gap:2px;padding:4px 6px;font-size:12px;line-height:18px;transition:opacity .16s ease-in,transform .16s cubic-bezier(.4,0,1,1);display:flex;position:absolute;bottom:14px;transform:translate(-50%,16px)scale(.98);box-shadow:0 8px 24px light-dark(#0000001a,#00000060),0 2px 5px light-dark(#00000009,#00000035)}.lyqg2a_visible{opacity:1;pointer-events:auto;transition:opacity .14s ease-out,transform .18s cubic-bezier(.22,1,.36,1);transform:translate(-50%)scale(1)}.lyqg2a_controlAnchor{display:flex}.lyqg2a_zoomButton{flex:none;width:28px;padding:0}.lyqg2a_percent{font-variant-numeric:tabular-nums;justify-content:center;align-items:center;gap:2px;min-width:58px;padding-inline:6px;display:inline-flex}.lyqg2a_zoomMenu{min-width:112px}@media (hover:none),(pointer:coarse){.lyqg2a_panel{opacity:1;pointer-events:auto;transform:translate(-50%)scale(1)}}@media (prefers-reduced-motion:reduce){.lyqg2a_panel,.lyqg2a_visible{transition-duration:.01ms}}";
+		const css$5 = ".lyqg2a_panel{z-index:2;inset-inline-start:50%;box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l3);border-radius:var(--dsw-radius-lg);color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);opacity:0;pointer-events:none;will-change:opacity, transform;align-items:center;gap:2px;padding:4px 6px;font-size:12px;line-height:18px;transition:opacity .16s ease-in,transform .16s cubic-bezier(.4,0,1,1);display:flex;position:absolute;bottom:14px;transform:translate(-50%,16px)scale(.98);box-shadow:0 8px 24px light-dark(#0000001a,#00000060),0 2px 5px light-dark(#00000009,#00000035)}.lyqg2a_visible{opacity:1;pointer-events:auto;transition:opacity .14s ease-out,transform .18s cubic-bezier(.22,1,.36,1);transform:translate(-50%)scale(1)}.lyqg2a_controlAnchor{display:flex}.lyqg2a_zoomButton{flex:none;width:28px;padding:0}.lyqg2a_percent{font-variant-numeric:tabular-nums;justify-content:center;align-items:center;gap:2px;min-width:58px;padding-inline:6px;display:inline-flex}.lyqg2a_zoomMenu{min-width:112px}@media (hover:none),(pointer:coarse){.lyqg2a_panel{opacity:1;pointer-events:auto;transform:translate(-50%)scale(1)}}@media (prefers-reduced-motion:reduce){.lyqg2a_panel,.lyqg2a_visible{transition-duration:.01ms}}";
 		const tagId$5 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/ZoomControls.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$5) + "]") === null) {
 			const tag = document.createElement("style");
@@ -4607,7 +4612,7 @@ document.open();document.write(html);document.close();
 		const zoomSurfaceClass = ZoomViewport_module_css_default.surface;
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/image/ImageBody.module.css.mjs
-		const css$3 = ".JFRUHG_frame{box-sizing:border-box;width:100%;min-width:100%;height:max-content;min-height:100%;font-family:var(--dsw-font,sans-serif);white-space:normal;padding:12px;display:flex}.JFRUHG_surface{flex:none;max-width:none;margin:auto;display:block}.JFRUHG_surface[hidden]{display:none}.JFRUHG_image{user-select:none;border-radius:8px;width:100%;max-width:none;height:auto;max-height:none;display:block}.JFRUHG_status{box-sizing:border-box;width:100%;min-height:100%;color:var(--dsw-alias-label-secondary);white-space:normal;justify-content:center;align-items:center;margin:0;padding:10px;font-size:13px;line-height:1.5;display:flex}";
+		const css$3 = ".JFRUHG_frame{box-sizing:border-box;width:100%;min-width:100%;height:max-content;min-height:100%;font-family:var(--dsw-font,sans-serif);white-space:normal;padding:12px;display:flex}.JFRUHG_frame:has([data-document-loading]){height:100%}.JFRUHG_surface{flex:none;max-width:none;margin:auto;display:block}.JFRUHG_surface[hidden]{display:none}.JFRUHG_image{border-radius:var(--dsw-radius-md);user-select:none;width:100%;max-width:none;height:auto;max-height:none;display:block}.JFRUHG_status{box-sizing:border-box;width:100%;min-height:100%;color:var(--dsw-alias-label-secondary);white-space:normal;justify-content:center;align-items:center;margin:0;padding:10px;font-size:13px;line-height:1.5;display:flex}";
 		const tagId$3 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/ImageBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$3) + "]") === null) {
 			const tag = document.createElement("style");
@@ -4695,10 +4700,7 @@ document.open();document.write(html);document.close();
 				role: "alert",
 				children: t("unsupported")
 			});
-			if (source?.data !== data || source.mediaType !== mediaType) return (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-				className: ImageBody_module_css_default.status,
-				label: t("loading")
-			});
+			if (source?.data !== data || source.mediaType !== mediaType) return (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: t("loading") });
 			if (source.kind === "failed") return (0, react_jsx_runtime.jsx)("p", {
 				className: ImageBody_module_css_default.status,
 				role: "alert",
@@ -4740,10 +4742,7 @@ document.open();document.write(html);document.close();
 					className: ImageBody_module_css_default.frame,
 					"data-image-preview": true,
 					children: [
-						state === "loading" && (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-							className: ImageBody_module_css_default.status,
-							label: t("loading")
-						}),
+						state === "loading" && (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: t("loading") }),
 						state === "failed" && (0, react_jsx_runtime.jsx)("p", {
 							className: ImageBody_module_css_default.status,
 							role: "alert",
@@ -4801,7 +4800,7 @@ document.open();document.write(html);document.close();
 			...zoomZh,
 			title: "图片",
 			preview: "图片预览：{name}",
-			loading: "正在读取…",
+			loading: "文档渲染中...",
 			failed: "无法显示这张图片",
 			unsupported: "图片预览需要完整文件内容"
 		};
@@ -4810,7 +4809,7 @@ document.open();document.write(html);document.close();
 			...zoomEn,
 			title: "Image",
 			preview: "Image preview: {name}",
-			loading: "Reading…",
+			loading: "Rendering document...",
 			failed: "This image could not be displayed.",
 			unsupported: "Image preview requires the complete file contents."
 		};
@@ -4888,12 +4887,13 @@ document.open();document.write(html);document.close();
 		* @returns the deferred PDF renderer.
 		*/
 		function LazyPdfBody(props) {
+			const loading = (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: props.t("loading") });
 			return (0, react_jsx_runtime.jsx)(react.Suspense, {
-				fallback: (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-					className: TextPreview_module_css_default.status,
-					label: props.t("loading")
-				}),
-				children: (0, react_jsx_runtime.jsx)(LoadedPdfBody, { ...props })
+				fallback: loading,
+				children: (0, react_jsx_runtime.jsx)(LoadedPdfBody, {
+					...props,
+					loading
+				})
 			});
 		}
 		//#endregion
@@ -4937,7 +4937,7 @@ document.open();document.write(html);document.close();
 			...zoomZh,
 			title: "PDF",
 			pageImage: "PDF 第 {page} 页",
-			loading: "正在读取…",
+			loading: "文档渲染中...",
 			rendering: "正在绘制页面…",
 			failed: "无法显示 PDF：{message}",
 			password: "此 PDF 需要密码，暂不支持预览",
@@ -4950,7 +4950,7 @@ document.open();document.write(html);document.close();
 			...zoomEn,
 			title: "PDF",
 			pageImage: "PDF page {page}",
-			loading: "Reading…",
+			loading: "Rendering document...",
 			rendering: "Rendering page…",
 			failed: "Cannot display PDF: {message}",
 			password: "This PDF requires a password; password-protected previews are not supported.",
@@ -5102,7 +5102,7 @@ document.open();document.write(html);document.close();
 		/** Office preview copy and Host render configuration guidance. */
 		const zh$1 = {
 			title: "Office 文档",
-			loading: "正在读取…",
+			loading: "文档渲染中...",
 			retry: "重试",
 			viewMissingFonts: "缺失 {count} 种字体，点击查看",
 			missingFontsTitle: "缺失的字体",
@@ -5120,7 +5120,7 @@ document.open();document.write(html);document.close();
 		/** English translations checked against the Chinese key set. */
 		const en$1 = {
 			title: "Office document",
-			loading: "Reading…",
+			loading: "Rendering document...",
 			retry: "Retry",
 			viewMissingFonts: "Missing fonts: {count}. Click to view.",
 			missingFontsTitle: "Missing fonts",
@@ -5394,10 +5394,7 @@ document.open();document.write(html);document.close();
 					]
 				});
 			}
-			if (file === void 0) return (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-				className: TextPreview_module_css_default.statusLine,
-				label: t("loading")
-			});
+			if (file === void 0) return (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: t("loading") });
 			return (0, react_jsx_runtime.jsx)("div", {
 				className: OfficeBody_module_css_default.body,
 				children: props.renderSlot("sidebar.right.tab.document.office.pdf", {
@@ -5418,7 +5415,7 @@ document.open();document.write(html);document.close();
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/office/FontNotice.module.css.mjs
-		const css = ".JqwYuG_anchor{flex:none;display:inline-flex}.JqwYuG_anchor .JqwYuG_warning,.JqwYuG_anchor .JqwYuG_warning:hover{color:var(--dsw-alias-state-warn-label)}.JqwYuG_anchor .JqwYuG_warning:hover,.JqwYuG_anchor .JqwYuG_warning[aria-expanded=true]{background:var(--dsw-alias-state-warn-tertiary)}.JqwYuG_panel{--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);z-index:100;box-sizing:border-box;width:min(340px,100vw - 24px);max-height:calc(100dvh - 24px);color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-2);box-shadow:var(--dsw-elevation-prominent);border:0;border-radius:12px;padding:16px;font-size:13px;line-height:1.6;position:fixed;overflow:auto}.JqwYuG_panelHeader{justify-content:space-between;align-items:center;gap:12px;display:flex}.JqwYuG_panelHeader h3{margin:0;font-size:14px;font-weight:600}.JqwYuG_description{color:var(--dsw-alias-label-secondary);margin:8px 0 16px}.JqwYuG_count{color:var(--dsw-alias-label-tertiary);margin:0 0 6px;font-size:12px}.JqwYuG_fonts{overflow-wrap:anywhere;margin:0;padding:0;list-style:none}.JqwYuG_fonts li{border-top:.5px solid var(--dsw-alias-border-l2);padding:8px 0}";
+		const css = ".JqwYuG_anchor{flex:none;display:inline-flex}.JqwYuG_anchor .JqwYuG_warning,.JqwYuG_anchor .JqwYuG_warning:hover{color:var(--dsw-alias-state-warn-label)}.JqwYuG_anchor .JqwYuG_warning:hover,.JqwYuG_anchor .JqwYuG_warning[aria-expanded=true]{background:var(--dsw-alias-state-warn-tertiary)}.JqwYuG_panel{--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);z-index:100;box-sizing:border-box;width:min(340px,100vw - 24px);max-height:calc(100dvh - 24px);color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-2);border-radius:var(--dsw-radius-lg);box-shadow:var(--dsw-elevation-prominent);border:0;padding:16px;font-size:13px;line-height:1.6;position:fixed;overflow:auto}.JqwYuG_panelHeader{justify-content:space-between;align-items:center;gap:12px;display:flex}.JqwYuG_panelHeader h3{margin:0;font-size:14px;font-weight:600}.JqwYuG_description{color:var(--dsw-alias-label-secondary);margin:8px 0 16px}.JqwYuG_count{color:var(--dsw-alias-label-tertiary);margin:0 0 6px;font-size:12px}.JqwYuG_fonts{overflow-wrap:anywhere;margin:0;padding:0;list-style:none}.JqwYuG_fonts li{border-top:.5px solid var(--dsw-alias-border-l2);padding:8px 0}";
 		const tagId = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/FontNotice.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -5798,14 +5795,13 @@ document.open();document.write(html);document.close();
 		*/
 		function LazyExcelBody(props) {
 			const format = excelFormat(hostFileOf(props.resourceAddress).path);
+			const loading = (0, react_jsx_runtime.jsx)(LoadingIndicator, { label: props.t("loading") });
 			return (0, react_jsx_runtime.jsx)(react.Suspense, {
-				fallback: (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-					className: TextPreview_module_css_default.status,
-					label: props.t("loading")
-				}),
+				fallback: loading,
 				children: (0, react_jsx_runtime.jsx)(LoadedExcelBody, {
 					...props,
-					format
+					format,
+					loading
 				})
 			});
 		}
@@ -5815,7 +5811,7 @@ document.open();document.write(html);document.close();
 		const zh = {
 			title: "表格",
 			language: "zh",
-			loading: "正在打开表格…",
+			loading: "文档渲染中...",
 			invalid: "无法打开此表格。请检查文件格式、内容或密码保护。",
 			tooLarge: "此表格超过预览大小限制。",
 			timeout: "打开表格超时。请缩小文件后重试。",
@@ -5833,7 +5829,7 @@ document.open();document.write(html);document.close();
 		const en = {
 			title: "Spreadsheet",
 			language: "en",
-			loading: "Opening spreadsheet…",
+			loading: "Rendering document...",
 			invalid: "This spreadsheet could not be opened. Check its format, contents, or password protection.",
 			tooLarge: "This workbook exceeds the preview size limit.",
 			timeout: "Opening this workbook timed out. Try a smaller file.",
@@ -6862,9 +6858,9 @@ document.open();document.write(html);document.close();
 			apply$6(ctx);
 			apply$5(ctx);
 			apply$4(ctx);
-			apply$3(ctx);
 			apply$2(ctx, config.office);
 			apply$1(ctx, config.excel);
+			apply$3(ctx);
 		}
 		//#endregion
 		exports.apply = apply;

package/lib/client.pdf.js

@@ -32376,7 +32376,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/pdf/PdfBody.module.css.mjs
-		const css = ".E0GbtG_body{box-sizing:border-box;background:var(--dsw-alias-bg-document-preview);width:100%;min-width:100%;min-height:0;font-family:var(--dsw-font,sans-serif);white-space:normal;flex-direction:column;display:flex;overflow:visible}.E0GbtG_page{box-sizing:border-box;width:100%;min-width:0;overflow-x:visible}.E0GbtG_placeholder{aspect-ratio:3/4;background:var(--dsw-alias-bg-skeleton);width:100%}.E0GbtG_canvas{width:100%;max-width:none;height:auto;margin-inline:auto;display:block}.E0GbtG_surface{max-width:none;box-shadow:var(--dsw-elevation-prominent);margin-inline:auto;position:relative}.E0GbtG_surface[hidden]{display:none}.E0GbtG_text{position:absolute;inset:0;overflow:clip}.E0GbtG_text .textLayer{text-align:initial;letter-spacing:normal;word-spacing:normal;text-size-adjust:none;forced-color-adjust:none;transform-origin:0 0;caret-color:canvastext;z-index:0;--text-scale-factor:calc(var(--total-scale-factor) * var(--min-font-size));--min-font-size-inv:calc(1 / var(--min-font-size));line-height:1;position:absolute;inset:0;overflow:clip}.E0GbtG_text .textLayer[data-main-rotation=\"90\"]{transform:rotate(90deg)translateY(-100%)}.E0GbtG_text .textLayer[data-main-rotation=\"180\"]{transform:rotate(180deg)translate(-100%,-100%)}.E0GbtG_text .textLayer[data-main-rotation=\"270\"]{transform:rotate(270deg)translate(-100%)}.E0GbtG_text :is(span,br){color:#0000;white-space:pre;cursor:text;transform-origin:0 0;user-select:text;position:absolute}.E0GbtG_text .textLayer>:not(.markedContent),.E0GbtG_text .markedContent span:not(.markedContent){z-index:1;--font-height:0;--scale-x:1;--rotate:0deg;font-size:calc(var(--text-scale-factor) * var(--font-height));transform:rotate(var(--rotate)) scaleX(var(--scale-x)) scale(var(--min-font-size-inv))}.E0GbtG_text .markedContent{display:contents}.E0GbtG_text ::selection{background:var(--dsw-alias-interactive-bg-hover-accent);color:#0000}.E0GbtG_text br::selection{background:0 0}.E0GbtG_text .textLayer .endOfContent{z-index:0;cursor:default;user-select:none;display:block;position:absolute;inset:100% 0 0}.E0GbtG_text .selecting .endOfContent{top:0}.E0GbtG_status{color:var(--dsw-alias-label-secondary);align-items:center;gap:8px;padding:10px;font-size:13px;line-height:1.5;display:flex}.E0GbtG_body .E0GbtG_status{color:var(--dsw-alias-label-document-preview)}.E0GbtG_opening{box-sizing:border-box;justify-content:center;width:100%;min-height:100%}";
+		const css = ".E0GbtG_body{box-sizing:border-box;background:var(--dsw-alias-bg-document-preview);width:100%;min-width:100%;min-height:100%;font-family:var(--dsw-font,sans-serif);white-space:normal;flex-direction:column;gap:12px;padding:12px;display:flex;overflow:visible}[data-document-zoom-mode=fixed] .E0GbtG_body{width:max-content}.E0GbtG_page{box-sizing:border-box;width:100%;min-width:0;overflow-x:visible}.E0GbtG_placeholder{aspect-ratio:3/4;background:var(--dsw-alias-bg-skeleton);width:100%}.E0GbtG_canvas{width:100%;max-width:none;height:auto;margin-inline:auto;display:block}.E0GbtG_surface{max-width:none;box-shadow:var(--dsw-elevation-prominent);margin-inline:auto;position:relative}.E0GbtG_surface[hidden]{display:none}.E0GbtG_text{position:absolute;inset:0;overflow:clip}.E0GbtG_text .textLayer{text-align:initial;letter-spacing:normal;word-spacing:normal;text-size-adjust:none;forced-color-adjust:none;transform-origin:0 0;caret-color:canvastext;z-index:0;--text-scale-factor:calc(var(--total-scale-factor) * var(--min-font-size));--min-font-size-inv:calc(1 / var(--min-font-size));line-height:1;position:absolute;inset:0;overflow:clip}.E0GbtG_text .textLayer[data-main-rotation=\"90\"]{transform:rotate(90deg)translateY(-100%)}.E0GbtG_text .textLayer[data-main-rotation=\"180\"]{transform:rotate(180deg)translate(-100%,-100%)}.E0GbtG_text .textLayer[data-main-rotation=\"270\"]{transform:rotate(270deg)translate(-100%)}.E0GbtG_text :is(span,br){color:#0000;white-space:pre;cursor:text;transform-origin:0 0;user-select:text;position:absolute}.E0GbtG_text .textLayer>:not(.markedContent),.E0GbtG_text .markedContent span:not(.markedContent){z-index:1;--font-height:0;--scale-x:1;--rotate:0deg;font-size:calc(var(--text-scale-factor) * var(--font-height));transform:rotate(var(--rotate)) scaleX(var(--scale-x)) scale(var(--min-font-size-inv))}.E0GbtG_text .markedContent{display:contents}.E0GbtG_text ::selection{background:var(--dsw-alias-bg-document-selection);color:#0000}.E0GbtG_text br::selection{background:0 0}.E0GbtG_text .textLayer .endOfContent{z-index:0;cursor:default;user-select:none;display:block;position:absolute;inset:100% 0 0}.E0GbtG_text .selecting .endOfContent{top:0}.E0GbtG_status{color:var(--dsw-alias-label-secondary);align-items:center;gap:8px;padding:10px;font-size:13px;line-height:1.5;display:flex}.E0GbtG_body .E0GbtG_status{color:var(--dsw-alias-label-document-preview)}";
 		const tagId = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/PdfBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -32388,7 +32388,6 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		var PdfBody_module_css_default = {
 			"body": "E0GbtG_body",
 			"canvas": "E0GbtG_canvas",
-			"opening": "E0GbtG_opening",
 			"page": "E0GbtG_page",
 			"placeholder": "E0GbtG_placeholder",
 			"status": "E0GbtG_status",
@@ -32402,7 +32401,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		const FIT_WIDTH = { kind: "fit-width" };
 		/**
 		* Present a PDF with tab-local viewing preferences and component-owned rendering resources.
-		* @param props - complete bytes and framework-owned tab/store/locale seats.
+		* @param props - complete bytes, framework-owned tab/store/locale seats, and main-bundle loading content.
 		* @returns the PDF reader.
 		*/
 		function PdfBody(props) {
@@ -32475,13 +32474,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				role: "alert",
 				children: t("unsupported")
 			});
-			if (load?.data !== data) return (0, react_jsx_runtime.jsx)("span", {
-				className: `${PdfBody_module_css_default.status} ${PdfBody_module_css_default.opening}`,
-				role: "status",
-				"aria-label": t("loading"),
-				"data-document-loading": true,
-				children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "ongoing" })
-			});
+			if (load?.data !== data) return props.loading;
 			if (load.kind === "failed") return (0, react_jsx_runtime.jsxs)("div", {
 				className: PdfBody_module_css_default.status,
 				role: "alert",
@@ -32511,6 +32504,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 			return (0, react_jsx_runtime.jsx)(ZoomViewport, {
 				preference,
 				intrinsicWidth: pageWidth,
+				horizontalInset: 24,
 				labels,
 				signal: tab.signal,
 				scrollportRef: props.scrollportRef,

package/lib/types/client/LoadingIndicator.d.ts

@@ -1,12 +1,11 @@
 /** Shared indeterminate loading feedback for document reads and rendering. */
 import type { ReactNode } from 'react';
 /**
- * @param props - localized status label, carried as the accessible name with
- * no visible text, and optional placement style.
- * @returns an animated, accessible loading status.
+ * @param props - localized status label and compact inline placement for additional pages.
+ * @returns a centered document loading status or an accessible inline spinner.
  */
-export declare function LoadingIndicator({ label, className }: {
+export declare function LoadingIndicator({ label, inline }: {
     label: string;
-    className?: string | undefined;
+    inline?: boolean;
 }): ReactNode;
 //# sourceMappingURL=LoadingIndicator.d.ts.map

package/lib/types/client/excel/LazyExcelBody.d.ts

@@ -8,9 +8,10 @@ import type { ExcelLimits } from './model.ts';
 export type ExcelBodyProps = DocumentPreviewProps & PropsLocale<'sidebarExcel'> & {
     readonly limits: ExcelLimits;
 };
-/** Lazily loaded renderer input with the filename-derived parser choice. */
+/** Lazily loaded renderer input with the parser choice and main-bundle loading content. */
 export type LoadedExcelBodyProps = ExcelBodyProps & {
     readonly format: ExcelFormat;
+    readonly loading: ReactNode;
 };
 /**
  * Load the browser spreadsheet renderer for every registered format.

package/lib/types/client/excel/excel.d.ts

@@ -7,5 +7,5 @@ import type { LoadedExcelBodyProps } from './LazyExcelBody.tsx';
  * @param props - Complete workbook bytes, limits, and locale.
  * @returns An isolated spreadsheet surface with cancellable loading.
  */
-export declare function ExcelBody({ content, format, limits, t }: LoadedExcelBodyProps): ReactNode;
+export declare function ExcelBody({ content, format, limits, t, loading }: LoadedExcelBodyProps): ReactNode;
 //# sourceMappingURL=excel.d.ts.map

package/lib/types/client/markdown/path-images.d.ts

@@ -3,7 +3,7 @@
  * @param base - document base URI, including any deployment prefix.
  * @param documentPath - absolute source path reported by the Host, when available.
  * @param destination - authored Markdown image URL; query and fragment are not filename components.
- * @returns an HTTP(S) file URL, or undefined for unsupported or malformed destinations.
+ * @returns a Web or Desktop file URL, or undefined for unsupported or malformed destinations.
  */
 export declare function markdownImageUrl(base: string, documentPath: string | undefined, destination: string): string | undefined;
 //# sourceMappingURL=path-images.d.ts.map

package/lib/types/client/pdf/pdf.d.ts

@@ -22,8 +22,10 @@ export interface PdfBodyInjected {
 export type PdfBodyProps = DocumentPreviewProps & PropsLocale<'sidebarPdf'> & PropsStore<PdfStore> & PdfBodyInjected;
 /**
  * Present a PDF with tab-local viewing preferences and component-owned rendering resources.
- * @param props - complete bytes and framework-owned tab/store/locale seats.
+ * @param props - complete bytes, framework-owned tab/store/locale seats, and main-bundle loading content.
  * @returns the PDF reader.
  */
-export declare function PdfBody(props: PdfBodyProps): ReactNode;
+export declare function PdfBody(props: PdfBodyProps & {
+    readonly loading: ReactNode;
+}): ReactNode;
 //# sourceMappingURL=pdf.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-sidebar-documentpreview",
   "description": "Extensible Sidebar previews for Office documents, spreadsheets, Markdown, code, images, PDF, HTML, and plain text",
-  "version": "0.1.7-rc.1",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -62,25 +62,25 @@
     "react-dom": "^18.2.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-gateway": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-api-workspace-files": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-resources": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-dockkit": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-office-to-pdf": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1"
+    "@deepseek-ai/dsh-api-gateway": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-workspace-files": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-resources": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-dockkit": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-office-to-pdf": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.0-rc.1"
   },
   "files": [
     "lib/index.js",