v1.3.8 版本说明

下载

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

Linux: kuake-v1.3.8-linux-amd64
macOS: kuake-v1.3.8-darwin-amd64
Windows: kuake-v1.3.8-windows-amd64.exe

配置文件

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

config.json

注意：v1.3.8 版本新增了 -cookies 参数，可以直接通过命令行指定 cookie 值，无需配置文件。详见下方使用示例。

安装与配置步骤

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

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

./kuake-v1.3.8-{os}-{arch} user

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

或者，使用新的 -cookies 参数方式（无需配置文件）：

./kuake-v1.3.8-{os}-{arch} -cookies "your_cookie_value" user

更新日志 (v1.3.8)

核心功能增强

新增 -cookies 参数支持：可直接通过命令行指定 cookie 值，无需配置文件
- 自动为 cookie 值添加 __pus= 前缀（如果缺失）
- 自动添加末尾分号（如果缺失）
- 使用 -cookies 参数时，不会读取配置文件，提高效率并避免不一致
- 简化使用流程，特别适合临时使用或脚本自动化场景

技术改进

修复并行上传逻辑：多分片文件禁用并行上传（因为需要使用 X-Oss-Hash-Ctx）
- 单分片文件（totalParts == 1）可以并行上传
- 多分片文件（totalParts > 1）必须顺序上传，确保 X-Oss-Hash-Ctx 正确计算
- 修复了多分片文件并行上传可能导致的上传失败问题

使用示例

使用 -cookies 参数（新增功能）

# 使用 -cookies 参数，无需配置文件
./kuake-v1.3.8-linux-amd64 -cookies "your_cookie_value" user

# 只需提供 cookie 值，工具会自动添加 __pus= 前缀和末尾分号
./kuake-v1.3.8-linux-amd64 -cookies "abc123def456" upload "file.txt" "/folder/file.txt"

# 如果 cookie 值已经包含 __pus= 前缀，工具会智能识别，不会重复添加
./kuake-v1.3.8-linux-amd64 -cookies "__pus=abc123def456" list "/"

# 使用 -cookies 参数时，不会读取配置文件，提高效率
./kuake-v1.3.8-linux-amd64 -cookies "your_cookie_value" share-list

-cookies 参数说明：

只需提供 cookie 值，工具会自动格式化（添加 __pus= 前缀和末尾分号）
如果 cookie 值已经包含 __pus= 前缀，工具会智能识别，不会重复添加
如果 cookie 值末尾已有分号，工具不会重复添加
使用 -cookies 参数时，不会读取配置文件，提高效率并避免不一致
特别适合临时使用、脚本自动化或 CI/CD 场景

传统配置文件方式（仍然支持）

# 使用配置文件方式（与之前版本完全兼容）
./kuake-v1.3.8-linux-amd64 user
./kuake-v1.3.8-linux-amd64 upload "file.txt" "/folder/file.txt"

文件上传（并行上传逻辑修复）

# 上传小文件（单分片，可以并行上传）
./kuake-v1.3.8-linux-amd64 upload "small_file.txt" "/backups/small_file.txt"

# 上传大文件（多分片，自动使用顺序上传，确保 X-Oss-Hash-Ctx 正确）
./kuake-v1.3.8-linux-amd64 upload "large_file.zip" "/backups/large_file.zip"

上传逻辑说明：

单分片文件（< 10MB）：可以并行上传（虽然只有一个分片）
多分片文件（>= 10MB）：必须顺序上传，确保 X-Oss-Hash-Ctx 正确计算
修复了多分片文件并行上传可能导致的上传失败问题

技术细节

-cookies 参数实现

v1.3.8 版本实现了便捷的 -cookies 参数支持：

智能格式化：自动为 cookie 值添加 __pus= 前缀（如果缺失）
自动补全：自动添加末尾分号（如果缺失）
智能识别：如果 cookie 值已经包含 __pus= 前缀或末尾分号，不会重复添加
高效处理：使用 -cookies 参数时，不会读取配置文件，提高效率
向后兼容：不影响传统的配置文件使用方式

并行上传逻辑修复

修复了多分片文件并行上传的问题：

问题分析：多分片文件需要使用 X-Oss-Hash-Ctx，必须顺序计算哈希上下文
解决方案：多分片文件（totalParts > 1）禁用并行上传，确保哈希上下文正确
单分片优化：单分片文件（totalParts == 1）仍然可以并行上传（虽然只有一个分片）
兼容性保证：修复不影响现有功能，上传成功率提升

使用场景

场景 1：临时使用

# 临时使用，无需创建配置文件
./kuake-v1.3.8-linux-amd64 -cookies "your_cookie_value" list "/"

场景 2：脚本自动化

#!/bin/bash
COOKIE="your_cookie_value"
./kuake-v1.3.8-linux-amd64 -cookies "$COOKIE" upload "backup.tar.gz" "/backups/"

场景 3：CI/CD 集成

# GitHub Actions 示例

- name: Upload file
  run: |
    ./kuake-v1.3.8-linux-amd64 -cookies "${{ secrets.QUARK_COOKIE }}" \
      upload "build.tar.gz" "/releases/"

场景 4：多账号切换

# 快速切换不同账号，无需修改配置文件
./kuake-v1.3.8-linux-amd64 -cookies "cookie1" user
./kuake-v1.3.8-linux-amd64 -cookies "cookie2" user

兼容性说明

此版本完全向后兼容 v1.3.7 及之前版本
配置文件格式保持不变
CLI 命令参数保持兼容
-cookies 参数为新增功能，不影响现有使用方式
并行上传逻辑修复，提升上传成功率

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

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

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