# @astram/core 中文文档

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

版本：1\.19\.0
npm 元数据更新时间：2026-11-03T11:22:14.308Z
中文译文更新时间：2026-11-07T00:59:57.002Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.8 MB，434 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-10T14:21:15.959Z
- 最新版本发布：2026-11-03T11:22:14.088Z
- 近 30 天下载量：4277（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

Astram框架——密封安全核心(身份、认证、会话、风险、授权、审计)。 ZERO框架分解——可移植的决定大脑(ADR-0003). 被冻结的公共合同消费者建立起来反对;已经安装,未经编辑(ADR-0023).

## 安装

```sh
npm install @astram/core
```

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

## README

# @ astram/ 核心

这个 **核心** 为阿斯特朗. 核心小组拥有 (STATUS 第3层), `010_Architecture`) (中文(简体) ). 框架 -- -- 可知性 [ADR-0003 (韩语)](https://npmcn.com/package/docs/Shield/ADR/0003-framework-agnostic-core.md) —— 说 **津巴布韦 NestJS / react / Express / Vite 导入** (由根ESLint边界规则所强化).

## 这个包裹是什么

另一层的便携式合同是相对的。 在这个脚手架阶下,它定义 **只有类型/界面** ——发动机接缝和模块-注册-元数据 合同. **没有安全逻辑** 生活在这里; 每一层的执行都是构建的 后来,与这些接合.

### 发动机接合器(每层1个——请求的行程)

| 层 | 模块 | 主要出口 |
| --- | --- | --- |
| 身份 | `src/identity` | `Principal`, (中文(简体) ), `Tenant`, (中文(简体) ), `PrincipalKind`, (中文(简体) ), `ExternalIdentityAssertion`, (中文(简体) ), `IdentityBroker` |
| 认证 | `src/authentication` | `Credential`, (中文(简体) ), `AuthFactor`, (中文(简体) ), `AuthenticationResult`, (中文(简体) ), `Authenticator` |
| 会议 | `src/session` | `Session`, (中文(简体) ), `SessionTokens`, (中文(简体) ), `SessionEstablishment`, (中文(简体) ), `SessionAuthority` |
| 风险 | `src/risk` | `RiskSignal`, (中文(简体) ), `RiskScore`, (中文(简体) ), `RiskLevel`, (中文(简体) ), `RiskEngine` |
| 授权 | `src/authorization` | `Principal`\- 基于 `Action`, (中文(简体) ), `Resource`, (中文(简体) ), `DecisionContext`, (中文(简体) ), `Decision`, (中文(简体) ), `DecisionReasonCode`, (中文(简体) ), `AccessTier`, (中文(简体) ), `ResourceLevel`, (中文(简体) ), **`DecisionAuthority.decide(principal, action, resource, context)`** (第7节) |
| 审计 | `src/audit` | `AuditEvent`, (中文(简体) ), `AuditEventType`, (中文(简体) ), `AuditSink` |

### 模块登记人-元数据合同

`src/metadata` - 如何建立一个商业单元 **声明** 其对象类型、动作、, 访问级,并支持对核心的只读依赖性(它从来没有) 执行访问检查)。 出口 `ObjectTypeDescriptor`, (中文(简体) ), `FieldDescriptor`, (中文(简体) ), `ActionDescriptor`, (中文(简体) ), `SupportingDependency`, (中文(简体) ), `ModuleMetadata`,则 `ModuleRegistry` 界面(静态+动态/运行时间注册,按ADR-0014§5.5).

## 脚本

```bash
pnpm --filter @astram/core build   # tsc → dist/ (declarations + maps)
pnpm --filter @astram/core lint    # eslint — proves no framework import leaked
pnpm --filter @astram/core test    # vitest — trivial import smoke test
```

## 规则

-   **无框架进口** 任何地点(ADR-0003). 横跨注入平台 相反,综合边界.
-   **只在此一步键入** 没有决定/决定/会期逻辑机构。 真实 随着层层的形成,每个层都有不完全的证据.

## 常见问题

### @astram/core 是什么？

Astram框架——密封安全核心\(身份、认证、会话、风险、授权、审计\)。 ZERO框架分解——可移植的决定大脑\(ADR-0003\)\. 被冻结的公共合同消费者建立起来反对;已经安装,未经编辑\(ADR-0023\)\.

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

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

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

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

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

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

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

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

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

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