Skip to content

Latest commit

 

History

History
177 lines (125 loc) · 24.6 KB

NATIVE_UPLOAD.md

File metadata and controls

177 lines (125 loc) · 24.6 KB

桌面版原生上传交付说明

本次在 YunX-Desktop 原工程上增量增加上传,保留 Kotlin/JVM、Compose Desktop、原登录/目录页面、下载模块及打包结构。文件由桌面客户端通过网盘 API 和授权存储直接传输,不依赖网页上传、Android 模拟器或额外服务器。

2026-11-14 上传可靠性补强

  • 失败项支持在详情和后台列表单独点击“重试”,批量“重试失败项”继续保留;重排后立即清除上一条失败原因、速度与进度采样,单项重试沿用原账号和目录,并遵守并发上限。
  • 取消或账号错误在项目已选中但尚未启动的窗口内也会重新校验,避免取消后迟到任务仍发起写请求;并发补位和取消状态会立即刷新,不依赖下一轮定时采样。
  • 目录分页把空游标、-1、重复游标和空页统一视为协议异常或结束条件,防止 123 等平台在末页后继续请求空页导致文件夹上传失败。
  • 文件大小尚未解析时,批次显示“已发送 · 总大小未知”,不再把未知总大小误画成 0% 完成率;解析完成后恢复正常百分比与 ETA。
  • 115 上传时的目录查找关闭打开时间记录和子项计数,只保留目录判断所需数据,减少大目录扫描开销。
  • 本轮仍只编译和静态核对,不运行测试、不启动软件、不执行真实上传。

2026-11-14 上传失败重试

  • 详情窗口和右下角后台卡片均提供“重试失败的 N 项”。上传过程中即可把失败项目重新排队,继续遵守设置中的并发上限;批次结束后的失败结果也保留重试入口。
  • 仅重试失败的文件及目录,不重传成功项目,不重排取消项目;重置该项进度及失败原因后重新开始上传,不提供断点续传或自动无限重试。重传字节继续纳入整批速度,剩余时间按新的待传字节数更新。
  • 沿用原账号、目录和上传协议,发起传输前重新核对账号。已确认成功的目录映射保留,失败目录在互斥保护下清理错误缓存并重新读取列表;等待旧任务清理完 I/O 后才允许重新排队,避免同一项目重复执行。
  • 若上次失败发生在网盘确认阶段,重试前请先查看远端是否已保存,以免重复内容。已知账号错误停止接收后,须先恢复原账号再重试。
  • 按要求仅编译、打包和静态核对,不运行测试、不启动应用、不执行真实上传。

2026-11-14 整批上传速度与剩余时间

  • 总速度改为近五秒整批实际上传回调的字节增量除以采样时长,每半秒采样;跨文件、并发文件及目录任务连续统计,不再相加当前活跃文件的瞬时速度。不把建目录、秒传或服务端完成确认的进度跳变当作网络传输速度。
  • 预计剩余时间采用整批尚待传输字节数除以总速度并四舍五入,不再因单个文件暂时无速度或批次正在准备下一个文件而隐藏。失败和取消项的未传字节不计入剩余工作;尚无有效采样或五秒窗口内无传输时显示 0 B/s,预计时间等待有效速度,避免虚构倒计时。此估算不预测建目录、计算校验及服务端确认耗时。
  • 后台卡片和上传详情复用同一统计区域,显示整批已发送/总大小、总速度与预计剩余。后台统计移到限高滚动列表上方;时间数字保留 132 × 28 dp 固定区域和等宽字体。
  • 保留上一版上传图标悬浮说明、仅拖拽时显示落点提示、文件和文件夹混选、并发设置及追加上传。未修改网盘上传协议。
  • 本轮仅编译、打包及静态核对,未运行测试、未启动应用、未执行真实上传;统计准确性和实际界面效果由用户运行验收。

