dsh-workspace-explorer 0.0.0-stage → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# 版本记录
+
+## v1.0.1 · 说明文档更新
+
+- README 重写为完整功能说明：按「找到文件」「确认内容」「交给会话」「就地整理」四段组织。
+- 补充完整的支持格式表（图片、音视频、文本、字幕、字体、3D、压缩包、TOML、KiCad、VCD/JCAMP、固件、PDF 与 Office）。
+- 补充权限与限制说明（32 MB 预览上限、2 MB 文本上限、128 项批量上限、300 条搜索上限）。
+- 功能无变更，仅文档与版本号。
+
+## v1.0.0 · 完整正式版
+
+- 浏览 Windows 本机磁盘，支持面包屑、直接输入路径、前进、后退、上一级和刷新。
+- 原生多标签独立导航和预览，支持标签拖动排序、滚轮横移、目录拖入标签栏开新页。
+- 列表与大图标按目录记忆。支持图片和视频缩略图、默认开启且可调整高度的预览窗格。
+- 收藏目录、手动跳转会话工作区，或以会话工作区为根目录按文件名递归搜索。点选搜索结果会进入所在目录并预览。
+- 支持 Shift 区间和 Ctrl 逐项多选、批量复制剪切粘贴和回收站删除，以及重命名、定位系统资源管理器和复制文件路径。
+- 文件可拖入会话作为附件，目录可拖入会话插入绝对路径。
+
+本版整合了本地 `1.1.0-beta.1` 至 `1.1.0-beta.11` 的迭代。GitHub 主分支曾有一个未配套 Release 的中间提交，保留在提交历史中。
+
+## v1.0.0-preview.1 · 早期预览归档
+
+- 支持浏览本机磁盘和单独预览文件。
+- 对应最早的 GitHub 发布及其原始安装包。归档标签用于区分早期版本和完整版。

package/LICENSE-preview-extra

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LeiYuXingZhou
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,107 @@
-# Temporary Holding Version
+# DSH 工作区资源管理器
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在 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`。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-workspace-explorer
+      name: 'dsh-workspace-explorer'