# 版本记录 ## v1.2.1 · 侧栏交互优化与批处理修复 优化侧栏按钮排布和路径操作,统一文件列表表头与预览顶栏的视觉效果,并修复 Windows 批处理脚本的启动目录。 - 侧栏展开时,收起、分栏和全屏按钮沿分界线竖排,并适配深色模式的可用与禁用配色。 - 路径栏的文件夹支持右键引用路径文本到对话框、在资源管理器中显示或复制路径。 - 文件列表表头与预览顶栏共用渐变透明和模糊背景。列表滚动时表头固定,列名保持 80% 不透明度。 - 修复从侧栏打开 `.bat` 或 `.cmd` 时的工作目录。Windows 以脚本所在文件夹为启动目录,同目录调用和相对路径可正常使用([#5](https://github.com/tm5452/dsh-workspace-explorer/issues/5))。 ## v1.2.0 · 界面重构与交互优化 重构整体界面视觉效果,统一侧栏、工具栏、标签页和预览窗的视觉风格,优化按钮排布与交互体验,优化文件图标识别,优化深色模式界面显示适配问题。 - 优化了图片、视频播放、音频播放界面和操作。图片自由缩放;视频预览通过卡片进行操作,并添加了全屏观看的界面,查看更自由;音频播放添加胶囊小窗形式,可挂在后台播放。 - 多种常用文件预览不限文件大小。常见文本分段加载,PDF 按需读取,图片和音视频按需读取或流式播放。Office 文档仍遵循 DSH 转换器的大小限制。 - 优化标签展开与收起、拖放和收藏夹操作。同一工作区的会话共享浏览位置,切换工作区时会打开或复用对应的标签。 ## v1.1.36-beta.4 · 预览与标签交互性能 - 工作区标签恢复悬停时展开、移开后收起的动画,右侧空间不足时以右边缘为支点向左展开。 - 工作区标签沿展开方向收起,切换选中标签时也有收起动画,并更新了工作区图标。 - 图片和视频缓存预览尺寸。拖动和缩放使用缓存限制边界,保留指针中心缩放。 - 音乐封面旋转和长标题滚动使用浏览器原生动画,离开可视区域时暂停。 ## v1.1.36-beta.3 · 大文件预览 - PDF 改为按字节范围读取。Office 转换结果也按范围传给预览,输入与输出大小遵循 DSH 的转换器限制。 - 常见文本分段读取,滚动到底时加载下一段,并可返回上一段。无法显示的文件直接提示。 - 视频全屏时将进度条和退出按钮并排放在画面内,下方区域控制整组淡入和淡出。视频播完后,两端按钮常显。 - 预览顶部栏保留独立布局,使用 20% 不透明的白色背景和轻微高斯模糊。全屏播放键与进度栏裁剪分离。 - 全屏播放键直接处理指针释放。图片、视频和滚动文档从原位置加载,可移动至预览顶栏背后,裁剪到窗格分隔线。 - 调整预览顶栏和标签的模糊及透明度。图片、视频缩小后仍可拖动。每个方向上,较小区域的中心保持在较大区域的边缘内。 - 图片交给浏览器直接读取,音视频保留流式播放,桌面协议无法跳转时再切换到可跳转来源。 - 顶部标签滚动区使用右侧栏控制按钮腾出的空间,保留分屏宽度限制。工作区标签悬停展开时保持在顶部可视区域。路径栏悬停时显示收藏星标,删除与工作区浏览之间增加分隔线。 - 加号在队尾打开开始页。拖入文件夹、文件或预览标签,以及切换到未打开的工作区时,新标签插在当前标签右侧。 - 更新工作区标签图标。大图标模式为文件名保留两行高度,统一图标和缩略图的位置。 ## v1.1.36-beta.2 · Explorer 界面调整 - 对齐资源管理器左侧控件边缘,统一文件、文件夹和预览标签的高度、圆角及图标留白。 - 更新删除和收藏夹图标,媒体按钮交互底色使用蓝色系,深色音乐预览窗使用 DSH 背景色。 - 统一音视频预览和音乐胶囊的蓝色配色,覆盖常态控件、文本、图标和进度条。 - 音乐预览底色跟随 DSH 主题。调整路径栏灰色常态、悬停背景、收藏夹和工作区按钮展开样式以及底部排序按钮。 - 细化路径栏悬停颜色,将移除、清空和拖动排序集中到收藏夹编辑状态,并统一使用新的音频文件图标。 - 更新音频文件图标,为无封面音乐使用独立的圆形旋转背景。 - 替换各类文件图标和五个操作图标。音乐胶囊与视频播完后的控制条延时两秒收起,悬停立即展开。 - 为文件底图叠加 DSH 原版的文件类型标记。音乐胶囊向右收拢,悬停时向左连续展开。 - 在工作区内浏览时,同一工作区的会话共享浏览状态。切换到其他工作区会打开或复用该工作区的受限标签页,并显示专用的文件夹图标。 - 将右侧栏的分屏、全屏和收起按钮移到会话标题栏。双击路径栏空白或分隔处即可编辑,收藏星标移到路径栏右端。 - 调整标题栏按钮顺序和颜色、预览标签的选中样式,以及收藏夹和路径栏的退出编辑方式。 - 恢复分栏的原生宽度限制。未选中的工作区标签默认缩为图标,悬停 50 毫秒后展开。收藏夹和工作区内浏览按钮使用相同悬停延迟。 - 工作区标签双向过渡。音视频控件统一延时一秒收起,视频播放和播完时均可收起,播完显示重播图标。全屏退出按钮位于进度条末端,也可按 Esc 退出。 - 全屏退出按钮独立固定在画面右下角。修复 DSH 桌面视频拖动或点击进度条归零,收起的音乐胶囊只显示完整封面。 - 在资源管理器标签之间共享并保存预览窗格比例。 ## v1.1.36-beta.1 · Explorer 图标更新 - 替换资源管理器按钮、收藏状态、视频预览、右键手势提示和拖动备用标志的 SVG,适配浅色与深色主题。 - 恢复原有按钮的状态颜色,收藏后只显示橙黄色星星。 - 更新视频卡片和全屏播放,视频和图片支持以指针为中心缩放,移动满 6 像素才进入拖动状态。 - 音乐预览可缩成胶囊继续播放,可返回预览并定位文件,保留播放进度和暂停状态。 - 音视频在流式播放不可用时改用兼容读取方式。音乐预览铺满窗格,播放按钮叠在圆形封面中央。视频信息可悬停查看。 - 视频全屏保留 DSH 标题栏,悬停控件快速淡入淡出。音乐胶囊长宽减半,播放时旋转封面,并更新两个切换按钮。 - 视频缩放时保持圆角大小,标题和控制条与圆角圆心对齐。播放结束后控制条收成圆形播放键。 - 预览标签拖动超过 6 像素才显示抓手。音乐预览根据窗格高度切换为横排,播放时滚动过长标题。 - 音乐封面使用小尺寸预览图,播放进度独立刷新。胶囊移除艺人行,标题和时间使用同一字号。 - 修复视频标题上沿裁切,深色音乐预览窗使用黑底。普通大小的本地音频一次读取后播放,大文件继续按需读取。 - 封面和长标题按固定帧率更新,播放器不可见时暂停界面动画。 ## v1.1.35 · 文档预览兼容与稳定性 - 适配新版 DSH 的 PDF 渲染器加载和 Office 转换服务,修复 WAV 音频预览。 - 限制异常光谱、3D 模型、KiCad 和归档文件的解析开销。文本预览支持 GBK,图片放大后可在边界内平移。 - 复用 Windows 文件操作进程,增加粘贴和回收操作的等待上限,并把盘符缓存延长到 30 秒。 - 右键手势阈值调为 6 像素。Windows 文件拖到会话区以外时交给宿主处理。 - 修正深色主题、路径大小写比较、旧行号定位、收藏夹裁切及右键菜单键盘关闭的问题。 ## v1.1.35-beta.3 · WAV 预览兼容 - 为 WAV 预览返回明确的音频类型,避免 Chromium 丢弃读取结果。 ## v1.1.35-beta.2 · 桌面端文档预览兼容 - 适配新版 DSH 的 PDF 加载和 Office 转换服务。保留旧版转换服务的兼容路径。 ## v1.1.35-beta.1 · 文件操作与预览稳定性 - 右键手势阈值调为 6 像素。 - 为光谱、模型、电路板和归档预览增加解析边界。普通文本支持 GBK,图片仅在放大后可平移。 - 复用 Windows 文件操作进程,限制单次等待时间,并延长盘符缓存。 - 会话区以外的 Windows 文件拖放交给宿主处理。修正目录大小写比较、旧行号定位、收藏菜单裁切和右键菜单键盘关闭。 - 深色模式适配:分隔线、悬停底色、收藏夹与右键菜单的描边、阴影、预览标签选中态、收藏星标、错误提示都改为跟随宿主主题变量,不再写死浅色值。 ## v1.1.34 · 多标签预览与大文件显示优化 - 从文件列表或下方预览标签拖到顶部标签栏,可打开独立预览卡片并直接加载。拖到会话区可引用文件路径,拖动时用蓝框标出两个落点。 - 下方预览支持固定标签、拖动排序和滚轮横向浏览。固定最左侧标签后,点击新文件会保留原标签。已确认的预览在切回时直接重新加载,切走时释放内容。 - HTML 和 HTM 使用 Chromium 渲染。小窗点击按钮后打开,大窗直接加载。 - TXT、JSON 等长文本按可视范围渲染,保留自动换行和文件链接的行号定位。文本预览最多读取文件开头 2 MB。 ## v1.1.33 · MIT 许可证 - 为插件添加项目级 MIT 许可证,并在 npm 包中声明。保留第三方预览代码的原版权声明和许可证。 ## v1.1.32 · 全会话区域拖放 - 从插件或 Windows 资源管理器拖入文件、文件夹时,整个中间栏都可以接收路径引用,包括标题上方。蓝框内保持背景清晰。 - 两个方向的拖放提示都用 140 毫秒渐显和渐隐。进入或离开投放区时,蓝框粗细用 100 毫秒过渡。 ## v1.1.32-beta.3 · 拖放蓝框粗细过渡 - 双向拖放时,蓝框在进入和离开投放区时用 100 毫秒过渡粗细。 ## v1.1.32-beta.2 · 扩大会话拖放范围并加入渐变 - 拖入会话的蓝框覆盖整个中间栏,包括标题上方。 - 双向拖放的蓝框在出现和消失时短暂渐变。 ## v1.1.32-beta.1 · 拖入会话区域引用路径 - 从插件或 Windows 资源管理器拖动文件或文件夹时,当前会话显示蓝色边框。进入会话区域后边框加粗,松手插入路径引用。 ## v1.1.31 · Windows 右键手势与侧栏交互 - 在右侧栏「电脑文件资源管理器」上半部按住右键滑动。向左后退、向右前进、向上返回上一级。蓝色轨迹随鼠标显示,松手后在右侧栏中央显示动作提示。分屏时操作起点所在的窗格。 - 普通右键仍可打开菜单。发送附件请使用「复制文件到对话框」,左键拖入文件或目录仍用于引用路径。 - 关闭最后一张停靠卡片时,右侧栏保持展开并回到「开始」页。打开或切换卡片时内容渐显,拖动顶部标签页时图标跟随鼠标。 - 纳入 Windows 预发布版的本机磁盘接口兼容修复,支持 DSH NEXT 和使用 Cordis 4 的桌面端。宿主没有 Office 转换服务时,Office 预览显示不可用提示。 ## v1.1.5-beta.7 · 关闭最后一张卡片后返回开始页 - 右侧栏展开时,关闭最后一张停靠卡片会直接回到「开始」页,侧栏保持展开。 - 打开或切换右侧栏卡片,以及返回「开始」页时,卡片内容短暂渐显。 - 拖动右侧栏顶部标签页时,标签图标跟随鼠标。 ## v1.1.5-beta.6 · 右键手势限定在文件管理区 - 只追踪从右侧栏「电脑文件资源管理器」上半部文件管理区起手的右键手势。开始界面、其他卡片和下半部预览区保留原有右键行为。 ## v1.1.5-beta.5 · 右键手势限定在右侧栏 - 只追踪从右侧栏起手的右键手势。会话区保留原有右键行为。 ## v1.1.5-beta.4 · 先画轨迹,再识别手势 - 右键位移小于 2 像素时交给原菜单。达到 2 像素就显示轨迹,松手后再识别和执行动作。 - 动作提示移到右侧栏中央。无可用目录时,右键拖动仍有轨迹反馈。 ## v1.1.5-beta.3 · 提高右键手势触发优先级 - 只有位移小于 2 像素的右键点按会打开菜单。按下即追踪鼠标,即使高速滑动只在松手时上报位移,也会判定手势并显示提示。 - 放宽短轨迹的曲折容差,保留明显折返、绕圈及向下手势的无效提示。松手后蓝色轨迹短暂淡出。 ## v1.1.5-beta.2 · 改进右键手势反馈 - 右键移动 4 像素即进入手势,松手后不弹右键菜单。拖动时显示蓝色轨迹和窗口中央的动作提示。 - 按起点与终点连线的 45° 分界判断方向。向下、明显折返或绕圈的手势只显示无效提示。 ## v1.1.5-beta.1 · Windows 右键手势 - 在 DSH 主窗口按住右键滑动,松手执行目录导航。向左后退、向右前进、向上返回上一级。分屏时以手势起点所在的文件窗格为准。 - 移除右键拖动文件添加附件。普通右键仍可打开文件菜单,通过「复制文件到对话框」添加附件。左键拖入仍用于引用路径。 ## v1.1.4-beta.2 · 修好在 desktop 0.2.2-rc.2 上的注册失败 ### `ctx.inject` 的对象形态在 cordis 4 里是全必填 - 旧代码写的是 `ctx.inject({ connection: true, officeToPdf: { required: false } }, …)`,本意是「等 connection,officeToPdf 可选」。cordis 4 把对象形态当成「服务名 → 拦截配置」,每个键都算必需服务;desktop 0.2.2-rc.2 起没有插件提供 `officeToPdf`,于是回调永远等不到,路由一条都没注册,面板请求 404。 - 现在只 inject 真正必需的 `connection`,`officeToPdf` 改成用时再取(`ctx.get()`,取不到就让 Office 预览返回原来的 503 提示)。 ### 直接读可选服务会抛错 - cordis 4 不允许读没有 inject 的服务(`cannot get property "officeToPdf" without inject`),`src/host/files.js` 里那处直接属性访问会连带把整条路由打成 500。已改为 `ctx.get('officeToPdf')` 并兜住异常,两种 cordis 版本都能跑。 ## v1.1.4-beta.1 · 兼容打包成 app.asar 的桌面端 ### 本机磁盘接口不再只认官方启动方式 - 以前的判断要求宿主进程是官方桌面端 fork 出来的子进程(带 IPC 通道、入口是 `@deepseek-ai/dsh-desktop-host/lib/index.js`)。dsH NEXT 这类把宿主打进 `app.asar` 的版本没有 IPC 通道、入口是 `lib/host.js`,插件因此不注册本机磁盘接口,面板里会看到 404。 - 现在同时接受两种入口,并仍然要求 Windows + Electron 运行环境;普通网页端和不相干的 Electron 应用不会被误判。跳过注册时会输出一条 debug 日志,日后再遇到类似问题能直接看出是「没注册」还是「请求被拒绝」。 ### 请求来源校验改为只拦真正的跨站 - 打包版的转发层会把浏览器的 `origin` 和 `sec-fetch-site` 原样写回请求,旧代码一看到这两个头就返回 403(`本机磁盘接口仅供 Harness 桌面端使用`),所以即使接口注册上了也打不开。 - 现在拒绝的是:`sec-fetch-site` 为 `cross-site` / `same-site`、`origin` 既不是应用内协议也不是回环地址的请求。一次性缩略图票据、自定义请求头、`cross-origin-resource-policy: same-origin` 全部保留,DNS 重绑定也仍然拦得住。 ## v1.1.3 · 路径引用与 Better Sidebar 适配 ### 文件和文件夹可以作为位置引用拖进会话 - 用左键把本机文件或文件夹拖到会话输入框,会插入一个显示名称的引用块。发送时带上完整路径,AI 可以按这个位置找到文件或目录。可从插件或 Windows 资源管理器拖入。 - 需要发送文件内容时,在插件内用右键拖动文件,光标旁会跟随文件类型图标,松手后添加为附件。也可以右键选择「复制文件到对话框」。要直接插入可编辑的路径文字,则选择「引用路径文本到对话框」。 ### 与 Better Sidebar 共存 - 从右侧栏的「+」打开「电脑文件资源管理器」。点击卡片主体进入当前会话的工作区,点击右侧电脑图标直达「此电脑」和本机盘符。 - 插件使用独立入口,DSH 自带的「文件」入口和 Better Sidebar 的文件树可以同时使用。路径引用也可独立使用,无需安装 Better Sidebar。 ### 交互调整 - 底栏新增「按修改时间排序」,最近修改的项目优先。列表、大图标和工作区搜索结果都支持这个排序,开关按文件夹记忆。 - 图片预览可用滚轮围绕鼠标位置缩放,按住左键拖动平移。PDF 和 Office 文档用 Ctrl+滚轮缩放,放大后也可拖动平移。 - 视图和预览按钮集中在底栏右侧,鼠标进入底栏时图标变黑。预览文件名使用浅灰圆角标签,上下分隔线可直接拖动调整高度。右键菜单将会话操作放在上方独立区块。 ## v1.1.2 · 会话文件定位与拖放目标 - **单击在当前浏览页定位。** 点击 AI 交付的文件、改动卡片中的具体文件或回复里的本地文件链接,当前文件浏览页会跳到所在目录、选中文件并展开预览;没有打开的浏览页时会新建一个。 - **拖到右侧打开 DSH 原生视图。** 交付文件和本机文件链接拖到右侧提示区后打开 DSH 文档预览,改动卡片打开该文件的 DSH 差异审阅,可查看原生红绿对比。按住 Shift 点击改动文件也能直接打开差异。 - **拖放提示跟随目标。** 拖动交付文件时提示在 DSH 文档预览中打开,拖动改动文件时提示在 DSH 差异审阅中打开。 - **按文件头声明的编码预览 Python。** `.py` 文件会读取开头注释里的 `coding` 声明(如 GBK),按声明的编码显示;其他文本仍按 UTF-8 校验。 ## v1.1.1 · 独立侧栏与会话文件拖放 - **文件浏览独立于会话。** 切换会话或工作区时,右侧保留文件浏览标签、当前目录和预览。只有点击展开或收起按钮时才播放侧栏动画。 - **在当前标签页预览会话文件。** 单击交付文件卡片或本机文件链接,当前文件浏览页会跳到所在目录、选中文件并展开下方预览。需要独立预览时,可拖到右侧提示区松手,新开一个标签页。 - **拖动时显示文件类型图标。** 图标随鼠标移动,右侧打开区使用轻度模糊和蓝色描边,移入时描边加粗。 - **收藏与大图标。** 收藏夹支持拖动排序并记住顺序。图片和视频缩略图按原比例限制宽高,长图和竖屏视频也能完整显示。工作区模式、收藏夹、预览窗格和视图按钮统一为启用时灰底、悬停时淡蓝底。 - **调整文件区和预览布局。** 列表与大图标按钮移到项目数量左侧,内容分隔线向内缩进。预览封面的文件名和大小靠近操作按钮,视频封面使用圆形播放按钮与顶部信息条。 ## v1.1.0 · 侧栏预览更新 - **直接预览 PDF 和 Office。** PDF、Word、Excel、PowerPoint 可在下方窗格查看。Office 在本机转换,Excel 以打印版式呈现。文档支持上下连续滚动,页面接近可见区域时才渲染。 - **Ctrl+滚轮缩放。** 图片和文档支持围绕鼠标指向的位置放大或缩小。松开 Ctrl 后可照常滚动。文档在滚轮操作结束后按新比例重绘。 - **按类型延迟加载。** 图片、音频和纯文本单击即预览。视频先尝试显示首帧,点击中央按钮才读取并播放。文档、3D 模型、字幕、字体等先显示图标和对应的查看按钮。 - **按需预览压缩包。** 点击「解压预览」后浏览包内目录,选择条目时按需解压到内存中查看。 - **调整预览窗格界面。** 分隔线平时显示为细灰线,悬停或拖动时显示手柄。标题栏与文件工具栏对齐,文件名框内的「×」可单独关闭当前文件预览。 ## 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 发布及其原始安装包。归档标签用于区分早期版本和完整版。