2026-11-14 上传悬浮提示与资源优化

  • 移除默认常驻的上传提示栏和其中重复的选择按钮,将点击、混选、目录层级及追加说明放到上传图标的悬浮提示中。拖入本地文件时临时显示落点提示,离开或松开后收起;十个平台共用此行为。
  • 普通字节进度按整批限频为最多每 200 毫秒一次,避免并发文件各自触发完整队列快照。阶段变化、文件完成、追加、取消及并发设置变化仍立即发布,文件传输和并发上限不受此界面限频影响。
  • 详情和后台卡片直接按索引读取现有进度列表,不再每次刷新转换整份候选文件列表。候选项目缓存相对路径;调度按可用并发位置按需取项,预计剩余时间不再建立额外过滤列表。
  • 上传展示信息交给常驻组件后释放页面的原始选择引用;拖拽追加交接后释放原始拖入列表引用。保留失败结果、重试数据及目录层级,已有结果关闭和批次回收逻辑继续沿用。
  • 本轮仅编译、打包和静态核对,不运行测试、不启动应用、不执行真实上传,也未测量实际 CPU 或内存降幅。

2026-11-14 文件夹与混合批量上传

  • “选择文件或文件夹”统一打开 JVM 本地混选窗口,支持按 Ctrl/Shift 在同一窗口多选文件和文件夹,自动识别类型;窗口采用系统外观,与之前 Windows COM 选择器略有不同。也可一次拖入文件和文件夹,确认窗口可继续追加、移除。
  • 在选择窗口取消且没有待上传项目时关闭上传确认窗;已有待上传项目时取消追加,保留原列表。
  • 后台扫描子文件夹,只读取元数据;保留所选根文件夹、子目录和空目录。扫描可取消,不跟随符号链接、目录联接或特殊文件,不直接上传磁盘根目录;跳过项会在确认窗口提示。
  • 夸克、UC、迅雷、百度、移动云盘、123、115、光鸭、蓝奏和蓝奏优享均接入已有建目录 API。优先复用同名远端目录;同名文件阻挡目录、存在多个同名目录或无法确认分页时,相关项失败并显示原因。
  • 目录映射限定原批次,建目录互斥,文件按设置并发传输。同名文件仅在目标相对路径相同时依次处理,不同子目录的同名文件可并行。文件重名、类型、大小及空文件限制仍沿用各网盘原有上传协议。
  • 上传中可继续点击图标、选择文件夹或拖入混合内容;追加沿用原账号和目标目录。本地路径去重,确认列表和进度显示相对路径,移除文件夹会同时移除它的子项目。选择父目录时,已选择的子文件归入该目录。
  • 目录失败不会由其他排队文件自动重放建目录写请求;显式重试失败项时保留已确认成功的目录映射,并重新读取目录列表。取消只中止待传输内容,不删除已创建目录或已上传文件。
  • 本次按用户要求仅编译、打包及静态文件核对,不运行测试、不启动应用、不执行真实上传;十个平台的线上行为仍需使用实际账号确认。便携包内 BUILD-INFO.json 和 SOURCE-CHANGES.patch 标明本次源码及构建状态。上传悬浮卡片继续保持自适应高度和后台列表 120 dp 上限。

2026-11-14 前次源码审核记录(历史)

  • 本轮仅静态检查,不编译、不运行测试、不启动应用。下文已有 EXE、JAR、编译和测试记录均为历史交付,不包含本轮修复;现有 release 目录保持原样。
  • 准备阶段保留已发送字节;速度采用平滑采样,约两秒无增长后显示网络等待并清除旧速度、ETA,恢复传输后重新采样。ETA 保留固定 132 × 28 dp、等宽字体和秒数四舍五入;超过 99 小时显示 >99:59:59。
  • 普通文件失败不停止排队和追加。已知账号缺失、账号切换或凭据辅助函数明确报告失效时停止新任务;不按模糊错误文字猜测鉴权失败,也不把对象存储的签名错误一律当成账号失效。
  • 后台卡片和详情均用可滚动列表展示全部文件,分别显示真实阶段、速度、字节数及 ETA,保留成功、失败、取消数量。失败/取消结果保留到关闭或新批次启动。
  • 批次结束后可仅重新排队失败文件,复用原目录和上传函数,并再次核对原账号身份。此重试需要用户点击,不自动重放整批;不重传已完成项,不包含取消项,也不提供重启恢复。
  • 更新、下载和问题入口改到 SeanWang114514/YunX-Desktop。安装器 AppId、默认目录、快捷方式和通知身份与原版区分;仍沿用原数据目录及单实例机制。
  • 打包脚本不再强制停止任何运行实例或全局 JCEF 助手。完整修改及静态核对记录见 本轮审核报告。

