[交互式] 发起 OAuth 2.0 + PKCE 登录。

返回授权 URL。用户需在浏览器打开该 URL，登录 fnOS 并确认授权， 然后把页面显示的一次性 code 用 submit_auth_code 工具提交。 不要向用户索取 NAS 账号密码。

提交 OAuth 一次性授权码，完成 token 交换与 session 保存。

注意：该工具通过带 pty 的后台进程完成交互（CLI 要求 TTY 等待输入）， 仅在 code 有效（5 分钟内、未使用）时成功。

退出登录并清理当前 profile 的 session 与 OAuth pending 文件。

查询当前登录用户信息（验证 session 有效性）。

聚合只读状态：系统信息 + CPU/内存监控（对应 trim-cli +status）。

获取系统信息：主机名、trim 版本、内核版本、uptime 等。

获取硬件信息。

列出所有卷（含配置卷）。

获取定时开关机计划与状态。

聚合查询系统只读信息（trim 版本、内核、主机名、uptime、风扇模式、 通电自启、下次定时关机、Docker 概要等 18 项；单条失败不影响其余）。

列出系统支持的时区。

列出目录内容（单页）。

列出目录全部内容（自动汇总所有分页为 JSON 数组）。

全盘或指定目录搜索文件。

获取文件/目录属性。

计算文件/目录大小。

获取文件下载 URL（通常需浏览器已登录 cookie）。

查看卷空间使用分类汇总。

trim-cli 的 位置参数只接受整数（1 表示 /vol1），传 vol1 会报 "invalid digit found in string"，所以这里先把数字部分抽出来再传。

列出最近访问的文件。

列出回收站内容。

⚠️ 实测在 fnOS 1.2.0800 上，file rm 是硬删除，回收站接口只回 {"result":"succ","uver":...} 而不含任何条目，带不带 path 都一样。 不要把本工具的输出当作"删除是否可恢复"的依据。

计算目录统计信息（递归统计，与 file_size 的单条目大小不同）。

查询当前用户对文件/目录的访问权限。

判断路径是否为挂载点。

搜索其他用户共享的文件。

取消文件后台任务（搜索/压缩等长任务，写操作）。

取消全盘搜索任务（写操作）。

列出应用专属目录（appdirs）。

查看系统分区信息。

列出团队空间。

列出指定团队空间的回收站。

列出团队空间垃圾桶（trashbin，与分空间回收站不同）。

从团队空间回收站恢复文件（写操作）。

清空团队空间回收站（危险写操作，不可恢复）。

列出收藏的文件。

收藏文件/目录（写操作）。

取消收藏（写操作）。

查询文件/目录的共享信息。

列出指定用户的文件共享。

列出其他用户的共享。

管理员视角列出文件共享。

管理员视角列出其他用户的共享。

创建文件共享（写操作）。

删除文件共享（写操作）。

查询文件 ACL 权限。

设置文件 ACL 权限（写操作，可能批量影响子项）。

导出卷 ACL 迁移报告（写操作，生成 CSV 报告文件）。

创建目录（写操作）。

重命名文件/目录（写操作）。

复制文件到目标目录（写操作）。

移动文件到目标目录（写操作）。

删除文件/目录（写操作，⚠️ 永久删除）。

实测：trim-cli 的 file rm 是硬删除，文件不会出现在 /vol1//.@#local/trash 里，file_trash_list 也查不到， file_trash_restore 更是无效。调用前请自行确认。

从回收站恢复文件（写操作）。

⚠️ 实测不可靠：即使返回 "Restored "，文件也常常没有回到原位 （因为 file rm 走的是硬删除，回收站里本来就没有该条目）。恢复后请 用 file_property 确认。

清空回收站（危险写操作，不可恢复）。

预检上传目标（探测远端占用与配额）。

overwrite 默认 skip，这是非破坏性的：目标已存在时返回 {"result":"succ","skip":1} 表示会跳过，原文件不动。

