Meldwork 安全设计完整指南:从敏感信息脱敏、私有文件存储到 CSP 防护全解析

原创2026-10-19 09:41:02519 阅读

Meldwork 安全设计完整指南:从敏感信息脱敏、私有文件存储到 CSP 防护全解析

Meldwork 是一款 local-first(本地优先)的 AI Agent 协作工作区。它的 Meldwork 安全设计围绕三条主线展开:敏感信息脱敏、私有文件存储与 CSP 防护。本文带你完整解析这套「脱敏—存储—防护」三层安全机制如何协同工作,让多个 Agent 在你的电脑上放心协作。🛡️

先搞清楚:本地多 Agent 工作区面临哪些风险

Meldwork 让 Codex、Claude Code、Hermes 等多个 Agent 在本地共同完成群聊讨论、自动评审等任务。数据不出本机是它的卖点,但 Agent 会调用本地 CLI、读写文件、产生日志,这就带来三类典型风险:

  • 🔑 密钥泄漏:Agent 的 CLI 输出、日志里可能混入 API Key、Token、私钥,一不小心就被存进对话记录;
  • 📂 本地文件越权读取:工作区、凭据、收件箱等 JSON 文件若权限过宽,同机其他用户也能读;
  • 🧱 渲染进程被注入:作为 Electron 应用,如果 CSP(Content Security Policy)不严,恶意脚本或外部内容就可能借道 UI 拿到本地数据。

Meldwork 的应对思路可以概括为一句话:日志先脱敏、落盘先设防、界面先隔离。

Meldwork 本地 Agent 发现界面:local-first 多 Agent 工作区的安全设计起点

敏感信息脱敏:redactSecrets 一次性拦截 9 类密钥

脱敏逻辑集中在 desktop/src/security/secret-redaction.cjs,核心是一个 redactSecrets() 函数。它对任意文本做一遍正则扫描,命中以下 9 类高风险模式就替换为 [redacted]:

高风险内容 示例 脱敏结果
PEM 私钥块 -----BEGIN ... PRIVATE KEY----- [redacted private key]
Bearer 令牌 Bearer eyJhbGci... Bearer [redacted]
Basic 认证 Basic dXNlcjpwYXNz Basic [redacted]
云厂商密钥前缀 sk-... / ghp_... / xoxb-... [redacted]
AWS 访问密钥 AKIA + 16 位大写字母数字 [redacted]
Google API Key AIza + 35 位 [redacted]
JWT / JOSE 紧凑串 3 段或 5 段 base64url [redacted]
URL 内嵌凭据 postgres://user:pass@host postgres://[redacted]@host
敏感键赋值 api_key: "abc123" credential=[redacted]

细节上它做得很克制:Basic 认证串会先尝试 base64 解码、确认里面真的像 用户名:密码 才脱敏;JWT 会检查头部是否含 alg/enc 字段,避免误伤普通文本。而「敏感键赋值」一条会匹配 api_key、token、password、dsn、database_url、session_ref 等 18 个键名,覆盖配置文件里常见的 key=value 与 key: "value" 两种写法。

脱敏的双重角色:日志清洗 + 入库校验

redactSecrets 在 Meldwork 里不只是「输出过滤器」,还兼职「输入校验器」,这是这套设计最巧妙的地方:

  • 输出侧(清洗):Agent CLI 的事件流在交给界面前,会先经过 cli-acp-runner.cjs 的脱敏管道,密钥不会出现在运行日志里;
  • 输入侧(校验):在 Connector 清单、消息入站等落盘入口,Meldwork 会执行 redactSecrets(value) !== value 的判断——如果一段文本经过脱敏后发生了变化,说明它含有密钥,直接判为非法并拒绝写入(见 agent-connector-manifest.cjs、channel-ingress-contract.cjs)。

这样密钥既不会从日志里「漏出去」,也不会从用户输入里「流进来」。

Meldwork 多 Agent 协作群聊界面:Meldwork 安全设计保障敏感信息脱敏与私有文件存储

私有文件存储:0o600 权限 + 原子写入双保险

