{
  "name": "123yunpan",
  "version": "1.3.0",
  "description": "123云盘开放平台 CLI 工具。支持文件管理、上传下载、分享链接、离线下载、直链、图床、视频转码等 70+ API 端点，专业/标准双空间配额报告，零依赖 Excel 导出。",
  "entry": "scripts/123yunpan.py",
  "config": {
    "env": [
      {
        "name": "TWOPAN_CLIENT_ID",
        "required": true,
        "description": "123云盘开发者 Client ID，从 https://www.123pan.com/member 购买开发者权益包获取"
      },
      {
        "name": "TWOPAN_CLIENT_SECRET",
        "required": true,
        "description": "123云盘开发者 Client Secret"
      },
      {
        "name": "TWOPAN_ACCESS_TOKEN",
        "required": true,
        "description": "123云盘 API Access Token（可通过 setup 命令自动获取）"
      }
    ]
  },
  "security": {
    "warnings": [
      "access_token 和 client_secret 是敏感凭证，不要硬编码在脚本中",
      "批量删除操作（share delete-batch --all）会删除所有分享链接，请先用 --dry-run 预览",
      "深度目录遍历（100+ 文件夹）可能耗时 5-10 分钟，使用 BFS 缓存可加速",
      "专业空间或标准空间任一超额都会阻断开放平台上传，大批量上传前先跑 space 查看配额",
      "审核驳回文件（status > 100）无法分享，share create-batch 会在遍历阶段自动剔除",
      "WebDAV 上传有 30-90 秒索引延迟，上传后需轮询等待文件出现"
    ],
    "suggested_isolation": {
      "config_file": "凭证存储在 ~/.123yunpan_config.json 或环境变量中",
      "env_file": "推荐使用环境变量，不要在代码中硬编码"
    }
  },
  "commands": {
    "config": {
      "description": "配置管理",
      "subcommands": ["show", "check", "export", "import"]
    },
    "file": {
      "description": "文件管理",
      "subcommands": ["list", "search", "tree", "detail", "details-multi", "mkdir", "rename", "rename-batch", "move", "copy", "copy-batch", "copy-progress", "trash", "recover", "recover-by-path", "download", "download-batch", "storage-report"]
    },
    "upload": {
      "description": "上传文件（V2 API，自动单次/分片上传）",
      "subcommands": []
    },
    "space": {
      "description": "空间占用报告（专业空间 / 标准空间双配额）"
    },
    "share": {
      "description": "分享管理",
      "subcommands": ["create", "create-batch", "list", "update", "stats", "delete-batch", "export", "pay-create", "pay-list", "pay-update"]
    },
    "offline": {
      "description": "离线下载",
      "subcommands": ["create", "progress", "list"]
    },
    "direct-link": {
      "description": "直链管理",
      "subcommands": ["enable", "disable", "url", "short-url", "cache-refresh", "ip-list", "ip-switch", "ip-update", "offline-logs", "traffic-logs"]
    },
    "oss": {
      "description": "图床管理",
      "subcommands": ["list", "detail", "delete", "move", "copy", "copy-process", "copy-fail"]
    },
    "transcode": {
      "description": "视频转码",
      "subcommands": ["list", "folder", "resolutions", "transcode", "record", "result", "delete", "download", "download-m3u8", "download-all", "upload-cloud"]
    },
    "safebox": {
      "description": "保险箱管理",
      "subcommands": ["unlock"]
    },
    "cache": {
      "description": "BFS 缓存管理",
      "subcommands": ["list", "clear", "info"]
    },
    "user-info": {
      "description": "获取用户信息"
    }
  },
  "global_options": {
    "--no-color": "禁用彩色输出（也支持 NO_COLOR 环境变量）",
    "--json": "JSON 机器可读输出（单行，无缩进）"
  },
  "inputs": {
    "file": {
      "type": "string",
      "description": "要上传的本地文件路径",
      "required": false
    },
    "parent-id": {
      "type": "number",
      "description": "目标文件夹 ID（默认 0 = 根目录）",
      "required": false,
      "default": 0
    },
    "file-ids": {
      "type": "string",
      "description": "文件 ID 列表（逗号分隔，如 1,2,3）",
      "required": false
    },
    "excel-threshold": {
      "type": "number",
      "description": "share create-batch 链接数超过该值时自动生成 Excel（默认 10）",
      "required": false,
      "default": 10
    },
    "url-format": {
      "type": "string",
      "description": "分享链接格式：official(默认) / web / uid / short",
      "required": false,
      "default": "official"
    }
  },
  "outputs": {
    "file_list": {
      "description": "文件列表 JSON",
      "fields": {
        "fileId": "文件 ID（数字）",
        "filename": "文件名",
        "size": "文件大小（字节）",
        "type": "类型（0=文件, 1=文件夹）",
        "trashed": "是否在回收站（0=否, 1=是）",
        "parentFileID": "父文件夹 ID",
        "createAt": "创建时间"
      }
    },
    "share_create": {
      "description": "创建分享结果",
      "fields": {
        "shareID": "分享 ID",
        "shareKey": "分享密钥",
        "_shareUrl": "CLI 自动拼接的完整链接"
      }
    },
    "upload": {
      "description": "上传结果",
      "fields": {
        "fileID": "文件 ID",
        "completed": "是否完成",
        "reuse": "是否秒传（文件已存在）"
      }
    },
    "user_info": {
      "description": "用户信息",
      "fields": {
        "uid": "用户 ID",
        "nickname": "昵称",
        "spaceUsed": "已用空间（字节）",
        "vip": "是否 VIP"
      }
    },
    "space_report": {
      "description": "空间占用报告（专业 / 标准双配额）",
      "fields": {
        "total_quota": "总配额（字节）",
        "total_used": "总已用（字节）",
        "professional.used": "专业空间已用（本人文件 / ≥10GB / 直链 / 转码 / 图床）",
        "professional.quota": "专业空间配额",
        "professional.remain_days": "剩余清理天数，>0 时超出后配额不可恢复",
        "standard.used": "标准空间已用（转存文件，重复与回收站文件不计）",
        "standard.quota": "标准空间配额"
      }
    },
    "share_excel": {
      "description": "分享链接 Excel 三列结构",
      "columns": {
        "文件名称": "不含分类前缀与扩展名，如 Cinema 4D R20",
        "链接": "该文件的分享/直链 URL，单元格为可点击超链接",
        "路径": "云盘内完整相对路径，如 软件/office/离线安装包/2021/ProPlus2021Retail.img"
      }
    }
  }
}