版本与来源

  • 桌面基线:tidain/YunX-Desktop,提交 00a030f778a65840e9be65baecb15497a94b04ec,保留版本号 1.3.4。本产物是本地修改版,不是上游官方发布。
  • 安卓参考:CYQawa/YunX,提交 cc9afe24c9409b239c361263b976f7aad77d1d9e。安卓参考目录未修改。
  • 上传 I/O、签名及协议按需移植,Android URI/SAF 改为 JVM 文件流,未整文件替换原桌面 API。移植公共代码保留 CYQawa 版权及 AGPL 来源说明,原 LICENSE 保留。
  • 首版实施和验证日期:2026-11-13;上传任务可见性更新:2026-11-14(仅编译、打包和文件核对,未运行测试)。

使用方法

  1. 启动修改版,登录需要上传的网盘。
  2. 进入个人盘目标目录,悬停右上角上传图标查看说明,点击后选择文件或文件夹;也可直接拖入文件列表。拖入时临时显示落点提示,松开后打开上传确认窗口。
  3. 用“选择文件或文件夹”继续混合多选,无需切换选择模式;双击文件夹进入目录,选中文件夹后点击“选择”则添加整个文件夹。核对目标目录、文件数、目录数、总大小及相对路径,可移除文件或整个文件夹;点击“开始上传”才发送。此上传入口使用支持混选的 Swing JFileChooser,其他导入、保存及目录设置选择器保持原样。
  4. 在“设置 → 上传 → 上传并发数”中选择 1–10 个文件(默认 3)。设置自动保存,按每个网盘分别计算,准备、传输和等待确认均占用并发位置。调高立即唤醒调度器并补充等待文件;调低不中断已开始的文件,随后按新上限排队。详情和后台卡片显示实际处理数量与上限,各文件分别显示等待、准备、传输、等待确认、完成或失败状态。进度条按整批字节数计算;速度为正在传输文件的合计速度(B/s、KiB/s、MiB/s 或 GiB/s),预计剩余按本批次尚未传输的总字节数估算,包含排队文件。剩余秒数四舍五入,时间数字使用固定宽高和等宽字体;采样不足时显示占位符。估算不包含尚未发生的哈希准备或服务端确认等待。“取消上传”停止本平台整个批次,退出程序也会中止。
  5. 完成后查看成功、失败、取消及未开始数量,目录自动刷新。失败结果可点击“重试失败文件”,取消项需要重新选择。首次使用每个平台请先用可删除的小测试文件验证。

上传中点击进度窗口外的空白处、按 Esc 或点击“后台上传”,会收起详情,任务继续执行。主窗口右下角紧凑卡片显示完成数量、并发数量、文件名、整批进度、合计上传速度及预计剩余时间;时间沿用固定 132 × 28 dp、等宽数字及秒数四舍五入。卡片缩小上下内边距和行间距,字节详情保留在展开窗口中。点击卡片可重新展开详情并取消上传。切换目录、网盘或主导航页面后仍显示后台卡片;多个网盘同时上传时卡片纵向排列。这里的后台指应用内继续执行,退出程序仍会中止上传。

上传中右上角上传图标保持可用,点击后可继续选择多个文件;也可拖入文件到页面文件列表、上传详情、右下角进度卡片或文件确认列表。核对后点击“加入上传队列”,有空位时立即并发上传,达到设置上限时自动等待。详情与卡片的“添加文件”仍可使用。追加始终使用原批次固定的账号、目录和上传函数,不随当前浏览目录变化;同一真实路径在本批次中去重。确认窗口固定打开时的批次和提交动作,批次结束或停止接收后,迟到的确认不会把文件放进后续批次。不同目录的同名文件按顺序处理以避免同时覆盖,其他文件按配置填充并发位置。上限不等于实际传输数:文件不足、同名文件、准备或网盘确认阶段均可能导致实际传输数较少。

