乐享文件上传管理

前置条件：本 skill 需要已配置乐享 MCP 连接。如未配置，请先使用 lexiang-setup skill。 遇到 401 错误：不要重试，切换到 lexiang-setup skill 引导用户续期（点击续期按钮即可恢复，无需重新配置）。

⚠️ 前置检查：确认产品版本

每次执行文件操作前，先调用 whoami() 检查 sub_server_type：

• v2 → 继续使用本 skill
• v1 → 停止，提示用户加载 lexiang-v1-docs（文件上传）或 lexiang-v1-assets（图片上传）
• v1v2 → 如果用户明确说了「乐享社区」→ 提示切换对应 v1 skill；否则继续使用本 skill

工具概览

📎 文件管理

• file_apply_upload — 申请文件上传（返回 upload_url 和 session_id）
• file_commit_upload — 确认上传完成
• file_describe_file — 获取文件详情
• file_download_file — 下载文件

文件上传完整流程（三步）

⚠️ 必须严格按顺序执行以下三步，缺一不可。

Step 1: 申请上传凭证（MCP 调用）

MCP Tool: file_apply_upload
Arguments: {
  "parent_entry_id": "<目标目录的 entry_id>",
  "name": "example.pdf",
  "size": 12345,
  "mime_type": "application/pdf",
  "upload_type": "PRE_SIGNED_URL"
}

必填参数说明：

返回值（关键字段）：

{
  "session": {
    "session_id": "abc123",
    "upload_url": "https://cos.example.com/upload?sign=xxx"
  }
}

Step 2: HTTP PUT 上传文件内容（curl 命令，非 MCP）

⚠️ 这一步不是 MCP 调用，必须用 curl 命令执行 HTTP PUT 请求。

curl -X PUT \
  -H "Content-Type: <mime_type>" \
  --data-binary "@<本地文件路径>" \
  "<Step 1 返回的 upload_url>"