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/bgeLinux:從發行頁面下載對應架構(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)驗證下載。
快速開始
產生身分密鑰對、為接收者加密,再用對應私鑰解密。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 工具頁面的用法和保護措施。
開放格式與密鑰
CLI 僅使用檔案形式的密鑰,不儲存私鑰。它與 App 使用相同的開放 .bge v3 格式,規範和測試向量公開。