警告（真机实测）：

• overwrite=replace 时上游 check-upload 会立刻把同名目标文件截断成 0 字节，内容丢失且回收站里也没有。别用它"试探会不会冲突"，要覆盖 直接调 file_upload。

• 目标不存在时上游会留下 0 字节的 <名字>.#0 占位文件。不要用 file_delete 删它：fnOS 的 rm 把 X.#0 当作 X 的别名，会连同名目标 文件一起删掉。占位文件会被后续 file_upload 覆盖，留着无害。

上传本地文件到 NAS 目录（写操作）。

overwrite 决定远端同名文件冲突策略：skip 跳过、replace 覆盖、 rename 保留旧文件并给新文件改名。上传前可先用 file_check_upload 预检目标状态。

把文本内容直接写入 NAS 文件（写操作；组合 upload 实现）。

等价于在服务器临时文件上执行 file upload：远端父目录不存在时会 先用 file_mkdir 逐级创建。overwrite=skip 时远端同名文件已存在则 跳过不写。适合写配置、脚本、compose 文件等小文本。

压缩文件/目录为压缩包（写操作）。

解压压缩包到指定目录（写操作）。

修改文件/目录属主（写操作；sub=True 递归应用到子项）。

列出相册文件夹。

搜索相册照片（支持 AI 语义搜图；total 才是匹配总数）。

获取照片详情。

获取照片预览 URL（通常需浏览器已登录 cookie）。

调用 Photos 原生 HTTP API（高级用法；POST/PUT/PATCH/DELETE 需确认）。

列出已安装的应用。

返回的每个应用同时有 appName（API 标识，如 fn-codeserver）和 name（显示名，如 code-server）。后续所有 app_* 工具要传的是 appName，传 name 会报 "installed app not found"。

查询单个应用状态。

在应用商店搜索应用。

查看应用商店中的应用详情。

检查已安装应用的更新。

安装应用（写操作）。dry_run=True 时仅预演不执行。

卸载应用（写操作）。

启动应用（写操作）。

停止应用（写操作）。

重启应用（写操作）。

升级应用到指定版本（写操作）。dry_run=True 仅预演。

查询应用任务进度（安装/更新/卸载等）。

取消应用任务（写操作）。

取消应用安装任务（写操作）。

取消应用更新任务（写操作）。

取消应用商店下载任务（写操作）。

从 fpk 离线安装包安装应用（写操作；remote_path 或 local_file 二选一）。

按类型取消应用任务（写操作，聚合入口）。

action 对应 CLI 子命令：task-cancel / install-cancel / update-cancel / app download cancel。

列出所有应用的配置项。

查看指定应用的配置项详情。

查看应用中心系统配置。

查看应用的鉴权路径配置。

获取应用配置向导数据（安装向导表单定义）。

修改应用配置项（写操作）。fields 为 JSON object 透传。

修改应用中心系统配置（写操作，影响全局应用行为）。

开启/关闭应用自动更新（写操作）。

允许/禁止应用的外网代理访问（写操作）。

查询应用 OpenAPI 详情。

查询应用 OpenAPI 允许的鉴权路径。

为应用添加 OpenAPI 鉴权路径（写操作）。

为应用添加 OpenAPI 鉴权继承文件（写操作）。

列出应用商店全部应用。

获取应用商店最新上架应用。

批量检查应用是否已安装（装机引导）。

批量安装商店应用（写操作，装机引导流程）。

获取应用中心基础数据。

获取 SAC 应用商店列表（应用推荐数据源）。

列出应用提供的服务。

列出应用入口；only_hidden=True 仅列出隐藏入口。

列出桌面应用图标。

查看应用运营设置。

查询/设置应用公共卷（set_volume 非空时为写操作）。

列出 Docker 容器。

对容器执行操作（写操作）：start / stop / restart / kill。

