夸克网盘 CLI - Kuake CLI - Version:1.3.7

作者：越野小张 分类：Kuake CLI

v1.3.7 版本说明

下载

您可以通过以下链接下载适用于各平台的二进制文件：

配置文件

此版本依赖的配置文件如下，请一并下载：

安装与配置步骤

请按以下顺序完成安装与配置：

  1. 根据您的操作系统，下载对应的二进制文件。
  2. 下载 config.json 配置文件。
  3. 将 config.json 配置文件放置在可执行文件所在的目录中（例如：c:/kuake-cli/config.json）。
  4. 使用文本编辑器打开 config.json，在相应字段中填入您的 Cookie 信息。
  5. 在终端或命令行中运行以下命令，测试用户功能是否正常：
./kuake-v1.3.7-{os}-{arch} user

请将 {os}-{arch} 替换为实际的文件名后缀（例如 linux-amd64）。

更新日志 (v1.3.7)

核心功能增强

  • 新增并行上传功能：支持可配置并发的分片上传，显著提升大文件上传速度
    • 感谢 @Cody292 的贡献（PR #13）
    • 支持通过 --max_upload_parallel 命令行参数或 KUAKE_UPLOAD_PARALLEL 环境变量配置并行度
    • 并行度范围：1-16，默认值为 4
    • 仅在满足条件时启用（新上传、第一个分片开始、分片数大于1、并行度大于1）
    • 断点续传时自动使用顺序上传，确保兼容性
  • 新增转存分享文件功能：支持将分享链接中的文件转存到自己的网盘
    • 新增 share-save CLI 命令，支持转存分享文件
    • 自动从分享链接中提取 pwd_id 和提取码
    • 支持指定目标目录（可以是路径或 FID）
    • 默认转存分享中的所有文件
    • 完整的错误处理和用户友好的提示信息

用户体验改进

  • 改进路径参数处理：优化路径参数解析，明确要求所有路径参数必须用引号包裹，提供更好的错误提示和用户指导

使用示例

并行上传（提升上传速度）

# 使用默认并行度（4）上传文件
./kuake-v1.3.7-linux-amd64 upload "large_file.zip" "/backups/large_file.zip"

# 指定并行度为 8，进一步提升上传速度
./kuake-v1.3.7-linux-amd64 upload "large_file.zip" "/backups/large_file.zip" --max_upload_parallel 8

# 通过环境变量设置并行度
export KUAKE_UPLOAD_PARALLEL=8
./kuake-v1.3.7-linux-amd64 upload "large_file.zip" "/backups/large_file.zip"

并行上传说明： - 并行上传仅在满足条件时自动启用（新上传、多分片文件等） - 断点续传时自动使用顺序上传，确保兼容性 - 并行度建议范围：1-16，根据网络环境调整 - 网络条件好时，适当提高并行度可以显著提升上传速度

转存分享文件（新增功能）

# 转存分享文件到根目录（自动提取分享信息）
./kuake-v1.3.7-linux-amd64 share-save "https://pan.quark.cn/s/xxx"

# 转存分享文件（指定提取码）
./kuake-v1.3.7-linux-amd64 share-save "https://pan.quark.cn/s/xxx" "1234"

# 转存分享文件到指定目录
./kuake-v1.3.7-linux-amd64 share-save "https://pan.quark.cn/s/xxx" "1234" "/my_folder"

# 转存分享文件到指定目录（使用 FID）
./kuake-v1.3.7-linux-amd64 share-save "https://pan.quark.cn/s/xxx" "1234" "fid123456"

转存功能说明： - 自动从分享链接中提取 pwd_id 和提取码（如果链接中包含） - 支持命令行指定提取码，优先级高于链接中的提取码 - 目标目录可以是路径（如 /folder）或 FID（如 fid123456） - 默认转存分享中的所有文件，操作简单便捷

路径参数处理改进

# 正确：使用引号包裹路径参数
./kuake-v1.3.7-linux-amd64 upload "file name.txt" "/dest/file name.txt"
./kuake-v1.3.7-linux-amd64 list "/my folder"

# 错误：未使用引号（会收到明确的错误提示）
./kuake-v1.3.7-linux-amd64 upload file name.txt /dest/file.txt

路径参数说明： - 所有路径参数必须用引号包裹，避免空格和特殊字符导致的问题 - 如果未使用引号，会收到明确的错误提示和使用指导 - 支持包含空格、括号等特殊字符的文件名和路径

技术细节

并行上传实现

v1.3.7 版本实现了高效的并行上传功能：

  1. 智能启用：仅在满足条件时启用并行上传（新上传、多分片文件、并行度大于1）
  2. 并发控制：使用 goroutine 和 channel 实现可控的并发上传
  3. 错误处理：任何分片上传失败时，立即取消其他分片上传，避免资源浪费
  4. 进度同步：实时更新上传进度，显示总体上传速度和剩余时间
  5. 兼容性保证：断点续传时自动使用顺序上传，确保状态一致性

转存功能实现

转存功能的核心流程：

  1. 链接解析：使用正则表达式从分享链接中提取 pwd_id 和提取码
  2. Token 获取：调用 GetShareStoken API 获取分享 stoken
  3. 目录处理：支持路径和 FID 两种方式指定目标目录，自动转换
  4. 批量转存：调用 SaveShareFile API 实现批量文件转存
  5. 错误处理：完整的错误处理和用户友好的提示信息

路径参数处理改进

  • 参数验证：在命令处理函数中明确验证路径参数格式
  • 错误提示：提供清晰的错误提示和使用示例
  • 文档完善：在 README 和帮助信息中明确说明引号要求

性能提升

并行上传性能

  • 小文件（< 10MB）：并行上传影响较小，使用默认设置即可
  • 中等文件（10MB - 100MB）：并行度 4-8 可以提升 2-3 倍上传速度
  • 大文件（> 100MB）：并行度 8-16 可以提升 3-5 倍上传速度（取决于网络带宽）

注意：并行度并非越高越好，需要根据网络环境调整。网络带宽有限时，过高的并行度可能导致网络拥塞。

兼容性说明

  • 此版本完全向后兼容 v1.3.6 及之前版本
  • 配置文件格式保持不变
  • CLI 命令参数保持兼容
  • 并行上传为可选功能，不影响现有使用方式
  • 转存功能为新增功能，不影响现有功能

更详细的使用说明与指南，请参阅项目 README.md

致谢

感谢所有为项目做出贡献的开发者！

  • @Cody292 - 并行上传功能（PR #13）

发布地址：https://github.com/zhangjingwei/kuake_sdk/releases/tag/v1.3.7

标签： Kuake

评论

发表评论

正在加载评论...