今天给大家推荐一个项目 115-netdisk-skill,是一个面向 Codex / OpenClaw / Hermes / CLI Agent 的 115 网盘 Skill。
简单来说,它的作用就是:让 AI Agent 具备操作 115 网盘的能力。
它可以完成扫码登录、保存登录态、浏览目录、搜索文件、添加离线下载任务、查看离线任务状态等操作。也就是说,Agent 不再只是告诉你“应该怎么打开网页手动操作”,而是可以在一定程度上直接帮你完成网盘相关任务。
仓库地址:https://github.com/chongchong59699/115-netdisk-skill
01
这个Skill为什么会出现?
现在很多 Agent 已经能写代码、改项目、执行命令、读文件、调接口,但一旦涉及“网盘资源管理”,就会突然变得很笨。
比如你想让 Agent 帮你做这些事情:
“帮我看看 115 里有没有这个文件。”“帮我搜索某个关键字相关的资源。”“帮我添加一个离线下载任务。”“帮我看看离线任务有没有完成。”“帮我整理某个目录下的文件列表。”
正常情况下,Agent 没有网盘操作能力。它只能告诉你“你可以打开网页手动操作”,或者帮你写一段脚本,但它自己并不能完成闭环。
这个 Skill 的核心目的,就是把 115 网盘变成 Agent 可以调用的工具能力。
也就是说,未来你和 Agent 对话时,不只是让它“建议你怎么做”,而是可以让它真正去执行一部分网盘操作。
02
这个 Skill 能做什么?
目前这个 Skill 主要支持以下能力:
115 网盘扫码登录
登录态保存与复用
浏览网盘目录
搜索网盘文件
添加离线下载任务
查询离线任务状态
面向 Agent 的二维码输出适配
面向 Codex / OpenClaw / Hermes / CLI Agent 的使用说明
它不是一个单纯的 115 脚本集合,而是尽量按照 Agent Skill 的方式来组织:让 Agent 能读懂、会安装、知道怎么调用,并且能在对话中把结果反馈给用户。
03
它解决的核心问题
115 的登录方式比较特殊,很多场景下需要扫码。普通脚本可以扫码,但 Agent 场景更麻烦,因为 Agent 不一定能直接弹出二维码,也不一定能渲染本地图片。
所以这个项目专门做了 Agent 兼容设计。扫码登录脚本会同时输出多种二维码标记,包括 LOGIN_QR_JSON、QR_IMAGE_PATH、QR_FILE_URI、QR_REMOTE_URL 和 QR_MARKDOWN,让不同类型的 Agent 都能选择自己能处理的方式,把二维码展示给用户。
第二个问题是:Agent 执行命令时不能一直卡住。
扫码登录不是一个瞬间完成的动作。脚本启动后,需要先生成二维码,然后等待用户用 115 App 扫码确认。
对 Codex、Hermes、OpenClaw 这类 Agent 来说,如果一直等命令结束再回复用户,用户根本看不到二维码,也就无法扫码。
所以这个 Skill 的设计里明确要求:Agent 看到二维码输出标记后,就应该立刻把二维码图片或链接发给用户,然后继续等待登录结果。这个细节看起来很小,但对 Agent 实际可用性非常关键。
第三个问题是:不能只给 Agent 一个说明文档,还要给它完整工具链。
这个 Skill 采用了模拟 TV 登录的方式来处理登录态,尽量避免直接占用网页端登录状态,从而降低“顶掉线”的概率。
这个仓库不是只有一个 SKILL.md。README 里也说明了,安装时需要复制完整 Skill 文件集,包括 SKILL.md、scripts/、agents/ 和 requirements.txt,否则浏览目录、搜索、离线下载这些功能都无法正常工作。
04
安装方式
此项目提供了自动安装入口,目标是尽量减少使用门槛。
如果你是给 Agent 安装,可以直接让它读取安装说明:
curl -fsSL https://raw.githubusercontent.com/chongchong59699/115-netdisk-skill/master/SKILL.md请安装这个skill和基础环境
Agent 读取说明后,会按要求复制完整文件集,并安装基础依赖。
需要注意的是,不要只复制 SKILL.md。这个 Skill 依赖 scripts、agents 和 requirements.txt,缺少这些文件会导致功能不完整。

通过微信接入hermes对话安装示例:

05
一些简单的使用示例
下面放几个通过微信接入hermes对话实际使用场景,主要展示这个 Skill 接入 Agent 后能做什么。
1.自动抓取上传流媒体字幕
这个场景下,可以让 Agent 根据目录内容和文件名称,辅助查找、整理、上传或匹配字幕文件。
这里原本需要人手动打开网盘、搜索文件、判断目录,现在可以让 Agent 参与一部分整理流程。

2.整理流媒体目录
网盘里资源一多,目录结构很容易混乱。
接入 Skill 后,可以让 Agent 读取指定目录下的文件列表,再根据文件名、剧集、季数、清晰度等信息辅助整理。

3.下载文件
当 Agent 能够浏览和搜索网盘文件后,就可以根据用户描述定位目标文件,并执行下载相关操作。
这类场景比较适合处理“我知道大概叫什么,但不想自己翻目录”的情况。

4.离线下载
115 的离线下载能力也可以被 Agent 调用。
你可以把链接发给 Agent,让它添加离线下载任务,然后继续查询任务状态。

这个项目的定位不是做一个完整的 115 网盘客户端,也不是替代官方客户端。
它更像是给 Agent 增加一组“网盘工具能力”。也就是说,它的重点不是 UI,而是让 Agent 在需要的时候可以调用这些能力,完成搜索、浏览、离线下载、任务查询等操作。
本质上,这是一次把“网盘操作”接入 Agent 工作流的尝试。
夜雨聆风