dsh-workspace-explorer 1.0.1 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 版本记录
 
+## v1.1.1 · 独立侧栏与会话文件拖放
+
+- **文件浏览独立于会话。** 切换会话或工作区时，右侧保留文件浏览标签、当前目录和预览。只有点击展开或收起按钮时才播放侧栏动画。
+- **在当前标签页预览会话文件。** 单击交付文件卡片或本机文件链接，当前文件浏览页会跳到所在目录、选中文件并展开下方预览。需要独立预览时，可拖到右侧提示区松手，新开一个标签页。
+- **拖动时显示文件类型图标。** 图标随鼠标移动，右侧打开区使用轻度模糊和蓝色描边，移入时描边加粗。
+- **收藏与大图标。** 收藏夹支持拖动排序并记住顺序。图片和视频缩略图按原比例限制宽高，长图和竖屏视频也能完整显示。工作区模式、收藏夹、预览窗格和视图按钮统一为启用时灰底、悬停时淡蓝底。
+- **调整文件区和预览布局。** 列表与大图标按钮移到项目数量左侧，内容分隔线向内缩进。预览封面的文件名和大小靠近操作按钮，视频封面使用圆形播放按钮与顶部信息条。
+
+## v1.1.0 · 侧栏预览更新
+
+- **直接预览 PDF 和 Office。** PDF、Word、Excel、PowerPoint 可在下方窗格查看。Office 在本机转换，Excel 以打印版式呈现。文档支持上下连续滚动，页面接近可见区域时才渲染。
+- **Ctrl＋滚轮缩放。** 图片和文档支持围绕鼠标指向的位置放大或缩小。松开 Ctrl 后可照常滚动。文档在滚轮操作结束后按新比例重绘。
+- **按类型延迟加载。** 图片、音频和纯文本单击即预览。视频先尝试显示首帧，点击中央按钮才读取并播放。文档、3D 模型、字幕、字体等先显示图标和对应的查看按钮。
+- **按需预览压缩包。** 点击「解压预览」后浏览包内目录，选择条目时按需解压到内存中查看。
+- **调整预览窗格界面。** 分隔线平时显示为细灰线，悬停或拖动时显示手柄。标题栏与文件工具栏对齐，文件名框内的「×」可单独关闭当前文件预览。
+
 ## v1.0.1 · 说明文档更新
 
 - README 重写为完整功能说明：按「找到文件」「确认内容」「交给会话」「就地整理」四段组织。

package/README.md

