⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.7.0

alist-cli

kinemaclawworkspace@kinemaclawworkspace⭐ 1 stars· last commit 4mo ago· 0 open issues

|

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 1 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

AList CLI

基于 AList API 的文件管理 CLI 工具,支持上传、下载、搜索、直链获取,认证令牌自动管理。

功能

  • 文件上传/下载
  • 文件列表浏览
  • 创建文件夹、删除、移动文件
  • 文件搜索
  • 获取文件预览链接和下载直链
  • 自动登录认证 + 令牌自动刷新

适用场景

  • 通过对话管理 AList 云存储文件
  • 上传文件并获取分享链接
  • 搜索和浏览远程存储

使用方式

本 skill 支持 Codex、Claude Code 和 OpenClaw,安装后可通过对话触发:

上传这个文件到云存储
帮我看看 /public/docs 下有什么文件
搜索一下 xxx 相关的文件
把文件分享给别人

首次使用需完成 references/ONBOARDING.md 配置(设置环境变量和安装脚本)。

Codex 安装

codex plugin marketplace add https://github.com/KinemaClawWorkspace/kinema-skills-marketplace.git
codex plugin add alist-cli@kinema-skills-marketplace

安装后新开一个 Codex 对话。Codex 插件本身不需要 Node.js;运行 AList CLI 需要 Python 3 和 requests。

命令列表

命令说明
login登录认证
ls [path]列出文件
upload <local> <remote>上传文件
get <path>获取文件信息
url <path>获取预览/下载链接
mkdir <path>创建文件夹
rm <path>删除文件
mv <src> <dst>移动文件
search <keyword>搜索文件
whoami当前用户

项目结构

alist-cli/
├── .claude-plugin/plugin.json
├── .codex-plugin/plugin.json
├── skills/alist-cli/SKILL.md
├── SKILL.md
├── scripts/
│   └── alist_cli.py
└── references/
    ├── ONBOARDING.md
    └── openapi.json

作者

许可证