删除容器（危险写操作；force=True 强制删除运行中的容器）。

列出 Docker 镜像。

拉取 Docker 镜像（写操作）。

删除 Docker 镜像（危险写操作）。

查看 Docker 资源占用统计。

列出 Docker Compose 项目。

调用任意 appcgi.dockermgr.* 端点（写操作，兜底入口）。

固定命令未覆盖的 Docker 端点走这里：networkList、composeContainers、 composeStart/Stop 等。endpoint 只需端点名（CLI 自动加前缀校验）， body 为 JSON object 且不能包含 req/reqid（CLI 自动生成）。 Compose/网络/系统类写操作前先做只读探测（如 composeList）。

登记 Docker Compose 项目（写操作；composeCreate 端点）。

请求体真实结构（源自 fnOS 前端逆向）：{"auto_build": false, "file": "docker-compose.yaml", "folder": "/vol1/1000/xxx", "project_name": "xxx"}。compose 内容不在请求里——必须先用 file_write_text/file_upload 把 yaml 文件写入 folder，再调本工具。

典型流程：1) file_write_text 写 compose 文件；2) 本工具登记项目； 3) docker_compose_build(project_name) 真正拉起容器（compose up -d）； 4) docker_compose_containers(project_name) 验证。auto_build=true 可合并第 2/3 步。

注意：folder 的父目录若自身已带 compose 文件（如 /vol1/1000/docker 自带 docker-compose.yml），fnOS 会判定其为 compose 项目，嵌套创建 返回 errno 0x03200107（父级目录已存在项目），应换干净父目录； 0x03200102 表示 folder 下找不到 compose 文件。

拉起 Compose 项目容器（写操作；composeBuild，等价 compose up -d）。

新登记的项目必须先 build 才有容器；composeStart 只对已 build 过的 项目生效（它仅执行 docker compose start，不创建容器）。

启动已 build 的 Compose 项目（写操作；composeStart）。

仅执行 docker compose start，项目必须先 composeBuild 过； 未 build 的项目请用 docker_compose_build。

停止 Compose 项目（写操作；composeStop，容器转 Exited）。

删除 Compose 项目登记（写操作；composeDelete，项目列表清零）。

列出 Compose 项目下的容器（composeContainers）。

创建 Docker 容器（写操作）。

支持端口/挂载映射、环境变量、内存/CPU 限制与启动策略。 创建后可用 docker_containers(--all) 与 docker_container_action 管理。

⚠️ cmd 的限制：trim-cli 的 --cmd 会按空格重新切分，所以 cmd=["sh","-c","sleep 300"] 实际落成 ["sh","-c","sleep","300"]， ["sh","-c","while true; do ...; done"] 这类命令会直接跑挂。需要带空格 的参数时改用 docker_request(endpoint="containerCreate", body={...}) 传原始 Cmd 数组。

查看容器详细配置（inspect）。

查看容器内进程列表（top）。

查看单个容器的资源占用统计（cpuUsage / usedMem / networkRx / networkTx）。

注意：必须传 64 位容器 ID。传容器名时上游只返回 {"result":"succ"} 空壳，不报错，容易误判成"没有数据"。

更新容器配置（写操作）：重启策略 / 内存 / CPU 限制。

查看镜像详细信息（inspect）。

列出下载任务。

查看下载任务详情。

查看下载任务的文件列表。

新建下载任务（写操作）。

批量操作下载任务（写操作）：pause / resume / retry / rm。

查看下载中心全局统计。

从 NAS 本地路径新建下载任务（写操作，如 .torrent 文件）。

调用下载中心原始 API（兜底；写方法自动带 --yes）。

分页查询系统日志。

列出日志模块。

导出日志（写操作）。

清除指定级别/模块的日志（危险写操作，不可恢复）。

查询日志归档配置。

设置日志归档配置（写操作；switch/file_path 必填，其余可选）。

