# @git-stunts/vault 中文文档

规范地址：https://npmcn.com/package/%40git-stunts/vault/

版本：1\.0\.1
npm 元数据更新时间：2026-03-03T20:15:37.048Z
中文译文更新时间：2026-11-16T10:41:25.590Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：39.5 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- 首次发布：2026-01-12T16:04:29.075Z
- 最新版本发布：2026-03-03T20:15:36.913Z
- 近 30 天下载量：6928（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

OS-native密钥链的安全接口(macOS,Linux,Windows)用于"零秘密架构"

## 安装

```sh
npm install @git-stunts/vault
```

也可以使用：`pnpm add @git-stunts/vault`、`yarn add @git-stunts/vault`、`bun add @git-stunts/vault`

## README

# @ git- stunts/ 跳跃

![](https://github.com/user-attachments/assets/aa623669-6269-48e8-83ef-66ffe9a46793)

OS-native密钥链的安全接口(macOS,Linux,Windows)用于"零秘密架构"

### 为什么是沃特?

存储 API 密钥或加密密钥 `.env` 文件是一种安全风险. `vault` 卸下这个责任 给操作系统的本地安全存储。 你的申请从来不是"拥有"这个秘密——它只是在需要时要求它.

### 特征

-   **横线**:支持macOS keychain,Linux特勤公司,和Windows证书管理器.
-   **零密会**: 磁盘中没有纯文本密钥.
-   **交互式**: 可以提示用户丢失机密并自动存储.

## 所需资源

-   **马科斯**: 箱外工作(用途) `security`) (中文(简体) ).
-   **链接**: 要求 `libsecret` (例如, `sudo apt install libsecret-tools`) (中文(简体) ).
-   **窗口**: 要求 `CredentialManager` 动力壳模块.

## 运行时特定适配器

-   **节点( 默认)**数字 : `Vault` 自动检测 Bun 和 Deno Globals 并在两者都不在时返回到节点适配器.
-   **阿宝**: 导入 `createBunKeychainAdapter` (或依赖自动检测)执行命令 `Bun.spawnSync` 当运行在邦下.
-   **德诺**: 导入 `createDenoKeychainAdapter` 运行通过 `Deno.Command`。见 `deno.json` 财务报告和审定财务报表 `Dockerfile.deno` 一个工作机构.

这个 `plumbing/` 文件夹中包含每次运行时的引用 Docker 文件(`Dockerfile.bun`, (中文(简体) ), `Dockerfile.deno`等),这样就可以看到端到端的图像如何将端口连接在一起.

## 基于嵌入器的测试

-   `npm test` 运行 `scripts/run-multi-runtime-tests.sh`,这反过来又提出了 `node-test`, (中文(简体) ), `bun-test`,以及 `deno-test` 定义的容器 `docker-compose.yml`。 。 。 .
-   每个容器都使用相应的多克文件(`Dockerfile`, (中文(简体) ), `Dockerfile.bun`, (中文(简体) ), `Dockerfile.deno`),可以在当地或CI中复制同样的设置.

## 使用量

```javascript
import Vault from '@git-stunts/vault';

const vault = new Vault({ account: 'my-app' });

// Get a secret (returns undefined if missing)
const key = vault.getSecret({ target: 'CHUNK_ENC_KEY' });

// Ensure a secret exists (prompts user if missing)
const secret = await vault.ensureSecret({ 
  target: 'API_TOKEN', 
  promptMessage: 'Enter your API Token' 
});

// Resolve with Env Var priority
const apiKey = vault.resolveSecret({ 
  envKey: 'MY_API_KEY', 
  vaultTarget: 'api-key' 
});
```

## 嵌入图像

-   `Dockerfile` (节点)映射寄存器根工作流程并运行 `npm test`。 。 。 .
-   `Dockerfile.bun` 复制两个工程,安装Bun,并运行 `bun run vitest test/unit`。 。 。 .
-   `Dockerfile.deno` 依赖 `deno task test` 定义 `deno.json`,它通过共享脚本返回 npm 测试堆栈.

## 许可证

阿帕奇 - 2.0 版权 2026 [詹姆斯·罗斯](https://github.com/flyingrobots)

## 常见问题

### @git-stunts/vault 是什么？

OS-native密钥链的安全接口\(macOS,Linux,Windows\)用于"零秘密架构"

### 如何安装 @git-stunts/vault？

在项目目录运行 npm install @git-stunts/vault，或使用 pnpm add / yarn add / bun add。

### @git-stunts/vault 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/git-stunts\_\_vault 是否存在。

### @git-stunts/vault 支持 ESM 还是 CommonJS？

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

### @git-stunts/vault 需要什么版本的 Node\.js？

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

### @git-stunts/vault 可以商用吗？

@git-stunts/vault 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @git-stunts/vault 的下载量有多少？

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

### @git-stunts/vault 还在维护吗？

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

