更新日志（桌面端）#

本页记录桌面客户端（Windows / macOS / Linux）的功能更新。客户端与服务端分开发版、互不影响：服务端 / 管理端变更见 服务端更新日志，移动客户端见 移动端更新日志，安装包下载见 下载安装 与 历史版本。

[未发布]#

新增#

• 系统右键菜单「上传到 Cloud Blox」
  • macOS：在访达中右键文件或文件夹，右键菜单最外层直接出现「上传到 Cloud Blox」，支持多选一次提交；由随包分发的访达扩展提供，首次安装启动后自动启用，也可在「系统设置 → 登录项与扩展 → 访达扩展」中自行开关。
  • Windows：在资源管理器中右键文件或文件夹可上传，Windows 11 需先点「显示更多选项」；免安装（便携）版不写注册表，因此不提供该功能。
  • 未登录时点击只会唤起窗口，登录完成后自动接着弹出上传位置选择；已在文件页浏览某个目录时直接上传到当前目录。
  • 设置页「系统集成」新增开关可随时关闭。

变更#

• Windows 右键菜单自动识别包标识：官网安装包继续走注册表动词（Win11 在「显示更多选项」）；将来商店 MSIX 或稀疏包带上包标识、并注册 IExplorerCommand 后，自动切到顶层菜单并摘掉传统动词，避免两条重复项。仅有商店签名、尚未挂上现代菜单项时仍保留传统动词，菜单不会消失。

修复#

---

[1.0.2] - 2026-09-02#

新增#

• Linux 安装包
  • 新增 Linux 桌面客户端打包（x64），提供 AppImage、DEB（Debian / Ubuntu）与 RPM（Fedora / openSUSE）三种格式；下载安装 页在安装包发布后自动开放下载。
  • Linux 版支持系统托盘、开机自启与深链接 cloudblox://，与 Windows / macOS 功能一致。

变更#

• 安装包命名统一：安装包统一为 CloudBlox-{版本}-{系统}-{架构}[-变体].{后缀}，Windows 安装程序改名为 CloudBlox-{版本}-windows-x64-setup.exe，便携版为 -windows-x64-portable.zip；「检查更新」与历史版本页按新命名生成链接，旧版本的下载地址保持不变。

---

[1.0.1] - 2026-09-02#

新增#

• 全局上传面板

  • 上传进度面板提升到应用外壳层，在任意页面都可见：展开态显示总进度与逐任务的暂停 / 继续 / 重试 / 取消，可最小化为进度胶囊或直接关闭，关闭后上传继续在后台进行。
  • 顶栏上传按钮与全局拖拽上传都会重新唤出面板；确认上传后不再强制跳转到传输页。

• Windows 免安装便携版与多语言安装包

  • 新增 -portable.zip 便携版：解压即用，数据库、登录凭据、预览缓存与 WebView 缓存全部保存在程序旁的 data/，不写注册表，删除目录即卸载。
  • -setup.exe 安装时可选简体中文 / English；MSI 提供简体中文与 English 两份；安装包与程序文件写入发行者、版权等元数据。

• 传输可靠性改造

  • 上传前预检存储桶「单文件大小上限 / 扩展名规则」，超限直接提示，不再传完整个文件才收到 413 错误。
  • 传输失败自动区分错误类型：网络等临时故障按设置的次数退避重试；超限、类型不允许等明确错误不再无谓重试。
  • 设置页新增「失败自动重试次数」（0–30，默认 10）。
  • 大文件上传显示阶段提示：「正在计算文件校验值」「等待云端校验合并」，不再看起来卡在 0% 或 100%。

• 传输列表预览

  • 传输任务显示文件类型图标 / 图片缩略图与方向角标；点击可直接预览图片或打开文件。

• 托盘与菜单栏账号管理

  • 托盘显示当前账号与服务器，新增「切换账号」子菜单与「添加账号」入口，macOS 菜单栏同步提供；Windows / Linux 托盘同样生效。
  • 窗口已显示时托盘「显示窗口」项自动置灰。

• 说明页与检查更新

  • 文档站将 桌面客户端 提升为一级栏目：下载安装、快速开始、使用说明与历史版本。
  • 安装包可免费下载，不按授权版本拆分；客户端只用于连接你自己部署的服务器。
  • 客户端可通过菜单栏或托盘打开帮助中心、检查更新与关于窗口；发现新版本时可直接下载当前系统安装包。

• 网盘化改版

  • 全新的侧边导航：全部文件、最近使用、我的收藏，以及传输列表、同步空间、冲突中心、回收站。
  • 文件浏览改为按目录逐级加载，大容量存储桶不再需要等待整棵目录树加载完成。
  • 支持新建文件夹、重命名、收藏，以及按名称、大小、修改时间排序。
  • 搜索改为在服务端按当前目录范围内跨层级查找，结果实时返回。
  • 图片、视频、音频、文本与 PDF 支持在客户端内直接预览，无需先下载。
  • 网格视图按文件类型显示彩色图标与扩展名角标，列表视图补充位置与修改时间列。
  • 回收站改为按存储桶分页加载，并对「彻底删除」增加独立二次确认。

