检查绿联云登录和 NAS 连通性。默认实际联网；不会读取或返回令牌。

列个人/共享根目录或指定文件夹。默认列共享文件夹。使用一元 ls-root，兼容流式接口不可用的设备。文件数组在 data.data.file_list.files；保留 total/page 等官方字段。

查询一个 NAS 文件/目录的元数据；使用列表或搜索返回的路径。结果在 items[0].data.stat，64 位数值可能是字符串。

有界读取 NAS 文件，默认 UTF-8 文本，二进制用 base64。每次最多 256 KiB；继续读取使用 offset。仅在用户请求相应文件时使用。

按名称搜索 NAS 文件/目录，默认递归。需要分页时返回 task_id 与 next_offset，使用 ugreen_search_results 继续；不要把一次返回当成所有结果。

继续读取搜索结果。task_id 必须来自搜索返回值，排序保持 name/asc。

把一个 NAS 文件下载到用户指定的本机绝对路径。默认拒绝覆盖已有文件。下载内容可用 Codex 的本地文件工具继续处理。

查询存储卷/池/磁盘、容器/镜像/Compose、已装应用和任务管理器状态。不会启停服务或改 NAS 设置。容器最多一页 100 项，进程/服务返回 CPU 排序前 20 项；旧固件可能不支持部分命令。

把一个本地普通文件上传到指定 NAS 绝对路径。remote_path 以 / 结尾时沿用本地文件名；默认同名自动改名，replace 会覆盖。verify 核对 SHA-256；dry_run 仅预演，不上传内容。仅操作用户指定的对象；写操作失败后先查询当前状态，不自动重试。权限由绿联令牌与 NAS 账户决定。

在指定 NAS 路径创建普通目录。parents 仅在用户要求创建缺失父目录时使用；mode 是八进制权限。创建共享注册项应使用专门的共享工具。仅操作用户指定的对象；写操作失败后先查询当前状态，不自动重试。权限由绿联令牌与 NAS 账户决定。

创建一个 NAS 文件，content 为 UTF-8 文本（可为空），最多 16 KiB；更大或二进制内容使用 ugreen_upload_file。默认 exclusive=true，已存在时失败；mode 是八进制权限。仅操作用户指定的对象；写操作失败后先查询当前状态，不自动重试。权限由绿联令牌与 NAS 账户决定。

写入一个已存在的 NAS 文件，UTF-8 内容最多 256 KiB。write 覆盖原内容；append 追加；patch 按字节 offset 局部写入。仅 patch 接受 offset；新建文件使用 ugreen_create_file 或上传。先用 dry_run 核对重要覆盖。仅操作用户指定的对象；写操作失败后先查询当前状态，不自动重试。权限由绿联令牌与 NAS 账户决定。

复制一个 NAS 文件或目录到已存在的目标目录，保留原名。destination_directory 必须是目录，不能写“目录/新文件名”；需要改名时另行移动为纯文件名。默认同名自动改名，replace 会覆盖；先 dry_run 核对覆盖影响。仅操作用户指定的对象；写操作失败后先查询当前状态，不自动重试。权限由绿联令牌与 NAS 账户决定。

移动或重命名一个 NAS 文件/目录。跨目录 destination 必须是已存在的目录绝对路径；同目录改名只能给不含斜杠的纯文件名。跨目录改名分成两步，不使用“目录/新文件名”。默认同名自动改名，replace 会覆盖；先 dry_run 核对。仅操作用户指定的对象；写操作失败后先查询当前状态，不自动重试。权限由绿联令牌与 NAS 账户决定。

删除用户指定的一个 NAS 文件或目录，默认移入回收站。recursive 默认为 false；删除目录及其内容必须明确指定 true。permanent 仅在用户明确要求永久删除时使用，永久删除不能恢复。先 dry_run 核对范围；CLI 会保护共享根目录并复核删除结果。回收站路径见 data.receipt.final_path，保存它以便恢复。仅操作用户指定的对象；写操作失败后先查询当前状态，不自动重试。权限由绿联令牌与 NAS 账户决定。

从回收站恢复一个 NAS 文件或目录，recycle_path 必须使用删除结果 data.receipt.final_path 或回收站列表返回的路径。dry_run 无法确认路径真的处于回收站，不能把预演当作已恢复。仅操作用户指定的对象；写操作失败后先查询当前状态，不自动重试。权限由绿联令牌与 NAS 账户决定。

离线查看官方 unc 业务命令组或子命令帮助，确认当前 CLI 的参数。不会访问 NAS，也不读取登录缓存。command 使用空格分隔的命令路径。

执行官方 unc 的完整 NAS 业务命令，权限由现有令牌和 NAS 固件决定。command 选择叶命令路径，arguments 是独立参数数组，不要包含 unc、命令路径或 shell 语法。先查询帮助和目标对象，再按用户授权操作；删除、覆盖、服务变更等先 dry_run 预演。需要确认门禁时显式传 --yes，已有授权无需重复询问。dry_run 默认 false；预演可能联网，成功不保证真实执行成功。流式请求最多 1800 秒；写操作超时或失败后先查状态，不自动重试。stdin 为 UTF-8 内容，创建用户仅用 --password-stdin 与 stdin 传密码。认证覆盖、输出重定向、调试和 CLI 本机管理命令不可用。