理解 Eidos 的文件模型

Eidos File 是基于 SQLite 的开放结构化数据格式。 每个 .eidos 文件保存自己的数据和结构，可以直接用兼容工具打开。

Eidos Lite 是桌面应用，把本地文件夹作为 Space 打开。 文件夹里可以同时存放 .eidos 文件、Markdown 笔记、图片和其他普通文件。 Lite 提供本地 Graft 历史和可选的 Sync；本地编辑在离线或未登录时也可使用。

从一份书单开始

你想记录读过的书，并保留阅读笔记。创建一个名为 Research 的 Space， 把书单放进 books.eidos，把笔记写在 notes.md 中。

一个 Space，几种普通文件

• 文件夹Research/ Space · 本地文件夹

  • books.eidos 表、字段、记录和视图
  • notes.md Markdown 笔记
  • 文件夹assets/

    • cover.jpg 书单引用的封面图片

books.eidos 中的 Books 表包含 Title、Status 等字段，每条记录代表一本书。“正在读”视图保存筛选和布局。

移动数据时，也带上它引用的本地文件。

这个文件夹仍然可以在系统文件管理器中打开。 用 Eidos Lite 打开它，不会把其他文档转换成数据库记录。

Eidos File 里面有什么

表组织记录，字段描述记录的值，保存的视图选择并显示表中的记录。

组成	作用	书单示例
表	组织同一种内容	Books
字段	描述一种属性	Title、Status
记录	保存一个具体项目	一本书
记录标题字段	提供记录的显示名称	Title
保存的视图	保存查询和显示设置	Status = Reading 的书

文件保存表结构、记录和视图。File 字段可以引用外部附件。 移动文件时，也要带上这些附件。详见数据存储。

一张表，可以有多个视图

Grid 按行显示，Gallery 按卡片显示，Kanban 对记录分组。 它们是表数据的不同显示方式。创建另一个视图不会复制记录。

试一试：同一组记录，不同的视图教学示例 · 不会修改你的文件

• 01The Little PrinceAntoine de Saint-Exupéry
  已读完: The Little Prince
• 02A Room of One’s OwnVirginia Woolf
  已读完: A Room of One’s Own
• 03WaldenHenry David Thoreau
  已读完: Walden

显示 3 / 3 条记录。切换布局不会复制数据。

筛选改变你能看到哪些记录。编辑记录改变记录本身的值。 如果一次编辑让记录不再符合筛选条件，它会从当前视图消失，但仍在表中。

选择打开文件的工具

• **Eidos Lite：**管理包含 .eidos 和普通文件的本地文件夹，使用本地 Graft 历史和可选的 Sync。
• **网页编辑器：**在浏览器中打开一个 Eidos File。关闭前检查保存状态。
• **CLI：**通过脚本或智能体创建、检查、查询和修改文件。用 eidos serve 打开本地编辑器。

这些工具都使用 Eidos File 提供的可跨平台 Runtime。 Lite、网页编辑器和 CLI Serve 共享编辑器 UI，文件的数据和编辑规则保持一致。

本地使用和局域网同步无需账户。云同步和发布是独立的可选服务。 比较保存、历史、Sync 与备份。

下一步：创建一张书单表。