开始时固定目录与账号身份,同平台只允许一个可追加批次;上传期间限制该平台切号、添加及移除账号。普通文件失败后只标记该文件并继续处理其他排队文件,也继续接收追加;已知账号错误或用户取消时停止新任务。100% 字节不等于成功,须等待协议确认。

拖放通过 Compose Desktop 1.7.3 的原生 AWT 文件列表接入,只接受本地文件及文件夹,不把文本或网页链接当成上传文件。采用 COPY 拖放动作,保留本地源文件。递归保留文件夹结构;不存在、不可读取或链接项目会被跳过并提示。相同本地路径去重,不同目录的同名文件仍分别保留。上传和排队期间仍接受多个文件及文件夹拖入;加载中、扫描中、批量选择或其他无关操作弹窗时不接收。上传相关窗口内的拖入由该窗口处理,不会穿透到背后的页面。目录变化会关闭页面的预选确认窗口,防止目标变化。

平台接入情况

以下表示源码接入、编译及模拟协议测试通过,不表示真实账号已逐家验收。

平台 上传流程 真实账号验证重点
夸克 预上传、哈希秒传、OSS 分片、合并回调、finish Cookie、子目录、非秒传
UC 共用夸克型流程,独立接口参数 UC 签名、分片、finish
百度 precreate、4 MiB MD5 分块、superfile2、create bdstoken、服务器、账号限额
139 SHA256、签发地址、PUT 分片、complete 分批地址与账号环境
123 优先预签名分片,保留 S3 分支,v2 合并 线上返回分支与兼容性
115 OSS 表单、完成校验 单文件代码上限 5 GiB
迅雷 gcid 秒传、S3、完成状态轮询 设备、captcha、凭据刷新
光鸭 OSS、任务轮询 临时凭据、最终状态
蓝奏优享 七牛表单或 8 MiB 分块、异步确认 不同大小分支
蓝奏 multipart、zt 和 fileId 校验 Cookie、大小与类型限制

增量代码位置

以下以 desktop/src/main/kotlin/com/yunx/app/ 为起点。

  • data/upload/:区间文件流、签名、请求体、分片、取消、批次及账号互斥。64 KiB 缓冲流式读取,检测大小、修改时间和文件标识变化。
  • data/network/QuarkUpload.kt:夸克/UC 共用协议。原十家 Api 和必要常量只增加上传段与辅助方法。
  • HttpClients.kt:独立上传客户端,沿用代理与 HTTP/2。控制请求纳入取消,请求体标记为不可自动重放。
  • DiagnosticNetworkInterceptor.kt:上传上下文跳过文件体和响应摘要,避免读取文件或记录临时授权。
  • util/WindowsFilePicker.kt、DesktopActions.kt:扩展原多选入口,保留单选/保存功能。
  • 原十家 ViewModel / Screen:上传函数、按钮及共用 UploadProgressDialog.kt。
  • UploadPane.kt、UploadSelection.kt:十页共用的拖放、预检、确认列表与上传状态界面,复用原上传执行器和 API。
  • AccountDirectory.kt、MultiAccountViewModel.kt、MainScreen.kt、Main.kt:账号保护及退出取消。
  • desktop/build.gradle.kts:登记测试、隔离测试偏好/目录及检测 VS 18。没有更换依赖版本或迁移数据库。

验证记录

以下 137 项测试与离线界面记录均为此前串行版本的历史验证,不覆盖本轮并发、追加和卡片压缩;本轮按用户要求不运行测试。

原仓库中文路径兼容入口 :desktop:testInProcess 结果 OK (137 tests):原有 85 项、上传协议与执行器新增 40 项、拖放预检与界面状态新增 12 项全过。主工程、测试源码和原生暗色 DLL 编译通过。

新增测试类 数量 覆盖重点
UploadSigningTest 9 安卓固定向量、OSS/S3 签名及编码
UploadIoTest 10 区间、文件变化、哈希、定长表单/XML、不重放、阻塞响应取消、S3
UploadRunnerTest 7 串行、失败停止、身份/互斥、页面销毁、取消分类
QuarkUploadTest 3 夸克秒传、UC 分片/finish、HTTP 200 XML 错误
UploadApiTest 11 其余八家 API 模拟、假成功、MD5 失败、缺少凭据
UploadSelectionTest 7 系统文件列表、拒绝文本/链接、去重、中文路径、无效文件与文件夹
UploadUiStateTest 5 确认后才上传、添加/移除、取消预检、忙碌禁用、空批次保护

