新手教程

漫画源插件怎么装:
从装好客户端到搜出第一本漫画

客户端本体是个空壳,不带任何漫画源。装完还要装至少一个插件,发现页的搜索和排行榜才会有内容。 下面是照着做就行的最短路径,全程在客户端里点,大约五分钟。

六个步骤 约 5 分钟 只需装一个插件
先弄明白

插件是什么,从哪来

搞清楚这三件事,后面照做就不会迷路。

插件就是一段 JavaScript

每个插件是一个单文件 bundle,跑在客户端内置的 QuickJS-NG 引擎里。它负责去某个漫画站取搜索结果、详情、章节和图片——客户端自己不碰这些接口。

列表是自动扫出来的

客户端自动搜索 GitHub 上所有以 Breeze-plugin- 开头的仓库,并且要求仓库里带 manifest.json。入库有延迟,通常 2~4 小时;名字前缀不对就永远进不了列表。

入口长在发现页

插件装好后会把自己的搜索、排行入口挂到发现页。一个插件没装时,发现页就是空的——不是坏了,是还没有源。

六步

照着点就行

每一步都有先后,跳步会卡住。第 2 步最容易找错位置。

01

先装客户端,然后打开它

按你的系统从下载页拿对应的包,装好、打开。这时候先别急着搜,搜索一定是空结果——因为还没有源。

安卓侧载放行、macOS 首次打开要解除隔离、iOS 要签名工具,都在下载页对应平台那一段里写好了,卡住就回去看。

02

找到插件商店

路径固定三步,不是底部导航上的图标,别在主界面上找:

发现页→右上角「设置」→插件商店→浏览安装

进去之后看到的那一串插件,就是客户端自动扫 GitHub 扫出来的结果。

03

挑一到两个源,别一次装一堆

先装 1~2 个,把整条链路验证通,再决定要不要加更多。长期维护、更新勤的那几个排在前面更靠谱。

  • 先看能不能搜到——一个关键词都搜不出来,说明这个源当下就不可用,换下一个。
  • 再看图片能不能加载——能搜到但全白,通常是图片域名被拦了,见下面的排查表。
  • 多个源互为备份——源站挂掉、换域名、加验证都是常事,装两三个不会亏。
  • 看全部 24 个漫画源插件与作者 →

    04

    安装,等它自己校验

    在列表里点安装,客户端会下载这个插件的 bundle。下完会执行一次身份校验:uuid 和当前条目对不上就拒绝安装,所以不会出现「装了 A 结果变成 B」的情况。

    装完之后进入这个插件的设置页,能看到版本号,就说明装上了。

    05

    回发现页,搜一个词

    插件会把自己的入口挂到发现页。回到发现页,随便搜一部你知道名字的漫画:

  • 有结果——通了,点进详情、翻一章确认图片也能出,就可以开始用了。
  • 没结果——先确认插件是启用状态,再按下面的排查表逐条对。
  • 06

    让它以后自己更新

    插件设置页右上角有个「同步」,会按插件声明的 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 只能等作者发新版,用底部「更新」手动重装
    插件是第三方代码。它运行在你的客户端里,能看到你的搜索词,也能接触你在源站的登录态。只装你信任的作者;插件机制仍在 beta,接口可能有较大改动。本站只做索引展示,不托管任何插件代码与漫画内容。
    装完之后

    顺手做完这三件事

    能搜到只是开始,下面这些决定后面用得顺不顺。

    收藏要先登录源站

    收藏这个动作是插件去调源站自己的接口完成的,不是存在客户端里。所以先在插件设置页登录该站点账号,换设备后登录同一个账号,收藏才跟得走。

    源站在墙外就把网络开起来

    内置 DoH 四路并发、ECH 与域名前置。遇到详情页打不开、图片加载慢,先开 DoH 再试;要排查劫持或只走干净出口时,用「内网拦截」开关切换请求策略。

    不用的就删掉

    插件设置页底部可以删除。装的源越多,发现页越长,启动时的检查也越多——只留当下真在用的那几个。

    本页依据。上面的界面路径与操作名称取自项目官方插件文档与 README;客户端仍在迭代,个别按钮文字可能随版本微调,以你机器上的实际界面为准。

    现在去挑一个源

    24 个插件按作者和功能列好了,支持云端收藏的有 13 个。