@chriscode/hush

中文文档
7.5.0发布于 2026/06/16MITTypeScriptES Module构建来源已验证近 30 天下载 1831

AI-本土机密经理. 保密在休息时保持加密;AI代理帮助而不看到值.

中文使用文档
文档目录18 节
  1. 安装
  2. 先决条件
  3. 快开始
  4. 1. 启动 v3 存储器
  5. 2. 检查目前的配置
  6. 3. 安全添加秘密
  7. 4. 运行您的应用程序
  8. 当前 v3 寄存器模式
  9. 核心命令
  10. 遗产 v2 迁移
  11. AI-安全工作流程
  12. 工作流程示例
  13. 团队设置
  14. 解决问题
  15. 缺少 OPS 或年龄
  16. 密钥不匹配此寄存器
  17. 你需要转换遗产的回购
  18. 许可证

@chriscode/ 嘘声

AI本地机密经理. 秘密会保密的 AI可以帮助而不看到价值.

npm Documentation

Hush - AI-native secrets manager

Hush将项目权限存储在加密的v3仓库文件中. 目前的模式很简单:

  • .hush/manifest.encrypted 定义身份、捆绑、目标和进口
  • .hush/files/**.encrypted 存储实际的秘密条目和文件级阅读器
  • hush run -- <command> 是正常运行时路径

没有纯文本的秘密文件可以教一个AI助手避免. Hush 解密只针对活性过程或已实现的目标,然后清理.

读取全部文件

安装

pnpm add -D @chriscode/hush
# or
npm install -D @chriscode/hush

先决条件

brew install sops age

快开始

1. 启动 v3 存储器

npx hush bootstrap

创建加密寄存器 shell, 设置密钥, 并写入第一个 v3 文件 :

.hush/manifest.encrypted
.hush/files/env/project/shared.encrypted

2. 检查目前的配置

npx hush config show
npx hush config active-identity

使用 hush config 检查仓库状态并更新文件阅读器.

3. 安全添加秘密

npx hush set DATABASE_URL
npx hush set API_KEY --gui

hush set 需要时提示值,所以助手永远看不到.

4. 运行您的应用程序

npx hush run -- npm start
npx hush run -e prod -- npm build

这是正常的运行时间路径 。 安静地解密内存,并将值传递给命令.

当前 v3 寄存器模式

Hush v3 保留加密 YAML 文档中的存储权限 .hush/。 。 。 .

文件目的
.hush/manifest.encrypted仓库元数据、身份、捆绑、目标和进口
.hush/files/**.encrypted每个加密文件的秘密条目加阅读器
.sops.yaml带有项目公钥的 SOPS 创建规则

hush bootstrap 创建外壳. hush config 检查或更新. hush run 这是你如何每天使用它.

核心命令

命令它会做什么
hush bootstrap创建 v3 寄存器 shell 和初始活动身份
hush config show [section]显示清单、文件、身份、目标、导入或状态
hush config active-identity [name]显示或更改活动身份
hush config readers <file-path> --roles <csv>更新文件阅读器
hush set <KEY>安全添加或更新一个秘密
hush inspect列出带有遮盖值的秘密名称
hush has <KEY>检查是否有秘密
hush run -- <command>在记忆中带着秘密运行
hush push向Cloudflare推进目标
hush keys setup校验本地工程密钥
hush skill安装 AI 技能

遗产 v2 迁移

如果一个寄存器仍然使用旧的 v2 版式, 请使用迁移桥 :

npx hush migrate --from v2
npx hush migrate --from v2 --cleanup

这是从遗留的寄存器到当前v3模型的支持桥.

AI-安全工作流程

对于AI助手来说,安全回路是:

npx hush inspect
npx hush has DATABASE_URL
npx hush set DATABASE_URL
npx hush run -- npm start

您也可以安装运出的技能 :

npx hush skill
npx hush skill --global
npx hush skill --local

工作流程示例

# bootstrap the repo once
hush bootstrap

# inspect config and identities
hush config show
hush config active-identity owner-local

# add secrets
hush set DATABASE_URL
hush set STRIPE_SECRET_KEY

# run the app
hush run -- npm start

团队设置

将工程年龄键复制到 ~/.config/sops/age/keys/{project}.txt,然后用:

hush config show state

解决问题

缺少 OPS 或年龄

brew install sops age

密钥不匹配此寄存器

运行 :

hush keys setup

你需要转换遗产的回购

运行 :

hush migrate --from v2

添加 --cleanup 在验证迁移状态后.

许可证

麻省理工学院

版本与发布记录

@chriscode/hush 共发布 57 个版本,首次发布于 2026/01/15;过去 12 个月发布了 57 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
7.5.0latest2026/06/164 个月前
7.4.02026/06/134 个月前
7.3.12026/06/134 个月前
7.3.02026/06/025 个月前
7.2.52026/05/305 个月前
7.2.42026/05/235 个月前

其他发布通道:next → 6.0.0-next.0。

关于 @chriscode/hush 的常见问题

@chriscode/hush 是什么?

AI-本土机密经理. 保密在休息时保持加密;AI代理帮助而不看到值.

如何安装 @chriscode/hush?

在项目目录运行 npm install @chriscode/hush,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 hush,可以用 npx hush 直接运行。

@chriscode/hush 支持 TypeScript 吗?

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

@chriscode/hush 支持 ESM 还是 CommonJS?

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

@chriscode/hush 需要什么版本的 Node.js?

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

@chriscode/hush 可以商用吗?

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

@chriscode/hush 的下载量有多少?

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

@chriscode/hush 还在维护吗?

最新版本 7.5.0 发布于 2026/06/16(4 个月前);至今共发布 57 个版本,其中过去 12 个月发布了 57 个;首次发布于 2026/01/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。