Eidos

Agent 与自动化

Rust eidos CLI 是面向 AI Agent 与自动化的结构化机器接口。它直接读写 .eidos 文件，只输出 JSON，并使用与 Eidos File Runtime 相同的类型化数据模型。它不会连接 Eidos Desktop。

状态：Alpha · 当前稳定 CLI 0.34.0。 CLI 与 Eidos Desktop 独立发布。

当前能力边界

Alpha 版本可以创建和检查 Eidos File，查询已存储的 scalar 与 list 字段，读取正向 Relation，通过 revision 检查原子执行 row 或 schema mutation，并运行 validation。

它会保留并报告已有的 Formula、Lookup、反向 Relation 与视图元数据，但还不能创建或计算这些虚拟字段。版本历史与同步由 Graft 负责，不属于 CLI。直接写 SQLite 不受支持，因为这会绕过类型化事务和 validation 边界。

1. 安装 CLI

macOS 与 Linux：

curl --proto '=https' --tlsv1.2 -LsSf https://download.eidos.space/cli/install.sh | sh

Windows PowerShell：

irm https://download.eidos.space/cli/install.ps1 | iex

安装器会解析稳定 CLI 版本，下载对应的 cli-v* GitHub Release 压缩包，并根据该 Release 的 SHA256SUMS 验证 SHA-256 后才替换二进制文件。Desktop 安装包与 CLI 压缩包是两条独立的产品与发布流。

2. 安装版本匹配的 Eidos Skill

CLI 负责类型化事务边界；Eidos Skill 教 Codex 使用安全的 context → apply → validate 工作流，以及何时使用 Graft 审阅或恢复。

从与 CLI 0.34.0 相同的公开 tag 安装 Skill：

npx skills add \
  https://github.com/mayneyao/eidos/tree/cli-v0.34.0/skills/eidos \
  --skill eidos -g -a codex -y

该命令使用开放的 skills installer，需要 Node.js 18 或更高版本。固定版本的来源让工作流与已安装的 CLI 保持一致，而不是跟随持续变化的开发分支。安装完成后新建一个 Codex 任务，让 Agent 重新发现 Skill。

3. 先从只读任务开始

使用 Eidos Skill 检查 ./tracker.eidos。
先展示 context，暂时不要修改。

Agent 应该先确认目标文件、数据表、字段、稳定 ID 与当前 revision，再提出 mutation。

安全写入闭环

  1. 读取紧凑且有边界的 context。
  2. 通过当前 revision 执行一次精确事务。
  3. 最后一次 mutation 完成后运行 full validation。
  4. 如果文件由 Graft 追踪，提交前审阅 logical diff，并在需要时通过历史恢复。
eidos tracker.eidos context Tasks --fields Title,Status --limit 50
eidos tracker.eidos apply - <<'JSON'
{
  "revision": "1",
  "table": "Tasks",
  "match": {"_id": "019..."},
  "expect": 1,
  "set": {"Status": "doing"},
  "returning": ["Title", "Status"]
}
JSON
eidos tracker.eidos validate --level full
graft status --json
graft diff --rows --json HEAD

Alpha 阶段，不要让 CLI 与 Web Editor 或 Desktop 同时写入同一个文件。先在编辑器中关闭文件，或在文件副本、Graft branch 中操作。

如果要在应用内嵌入 Eidos File，请使用 Runtime 与 UI package；如果要了解磁盘格式，请阅读格式参考。