# @atlasent/safeguard-manifest 中文文档

规范地址：https://npmcn.com/package/%40atlasent/safeguard-manifest/

版本：1\.0\.1
npm 元数据更新时间：2026-09-25T02:47:21.127Z
中文译文更新时间：2026-11-07T02:27:04.734Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：25.3 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-12T19:56:54.378Z
- 最新版本发布：2026-09-25T02:47:20.968Z
- 近 30 天下载量：16386（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

将权威的AtlaSent保护套件进行版本的、确定性的投影,投射到控制台保护地图的设计/预期事实(所有人、权威、预期证据来源、预期大门)。 没有运行时间观察状态。 零建设,z

## 安装

```sh
npm install @atlasent/safeguard-manifest
```

也可以使用：`pnpm add @atlasent/safeguard-manifest`、`yarn add @atlasent/safeguard-manifest`、`bun add @atlasent/safeguard-manifest`

## README

# @ atlasent/ 守护者- 操纵

现有定型预测 **权威保障软件包** (单位:千美元)`contract/safeguard-pack/`进入 **设计/预期的事实** 消费者需求 使控制台 **保护地图** - 每个受保护的行动:所有人、当局、, 预期的证据来源和预期的大门.

## 这究竟是什么(而不是什么)

-   **统计:** 预期/设计真相。 每一个保障是 _设计为要求_。 。 。 .
-   **没有:** 运行时间观测状态 。 它携带 **没有** 执行模式 影响、核查状况、覆盖范围或观察到的差距。 住在这里 运行时间和消费者加入.

显示器存在,所以控制台从没有手持可以保存的语义副本 漂从 Canon / 包。 这是唯一权威的饲料.

## 三个州,它使

消费者用现场直播的 事实来证明 三个不同状态的和解观点:

| 状态 | 来源 |
| --- | --- |
| **预期** | 此显示( 版本保护套件) |
| **配置** | 运行时间 — 当前配置( 执行模式, 捆绑) |
| **证明** | 运行时间——执行+核查证据(核查 活动,覆盖范围) |

一个保障措施是 **不是"覆盖"** 仅仅因为它在包件中(预计)或 按运行时间(配置)配置——覆盖需要观察运行时间+接受 证据(经证明)。 如果预期和配置/证明有异议,消费者 将差异显示为 a **差额**它不能调和或重新解释它.

## 重生决定主义( D)

JSON 的生成来源于 `scripts/generate-safeguard-manifest.py` (在回购中) root)来自权威的YAML. 没错 **决定性** - 相同的投入产出 字节相同的输出, 因此 CI 在任何出乎意料的再生 diff 上失败 :

```bash
python3 scripts/generate-safeguard-manifest.py           # regenerate
python3 scripts/generate-safeguard-manifest.py --check    # CI: fail if stale
```

**不要手动编辑 `safeguard-manifest.json`。 。 。 .** 更改权威 `contract/safeguard-pack/*` YAML并再生.

## 证明

-   `provenance.source_files[]` 记录每个权威投入中的SHA-256—— 确定确切输入(无挥发性SHA/时间戳) 在文物,所以 `--check` 保持稳定).
-   释放/承诺来源受约束 **发布时间** 通过 npm `--provenance` (Sigstore无密钥,与AtlaSent发布的其他套件相同).

## 分布针( P)

通过现有的软件包释放路径发布( )`v1_1-release.yml` 包装+ 每个非私人签名 `packages/*` 在版本标签上). **消费者 明确 `manifest_version` / 软件包版本** 永远不要沉默地消耗"最" 并证实一切迹象 `safeguard-manifest.schema.json` (单位:千美元)`schema_version` +出处)使用前.

## 使用量

```ts
import {
  safeguardManifest,
  getSafeguardAction,
  SAFEGUARD_MANIFEST_VERSION,
} from "@atlasent/safeguard-manifest";

const deploy = getSafeguardAction("production.deploy");
deploy?.owner_role;                 // expected owner (design)
deploy?.expected_evidence_sources;  // expected evidence sources (design)
```

## 常见问题

### @atlasent/safeguard-manifest 是什么？

将权威的AtlaSent保护套件进行版本的、确定性的投影,投射到控制台保护地图的设计/预期事实\(所有人、权威、预期证据来源、预期大门\)。 没有运行时间观察状态。 零建设,z

### 如何安装 @atlasent/safeguard-manifest？

在项目目录运行 npm install @atlasent/safeguard-manifest，或使用 pnpm add / yarn add / bun add。

### @atlasent/safeguard-manifest 支持 TypeScript 吗？

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

### @atlasent/safeguard-manifest 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @atlasent/safeguard-manifest 可以商用吗？

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

### @atlasent/safeguard-manifest 的下载量有多少？

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

### @atlasent/safeguard-manifest 还在维护吗？

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