技能介绍

要解决的问题

OpenList 的服务端 API 契约分散、易变：路径拼接、Token 校验、分页字段、跨驱动异步任务等细节，靠记忆拼接请求很容易在真实服务端上踩坑。直接手写 HTTP 调用还需要自己维护认证、分页和错误处理逻辑，调试成本高。openlist 技能的做法是把自然语言操作翻译成 openlist-cli 命令，由 CLI 去对接经真实服务端核验的 API 契约，而不是让模型凭印象造请求。

核心能力与工作方式

技能覆盖五类操作，全部通过命令分组驱动：

认证：auth login/logout/status，配置优先级为 CLI 选项 > 环境变量 > 配置文件；授权默认走终端交互式流程，由用户在提示中填写服务地址与 Token。
文件管理：fs 下的 list/get/search 浏览，mkdir/rename/move/copy/remove 增改删，put/form 上传，另有 batch-rename、regex-rename、recursive-move 等批量整理命令，以及 archive-meta/list/decompress 处理压缩包。
分享管理：share 的 create/update/delete/enable/disable，创建或更新时用 --path，可选 --password 与 --expires。
当前用户：me get 查看身份信息。
后台管理：admin 按资源分子命令树——user、storage、meta、setting、driver、index，增删改用 --file 或 --data 传 JSON。

典型流程是：识别意图（如「列出目录 X」→ fs list X）→ 检查认证 → 执行命令 → 解析结构化输出。所有命令输出统一为 { success, operation, data } 或 { success:false, message, code }，加 --pretty 可美化。列表命令的分页信息在 pagination 字段中，page < totalPages 时提示用户是否继续拉取，而不是自动拉全量。不确定参数时一律先查 openlist-cli <command> --help。

适用边界与注意点

跨驱动 copy/move/解压是异步任务：返回 task 后必须轮询目标目录确认落地，不能假设立即完成。
破坏性操作先确认：fs remove、fs move（覆盖）、share delete、admin */delete、admin storage disable、admin setting delete/reset-token、admin index build/clear 等执行前需要用户明确同意。
创建存储需二次确认：驱动值取自 admin driver names，表单字段取自 admin driver info，参数凑齐后创建前再确认一次。
Token 不回显：不写入对话、日志或文件；服务地址缺失时引导用户配置，不编造。
非交互环境（管道、脚本、CI）需显式提供 --base-url，避免命令阻塞等待输入。
fs archive-decompress 的目标目录必须预先存在；遇到 illegal file path: . 通常是压缩包含 . 顶层条目的服务端限制，并非 CLI 问题。