AES-256-GCM 加密密钥库、原子写入与零默认遥测lark-coding-agent-bridge 安全与隐私设计清单【免费下载链接】lark-coding-agent-bridgeBot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI. Streaming cards, per-chat sessions, multiple workspaces项目地址: https://gitcode.com/gh_mirrors/fe/lark-coding-agent-bridgelark-coding-agent-bridge 是一款把飞书 / Lark 消息桥接到本地 Claude Code 或 Codex CLI 的开源 Bot。它常驻在你的电脑上经手 App Secret、会话记录等敏感数据因此安全与隐私设计尤为关键。本文以「安全与隐私设计清单」为主线带你快速看懂它如何用 AES-256-GCM 加密密钥库保护密钥、用原子写入防止配置损坏、用零默认遥测保证数据不出本机——即使你是新手也能轻松理解这套设计。 App Secret 如何加密存储AES-256-GCM 密钥库原理很多同类 Bot 会把飞书应用的 App Secret 直接写进明文配置一旦备份、提交 Git 或粘贴日志就会泄露。lark-coding-agent-bridge 的解法是内置一个本地加密密钥库keystore核心实现在 keystore.ts。落盘时只有两个文件文件内容权限~/.lark-channel/profiles/profile/secrets.enc每个密钥的加密信封IV 密文 认证标签0600~/.lark-channel/profiles/profile/.keystore.salt32 字节随机盐值非机密0600加密链路由三步组成派生密钥用主机名 当前用户名 盐值作为种子经PBKDF2-SHA25610 万次迭代派生出 32 字节密钥deriveKey同一台机器上不同用户派生出不同密钥AES-256-GCM 加密每次加密随机生成 12 字节 IV并附带 16 字节 GCM 认证标签密文被篡改时解密会直接失败encrypt原子落盘写入密钥库文件本身也走原子写入避免半截文件。 源码注释对定位非常坦诚这是针对「备份外流、误提交、日志粘贴」等意外泄露的纵深防御而非抵御同用户进程的主动攻击——这种不夸大安全性的写法本身就值得加分keystore.ts。 密钥解析器把敏感值移出 config.jsonsecret-resolver.ts 支持四种方式提供 App Secret让明文密钥彻底远离配置文件明文 /${ENV_VAR}模板最简写法支持环境变量占位符env 源按变量名读取支持 provider白名单防止读到不该读的变量file 源从本地文件读取exec 源调用外部密钥管理命令JSON-RPC 协议带 5 秒超时与 64KB 输出上限防止恶意/异常输出拖垮进程spawnExecProvider。一个贴心细节当 exec 源指向 bridge 自己的secrets get命令时会短路直读密钥库避免进程自递归、也保证PATH缺失时仍能启动。⚡ 原子写入配置文件与密钥库为什么不会损坏断电、崩溃、磁盘抖动时「写到一半」的文件是数据损坏的常见来源。bridge 的 writeFileAtomic 把「原子写入」做成了完整流程在目标目录创建带 PID 时间戳 随机数的临时文件默认权限0600写完数据后执行fsync强制刷盘Windows 上忽略特定 EPERM 噪音chmod固定权限后将临时文件rename覆盖目标文件——rename 是原子操作读者要么看到旧文件、要么看到新文件rename 遇到 EBUSY/EPERM 等瞬态错误时指数退避重试最多 5 次renameWithRetry并用 graceful-fs 兜底 Windows 兼容性最后尽力同步目录项失败任一步骤都会清理临时文件再抛错。这意味着config.json、secrets.enc等关键文件在任何时刻都只可能是「完整旧版」或「完整新版」。 零默认遥测数据不离开你的机器「零默认遥测Zero Default Telemetry」指不配置任何东西时程序零依赖、零网络请求、零数据上报。telemetry.ts 默认是一个空操作适配器noop。运维人员如果确实需要监控才通过环境变量主动挂载自己的遥测模块LARK_CHANNEL_TELEMETRY_MODULEyour-telemetry-package lark-channel-bridge start该设计还有两层保险失败降级模块不存在、工厂函数不合法、adapter 抛错都静默降级为 noop——遥测永远不会阻止 bridge 启动loadTelemetryAdapter安全包裹所有 adapter 方法被 try/catch 包裹并只告警一次「慢而糟糕」的第三方遥测包也无法打断宿主进程。️ 日志脱敏与权限最小化隐私不止在传输层。logger.ts 内置脱敏管线含token/secret/authorization的字段一律替换为[REDACTED]Bearer token、Authorization: ...等文本模式被正则抹除本地路径替换为[REDACTED_PATH]、飞书资源 ID 替换为[REDACTED_RESOURCE]长字符串截断避免日志膨胀。权限侧同样遵循最小化permissions.ts 将 agent 文件访问收敛为read-only只读/workspace仅工作区/full完整三档默认从保守档位起步且与 Claude 的 permission mode、Codex 的沙箱模式做了归一化映射。✅ 安全与隐私设计清单速查#设计点机制源码位置1密钥加密AES-256-GCM 随机 IV 16B 认证标签src/config/keystore.ts2密钥派生PBKDF2-SHA256 × 100k主机用户盐 隔离src/config/keystore.ts3文件权限敏感文件强制chmod 0600src/config/keystore.ts4密钥外置env / file / exec 多源解析 白名单src/config/secret-resolver.ts5原子写入临时文件 fsync rename 重试src/platform/atomic-write.ts6零默认遥测默认 noopopt-in 且失败降级src/core/telemetry.ts7日志脱敏凭据、路径、资源 ID 自动抹除src/core/logger.ts8权限最小化read-only / workspace / full 三档src/config/permissions.ts小结lark-coding-agent-bridge 展示了本地 Bot 类产品应有的隐私姿态密钥加密落盘、写入永不损坏、数据默认不出门、日志不留痕。对新手用户来说你无需手动配置任何安全项——上述清单全部开箱即用而想审计或加固细节时上表中的源码路径就是最短路径。更多安装与配置说明可参考 README.zh.md对以上安全设计有讨论或反馈欢迎通过上方二维码加入飞书反馈群交流。【免费下载链接】lark-coding-agent-bridgeBot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI. Streaming cards, per-chat sessions, multiple workspaces项目地址: https://gitcode.com/gh_mirrors/fe/lark-coding-agent-bridge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考