@aalis/core

Aalis 的插件运行底座：显式服务声明、按激活绑定、资源清理与依赖编排。Core 环境无关，不包含业务服务或文件系统实现。

角色

插件通过 definePlugin({ uses, apply }) 声明使用的服务。六项内置服务（事件、生命周期、日志、插件自己的配置、发布、查询）和第三方服务共用容器与描述符协议；没有默认注入。钩子与贡献点由 @aalis/api-hooks / @aalis/api-contributions 及其默认提供者插件提供；插件发现与配置文档由宿主（Node 下为 @aalis/runtime）负责，core 只接收插件定义与注册时的配置。

提供者登记进容器的是实现对象本身。消费者每次激活拿到两层：选择层（list / use / of / present / follow，各服务相同）与业务层 use（转发给本插件选中的提供者；描述符给了 bind 时为它的返回值）。资源随消费者清理，提供者换人时有状态资源经 follow 交接；关闭根据资源归属与服务依赖分阶段执行。

安装

pnpm add @aalis/core

使用

import { definePlugin, events, logger } from '@aalis/core';

export default definePlugin({
  name: '@scope/plugin-example',
  uses: { events, logger },
  apply({ events, logger }) {
    events.use.on('app:started', () => logger.use.info('ready'));
  },
});

监听登记属于这次激活，卸载时自动撤回。参见 插件定义与生命周期、服务 和 第三方插件指南。

许可

见仓库根目录 LICENSE。