DotBGE

bge 命令行工具

bge 是 DotBGE 的终端工具。它使用开放的 .bge 格式:RSA-4096-OAEP 用于身份加密,AES-256-GCM 用于文件内容;无需账号或服务器。.bge 文件和 .bgekey 身份卡可与 iPhone、iPad 和 Android 应用交换。

安装

macOS:通过 Homebrew 安装。该通用二进制支持 Apple Silicon 和 Intel,经过开发者签名和公证。也可从发行页面下载 .pkg 或独立 .zip。

brew install --cask dotbge/tap/bge

Linux:从发行页面下载对应架构(x86_64 或 aarch64)的压缩包。二进制静态链接 Swift 运行时,可在较新的 glibc 发行版上运行,无需安装 Swift。

tar xzf bge-<version>-linux-x86_64.tar.gz
sudo install bge-<version>-linux-x86_64/bge /usr/local/bin/bge
bge --version

使用 shasum -a 256 -c SHA256SUMS(macOS)或 sha256sum -c SHA256SUMS-linux(Linux)校验下载。

查看 GitHub 及发行版本 ↗

快速开始

生成身份密钥对、为接收人加密,再用对应私钥解密。alice.pem 是私钥,请安全保存。运行 bge -h 或 bge <command> -h 查看选项;enc 和 dec 分别是 encrypt 和 decrypt 的别名。

bge keygen -o alice
bge encrypt report.pdf -r alice.pub.pem
bge decrypt report.pdf.bge -k alice.pem

常见操作

默认不会覆盖已有文件;只有确实需要覆盖时才使用 -f。

为别人加密文件

需要对方的公钥:.pem、.bgekey 身份卡或已保存的联系人名称。只有对方的私钥能解密。

bge encrypt report.pdf -r alice.pub.pem

按姓名给联系人加密

先保存公钥再按姓名加密。地址簿位于 ~/.bge,只保存公钥;姓名不区分大小写。

bge contact add alice.pub.pem -n Alice
bge encrypt report.pdf -r Alice

为自己加密备份

未指定接收人时,使用自己的当前身份;只有自己的私钥能打开。

bge identity add me.pub.pem -n Me
bge encrypt taxes.pdf

使用密码加密

密码适用于无法预先交换密钥的情况;知道密码的人可以打开。

bge encrypt report.pdf -p

解密 .bge 文件

根据加密方式选择私钥或密码;密码模式会提示输入。

bge decrypt report.pdf.bge -k alice.pem
bge decrypt report.pdf.bge -p

查看文件的接收人

只读取公开头部,无需密钥;如果地址簿中有接收人,还会显示姓名。

bge inspect report.pdf.bge

加密整个文件夹

可保留目录结构、逐文件加密,也可创建一个加密归档并隐藏文件名。

bge encrypt myfolder -r Alice
bge encrypt myfolder -a -r Alice

把多个文件打包加密

使用 -a 将多个文件压缩并加密;解密时可用 -x 解压。

bge encrypt a.pdf notes.txt photo.jpg -a -r Alice -o bundle.bge
bge decrypt bundle.bge -k alice.pem -x

不创建解密输出文件地处理数据

使用 - 通过标准输入输出传递内容。此例统计解密字节数而不创建输出文件;状态信息写入 stderr。下游程序仍可能将数据写入磁盘。

bge decrypt - -k alice.pem < report.pdf.bge | wc -c

在脚本中非交互运行

优先使用 RSA 密钥避免交互;密码通过 --password-stdin 传入,不要作为命令参数。可根据 sysexits 区分 64(用法)、65(数据)、66(无输入)、77(无法解密)。

printf %s "$PASSPHRASE" | bge encrypt notes.txt --password-stdin

分享自己的公钥

将公钥包装为 .bgekey 身份卡,让 DotBGE 应用导入为联系人;无需读取私钥。

bge card alice.pub.pem -n "Alice"

与 AI agent 一起使用

bge 仓库提供 Claude Code skill;支持 shell 的 agent 也可以调用相同命令。查看 AI 工具页面中的用法和保护措施。

AI 工具 ↗

开放格式与密钥

CLI 仅使用文件形式的密钥,不保存私钥。它与应用使用相同的开放 .bge v3 格式,规范和测试向量公开。

查看 GitHub 及发行版本 ↗ · .bge ↗