chore: 初始化 123yunpan skill 仓库 (v1.3.0)

- 完整 skill 本体：SKILL.md / README.md / manifest.json / config.json - scripts/123yunpan.py：零依赖 CLI（含空间双配额、QPS 限流、零依赖 XLSX） - references/ 参考资料 - 排除 .workbuddy/ 开发目录与 __pycache__
2026-09-27 22:41:43 +08:00
commit f0ecfa6de0
8 changed files with 5124 additions and 0 deletions
@@ -0,0 +1,180 @@
+{
+  "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"
+      }
+    }
+  }
+}