项目、图形与文件工作流
Eidograph 的层级是“工作区 → 项目 → 图形”。顶部每个标签是一个打开的项目;一个项目对应一个 .eido 文件,并可包含任意数量的 2D 或 3D 图形。每个图形是一份 Eidolang 脚本。
新建项目
点击顶部 +,选择:
- 新建项目 — 2D 图形:项目中带一个平面图形;
- 新建项目 — 3D 图形:项目中带一个立体图形;
- 空项目:不含图形,稍后从图形面板或 Agent 创建。
点击项目标签可切换;点击当前标签打开项目操作,可重命名、保存、另存为或关闭。项目名在保存后以实际 .eido 文件名为准。
管理图形
在右侧图形面板中:
- 使用 + 2D 或 + 3D 添加图形;
- 点击行切换当前图形;
- 使用铅笔按钮重命名;
- 使用 × 删除,确认后无法通过普通撤销恢复;
- 实心/空心圆点控制该图形是否暴露给 Windows MCP/REST 客户端。
图形在创建时固定为 plane 或 solid。修改脚本中的 space 为另一种类型只会产生诊断,不会转换图形;请新建目标类型图形并迁移构造。
当 Agent 固定到某个项目并正在工作时,该项目的图形新增、删除与切换会被锁定,以避免中途改变目标。
保存、另存为和关闭
- 保存:第一次选择目标路径,之后覆盖同一文件。
- 另存为:选择新文件名和位置,并把项目名同步为文件名。
Ctrl/⌘ S:保存;Ctrl/⌘ Shift S:另存为。- 关闭:只从工作区移除标签,不删除磁盘上的
.eido。有未保存修改时会要求确认。
.eido 是 ZIP 容器,manifest 当前固定为 version: 2,内部每个图形仍是纯文本脚本。它保存项目名、图形顺序/名称/类型以及项目自己的画布与缩放设置。默认不含 Agent 对话;需要时先开启设置 › 常规 › 包含 Agent 聊天。
相机姿态、2D 平移缩放、网格样式与选择状态是本机视图状态,不进入 .eido。
打开与拖放导入
点击顶部文件夹按钮,或把文件拖到应用窗口:
| 文件 | 结果 |
|---|---|
.eido | 作为新的项目标签打开 |
.zip | 按当前 .eido 包结构读取,作为新项目打开 |
.geo / .txt | 作为新图形加入当前项目 |
裸脚本优先读取 space plane 或 space solid。没有 space 行时,应用会询问以 2D 还是 3D 打开。.eido 永远不会合并进当前项目。
导出单个脚本
通过命令面板选择保存 Eidolang (.txt),可以把当前图形导出为纯文本。它只包含一个图形,不含项目设置或其他图形;适合代码审阅和版本控制,但完整分享应使用 .eido。
推荐备份方式
- 工作过程中定期保存项目。
- 在升级、切换测试/生产轨道或卸载前使用另存为建立外部副本。
- 需要分享对话时才打开“包含 Agent 聊天”,并先检查提示中是否有敏感内容。
- 用另一个标签重新打开备份,确认图形数量、类型和脚本无误。
