Windows 本地优先 一切皆插件 v1.4.1

你的笔记,落在你自己的磁盘上

ZLYNOTES 把你的笔记以自有明文格式 .zly 保存在本机:不联网也能用, 迁移只需拷文件。正文与插件数据同处一个文件,插件不会与笔记分家。账号与云同步是可选能力,可接到你自建的后端。

当前版本 v1.4.1 · 已打包安装版与便捷版(release/);许可: PolyForm Noncommercial License 1.0.0。

ZLYNOTES 主界面:左侧笔记列表,中间源码编辑器,右侧 Markdown 预览与插件面板
主界面:源码编辑(CodeMirror 6)与 Markdown 预览左右并列,右栏是插件面板。
核心特性

本地优先,却一点也不简陋

读写全部在本机完成:路径白名单 + 原子写入(tmp + fsync + rename)。插件体系覆盖编辑器、面板、侧栏、命令、设置与预览操作六类扩展点。

本地优先

纯文本落盘,随时带走

笔记是可直接阅读的 JSON(.zly):不依赖数据库、不锁定格式,拷走文件即完成迁移。

预览就地编辑

双击预览即改字

在预览区双击即可修改(含表格单元格 / 列表项 / 引用段 / 标题等片段级定位);改的是源码,只改纯文本,标记与结构一字不动。

插件体系

一个 manifest 就是插件

manifest.json + index.html 即可运行;能力默认拒绝、按权限白名单放行,插件故障绝不拖垮主程序。

多仓库

多份笔记目录并存

可切换多个笔记仓库;新建仓库会在所选文件夹下创建子文件夹(同名自动加后缀、绝不覆盖),移除仓库时可选择一并清理软件产生的数据。

可选云同步

账号与同步,可自建

登录后可把笔记同步到你自建的后端;支持云端笔记列表、按需下载、云端仓库分组。不登录也能完整使用本地功能。

公告 · 负载均衡

内置双端能力

内置公告插件(服务端维护公告文件、客户端展示公告条与公告中心,改文件后刷新即生效)与负载均衡插件(多节点并发测速择优、失败冷却、全部不可用时回落默认地址)。

界面截图

真实界面,非概念稿

以下截图由自动化探针在真实 Electron 中经 CDP 截取,与发布版本一致。

ZLYNOTES 主界面:编辑器与预览并列,左栏笔记列表与插件开关
主界面:左侧导航与插件开关、中间源码编辑、右侧预览与插件面板。
在预览区双击段落进入就地编辑态,仅修改纯文本
预览就地编辑:双击段落即可改字,虚线框内为编辑态,仅修改纯文本。
右栏插件面板:内置「公告」插件面板
插件面板:内置「公告」插件在右栏渲染,沙箱隔离、异常自动停用。
插件体系

三种形态,一套规范

第三方凭插件规范即可写出并打包插件;.zlymodel 包拖进窗口即安装。

编辑器插件

跑在渲染进程的 iframe 沙箱里,通过 window.zly.* 申请能力(编辑器 / 笔记 / 存储 / 界面 / 注册点)。

后端插件

跑在服务端子工程的 worker 软沙箱里:能力白名单 + SQL 白名单 + 超时与崩溃隔离,可读取插件目录内的只读资源。

双端插件

客户端与服务端成对,两端齐备才生效(如「用户系统」「公告」);任一端未启用则不请求、不展示。

完整字段表、能力域与最小示例见 插件开发文档;仓库内的规范原文是 docs/plugin-spec.md。

下载与版本

装好就能用,不装后端也行

本地笔记功能不依赖后端;只有账号与云同步需要你自建后端(见仓库 server/README.md)。

版本信息:当前 v1.4.1;更新与历史见 GitHub 仓库。 本站为静态站点,安装包由本站根目录下的 downloads/ 提供(部署说明见 web/README.md)。

许可

PolyForm Noncommercial License 1.0.0

本项目使用的许可协议

ZLYNOTES 的源码、安装包、文档与插件规范统一以 PolyForm Noncommercial License 1.0.0 发布。许可全文随源码仓库分发(仓库根目录 LICENSE), 官方文本见 polyformproject.org/licenses/noncommercial/1.0.0。

许可原文为英文,条款以英文文本为准。

FAQ

常见问题

必须联网吗?我的笔记存在哪里?

不需要。笔记以明文 .zly(JSON)保存在你自己的磁盘上,读写全在本机完成。账号与云同步是可选的:只有启用后才需要后端。

换电脑怎么迁移?

直接拷贝笔记文件或整个笔记目录即可。软件支持多个笔记仓库(目录),可在侧栏切换。

项目使用什么许可协议?

以 PolyForm Noncommercial License 1.0.0 发布,许可全文见源码仓库根目录 LICENSE,官方文本见 polyformproject.org。

插件安全吗?会不会拖垮主程序?

插件跑在沙箱里,能力默认拒绝、按权限白名单放行;后端插件还有 SQL 白名单与超时/崩溃隔离。插件异常会被自动停用,不影响主程序与其他插件。

公告和负载均衡是什么?

「公告」是内置双端插件:服务端维护公告文件,客户端展示公告条与公告中心,改文件后前端刷新即生效。「负载均衡」维护多个后端节点,联网前并发测速择优,失败会冷却并自动切换,全部不可用时回落默认地址。