ai-netdisk

name	ai-netdisk
description	让 AI 助手连接并操作网盘（夸克/百度/阿里/天翼等）内容的工具。涵盖网盘挂载为本地磁盘、Cookie/Token 获取与更新、文件批量整理（分类/重命名/移动/去重）。当用户提到连接网盘、挂载网盘、AI 调用网盘文件、网盘内容整理、网盘 Cookie 更新时触发。
agent_created	true

AI 网盘连接器

概述

本 skill 让 AI 助手能够连接你的网盘，直接读取、检索与整理其中的文件内容。

底层通过 Alist（Docker 容器）统一管理多个网盘，并以 WebDAV / 本地磁盘挂载的方式，使 AI 能像操作本地文件一样去调用网盘里的内容——无论是分类归档、重命名去重，还是批量读取后再处理。支持夸克网盘、百度网盘、阿里云盘、天翼云盘等多种驱动。

---

工作流 1：部署 Alist

全新部署

docker run -d --restart=unless-stopped \
  -v $(pwd)/alist-data:/opt/alist/data \
  -p 5244:5244 \
  --name alist \
  xhofe/alist:latest

检查状态

docker ps --filter "name=alist"
curl -s -o /dev/null -w "HTTP %{http_code}\n" http://127.0.0.1:5244/

获取初始密码

docker exec alist ./alist admin random

设置自定义密码

docker exec alist ./alist admin set <新密码>

容器管理

docker start alist       # 启动
docker stop alist        # 停止
docker restart alist     # 重启
docker logs alist        # 查看日志

Alist 后台地址：http://127.0.0.1:5244 默认账号 admin

---

工作流 2：配置网盘驱动

在 Alist 后台添加存储

1. 打开 http://127.0.0.1:5244 → 登录 → 进入「管理 → 存储」
2. 点击「添加」→ 选择驱动 → 填写配置

各网盘驱动配置

详见 references/drivers.md，以下为快速参考：

网盘	驱动名	关键认证字段	获取方式
夸克网盘	Quark	cookie	浏览器 F12 → Application → Cookies
百度网盘	BaiduNetdisk	refresh_token	Alist 后台引导授权
阿里云盘	AliyundriveOpen	refresh_token	Alist 后台引导授权
天翼云盘	Cloud189	username/password	账号密码
123云盘	123Pan	token	抓包
WebDAV	Native	url/user/pass	目标服务地址

Cookie/Token 过期判断

通过 API 查看存储状态：

POST /api/admin/storage/list  (Header: Authorization: <token>)

• status: work → 正常
• status: token invalid 或含错误码 → 认证过期，需更新

---

工作流 3：Cookie/Token 获取与更新

通用获取方法（浏览器抓取）

适用于夸克、123云盘等基于 Cookie 的网盘：

1. 浏览器（建议无痕窗口）登录目标网盘
2. 按 F12 → Application 标签页 → Cookies → 选择网盘域名
3. 复制全部 cookie，拼成 key1=value1; key2=value2; ... 格式
4. 或从 Network 面板：任意请求 → Headers → Cookie: 行复制

自动更新 Cookie（API 方式）

运行脚本（支持任意基于 Cookie 的网盘）：

python scripts/update_cookie.py \
  --alist-url http://127.0.0.1:5244 \
  --username admin \
  --password <密码> \
  --driver Quark \
  --cookie-file cookie.txt

脚本流程：

1. 登录 Alist 获取 JWT token
2. 查询存储列表，找到指定驱动的存储
3. 更新 addition.cookie 字段
4. 验证状态变为 work

详见 references/netdisk_api.md 了解完整 API

---

工作流 4：RaiDrive 挂载

下载安装 RaiDrive

官网：https://www.raidrive.com （免费版即可）

添加 WebDAV 挂载

设置项	值
类型	NAS → WebDAV
协议	HTTP（不是 HTTPS，除非 Alist 配了 SSL）
地址	127.0.0.1
端口	5244
路径	/dav（挂载全部存储）或 /dav/<挂载路径>（挂载单个网盘）
账户	Alist 管理员用户名
密码	Alist 管理员密码
自动重连	勾选

常见问题

现象	原因	解决
ProtocolVersion 错误	协议选了 HTTPS	改成 HTTP
401 Unauthorized	账号密码错误	确认 Alist 登录凭证
挂上但文件夹打不开	网盘 Cookie 过期	更新 Cookie（工作流3）
连接超时	Alist 容器未运行	docker start alist

替代方案

除 RaiDrive 外，也可用：

• Windows 资源管理器：映射网络驱动器 → http://127.0.0.1:5244/dav
• rclone mount：跨平台，命令行配置
• Alist 自带客户端：直接用网页浏览

---

工作流 5：网盘文件批量整理

核心原则

所有文件操作通过 Alist 服务端 API 执行，不走 WebDAV 的 mv/cp（API 快得多）。

API 快速参考

操作	API	关键参数
列目录	POST /api/fs/list	path, refresh: true
建文件夹	POST /api/fs/mkdir	path
移动	POST /api/fs/move	src_dir, dst_dir, names: []
重命名	POST /api/fs/rename	path(旧完整路径), name(新名)
删除	POST /api/fs/remove	dir, names: []

完整 API 文档见 references/netdisk_api.md

批量整理注意事项

1. 先扫描再操作：用 refresh: true 列出目录，确认实际文件名后再操作
2. 分批执行：每批 10-20 项，每批间隔 0.3-1 秒
3. 异步移动：部分网盘（如夸克）的 move 是异步的，返回 success 后需 refresh 才能看到结果
4. 文件名编码：ls 输出可能把末尾空格编码为 %20，实际文件名不含
5. 系统文件夹：网盘自动创建的文件夹可能无法移动（API 报错）
6. 删除 = 回收站：remove 会将文件放入网盘回收站（非永久删除），保留约 30 天
7. 删除非空文件夹前先移出内容：否则未移出的文件会一起进回收站

整理流程建议

1. 扫描 → 列出根目录，保存到本地 JSON
2. 分类方案 → 按关键词匹配分类，生成方案交用户确认
3. 建文件夹 → 创建分类文件夹
4. 批量移动 → 每批 10 项移入分类文件夹
5. 子分类 → 创建子分类文件夹，继续细分
6. 重命名 → 去广告水印、去编号前缀、简化长名、语义识别重命名
7. 去重 → 对比内容完全相同的文件夹，确认后删除
8. 验证 → 每步用 refresh: true 验证结果

---

Resources

scripts/

• update_cookie.py — 通用 Cookie 更新脚本，支持任意基于 Cookie 的 Alist 网盘驱动

references/

• netdisk_api.md — 网盘 REST API 完整参考（认证、文件操作、存储管理、错误码）
• drivers.md — 各网盘驱动配置说明（夸克/百度/阿里/天翼等）