Kuake CLI

English · License

夸克网盘文件管理 CLI 工具。

开源说明

本项目采用 AGPL-3.0 开源；商业使用（含 SaaS、商业产品集成等）须另行取得授权。源代码可自本仓库获取，使用 build.sh 可本地编译各平台二进制。欢迎通过 Issue / Pull Request 参与。

相关项目 (Related Projects)

如果你觉得这个项目对你有帮助，可能也会对我的其他开源作品感兴趣：

• Weixin Link - 把微信私聊接到电脑或服务器上的 AI Agent 助手。离开工位后，你仍能通过微信随时发起任务、补充要求，并直接接收回答和生成的文件。

目录

• 功能特性
• 系统要求
• 安装
• 快速开始
• 文档与变更
• 参与开发
• 免责声明
• 许可证
• Star History
• 贡献者

功能特性

• 用户信息与网盘目录列表、文件详情、上传/下载、创建目录、移动/复制/重命名/删除
• 分享创建与取消、分享列表、转存他人分享
• JSON 输出、管道模式（与 jq 等组合）；可选 OpenClaw 技能（见 openclaw/kuake_skill/）：普通用户只需安装 Releases 中的 kuake、配置 PATH 与 KUAKE_COOKIE（说明见 openclaw/kuake_skill/SKILL.md 与 docs/cli.md）
• kuake-mcp MCP server：以 stdio 方式将 14 个网盘操作暴露为 MCP 工具，配合 Claude Code 等 MCP 客户端使用；通过 KUAKE_DENY_OPS / KUAKE_DENY_PATHS / KUAKE_DENY_EXTS / KUAKE_MAX_UPLOAD_MB / KUAKE_DOWNLOAD_DIR 等环境变量控制可执行的操作与沙箱（见 .mcp.json.example）

凭证优先从 KUAKE_COOKIE / KUAKE_PUS+KUAKE_PUUS / -cookies 读取。自 v1.5.0 起，旧版 config.json 与 -c, --config 不再支持。

认证功能的版本区别：v1.5.0 正式发布版 不支持 kuake auth save、auth status 或 auth clear，请使用环境变量或 .env。这些凭证持久化命令自 v1.6.0 起随正式版提供，也可从当前 main 源码构建。

更多用法见 docs/cli.md。环境变量模板见 .env.example；存在 .env 时 kuake 会从当前工作目录加载（可用 KUAKE_LOAD_DOTENV=0 关闭），不覆盖已 export 的变量。

更多文档见：

• specs/architecture/spec.md
• openclaw/kuake_skill/SKILL.md（OpenClaw 技能说明）

系统要求

• Linux / macOS / Windows
• 有效的夸克网盘账号与 Cookie

安装

从源码构建

需要 Go 1.25+（与 go.mod 一致）与 Git。

git clone https://github.com/zhangjingwei/kuake_cli.git
cd kuake_cli
chmod +x build.sh
./build.sh

构建产物位于 dist/：CLI 为 kuake-{version}-{os}-{arch}；MCP server 为 kuake-mcp-{os}-{arch}（5 平台）。

预编译二进制

从 Releases 下载对应平台文件，文件名与版本以 Release 页为准。

快速开始

以下方式适用于 v1.5.0 正式发布版，也适用于当前 main：

1. 复制 .env.example 为 .env，取消 KUAKE_COOKIE 行的注释并填入浏览器复制的完整 Cookie。将 .env 放在运行命令的当前目录；也可直接设置环境变量 KUAKE_COOKIE。勿提交或分享含真实 Cookie 的文件。
2. 在项目目录执行（二进制名以你本机为准）：

./kuake user
./kuake list "/"
./kuake upload "file.txt" "/file.txt"

v1.6.0 及以上版本：设置 Cookie 后可执行 ./kuake auth save 保存凭证，使用 ./kuake auth status 查看配置状态、./kuake auth clear 清除持久化 Cookie。Linux/macOS 上凭证文件权限为 0600，Windows 上使用仅允许当前用户访问的受保护 ACL；命令不会输出 Cookie 值。使用前可运行 ./kuake --help，确认命令列表包含 auth <save|status|clear>。详情见 CLI 文档。

目录下载支持并发、当前文件进度和独立缓存断点续传；重复运行同一命令会跳过大小一致的完整文件，并继续未完成文件。

更多参数与凭证回退方式见 docs/cli.md；从源码运行见下方「参与开发」。

文档与变更

文档	说明
docs/cli.md	CLI 配置、命令表、JSON 约定与示例
docs/CHANGELOG.md	版本变更记录
docs/DISCLAIMER.md	完整免责声明
openclaw/kuake_skill/	给 OpenClaw 普通用户：把内含 SKILL.md 的文件夹配进 OpenClaw 的技能目录；另从 Releases 安装 kuake 并加入 PATH，按 docs/cli.md 配置 KUAKE_COOKIE 等即可，无需本仓库其它文件
.mcp.json.example	kuake-mcp MCP server 的 Claude Code 集成模板：列出 KUAKE_COOKIE 与黑名单/沙箱环境变量；复制为 .mcp.json 并填入实际 cookie 即可（已加入 .gitignore，不会被提交）

参与开发

提交 PR 前（与 [.github/workflows/ci.yml](.github/workflows/ci.yml) 中 lint / test 一致）：

golangci-lint run ./...
go test ./... -count=1

golangci-lint 规则见 [.golangci.yml](.golangci.yml)；未安装时可用 go install github.com/golangci/golangci-lint/cmd/[email protected]，并将 $(go env GOPATH)/bin 加入 PATH。

作为其它项目的 Go 模块依赖：

go get github.com/zhangjingwei/kuake_cli@latest

免责声明

本工具为非官方第三方项目，与夸克网盘官方无关；使用可能导致账号风险、数据丢失或 API 变更导致不可用等，风险自负。使用即表示您已阅读并同意完整条款，详见 docs/DISCLAIMER.md。

许可证

本项目采用 AGPL-3.0，详见 LICENSE。衍生作品须以相同协议开源。商业使用请联系维护者取得授权。

Star History

贡献者

感谢通过 Issue、Pull Request 等形式参与本项目的所有人。完整贡献者统计见仓库 Contributors。

欢迎提交 Issue 与 Pull Request。