GNU General Public License v3.0

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md5.0 KBupstream ↗
    ---
    name: alist-cli
    displayName: "AList CLI (Cloud Storage CLI for AList)"
    version: 1.7.0
    description: |
      AList file management CLI for AI agents including Codex, Claude Code, and OpenClaw. Supports upload, download, list, mkdir, rm, mv, search, url.
      Auth via environment variables with auto-refresh. Trigger: file management, AList operations, upload/download.
    ---
    
    # AList CLI
    
    - **Author**: [LeeShunEE](https://github.com/LeeShunEE)
    - **Organization**: [KinemaClawWorkspace](https://github.com/KinemaClawWorkspace)
    - **GitHub**: https://github.com/KinemaClawWorkspace/alist-cli
    
    AList file management CLI. Auth token managed via environment variables with auto-login and auto-refresh.
    
    ## ⚠️ Before First Use | 首次使用必读
    
    **首次使用此 skill 前,必须先读取 [references/ONBOARDING.md](references/ONBOARDING.md) 完成环境配置。**
    
    - **环境不可用**(命令不存在、依赖缺失、连接失败)→ 读取 [references/ONBOARDING.md](references/ONBOARDING.md) 按步骤排查修复
    - **首次配置** → 读取 [references/ONBOARDING.md](references/ONBOARDING.md) 完成 6 步配置
    - **配置完成后** → 直接使用下方 Run Commands
    
    ## Environment Variables
    
    | Variable | Required | Description |
    |----------|----------|-------------|
    | `ALIST_URL` | ✅ | AList server URL (e.g. `https://your-alist-server`) |
    | `ALIST_USERNAME` | ✅ | Login username |
    | `ALIST_PASSWORD` | ✅ | Login password |
    | `ALIST_AUTH_TOKEN` | ❌ | Auth token (auto-obtained via login, skip manual set) |
    | `ALIST_USER_INFO` | ❌ | User info JSON (auto-obtained via login, skip manual set) |
    
    ## Run Commands
    
    ```bash
    alist-cli <command> [args]
    ```
    
    ### Commands
    
    | Command | Description |
    |---------|-------------|
    | `login [username] [password]` | Login (outputs export statements to source) |
    | `ls [path]` | List files |
    | `get <path>` | Get file info + all URLs |
    | `url <path>` | Get preview/download URLs for file or folder |
    | `mkdir <path>` | Create folder |
    | `upload <local> <remote>` | Upload file (outputs preview + download URL) |
    | `rm <path>` | Delete file |
    | `mv <src> <dst>` | Move file |
    | `search <keyword> [path]` | Search files |
    | `whoami` | Current user info |
    
    ## Upload Behavior | 上传行为
    
    **上传前必须判断文件用途,选择正确的目标路径:**
    
    ### 判断规则
    
    | 场景 | 目标路径 | 说明 |
    |------|---------|------|
    | **外部访问**(分享给他人、公开文件) | `/public/...` | Guest 可见,预览和下载链接无需登录 |
    | **内部使用**(个人文件、工具输出、临时文件) | `/private/storage/...` | 需要登录才能访问 |
    
    **如何判断:**
    1. 用户明确说"分享给 XX"、"发给别人"、"外部" → `/public/`
    2. 用户说"内部"、"私有"、"自己看"、"备份" → `/private/storage/`
    3. 用户未说明 → **必须询问**文件用途
    4. 批量上传多个文件到同一个目标 → 可以创建新文件夹整理
    5. 单个文件 → 一般直接上传到已有目录,不新建文件夹(除非用户指定或目标目录为空)
    
    ### 文件夹创建规则
    
    - ❌ 不要随意创建新文件夹
    - ✅ 用户明确要求时才创建
    - ✅ 批量上传且目标目录为空时,可以创建子文件夹
    - ✅ 用户指定路径时,自动创建(mkdir -p 行为由 API 保证)
    
    ## URL Rules
    
    AList 文件有两种链接:
    
    ### 1. 预览链接
    
    ```
    {ALIST_URL}{path}
    ```
    
    - 从 raw_url 去掉 `/p` 前缀和 `?sign=xxx` 参数
    - **内部文件**(`/private/`):需要 AList 登录态才能预览
    - **外部文件**(`/public/`):无需登录即可预览
    - 例: `https://cloud.example.com/public/docs/notes.md`
    
    ### 2. 下载直链
    
    ```
    API 返回的 raw_url 字段(包含 /p/ 前缀和 ?sign 签名)
    ```
    
    - 直接下载文件,无需登录,curl/wget 可用
    - 签名有时效性,过期后需重新通过 API 获取
    - 例: `https://cloud.example.com/p/public/docs/notes.md?sign=abc123=:0`
    - **分享文件时优先使用此链接**
    
    ### Directory Structure | 目录结构
    
    ```
    / (root)
    ├── public/        ← 外部访问(guest 挂载点)
    │   └── ...
    └── private/       ← 内部文件(需登录)
        └── storage/   ← 用户存储
            └── ...
    ```
    
    ### Path Mapping
    
    ```
    user_path (用户输入)  →  real_path (AList API 使用)
    /public/docs/a.md    →  /public/docs/a.md       (外部)
    /private/storage/a   →  /private/storage/a       (内部)
    ```
    
    - `base_path` 通过登录自动获取(`/api/me` 接口),当前为 `/`
    - 预览链接基于 `real_path`(去掉 `/p` 和 `?sign`)
    - 下载直链使用 API 返回的 `raw_url`
    
    ## Auth Behavior
    
    - **Auto-login**: Script checks `ALIST_AUTH_TOKEN` on startup. If missing, auto-logins with `ALIST_USERNAME` + `ALIST_PASSWORD`.
    - **Auto-refresh**: If API returns 401, automatically re-logins and retries.
    - **Manual login**: `alist login` command outputs `export` statements. User should `eval $(alist login)` or manually `source` them.
    
    ## References
    
    - `references/openapi.json` - AList API specification
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/kinemaclawworkspace-alist-cli.md

// REPO STATS

1 stars
0 open issues
Last commit: 4mo ago