# @atomic-chat/core 中文文档

规范地址：https://npmcn.com/package/%40atomic-chat/core/

版本：0\.22\.0
npm 元数据更新时间：2026-11-07T00:01:33.193Z
中文译文更新时间：2026-11-07T03:21:26.831Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：12.6 MB，2161 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：6 个
- 首次发布：2026-09-24T13:37:31.465Z
- 最新版本发布：2026-11-07T00:01:32.586Z
- 近 30 天下载量：3931（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

Atomic Chat的推论核心: local lama.cpp/MLX/Foundation Models 运行时间,云提供商,模型路由器和OpenAI兼容服务器在:1337.

## 安装

```sh
npm install @atomic-chat/core
```

也可以使用：`pnpm add @atomic-chat/core`、`yarn add @atomic-chat/core`、`bun add @atomic-chat/core`

## README

# 原子聊天核心

脚本推论核心 [原子聊天](https://github.com/AtomicBot-ai/Atomic-Chat): 当地lama.cpp / MLX / 苹果基金会模型运行时间,后端和模型管理,云提供商,模型路由器和 OpenAI 兼容服务器 `http://localhost:1337/v1`。 。 。 .

-   工作在这个repo: [`AGENTS.md`](https://npmcn.com/package/%40atomic-chat/core/AGENTS.md)
-   计划、建筑和外观: [`PLAN.md`](https://npmcn.com/package/%40atomic-chat/core/PLAN.md)
-   决定: [`docs/decisions/INDEX.md`](https://npmcn.com/package/%40atomic-chat/core/docs/decisions/INDEX.md)

```bash
bun install
npm run verify
```

阶段1CLI实例:

```bash
atomic-chat-core serve owner/repository   # a model already on disk; the core does not download models
atomic-chat-core serve --model-path ./model.gguf --bin ./llama-server --port 6767
atomic-chat-core models list --json
atomic-chat-core shutdown
```

`serve` 附加到选定数据文件夹的持久所有者。 命令可以退出 - 不卸下模型; `shutdown` 明确停止该所有人及其会议.

## 管理运行时间(Linux + NVIDIA)

在有NVIDIA GPU的Linux上,核心还可以在它自己管理的容器内运行一个模型- {\\fn华文楷体\\fs16\\1che0e0e0}今天 `tensorrt-llm`NVIDIA的推论引擎 而不是像它那样产生一个局部过程 lama.cpp和MLX都这样 它需要多克和NVIDIA集装箱工具包,核心从未安装过 单打独斗:设定一个计算一个计划,请求同意,然后进行一个特权步骤 (包装安装, `docker` group members),通过帮助者应用或CLI作为根运行——核心 它从未获得过更高的权利。 让你加入 `docker` 组等待您的下一个 在它能继续之前签入。 见 [`docs/contracts.md`](https://npmcn.com/package/%40atomic-chat/core/docs/contracts.md) 控制路线, 主机步骤文件协议和退出代码、磁盘版式以及 `model.yml` 形状管理 模型的目录需要.

手工安装运行与设置相同的步骤:多克引擎和NVIDIA集装箱工具包 从自己的供应商那里 `apt` 或者说 `dnf` 寄存器,用于分发 合格(见 `atomic-chat-conf/runtimes/`),然后NVIDIA运行时间注册到多克和 引用用户添加到 `docker` 组合。 在主机上没有任何东西被删除或升级.

实际安装在真实的 Linux VM 上的活性测试是选入并更改机器——见 [`docs/live-tests.md`](https://npmcn.com/package/%40atomic-chat/core/docs/live-tests.md) 他们的行为。 他们只在 `ATOMIC_LIVE=1` 财务报告和审定财务报表 `ATOMIC_LIVE_MANAGED=1` 二者均被设定; `ATOMIC_RUNTIME_DESCRIPTOR_URL` 可以选择将其指向一个 本地描述符.

## 释放

桌面app 标出一个核心版本(`atomicCore.version` 联合国 `package.json`和下载该 释放的二进制,检查它们与 `SHA256SUMS`。 。 。 .

```bash
make release                 # patch; or VERSION=minor, major, or an explicit X.Y.Z
```

它会撞倒 `package.json` 财务报告和审定财务报表 `src/version.ts` 一起,承诺 `release: vX.Y.Z`,标记并推 分支和标签(当前版本,明确给出,只有标签) `HEAD`) (中文(简体) ). 未制作: `npm run release -- patch --push`,或删除 `--push` 在推进前看看 标记运行 `release` 工作流程:与macOS、Linux和Windows(x64和arm64上的Linux和Windows)上的CI相同,两者均 二进制为每个目标(macOS arm64和x64,Windows x64和arm64,Linux x64和arm64),然后 `vX.Y.Z` 以二进制和 `SHA256SUMS` 作为最新发布.

工作流程也可以由手动启动,用于已经输入的版本 `package.json` 在树枝上 运行工作流程,或 `gh workflow run release.yml --ref <branch>`)它创造了 标记自己。 公布的版本从未被替换:第二次运行失败,所以先被撞倒.

## 常见问题

### @atomic-chat/core 是什么？

Atomic Chat的推论核心: local lama\.cpp/MLX/Foundation Models 运行时间,云提供商,模型路由器和OpenAI兼容服务器在:1337\.

### 如何安装 @atomic-chat/core？

在项目目录运行 npm install @atomic-chat/core，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 atomic-chat-core，可以用 npx atomic-chat-core 直接运行。

### @atomic-chat/core 支持 TypeScript 吗？

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

### @atomic-chat/core 支持 ESM 还是 CommonJS？

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

### @atomic-chat/core 需要什么版本的 Node\.js？

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

### @atomic-chat/core 可以商用吗？

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

### @atomic-chat/core 的下载量有多少？

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

### @atomic-chat/core 还在维护吗？

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