@deepseek-ai/dsh-client-ui-sidebar-documentpreview 0.1.5-rc.1 → 0.1.6-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # 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:
 #   pnpm run verify-translation-pairing --write packages/client/ui-sidebar-documentpreview/README.md
-README.md: e3659ed08a7c82f7c5ef314806ea07262f421caa
-README.zh.md: 2c2fe2225a87b333f501e58f4988ff8034c14273
+README.md: 3da629129f36d18a20eef74be8f96a1455d532f3
+README.zh.md: 6f1eb7eef1f690ebdfdf38cfdd1f62b1314d7d66

package/README.md

@@ -27,10 +27,10 @@ Preview readable files in the right Sidebar and choose among registered renderer
 ## What it registers
 
 - **The type** — `ctx.sidebarRightTabs.register(...)` with id `@deepseek-ai/dsh-client-ui-sidebar-documentpreview` (this implementation's identity in the tab system, and the key its body registers under), kind `text`, pattern `dsh-resource://file/**`, band `fallback`. `canOpen` accepts only Session addresses, whose paths may be relative or absolute; bare `absolute` addresses are not claimed. A type registered at the `extension` or `builtin` band for a narrower pattern (say `*.png`) takes those addresses; other supported files land here. The whole address is the content identity, so two files with one name in different directories, or one path under two sessions, are two tabs; the decoded basename is the tab title, and the keyed `sidebar.right.pane.tab.title` seat places its extension-specific `FileTypeIcon` before that title.
-- **The body** — the keyed `sidebar.right.pane.tab` seat under the type's id. Its fixed header shows the Host's absolute path when available, otherwise the requested path; directories use tertiary label colour, the name uses primary label colour, and a clipped path retains and fades toward its final segment while its tooltip exposes the full value. A dropdown selects among matching renderers and plain text. A wrap toggle appears only when the selected renderer declares `wrap: true`; its glyph describes the mode the click selects, and the per-tab preference starts on. Reload stays in this header, not the Sidebar's tab strip. The body reaches every pane edge; each renderer owns its content inset and may own an inner scrollport. This intentionally differs from the Files tab's 2px right-side scrollbar offset: previews keep the full pane width so edge-to-edge HTML and code scrollports end at the pane edge.
+- **The body** — the keyed `sidebar.right.pane.tab` seat under the type's id. Its fixed header shows the Host's absolute path when available, otherwise the requested path; directories use tertiary label colour, the name uses primary label colour, and a clipped path retains and fades toward its final segment while its tooltip exposes the full value. A dropdown selects among matching renderers and plain text; a suffix declared binary (bitmap images, PDF) drops the plain-text fallback, and a single remaining candidate renders no viewer control at all. A known binary container suffix with no registered renderer (audio, video, archives, office documents) shows an unsupported empty state under the path header — the file-type icon and one explanatory line — and never issues a read. A wrap toggle appears only when the selected renderer declares `wrap: true`; its glyph describes the mode the click selects, and the per-tab preference starts on. Reload stays in this header, not the Sidebar's tab strip. The body reaches every pane edge; each renderer owns its content inset and may own an inner scrollport. This intentionally differs from the Files tab's 2px right-side scrollbar offset: previews keep the full pane width so edge-to-edge HTML and code scrollports end at the pane edge.
 - **Shared loading and view state**, session-scoped and bucketed by tab id. The store holds accumulated pages or complete bytes, read and observed versions, loading/failure state, renderer choice, scroll offset, wrap, and the answered navigation revision. The ordinary inject face calls Remote readers and writes through declared store actions. Reloads and loading-mode changes retire older requests; the tab's abort signal forgets its state.
 
-Document implementations register metadata with `ctx.documentPreviews.register({ id, extensions, priority, title, loading, wrap? })` and a body under the same `id` in the keyed, Session-scoped `sidebar.right.tab.document` child slot. Own both registrations with effects and wait for the child slot through `ctx.slots.inject`. Bodies receive `resourceAddress`, prepared `content`, `wrap`, `scrollportRef`, and the standard `useTabInfo`/`useResource` hooks; they do not receive a custom resource loader. A renderer that owns an inner scrolling element attaches `scrollportRef` to it, and the owner returns to the shared body when that element unmounts. Metadata declares `loading: 'text-pages'` or `'bytes-complete'`. The registry retains all matching alternatives: `extension` (the default) ranks above `builtin`, then longer suffixes rank first, then registration order. The dropdown preserves a selected implementation while it remains available; removing it selects the next candidate. Builtin bodies use these same registrations.
+Document implementations register metadata with `ctx.documentPreviews.register({ id, extensions, binaryExtensions?, priority, title, loading, wrap? })` and a body under the same `id` in the keyed, Session-scoped `sidebar.right.tab.document` child slot. `binaryExtensions` names the suffixes among `extensions` whose bytes are not readable text; a file matching one loses the plain-text fallback among its viewer choices. Own both registrations with effects and wait for the child slot through `ctx.slots.inject`. Bodies receive `resourceAddress`, prepared `content`, `wrap`, `scrollportRef`, and the standard `useTabInfo`/`useResource` hooks; they do not receive a custom resource loader. A renderer that owns an inner scrolling element attaches `scrollportRef` to it, and the owner returns to the shared body when that element unmounts. Metadata declares `loading: 'text-pages'` or `'bytes-complete'`. The registry retains all matching alternatives: `extension` (the default) ranks above `builtin`, then longer suffixes rank first, then registration order. The dropdown preserves a selected implementation while it remains available; removing it selects the next candidate. Builtin bodies use these same registrations.
 
 <a id="addresses"></a>
 ## Addresses
@@ -49,11 +49,11 @@ The body reads its record, navigation and lifetime through `useTabInfo().tab`. `
 
 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 ordinary inject callback to `remote.workspaceFiles.readRelated`, with fixed safety limits of 4 MiB per asset, 32 MiB total, and 64 distinct assets. Host code resolves the related path; `rpc.ts` decodes the returned bytes. 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. The image keeps its intrinsic CSS-pixel dimensions; a smaller image centres in the shared scroller, and larger dimensions scroll on either axis. The renderer provides neither zoom nor drag-to-pan. 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.
+PNG, JPEG, GIF, WebP, BMP, ICO, and SVG render through Blob URLs in an `<img>` static-image context, rounded inside a 12px inset. A wider image scales down to the pane's width at its intrinsic aspect ratio, a smaller image centres at its intrinsic CSS-pixel dimensions, and a taller image scrolls vertically. The renderer provides neither zoom nor drag-to-pan. 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.
 
-Initial reads, additional pages, and HTML/PDF/image preparation share a loading indicator that respects reduced-motion preferences. Loaded pages stay visible while another page loads. PDF pages form one vertical, width-fitted sequence and render lazily near the viewport. Code previews 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, additional pages, and HTML/PDF/image preparation share an icon-only loading spinner that exposes its label to assistive technology and respects reduced-motion preferences; every wait before content exists centres the spinner in the pane, so opening a file shows one spinner in one position until the body appears. Loaded pages stay visible while another page loads. 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. Code previews 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="navigation"></a>
 ## Navigation
@@ -74,7 +74,7 @@ No direct effect; what the user reads here never enters a model request.
 <a id="known-limitations-and-deferred-work"></a>
 - **Preview, not editing.** The viewers provide no file editing or shared search interface; a directory address fails with `not-regular-file`. Unknown extensions use the plain-text reader and remain subject to its UTF-8/NUL checks.
 - **Sequential text and bounded complete files.** Deep source lines require the preceding pages; PDF, HTML, and images require a complete result within the Host's `maxFileBytes` cap.
-- **Byte-view scroll state is not restored.** PDF, HTML, and images can return to the top when their renderer remounts or reloads; image horizontal position is never restored, and HTML iframe scrolling belongs to its opaque browsing context.
+- **Byte-view scroll state is not restored.** PDF, HTML, and images can return to the top when their renderer remounts or reloads; images fit the pane's width and never scroll horizontally, and HTML iframe scrolling belongs to its opaque browsing context.
 - **Finite local HTML dependencies.** Only direct classic `.js` and stylesheet `.css` references are packed. Browser-resolved resources retain browser origin and network restrictions; no runtime file-read bridge is exposed to the iframe.
 - **Package-local wrap glyphs.** `IconWrapFill16` and `IconNowrapFill16` live in `src/client/icons.tsx` until the shared icon set carries them; their props already match the shared icon contract.
 - **Scroll writes are unthrottled.** Every scroll event records its offset in the store; the line blocks are memoized so the resulting re-render hands React the same elements back.

package/README.zh.md

@@ -26,16 +26,16 @@ kind: "package-reference"
 <a id="what-it-registers"></a>
 ## 注册了什么
 
-- **类型** —— `ctx.sidebarRightTabs.register(...)`，id 为 `@deepseek-ai/dsh-client-ui-sidebar-documentpreview`（这个实现在 tab 系统里的唯一键，也是其体注册所用的 key），kind `text`，pattern `dsh-resource://file/**`，档位 `fallback`。`canOpen` 只接受 Session 地址，其中路径可为相对或绝对路径；不认领裸 `absolute` 地址。在 `extension` 或 `builtin` 档以更窄 pattern（比如 `*.png`）注册的类型接走那些地址；其他受支持文件落到这里。整个地址就是内容身份，所以不同目录下同名的两个文件、或同一路径在两个会话之下，是两个 tab；解码后的 basename 是 tab 标题，keyed slot `sidebar.right.pane.tab.title` 会在标题前放置按扩展名选择的 `FileTypeIcon`。
-- **正文** —— keyed slot `sidebar.right.pane.tab`，键为类型的 id。固定头部在可用时显示 Host 的绝对路径，否则显示请求路径；目录使用三级标签色，文件名使用一级标签色，路径过长时保留末段并向开头淡出，提示中仍提供完整值。下拉菜单可在匹配的渲染器与纯文本间切换。仅当所选渲染器声明 `wrap: true` 时显示换行开关；图标表示点击后切换到的模式，该偏好按 tab 保存，初始开启。重新载入仍在此头部，不放入 Sidebar 的 tab 条。正文贴合格的每条边，各渲染器自行提供内容留白，并可拥有内部滚动区。这与 Files tab 右侧预留 2px 滚动条间距的布局有意不同：Preview 使用格的完整宽度，使贴边 HTML 与代码滚动区终止于格的边缘。
+- **类型** —— `ctx.sidebarRightTabs.register(...)`，id 为 `@deepseek-ai/dsh-client-ui-sidebar-documentpreview`（这个实现在 tab 系统中的身份，也是其正文注册所用的键），kind `text`，pattern `dsh-resource://file/**`，档位 `fallback`。`canOpen` 只接受 Session 地址，其中路径可为相对或绝对路径；不认领裸 `absolute` 地址。在 `extension` 或 `builtin` 档以更窄 pattern（比如 `*.png`）注册的类型接走那些地址；其他受支持文件落到这里。整个地址就是内容身份，所以不同目录下同名的两个文件、或同一路径在两个会话之下，是两个 tab；解码后的 basename 是 tab 标题，keyed slot `sidebar.right.pane.tab.title` 会在标题前放置按扩展名选择的 `FileTypeIcon`。
+- **正文** —— keyed slot `sidebar.right.pane.tab`，键为类型的 id。固定头部在可用时显示 Host 的绝对路径，否则显示请求路径；目录使用三级标签色，文件名使用一级标签色，路径过长时保留末段并向开头淡出，提示中仍提供完整值。下拉菜单可在匹配的渲染器与纯文本间切换；声明为二进制的后缀（位图图片、PDF）不提供纯文本兜底，只剩一个候选时完全不渲染查看器控件。已知的二进制容器后缀（音频、视频、压缩包、office 文档）没有注册渲染器时，在路径头部下方显示不支持预览的空态——文件类型图标加一行说明——并且不会发起读取。仅当所选渲染器声明 `wrap: true` 时显示换行开关；图标表示点击后切换到的模式，该偏好按 tab 保存，初始开启。重新载入仍在此头部，不放入 Sidebar 的 tab 条。正文贴合格的每条边，各渲染器自行提供内容留白，并可拥有内部滚动区。这与 Files tab 右侧预留 2px 滚动条间距的布局有意不同：Preview 使用格的完整宽度，使贴边 HTML 与代码滚动区终止于格的边缘。
 - **共享加载与视图状态**，会话作用域、按 tab id 分桶。store 持有累计页或完整字节、读取与观察版本、加载/失败状态、渲染器选择、滚动位置、换行和已响应的导航 revision。普通 inject face 调用 Remote 读取，并经声明的 store action 写入。重新载入和加载模式变化会淘汰旧请求；tab 的中止信号清理其状态。
 
-文档实现在 `ctx.documentPreviews.register({ id, extensions, priority, title, loading, wrap? })` 注册元数据，并以相同 `id` 向 keyed、Session 作用域的子 slot `sidebar.right.tab.document` 注册正文。两处注册都由 effect 持有，通过 `ctx.slots.inject` 等待子 slot。正文接收 `resourceAddress`、准备好的 `content`、`wrap`、`scrollportRef` 和标准 `useTabInfo`/`useResource` 钩子，不接收自定义资源加载器。拥有内部滚动元素的渲染器把 `scrollportRef` 挂到该元素上；该元素卸载后，owner 恢复使用共享正文。元数据声明 `loading: 'text-pages'` 或 `'bytes-complete'`。注册表保留所有匹配备选：`extension`（默认）优先于 `builtin`，随后按更长的后缀、再按注册顺序排列。所选实现仍可用时，下拉选择保持不变；移除后选择下一个候选。内置正文也使用相同注册方式。
+文档实现在 `ctx.documentPreviews.register({ id, extensions, binaryExtensions?, priority, title, loading, wrap? })` 注册元数据，并以相同 `id` 向 keyed、Session 作用域的子 slot `sidebar.right.tab.document` 注册正文。`binaryExtensions` 列出 `extensions` 中字节不可按文本阅读的后缀；匹配这类后缀的文件在其查看器选项中不再提供纯文本兜底。两处注册都由 effect 持有，通过 `ctx.slots.inject` 等待子 slot。正文接收 `resourceAddress`、准备好的 `content`、`wrap`、`scrollportRef` 和标准 `useTabInfo`/`useResource` 钩子，不接收自定义资源加载器。拥有内部滚动元素的渲染器把 `scrollportRef` 挂到该元素上；该元素卸载后，owner 恢复使用共享正文。元数据声明 `loading: 'text-pages'` 或 `'bytes-complete'`。注册表保留所有匹配备选：`extension`（默认）优先于 `builtin`，随后按更长的后缀、再按注册顺序排列。所选实现仍可用时，下拉选择保持不变；移除后选择下一个候选。内置正文也使用相同注册方式。
 
 <a id="addresses"></a>
 ## 地址
 
-tab 使用 `fileAddressFor` 构造的 Session 地址，携带相对或绝对路径。`hostFileOf(address)` 仅从地址取得 Session，不接收外部 Session 参数，也不借用当前或 Tab Session。Host 通过 Session 文件系统解析文件及关联路径，由该后端控制读取权限。任何 UI（包括 Global 组件）都共享同一完整地址的元数据。[Workspace Files README](../../api/workspace-files/README.zh.md)定义这些规则；渲染器选择不改变导航地址。
+tab 使用 `fileAddressFor` 构造的 Session 地址，携带相对或绝对路径。`hostFileOf(address)` 仅从地址取得 Session，不接收外部 Session 参数，也不借用当前或 Tab Session。Host 通过 Session 文件系统解析文件及关联路径，由该后端控制读取权限。任何 UI（包括 Global 组件）都共享同一完整地址的元数据。[Workspace Files README](../../api/workspace-files/README.zh.md) 定义这些规则；渲染器选择不改变导航地址。
 
 <a id="how-it-reads"></a>
 ## 怎么读
@@ -43,17 +43,17 @@ tab 使用 `fileAddressFor` 构造的 Session 地址，携带相对或绝对路
 正文通过 `useTabInfo().tab` 读取记录、导航和生命周期。`useResource<'file'>(tab.contentId)` 提供元数据，普通 inject 回调提供内容读取：
 
 - 资源快照仅包含 `status`、`value` 和 `failure`；`value` 是 `WorkspaceFileStat` 元数据。提供方可用后，内容读取无需等待首个元数据帧。观察失败优先于 Preview 的变更提示显示；两者都不会自动替换已加载内容。
-- **文本页** —— 纯文本、Markdown 和代码通过 inject 回调调用 `remote.workspaceFiles.read(sessionId, path, { offset }, signal)`。首次挂载读取第一页；滚动到正文末尾或点击 **加载更多** 会读取下一页，直到 `eof`。owner 以 `{ kind: 'text', text, pages, eof }` 提供累计前缀，包含源码行偏移和行数。Markdown 和代码增量渲染此前缀，不把每页当成独立文档。第一页之后到达的更新版本页会使读取从头开始，避免混合版本。尚无内容时，失败会以文件类型图标、说明与重试按钮填满正文；较晚的失败保留已有内容并在其下提供重试。
+- **文本页** —— 纯文本、Markdown 和代码通过 inject 回调调用 `remote.workspaceFiles.read(sessionId, path, { offset }, signal)`。首次挂载读取第一页；滚动到正文末尾或点击 **加载更多** 会读取下一页，直到 `eof`。owner 以 `{ kind: 'text', text, pages, eof }` 提供累计前缀，包含源码偏移和行数。Markdown 和代码增量渲染此前缀，不把每页当成独立文档。第一页之后到达的更新版本页会使读取从头开始，避免混合版本。尚无内容时，失败会以文件类型图标、说明与重试按钮填满正文；较晚的失败保留已有内容并在其下提供重试。
 - **完整字节** —— PDF、HTML 和常见图片通过 inject 回调调用 `remote.workspaceFiles.readAll(sessionId, path, signal)`。`rpc.ts` 将线路上的 base64 解码为 `data: Uint8Array<ArrayBuffer>`，供 `{ kind: 'bytes', data }` 使用。Host 的 `maxFileBytes` 上限拒绝超大文件，不截断。PDF 在传给 worker 前复制保留的字节，使 Preview 缓冲区仍可使用。字节仅保存在临时视图状态中，绝不进入持久布局或 Session JSONL。加载模式变化会淘汰先前结果。
 - **重新载入** —— 仅当前 Preview tab 通过自己的 Remote 回调重读，保留滚动偏好并淘汰旧请求。变更提示将读取版本及起读时的观察版本与后续 `resource.value.version` 比较；刷新前已观察到的版本不会被当成新变化。读取既不刷新共享元数据，也不清除其它 tab 的提示。
 
 HTML 以贴合正文四边的 Blob iframe 运行，沙箱属性严格为 `sandbox="allow-scripts"`，不含 `allow-same-origin`；脚本无法访问父应用的源或文件读取接口。渲染器通过普通 inject 回调调用 `remote.workspaceFiles.readRelated`，加载直接声明的相对 `.js` 经典脚本和 `.css` 样式表；固定安全上限为单个资源 4 MiB、总计 32 MiB、64 个不同资源。Host 代码解析关联路径，`rpc.ts` 解码返回的字节。在渲染器内部，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>` 静态图片上下文中渲染。图片保持固有 CSS 像素尺寸；小图在共享滚动区内居中，大图可沿任一轴滚动。渲染器既不提供缩放，也不提供拖拽平移。SVG 标记绝不进入应用 DOM 或 iframe，因此其中的脚本无法执行，也无法访问父页面。替换或卸载图片会撤销其 Blob URL。
+PNG、JPEG、GIF、WebP、BMP、ICO 和 SVG 通过 Blob URL 在 `<img>` 静态图片上下文中渲染，带 12px 内边距和圆角。宽图按固有纵横比缩小到面板宽度，小图按固有 CSS 像素尺寸居中，超高图纵向滚动。渲染器既不提供缩放，也不提供拖拽平移。SVG 标记绝不进入应用 DOM 或 iframe，因此其中的脚本无法执行，也无法访问父页面。替换或卸载图片会撤销其 Blob URL。
 
 共享文案来自 `sidebarDocumentPreview`；各内置渲染器拥有自己的本地化标签。
 
-首次读取、追加页及 HTML/PDF/图片准备共用加载指示器，并遵循减少动态效果偏好。下一页加载期间保留已显示的内容。PDF 页面组成一个纵向、适配宽度的连续序列，并在接近视口时惰性渲染。代码预览默认显示源码行号，但复制文本不包含行号；纯文本与代码使用相同字号和行高。代码直接坐在分栏自身的背景上，而不是会话卡片的填充色；复制条与占满剩余高度的内部滚动区相邻，因此横纵滚动条都从复制控件下方开始。
+首次读取、追加页及 HTML/PDF/图片准备共用仅图标的加载 spinner，其标签暴露给辅助技术，并遵循减少动态效果偏好；内容出现前的每个等待都把 spinner 居中在面板中，打开文件到正文出现始终是同一位置的一个 spinner。下一页加载期间保留已显示的内容。PDF 页面贴边占满面板宽度，组成一个纵向连续序列并在接近视口时惰性渲染；未渲染的页以安静的 3:4 占位块保持位置。代码预览默认显示源码行号，但复制文本不包含行号；纯文本与代码使用相同字号和行高。代码直接坐在分栏自身的背景上，而不是会话卡片的填充色；复制条与占满剩余高度的内部滚动区相邻，因此横纵滚动条都从复制控件下方开始。
 
 <a id="navigation"></a>
 ## 导航
@@ -73,8 +73,8 @@ PNG、JPEG、GIF、WebP、BMP、ICO 和 SVG 通过 Blob URL 在 `<img>` 静态
 
 <a id="known-limitations-and-deferred-work"></a>
 - **预览而非编辑。** 查看器不提供文件编辑或共享搜索接口；目录地址以 `not-regular-file` 失败。未知扩展名使用纯文本读取，仍受其 UTF-8/NUL 检查限制。
-- **文本顺序分页，完整文件受限。** 定位深处源码行需要先加载此前各页；PDF、HTML 和图片必须取得 Host `maxFileBytes` 上限内的完整结果。
-- **字节视图不恢复滚动位置。** PDF、HTML 与图片的渲染器重新挂载或重新载入时可能回到顶部；图片的横向位置始终不恢复，HTML iframe 的滚动属于其不透明浏览上下文。
+- **文本顺序分页，完整文件受限。** 定位到较深处的源码行需要先加载此前各页；PDF、HTML 和图片必须取得 Host `maxFileBytes` 上限内的完整结果。
+- **字节视图不恢复滚动位置。** PDF、HTML 与图片的渲染器重新挂载或重新载入时可能回到顶部；图片适配面板宽度、不产生横向滚动，HTML iframe 的滚动属于其不透明浏览上下文。
 - **本地 HTML 依赖集合有限。** 只打包直接引用的经典 `.js` 脚本和 `.css` 样式表。浏览器解析的资源仍受浏览器源与网络规则限制；iframe 不获得运行时文件读取桥接。
 - **换行图标为包内自绘。** `IconWrapFill16` 与 `IconNowrapFill16` 住在 `src/client/icons.tsx`，直到共享图标集提供为止；它们的 props 已与共享图标契约一致。
 - **滚动写入未节流。** 每次滚动事件都把偏移记进 store；行块已 memo 化，于是由此引发的重渲染交还给 React 的是同一批元素。

package/lib/client.js

@@ -1103,17 +1103,22 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region lib/types/client/LoadingIndicator.js
-		/** @param props - localized status label and optional placement style. @returns an animated, accessible loading status. */
+		/**
+		* @param props - localized status label, carried as the accessible name with
+		* no visible text, and optional placement style.
+		* @returns an animated, accessible loading status.
+		*/
 		function LoadingIndicator({ label, className }) {
-			return (0, react_jsx_runtime.jsxs)("span", {
+			return (0, react_jsx_runtime.jsx)("span", {
 				className: clsx(LoadingIndicator_module_css_default.loading, className),
 				role: "status",
+				"aria-label": label,
 				"data-document-loading": true,
-				children: [(0, react_jsx_runtime.jsx)("span", {
+				children: (0, react_jsx_runtime.jsx)("span", {
 					className: LoadingIndicator_module_css_default.icon,
 					"aria-hidden": "true",
 					children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutline16, {})
-				}), (0, react_jsx_runtime.jsx)("span", { children: label })]
+				})
 			});
 		}
 		//#endregion
@@ -1158,6 +1163,38 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region lib/types/client/document/suffix.js
+		/**
+		* Filename suffix matching shared by the preview registry and the owner's
+		* unviewable list, so every consumer normalizes paths and suffixes alike.
+		*/
+		/**
+		* Normalize one declared suffix for comparison.
+		* @param extension - declared file suffix, with or without a leading dot.
+		* @returns the suffix lowercased with any leading dot dropped.
+		*/
+		function normalizeSuffix(extension) {
+			return extension.toLowerCase().replace(/^\./u, "");
+		}
+		/**
+		* The filename a path's suffixes are matched against.
+		* @param path - decoded filename or file path; `\` is accepted as a separator.
+		* @returns the lowercased final path segment.
+		*/
+		function documentFileName(path) {
+			const normalized = path.replaceAll("\\", "/").toLowerCase();
+			return normalized.slice(normalized.lastIndexOf("/") + 1);
+		}
+		/**
+		* The longest declared suffix ending the filename.
+		* @param name - lowercased filename from {@link documentFileName}.
+		* @param extensions - declared suffixes; compound suffixes such as `tar.gz` are accepted.
+		* @returns the matched suffix's normalized length, or 0 when none matches.
+		*/
+		function matchedSuffixLength(name, extensions) {
+			return Math.max(0, ...extensions.map(normalizeSuffix).filter((extension) => name.endsWith(`.${extension}`)).map((extension) => extension.length));
+		}
+		//#endregion
 		//#region lib/types/client/document/registry.js
 		/** File-extension preview registrations; component dispatch belongs to the keyed document slot. */
 		/**
@@ -1167,15 +1204,24 @@ window.__ModuleLoader__.load({
 		* @returns matching implementations, external band first, then longest suffix.
 		*/
 		function matchingDocumentPreviews(definitions, path) {
-			const normalized = path.replaceAll("\\", "/").toLowerCase();
-			const name = normalized.slice(normalized.lastIndexOf("/") + 1);
+			const name = documentFileName(path);
 			return definitions.map((definition, order) => ({
 				definition,
 				order,
 				rank: definition.priority === "builtin" ? 0 : 1,
-				length: Math.max(0, ...definition.extensions.map((extension) => extension.toLowerCase().replace(/^\./u, "")).filter((extension) => name.endsWith(`.${extension}`)).map((extension) => extension.length))
+				length: matchedSuffixLength(name, definition.extensions)
 			})).filter((candidate) => candidate.length > 0).sort((left, right) => right.rank - left.rank || right.length - left.length || left.order - right.order).map((candidate) => candidate.definition);
 		}
+		/**
+		* Whether any registered implementation declares the filename's suffix binary.
+		* @param definitions - registered implementations.
+		* @param path - decoded filename or file path.
+		* @returns true when a declared binary suffix matches the filename.
+		*/
+		function binaryDocumentPath(definitions, path) {
+			const name = documentFileName(path);
+			return definitions.some((definition) => matchedSuffixLength(name, definition.binaryExtensions ?? []) > 0);
+		}
 		/** Observable registry of all live implementations, including lower-priority alternatives. */
 		var DocumentPreviewRegistry = class {
 			registered = /* @__PURE__ */ new Map();
@@ -1199,11 +1245,15 @@ window.__ModuleLoader__.load({
 			};
 			/**
 			* Register metadata separately from the matching keyed slot component.
-			* @param definition - unique implementation and recognized suffixes.
-			* @returns an idempotent disposer; duplicate live implementation names throw.
+			* @param definition - unique implementation and recognized suffixes; every
+			* `binaryExtensions` entry must appear in `extensions`.
+			* @returns an idempotent disposer; duplicate live implementation names and
+			* binary suffixes outside `extensions` throw.
 			*/
 			register(definition) {
 				if (this.registered.has(definition.id)) throw new Error(`documentPreviews: duplicate implementation "${definition.id}"`);
+				const declared = new Set(definition.extensions.map(normalizeSuffix));
+				for (const extension of definition.binaryExtensions ?? []) if (!declared.has(normalizeSuffix(extension))) throw new Error(`documentPreviews: "${definition.id}" declares binary suffix "${extension}" outside its extensions`);
 				this.registered.set(definition.id, definition);
 				this.publish();
 				let active = true;
@@ -1228,6 +1278,90 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
+		//#region lib/types/client/document/unviewable.js
+		/**
+		* Known binary container suffixes with no registered renderer. The preview
+		* owner shows these the unsupported empty state instead of the plain-text
+		* fallback; any renderer registration for a suffix takes precedence because
+		* the owner consults this list only when no implementation matches. A suffix
+		* belongs here only when its bytes are never readable text — an uncertain
+		* suffix stays out and keeps the plain-text fallback.
+		*/
+		const UNVIEWABLE_BINARY_EXTENSIONS = [
+			"mp4",
+			"mov",
+			"avi",
+			"mkv",
+			"webm",
+			"flv",
+			"wmv",
+			"m4v",
+			"mp3",
+			"wav",
+			"flac",
+			"ogg",
+			"m4a",
+			"aac",
+			"wma",
+			"opus",
+			"zip",
+			"gz",
+			"tgz",
+			"bz2",
+			"xz",
+			"zst",
+			"7z",
+			"rar",
+			"tar",
+			"jar",
+			"doc",
+			"docx",
+			"xls",
+			"xlsx",
+			"ppt",
+			"pptx",
+			"odt",
+			"ods",
+			"odp",
+			"pages",
+			"numbers",
+			"exe",
+			"dll",
+			"so",
+			"dylib",
+			"bin",
+			"o",
+			"class",
+			"pyc",
+			"wasm",
+			"ttf",
+			"otf",
+			"woff",
+			"woff2",
+			"eot",
+			"dmg",
+			"iso",
+			"img",
+			"sqlite",
+			"db",
+			"psd",
+			"ai",
+			"sketch",
+			"tiff",
+			"tif",
+			"heic",
+			"heif",
+			"avif"
+		];
+		/**
+		* Whether a filename's suffix is a known binary container that no renderer claims.
+		* @param path - decoded filename or file path.
+		* @returns true when the suffix belongs to the unviewable binary list.
+		*/
+		function unviewableBinaryPath(path) {
+			return matchedSuffixLength(documentFileName(path), UNVIEWABLE_BINARY_EXTENSIONS) > 0;
+		}
+		//#endregion
 		//#region lib/types/client/text/lines.js
 		/**
 		* Split a loaded page into its source lines.
@@ -1274,7 +1408,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$5 = ".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{white-space:nowrap;flex:auto;justify-content:flex-end;min-width:0;margin-right:12px;font-size:12px;display:flex;overflow:hidden}.dhJKeW_path[data-textpreview-path-clipped]{mask-image:linear-gradient(90deg,#0000,#000 28px)}.dhJKeW_pathText{flex:none;margin-right:auto}.dhJKeW_pathDirectory{color:var(--dsw-alias-label-tertiary)}.dhJKeW_pathName{color:var(--dsw-alias-label-primary)}.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_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{flex-direction:column;align-items:flex-start;gap:8px;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);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{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}.dhJKeW_viewerTool{white-space:nowrap;text-overflow:ellipsis;width:auto;max-width:160px;padding:0 6px;font-size:12px;overflow:hidden}";
+		const css$5 = ".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{white-space:nowrap;flex:auto;justify-content:flex-end;min-width:0;margin-right:12px;font-size:12px;display:flex;overflow:hidden}.dhJKeW_path[data-textpreview-path-clipped]{mask-image:linear-gradient(90deg,#0000,#000 28px)}.dhJKeW_pathText{flex:none;margin-right:auto}.dhJKeW_pathDirectory{color:var(--dsw-alias-label-tertiary)}.dhJKeW_pathName{color:var(--dsw-alias-label-primary)}.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_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{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}.dhJKeW_viewerTool{white-space:nowrap;text-overflow:ellipsis;width:auto;max-width:160px;padding:0 6px;font-size:12px;overflow:hidden}";
 		const tagId$5 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/TextPreview.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$5) + "]") === null) {
 			const tag = document.createElement("style");
@@ -1286,6 +1420,7 @@ 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",
@@ -1401,6 +1536,27 @@ window.__ModuleLoader__.load({
 				shown
 			]);
 		}
+		/** The header's path: directories greyed, the final segment in full ink, faded when clipped. */
+		function HeaderPath({ pathRef, pathTextRef, path }) {
+			const { directory, name } = pathPartsOf(path);
+			return (0, react_jsx_runtime.jsx)("div", {
+				ref: pathRef,
+				className: TextPreview_module_css_default.path,
+				title: path,
+				"data-textpreview-path": true,
+				children: (0, react_jsx_runtime.jsxs)("span", {
+					ref: pathTextRef,
+					className: TextPreview_module_css_default.pathText,
+					children: [directory !== "" && (0, react_jsx_runtime.jsx)("span", {
+						className: TextPreview_module_css_default.pathDirectory,
+						children: directory
+					}), (0, react_jsx_runtime.jsx)("span", {
+						className: TextPreview_module_css_default.pathName,
+						children: name
+					})]
+				})
+			});
+		}
 		/**
 		* The text type's body, registered under `sidebar.right.pane.tab` as `text`.
 		* @param props - composed slot props.
@@ -1414,11 +1570,18 @@ window.__ModuleLoader__.load({
 			const file = (0, react.useMemo)(() => hostFileOf(tab.contentId), [tab.contentId]);
 			const state = useStore((s) => s.byTab[tab.id]);
 			const definitions = useDocumentPreviews((value) => value);
+			const unviewable = (0, react.useMemo)(() => unviewableBinaryPath(file.path), [file.path]);
 			const candidates = (0, react.useMemo)(() => {
 				const matched = matchingDocumentPreviews(definitions, file.path);
+				if (matched.length > 0 && binaryDocumentPath(definitions, file.path)) return matched;
+				if (matched.length === 0 && unviewable) return matched;
 				const fallback = definitions.find((definition) => definition.id === PLAIN_BODY_ID);
 				return fallback === void 0 ? matched : [...matched, fallback];
-			}, [definitions, file.path]);
+			}, [
+				definitions,
+				file.path,
+				unviewable
+			]);
 			const selected = candidates.find((candidate) => candidate.id === state?.rendererId) ?? candidates[0];
 			const mode = selected?.loading;
 			const current = (state?.mode ?? "text-pages") === mode ? state : void 0;
@@ -1512,6 +1675,37 @@ window.__ModuleLoader__.load({
 				current?.complete,
 				current?.eof
 			]);
+			if (selected === void 0 && unviewable) {
+				const { name: unsupportedName } = pathPartsOf(displayPath);
+				return (0, react_jsx_runtime.jsxs)("div", {
+					className: TextPreview_module_css_default.preview,
+					"data-textpreview-state": "unsupported",
+					"data-textpreview-url": tab.contentId,
+					children: [(0, react_jsx_runtime.jsx)("div", {
+						className: TextPreview_module_css_default.header,
+						children: (0, react_jsx_runtime.jsx)(HeaderPath, {
+							pathRef,
+							pathTextRef,
+							path: displayPath
+						})
+					}), (0, react_jsx_runtime.jsx)("div", {
+						className: TextPreview_module_css_default.body,
+						"data-textpreview-body": true,
+						children: (0, react_jsx_runtime.jsxs)("div", {
+							className: TextPreview_module_css_default.empty,
+							"data-textpreview-unsupported": true,
+							children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.FileTypeIcon, {
+								kind: (0, _deepseek_ai_dsh_client_ui_primitives.classifyFileType)(unsupportedName),
+								size: 36,
+								className: TextPreview_module_css_default.emptyIcon
+							}), (0, react_jsx_runtime.jsx)("p", {
+								className: TextPreview_module_css_default.emptyLine,
+								children: t("unsupportedFile")
+							})]
+						})
+					})]
+				});
+			}
 			if (state === void 0 || selected === void 0) return (0, react_jsx_runtime.jsx)("div", {
 				className: TextPreview_module_css_default.status,
 				"data-textpreview-state": "loading",
@@ -1524,7 +1718,7 @@ window.__ModuleLoader__.load({
 				})
 			});
 			const next = loadedThrough + 1;
-			const { directory, name } = pathPartsOf(displayPath);
+			const { name } = pathPartsOf(displayPath);
 			const observedVersion = meta.value?.version;
 			const changed = current?.version !== void 0 && observedVersion !== void 0 && observedVersion !== current.version && observedVersion !== current.observedVersion;
 			const loadNext = () => {
@@ -1566,24 +1760,12 @@ window.__ModuleLoader__.load({
 					(0, react_jsx_runtime.jsxs)("div", {
 						className: TextPreview_module_css_default.header,
 						children: [
-							(0, react_jsx_runtime.jsx)("div", {
-								ref: pathRef,
-								className: TextPreview_module_css_default.path,
-								title: displayPath,
-								"data-textpreview-path": true,
-								children: (0, react_jsx_runtime.jsxs)("span", {
-									ref: pathTextRef,
-									className: TextPreview_module_css_default.pathText,
-									children: [directory !== "" && (0, react_jsx_runtime.jsx)("span", {
-										className: TextPreview_module_css_default.pathDirectory,
-										children: directory
-									}), (0, react_jsx_runtime.jsx)("span", {
-										className: TextPreview_module_css_default.pathName,
-										children: name
-									})]
-								})
+							(0, react_jsx_runtime.jsx)(HeaderPath, {
+								pathRef,
+								pathTextRef,
+								path: displayPath
 							}),
-							(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Menu, {
+							candidates.length > 1 && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Menu, {
 								open: menuOpen,
 								anchor: (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
@@ -1658,7 +1840,7 @@ window.__ModuleLoader__.load({
 						},
 						children: [
 							!hasContent && current?.failure === void 0 && (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-								className: TextPreview_module_css_default.statusLine,
+								className: clsx(TextPreview_module_css_default.statusLine, TextPreview_module_css_default.bodyLoading),
 								label: t("loading")
 							}),
 							content !== void 0 && renderSlot("sidebar.right.tab.document", {
@@ -2035,7 +2217,7 @@ window.__ModuleLoader__.load({
 		const zh$5 = {
 			loading: "正在读取…",
 			loadMore: "加载更多",
-			changed: "文件已更新，当前显示为旧内容。",
+			changed: "文件已更新，当前显示为旧内容",
 			reloadNow: "重新载入",
 			reload: "重新读取文件",
 			"wrap.enable": "自动换行",
@@ -2043,12 +2225,13 @@ window.__ModuleLoader__.load({
 			"wrap.aria": "自动换行",
 			openWith: "打开方式",
 			"viewer.text": "纯文本",
-			resourceUnavailable: "文件资源服务不可用。",
-			rendererUnavailable: "预览器 {name} 不可用。",
-			"error.notFound": "文件不存在，可能已被移动或删除。",
-			"error.tooLarge": "单页内容超过 {limit} 上限，无法读取。",
-			"error.notText": "非文本文件，暂时无法预览。",
-			"error.notRegularFile": "该路径不是普通文件，没有可显示的内容。",
+			resourceUnavailable: "文件资源服务不可用",
+			rendererUnavailable: "预览器 {name} 不可用",
+			unsupportedFile: "该格式文件暂时无法预览",
+			"error.notFound": "文件不存在，可能已被移动或删除",
+			"error.tooLarge": "单页内容超过 {limit} 上限，无法读取",
+			"error.notText": "该格式文件暂时无法预览",
+			"error.notRegularFile": "该路径不是普通文件，没有可显示的内容",
 			"error.unavailable": "读取失败：{message}",
 			retry: "重试"
 		};
@@ -2066,9 +2249,10 @@ window.__ModuleLoader__.load({
 			"viewer.text": "Plain text",
 			resourceUnavailable: "The file resource service is unavailable.",
 			rendererUnavailable: "The {name} preview is unavailable.",
+			unsupportedFile: "Preview is not available for this file type yet.",
 			"error.notFound": "File not found. It may have been moved or deleted.",
 			"error.tooLarge": "This page exceeds the {limit} limit and cannot be read.",
-			"error.notText": "Not a text file, preview is unavailable for now.",
+			"error.notText": "Preview is not available for this file type yet.",
 			"error.notRegularFile": "Not a regular file, nothing to display.",
 			"error.unavailable": "Read failed: {message}",
 			retry: "Retry"
@@ -2331,7 +2515,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$3 = ".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 css$3 = ".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 tagId$3 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/HtmlBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$3) + "]") === null) {
 			const tag = document.createElement("style");
@@ -2342,6 +2526,7 @@ document.open();document.write(html);document.close();
 		}
 		var HtmlBody_module_css_default = {
 			"frame": "HyIruq_frame",
+			"opening": "HyIruq_opening",
 			"status": "HyIruq_status"
 		};
 		//#endregion
@@ -2378,7 +2563,7 @@ document.open();document.write(html);document.close();
 				};
 			}, [data, readRelative]);
 			if (frame?.data !== data || frame.readRelative !== readRelative) return (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-				className: HtmlBody_module_css_default.status,
+				className: clsx(HtmlBody_module_css_default.status, HtmlBody_module_css_default.opening),
 				label: t("loading")
 			});
 			if (frame.url === void 0) return (0, react_jsx_runtime.jsx)("p", {
@@ -2419,14 +2604,14 @@ document.open();document.write(html);document.close();
 		const zh$3 = {
 			title: "HTML",
 			frame: "HTML 文档预览",
-			loading: "正在准备 HTML 预览…",
-			failed: "无法预览这份 HTML 文档。"
+			loading: "正在读取…",
+			failed: "无法预览这份 HTML 文档"
 		};
 		/** English dictionary with the same keys as the Chinese dictionary. */
 		const en$3 = {
 			title: "HTML",
 			frame: "HTML document preview",
-			loading: "Preparing HTML preview…",
+			loading: "Reading…",
 			failed: "This HTML document could not be previewed."
 		};
 		//#endregion
@@ -2471,7 +2656,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/image/ImageBody.module.css.mjs
-		const css$2 = ".JFRUHG_frame{box-sizing:border-box;width:max-content;min-width:100%;height:max-content;min-height:100%;font-family:var(--dsw-font,sans-serif);white-space:normal;padding:8px;display:flex}.JFRUHG_image{user-select:none;flex:none;width:auto;max-width:none;height:auto;max-height:none;margin:auto;display:block}.JFRUHG_image[hidden]{display:none}.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$2 = ".JFRUHG_frame{box-sizing:border-box;width:100%;height:max-content;min-height:100%;font-family:var(--dsw-font,sans-serif);white-space:normal;padding:12px;display:flex}.JFRUHG_image{user-select:none;border-radius:8px;flex:none;width:auto;max-width:100%;height:auto;max-height:none;margin:auto;display:block}.JFRUHG_image[hidden]{display:none}.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$2 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/ImageBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$2) + "]") === null) {
 			const tag = document.createElement("style");
@@ -2487,7 +2672,7 @@ document.open();document.write(html);document.close();
 		};
 		//#endregion
 		//#region lib/types/client/image/ImageBody.js
-		/** Complete image bytes rendered at their intrinsic CSS-pixel dimensions. */
+		/** Complete image bytes rendered rounded within an inset frame, scaled down to the pane's width. */
 		const IMAGE_MEDIA_TYPES = {
 			png: "image/png",
 			jpg: "image/jpeg",
@@ -2509,9 +2694,11 @@ document.open();document.write(html);document.close();
 			return IMAGE_MEDIA_TYPES[name.slice(name.lastIndexOf(".") + 1)];
 		}
 		/**
-		* Present complete image bytes without fitting or scaling them to the pane.
+		* Present complete image bytes fitted to the pane's width.
 		* @param props - document bytes, resource identity, and locale.
-		* @returns an intrinsic-size image whose containing document body provides scrolling.
+		* @returns a rounded image scaled down to the pane's width at its aspect
+		* ratio — a smaller image centres at its intrinsic size — whose containing
+		* document body provides vertical scrolling.
 		*/
 		function ImageBody({ content, resourceAddress, t }) {
 			const path = (0, react.useMemo)(() => hostFileOf(resourceAddress).path, [resourceAddress]);
@@ -2601,15 +2788,15 @@ document.open();document.write(html);document.close();
 		const zh$2 = {
 			title: "图片",
 			preview: "图片预览：{name}",
-			loading: "正在打开图片…",
-			failed: "无法显示这张图片。",
-			unsupported: "图片预览需要完整文件内容。"
+			loading: "正在读取…",
+			failed: "无法显示这张图片",
+			unsupported: "图片预览需要完整文件内容"
 		};
 		/** English dictionary with the same keys as the Chinese dictionary. */
 		const en$2 = {
 			title: "Image",
 			preview: "Image preview: {name}",
-			loading: "Opening image…",
+			loading: "Reading…",
 			failed: "This image could not be displayed.",
 			unsupported: "Image preview requires the complete file contents."
 		};
@@ -2628,6 +2815,16 @@ document.open();document.write(html);document.close();
 			"ico",
 			"svg"
 		];
+		/** Bitmap suffixes whose bytes are unreadable as text; SVG stays out because its XML source is worth reading. */
+		const BINARY_IMAGE_EXTENSIONS = [
+			"png",
+			"jpg",
+			"jpeg",
+			"gif",
+			"webp",
+			"bmp",
+			"ico"
+		];
 		/**
 		* Describe the builtin image renderer independently from its keyed body slot.
 		* @param title - locale-owned implementation name.
@@ -2637,6 +2834,7 @@ document.open();document.write(html);document.close();
 			return {
 				id: IMAGE_BODY_ID,
 				extensions: IMAGE_EXTENSIONS,
+				binaryExtensions: BINARY_IMAGE_EXTENSIONS,
 				priority: "builtin",
 				title,
 				loading: "bytes-complete",
@@ -26473,7 +26671,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$1 = ".E0GbtG_body{box-sizing:border-box;width:100%;min-height:0;font-family:var(--dsw-font,sans-serif);white-space:normal;flex-direction:column;padding:8px;display:flex;overflow-x:hidden}.E0GbtG_page{box-sizing:border-box;width:100%;min-width:0;padding:12px;overflow-x:hidden}.E0GbtG_placeholder{aspect-ratio:3/4;justify-content:center;align-items:center;width:100%;display:flex}.E0GbtG_canvas{width:min(var(--pdf-page-width), 100%);max-width:100%;height:auto;margin-inline:auto;display:block}.E0GbtG_canvas[hidden]{display:none}.E0GbtG_status{color:var(--dsw-alias-label-secondary);align-items:center;gap:8px;padding:10px;font-size:13px;line-height:1.5;display:flex}";
+		const css$1 = ".E0GbtG_body{box-sizing:border-box;width:100%;min-height:0;font-family:var(--dsw-font,sans-serif);white-space:normal;flex-direction:column;display:flex;overflow-x:hidden}.E0GbtG_page{box-sizing:border-box;width:100%;min-width:0;overflow-x:hidden}.E0GbtG_placeholder{aspect-ratio:3/4;background:var(--dsw-alias-bg-skeleton);width:100%}.E0GbtG_canvas{width:min(var(--pdf-page-width), 100%);max-width:100%;height:auto;margin-inline:auto;display:block}.E0GbtG_canvas[hidden]{display:none}.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_opening{box-sizing:border-box;justify-content:center;width:100%;min-height:100%}";
 		const tagId$1 = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/PdfBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
 			const tag = document.createElement("style");
@@ -26485,6 +26683,7 @@ 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"
@@ -26554,7 +26753,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				children: t("unsupported")
 			});
 			if (load?.data !== data) return (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-				className: PdfBody_module_css_default.status,
+				className: clsx(PdfBody_module_css_default.status, PdfBody_module_css_default.opening),
 				label: t("loading")
 			});
 			if (load.kind === "failed") return (0, react_jsx_runtime.jsxs)("div", {
@@ -26634,13 +26833,11 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				className: PdfBody_module_css_default.page,
 				"data-pdf-page": page,
 				children: [
-					failure === void 0 && state !== "ready" && (0, react_jsx_runtime.jsx)("div", {
+					failure === void 0 && state !== "ready" && (requested ? (0, react_jsx_runtime.jsx)("div", {
 						className: PdfBody_module_css_default.placeholder,
-						children: requested && (0, react_jsx_runtime.jsx)(LoadingIndicator, {
-							className: PdfBody_module_css_default.status,
-							label: t("rendering")
-						})
-					}),
+						role: "status",
+						"aria-label": t("rendering")
+					}) : (0, react_jsx_runtime.jsx)("div", { className: PdfBody_module_css_default.placeholder })),
 					failure !== void 0 && (0, react_jsx_runtime.jsxs)("div", {
 						className: PdfBody_module_css_default.status,
 						role: "alert",
@@ -26673,19 +26870,19 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		const zh$1 = {
 			title: "PDF",
 			pageImage: "PDF 第 {page} 页",
-			loading: "正在打开 PDF…",
+			loading: "正在读取…",
 			rendering: "正在绘制页面…",
 			failed: "无法显示 PDF：{message}",
-			password: "此 PDF 需要密码，暂不支持预览。",
-			workerFailed: "PDF 渲染进程无法继续，请重试。",
-			unsupported: "PDF 预览需要完整文件内容。",
+			password: "此 PDF 需要密码，暂不支持预览",
+			workerFailed: "PDF 渲染进程无法继续，请重试",
+			unsupported: "PDF 预览需要完整文件内容",
 			retry: "重试"
 		};
 		/** English PDF-renderer dictionary. */
 		const en$1 = {
 			title: "PDF",
 			pageImage: "PDF page {page}",
-			loading: "Opening PDF…",
+			loading: "Reading…",
 			rendering: "Rendering page…",
 			failed: "Cannot display PDF: {message}",
 			password: "This PDF requires a password; password-protected previews are not supported.",
@@ -26706,6 +26903,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 			return {
 				id: PDF_BODY_ID,
 				extensions: ["pdf"],
+				binaryExtensions: ["pdf"],
 				priority: "builtin",
 				title,
 				loading: "bytes-complete",

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

@@ -1,6 +1,10 @@
 /** Shared indeterminate loading feedback for document reads and rendering. */
 import type { ReactNode } from 'react';
-/** @param props - localized status label and optional placement style. @returns an animated, accessible loading status. */
+/**
+ * @param props - localized status label, carried as the accessible name with
+ * no visible text, and optional placement style.
+ * @returns an animated, accessible loading status.
+ */
 export declare function LoadingIndicator({ label, className }: {
     label: string;
     className?: string | undefined;

package/lib/types/client/document/registry.d.ts

@@ -6,6 +6,12 @@ export interface DocumentPreviewDefinition {
     readonly id: string;
     /** File suffixes without a leading dot; compound suffixes such as tar.gz are accepted. */
     readonly extensions: readonly string[];
+    /**
+     * Suffixes among `extensions` whose bytes are not readable text; a file
+     * matching one loses the plain-text fallback among its viewer choices.
+     * Every entry must appear in `extensions`; `register` rejects strays.
+     */
+    readonly binaryExtensions?: readonly string[];
     /** External implementations win over product implementations; defaults to extension. */
     readonly priority?: 'builtin' | 'extension';
     /** Localized implementation label, evaluated when the toolbar renders. @returns the visible name. */
@@ -22,6 +28,13 @@ export interface DocumentPreviewDefinition {
  * @returns matching implementations, external band first, then longest suffix.
  */
 export declare function matchingDocumentPreviews(definitions: readonly DocumentPreviewDefinition[], path: string): readonly DocumentPreviewDefinition[];
+/**
+ * Whether any registered implementation declares the filename's suffix binary.
+ * @param definitions - registered implementations.
+ * @param path - decoded filename or file path.
+ * @returns true when a declared binary suffix matches the filename.
+ */
+export declare function binaryDocumentPath(definitions: readonly DocumentPreviewDefinition[], path: string): boolean;
 /** Observable registry of all live implementations, including lower-priority alternatives. */
 export declare class DocumentPreviewRegistry {
     private readonly registered;
@@ -40,8 +53,10 @@ export declare class DocumentPreviewRegistry {
     readonly subscribe: (listener: () => void) => (() => void);
     /**
      * Register metadata separately from the matching keyed slot component.
-     * @param definition - unique implementation and recognized suffixes.
-     * @returns an idempotent disposer; duplicate live implementation names throw.
+     * @param definition - unique implementation and recognized suffixes; every
+     * `binaryExtensions` entry must appear in `extensions`.
+     * @returns an idempotent disposer; duplicate live implementation names and
+     * binary suffixes outside `extensions` throw.
      */
     register(definition: DocumentPreviewDefinition): () => void;
     /**

package/lib/types/client/document/suffix.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Filename suffix matching shared by the preview registry and the owner's
+ * unviewable list, so every consumer normalizes paths and suffixes alike.
+ */
+/**
+ * Normalize one declared suffix for comparison.
+ * @param extension - declared file suffix, with or without a leading dot.
+ * @returns the suffix lowercased with any leading dot dropped.
+ */
+export declare function normalizeSuffix(extension: string): string;
+/**
+ * The filename a path's suffixes are matched against.
+ * @param path - decoded filename or file path; `\` is accepted as a separator.
+ * @returns the lowercased final path segment.
+ */
+export declare function documentFileName(path: string): string;
+/**
+ * The longest declared suffix ending the filename.
+ * @param name - lowercased filename from {@link documentFileName}.
+ * @param extensions - declared suffixes; compound suffixes such as `tar.gz` are accepted.
+ * @returns the matched suffix's normalized length, or 0 when none matches.
+ */
+export declare function matchedSuffixLength(name: string, extensions: readonly string[]): number;
+//# sourceMappingURL=suffix.d.ts.map

package/lib/types/client/document/unviewable.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether a filename's suffix is a known binary container that no renderer claims.
+ * @param path - decoded filename or file path.
+ * @returns true when the suffix belongs to the unviewable binary list.
+ */
+export declare function unviewableBinaryPath(path: string): boolean;
+//# sourceMappingURL=unviewable.d.ts.map

package/lib/types/client/image/ImageBody.d.ts

@@ -1,4 +1,4 @@
-/** Complete image bytes rendered at their intrinsic CSS-pixel dimensions. */
+/** Complete image bytes rendered rounded within an inset frame, scaled down to the pane's width. */
 import { type ReactNode } from 'react';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { DocumentPreviewProps } from '../document/contract.ts';
@@ -22,9 +22,11 @@ export type ImageBodyProps = DocumentPreviewProps & PropsLocale<'sidebarImage'>;
  */
 export declare function imageMediaType(path: string): ImageMediaType | undefined;
 /**
- * Present complete image bytes without fitting or scaling them to the pane.
+ * Present complete image bytes fitted to the pane's width.
  * @param props - document bytes, resource identity, and locale.
- * @returns an intrinsic-size image whose containing document body provides scrolling.
+ * @returns a rounded image scaled down to the pane's width at its aspect
+ * ratio — a smaller image centres at its intrinsic size — whose containing
+ * document body provides vertical scrolling.
  */
 export declare function ImageBody({ content, resourceAddress, t }: ImageBodyProps): ReactNode;
 export {};

package/lib/types/client/image/index.d.ts

@@ -5,6 +5,8 @@ import type { DocumentPreviewDefinition } from '../document/registry.ts';
 export declare const IMAGE_BODY_ID = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/image";
 /** File suffixes rendered by the builtin image body. */
 export declare const IMAGE_EXTENSIONS: readonly ["png", "jpg", "jpeg", "gif", "webp", "bmp", "ico", "svg"];
+/** Bitmap suffixes whose bytes are unreadable as text; SVG stays out because its XML source is worth reading. */
+export declare const BINARY_IMAGE_EXTENSIONS: readonly ["png", "jpg", "jpeg", "gif", "webp", "bmp", "ico"];
 /**
  * Describe the builtin image renderer independently from its keyed body slot.
  * @param title - locale-owned implementation name.

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

@@ -19,6 +19,7 @@ export declare const zh: {
     'viewer.text': string;
     resourceUnavailable: string;
     rendererUnavailable: string;
+    unsupportedFile: string;
     'error.notFound': string;
     'error.tooLarge': string;
     'error.notText': string;
@@ -42,6 +43,7 @@ export declare const en: {
     'viewer.text': string;
     resourceUnavailable: string;
     rendererUnavailable: string;
+    unsupportedFile: string;
     'error.notFound': string;
     'error.tooLarge': string;
     'error.notText': string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-sidebar-documentpreview",
   "description": "Extensible document previews for Sidebar files: Markdown, highlighted code, images, PDF, HTML, and plain text",
-  "version": "0.1.5-rc.1",
+  "version": "0.1.6-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -50,21 +50,21 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-api-workspace-files": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-resources": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-dockkit": "^0.1.5-rc.1"
+    "@deepseek-ai/dsh-api-gateway": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-workspace-files": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-resources": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-dockkit": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.1"
   },
   "files": [
     "lib/index.js",