# Schemary · Agent 快速入口

无需安装 Skill、SDK 或 MCP。使用 [Agent 工作台](agent.html) 的可见表单。当前产品版本与构建见 [release.json](release.json)，输入／输出与入口见 [能力清单](agent-capabilities.json)。

This is a static website; /api/projects is NOT an HTTP endpoint. Never invent network APIs.

## 选择最小操作

| 任务 | 操作 |
| --- | --- |
| 查找文案或绑定 | 展开“按任务读取”，按页面、分组或字段筛选；先读匹配结果，按需下一批 |
| 修改几个字段 | 用读取结果的页面／块 ID 与修订，填写“局部变更”；不要读取整个项目 |
| 确认应用类型 | 创建时指定 manifest.display；整个项目共用，创建后暂不可更改。手机竖屏，其余横屏，无需方向字段 |
| 修改交互逻辑 | 读取相关页面与依赖，再提交页面与共享逻辑的原子变更包 |
| 新建页面及入组 | 同一变更包提交 pages 和 groups；scenarios、defaults、settings 也可在包内调整 |
| 读取设计供视觉／开发使用 | 阅读 [读取指南](reading-guide.md)，默认不写入项目 |
| 新建项目 | 完整项目加载 [空白示例](examples/blank-project.json)，保留格式并创建独立项目 |

## 修改闭环

1. 选择项目，读取当前修订。优先按任务筛选，必要时读取相关页面。
2. 提交最小变更包，保留已有 ID。例如：

```json
{"patches":[{"op":"update_block","pageId":"start","blockId":"start-title","patch":{"text":"新标题"}}]}
```

3. 点击“检查并预览差异”，核对旧值→新值、影响范围、相关用例和人工入口。结构错误阻止保存，行为失败单独报告。检查后修改候选会失效，必须重查。
4. 保存原候选，读取新修订和摘要。需要时打开体验或导出备份。冲突时重新读取，不盲目重试。

结构合法、声明用例通过、浏览器体验、用户确认是不同证据。未运行／跳过用例不能算通过。不添加运行脚本、HTML、CSS 或专用适配器。

Different browser/environment: project IDs do not transfer data. 导出文件中的 IDs/timestamps do not identify an import target；导入会新建项目。Data lives in this origin's IndexedDB, not shared cloud storage. Do not promise cross-device synchronization or persistence after site data is cleared.

按需查阅：[创建质量规则](authoring-guide.md) · [操作与格式参考](agent-reference.md) · [组件](components.md) · [行为用例](behavior-guide.md) · [完整 Schema](project.schema.json)。menu 当前是原型窗口内底部菜单示意，不是锚定触发位置的原生浮出菜单。主工作台低频技术操作（文本新建、导入修改、图标目录）位于“更多工具”内，原有 DOM ID 保持不变；项目卡片主操作为“打开项目”，次级操作位于卡片“更多”内；小屏（<=600px）通过“页面与分组”展开搜索与页面列表。

新建入口的 AI 提示词尚未创建项目；先与用户确认目标、名称和应用类型，再创建独立项目。若接手说明已给出现有用户项目 ID，则读取并更新该项目，不重复新建。主工作台右上图标可展开页面详情，点击体验默认收起；选择连线或逻辑节点会打开规则。