@chatluna/patchbay

中文文档
0.1.11发布于 2026/11/09MITTypeScriptES Module近 30 天下载 2029

用于 Koishi 、 Satori 、 Satori 适配器和 Cordis 插件的 Cordis 4 补丁, 线接入纱线、 pnpm 或 npm

中文使用文档
文档目录4 节
  1. 使用
  2. 从代码
  3. 维护
  4. 许可证

补丁

运行 Koishi 、 Satori 、 Satori 适配器和一些 Cordis 插件的补丁 科尔地斯 4,保存在一个地方,并用一个命令将线接入纱线,pnpm或npm.

每个补丁都针对一个准确的上游版本,列于 patchbay.json。没有重新发布:您的软件包管理器安装上游柏油球并应用此软件包的补丁.

使用

npm i -D @chatluna/patchbay      # or yarn add -D / pnpm add -D
npx patchbay sync                # writes .patchbay/ and the package-manager config
npm install                      # or yarn install / pnpm install

提交 .patchbay/ 与配置组合 sync 写作。 运行 patchbay sync 在升级了补丁字后再次出现。 它取代了上一个版本所写的每根针.

软件包管理器什麽 sync 写入当补丁适用时
亚伦 2+resolutions → patch:<pkg>@npm:<version>#~/.patchbay/<pkg>@<version>.patch安装时
页:1pnpm-workspace.yaml数字 : overrides, (中文(简体) ), patchedDependencies, (中文(简体) ), allowUnusedPatches安装时
无overrides直接依附于同一种类, postinstall: patchbay apply安装后, 设置

sync 从 packageManager,然后是锁文件,然后是运行它。 过 --pm yarn|pnpm|npm 自己选择 Yarn 1没有补丁支持,被拒绝.

每个被补丁的包被固定在其被补丁的版本上,连同这些别名:

  • koishi → @koishijs/core
  • minato → @cordisjs/plugin-database

一个后来安装其中之一的插件得到补丁构建.

在npm时, patchbay apply 保存它在每个软件包中应用的补丁的副本(.patchbay.patch) (中文(简体) ). 它跳过已经流过的软件包,并在应用更新的软件包之前取消更旧的补丁 .

从代码

import { apply, sync } from '@chatluna/patchbay'

const pm = sync(projectDir) // 'yarn' | 'pnpm' | 'npm'
// ...run the install...
if (pm === 'npm') apply(projectDir)

维护

yarn refresh edit <name>     # unpack upstream to .work/<pkg>/{a,b}, current patch applied to b
# edit .work/<pkg>/b
yarn refresh commit <name>   # diff a → b into patches/<pkg>@<version>.patch
yarn verify                  # every patch applies to its upstream tarball
yarn test                    # unit tests plus real yarn, pnpm and npm installs

要补齐新软件包或版本,请将其条目添加到 patchbay.json运行 yarn refresh edit <name>做出改变,然后承诺.

许可证

麻省理工学院

版本与发布记录

@chatluna/patchbay 共发布 13 个版本,首次发布于 2026/11/03;过去 12 个月发布了 13 个版本。

版本发布日期距今
0.1.11latest2026/11/09今天
0.1.102026/11/09今天
0.1.92026/11/072 天前
0.1.82026/11/072 天前
0.1.72026/11/063 天前
0.1.62026/11/063 天前

关于 @chatluna/patchbay 的常见问题

@chatluna/patchbay 是什么?

用于 Koishi 、 Satori 、 Satori 适配器和 Cordis 插件的 Cordis 4 补丁, 线接入纱线、 pnpm 或 npm

如何安装 @chatluna/patchbay?

在项目目录运行 npm install @chatluna/patchbay,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 patchbay,可以用 npx patchbay 直接运行。

@chatluna/patchbay 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chatluna/patchbay 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@chatluna/patchbay 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@chatluna/patchbay 可以商用吗?

@chatluna/patchbay 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chatluna/patchbay 的下载量有多少?

根据 npm 官方下载统计,@chatluna/patchbay 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,029 次,日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chatluna/patchbay 还在维护吗?

最新版本 0.1.11 发布于 2026/11/09(今天);至今共发布 13 个版本,其中过去 12 个月发布了 13 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。