Eidos

Eidos File：把开放结构化数据装进一个文件

Eidos File 是一种开放、本地优先的结构化数据格式。一个可移植的 .eidos 文件，可以在标准 SQLite 之上容纳多张类型化数据表、关系、Formula、Lookup 与持久化视图。文件属于你，即使离开 Eidos 应用也仍然可以检查。

普通 SQLite 工具可以读取规范数据表与元数据。Formula、Lookup、反向 Relation、类型化查询、事务和 validation 等完整逻辑行为，则由符合规范的 Runtime 提供。

一个 Eidos File 分别呈现为 Grid、Kanban 与 Gallery，所有视图共享同一份记录。

Grid、Gallery、Kanban 与自定义视图，只是处理同一份记录的不同方式。视图保存查询和呈现状态，不会复制数据表。

在编辑器中体验

  1. 打开 Eidos File 编辑器。
  2. 选择打开 .eidos 文件、打开示例 Eidos File或从模板新建…。
  3. 体验项目组合、个人关系管理、家庭财务、阅读资料库、习惯日志和内容日历。这些文件共同覆盖 Formula、Relation、Lookup、Select、Multi-select、日期、附件、持久化筛选、分组、统计、Gallery 与 Kanban。
  4. 保存原文件，或下载新的副本。

获得授权后，Chromium 系浏览器可以把修改写回原文件；其他浏览器使用明确的副本流程。两种模式都只在本地通过 SQLite WASM 与 Web Worker 处理数据库。

文件会携带什么

  • File、Table、Field、Record 的稳定标识，以及当前 revision；
  • 字段名称、类型、选项、Formula、Lookup 与 Relation；
  • 包含筛选、排序、字段顺序和布局属性的持久化视图；
  • 文件标识与格式版本。

不受当前宿主支持的自定义视图类型仍会保留在文件中。宿主可以临时回退到 Grid，但不应删除自己无法理解的视图元数据。

选择一条路径

Eidos File 提供两条不同的工作路径，最终都落到同一个由用户拥有的文件。

人 → Web Editor 或 Eidos Desktop → Runtime → .eidos

通过可视化编辑器创建数据表、切换视图并直接审阅数据。

AI Agent → Eidos Skill → eidos CLI → Runtime → .eidos → Graft diff / review / restore

当 Agent 或自动化需要类型化、revision-aware 的事务边界时，使用 Skill 与 CLI；需要版本历史、审阅、分支、同步或恢复时，再接入 Graft。

入口适用场景
Eidos File Web Editor直接在浏览器中打开或编辑本地文件。
Eidos Desktop将 Eidos File 与文档、附件、本地 AI 和版本历史一起使用。
eidos CLI + Eidos Skill让 Agent 或脚本安全地执行结构化读取与 mutation。
@eidos.space/eidos-file为应用接入 headless Runtime、类型化查询、事务或 validation。
@eidos.space/eidos-file-ui为 React 应用接入共享 viewer、编辑器 UI 或自定义视图。
Graft为文件提供版本化 diff、分支、同步、审阅或恢复。

隐私与所有权

.eidos 文件始终是事实来源。编辑器不会把文件内容上传到 Eidos 服务器。需要恢复未保存工作时，浏览器可能保留一份私有本地 checkpoint；你可以在编辑器中丢弃，或通过清除站点数据将其删除。

编辑器和模板均支持中文与英文。切换界面语言时，编辑器会选择对应语言的模板文件；它绝不会翻译或改写已有文件中用户创建的名称与数据。

阅读格式参考了解稳定的 SQLite 契约，使用已发布的 1.0.0 package 基于 Eidos File 构建，或配置 Agent 与自动化。