基础工作流
项目、图形与脚本
Eidograph 的工作区可以同时打开多个项目。项目显示为顶部标签,一个项目内部可以有任意数量的 2D 平面图形与 3D 立体图形。图形类型在创建时确定;切换图形时,应用会装载对应的画布与工具。
每个图形只有一个事实来源:Eidolang 脚本。画布工具会追加命令,拖动会改写数值字面量,参数滑块也会把最终值写回文本。因此可以自由混合三种编辑方式:
- 用工具快速搭建构造;
- 直接拖动自由点或路径上的绑定点;
- 在编辑器中精确修改命令与表达式。
对象面板列出名称、类型、自由度和当前状态;诊断区域给出脚本错误、警告、行号和修复提示。遇到错误时先修复最早的一条,后续错误往往会随之消失。
文件管理
一个 .eido 文件就是一个完整项目。它是基于 ZIP 的当前格式(manifest version: 2),内部脚本保持为纯 UTF-8 文本。保存项目时会包含图形顺序、名称、2D/3D 类型以及该项目自己的画布与缩放设置。
默认不把 Agent 聊天写入文件;需要共享对话时,在设置 › 常规 › 包含 Agent 聊天中开启。摄像机角度、平移缩放和选择状态属于本机视图状态,不进入项目文件。
导出图形
点击左侧工具栏底部的导出,选择格式与范围:
| 格式 | 2D 平面 | 3D 立体 | 适合场景 |
|---|---|---|---|
| SVG | 原生矢量图 | 当前视角的线框/轮廓投影 | 排版、网页和后续矢量编辑 |
| PNG | 支持透明背景与 1×/2×/4× | WebGL 画布像素输出 | 演示、聊天和普通图片 |
| GIF | 按动画或阶段时间线导出 | 时间线或相机环绕 | 展示动态关系 |
范围可选择当前视图或适合内容;2D 还可以在画布上框选自定义区域。坐标网格、透明背景、像素倍率和 GIF 帧率可以逐次调整,也可以在设置中修改默认值。
常用设置
- 外观:浅色/深色/跟随系统、界面语言和文字缩放。
- 画布与缩放(默认):只影响之后创建的新项目。
- 此项目 › 画布与缩放:随
.eido保存,只影响当前项目。 - 导出默认值:决定导出对话框的初始值。
- Agent:保存模型端点并选择当前模型。
- MCP / REST 服务器:控制原生应用的端口、监听范围、工具权限与活动记录。
应用内 Agent 基础使用
- 打开设置 › Agent,添加模型的提供商、Base URL、API 密钥和模型 ID。
- 回到右侧 Agent 标签,输入“创建一个三角形并标出三边中点”之类的请求。
- 展开每个工具调用,检查参数、结果和脚本修改。
- 如果结果不合适,使用该轮下方的回退本轮;它会尽量保留你在之后做的手动修改。
Agent 默认跟随当前项目。长任务开始前可以将它固定到项目,避免查看其他标签时改变编辑目标。Agent 修改会经过与手动编辑相同的编译、诊断、持久化与撤销流程。
WARNING
模型端点必须允许应用的 WebView 发起跨域请求(CORS)。Windows 和 Android 应用会把 API 密钥存入系统保护的凭据存储。
