Thunderbolt 加密数据线上格式完整解析__enc: : 背后的设计【免费下载链接】thunderboltAI You Control: Choose your models. Own your data. Eliminate vendor lock-in.项目地址: https://gitcode.com/GitHub_Trending/thund/thunderboltThunderboltthund/thunderbolt是一款主打AI You Control的开源 AI 助手支持端到端加密多设备同步。本文将拆解 Thunderbolt 端到端加密在同步链路上使用的线上数据格式__enc:iv:ciphertext它由哪几段组成、为什么这样设计以及新手如何阅读相关源码帮你真正理解零知识同步背后的工程细节。一句话看懂Thunderbolt 端到端加密同步先建立整体认知Thunderbolt 的加密同步属于零知识架构——所有用户数据在客户端加密后才上传服务器只保存密文和包裹好的密钥即使服务器被攻破或被迫配合也读不到你的聊天内容。整个密钥体系可以概括为三个角色概念作用内容密钥 CK一把 AES-256-GCM 密钥加密同一用户的所有数据所有设备共用设备密钥对每台设备一对 ECDH P-256 ML-KEM-768后量子密钥私钥永不出设备设备信封用混合加密为特定设备包裹的 CK只有该设备能解开完整的密钥分层设计详见官方架构文档 docs/architecture/e2e-encryption.md。线上格式拆解三段式密文的每一部分当开启端到端加密后同步通道PowerSync 同步链路上传/下载的每一条加密列的值都会被写成这样的字符串__enc:iv-base64:ciphertext-base64逐段解释__enc:前缀—— 格式标识符。它的作用不只是看起来像密文而是权威信号下载端只要看到这个前缀就执行解密无需查询配置。ivBase64 编码—— 12 字节的随机初始化向量由加密时随机生成。AES-GCM 要求每次加密使用不同的 IV防止相同明文产出相同密文。ciphertextBase64 编码—— 用 AES-256-GCM 加密后的密文末尾自带 16 字节的认证标签能检测任何篡改。选择 Base64 而非 hex 的原因也很实际Base64 比 hex 短约 25%在同步 JSON 里传输更省流量且对文本数据库完全友好。加密原语全部集中在 src/crypto/primitives.tsencrypt()负责生成随机 IV 并输出 Base64 的 iv/ciphertextdecrypt()负责还原。编解码核心codec 的防御性设计真正拼装与拆解这个格式的是编解码器 src/db/encryption/codec.ts它对新手特别值得细读因为里面全是防御性编程的细节encode 侧如果输入已经以__enc:开头直接原样返回防止密文再加密的双重加密事故如果内容密钥 CK 缺失但加密已完成配置会直接抛错拒绝写入明文宁可失败也不泄露。decode 侧找不到分隔符、没有 CK、解密失败时都降级返回原始值而不是崩溃——同步链路不能因为单条数据出错就整体中断。CK 缓存失效机制CK 惰性加载自 IndexedDB 并缓存在内存登出时通过BroadcastChannel向主线程、SharedWorker、其他标签页广播失效消息确保过期的密钥绝不会被再次使用。上传与下载两条路径同一个格式格式之所以简单稳定是因为上传和下载共用同一个契约上传路径加密后入库到同步队列src/db/encryption/upload-encoder.ts 中的encodeForUpload()只加密配置表里声明过的列PUT/PATCH 走加密、DELETE 直接放行。下载路径解密后写入本地 SQLitesrc/db/powersync/middleware/EncryptionMiddleware.ts 采用数据驱动策略——它扫描整条记录的所有字符串字段凡以__enc:开头的都解密不看配置。这个不对称是有深意的桌面端旧版本自带的加密列清单可能落后于新版本新增的加密列但只要认前缀旧客户端依然能正确解密新数据。格式即接口前缀即契约。哪些列被加密由单一事实来源 src/db/encryption/config.ts 中的encryptedColumnsMap声明涵盖聊天标题、消息内容、任务、模型配置、提示词、技能等几乎所有用户创作内容——而设备 ID、排序字段这类非用户内容则保持明文。为什么格式里不需要密钥版本号细心的你会发现__enc:里只有 IV 和密文没有算法或版本字段。这并非疏忽算法由内容密钥 CK 的类型决定固定 AES-256-GCM 12 字节 IV密钥类型不会中途更换真正需要版本化的地方是设备信封src/crypto/primitives.ts 中wrapCK()组装的信封首字节就是版本号0x01因为混合密钥封装ECDH ML-KEM-768更可能有协议演进数据面格式保持稳定把演进压力留给密钥面是典型的少变协议、多变密钥分层思路。类似的验证机制还能在金丝雀文件里看到src/crypto/canary.ts 用同一个 CK 加密一个固定前缀 随机秘密存到服务端用于校验恢复密钥24 词 BIP-39 助记词是否正确。新手阅读路线图如果你想在本地仓库中亲手验证这套格式建议按以下顺序阅读若需拉取仓库git clone https://gitcode.com/GitHub_Trending/thund/thunderbolt顺序文件看点1️⃣docs/architecture/e2e-encryption.md全局概念、Wire Format 定义、用户流程2️⃣src/crypto/primitives.tsAES-256-GCM 加解密、混合密钥包裹3️⃣src/db/encryption/codec.ts__enc:格式的拼装与拆解、CK 缓存4️⃣src/db/encryption/config.ts加密列清单单一事实来源5️⃣src/db/encryption/upload-encoder.ts上传前加密6️⃣src/db/powersync/middleware/EncryptionMiddleware.ts下载时按前缀解密7️⃣src/db/encryption/codec.test.ts用测试验证你对格式的理解相关文档还包括同步管道集成说明 docs/architecture/powersync-sync-middleware.md。总结__enc:iv:ciphertext这个看似简单的三段式字符串浓缩了 Thunderbolt 端到端加密的几个核心设计取舍前缀即契约数据驱动解密兼容新旧版本、格式稳定密钥演进版本放在信封层而非数据层、处处防御防双重加密、失败降级、密钥失效广播。对于想理解零知识同步如何落地的新手来说这份源码是一份难得的、可直接运行验证的范本。【免费下载链接】thunderboltAI You Control: Choose your models. Own your data. Eliminate vendor lock-in.项目地址: https://gitcode.com/GitHub_Trending/thund/thunderbolt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