测试使用本地模拟 HTTP。最终回归设置内存 PreferencesFactory 和独立 desktop/build/test-data,不读写注册表真实配置。首轮曾漏设隔离,发现后补齐并重跑;既有下载测试使用内存 DAO,但首轮缓存路径未隔离,不能称首轮完全未接触用户缓存。未使用真实网盘账号或上传用户文件。

普通 :desktop:test 在本机中文路径下测试类 ClassNotFound,未能实际运行;通过结果来自原兼容入口。

发布包 JVM 加载已打包应用类,额外验证 Windows COM 多选,正确返回两个中文文件名的绝对路径,结果 NATIVE_MULTISELECT_OK count=2。只选择新建测试文件,不发送网络请求。

拖放与界面另用 UploadUiSmoke 加载正式共享组件离线检查。外部系统文件拖入已观察到文件列表事件、确认窗口及模拟完成;另用两个自建中文路径文件验证数量/总大小、移除、单文件完成、双文件串行完成及取消第二项后的结果。两个测试源文件检查前后 SHA256 一致。模拟执行器不发送 HTTP,不代表真实网盘上传成功。早期同窗内嵌 Swing 拖放源未完成投放,不计入通过证据;已移除该测试控件,避免其遮挡 Compose 弹窗。

应用启动冒烟使用发布包 runtime/bin/java.exe、已打包应用类和独立数据目录,软件渲染下首次欢迎页完整显示,45 秒定时退出,进程退出码 0。此项没有验证双击自研 EXE 启动器或登录后页面。原公告服务请求超时、浏览器插件桥端口不可用,欢迎页仍正常渲染;这两项不属于上传验收。

构建与发布

环境需 JDK 17、Gradle Wrapper;Windows DLL 需 MSVC/Windows SDK;安装包需 Inno Setup 6。本次均用本机已有工具,未安装系统组件。源码根目录执行:

. ./jdk-setup.ps1
$jdk = Ensure-Jdk
Invoke-Gradle ':desktop:compileKotlin' ':desktop:testInProcess' '--no-daemon' '--max-workers=1'

本机提交内存紧张及 JDK 回环套接字异常,仅在进程设置 JAVA_TOOL_OPTIONS=-Djdk.net.unixdomain.tmpdir=D:/yunx_no_unix_socket_dir -XX:ActiveProcessorCount=2,未改全局配置。完整主编译最大堆 1600 MiB,后续测试/打包 Gradle 堆 900 MiB,测试 JVM 堆 512 MiB。正常环境不必照搬机器专用参数。

便携目录:release/YunX-Desktop/,须完整保留。安装包:release/YunX-Desktop-setup-1.3.4.exe。保留上游版本号和安装标识,安装版可能覆盖原安装目录,建议先用便携目录验证。

上传图标调整版位于 release/YunX-Desktop-icon/,运行其中 YunX-Desktop.exe。由于原便携目录正在运行且 jar 被占用,本轮保留原目录,只更新新的完整便携目录;安装包使用临时 ISS 副本指向新目录编译,原安装脚本不改。本轮将十个网盘页面的工具栏文字入口统一改为上传图标,停留约 0.5 秒提示“上传文件”,保留点击和禁用条件。编译通过;按用户要求停止后续测试,悬浮及点击效果由用户自行验收。

最新速度与预计时间版位于 release/YunX-Desktop-speed/,运行其中 YunX-Desktop.exe。图标版 jar 当前被占用,故另建完整便携目录,保留运行中的软件。上传速度约每半秒采样更新;当前文件预计剩余按秒四舍五入,以时:分:秒显示,数值区域固定为 132 × 28 dp 并使用等宽字体。初始采样不足时显示 --:--:--,准备和网盘确认阶段不作时间估算。本轮主工程编译通过,按用户要求只编译、打包,不运行测试;既有 137 项结果属于前述历史验证,不覆盖本轮新增的速度和预计时间功能。

