@jaxzhou/dsh-file-explorer 0.1.6 → 0.1.7

package/README.md

@@ -30,9 +30,9 @@ Markdown behind it, a second document open beside it in its own tab, and an expo
 of it to PDF.
 
 **The recording is an older build than the list below.** It predates Mermaid
-diagrams, the PDF and Office previews and the pane's **Download** control, and it
-still shows an export handing the page to the browser's print dialog — which no
-export does now.
+diagrams, the PDF and Office previews, and downloading a file from the pane at
+all, and it still shows an export handing the page to the browser's print dialog —
+which no export does now.
 
 ## What you get
 
@@ -68,14 +68,22 @@ source, with the failure named above it.
 Text previews wrap at their spaces and keep every word whole; an image reads its
 complete bytes.
 
-Every preview carries **Download** in the pane's toolbar, which saves the file
-itself — not a conversion of it, which is why it is the one control that works for
-every kind of file, including the ones this pane will not draw. Every text body
-carries **Copy**, which copies the file's own text — a rendered Markdown document
-copies its Markdown source.
+Every preview carries one **Export** button in the pane's toolbar. Its first row
+is **Download**, which saves the file itself — not a conversion of it — so that row
+is there for every kind of file, including the ones this pane will not draw. **Its
+size is not a limit**: a download is read a window at a time rather than all at
+once, so a file larger than a preview can hold still saves normally — a 260 MB
+release tarball included. Up to 32 MiB it goes quietly to the browser's downloads;
+past that it asks where to put it and streams there, which keeps the memory it
+costs flat however large the file is. Several downloads run at once, each with its
+own row, its own progress and its own **Cancel**, and one failing leaves the
+others alone.
 
-A rendered Markdown or HTML document also carries **Export**, which **downloads a
-file directly** — no print dialog — in either of two formats:
+Every text body carries **Copy**, which copies the file's own text — a rendered
+Markdown document copies its Markdown source.
+
+A rendered Markdown or HTML document adds two rows to that menu — **PDF** and
+**Word** — and each **downloads a file directly**, with no print dialog:
 
 | Format | What it is |
 |---|---|
@@ -199,9 +207,14 @@ restart the profile.
 - **Only the OOXML formats are read.** `.doc`, `.xls` and `.ppt` are the older
   binary container, which this pane does not parse — it says so and offers the
   download instead.
-- **Preview and download are bounded by one complete-file read**, 32 MiB by
-  default in the shipped Web composition. A file above it reports the refusal
-  rather than arriving cut.
+- **A preview is bounded by one complete-file read**, 32 MiB by default in the
+  shipped Web composition: a larger PDF or Office package reports the refusal
+  rather than being shown cut. A **download** is not bounded that way — it pages
+  through the file — so something too large to preview can still be saved.
+- **A large download goes through the browser's save dialog.** Past 32 MiB the
+  bytes stream into a file you pick, which is what keeps the memory cost flat; a
+  browser without that API collects the file first, so a very large download
+  there costs its own size in memory.
 - **Long documents are cut at 60 PDF pages**, and an image past 8 MiB is left out;
   both are stated here because a silent cut reads as a complete export.
 

package/README.zh.md

@@ -27,8 +27,9 @@ dsh --profile web
 （含表格）、切到 **源码** 看它背后的 Markdown、在旁边用另一个标签打开第二份文档，
 最后把它导出为 PDF。
 
-**录屏来自比下面更早的版本。** 它早于 Mermaid 图表、PDF 与 Office 预览以及工具栏
-上的 **下载**，其中那次导出仍然把页面交给浏览器的打印对话框 —— 现在的导出都不会。
+**录屏来自比下面更早的版本。** 它早于 Mermaid 图表、PDF 与 Office 预览，也早于
+「在窗格里直接下载文件」，其中那次导出仍然把页面交给浏览器的打印对话框 —— 现在的
+导出都不会。
 
 ## 能做什么
 
@@ -58,13 +59,18 @@ dsh --profile web
 
 文本预览在空格处折行、保持单词完整；图片读取完整字节。
 
-每一种预览的窗格工具栏里都有 **下载**，保存的是文件本身而不是它的某种转换 ——
-因此这是唯一对**所有**文件类型都可用的控件，包括本窗格不绘制的那些。每一种文本预览
-还有 **复制**，复制的是文件自身的文本——渲染态的 Markdown 复制的是它的 Markdown
-源码。
+每种预览的窗格工具栏里只有**一个导出按钮**，菜单第一行是 **下载**，保存的是文件本身
+而不是它的某种转换 —— 因此这一行对**所有**文件类型都在，包括本窗格不绘制的那些。
+**它不受文件大小限制**：下载按窗口逐段读取而不是一次性读完，所以比预览上限更大的
+文件也能正常保存——260 MB 的发布包也不例外。32 MiB 以内静默存到浏览器的下载目录；
+超过则询问保存位置并直接流式写入，因此内存占用与文件大小无关。可以同时进行多个下载，
+每个都有自己的进度行和 **取消**，其中一个失败不影响其余。
 
-渲染态的 Markdown 与 HTML 还带 **导出** 菜单，**直接下载文件**（不走打印对话框），
-两种格式：
+每一种文本预览还有 **复制**，复制的是文件自身的文本——渲染态的 Markdown 复制的是它的
+Markdown 源码。
+
+渲染态的 Markdown 与 HTML 会在该菜单里再加两行 —— **PDF** 与 **Word** ——
+各自 **直接下载文件**（不走打印对话框）：
 
 | 格式 | 说明 |
 |---|---|
@@ -170,8 +176,11 @@ profile。
   动画。公式显示文件缓存的值，不做重算。
 - **只读取 OOXML 格式**：`.doc`、`.xls`、`.ppt` 是更早的二进制容器，本窗格不解析
   —— 会说明这一点并提供下载。
-- **预览与下载都受同一次「完整读取」上限约束**：官方 Web 组合默认 32 MiB。超过上限
-  的文件会报告被拒绝，而不是被截断后送来。
+- **预览受「完整读取」上限约束**：官方 Web 组合默认 32 MiB，超过的 PDF 或 Office
+  包会报告被拒绝，而不是截断后显示。**下载不受此限制** —— 它按窗口分页读取 —— 所以
+  预览不了的文件仍然可以保存。
+- **大文件下载会走浏览器的保存对话框**：超过 32 MiB 时字节流式写入你选择的文件，
+  内存占用因此恒定；不支持该 API 的浏览器会先收集文件，此时超大下载会占用等量内存。
 - **超长文档会在 60 页 PDF 处截断**，单张超过 8 MiB 的图片会被跳过；写在这里是因为
   静默截断会被误认为完整导出。