跳转到主要内容
state API 为你的扩展提供对 Aether 公开应用状态的读写访问。可用它预填输入栏、切换 Agent 模式、更改所选模型,或管理 Skill 选择 — 全部通过在 Script Mods 中一致可用的基于路径的接口完成。

API 参考

支持的状态路径

state.get

读取完整公开状态对象,或传入路径字符串读取特定字段。解析后的值在响应的 value 字段中返回:
不带参数调用 state.get() 会将整个公开状态快照放在 value 中返回。传入路径字符串则在 value 中返回该路径上的值。

state.patch

写入单个状态路径。patch 是单操作事务的便捷简写:

state.transaction

在一次请求中应用多个状态变更。操作按数组顺序应用:
省略 op 时,每个操作默认为 op: "set"。传入 op: "remove" 可清除受支持的路径。selected_model_keyscreen 需要有效的替换值,不能被移除:
事务按顺序应用操作。它们提供统一的变更 API,而不是跨无关 Android 仓库的数据库级回滚。若某个操作失败,同一事务中更早的操作不会被撤销。
需要一次更新多个路径时,优先使用 state.transaction 而非多次 state.patch。批量变更可将相关状态更新保持在单次宿主请求中。