最新后台上传版位于 release/YunX-Desktop-background/,运行其中 YunX-Desktop.exe。在原上传执行器、页面及窗口内覆盖层基础上增加主窗口常驻的进度展示,没有更换上传协议或引入运行依赖。本轮主工程编译通过,按用户要求只编译、打包,不运行测试;后台收起、展开及页面切换交互由用户自行验收,历史测试结果不代表本轮功能已测试。

本轮多文件并发与追加版位于 release/YunX-Desktop-multiupload/,运行其中 YunX-Desktop.exe。复用原 UploadRunner、每家上传 API、原生多选与预检确认窗口,未新增运行依赖。每个文件有独立 I/O、取消和速度采样,详情不再按索引先后推断完成状态。迅雷的上传凭据缓存按并发文件隔离;蓝奏的表单文件标识、蓝奏优享的对象时间戳各自避免同批并发冲突。主工程编译通过;按用户要求只编译、打包,不执行软件启动或真实网盘上传测试。

此前打包复用原 portable-package.ps1 步骤,临时副本移除三条全局停止同名进程命令并加低内存参数,当时原跟踪脚本未改。本轮已在跟踪脚本中正式移除这些停止命令,未执行打包或安装。

拖放与上传界面版本未增加运行依赖;在既有完整便携目录中更新正式 desktop.jar 和本说明,再用原 ISS 重编安装包。发布 jar 不包含离线模拟入口或测试类;两份 jar 的 SHA256 核对一致,并重新生成 release/SHA256SUMS.txt。

限制与验收建议

此前的任务详情可执行版位于 release/YunX-Desktop-upload-task-details/,运行其中 YunX-Desktop.exe。该历史产物的后台卡片最多预览 3 个文件,详情展示全部状态;本轮源码已将后台预览也改为完整滚动列表,但没有更新此目录的 EXE/JAR。文件级并发、真实网盘速度和拖拽交互仍需用户自行验收,不能把静态检查当作线上并发已验证。

最新可配置并发版位于 release/YunX-Desktop-upload-settings/,运行其中 YunX-Desktop.exe。上传并发配置复用原 SettingsRepository 持久化,由状态流按变更通知上传调度器,不轮询;并发上限不再写死为 3,确认窗口、详情和后台卡片均读取配置或真实调度快照。未新增依赖。按用户要求仅编译、打包与核对发布文件,不运行测试、不启动软件或真实上传;不能据此认定已复现或确认线上实际并发为 1 的原因。启动前请先完成旧版任务并退出旧版,避免单实例限制唤起旧程序。

本轮上传中图标与拖拽追加版位于 release/YunX-Desktop-parallel-drop/,运行其中 YunX-Desktop.exe。在既有 3 文件并发调度器上接通十个网盘页面的图标、拖拽与追加回调,并为上传详情、后台卡片和文件确认列表接入同一原生拖放处理。未新增依赖、未修改上传协议。按用户要求仅编译、打包与核对发布文件,不运行测试、不启动软件或真实上传。软件有单实例限制,启动新目录前请等当前任务结束并退出旧版。

  • 仍需真实账号逐家验收。鉴权、签名、风控、限额和 API 变化可能失败,模拟测试不能证明线上接口可用。
  • 首版不含文件夹递归、暂停续传、重启恢复、历史或全局传输中心。
  • 取消中断任务与 HTTP,未实现通用远端 multipart abort,不保证清理分片,也不撤回已保存文件。
  • 失败/取消可能发生在服务端提交后、确认响应前。先刷新核实再决定重传,避免重复文件。同名策略沿用平台协议。
  • 变化检测基于文件元数据,不是写入锁,上传期间请勿修改文件。大小、类型、配额等平台限制仍生效。
  • 原更新入口指向上游,更新可能覆盖扩展,请保留修改源码和当前发布包。

逐平台验收:根/子目录、中文/特殊字符、多文件、跨分片大小、秒传/非秒传、取消/断网、过期登录、同名、账号保护。上传后下载比较 SHA256;接近大小上限的测试单独安排。