defineBackend({api,setup({host})}) 注册后台。setup 返回 handlers、可选 chat 和 stop。方法输入输出由 Zod 契约验证;流式方法返回 AsyncIterable,CallContext 包含 signal、requestId 与可选 viewId。
host.paths 提供 data/cache/logs。应用使用 Bun SQLite 或文件保存业务数据,不写入不可变安装目录。host.models 提供目录、默认模型和 Responses;host.application.setSummary(snapshot | null) 完整替换摘要,host.application.notifyDataChanged() 独立通知当前运行代的页面;host.ui 提供定向 Toast/确认。
chat 的键匹配 manifest 聊天 ID。处理器取得 message、signal、reply,调用 reply.complete({text}) 持久提交最终回复。手机入口没有 viewId,不能等待页面确认弹窗。
stop 关闭数据库、定时器和业务资源。宿主先取消请求,再给清理期限,最后终止进程组。不要把进程独立误认为系统权限沙箱。
摘要是派生内容:业务写入提交后通知页面并发布摘要,捕获摘要错误以免误报业务写入失败。页面订阅 dataChanged 和 reconnected 后重新读取业务数据;摘要更新本身不会触发 dataChanged。详见应用摘要。
SDK 0.8.0 的模型 API 已采用具体请求与事件类型,输入消息必须包含 type: "message";response.output_text.delta 分支中的 delta 为 string,response.completed 分支中的 response 为完整协议资源。失败抛出的 ResponseStreamError.event 保留原始失败详情。方法签名仍为 models.responses(request, { connectionId, signal });支持与验证范围见模型与账号。