dsh-workspace-explorer 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +107 -72
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # 版本记录
2
2
 
3
+ ## v1.0.1 · 说明文档更新
4
+
5
+ - README 重写为完整功能说明：按「找到文件」「确认内容」「交给会话」「就地整理」四段组织。
6
+ - 补充完整的支持格式表（图片、音视频、文本、字幕、字体、3D、压缩包、TOML、KiCad、VCD/JCAMP、固件、PDF 与 Office）。
7
+ - 补充权限与限制说明（32 MB 预览上限、2 MB 文本上限、128 项批量上限、300 条搜索上限）。
8
+ - 功能无变更，仅文档与版本号。
9
+
3
10
  ## v1.0.0 · 完整正式版
4
11
 
5
12
  - 浏览 Windows 本机磁盘，支持面包屑、直接输入路径、前进、后退、上一级和刷新。
package/README.md CHANGED
@@ -1,72 +1,107 @@
1
- # DSH 工作区资源管理器
2
-
3
- 适用于 DeepSeek Harness 的 Windows 桌面插件。通过右侧栏原有的「文件浏览」入口浏览本机磁盘，并在下方独立预览文件。
4
-
5
- ## 安装
6
-
7
- ### 从 npm 安装（推荐）
8
-
9
- ```bash
10
- dsh plugin --profile web add dsh-workspace-explorer
11
- ```
12
-
13
- 也可以在 Harness 的「插件 → 添加插件」里直接输入包名 `dsh-workspace-explorer`，让它自己解析注册表。
14
-
15
- 安装后从系统托盘完全退出 Harness，再重新打开右侧栏的「文件浏览」。
16
-
17
- ### 从 GitHub Release 安装
18
-
19
- 在 Harness 的「插件 → 添加插件」中粘贴下方安装包链接，也可粘贴已下载的本地 `.tgz` 路径：
20
-
21
- ```text
22
- https://github.com/tm5452/dsh-workspace-explorer/releases/download/v1.0.0/dsh-workspace-explorer-1.0.0.tgz
23
- ```
24
-
25
- 已安装早期预览包或 `1.1.0-beta.*` 本地测试包的用户，先在插件列表移除旧条目，再重新安装。发布变更见 [版本记录](CHANGELOG.md)。
26
-
27
- ### 从源码安装
28
-
29
- 将插件目录以 `link:<绝对路径>` 添加。旧的同名插件记录可先从插件列表移除。
30
-
31
- ## 界面实拍
32
-
33
- 大图标视图、收藏夹和图片预览
34
-
35
- ![大图标视图中的图片缩略图、收藏夹菜单和下方图片预览](docs/screenshots/grid-favorites.png)
36
-
37
- **工作区搜索**
38
-
39
- 工作区模式会在结果中显示文件所在的子目录。
40
-
41
- ![工作区模式按文件名搜索并显示结果所在的子目录](docs/screenshots/workspace-search.png)
42
-
43
- **多标签页浏览与管理**
44
-
45
- 在顶部标签栏打开和切换多个文件夹，可拖动标签调整顺序。每个标签页各自保留目录、导航历史和预览。
46
-
47
- ![顶部标签栏同时打开了三个文件夹，当前选中 preview-test](docs/screenshots/stl-preview.png)
48
-
49
- ## 浏览本机磁盘
50
-
51
- - 地址栏在第一行，右侧依次是编辑路径、收藏星标和收藏夹按钮。路径超出宽度时，在路径上滚动鼠标滚轮可左右查看。第二行提供导航、文件操作和工作区模式按钮。
52
- - 用底栏切换列表和大图标。每个目录分别记住所选视图。大图标会为可解码的图片和视频显示内容缩略图。
53
- - 预览窗格默认打开，可用底栏最右侧的按钮开关。拖动中间接缝调整上下高度，也可聚焦接缝后按方向键。关闭再打开会恢复刚才的比例。
54
- - 双击文件夹进入目录。预览窗格打开时，单击文件即可查看。双击文件交给 Windows 默认应用打开。PDF 和 Office 文档也可以从预览栏交给 DSH 文档预览。
55
- - 点地址栏右侧的编辑路径按钮，或在列表中按 Ctrl+L，可以粘贴 Windows 的绝对路径。目录路径打开列表，文件路径选择要预览的文件。
56
- - 从列表或网格把文件拖入当前会话，文件会作为附件加入输入框草稿。单个拖入文件的读取上限为 32 MB。也可右键选择「复制文件路径」，将绝对路径作为文本粘贴。
57
- - 把文件夹或路径栏中的某段目录拖到会话，会在输入框中插入绝对路径。拖到标签栏会为该目录新开一个标签页。
58
- - 右键文件或文件夹可复制、剪切、粘贴、在资源管理器中显示、复制路径和重命名。复制和剪切使用 Windows 文件剪贴板。右键文件夹可粘贴到该文件夹，右键列表空白处可粘贴到当前目录。同名粘贴由 Windows 保留两份。包含符号链接或目录联接的项目可在 Windows 资源管理器中粘贴。
59
- - 选中文件或文件夹后，可用第二行工具栏复制、剪切或删除。工具栏的粘贴始终使用当前目录。工具栏和右键菜单的「删除」都需要确认，并请求移入 Windows 回收站。
60
- - 在列表或大图标视图中，按住 Shift 点选连续区间，按住 Ctrl 逐项选中或取消。复制、剪切和删除可批量操作，每次最多 128 项。多选时预览保留最近一次普通单击的文件。
61
- - 点亮星标会收藏当前目录。收藏夹在地址栏下方悬浮展开，点击外部自动收起。可直接跳转、移除单条收藏或清空列表。收藏保存在本地配置中，移除或清空只更新保存的路径。
62
- - 打开「在工作区内工作」后，该标签以当前会话的工作区为根目录。可按文件名关键词搜索所有可读取的子目录，点选结果会打开文件所在目录并预览。为避免循环和越界，搜索不遍历目录联接。结果最多显示 300 条。
63
- - 「跳转至工作区」可手动进入当前会话的工作区。切换会话时，正在使用的文件浏览页保留目录、历史和预览。
64
- - 点标签栏的「+」，再点「文件浏览」，可新开一个拥有独立目录、历史和预览的标签页。标签显示当前文件夹名。可按住标签拖动排序，标签超出宽度时可在标签栏上滚动鼠标滚轮。
65
-
66
- 本机磁盘访问仅在 Windows 桌面 Host 上启用，按启动 Harness 的 Windows 账户权限访问。粘贴和重命名会修改所选的本机文件或目录。Windows 拒绝访问时会显示提示。盘符首页只列本机磁盘、可移动盘和光驱。图片、音视频和扩展格式的内嵌预览最多读取 32 MB，文本预览读取前 2 MB。
67
-
68
- ## 构建
69
-
70
- 运行 `node scripts/build-client.mjs` 生成 `lib/client.js`。安装目录已包含构建产物。
71
-
72
- 扩展预览实现沿用 [dsh-preview-extra](https://github.com/LeiYuXingZhou/dsh-preview-extra)，许可证见 `LICENSE-preview-extra`。
1
+ # DSH 工作区资源管理器
2
+
3
+ 在 DeepSeek Harness 里和 AI 聊到一半，需要找本机资料、确认文件内容，或把文件交给当前会话时，可以直接在右侧栏完成。安装后，从右侧栏的「文件浏览」进入。插件适用于 Windows 桌面端，按当前 Windows 账户权限访问文件。
4
+
5
+ ## 安装
6
+
7
+ ### 从 npm 安装（推荐）
8
+
9
+ ```bash
10
+ dsh plugin --profile web add dsh-workspace-explorer
11
+ ```
12
+
13
+ 也可以在 Harness 的「插件 → 添加插件」里直接输入包名 `dsh-workspace-explorer`，让它自己解析注册表。
14
+
15
+ 安装后从系统托盘完全退出 Harness，再重新打开右侧栏的「文件浏览」。
16
+
17
+ ### 从 GitHub Release 安装
18
+
19
+ 在 Harness 的「插件 → 添加插件」中粘贴下方安装包链接，也可粘贴已下载的本地 `.tgz` 路径：
20
+
21
+ ```text
22
+ https://github.com/tm5452/dsh-workspace-explorer/releases/download/v1.0.0/dsh-workspace-explorer-1.0.0.tgz
23
+ ```
24
+
25
+ 已安装早期预览包的用户，先在插件列表移除旧条目，再重新安装。发布变更见 [版本记录](CHANGELOG.md)。
26
+
27
+ ### 从源码安装
28
+
29
+ 将插件目录以 `link:<绝对路径>` 添加。旧的同名插件记录可先从插件列表移除。
30
+
31
+ ## 界面实拍
32
+
33
+ 大图标视图、收藏夹和图片预览
34
+
35
+ ![大图标视图中的图片缩略图、收藏夹菜单和下方图片预览](docs/screenshots/grid-favorites.png)
36
+
37
+ **工作区搜索**
38
+
39
+ 工作区模式会在结果中显示文件所在的子目录。
40
+
41
+ ![工作区模式按文件名搜索并显示结果所在的子目录](docs/screenshots/workspace-search.png)
42
+
43
+ **多标签页浏览与管理**
44
+
45
+ 在顶部标签栏打开和切换多个文件夹，可拖动标签调整顺序。每个标签页各自保留目录、导航历史和预览。
46
+
47
+ ![顶部标签栏同时打开了三个文件夹，当前选中 preview-test](docs/screenshots/stl-preview.png)
48
+
49
+ ## 找到文件，保留浏览位置
50
+
51
+ **浏览本机磁盘。** 点首页按钮回到「此电脑」，查看 C、D、E 等可用盘符。双击文件夹进入，页面只显示当前目录下的文件和子文件夹。工具栏可前进、后退、返回上一级和刷新。
52
+
53
+ **用路径直达。** 点地址栏中的任一级目录即可返回那里。路径太长时，把鼠标放在地址栏上滚动，可左右查看。点右侧的编辑按钮或按 Ctrl+L，可直接粘贴绝对路径。输入文件夹路径会进入该目录，输入文件路径会定位并预览该文件。
54
+
55
+ **同时打开多个目录。** 点顶部「+」再选「文件浏览」，每个标签页各自保留目录、前进后退历史和预览。标签显示当前文件夹名，可拖动排序，放不下时可用滚轮左右查看。普通浏览模式下，切换会话会保留原来的浏览位置。
56
+
57
+ **每个目录记住自己的视图。** 底部可切换列表和大图标。列表显示名称、类型和大小。大图标可直接看到图片和可解码视频的缩略图。下次进入同一目录，会沿用上次的选择。
58
+
59
+ **收藏常用目录。** 点地址栏旁的星标收藏当前文件夹。悬浮收藏夹只显示文件夹名，点击即可直达，操作面板外的内容时会自动收起。移除单项或清空只修改收藏记录。
60
+
61
+ ## 确认文件内容，再决定怎么用
62
+
63
+ **单击预览，双击打开。** 下方预览窗默认开启，底栏右侧按钮可随时收起或展开，拖动中间的分隔线可调整上下比例。切换文件夹时可继续查看上一次选中的文件。双击文件则交给 Windows 默认应用打开。
64
+
65
+ **在侧栏查看多种内容。** 可看图片、文本、字幕和字体，播放支持解码的音视频，查看 ZIP 等压缩包的内容，旋转和缩放 STL、OBJ 等 3D 模型，也支持 TOML、KiCad 等部分工程格式。PDF 和 Office 文档可点预览窗右上角的「在 DSH 文档预览中打开」。
66
+
67
+ | 类别 | 支持格式 | 预览内容 |
68
+ | --- | --- | --- |
69
+ | 图片 | PNG、JPG / JPEG、GIF、WebP、BMP、ICO、AVIF | 显示图片 |
70
+ | 视频 | MP4、WebM、M4V、MOV、MKV | 播放视频，取决于 DSH 内置浏览器能否解码 |
71
+ | 音频 | MP3、WAV、OGG、OGA、M4A、AAC、FLAC、Opus | 播放音频，同样取决于解码支持 |
72
+ | 纯文本与代码 | UTF-8 编码的 TXT、MD、JSON、CSV、HTML、脚本等 | 显示原始文本，最多读取前 2 MB |
73
+ | 字幕 | SRT、VTT、ASS、SSA | 查看字幕时间和正文，也可切换到原始文本 |
74
+ | 字体 | TTF、OTF、WOFF、WOFF2 | 查看字体样张 |
75
+ | 3D 模型 | STL、OBJ、PLY、GLB、glTF | 旋转、缩放、平移模型，可切换线框。glTF 须内嵌模型数据 |
76
+ | 压缩包 | ZIP、JAR、WAR、APK、TAR、GZ、TAR.GZ / TGZ | 浏览包内文件，查看部分条目内容 |
77
+ | 配置文件 | TOML | 按表查看配置键、类型和值 |
78
+ | 电路设计 | KiCad 原理图 .kicad_sch、PCB .kicad_pcb | 查看图形，支持缩放和平移 |
79
+ | 波形与光谱 | VCD、JCAMP-DX（.jdx、.dx） | 查看信号波形或光谱曲线 |
80
+ | 固件 | Intel HEX（.hex）、DFU（.dfu） | 查看数据地址、数据段和校验信息 |
81
+ | PDF 与 Office | PDF、DOC / DOCX、XLS / XLSX、PPT / PPTX | 交给 DSH 文档预览 |
82
+
83
+ 侧栏需要完整读取的格式，单文件上限为 32 MB。7Z、RAR 等压缩包可双击用 Windows 默认应用打开。
84
+
85
+ ## 让文件进入当前会话
86
+
87
+ **拖入文件就是添加附件。** 从列表或大图标视图把文件拖到左侧输入框，文件会加入当前会话的草稿，发送前仍可检查。遇到 DSH 无法接收的文件，可右键「复制文件路径」，再把路径粘贴到对话里。
88
+
89
+ **拖入文件夹就是插入路径。** 列表里的文件夹和地址栏里的任一级目录都可以拖。拖到对话输入框，会插入该目录的绝对路径。拖到顶部标签栏，会为它新开一个文件浏览页。
90
+
91
+ **按需切到会话工作区。** 「跳转至工作区」只执行一次跳转。「在工作区内工作」则将当前会话的工作区设为该标签页的根目录，并显示搜索栏。输入文件名关键词，可搜索各级子目录。结果会标出所在目录，点击后直接定位到文件并打开预览。切换到不同工作区的会话时，该模式会跟随切换。关闭模式即可回到之前的普通浏览位置。
92
+
93
+ ## 就地整理文件
94
+
95
+ **单项和批量操作。** 右键文件或文件夹，可复制、剪切、粘贴、重命名、复制路径、在 Windows 资源管理器中显示或删除。按住 Shift 可选连续区间，按住 Ctrl 可逐项选中或取消。多选后可批量复制、剪切或删除。
96
+
97
+ **与 Windows 剪贴板配合。** 工具栏的粘贴会把文件放进当前目录，右键某个文件夹则可直接粘贴到该文件夹内。同名粘贴会保留两份，删除需确认后移入 Windows 回收站。
98
+
99
+ ## 权限与限制
100
+
101
+ 本机磁盘访问仅在 Windows 桌面 Host 上启用，按启动 Harness 的 Windows 账户权限访问。粘贴和重命名会修改所选的本机文件或目录，Windows 拒绝访问时会显示提示。盘符首页只列本机磁盘、可移动盘和光驱。内嵌预览最多读取 32 MB，文本预览读取前 2 MB。批量操作每次最多 128 项，工作区搜索结果最多显示 300 条，且不遍历目录联接。
102
+
103
+ ## 构建
104
+
105
+ 运行 `node scripts/build-client.mjs` 生成 `lib/client.js`。安装目录已包含构建产物。
106
+
107
+ 扩展预览实现沿用 [dsh-preview-extra](https://github.com/LeiYuXingZhou/dsh-preview-extra)，许可证见 `LICENSE-preview-extra`。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-workspace-explorer",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "Windows disk browsing, file operations and persistent preview in DeepSeek Harness Desktop.",
5
5
  "type": "module",
6
6
  "main": "./lib/index.js",