• 多账号切换

  • 设置页新增账号列表，支持一键切换不同服务器 / 不同账号。
  • 支持「添加账号」（登录其他服务器或账号，不影响当前登录）与「移除账号」（清理本机登录状态与缓存）。
  • 切换不撤销云端会话，各账号的离线文件、传输记录与缓存相互隔离；登录已过期的账号会引导重新登录。

变更#

• 回收站页重构：存储桶改为可搜索的下拉选择器（按名称 / 区域过滤，回车选中首项），全部文件页复用同一存储桶标签；首次加载与切换存储桶时显示骨架行 / 卡片，区分「暂无存储桶 / 加载失败 / 回收站为空」三种空态；带过期时间的条目显示自动清理倒计时。新增列表 / 卡片双视图（与全部文件一致的圆形勾选与全选交互）、显示回收站总数，名称列带文件类型图标。
• 首页加载：最近使用列表按账号缓存，返回首页先显示上次内容再静默刷新；首次加载用固定高度骨架行代替转圈，各板块高度稳定不再跳动。
• 启动体积：页面按路由懒加载；PPTX / HLS / Excel / PDF / 代码高亮等预览依赖只在预览对应文件时加载，首屏同步加载的脚本由约 4.3 MB 降至约 0.7 MB。
• 传输状态呈现：阶段文案、字节进度、带状态码的错误说明、重试倒计时与速度 / ETA 统一；总量未知时显示「已下载 X · 总大小未知」。选择或拖入文件后立即提示「正在读取文件 / 准备上传」，悬浮条同时覆盖上传与下载。
• 回收站分页：去掉常驻「加载更多」，改为触底自动加载；删除或还原后列表不足一屏会沿游标补页，只有服务端确认总数为 0 才显示空回收站。
• 启动与刷新性能：启动和刷新不再一次性拉取全部存储桶的完整文件清单，文件数量多的账户冷启动明显更快、内存占用大幅下降。
• 设备在线判定：发起请求的设备恒定在线，离线时长改由服务端统一计算下发（消除跨时区偏差）；设备列表按 Windows / macOS / Linux / iOS / Android 区分图标。
• 大列表性能：回收站启用虚拟滚动并触底自动加载；文件网格视图改为按行虚拟化渲染，数万文件不再卡死。

修复#

• 窗口状态：修复主窗口已显示时应用菜单「全部显示」仍可点击的问题，与托盘「显示窗口」共用同一置灰规则，最小化 / 还原 / 聚焦后即时同步。
• 启动被权限弹窗阻塞：目录监听、传输调度与同步等会触发系统权限申请的启动工作，改到主窗口首屏渲染完成后再执行（最多等待 8 秒），macOS 目录访问弹窗不再挡住空白窗口；剪贴板导入登录信息同样延后到首屏可交互之后。
• 回收站「清空回收站」闪烁：数据加载期间按钮保持禁用，不再出现禁用 → 可用的闪动。
• 首页闪烁：切换到首页不再整页闪白。
• 最小窗口登录页：修复 900×600 最小窗口下登录按钮落到首屏之外需要滚动的问题；低高度窗口按高度分级压缩间距，错误提示可见时依然无需滚动。
• 浏览器预览：修复在纯浏览器中打开界面时因缺少桌面运行时而整页报错的问题，桌面专属功能改为明确提示「此功能仅在桌面客户端中可用」。
• 传输进度回退与重复任务：修复并发分片回调导致进度回跳；相同文件重复入队复用进行中任务，不同来源覆盖同一远端路径时明确替代旧任务。
• 下载总量与断点续传：修复下载进度显示 X / 0 B；断点续传按 Content-Range 校正总量。
• 上传冲突与入库中下载：远端文件已变化（409）时自动对齐版本并轮换上传标识后重试；对象仍在入库时按可重试错误退避后继续，不再判为永久失败。
• 回收站假空与补页失败：修复加载失败被当成空回收站、以及删光当前已加载页后不再加载后续条目的问题。
• 同步空间进度条闪烁：新增同步空间或周期性对账时，已完成基线的空间改为静默清点，仅发现真实差异时才显示同步进度，不再无故闪现扫描态；开启 / 关闭同步空间时进度区改为固定占位 + 延迟显示，短暂扫描不再闪现。
• 同步空间扫描计数：扫描期间「已发现数量」不再长时间停留在 0，远端清单就绪后即渐进更新。
• Dock 图标：开发态图标对齐系统 App 的透明边与圆角，避免偏大、发方。
• 打开本地路径：修复同步空间中打开本地文件夹报「Not allowed to open path」的问题。

---

[0.1.0] - 2026-08-25#

桌面客户端首个发布版本。

新增#

• 网盘浏览与在线预览、传输中心、同步空间、冲突处理与回收站。
• 提供 macOS（Apple Silicon）与 Windows 安装包，见 下载安装 与 历史版本。

---