v1.3.5 版本说明
下载
您可以通过以下链接下载适用于各平台的二进制文件:
- Linux: kuake-v1.3.5-linux-amd64
- macOS: kuake-v1.3.5-darwin-amd64
- Windows: kuake-v1.3.5-windows-amd64.exe
配置文件
此版本依赖的配置文件如下,请一并下载:
安装与配置步骤
请按以下顺序完成安装与配置:
- 根据您的操作系统,下载对应的二进制文件。
- 下载
config.json配置文件。 - 将
config.json配置文件放置在可执行文件所在的目录中(例如:c:/kuake-cli/config.json)。 - 使用文本编辑器打开
config.json,在相应字段中填入您的 Cookie 信息。 - 在终端或命令行中运行以下命令,测试用户功能是否正常:
./kuake-v1.3.5-{os}-{arch} user
请将 {os}-{arch} 替换为实际的文件名后缀(例如 linux-amd64)。
更新日志 (v1.3.5)
核心功能增强
- 新增断点续传功能:文件上传支持断点续传,上传中断后可自动恢复,避免重复上传已完成的片段
- 改进上传进度显示:上传进度回调现在显示上传速度、剩余时间等详细信息,提供更好的用户体验
- 新增上传状态管理:添加
UploadProgress和UploadState类型,支持详细的上传进度和状态管理
错误处理与稳定性
- 增强上传错误处理:正确处理 OSS 分片已存在错误(409),支持从错误响应中提取 ETag
- 增强上传超时处理:为大文件上传设置合理的超时时间(分片上传30分钟,提交5分钟)
- 改进分享创建错误处理:分享创建失败时增加重试机制,尝试通过文件 FID 查找已创建的分享
用户体验优化
- 优化命令行参数解析:支持
-c/--config参数指定配置文件路径,改进参数解析逻辑 - 改进配置文件路径解析:配置文件路径解析优先使用当前工作目录,对开发模式更友好
- 改进目录创建逻辑:优化目录创建流程,使用创建后的 FID 直接进行后续操作,提高效率
使用示例
使用自定义配置文件
# 使用 -c 参数指定配置文件路径
./kuake-v1.3.5-linux-amd64 -c /path/to/custom.json upload "file.txt" "/file.txt"
# 使用 --config 参数(效果相同)
./kuake-v1.3.5-linux-amd64 --config /path/to/custom.json upload "file.txt" "/file.txt"
文件上传(支持断点续传)
# 上传文件,如果中断会自动恢复
./kuake-v1.3.5-linux-amd64 upload "large_file.zip" "/backups/large_file.zip"
上传过程中会显示详细进度信息,包括: - 当前上传速度 - 已上传/总大小 - 剩余时间估算 - 上传状态
技术改进
断点续传实现
v1.3.5 版本实现了完整的断点续传功能:
- 状态保存:上传过程中会保存每个分片的上传状态
- 自动恢复:上传中断后,重新执行上传命令会自动检测已上传的分片
- 智能续传:只上传未完成的分片,避免重复上传
- 状态管理:通过
UploadState类型管理上传状态,支持暂停和恢复
错误处理优化
- OSS 分片冲突处理:当分片已存在时(409错误),自动从错误响应中提取 ETag,继续后续操作
- 超时控制:为大文件上传设置了合理的超时时间,避免长时间等待
- 重试机制:分享创建失败时,自动尝试通过文件 FID 查找已创建的分享
兼容性说明
- 此版本完全向后兼容 v1.3.4 及之前版本
- 配置文件格式保持不变
- CLI 命令参数保持兼容,新增
-c/--config参数为可选参数
更详细的使用说明与指南,请参阅项目 README.md
发布地址:https://github.com/zhangjingwei/kuake_sdk/releases/tag/v1.3.5
正在加载评论...