AList CLI (Cloud Storage CLI for AList)
AI代理的AList云存储文件管理CLI
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：AList CLI (Cloud Storage CLI for AList)。 它的用途是：AI代理的AList云存储文件管理CLI 完整的 Skill 内容见：https://321skill.com/skills/alist-cli-cloud-storage-cli-for-alist/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请使用AList CLI将本地的README.md文件上传到云存储的文档目录下'，AI会执行 `alist upload ./README.md /文档/` 并返回结果。再比如：'列出云存储中所有图片文件'，AI会运行 `alist list --filter "*.png" 或 "*.jpg"` 并输出文件名列表。如果某个文件需要外部访问链接，AI可以调用 `alist url /文档/example.pdf` 获取直链。
介绍
AList CLI 是一个专为 AI 代理（如 Codex、Claude Code、OpenClaw）设计的命令行工具，用于管理 AList 云存储服务中的文件。它解决了在自动化工作流中无法直接通过终端操作云存储文件的问题，支持上传、下载、列表、创建目录、删除、移动、搜索和获取文件直链等核心功能，帮助开发者和 AI 代理高效完成文件管理任务。
使用方式极其简单：通过环境变量（如 ALIST_HOST、ALIST_TOKEN）完成认证后，直接调用 alist upload、alist ls、alist download 等命令即可。所有操作均可在终端或 AI 代理的 shell 中执行，无需手动操作网页界面，非常适合集成到 CI/CD 流水线、自动化脚本或智能体工作流中。
适合后端开发者、运维工程师和智能体开发人员，尤其是那些需要让 AI 代理自主管理云存储资源的场景。例如，AI 在生成代码后自动上传到指定目录，或定期同步配置文件到云端。
建议在使用前确保 AList 服务已正确部署，并妥善保管 Token 等敏感信息，避免硬编码在脚本中。由于是纯命令行工具，不支持图形化交互，复杂权限管理仍需通过 AList 后台配置。
核心特点
与 rclone、ossutil 等通用云存储 CLI 不同，AList CLI 专门为 AI 代理的交互模式优化，认证方式仅需环境变量，命令输出简洁，易于被 AI 解析，且深度适配 Codex、Claude Code 等工具的自动补全和错误处理机制。
注意事项
不适合需要图形界面或拖拽操作的场景，且仅支持 AList 后端，无法直接对接其他云存储服务。
常见问题
如何安装 AList CLI？
推荐使用 npm 全局安装：`npm install -g alist-cli`，或从 GitHub Releases 下载二进制文件。
如何配置认证信息？
设置环境变量 `ALIST_HOST`（例如 http://your-alist-server:5244）和 `ALIST_TOKEN`（AList 后台生成的令牌），即可自动认证。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/alist-cli-cloud-storage-cli-for-alist/raw/index.md 读取 AList CLI (Cloud Storage CLI for AList) 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/alist-cli-cloud-storage-cli-for-alist/raw/index.md（查看排版版本）