直接导入单个 Miru 扩展 JS 文件

什么时候用这个方式

不是所有扩展都在仓库里。你可能从下面这些场景拿到单个 JS 文件：

• 扩展开发者在论坛或 Telegram 群里直接贴出的文件；
• GitHub Gist / 个人仓库的单个扩展；
• 朋友直接发给你的扩展文件；
• 你自己写的正在调试中的扩展。

快速导入：扩展页面右上角按钮

Miru 提供了一个快速定位扩展加载目录的入口：

1. 切换到扩展管理页面；
2. 点击页面右上角的导入按钮（不同版本图标略有差异，通常是一个加号或下载箭头）；
3. 这会直接打开本地文件系统的扩展加载目录；
4. 把你的 .js 文件拖进这个目录；
5. 回到 Miru，刷新一下扩展列表——新扩展就出现了。

Windows 扩展目录在哪

如果右上角按钮不好用，你也可以手动找到目录：

• Windows：%LOCALAPPDATA%\miru\extensions\
• Android：不同版本路径可能不同，常见路径包括内部存储的 Miru 子目录或应用私有目录内

扩展名（即 @package 字段）必须和文件名一致。比如 @package com.example.mysource 的扩展，文件名必须是 com.example.mysource.js——Miru 会在加载时校验这一点，不一致会报错。

导入后检查

导入完扩展后，在扩展管理区确认：

1. 扩展出现在列表里，类型标签正确（bangumi / manga / fikushon）；
2. 版本号和作者信息正常显示；
3. 状态是绿色"已启用"；
4. 如果显示红色错误，点开看一下错误信息——最常见的是元数据缺失、JS 语法错误或 @package 和文件名不匹配。

单个扩展 vs 仓库

两种方式可以混用。如果你只想要某个仓库里的一个扩展，没必要整个添加仓库——直接把那个 JS 文件复制到扩展目录即可。反之，如果你想定期更新或方便管理，添加仓库更合适。