酷模 COOLMODULE

让好模块
能够发光发热

大量国内自制模块只存在于酷安帖子里的网盘链接,几个月后就成死链,主流索引也搜不到。 这里就是给这些模块开的投稿入口:把 zip 传上来、写清出处,服务端把它存成长期可用的下载地址, 审核通过后进入公开索引,所有人就能在管理器里搜到并一键安装。

大小上限 8 MB
zip 形态 根目录含 module.prop
溯源 酷安出处 + 投稿人 UID
提交之后 自动开 GitHub PR 待审
01

目标模块

module.zip

选好 zip 后浏览器会当场解一次包:根据根目录下的 module.prop 自动填充模块信息到下面。

02

模块元数据

手动填写

这些信息应来自 zip 内 module.prop。改了这里不等于改了包里的文件, 请照实填写,服务端与审核都按包内内容为准。

module.prop 里的 id,索引认它,不认名字。填完下面版本号,这里会自动查重。

请填写模块 ID

请填写模块名称

请填写版本字符串

必须是整数

写原作者,不是投稿人。

03

出处与身份

traceability

这两项是硬性要求:出处说明包从哪来,UID 说明是谁带上来的。 溯源是日后追责和审核的唯一抓手,缺一项服务端就会拒收。

只收酷安站内链接:原帖 coolapk.com/feed/… 或原作者主页 coolapk.com/u/… 都行。网盘下载链会失效,别填网盘。

请填写酷安站内链接

酷安 App「我的」→ 点头像进个人主页 → 右上角三点 → 「查看我的资料」里的 用户 UID。

UID 应是 4-12 位纯数字

04

确认与上传

irreversible

上传是公开且长期保留的动作,所以下面三道确认一屏都跳不过去。

    先把上面几项填齐

    已收录模块

    公开索引里的全部内容。投稿前先搜一下,别重复提交已经有人在维护的模块。

    处置公示

    被下架、被拒收的内容全部记在这里,一条一条公开:命中了什么、什么理由、谁做的、什么时候。 索引里没有的模块不等于没被投过 —— 这一页就是那个「为什么」。

    APPEAL不服某条处置,去哪儿说话

    唯一正式渠道是索引仓库的 issue。被下架的:在那条处置「证据」指向的 issue 下面回帖;被审核判红、没进索引的:在自己的投稿 PR 里说明。

    要让一个判红的模块进来,得由两个不同的人各在 PR 里留一条以 #human-approved 开头的评论,再由有权限的人点合并 —— 说服一个人不够,这是刻意的。

    这里没有时限承诺,也没有「一定回复」。能承诺的是:每一次放行或下架都留下可以复验的名字和证据, 所以「谁决定的」这个问题永远有答案。站内聊天可以说话,但结论只认 issue —— 帖子会删、评论会折叠,那些都不构成可复验的记录。

    LEGEND这些字段是什么意思

      为什么要人人共建

      这个索引解决的是一个很具体的问题,不是又一个模块站。

      A装不到的模块,其实满地都是

      Android 的 KernelSU / Magisk 生态里,模块以 zip 分发;模块仓库是一份 JSON 索引, 让大家在管理器 App 里直接浏览、一键安装。但大量优质模块根本不在任何索引里 —— 它们是国内社区的个人开发者自制,作者把 zip 传网盘、在帖子里发个链接,别人下载后手动刷。

      1. 进不了主流索引。主流仓库要求模块 ID 等于仓库名、提交者必须是仓库所有者,个人自制模块不符合。
      2. 网盘链接会死。有效期、要转存、账号封禁,几个月后帖子里就只剩一个打不开的页面。
      3. 搜不到。索引里没有条目,只能靠人传人,装过的永远知道,没装过的永远不知道。

      B投稿之后会发生什么

      任何人手上有一个还没被收录的模块,都可以把它投稿上来。流程是固定的:

      1. 1
        你上传 zip服务端收下这个包。
      2. 2
        存成 GitHub Release asset长期稳定、可下载,替掉会失效的网盘链接。
      3. 3
        自动开一个 PRPR 里只有元数据 JSON,不含 zip 本体。
      4. 4
        自动安全审核静态扫描模块脚本里的危险行为、外联、敏感信息。
      5. 5
        人工审核(版本更新必走)对已收录模块的更新一律人工过一遍。
      6. 6
        合并进公开索引从此所有人能在管理器里搜到它,下载链接长期有效。
      别以为提交完就立刻上线。低风险的新模块可以自动通过;但「对已收录模块的版本更新」 一定要人工审核。这是刻意的安全设计 —— 否则有人 fork 一个热门模块、加几行恶意代码、 伪装成「更新」投稿,所有已安装用户就会收到恶意更新提示。

      C两个投稿入口

      手机上:管理器 App —— 选本地 zip 时会提示投稿,已实现。
      电脑上 / 作者本人:就是这个网页站,同时也作为这个索引的对外门面。

      D为什么投稿人必须给酷安 UID

      索引是公开可编辑的,任何人都能往里塞东西,所以唯一可靠的安全机制是「找得到人」。 自由文本的署名可以被随便冒充,而酷安 UID 是一个唯一、可回访、平台可处置的标识: 出事时点开 coolapk.com/u/<UID> 就知道是谁,社区也能对具体账号做处理。

      出处同理,只收酷安站内链接:模块必须能回溯到某个帖子或某个作者主页, 网盘直链、匿名转存链接一律不算出处。

      署名昵称和 UID 是两个字段。昵称给人看(会公开显示在索引里),UID 给审核和追责用。 填对 UID 后会自动核实这个账号确实存在,核实通过还会把昵称自动填上。

      E怎么加源

      索引地址还没配置,暂时给不出一键加源链接。

      F这个站自己的状态

      纯静态站点,没有任何自己的服务端;所有请求都直连投稿后端。下面是当前接线情况:

        已知待办:投稿端点目前没有鉴权与限流, 后续会接 Cloudflare Turnstile。界面上留了接入位,后端配好 sitekey 填进 config.js 即可,本站不自己伪造任何验证码。

        待填:模块 zip四项必填 + 三道确认