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

v1.4.5

重大变更

CLI * 移除了已废弃的“将子命令后第一个以 .json 结尾的位置参数视为配置文件”的行为，该行为曾导致误将 upload 等命令的本地 JSON 文件当作配置解析。 * 指定配置文件时，请始终使用 -c 或 --config 参数并传入路径。 凭证也可通过 .env 文件或 KUAKE_COOKIE 等环境变量设置。 * 对于曾使用 kuake user ./my.json 格式的脚本，请将其修改为 kuake -c ./my.json user。

v1.4.4

重大变更

认证凭证 * 调整了凭证来源的优先级： KUAKE_COOKIE（去除首尾空格后非空）的优先级高于 --cookies 或 -cookies 命令行参数，再高于配置文件。 * 若脚本曾依赖“命令行参数覆盖已导出的 KUAKE_COOKIE 环境变量”的行为，现在需要先清除该环境变量（在 POSIX shell 中使用 unset KUAKE_COOKIE；在 PowerShell 中使用 Remove-Item Env:KUAKE_COOKIE），或改为使用配置文件。

上传 * 当未传递 --max_upload_parallel 参数时，kuake 会读取 KUAKE_UPLOAD_PARALLEL 环境变量（允许范围 1–16）。 * 若传递了该命令行参数，则参数值优先于环境变量。

文档 * 移除了关于“kuake 二进制文件通过 KUAKE_PATH 环境变量解析路径”的说明。 * 请通过系统的 PATH 环境变量或包装脚本来定位 kuake 可执行文件。

Go Module（重大变更） * Module 路径已变更为 github.com/zhangjingwei/kuake_cli，以与 GitHub 仓库 zhangjingwei/kuake_cli 对齐。现在可以使用 go get github.com/zhangjingwei/kuake_cli@... 获取。 * 请将所有原来的 import "kuake_sdk/..." 引用修改为 import "github.com/zhangjingwei/kuake_cli/..."。

构建、发布与文档 * 构建与发布： build.sh 脚本现在会在 dist/ 目录中随版本打包 OpenClaw 技能目录 openclaw/kuake_skill（默认生成 kuake_skill-<version>.zip；如果系统没有 zip 命令，则生成 kuake_skill-<version>.tar.gz）。构建产物列表使用 ls -lhA 命令以包含 .env.example 文件。 * 发布脚本： push.sh 脚本会将上述技能包作为 GitHub Release 的附件上传，并移除对已不存在的 openclaw/DEPLOYMENT.md 和 openclaw/SKILL.md 的引用。如果缺少技能包，脚本会自动重新执行 ./build.sh。 * 文档： 将 OpenClaw 相关的说明整合为“预编译 kuake + PATH + 技能目录”的普通用户使用路径。修复了 docs/cli.md 中的失效链接，并同步了 README 中的文档表格和功能描述。

v1.4.3

SDK 健壮性与校验（OpenSpec robustness-refactor） * 新增 sdk/validation 模块，提供链式校验器、分页与路径安全校验（包含 ValidPathResult）、默认值注入、使用 crypto/rand 的安全随机数生成、统一错误码以及中文化的校验消息。 * UploadFile 和 DownloadFile 方法现在会对远端路径进行规范化与安全校验。 * 分享列表类方法增加了对分页与排序参数的校验。 * CLI 通过 cmd/validation 安全地解析分页参数与 JSON 路径。

上传 * UploadFile 现在会读取 KUAKE_UPLOAD_PARALLEL 环境变量（范围 1–16）来覆盖服务端的 part_thread 参数（不超过总分片数）。 * 修复了并行上传出错时重复关闭 jobCh 通道导致的 panic。

v1.4.2

SDK 路径与列表 * 修复了 listByFid 的翻页逻辑：现在仅根据本页返回的条目数是否达到满页来决定是否继续翻页，避免依赖不可靠的 total 字段导致列表缺失条目。 * 在 Windows 系统下，远程路径统一按 POSIX 风格处理：GetFileInfo 和 UploadFile 使用 path.Base 解析远端路径；GetFileInfo 列表的回退分支使用 path.Join 拼接子路径。 * listByFid 现在兼容 JSON 将 fid 字段解析为 float64 类型的情况。

下载（OSS 直链鉴权） * DownloadFile 方法现在对下载 URL 的 GET 请求会补充与网盘网页端一致的请求头（例如 User-Agent、Referer、Sec-Fetch-*、Accept、Cache-Control 等），并设置由客户端解析得到的完整 Cookie 头。 * 下载使用独立的 http.Client，其 Transport 启用 HTTP/2，与主 API 客户端（强制使用 HTTP/1.1）分离。这有助于减轻 OSS 回调侧因协议不匹配导致的 HTTP 403 / RequestDeniedByCallback 类失败（详见 buglist.txt 中的 ISSUE-006）。 * 如果 access_tokens 仍仅为不完整片段（例如仅包含 __pus），仍可能导致 403 错误。请使用从浏览器访问 pan.quark.cn 时复制的完整 Cookie 字符串（调试模式下可查看 DownloadFile 的相关提示）。

测试与记录 * 新增了可选的端到端回归测试 TestE2E_Regression_CoreFlow（通过设置环境变量 E2E_REGRESSION=1 或 INTEGRATION_TEST=1 启用；凭证来源与 CLI 一致，为 KUAKE_COOKIE 或 KUAKE_PUS/KUAKE_PUUS）。 * 问题与回归说明请参见仓库根目录下的 buglist.txt 文件。

v1.4.1

新增架构文档 * 新增了主规格架构文档：specs/architecture/spec.md。 * 补充了项目目录结构和模块划分说明。

项目配置 * 更新了 .gitignore 文件，排除本地辅助配置文件，但保留 .github/workflows/ 目录。

OpenSpec 归档 * 归档了 OpenSpec 变更记录：openspec/changes/archive/2026-04-11-main-architecture。

OpenClaw 技能包支持 * 新增了对 OpenClaw skill 包的支持：添加了 openclaw/kuake_skill/SKILL.md 文件，提供了标准的 OpenClaw skill 格式，以便智能体集成 kuake CLI 的能力。