WeMD 安全设计解读:本地优先存储、密钥隔离与 IPC 权限边界的完整指南
WeMD 安全设计解读:本地优先存储、密钥隔离与 IPC 权限边界的完整指南
WeMD 是一款更优雅的 Markdown 公众号编辑器,主打本地优先的写作体验:文章保存在你自己的设备里,无需登录账号,AI 与图床密钥也只存在本机。本文带你通俗地看懂 WeMD 的三层安全设计——本地存储、密钥隔离和 Electron IPC 权限边界,即使你不懂代码,也能明白"我的文章和密钥到底安不安全"。
一、本地优先存储:文章数据从不出你的电脑
📁 数据放在哪?
WeMD 的"本地优先"(Local-First)设计意味着:没有账号体系,没有云端同步你的文章正文。它有两种本地存储模式,可随时切换:
- IndexedDB 模式:默认模式。文章存在浏览器/应用内置的本地数据库
wemd-files中,实现见 IndexedDBAdapter.ts,清理浏览器数据才会丢失。 - 文件系统工作区模式:桌面端可以把一个本地文件夹作为工作区,每篇文章就是一个
.md文件,备份、Git 版本管理都由你掌控。入口在 FileSystemAdapter.ts。
统一的管理层是 StorageManager.ts,它负责"记住你上次选的是哪种模式"并在启动时自动恢复,你在界面里切换一次即可,无需任何配置。
💡 对新手的好处:你的草稿箱天然就是一份本地文件,拷走文件夹就等于完成备份,不存在"数据在别人的服务器上"的担忧。
二、密钥隔离:AI Key 和云存储凭据各管各的
🔑 很多人担心:编辑器要接 AI 和图床,我的 API Key 会不会被收集?看 WeMD 的做法:
1. AI 密钥按服务商分格存放
在设置中填写 DeepSeek、Kimi、OpenAI 等不同服务商的 API Key 时,WeMD 会把它们按服务商分开存档,切换服务商不会互相串号。配置逻辑集中在 aiConfig.ts,存储键为 wemd-ai-config,只写入本机的浏览器本地存储(localStorage),请求 AI 时密钥由你的设备直连对应服务商的接口,WeMD 本身不中转、不保存你的对话内容。
2. 服务端密钥与代码彻底分离
WeMD 的可选后端服务支持把图片上传到腾讯云 COS。此时 COS_SECRET_ID、COS_SECRET_KEY 等凭据只从服务器环境变量读取(见 upload.controller.ts),配置指南 COS_SETUP.md 中明确要求 .env 文件不要提交到仓库,并建议"使用子账号密钥、限制权限范围"。
3. 上传接口自带"最小化"约束
上传端点只接受 jpg/png/gif/webp 图片、单文件不超过 5MB(upload.controller.ts),文件名会被重命名为时间戳+随机数,避免原始文件名泄露信息。
三、IPC 权限边界:渲染进程"被关在笼子里"
🖥️ 桌面端基于 Electron。Electron 应用最常见的安全坑是:渲染网页一旦被攻破,就能借 Node 能力读取你整台电脑的文件。WeMD 做了四道隔离:
1. 关闭网页端的系统能力
创建窗口时明确设置 nodeIntegration: false 与 contextIsolation: true(window.ts),即渲染页面不能直接调用文件系统等系统 API。
2. 只开"白名单窗口"
渲染进程能做的事,全部通过 preload.ts 里 contextBridge 显式列出:列目录、读写文件、新建/重命名/删除文件、写剪贴板、控制窗口、检查更新……每一项都是独立的小函数,没有"万能入口",也没有任意命令执行通道。
3. 工作区"围栏":所有文件操作先验路径
这是最关键的一道。主进程用 isPathInsideWorkspace 校验每一次文件请求的路径必须落在你选定的工作区文件夹内,否则直接返回"非法路径"拒绝执行(见 fileHandlers.ts)。就算页面脚本被诱导,也读不到工作区之外的文件。
此外,工作区主题文件的写入路径由主进程自己推导、不接受外部传参,从设计上杜绝越权写入(themeStorage.ts)。
4. 出站与删除也收着做
- 打开外部链接只放行
http:///https://(shellHandlers.ts),防止本地文件协议被滥用; - 删除文件优先调用系统回收站
shell.trashItem,误删可恢复(fileHandlers.ts); - 剪贴板只提供"写入 HTML/文本"两个动作,不提供读取你既有剪贴板内容的能力(clipboardHandlers.ts)。
IPC 处理函数按职责拆分在 ipc/ 目录下(文件、文件夹、剪贴板、窗口、更新各自独立),边界清晰、便于审查。
四、安全清单:新手速查表
| 关注点 | WeMD 的做法 | 相关源码 |
|---|---|---|
| 文章存在哪 | 本机 IndexedDB 或本地工作区文件夹 | storage/ |
| 需要登录吗 | 不需要,无账号体系 | — |
| AI Key 会上传吗 | 只存本机,直连服务商 API | aiConfig.ts |
| 网页能读任意文件吗 | 不能,工作区路径围栏 + 白名单 API | state.ts |
| 误删怎么办 | 优先进系统回收站 | fileHandlers.ts |
总结
WeMD 的安全思路可以概括成一句话:默认能力最小化,危险操作逐个授权。本地优先让文章数据天然掌握在你手里,按服务商隔离的密钥与不进仓库的服务端凭据让敏感凭据各归其位,而 Electron 侧的上下文隔离、白名单 preload 和工作区路径围栏,则把桌面端最常见的提权风险挡在了门外。对于每天写公众号的创作者来说,这套"本地优先 + 权限围栏"的设计,正是开源写作工具里少见的安心感。📝
