# Kuake CLI 入门指南：核心配置原理与基础使用

> 本指南介绍了 Kuake CLI 的核心配置原理与基础使用。重点说明了从 v1.5.0 起弃用 config.json 并转向环境变量（KUAKE_COOKIE）和 .env 文件的配置变化，以及 v1.6.0 新增的 auth 凭证持久化功能。提供了获取 Cookie 的方法及 list、upload、download 等基础命令示例，适用于新手用户快速上手。

原文：/knowledge/crawler-8289084a941b61765e8c282ecdd5082bd41967d50417351ab68b63e1ffab0940

Kuake CLI 是一款开源的夸克网盘命令行管理工具，支持文件列表、上传、下载、分享及跨平台操作。本指南旨在帮助新手用户理解其核心配置原理，特别是从旧版配置文件模式向环境变量模式的演进，并提供基础命令的使用示例。

> **注意**：Kuake CLI 为非官方第三方项目，使用可能导致账号风险或 API 变更导致不可用，风险自负。

[来源1](https://github.com/zhangjingwei/kuake_cli)

## 核心配置原理：为什么不再使用 config.json？

在早期版本（如 v1.3.x）中，用户需要下载 `config.json` 并填入 Cookie。然而，随着版本迭代，配置方式发生了重大变化，主要出于安全性和简洁性的考虑：

1.  **v1.4.5 的 Breaking Change**：从 v1.4.5 开始，CLI 不再支持将 JSON 位置参数误作配置文件。用户必须使用 `-c` 或 `--config` 参数显式指定配置文件路径（如果仍使用文件方式）。例如，旧版 `kuake user ./my.json` 需改为 `kuake -c ./my.json user` [1]。
2.  **v1.5.0 的重大转向**：自 v1.5.0 起，旧版的 `config.json` 与 `-c, --config` 参数**不再支持**。项目强制转向使用环境变量进行认证 [1]。
3.  **v1.6.0 的凭证持久化**：v1.6.0 引入了 `auth` 命令系列（`save`, `status`, `clear`），允许用户在设置 Cookie 后保存凭证，实现持久化登录，无需每次输入 [1]。

**配置优先级**：
*   **环境变量**：`KUAKE_COOKIE` 是核心凭证来源。此外，`KUAKE_PUS` 和 `KUAKE_PUUS` 也可用于认证 [1]。
*   **命令行参数**：`-cookies` 参数可直接指定 Cookie 值，但优先级低于环境变量 [1]。
*   **配置文件**：仅在 v1.4.5 及更早版本中作为主要方式，或作为 `-c` 指定的可选方式（v1.5.0 前） [1]。

> **建议**：对于新用户，推荐使用 `.env` 文件或环境变量 `KUAKE_COOKIE` 进行配置，这是当前及未来版本的标准做法。

[来源1](https://github.com/zhangjingwei/kuake_cli) · [来源2](https://github.com/zhangjingwei/kuake_cli/releases)

## Cookie 获取方法

Kuake CLI 需要有效的夸克网盘账号 Cookie 才能运行。获取方法如下：

1.  **浏览器开发者工具**：
    *   登录夸克网盘网页版。
    *   打开浏览器开发者工具（F12）。
    *   在“网络”（Network）标签页中，刷新页面或发起一次请求。
    *   找到任意请求，查看“请求标头”（Request Headers）。
    *   复制 `Cookie` 字段的完整值。

2.  **配置方式**：
    *   **环境变量**：在终端中设置 `export KUAKE_COOKIE="你的Cookie值"`。
    *   **.env 文件**：复制仓库中的 `.env.example` 为 `.env`，取消 `KUAKE_COOKIE` 行的注释并填入 Cookie。Kuake 会自动从当前工作目录加载 `.env` 文件（可通过 `KUAKE_LOAD_DOTENV=0` 关闭） [1]。
    *   **auth 命令（v1.6.0+）**：设置 Cookie 后，运行 `./kuake auth save` 保存凭证。凭证文件权限在 Linux/macOS 上为 0600，Windows 上使用受保护 ACL，命令不会输出 Cookie 值 [1]。

> **安全警告**：勿提交或分享含真实 Cookie 的文件。

[来源1](https://github.com/zhangjingwei/kuake_cli)

## 基础命令示例

安装 Kuake CLI 后，可通过以下基础命令进行文件管理。所有命令均支持 JSON 输出，便于与 `jq` 等工具组合使用 [1]。

### 1. 查看用户信息
```bash
./kuake user
```
此命令可查询账号容量、会员信息等 [1]。

### 2. 列出文件目录
```bash
./kuake list "/"
```
列出根目录下的文件。支持指定路径参数，路径建议用引号包裹 [1]。

### 3. 上传文件
```bash
./kuake upload "file.txt" "/file.txt"
```
将本地 `file.txt` 上传至网盘根目录。支持并行上传（通过 `--max_upload_parallel` 配置）和断点续传 [1]。

### 4. 下载文件
```bash
./kuake download "/file.txt" "./local_file.txt"
```
支持并发下载、断点续传及跳过已存在的完整文件 [1]。

### 5. 分享管理
*   **创建分享**：需使用相关命令（具体参数见 `--help`）。
*   **转存分享文件**：使用 `share-save` 命令，可从分享链接中提取文件并转存至个人网盘 [1]。
*   **取消分享**：使用 `share-delete` 命令，可通过 `share_id` 或文件路径取消分享 [1]。

### 6. 凭证管理（v1.6.0+）
```bash
./kuake auth save   # 保存凭证
./kuake auth status # 查看配置状态
./kuake auth clear  # 清除凭证
```
使用前请运行 `./kuake --help` 确认命令列表包含 `auth` [1]。

[来源1](https://github.com/zhangjingwei/kuake_cli) · [来源2](https://github.com/zhangjingwei/kuake_cli/releases)

## 安装与系统要求

*   **系统要求**：Linux、macOS、Windows。
*   **安装方式**：
    *   **预编译二进制**：从 GitHub Releases 下载对应平台的二进制文件（如 `kuake-v1.6.0-linux-amd64`） [1]。
    *   **从源码构建**：需要 Go 1.25+ 和 Git。克隆仓库后运行 `./build.sh` 即可构建 [1]。

更多详细文档和参数说明，请参考仓库中的 `docs/cli.md` [1]。

[来源1](https://github.com/zhangjingwei/kuake_cli)
