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

Kuake v1.3.1 发布说明

下载链接

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

配置文件

• config.json：下载链接

安装说明

1. 下载适用于您操作系统的二进制文件
2. 下载 config.json 配置文件
3. 编辑 config.json 文件，填入您的 Cookie 信息
4. 运行 ./kuake-v1.3.1-{os}-{arch} user 命令进行测试

详细说明请参阅 README.md 文档。

变更日志

🐛 Bug 修复

错误消息转义问题修复 (cmd/main.go)

• 修复了 CLI 错误消息中双引号在 JSON 输出时被转义的问题
• 将所有错误消息示例从双引号改为单引号，避免 JSON 编码时的转义问题
• 影响的命令：upload, create, info, move, copy, rename, delete, download

API 错误响应处理优化 (sdk/quark_client.go)

• 改进了 HTTP 错误响应的处理逻辑
• 现在会尝试解析 JSON 响应体，提取具体的错误消息（message、errmsg、code 字段）
• 如果无法解析 JSON，会返回原始响应体的前 500 个字符
• 错误消息更加清晰，便于调试和定位问题

类型断言安全性修复 (sdk/file.go, sdk/share.go)

• 修复了多处直接类型断言可能导致 panic 的问题
• 在 CreateFolder、UploadFile、CreateShare 等方法中添加了安全的类型检查和错误处理
• 确保在访问 Data["fid"] 等字段前先检查响应是否成功，以及字段是否存在

✨ 新功能

完整的单元测试套件

• 新增 sdk/config_test.go - 配置文件加载和保存的测试
• 新增 sdk/quark_client_test.go - 客户端初始化和基础方法的测试
• 新增 sdk/user_test.go - 用户信息获取的测试
• 新增 sdk/file_test.go - 文件操作相关测试
• 新增 sdk/share_test.go - 分享功能相关测试
• 新增 sdk/TEST_README.md - 测试说明文档

测试覆盖

• 单元测试：覆盖不依赖外部资源的函数（如 normalizeRootDir, parseCookie, ConvertToFileInfo）
• 集成测试框架：为需要网络和 API 的测试提供了测试框架（标记为 t.Skip()）
• 表驱动测试：使用表驱动测试提高测试覆盖率

🔧 代码改进

错误处理增强

• 在 quark_client.go 的错误处理中添加了详细的注释说明
• 改进了错误消息的可读性和信息量

代码质量

• 所有测试用例通过编译和运行
• 修复了潜在的 nil 指针解引用问题
• 提高了代码的健壮性和安全性

📚 文档更新

测试文档

• 新增 sdk/TEST_README.md，详细说明如何运行测试
• 包含测试用例列表、运行方法、覆盖率查看等说明

🔍 测试统计

• 测试文件数量：5 个
• 测试函数数量：30+ 个
• 代码覆盖率：约 5.9%（单元测试部分，集成测试被跳过）

📋 详细变更文件列表

• sdk/quark_client.go - 错误处理优化，添加错误消息提取逻辑
• cmd/main.go - 修复错误消息转义问题（8 处修改）
• sdk/file.go - 修复类型断言安全问题（2 处修改）
• sdk/share.go - 修复类型断言安全问题（1 处修改）
• sdk/config_test.go - 新增配置文件测试
• sdk/quark_client_test.go - 新增客户端测试
• sdk/user_test.go - 新增用户信息测试
• sdk/file_test.go - 新增文件操作测试
• sdk/share_test.go - 新增分享功能测试
• sdk/TEST_README.md - 新增测试文档

发布地址：https://github.com/zhangjingwei/kuake_cli/releases/tag/v1.3.1