DotBGE

bge 命令列工具

bge 是 DotBGE 的終端機工具。它使用開放的 .bge 格式:RSA-4096-OAEP 用於身分加密,AES-256-GCM 用於檔案內容;無需帳號或伺服器。.bge 檔案和 .bgekey 身分卡可與 iPhone、iPad 和 Android App 交換。

安裝

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 App 匯入為聯絡人;無需讀取私鑰。

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

與 AI agent 一起使用

bge 儲存庫提供 Claude Code skill;支援 shell 的 agent 也可以呼叫相同命令。查看 AI 工具頁面的用法和保護措施。

AI 工具 ↗

開放格式與密鑰

CLI 僅使用檔案形式的密鑰,不儲存私鑰。它與 App 使用相同的開放 .bge v3 格式,規範和測試向量公開。

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