@digital-alchemy/core

中文文档
26.10.22发布于 2026/10/22TypeScriptES Module构建来源已验证近 30 天下载 5335

应用接线、配置和锅炉等公用事业

中文使用文档
文档目录5 节
  1. 安装
  2. 导言
  3. 看着
  4. 它会做什么
  5. 问题/问题?

codecov version stars


Digital Alchemy

安装

yarn add @digital-alchemy/core

导言

@digital-alchemy/core 是TypeScript——没有装饰、没有反射、没有等级结构——的依赖性注入框架。 服务是普通的功能,通过一个单一的被键入的参数接收其依赖性. 框架在启动时将所有东西都接通 整个服务图上都有完全的安全性.

瞄准最新的ESMEodule语法,并运行于Bun,Deno,和现代节点.

看着

import { CreateApplication, TServiceParams } from "@digital-alchemy/core";

function HelloService({ logger, lifecycle }: TServiceParams) {
  lifecycle.onReady(() => logger.info("hello world"));
}

const app = CreateApplication({
  name: "hello",
  services: { hello: HelloService },
});

await app.bootstrap();

它会做什么

  • 服务线 - 具有完全类型安全的自动依赖性注射
  • 配置 - 从文件、环境变量、 CLI 参数装入配置
  • 日志 - 结构化记录和定制产出
  • 生命周期钩 - 在应用程序启动/关闭时运行代码
  • 任务时间安排 - 长期工作和计时器
  • 测试公用事业 - 嘲笑并测试你的服务

问题/问题?

discord

版本与发布记录

@digital-alchemy/core 共发布 106 个版本,首次发布于 2024/02/19;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
26.10.22latest2026/10/2221 天前
26.10.212026/10/2122 天前
26.6.212026/06/214 个月前
26.6.142026/06/154 个月前
26.5.302026/05/315 个月前
26.5.282026/05/295 个月前

其他发布通道:beta → 25.8.22-beta.9。

关于 @digital-alchemy/core 的常见问题

@digital-alchemy/core 是什么?

应用接线、配置和锅炉等公用事业

如何安装 @digital-alchemy/core?

在项目目录运行 npm install @digital-alchemy/core,或使用 pnpm add / yarn add / bun add。

@digital-alchemy/core 支持 TypeScript 吗?

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

@digital-alchemy/core 支持 ESM 还是 CommonJS?

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

@digital-alchemy/core 需要什么版本的 Node.js?

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

@digital-alchemy/core 可以商用吗?

@digital-alchemy/core 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@digital-alchemy/core 的下载量有多少?

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

@digital-alchemy/core 还在维护吗?

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