AList 统一网盘管理

基于alist(45k+星)的统一网盘管理服务，支持百度网盘/阿里云盘/夸克网盘/115网盘等30+种存储后端。通过alist REST API v3实现文件上传、下载、分享、删除等操作。内置Token自动刷新(48小时有效期，过期前5分钟自动续期)、熔断器保护(3次重试+指数退避)和发货安全机制(自动密码+有效期+客户跟踪+重发限制)。替代原baidu-pan-mcp和quark-promote-mcp。

使用场景

1. 虚拟商品自动发货生成安全分享链接（EP-02）
2. 多平台网盘资源统一管理与同步
3. 闲置资源分享管理（带密码+有效期保护）
4. 云端素材库维护（商品图/视频/文案模板）
5. 企业文件集中管理（跨网盘统一操作）
6. 发货链接过期提醒与自动重发
7. 虚拟商品自动发货：买家付款后自动生成网盘分享链接+提取码发送给买家
8. 资料包分发：批量生成分享链接，用于闲鱼商品描述中的下载指引

工作流

主流程: 文件上传与分享

1. 调用list_drives确认可用的存储后端
2. 调用upload_file将本地文件上传到指定网盘目录
3. 调用create_share_link生成分享链接(设置密码+有效期)
4. 输出分享URL+密码+有效期信息

安全发货流程(虚拟商品专用)

1. 根据商品类型确定网盘文件路径
2. 调用create_secure_share生成安全分享链接(自动6位密码(小写字母+数字)+默认3天有效期)
3. delivery_tracker记录客户跟踪信息(买家ID+商品+链接+过期时间)
4. 输出安全分享结果(share_url+password+period_days+expires_at)

文件浏览与下载

1. 调用list_files列出指定目录下的文件
2. 调用get_file_info获取文件详细信息(大小/类型/修改时间)
3. 调用download_url获取文件下载链接
4. 输出文件列表或下载URL

发货跟踪管理

1. 调用redelivery_status查询买家发货记录(过期状态/重发次数/剩余次数)
2. 调用check_expiring_links检查即将过期的分享链接
3. 调用delivery_stats获取发货统计信息
4. 输出跟踪状态或统计结果

输入格式

文件上传

{
  "local_path": "d:/output/product_image.png",
  "remote_dir": "/JueJin/products/",
  "drive": ""
}

安全分享

{
  "file_path": "/JueJin/products/tutorial.zip",
  "drive": "",
  "period_days": 3
}

发货跟踪查询

{
  "buyer_id": "buyer_123",
  "product_name": "OpenClaw部署教程"
}

输出格式

分享链接输出

{
  "success": true,
  "data": {
    "share_url": "http://localhost:5244/s/abc123",
    "password": "a3b7",
    "file_path": "/JueJin/products/tutorial.zip",
    "drive": "",
    "period_days": 3
  },
  "error": null,
  "code": null
}

安全分享输出(含跟踪)

{
  "success": true,
  "data": {
    "share_url": "http://localhost:5244/s/abc123",
    "password": "k9m2",
    "file_path": "/JueJin/products/tutorial.zip",
    "period_days": 3,
    "expires_at": 1747358400.0
  },
  "error": null,
  "code": null
}

MCP工具清单

Token管理

异常处理

三省六部归口

• 部门: 吏部 (libu_hr)
• 职责: 统一网盘存储与资产管理
• 关联Agent: libu_hr

示例

示例1: 上传文件并生成安全分享链接

输入:

{"local_path": "d:/output/tutorial.zip", "remote_dir": "/JueJin/products/", "drive": ""}

执行:

1. 调用upload_file(local_path="d:/output/tutorial.zip", remote_dir="/JueJin/products/")
2. 调用create_secure_share(file_path="/JueJin/products/tutorial.zip", period_days=3)
3. delivery_tracker自动记录客户跟踪信息

输出:

{
  "success": true,
  "data": {
    "share_url": "http://localhost:5244/s/abc123",
    "password": "k9m2",
    "file_path": "/JueJin/products/tutorial.zip",
    "period_days": 3,
    "expires_at": 1747358400.0
  }
}

示例2: 查询买家发货记录

输入:

{"buyer_id": "buyer_123", "product_name": "OpenClaw部署教程"}

执行:

1. 调用redelivery_status(buyer_id="buyer_123", product_name="OpenClaw部署教程")
2. 返回链接状态+重发次数+剩余次数

输出:

{
  "success": true,
  "data": {
    "buyer_id": "buyer_123",
    "product_name": "OpenClaw部署教程",
    "share_url": "http://localhost:5244/s/abc123",
    "is_expired": false,
    "remaining_hours": 48.5,
    "delivery_count": 1,
    "can_redeliver": true,
    "remaining_redeliveries": 2,
    "status": "active"
  }
}