插件就是一段 JavaScript
每个插件是一个单文件 bundle,跑在客户端内置的 QuickJS-NG 引擎里。它负责去某个漫画站取搜索结果、详情、章节和图片——客户端自己不碰这些接口。
客户端本体是个空壳,不带任何漫画源。装完还要装至少一个插件,发现页的搜索和排行榜才会有内容。 下面是照着做就行的最短路径,全程在客户端里点,大约五分钟。
搞清楚这三件事,后面照做就不会迷路。
每个插件是一个单文件 bundle,跑在客户端内置的 QuickJS-NG 引擎里。它负责去某个漫画站取搜索结果、详情、章节和图片——客户端自己不碰这些接口。
客户端自动搜索 GitHub 上所有以 Breeze-plugin- 开头的仓库,并且要求仓库里带 manifest.json。入库有延迟,通常 2~4 小时;名字前缀不对就永远进不了列表。
插件装好后会把自己的搜索、排行入口挂到发现页。一个插件没装时,发现页就是空的——不是坏了,是还没有源。
每一步都有先后,跳步会卡住。第 2 步最容易找错位置。
按你的系统从下载页拿对应的包,装好、打开。这时候先别急着搜,搜索一定是空结果——因为还没有源。
安卓侧载放行、macOS 首次打开要解除隔离、iOS 要签名工具,都在下载页对应平台那一段里写好了,卡住就回去看。
路径固定三步,不是底部导航上的图标,别在主界面上找:
进去之后看到的那一串插件,就是客户端自动扫 GitHub 扫出来的结果。
先装 1~2 个,把整条链路验证通,再决定要不要加更多。长期维护、更新勤的那几个排在前面更靠谱。
在列表里点安装,客户端会下载这个插件的 bundle。下完会执行一次身份校验:uuid 和当前条目对不上就拒绝安装,所以不会出现「装了 A 结果变成 B」的情况。
装完之后进入这个插件的设置页,能看到版本号,就说明装上了。
插件会把自己的入口挂到发现页。回到发现页,随便搜一部你知道名字的漫画:
插件设置页右上角有个「同步」,会按插件声明的 npmName / updateUrl 去查有没有新版,有新版本才装。
页面底部的「更新」是另一件事:手动重装入口,不判断版本,可以走网络 URL 或本地文件。作者没配更新通道时,只能等他发新版再手动装。
init / getInfo 这类拿不到热更新的部分——重启客户端,或者卸载重装一次就好。
插件本质上就是一个 bundle 文件,客户端只要能拿到它就能用,所以装法不止一种。
| 方式 | 怎么操作 | 什么时候用 | 注意 |
|---|---|---|---|
| 从列表安装 | 发现页 → 右上角设置 → 插件商店 → 浏览安装 | 绝大多数情况,点一下就好 | 前提是仓库名以 Breeze-plugin- 开头且已入库 |
| 网络安装 | 插件商店 → 浏览安装 → 网络安装,粘贴 bundle 地址 | 列表里还没收录、或作者让你直接用地址装 | 地址失效就装不上;开发调试时也是填这个地址 |
| 本地安装 | 插件设置页底部「更新」→ 本地文件,选 .js / .cjs / .br |
别人直接把 bundle 文件发给你了 | 同样校验 uuid,装错包会被拒绝 |
插件相关的问题八成是这七种,按症状对号入座。
| 症状 | 大概率原因 | 怎么办 |
|---|---|---|
| 商店里搜不到某个插件 | 仓库名不是 Breeze-plugin- 开头,或刚发布还没入库(2~4 小时) |
等几小时;急着用就让作者给 bundle 地址,走网络安装 |
| 点安装没反应,或转圈后失败 | bundle 下载被网络拦住了(多半是 GitHub 直连问题) | 换个网络或开代理再试;列表里的插件通常会自动套 GitHub 加速 |
| 提示插件身份不一致 / 装完不是它 | 拿到的 bundle 属于另一个插件,uuid 对不上 | 确认下载的是这个插件的产物,重新获取地址 |
| 装完了,发现页没有新入口 | 插件未启用,或插件更新了 init / getInfo 而热更新不生效 |
回发现页刷新;仍不行就重启客户端,或卸载重装 |
| 搜索一直转圈,或结果为空 | 源站需要登录,或请求被拦截 | 进插件设置页登录该源站账号;打开 DoH / ECH 后重试 |
| 能搜到,但详情和图片全白 | 图片域名被单独拦截,或源站换了 CDN | 开 DoH 后重试;还不行就换一个源,等作者适配 |
| 点「同步」没有新版本 | 插件没配 npmName 也没配 updateUrl |
只能等作者发新版,用底部「更新」手动重装 |
能搜到只是开始,下面这些决定后面用得顺不顺。
收藏这个动作是插件去调源站自己的接口完成的,不是存在客户端里。所以先在插件设置页登录该站点账号,换设备后登录同一个账号,收藏才跟得走。
内置 DoH 四路并发、ECH 与域名前置。遇到详情页打不开、图片加载慢,先开 DoH 再试;要排查劫持或只走干净出口时,用「内网拦截」开关切换请求策略。
插件设置页底部可以删除。装的源越多,发现页越长,启动时的检查也越多——只留当下真在用的那几个。