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 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我上传本地~/docs/report.pdf到云存储的public目录，并获取分享链接'，AI会先执行alist-cli login自动登录，然后执行alist-cli upload ~/docs/report.pdf /public/report.pdf，最后通过alist-cli url /public/report.pdf获取预览和下载链接返回给你。
介绍
这个Skill解决了AI代理在云存储文件管理中的痛点。在实际开发中，AI编码助手（如Codex、Claude Code）需要频繁上传、下载、列出、搜索、移动和删除文件，但缺乏统一的命令行接口，每次都需要手动编写脚本或使用不同工具，效率低下。AList CLI为AI代理提供了标准化的文件操作命令，支持自动认证和令牌刷新，无需人工干预。
使用方式很简单，你只需要配置三个环境变量：AList服务器地址、用户名和密码。之后就可以通过自然语言指令来执行文件管理，例如“上传本地文件到远程目录”或“列出public下的文件”。CLI支持登录、列表、获取文件信息、获取下载链接、创建文件夹、上传、删除、移动、搜索和查看用户信息等12个命令，所有操作都基于AList API，响应快速。
它非常适合需要频繁与云存储交互的AI代理开发者、智能体应用和自动化工作流。尤其是那些已经使用AList搭建私有云存储的团队，AList CLI可以无缝集成到AI编码环境中，让AI代理自主完成文件管理任务，减少人工介入。
建议在配置环境变量时确保AList_URL以https开头，并检查网络连通性。首次使用前必须阅读ONBOARDING.md完成环境配置。需要注意的是，上传文件时需根据用途选择public或private目录，外部分享用/public，内部使用用/private/storage。
常见问题
如何配置环境变量？
设置AList_URL、ALIST_USERNAME、ALIST_PASSWORD即可，ALIST_AUTH_TOKEN和ALIST_USER_INFO可自动获取，无需手动设置。
不支持哪些文件操作？
当前不支持复制、重命名（可通过mv实现）、批量操作、目录递归下载等功能。
给 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（查看排版版本）