Meldwork 安全设计完整指南:从敏感信息脱敏、私有文件存储到 CSP 防护全解析
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 的应对思路可以概括为一句话:日志先脱敏、落盘先设防、界面先隔离。
敏感信息脱敏: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)。
这样密钥既不会从日志里「漏出去」,也不会从用户输入里「流进来」。
私有文件存储:0o600 权限 + 原子写入双保险
第二类防线是 desktop/src/security/private-file.cjs 提供的 atomicWritePrivateFile()。Meldwork 的所有本地状态文件(工作区、凭据、收件箱、人机门禁记录等)都通过它落盘,流程分五步:
- 目录权限 0o700:创建存储目录时限定只有属主可进入;
- 临时文件独占创建:生成
.文件名.pid.随机串.tmp临时文件,以wx标志 + 0o600 权限打开——只属于当前进程、属主独读独写,还天然避免并发写入冲突; - fsync 刷盘:写完强制同步到磁盘,掉电也不留半个文件;
- 再次 chmod 0o600:显式校正,防止系统 umask 差异削弱权限;
- rename 原子替换:把临时文件重命名为正式文件,读者看到的要么是旧文件、要么是完整的新文件。
任何一步失败都会关闭句柄并清理临时文件,绝不留下「脏数据」。
哪些数据走了私有存储?
从代码引用来看,走私有存储的都是「敏感 + 关键状态」:
- 云 Agent 桥接的存储与操作记录(cloud-agent-bridge.cjs、cloud-agent-operation-store.cjs);
- Agent Connector 实例的凭据文件(agent-connector-instance-store.cjs);
- 消息通道收件箱(channel-inbox-store.cjs);
- 人机门禁(human gate)的记录与隔离文件(human-gate-store.cjs)。
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 把安全规则「钉死」在测试里:
- 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 工作区赢得用户信任的底层逻辑。


