一、速览：把文件夹变成数据库

入门

Eidos 是一个面向「个人数据管理」的开源框架，其核心理念非常反直觉：你的数据不应该被困在某个专有软件的封闭格式里，而应该存在于你完全掌控的普通文件夹中。

它不像 Notion 那样将所有内容存储在云端黑盒中，也不像传统笔记软件那样依赖复杂的 JSON 嵌套。Eidos Lite（当前主推版本）将每一个 .eidos 文件定义为一个标准的 SQLite 数据库。

这意味着你可以用任何支持 SQLite 的工具打开、查询甚至修改这些数据。这种「Local-first」（本地优先）的设计，确保了即使没有网络、没有官方服务器，你的数据依然完整可用且具备版本历史。

对于开发者而言，Eidos 提供了一个基于 TypeScript 的扩展框架，允许你在保留数据主权的前提下，构建定制化的数据视图和工作流。

二、设计理念：SQLite 即一切

进阶 · 推荐细读

理解 Eidos 的关键在于掌握其「空间（Space）」的心智模型。在 Eidos 中，一个 Space 仅仅是一个普通的操作系统文件夹。

这个文件夹内可以包含多个 .eidos 文件。每个文件本质上都是一个 SQLite 数据库，但它们被 Eidos 赋予了额外的元数据和版本控制能力。

核心抽象：不要将 .eidos 视为私有二进制文件，应将其视为「带有版本历史的结构化数据表」。

这种设计解决了传统笔记软件的两大痛点：数据锁定和性能瓶颈。由于底层是 SQLite，Eidos 能够利用数据库引擎的优势处理大规模数据。

它支持分页查询、虚拟化的表格渲染以及有界的变化预览。即使面对数万行数据，界面依然能保持流畅，这是基于 DOM 的传统编辑器难以企及的。

此外，Eidos 严格区分了「本地状态」与「云同步状态」。版本历史和云端同步是渐进式可用的功能，它们不影响核心文件的可用性。

三、快速开始：从源码运行 Lite 版

入门

目前 Eidos Lite 是主要的开发方向，虽然公共分发版仍在准备中，但开发者可以通过源码直接运行和打包。你需要确保本地已安装 Node.js 和 pnpm。

首先克隆仓库并安装依赖。项目使用了 Corepack 来管理包管理器版本，建议先启用该功能以确保环境一致。

git clone https://github.com/mayneyao/eidos.git
cd eidos
corepack enable
pnpm install --frozen-lockfile

安装完成后，你可以启动开发服务器。Eidos Lite 独立于旧版的 Electron 应用，不依赖 Web 服务器、Markdown 解析器或 AI 子系统，因此启动速度更快。

pnpm dev:eidos-lite

如果需要构建生产环境的开发包，可以使用以下命令。这有助于测试应用在接近真实环境下的表现。

pnpm build:eidos-lite:dev

启动后，你将看到一个极简的界面。此时你可以创建一个新 Space，实际上就是在指定位置创建了一个文件夹和一个初始的 .eidos SQLite 文件。

四、核心概念：版本与数据交互

进阶 · 推荐细读

Eidos 的强大之处在于它对数据变更的精细控制。不同于 Git 的文件级版本控制，Eidos 实现了「行感知（Row-aware）」的版本历史。

当你修改表格中的某一行数据时，系统会记录这一行的具体变化。你可以为每次提交添加有意义的版本说明，并在需要时从本地历史中恢复整个 Space 或特定数据行。

注意：版本历史存储在本地，无需联网即可回溯。这为误操作提供了强大的安全网。

在数据交互方面，Eidos 保持了极高的开放性。你可以直接将 CSV 数据导入到 .eidos 文件中，系统会自动映射列结构。

当需要将数据迁移到其他平台时，也可以轻松导出表格。由于底层是标准 SQLite，你甚至可以直接使用 DB Browser for SQLite 等第三方工具进行复杂查询。

这种设计使得 Eidos 不仅是一个笔记工具，更是一个轻量级的个人数据中台。你可以用它管理客户信息、项目进度或个人知识库，并随时将数据提取出来进行分析。

五、生态与扩展：轻量且独立

深入 · 老手可选

Eidos Lite 的架构刻意保持了轻量化。它与旧版 Eidos Desktop Legacy 中的复杂子系统（如内置浏览器、终端、AI 集成）完全解耦。

这种独立性意味着 Lite 版的代码库更易于理解和贡献。对于想要二次开发的团队来说，不需要处理庞大的遗留代码负担。

虽然目前插件生态尚在早期，但其基于 TypeScript 的框架设计为未来的扩展留下了充足空间。开发者可以围绕 .eidos 文件格式构建专用的数据可视化插件或导入导出工具。

社区资源主要集中在 Discord 和官方文档站。由于项目采用 AGPL v3 协议，任何基于此代码的修改和分发都需要遵守相应的开源义务。

对于大多数用户而言，Eidos 的价值不在于花哨的功能堆砌，而在于它提供了一种回归本质的数据管理方式：数据属于你，格式开放，且永远可用。

项目信息

参考链接

• GitHub 仓库
• 项目主页