115Master：提升115网盘体验的用户脚本安装指南

核心价值：重新定义网盘使用体验

115Master作为一款基于Tampermonkey[用户脚本管理器]的增强工具，通过组件化开发架构和静态类型检查，为115网盘用户提供三大核心价值：文件预览无需等待、视频内容智能缩略、播放器一键唤起。从开发者视角看，项目采用TypeScript强类型系统确保代码质量，通过Vue组件化设计实现功能模块化；对普通用户而言，这些技术最终转化为"无需下载即可预览"、"视频进度可视化"等直观体验提升。

环境搭建：从开发准备到脚本部署

准备开发环境

在开始前，请确保系统已安装：

• Node.js（v20.x.x或更高版本）：JavaScript运行时环境，用于执行构建脚本
• pnpm（v9.x.x或更高版本）：高效的包依赖管理工具

⚠️ 注意事项：使用nvm或官方安装包管理Node.js版本，避免系统自带旧版本造成兼容性问题

预期结果：在终端输入node -v和pnpm -v能显示符合要求的版本号

获取项目代码

通过终端执行以下命令克隆项目源码：

git clone https://gitcode.com/gh_mirrors/11/115master

进入项目目录：

cd 115master

安装项目依赖

执行依赖安装命令：

pnpm install

⚠️ 注意事项：如遇网络问题，可配置pnpm镜像源：pnpm config set registry https://registry.npmmirror.com

预期结果：终端显示依赖安装完成，项目根目录生成node_modules文件夹

验证开发环境

运行环境检查命令：

pnpm run check

预期结果：终端输出"Environment check passed"，无错误提示

构建用户脚本

执行构建命令生成可安装的用户脚本：

pnpm build

预期结果：项目根目录生成dist文件夹，其中包含115master.user.js文件

功能启用：从浏览器配置到脚本激活

安装Tampermonkey扩展

在115浏览器中安装Tampermonkey扩展，这是运行用户脚本的必要工具。

导入用户脚本

1. 打开Tampermonkey管理面板
2. 点击"实用工具"选项卡
3. 选择"从文件安装"，浏览并选择项目中的dist/115master.user.js文件
4. 在弹出的安装确认页面点击"安装"按钮

⚠️ 注意事项：安装时若浏览器提示"不安全的脚本"，需在扩展设置中允许"来自未知来源的扩展"

预期结果：Tampermonkey面板显示115Master脚本已安装并启用

验证功能激活

1. 打开115网盘网页版
2. 导航至包含视频文件的目录
3. 观察文件列表是否显示预览缩略图
4. 点击视频文件查看是否自动唤起增强播放器

预期结果：视频文件显示缩略图，点击后打开带控制栏的增强播放器

功能自定义：个性化配置指南

基础配置入口

在115网盘页面点击右上角的115Master图标，打开设置面板。常用配置项包括：

• 默认播放设置：可调整默认音量、播放速度和画质偏好
• 缩略图设置：控制缩略图生成质量和显示尺寸
• 快捷键配置：自定义播放控制的键盘快捷键

高级功能启用

在设置面板的"高级功能"选项卡中，可以启用：

• 视频增强模式：提升低清晰度视频的观看体验
• 字幕自动匹配：根据文件名自动搜索并加载字幕文件
• 播放历史同步：在不同设备间同步播放进度

常见问题：诊断与解决方案

脚本安装后不生效

可能原因：

1. Tampermonkey未正确启用脚本
2. 浏览器缓存未刷新
3. 脚本版本与115网盘不兼容

解决步骤：

1. 确认Tampermonkey中115Master已启用
2. 按Ctrl+Shift+R强制刷新页面
3. 执行pnpm build重新构建脚本

视频缩略图不显示

可能原因：

1. 网络连接问题
2. 视频文件格式不受支持
3. 缩略图生成服务未加载

解决步骤：

1. 检查网络连接状态
2. 确认文件为常见视频格式（MP4、MKV等）
3. 打开浏览器控制台（F12）查看是否有错误信息

播放器控制功能异常

可能原因：

1. 浏览器权限设置限制
2. 其他扩展与脚本冲突
3. 本地存储数据损坏

解决步骤：

1. 确保浏览器允许自动播放
2. 临时禁用其他扩展测试
3. 在Tampermonkey中重置脚本数据

环境维护：版本更新与问题反馈

手动更新脚本

定期执行以下命令获取最新代码并更新：

git pull
pnpm install
pnpm build

然后在Tampermonkey中重新导入生成的脚本文件

问题反馈渠道

如遇到无法解决的问题，可以：

1. 查看项目根目录的CONTRIBUTING.md文件了解贡献指南
2. 检查AGENTS.md获取技术支持联系方式
3. 参考CLAUDE.md中的常见问题解答