第二类防线是 desktop/src/security/private-file.cjs 提供的 atomicWritePrivateFile()。Meldwork 的所有本地状态文件(工作区、凭据、收件箱、人机门禁记录等)都通过它落盘,流程分五步:

  1. 目录权限 0o700:创建存储目录时限定只有属主可进入;
  2. 临时文件独占创建:生成 .文件名.pid.随机串.tmp 临时文件,以 wx 标志 + 0o600 权限打开——只属于当前进程、属主独读独写,还天然避免并发写入冲突;
  3. fsync 刷盘:写完强制同步到磁盘,掉电也不留半个文件;
  4. 再次 chmod 0o600:显式校正,防止系统 umask 差异削弱权限;
  5. rename 原子替换:把临时文件重命名为正式文件,读者看到的要么是旧文件、要么是完整的新文件。

任何一步失败都会关闭句柄并清理临时文件,绝不留下「脏数据」。

哪些数据走了私有存储?

从代码引用来看,走私有存储的都是「敏感 + 关键状态」:

CSP 防护:白名单 + 沙箱 + 信任校验三道防火墙

一条只允许本地加载的 CSP

前端入口 frontend/index.html 里写死了严格的 CSP 策略:

指令 取值 作用
default-src 'self' 默认只允许加载本地文件
script-src 'self' 禁止内联脚本与远程脚本
connect-src 'self' 禁止向外部地址发起连接
img-src / media-src 'self' data: meldwork-media: 图片、媒体仅限本地与自定义协议
object-src / frame-src 'none' 彻底禁用 <object> 与 <iframe>
base-uri / form-action 'none' 禁止篡改 <base> 与提交表单

连前端加载失败时的离线兜底页 offline.html 都用了更激进的 default-src 'none'——一个报错页没有任何理由去加载外部资源。

Electron 窗口加固:沙箱、上下文隔离与权限全拒

主进程创建窗口时(desktop/src/main.cjs)做了一整排加固:

配置 值 含义
contextIsolation true 上下文隔离,preload 脚本与页面 JS 互不干扰
nodeIntegration false 页面内无法直接使用 Node API
sandbox true 渲染进程整体沙箱化
webSecurity true 保留同源策略
allowRunningInsecureContent false 禁止不安全混合内容
webviewTag false 禁用 <webview> 标签

在这之上还有三条「全拒」规则:相机、麦克风、定位等所有权限请求一律拒绝;window.open 统一 deny,仅纯 https 链接(且 URL 中不含账号密码)才允许交给系统浏览器打开;本地导航只允许在「前端入口页」与「离线页」两个白名单路径之间跳转(main-renderer-security.cjs)。

IPC 信任校验:只有「正主」渲染进程才能调接口

沙箱只是第一道门,IPC 通道上还有一层身份核验。registerTrustedHandle 会把所有 ipcMain.handle 包一层 requireDesktopRenderer:发送方必须同时满足——是预期的 webContents、处于当前主帧(processId 与 routingId 双重匹配)、URL 是 file: 协议且路径精确等于前端入口文件(isTrustedLocalRenderer),否则直接抛出 DESKTOP_CLIENT_ACCESS_DENIED。

配合 preload.cjs 中冻结(frozen)的最小 API 桥接,以及附件导入的类型 + 大小白名单,UI 层能调用什么、能传多大的数据,都被严格框死。

Meldwork 自动讨论流程示意:CSP 防护与私有文件存储保障下的 Agent 安全协作

用测试与策略文档给安全设计兜底

Meldwork 把安全规则「钉死」在测试里:

  • main-security.test.cjs:验证主帧信任校验、单实例锁、导航白名单等主进程防线;
  • security.spec.js:断言 index.html 中的 CSP 关键指令(default-src 'self'、connect-src 'self'、object-src 'none' 等)不被意外弱化;
  • SECURITY.md:公开安全策略,明确「IPC 授权绕过、密钥暴露、任意文件读写、附件校验失效」属于漏洞报告范围,并约定漏洞应走私密渠道报告。

小结:Meldwork 安全设计的三个关键词

✅ 脱敏:redactSecrets 以一套正则覆盖 9 类密钥模式,同时充当日志清洗器与入库校验器,密钥进不来也出不去;

✅ 私存:atomicWritePrivateFile 用 0o700 目录 + 0o600 文件 + fsync + 原子替换,保证本地状态文件只有属主可读、永远完整;

✅ 防护:严格 CSP + 全沙箱 Electron 窗口 + 权限全拒 + IPC 主帧信任校验,让渲染进程成为一个「只读本地、只走白名单」的安全沙盒。

对新手来说,理解 Meldwork 的安全设计不需要背下所有正则——只要记住这条主线:日志先脱敏、落盘先设防、界面先隔离。这正是 local-first 多 Agent 工作区赢得用户信任的底层逻辑。

登录后查看全文
Meldwork