Skip to content

项目、图形与文件工作流

Eidograph 的层级是“工作区 → 项目 → 图形”。顶部每个标签是一个打开的项目;一个项目对应一个 .eido 文件,并可包含任意数量的 2D 或 3D 图形。每个图形是一份 Eidolang 脚本。

新建项目

点击顶部 +,选择:

  • 新建项目 — 2D 图形:项目中带一个平面图形;
  • 新建项目 — 3D 图形:项目中带一个立体图形;
  • 空项目:不含图形,稍后从图形面板或 Agent 创建。

点击项目标签可切换;点击当前标签打开项目操作,可重命名、保存、另存为或关闭。项目名在保存后以实际 .eido 文件名为准。

管理图形

在右侧图形面板中:

  • 使用 + 2D+ 3D 添加图形;
  • 点击行切换当前图形;
  • 使用铅笔按钮重命名;
  • 使用 × 删除,确认后无法通过普通撤销恢复;
  • 实心/空心圆点控制该图形是否暴露给 Windows MCP/REST 客户端。

图形在创建时固定为 planesolid。修改脚本中的 space 为另一种类型只会产生诊断,不会转换图形;请新建目标类型图形并迁移构造。

当 Agent 固定到某个项目并正在工作时,该项目的图形新增、删除与切换会被锁定,以避免中途改变目标。

保存、另存为和关闭

  • 保存:第一次选择目标路径,之后覆盖同一文件。
  • 另存为:选择新文件名和位置,并把项目名同步为文件名。
  • Ctrl/⌘ S:保存;Ctrl/⌘ Shift S:另存为。
  • 关闭:只从工作区移除标签,不删除磁盘上的 .eido。有未保存修改时会要求确认。

.eido 是 ZIP 容器,manifest 当前固定为 version: 2,内部每个图形仍是纯文本脚本。它保存项目名、图形顺序/名称/类型以及项目自己的画布与缩放设置。默认不含 Agent 对话;需要时先开启设置 › 常规 › 包含 Agent 聊天

相机姿态、2D 平移缩放、网格样式与选择状态是本机视图状态,不进入 .eido

打开与拖放导入

点击顶部文件夹按钮,或把文件拖到应用窗口:

文件结果
.eido作为新的项目标签打开
.zip按当前 .eido 包结构读取,作为新项目打开
.geo / .txt作为新图形加入当前项目

裸脚本优先读取 space planespace solid。没有 space 行时,应用会询问以 2D 还是 3D 打开。.eido 永远不会合并进当前项目。

导出单个脚本

通过命令面板选择保存 Eidolang (.txt),可以把当前图形导出为纯文本。它只包含一个图形,不含项目设置或其他图形;适合代码审阅和版本控制,但完整分享应使用 .eido

推荐备份方式

  1. 工作过程中定期保存项目。
  2. 在升级、切换测试/生产轨道或卸载前使用另存为建立外部副本。
  3. 需要分享对话时才打开“包含 Agent 聊天”,并先检查提示中是否有敏感内容。
  4. 用另一个标签重新打开备份,确认图形数量、类型和脚本无误。