开始复制调试日志到本地目录（写操作，生成诊断数据）。

查看 CPU 使用率。

查看内存使用率。

查看网络流量。

查看磁盘 IO 统计。

查看 GPU 使用率。

列出系统进程。

查看系统告警。

查看 NPU 使用率。

查看电池状态（笔记本/UPS 场景）。

查看系统风扇转速。

查询指定进程的详细监控信息。

查询系统服务进程监控。

查询是否支持蜂鸣器。

查询蜂鸣器事件记录。

查询蜂鸣器鸣叫原因。

静音蜂鸣器（写操作）。

按指标名批量查询监控数据（gen 通用入口）。

可选指标：storeSpeed（存储吞吐）、netSpeed（网速）、 cpuBusy（CPU 忙碌）、memPercent（内存占用）。

查询 SSH 服务状态（开关、端口、sftp）。

trim-cli 没有 status 子命令（network ssh switch 必须带 --enable 或 --disable，直接调用会报错），所以这里走原始端点 appcgi.network.ssh.status。

启用或禁用 SSH 服务（写操作）。

重启 NAS（危险写操作）。

关闭 NAS（危险写操作）。

存储总览。

列出存储池。

列出硬盘。

查看硬盘健康状态。

查看硬盘 SMART 信息。

查看存储空间容量。

列出未加入存储池的空闲硬盘。

列出可移动设备（U 盘/移动硬盘）。

查看硬盘详细信息。

挂载存储空间（写操作）。

卸载存储空间（写操作；部分场景需管理员密码）。

挂载独立硬盘（写操作）。

卸载独立硬盘（写操作）。

列出 NAS 用户。

查询用户信息。

列出用户组。

查询用户组详情。

列出被冻结的账号。

列出用户与用户组（可带版本号做增量查询）。

查询用户组成员关系（按版本增量）。

列出当前用户的登录设备。

创建用户组（写操作）。

修改用户组（写操作）。

删除用户组（危险写操作）。

整组设置用户组成员（写操作，覆盖原有成员）。

向用户组添加成员（写操作）。

从用户组移除成员（写操作）。

创建 NAS 用户（写操作）。

修改 NAS 用户信息（写操作）。

删除 NAS 用户（危险写操作）。

授予/撤销用户管理员权限（写操作）。

解冻被冻结的账号（写操作）。

查看百度网盘应用状态（是否已绑定）。

查看百度网盘容量配额。

列出百度网盘目录内容。

搜索百度网盘文件。

在百度网盘创建目录（写操作）。

查询网盘文件详细信息（可含下载直链 dlink）。

删除网盘文件（写操作，进入网盘回收站）。

重命名网盘文件（写操作）。

移动网盘文件（写操作；src_paths 最后一项为目标目录）。

复制网盘文件（写操作；src_paths 最后一项为目标目录）。

上传本地文件到网盘（写操作）。

从网盘下载文件到 NAS（写操作）。

转存分享链接内容到网盘（写操作）。

列出网盘上传/下载传输任务。

查询网盘传输任务详情。

批量操作网盘传输任务（写操作）：pause / resume / cancel。

清空网盘传输任务记录（写操作）。

列出网盘同步任务。

创建网盘同步任务（写操作）。direction=download 网盘→NAS， upload NAS→网盘。

修改网盘同步任务配置（写操作；status/interval/conflict 必填）。

启停/删除网盘同步任务（写操作）。

导出 NAS 诊断日志到本地目录（写操作，生成诊断包）。

停止诊断日志导出任务（写操作）。

调用系统业务原始 API（兜底，特权入口）。

trim-cli 的命令格式是 raw <REQ> [--json <body>] [--yes]——没有 method 位置参数，GET/POST 由端点自身决定。非审计白名单里的端点 必须带 --yes，这里统一加，所以调用前请自己确认端点安全性。

例：raw_request("appcgi.network.ssh.status") 返回 SSH 开关状态。