# @bitakit/core 中文文档

规范地址：https://npmcn.com/package/%40bitakit/core/

版本：0\.2\.9
npm 元数据更新时间：2026-11-01T11:20:22.981Z
中文译文更新时间：2026-11-08T03:58:59.125Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bitakit/core
原文对照：https://npmcn.com/package/%40bitakit/core/?lang=original
项目主页：https://github.com/mvavesal/bitakit#readme
源码仓库：https://github.com/mvavesal/bitakit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：493 kB，156 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：jiti ^2\.7\.0，@bitakit/discovery ^0\.2\.5
- 首次发布：2026-09-30T15:28:34.127Z
- 最新版本发布：2026-11-01T11:20:22.646Z
- 近 30 天下载量：3093（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

BitaKit Core:用于插件,服务,动作,事件,槽和设置的一种框架独立的运行时间.

## 安装

```sh
npm install @bitakit/core
```

也可以使用：`pnpm add @bitakit/core`、`yarn add @bitakit/core`、`bun add @bitakit/core`

## README

![BitaKit — Your app. Your building blocks. An AI-friendly composition layer for modern applications.](https://raw.githubusercontent.com/mvavesal/bitakit/main/docs/assets/readme/bitakit-banner.png)

# 比塔基特核心

框架独立的插件,服务,动作,事件,设置和生命周期管理. 核心在Node.js和浏览器中工作,没有React或路由器. 反应束缚,发现, 视觉插件和提供者集成是独立的包.

## 安装

```sh
npm install @bitakit/core
```

对于新的申请, `npx @bitakit/create-app my-app` 为您连接软件包 (节点.js 24或更新. 手册描述此取出中的 0.2 API; 使用匹配 软件包版本或 [本地软件包工作流程](https://npmcn.com/package/apps/docs/content/docs/local-development.mdx) 当尝试未发布的更改时.

## 从一个服务开始

在发现的应用中,创建 `src/plugins/counter/services/value.ts`数字 :

```ts
import { defineService } from '@bitakit/core';

export default defineService(({ store }) => {
  const state = store({ count: 0 });
  return { state, increment: () => state.set((s) => ({ count: s.count + 1 })) };
});
```

发现它的名字 `counter.value`继续 [反学习路径](https://npmcn.com/package/apps/docs/content/docs/concepts/index.mdx) 要添加一个动作和一个页面。 仅安装 Core 不扫描文件夹或渲染UI . 对于无头程序,跟随 [手动构成](https://npmcn.com/package/apps/docs/content/docs/concepts/manual-composition.mdx)。 。 。 .

## 开发者手册

该手册在文件网站的资料来源中保存过一次。 链接如下: 在仓库检查中解决,并跟踪在 GitHub 上查看的分支。 运行 `npm run dev:docs` 从寄存器根读取已提供的手册 `http://localhost:3002/docs`。尚未配置公共文件地址.

| 专题 | 指南 |
| --- | --- |
| 服务和清理 | [服务参考](https://npmcn.com/package/apps/docs/content/docs/reference/services.mdx) |
| 动作和反应约束 | [行动参考](https://npmcn.com/package/apps/docs/content/docs/reference/actions.mdx) |
| 事件和拦截 | [活动](https://npmcn.com/package/apps/docs/content/docs/concepts/events.mdx), (中文(简体) ), [截取器](https://npmcn.com/package/apps/docs/content/docs/concepts/interceptors.mdx) |
| 文件与开发者配置 | [发现](https://npmcn.com/package/apps/docs/content/docs/concepts/discovery.mdx), (中文(简体) ), [配置](https://npmcn.com/package/apps/docs/content/docs/concepts/configuration.mdx) |
| 延长点和优惠 | [槽数](https://npmcn.com/package/apps/docs/content/docs/reference/slots.mdx), (中文(简体) ), [设置](https://npmcn.com/package/apps/docs/content/docs/reference/settings.mdx) |
| 运行时间更新和诊断 | [运行时间管理](https://npmcn.com/package/apps/docs/content/docs/concepts/runtime-management.mdx) |
| 启用、禁用、添加和删除插件 | [插件管理器](https://npmcn.com/package/apps/docs/content/docs/plugin-management.mdx) |
| 激活信任的软件包目录 | [软件包管理器](https://npmcn.com/package/apps/docs/content/docs/package-management.mdx) |
| 认证合同 | [客户认证](https://npmcn.com/package/apps/docs/content/docs/reference/authentication.mdx) |
| 测试插件文件夹 | [测试](https://npmcn.com/package/apps/docs/content/docs/reference/testing.mdx) |
| 独立实例 | [待办事务走过](https://npmcn.com/package/apps/docs/content/docs/concepts/tutorial.mdx); 可运行的 JavaScript 文件 `examples/` |

插件是可信任的应用程序代码 。 核心不是沙盒、包安装器或远程 市场。 服务业拥有国家和资源;东道方拥有路线,坚持提供商 和服务器授权.

## 元数据和出处

`src/metadata.ts` 拥有由构建工具和运行时间共享的纯公域投影. `projectPluginMetadataSources` 接受命令 `{ value, location }` 来源, 工具可以命名 实际诊断源而不改变字段验证符。 包含文件夹出处 绑定在软件包倒置前保存已有的插件元数据. `src/inspection/plugin-origin.ts` 将主机证据与定义和项目成员挂钩 和团体; `src/inspection/inventory.ts` 用品序列式静态/活性检查. 见 [身份和元数据参考](https://npmcn.com/package/apps/docs/content/docs/reference/plugin-metadata.mdx)。 。 。 .

## 许可证

[麻省理工学院](https://github.com/mvavesal/bitakit/blob/main/LICENSE)第三方依赖性保留 他们自己的执照.

### 组别全部替换

仅限主机 `runtime.plugins.replace(ids, nextPlugins, { expectedRevision?, preserve? })` 验证 在阻止所有老主人之前 提出完整的组成. `plugins.preview({ operation: 'replace', ids, plugins, ...options })` 使用相同的规划器。 提供所有拥有的后裔; 外部依附者和外部ID相撞被拒绝. 空旧/新套件支持添加 或删除。 供应商、基础服务和其他构成限制仍在恢复 `restart-required`。正在等待清理;清理块再利用失败。 启动失败可以离开 使用失败的生命周期状态安装的候选定义; 此 API 不默默地滚动 回来 可选 `@bitakit/packages` 协调文物回收工作。 核心从不下载或 持续编码,以及 `reconcilePlugins` 保留其现有的较窄的兼容合同.

## 常见问题

### @bitakit/core 是什么？

BitaKit Core:用于插件,服务,动作,事件,槽和设置的一种框架独立的运行时间\.

### 如何安装 @bitakit/core？

在项目目录运行 npm install @bitakit/core，或使用 pnpm add / yarn add / bun add。

### @bitakit/core 支持 TypeScript 吗？

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

### @bitakit/core 支持 ESM 还是 CommonJS？

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

### @bitakit/core 可以商用吗？

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

### @bitakit/core 的下载量有多少？

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

### @bitakit/core 还在维护吗？

最新版本 0\.2\.9 发布于 2026/11/01（7 天前）；至今共发布 13 个版本，其中过去 12 个月发布了 13 个；首次发布于 2026/09/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。