@@ -1,107 +1,111 @@
-# DSH 工作区资源管理器
-
-在 DeepSeek Harness 里和 AI 聊到一半，需要找本机资料、确认文件内容，或把文件交给当前会话时，可以直接在右侧栏完成。安装后，从右侧栏的「文件浏览」进入。插件适用于 Windows 桌面端，按当前 Windows 账户权限访问文件。
-
-## 安装
-
-### 从 npm 安装（推荐）
-
-```bash
-dsh plugin --profile web add dsh-workspace-explorer
-```
-
-也可以在 Harness 的「插件 → 添加插件」里直接输入包名 `dsh-workspace-explorer`，让它自己解析注册表。
-
-安装后从系统托盘完全退出 Harness，再重新打开右侧栏的「文件浏览」。
-
-### 从 GitHub Release 安装
-
-在 Harness 的「插件 → 添加插件」中粘贴下方安装包链接，也可粘贴已下载的本地 `.tgz` 路径：
-
-```text
-https://github.com/tm5452/dsh-workspace-explorer/releases/download/v1.0.0/dsh-workspace-explorer-1.0.0.tgz
-```
-
-已安装早期预览包的用户，先在插件列表移除旧条目，再重新安装。发布变更见 [版本记录](CHANGELOG.md)。
-
-### 从源码安装
-
-将插件目录以 `link:<绝对路径>` 添加。旧的同名插件记录可先从插件列表移除。
-
-## 界面实拍
-
-大图标视图、收藏夹和图片预览
-
-![大图标视图中的图片缩略图、收藏夹菜单和下方图片预览](docs/screenshots/grid-favorites.png)
-
-**工作区搜索**
-
-工作区模式会在结果中显示文件所在的子目录。
-
-![工作区模式按文件名搜索并显示结果所在的子目录](docs/screenshots/workspace-search.png)
-
-**多标签页浏览与管理**
-
-在顶部标签栏打开和切换多个文件夹，可拖动标签调整顺序。每个标签页各自保留目录、导航历史和预览。
-
-![顶部标签栏同时打开了三个文件夹，当前选中 preview-test](docs/screenshots/stl-preview.png)
-
-## 找到文件，保留浏览位置
-
-**浏览本机磁盘。** 点首页按钮回到「此电脑」，查看 C、D、E 等可用盘符。双击文件夹进入，页面只显示当前目录下的文件和子文件夹。工具栏可前进、后退、返回上一级和刷新。
-
-**用路径直达。** 点地址栏中的任一级目录即可返回那里。路径太长时，把鼠标放在地址栏上滚动，可左右查看。点右侧的编辑按钮或按 Ctrl+L，可直接粘贴绝对路径。输入文件夹路径会进入该目录，输入文件路径会定位并预览该文件。
-
-**同时打开多个目录。** 点顶部「+」再选「文件浏览」，每个标签页各自保留目录、前进后退历史和预览。标签显示当前文件夹名，可拖动排序，放不下时可用滚轮左右查看。普通浏览模式下，切换会话会保留原来的浏览位置。
-
-**每个目录记住自己的视图。** 底部可切换列表和大图标。列表显示名称、类型和大小。大图标可直接看到图片和可解码视频的缩略图。下次进入同一目录，会沿用上次的选择。
-
-**收藏常用目录。** 点地址栏旁的星标收藏当前文件夹。悬浮收藏夹只显示文件夹名，点击即可直达，操作面板外的内容时会自动收起。移除单项或清空只修改收藏记录。
-
-## 确认文件内容，再决定怎么用
-
-**单击预览，双击打开。** 下方预览窗默认开启，底栏右侧按钮可随时收起或展开，拖动中间的分隔线可调整上下比例。切换文件夹时可继续查看上一次选中的文件。双击文件则交给 Windows 默认应用打开。
-
-**在侧栏查看多种内容。** 可看图片、文本、字幕和字体，播放支持解码的音视频，查看 ZIP 等压缩包的内容，旋转和缩放 STL、OBJ 等 3D 模型，也支持 TOML、KiCad 等部分工程格式。PDF 和 Office 文档可点预览窗右上角的「在 DSH 文档预览中打开」。
-
-| 类别 | 支持格式 | 预览内容 |
-| --- | --- | --- |
-| 图片 | PNG、JPG / JPEG、GIF、WebP、BMP、ICO、AVIF | 显示图片 |
-| 视频 | MP4、WebM、M4V、MOV、MKV | 播放视频，取决于 DSH 内置浏览器能否解码 |
-| 音频 | MP3、WAV、OGG、OGA、M4A、AAC、FLAC、Opus | 播放音频，同样取决于解码支持 |
-| 纯文本与代码 | UTF-8 编码的 TXT、MD、JSON、CSV、HTML、脚本等 | 显示原始文本，最多读取前 2 MB |
-| 字幕 | SRT、VTT、ASS、SSA | 查看字幕时间和正文，也可切换到原始文本 |
-| 字体 | TTF、OTF、WOFF、WOFF2 | 查看字体样张 |
-| 3D 模型 | STL、OBJ、PLY、GLB、glTF | 旋转、缩放、平移模型，可切换线框。glTF 须内嵌模型数据 |
-| 压缩包 | ZIP、JAR、WAR、APK、TAR、GZ、TAR.GZ / TGZ | 浏览包内文件，查看部分条目内容 |
-| 配置文件 | TOML | 按表查看配置键、类型和值 |
-| 电路设计 | KiCad 原理图 .kicad_sch、PCB .kicad_pcb | 查看图形，支持缩放和平移 |
-| 波形与光谱 | VCD、JCAMP-DX（.jdx、.dx） | 查看信号波形或光谱曲线 |
-| 固件 | Intel HEX（.hex）、DFU（.dfu） | 查看数据地址、数据段和校验信息 |
-| PDF 与 Office | PDF、DOC / DOCX、XLS / XLSX、PPT / PPTX | 交给 DSH 文档预览 |
-
-侧栏需要完整读取的格式，单文件上限为 32 MB。7Z、RAR 等压缩包可双击用 Windows 默认应用打开。
-
-## 让文件进入当前会话
-
-**拖入文件就是添加附件。** 从列表或大图标视图把文件拖到左侧输入框，文件会加入当前会话的草稿，发送前仍可检查。遇到 DSH 无法接收的文件，可右键「复制文件路径」，再把路径粘贴到对话里。
-
-**拖入文件夹就是插入路径。** 列表里的文件夹和地址栏里的任一级目录都可以拖。拖到对话输入框，会插入该目录的绝对路径。拖到顶部标签栏，会为它新开一个文件浏览页。
-
-**按需切到会话工作区。** 「跳转至工作区」只执行一次跳转。「在工作区内工作」则将当前会话的工作区设为该标签页的根目录，并显示搜索栏。输入文件名关键词，可搜索各级子目录。结果会标出所在目录，点击后直接定位到文件并打开预览。切换到不同工作区的会话时，该模式会跟随切换。关闭模式即可回到之前的普通浏览位置。
-
-## 就地整理文件
-
-**单项和批量操作。** 右键文件或文件夹，可复制、剪切、粘贴、重命名、复制路径、在 Windows 资源管理器中显示或删除。按住 Shift 可选连续区间，按住 Ctrl 可逐项选中或取消。多选后可批量复制、剪切或删除。
-
-**与 Windows 剪贴板配合。** 工具栏的粘贴会把文件放进当前目录，右键某个文件夹则可直接粘贴到该文件夹内。同名粘贴会保留两份，删除需确认后移入 Windows 回收站。
-
-## 权限与限制
-
-本机磁盘访问仅在 Windows 桌面 Host 上启用，按启动 Harness 的 Windows 账户权限访问。粘贴和重命名会修改所选的本机文件或目录，Windows 拒绝访问时会显示提示。盘符首页只列本机磁盘、可移动盘和光驱。内嵌预览最多读取 32 MB，文本预览读取前 2 MB。批量操作每次最多 128 项，工作区搜索结果最多显示 300 条，且不遍历目录联接。
-
-## 构建
-
-运行 `node scripts/build-client.mjs` 生成 `lib/client.js`。安装目录已包含构建产物。
-
-扩展预览实现沿用 [dsh-preview-extra](https://github.com/LeiYuXingZhou/dsh-preview-extra)，许可证见 `LICENSE-preview-extra`。
+# DSH 工作区资源管理器
+
+在 DeepSeek Harness 里和 AI 聊到一半，需要找本机资料、确认文件内容，或把文件交给当前会话时，可以直接在右侧栏完成。安装后，从右侧栏的「文件浏览」进入。插件适用于 Windows 桌面端，按当前 Windows 账户权限访问文件。
+
+## 安装
+
+### 从 npm 安装（推荐）
+
+```bash
+dsh plugin --profile web add dsh-workspace-explorer
+```
+
+也可以在 Harness 的「插件 → 添加插件」里直接输入包名 `dsh-workspace-explorer`，让它自己解析注册表。
+
+安装后从系统托盘完全退出 Harness，再重新打开右侧栏的「文件浏览」。
+
+### 从 GitHub Release 安装
+
+在 Harness 的「插件 → 添加插件」中粘贴下方安装包链接，也可粘贴已下载的本地 `.tgz` 路径：
+
+```text
+https://github.com/tm5452/dsh-workspace-explorer/releases/download/v1.1.1/dsh-workspace-explorer-1.1.1.tgz
+```
+
+已安装早期预览包的用户，先在插件列表移除旧条目，再重新安装。发布变更见 [版本记录](CHANGELOG.md)。
+
+### 从源码安装
+
+将插件目录以 `link:<绝对路径>` 添加。旧的同名插件记录可先从插件列表移除。
+
+## 界面实拍
+
+大图标视图、收藏夹和图片预览
+
+![大图标视图中的图片缩略图、收藏夹菜单和下方图片预览](docs/screenshots/grid-favorites.png)
+
+**工作区搜索**
+
+工作区模式会在结果中显示文件所在的子目录。
+
+![工作区模式按文件名搜索并显示结果所在的子目录](docs/screenshots/workspace-search.png)
+
+**多标签页浏览与管理**
+
+在顶部标签栏打开和切换多个文件夹，可拖动标签调整顺序。每个标签页各自保留目录、导航历史和预览。
+
+![顶部标签栏同时打开了三个文件夹，当前选中 preview-test](docs/screenshots/stl-preview.png)
+
+## 找到文件，保留浏览位置
+
+**浏览本机磁盘。** 点首页按钮回到「此电脑」，查看 C、D、E 等可用盘符。双击文件夹进入，页面只显示当前目录下的文件和子文件夹。工具栏可前进、后退、返回上一级和刷新。
+
+**用路径直达。** 点地址栏中的任一级目录即可返回那里。路径太长时，把鼠标放在地址栏上滚动，可左右查看。点右侧的编辑按钮或按 Ctrl+L，可直接粘贴绝对路径。输入文件夹路径会进入该目录，输入文件路径会定位并预览该文件。
+
+**同时打开多个目录。** 点顶部「+」再选「文件浏览」，每个标签页各自保留目录、前进后退历史和预览。标签显示当前文件夹名，可拖动排序，放不下时可用滚轮左右查看。同一窗口中的会话共享这组文件浏览标签，切换会话或工作区时会保留当前浏览状态。
+
+**每个目录记住自己的视图。** 底部可切换列表和大图标。列表显示名称、类型和大小。大图标可直接看到图片和可解码视频的缩略图。下次进入同一目录，会沿用上次的选择。
+
+**收藏常用目录。** 点地址栏旁的星标收藏当前文件夹。点击收藏项即可直达，也可以上下拖动排序，顺序会自动保存。操作面板外的内容时会自动收起。移除单项或清空只修改收藏记录。
+
+## 确认文件内容，再决定怎么用
+
+**单击预览，双击打开。** 图片、音频和纯文本单击即预览。其他格式先显示封面，点击对应按钮后才加载内容。视频封面会尝试显示首帧。双击文件可用 Windows 默认应用打开。
+
+**控制下方预览窗。** 窗格默认开启，底栏右侧按钮可随时收起或展开。分隔线平时显示为细灰线，悬停或拖动时显示手柄。文件名右侧的「×」可单独关闭当前文件预览。切换文件夹时可继续查看上一次选中的文件。
+
+**在侧栏浏览文档并缩放。** PDF 和 Office 文档可上下连续滚动。Office 使用 Harness 本机转换服务，Excel 按打印版式显示。鼠标放在图片或文档内容区时，按住 Ctrl 滚动滚轮可缩放。右上角仍可打开 DSH 文档预览。
+
+| 类别 | 支持格式 | 预览内容 |
+| --- | --- | --- |
+| 图片 | PNG、JPG / JPEG、GIF、WebP、BMP、ICO、AVIF | 显示图片 |
+| 视频 | MP4、WebM、M4V、MOV、MKV 等 | 尝试显示首帧，点击播放。取决于 DSH 内置浏览器能否解码 |
+| 音频 | MP3、WAV、OGG、OGA、M4A、AAC、FLAC、Opus | 播放音频，同样取决于解码支持 |
+| 纯文本与代码 | UTF-8 编码的 TXT、MD、JSON、CSV、HTML、脚本等 | 显示原始文本，最多读取前 2 MB |
+| 字幕 | SRT、VTT、ASS、SSA | 查看字幕时间和正文，也可切换到原始文本 |
+| 字体 | TTF、OTF、WOFF、WOFF2 | 查看字体样张 |
+| 3D 模型 | STL、OBJ、PLY、GLB、glTF | 旋转、缩放、平移模型，可切换线框。glTF 须内嵌模型数据 |
+| 压缩包 | ZIP、JAR、WAR、APK、TAR、GZ、TAR.GZ / TGZ | 点击「解压预览」后浏览包内文件，按需查看条目 |
+| 配置文件 | TOML | 按表查看配置键、类型和值 |
+| 电路设计 | KiCad 原理图 .kicad_sch、PCB .kicad_pcb | 查看图形，支持缩放和平移 |
+| 波形与光谱 | VCD、JCAMP-DX（.jdx、.dx） | 查看信号波形或光谱曲线 |
+| 固件 | Intel HEX（.hex）、DFU（.dfu） | 查看数据地址、数据段和校验信息 |
+| PDF 与 Office | PDF、DOC / DOCX、XLS / XLSX、PPT / PPTX | 点击「查看文档」后连续滚动，支持 Ctrl＋滚轮缩放 |
+
+侧栏需要完整读取的格式，单文件上限为 32 MB。7Z、RAR 等压缩包可双击用 Windows 默认应用打开。
+
+## 在会话与文件之间切换
+
+**打开会话里的文件。** 点击 AI 交付的文件卡片或回复中的本地文件链接，当前文件浏览页会跳到所在文件夹、选中文件并显示预览。把卡片或链接拖到右侧标出的区域，可在新标签页预览。预览栏右上角仍可使用 DSH 原生文档预览。
+
+**拖入文件就是添加附件。** 从列表或大图标视图把文件拖到左侧输入框，文件会加入当前会话的草稿，发送前仍可检查。遇到 DSH 无法接收的文件，可右键「复制文件路径」，再把路径粘贴到对话里。
+
+**拖入文件夹就是插入路径。** 列表里的文件夹和地址栏里的任一级目录都可以拖。拖到对话输入框，会插入该目录的绝对路径。拖到顶部标签栏，会为它新开一个文件浏览页。
+
+**按需切到会话工作区。** 「跳转至工作区」只执行一次跳转。「在工作区内工作」会把启用时的工作区设为该标签页的根目录，并显示搜索栏。输入文件名关键词，可搜索各级子目录。结果会标出所在目录，点击后直接定位到文件并打开预览。关闭模式即可回到之前的普通浏览位置。
+
+## 就地整理文件
+
+**单项和批量操作。** 右键文件或文件夹，可复制、剪切、粘贴、重命名、复制路径、在 Windows 资源管理器中显示或删除。按住 Shift 可选连续区间，按住 Ctrl 可逐项选中或取消。多选后可批量复制、剪切或删除。
+
+**与 Windows 剪贴板配合。** 工具栏的粘贴会把文件放进当前目录，右键某个文件夹则可直接粘贴到该文件夹内。同名粘贴会保留两份，删除需确认后移入 Windows 回收站。
+
+## 权限与限制
+
+本机磁盘访问仅在 Windows 桌面 Host 上启用，按启动 Harness 的 Windows 账户权限访问。粘贴和重命名会修改所选的本机文件或目录，Windows 拒绝访问时会显示提示。盘符首页只列本机磁盘、可移动盘和光驱。内嵌预览最多读取 32 MB，文本预览读取前 2 MB。批量操作每次最多 128 项，工作区搜索结果最多显示 300 条，且不遍历目录联接。
+
+## 构建
+
+从源码安装时，先运行 `npm install` 安装 PDF.js，再运行 `node scripts/build-client.mjs` 生成 `lib/client.js`。发布包已包含构建产物。
+
+扩展预览实现沿用 [dsh-preview-extra](https://github.com/LeiYuXingZhou/dsh-preview-extra)，许可证见 `LICENSE-preview-extra`。