Skip to content

Latest commit

 

History

History
162 lines (88 loc) · 28.2 KB

README.md

File metadata and controls

162 lines (88 loc) · 28.2 KB

iOS 原生客户端

本地“自动化 → 使用组合包”支持触摸伴读灯、自定义JSON、逐模块绑定、60秒预演和明确启用。CompositionClient复用原网关会话与安全存储接口,先保存并回读完整原请求再单次条件创建;丢回执保持attempted,重启只查询,停用沿原自动化列表。后台、离页、离线、输入或相关设备变化清除证明。npm run test:composition:native检查共享向量、实际CompositionStore及真实网关跨进程恢复;宿主文件存储与SwiftUI语法检查不代表Keychain或完整iOS App运行。详见组合包合同。

本地“设置 → 音频 → 陪伴”支持自定义角色说明、实际声音和逐轮录音,默认四轮、十分钟。CompanionClient与#companion:space_id摘要账本复用原三阶段;后台/离页/离线清除内存历史,返回只GET,停止无需正文并清各轮文字。生成音频仍须独立授权播放。入口npm run test:companion:native检查共享账本、实际状态层及真实网关跨进程恢复,见原生合同。完整原生页面、生产安全存储与真实模型质量独立验收,实机跳过。

“设置 → AI 服务”展示当前五类能力、实际模型、部署修订和限制;“已配置,健康未检测”不表示模型可用。已配置条目可进入原自动化、对话、视觉或音频页面,仍需明确调用。后台、离页、离线或会话变化会清除目录,迟到响应不恢复旧入口;查询不创建推理任务,不持久保存目录。SDK使用try await gateway.aiCatalog(space: "space-demo"),严格合同见AI目录。统一检查入口为npm run test:ai-catalog:native,SwiftUI语法与宿主状态层检查不代表完整iOS应用运行。

静态配置的Zigbee开关复用家庭设备页现有电源控件与GatewayClient,不增加协议专用UI。npm run test:zigbee:onoff-native使用真实Rust/SQLite和软件NCP,检查Swift/Kotlin客户端库的完整读回证据、丢响应原键查询、客户端进程及网关重启零补发;宿主库联调与完整App运行分别验收。配置与范围见属性桥接合同。

Zigbee 来源接入

同页的“Zigbee 入网”支持选择协调器、填写1–120秒时长,核对IEEE后明确开放;关闭独立确认。ZigbeeClient使用origin#zigbee-operations保存并回读原请求,未知只查询原键,禁止换键延长未知窗口。已完成回执不可变化;后台、离页、离线或60秒过期清除核对,准备与取消零POST。共享合同与运行边界见入网管理合同。

本地“设置 → Zigbee 设备”支持选择已配置的协调器,发现已有邻居、读取端点,再查询支持的温湿度端点,核对厂商/型号后明确添加;也保留已知 IEEE/端点和设备编号的手填入口。发现和端点只在内存保留最长 60 秒,过期、输入/来源变化或暂停后清除,不创建设备或保存原请求。托管来源可先读取当前绑定再确认撤销;重新接入重新查询候选。配置接入的静态来源只展示,不接管或迁移。

ObservationClient(gateway:store:)复用当前HTTPS会话与Keychain适配器,独立origin#observation-operations最多保留128条完整原请求。保存并回读成功才POST;同键仅GET,未知同设备/来源阻止换键和换编号。后台、离线、离页、输入/模型/来源变化和60秒到期清除核对;状态层取消在途任务,迟到结果不恢复页面。原请求查询不会重新启用已撤销来源。

在仓库根目录执行node tools/test-observation-native.mjs ios,检查共享合同、实际ObservationStore、HomeStore类型、SwiftUI语法与工程文件;完整组合旅程为npm run test:zigbee:native,需要Swift、JDK21和Android SDK。详情见来源合同。宿主文件存储为夹具,不代表Keychain或iOS App运行;完整Xcode/iOS SDK的既有缺口保留,实机按用户要求跳过。

使用 Swift 6、SwiftUI 和 URLSession,最低 iOS 17。LimeIoT.xcodeproj 是可打开的 iPhone/iPad 应用工程,Package.swift 提供独立、可编译的 LimeIoTKit 客户端库。没有 WebView、跨平台 UI 框架或官网源码依赖。

应用提供家庭网关与云服务两类入口。NAS入口支持设备开关/亮度、状态和回执、事件/阈值规则预演/启用/停用、关联运行及退出;云入口支持独立授权、空间/设备与原操作。本地规则表单支持数值/布尔属性和模型动作,动作参数使用JSON,先预演再明确启用;单操作编辑保留完整比较/all/any条件树及毫秒冷却,多操作规则完整展示并可停用,编辑使用TUI或CLI/API。规则执行语义见合同,宿主软件入口为npm run test:rules:conditions:native和npm run test:rules:actions:native,不代表SwiftUI或实机验收。

“仅当”通过原生控件选择全部可read标量属性、比较方式和值,并添加/移除嵌套组合。ConditionEditor按模型单位精确解析、检查类型/值域和4层/32项限额,无损回填失败时禁止编辑原规则;取消不提交。GatewayClient先校验再预演,RuleProof核对两次修订、触发和完整条件/动作证据;当前条件未满足仍可明确启用等待新触发。执行记录显示原条件、观测及原因,不从当前状态重建历史。iOS整包与SwiftUI运行仍受既有Xcode/SDK条件限制。

NAS与云界面均按绑定模型解析动作,提供遥控方向键、应用启动及通用参数控件;Schema 1空动作模型保留属性界面。记录显示原按键/应用ID及完成范围,submitted只显示“输入已提交”;动作沿用耐久原键,丢响应后只查询原操作。应用ID仍须执行端发现和授权白名单,控件存在不表示真实电视适配器或TV Agent已实现。

仓库根目录 npm run test:actions:native 分别运行Swift/Kotlin宿主库、真实HTTP/MQTT与虚拟设备,需要Swift、JDK21和Android构建工具。云属性/动作旅程使用 npm run test:control:native,每端每个旅程验证丢响应/重启后原键恢复。结果与手机端上缺口见 实施进度。

自动化页支持“用一句话设置”:网关配置本地模型后生成草案,展示触发、全部动作、冷却和原文,预演通过后明确启用。生成前在 Keychain 只保存原空间与幂等键,写入失败不发送;丢失响应或应用重启后查询原记录,不自动重发。修改需求清空预演证明;模型未配置仍可手工设置。推理模型配置见NAS说明。

构建和连接

定时规则在“触发方式”选择“定时”,输入HH:MM、IANA时区与重复星期;支持单操作创建、完整回填、修改、取消和停用,毫秒冷却与条件树保持完整。GatewayClient从网关校验结果获取下一次发生时刻做预演,客户端不重复实现DST。软件入口为npm run test:rules:schedules:native;Swift宿主库与SwiftUI源码语法通过不代表完整iOS App构建或运行,缺少Xcode/iOS SDK的阻塞保留。语义见定时合同。

使用 Xcode 16 或更新版本打开 LimeIoT.xcodeproj,选择 iOS 模拟器或自己的签名团队后运行。命令行构建:

xcodebuild -project "LimeIoT.xcodeproj" -scheme LimeIoT \
  -sdk iphonesimulator -configuration Debug \
  -derivedDataPath "../../.dev/ios-derived" CODE_SIGNING_ALLOWED=NO build

输入 NAS 的精确 HTTPS Origin,例如 https://192.168.1.20:8443,不附带路径或末尾斜杠,然后输入安装目录中的所有者凭据。使用本地 CA 时,先在设备/模拟器安装并启用信任。应用不绕过 TLS,不接受任意证书。

会话保存在 Keychain,所有者原始凭据不长期保存。会话恢复需网关再次验证;退出撤销服务器会话。重启网关后需重新登录。控制前保存原操作的幂等身份,本地写入失败时不发送。响应丢失、代理5xx或响应无法解析时保留身份,重新登录后仍查询原操作,不在断网时排队发送新控制。设备操作界面当前显示最近100条,完整分页合同由API/CLI提供。

普通控制在发送前保存并回读完整原输入;GatewayClient.create及resolve(space:intent:)核对空间、键、设备、模型、期限和操作,confirmed另核对属性或动作证据。错误回执不清除原请求;SDK校验摘要格式,正式JCS摘要由Rust负责。共享向量位于tests/fixtures/commands/recovery.json,swift run ClientChecks执行30组合同检查。库检查与HomeStore类型检查不代表Keychain故障或完整App运行验收。

仓库根目录执行node tools/test-home-native-state.mjs ios,直接编译并运行实际HomeStore的六组宿主旅程,覆盖存储抛错/未真正保存时零POST、错误回执与404保留原字节、状态重建/退出后恢复、清理未保存及503离线禁写。HomeStore通过现有SessionStore、HTTPTransport和独立偏好存储注入;生产默认使用Keychain,在连接时创建URLSession传输实例。测试使用内存存储及HTTP夹具,不代表生产Keychain故障或完整SwiftUI运行。

NAS快照读取失败(包括HTTP 503)时保留上次观测,并禁用设备控制;只有再次成功读取快照后才恢复控制。该状态处理已在macOS宿主类型检查,iOS整包运行仍需完整Xcode与iOS SDK。

应用图标沿用官网已有品牌包;图标的专有许可范围见 品牌素材,其余客户端代码遵循仓库代码许可。

云入口状态

SwiftUI云入口已接入源码,仍需完整Xcode编译与手机验收。在连接页选择“云服务”,输入Console的精确HTTPS origin;它可以是私有控制面地址,不要求官方云已经发布。点击“登录”后显示8位授权码,再由“打开浏览器”进入同站Console,本人登录、输入码并明确批准。App前台每3秒查询,后台或离开云入口时取消轮询;网络/授权错误暂停轮询,使用“继续查询”或“结束本次登录”处理原请求。

Keychain适配器供NAS与云库复用,云记录使用独立的limeiot.control:v1:<origin>键。启动/返回前台时核实原会话,未完成授权沿用原证明;503保留材料,可用“恢复会话”再次核实。结束本次登录先请求服务端取消,确认后才清理材料。恢复/登录后选择空间,读取当前有效网关、设备分页与物模型;当前合同每空间仅一个有效网关,设备页校验绑定修订。云界面只提供实际已实现的设备能力,不调用NAS规则API。

独立ControlClient实现原生随机键/S256 PKCE、授权恢复、领取/验证/保存独立会话、取消、退出、空间/网关/设备分页/物模型读取和远程控制;协议见 原生授权。SessionStore必填,身份Token不交给界面。

界面先明确调用beginAuthorization()取得仅供用户查看的授权码和同站verificationUri,由系统浏览器批准后调用pollAuthorization()。库先核对当前Console主体、CSRF与期限,再保存材料;界面只取得状态和主体,不持有Token。原请求保存失败不发送,响应丢失沿用原证明,503保留会话,401清理;restoreSession()核实原身份,logout()仅结束子会话。库不自动打开浏览器、后台轮询或写重试,同一实例并发动作返回busy。

远程控制按prepareCommand保存完整原请求,再由submitCommand先保存发送标记后单次提交。响应丢失、进程重启或同键再次提交均只查原操作,404也不补发;resolveCommand(reconcile: true)显式核实原设备结果。记录绑定当前主体/空间,最多128条,退出后保留;forgetCommand允许明确放弃未尝试且无结果/拒绝的准备记录,或清理明确拒绝/终态。已尝试而结果未知的记录不能清除。结果区分unknown、accepted、dispatched和设备终态,confirmed须有匹配原请求的设备证据。SDK只验证摘要格式和连续性,Go/Rust负责正式规范化摘要。

CloudStore持有当前云任务,scenePhase转为非active或切离云入口时明确pause,取消按钮任务与轮询,迟到读取不恢复在线状态。准备存储期间暂停不会继续提交;前台恢复只读取已保存的原记录,未发送记录可明确放弃,已尝试记录继续查询。取消不能撤回已发出的网络请求。

npm run test:control:native已通过真实HTTPS/WSS、Go/MySQL、Rust网关、MQTT模拟设备、Chromium批准和私有文件存储夹具。两端分别验证未受信CA拒绝、会话恢复、远程响应丢失/Go重启后查询原操作、只创建一条设备命令及独立退出。报告标记native_remote=true、transport=https、native_app=false、hardware=false;测试专用CA适配器不改变生产信任。此证据属于库,新增SwiftUI云页面、系统浏览器按钮、Keychain与前后台行为仍须在完整App中验收。

结构和验证

路径 职责
Sources/LimeIoTKit 类型化合同、HTTPS/会话、传输适配和网关操作
Sources/LimeIoTKit/ControlClient.swift 独立控制面授权/会话、读取及远程原操作,不复用NAS身份
App/HomeStore.swift 当前会话、快照、操作恢复和界面状态
App/CloudStore.swift 云授权、前台轮询、空间/绑定投影与原操作状态
App/CloudViews.swift SwiftUI云登录、设备、操作记录与设置
App/SecureStore.swift Keychain 存储适配
App/Views.swift 原生设备、规则、运行和设置界面
Tests/LimeIoTKitTests 可独立运行的合同与真实网关检查

在本目录执行 swift run ClientChecks 检查4组本地、4组控制面授权、4组远程、3组动作及7组OTA合同,覆盖整数编码、HTTPS、凭据/CSRF、原证明保存与恢复、S256、非法材料/主体拒绝、取消/退出,以及远程存储失败不发送、旧键只读、未发送明确放弃、拒绝/未知/终态清理和设备证据验证。无完整Xcode的Swift命令行环境也能运行;它不是iOS界面编译。真实控制面库检查在仓库根目录执行npm run test:control:native,需要Go、Docker/MySQL8.4、Swift、JDK21和Chromium。

在仓库根目录执行npm run test:clients:state -- ios,以macOS宿主编译实际CloudStore与Keychain适配源码,使用内存存储/HTTP夹具检查5组状态:后台不轮询及取消后恢复原授权、丢响应/重建客户端后未知操作不重复创建、绑定修订及空间切换隔离、准备存储期间暂停零提交与明确放弃、迟到刷新不恢复online。它不调用真实Keychain或系统浏览器,不编译SwiftUI界面。报告为.dev/native-state-checks/ios.json;Xcode工程已包含两个云源码文件。

在仓库根目录执行 npm run test:ios,会启动独立 Broker、网关、模拟设备与假 Ollama 提供方,验证会话、亮度回执、原操作查询、草案幂等/无自动部署/预演/明确启用、规则生命周期和退出。提供方仅验证 HTTP 合同,不代表模型质量。本机已通过库编译、4项合同检查及真实网关联调、状态管理与Keychain适配的macOS类型检查,以及全部Swift语法检查;没有完整Xcode/iOS SDK,尚未编译iOS整包。模拟器/实机布局、Keychain行为、局域网授权与前后台切换仍须通过 Xcode 和设备验证。

环境读数

规则库支持与事件互斥的属性阈值触发、模型单位、上升/下降及滞回;旧事件规则编码不变。simulate在属性规则下接收包含previous/current两份观测的JSON对象,预演不修改运行基线或创建设备命令。SwiftUI可创建/编辑单操作阈值规则、完整展示及停用;ThresholdEditor按十进制解析常用单位,不截断超精度输入,并生成标记为simulation.ui的预演采样。4组触发/表单合同与实际HTTP读取/预演入口见根目录npm run test:rules:thresholds。库和SwiftUI语法检查不代表iOS整包运行;缺少完整Xcode/iOS SDK的既有阻塞保留。

LimeIoTKit.Property兼容可选的semantic_id/unit,按正式环境模型显示温度和相对湿度,两位小数;旧属性继续按原值显示。NAS及云设备页面将只读属性显示为文本,过期样本保留原值并标明“已过期”。

swift run ClientChecks包含3组环境元数据/显示检查。根目录node --test tests/environment-node.test.mjs在真实Broker/Rust/SQLite三节点链路中执行Swift实际HTTP读取;该旅程还需要Android工具链。库检查和SwiftUI语法检查不代表iOS整包或端上页面通过,完整Xcode/iOS SDK缺失的限制仍保留,实机按用户要求跳过。

本地音频客户端库

MediaClient(gateway:store:)使用现有NAS所有者会话与必填SessionStore,提供list(space:)、submit(space:change:key:)、records(space:)和resolve(space:key:)。MediaChanges.upload(bytes:retainSeconds:)接受最多4MiB、60秒的16位PCM WAV;grant需要当前执行绑定修订,revoke与delete分别撤销授权和删除正文。接口消费媒体ID,不取得下载URL或令牌,上传/授权不自动播放。

首次POST前在origin#media-operations保存并回读摘要原记录,最多128项;不保存音频正文。同键同参只查询原键,404仍保持未知,同类未决操作阻止换键重发。重建客户端继续读取原记录;退出不会删除媒体记录,存储损坏、移除或保存失败阻止新写。历史授权回执的issued_in_process可随网关重启变化,库仍核对其余原决定;当前授权资格以列表和网关执行时检查为准。媒体与OTA共用有界安全整数JSON解析/规范化工具,各自独立校验领域合同。

家庭网关“设置 → 音频”提供系统WAV文件选择、保留时间、当前已绑定音箱、逐次明确授权、撤销、删除确认与原操作查询。文件只在内存中保留,有界读取最多4MiB+1字节,离线、离开页面或进入后台时清除文件、确认与删除意图。候选通过targets(space:)逐项核对当前执行绑定,兼容候选不表示已授权;上传/授权后在设备页另行播放。云入口不增加媒体权限。

npm run test:media:native检查库;npm run test:media:native:state编译运行实际MediaStore与文件读取器,通过真实Rust/SQLite/MQTT及软件音箱检查丢回执、明确授权/播放、客户端进程和网关重启、撤销/删除与原键不复活正文。另查本地无副作用、确认失效、取消保存后零POST、离线禁写和401。恢复文件为宿主夹具,不代替Keychain、系统文件选择器或SwiftUI运行。完整Xcode/iOS SDK缺失的限制保留,实机按用户要求跳过。

有限麦克风录音

“设置 → 音频 → 上传音频”支持明确开始、完成和取消录音。AppleRecordingInput在系统许可后使用AVAudioEngine与AVAudioConverter,RecordingStore同步写入有界内存缓冲,PcmRecording输出16 kHz单声道PCM16 WAV;最多60秒、960000帧,不补静音或创建临时录音文件。完成先关闭采音,再交给MediaStore独立保留,另行明确上传;不自动调用模型、授权或播放。后台、离页、断线、取消、音频路由变化或系统中断清除未上传录音,迟到权限和回调不恢复旧状态。工程声明麦克风用途,没有后台采音模式。

根目录node tools/test-recording-native.mjs ios检查实际状态层、AVFoundation独立解码、与JS逐字节一致及既有媒体回归;完整npm run test:recording:native另查两端真实Rust/SQLite上传、丢HTTP回执及新进程/网关重启只GET原键。适配器以macOS SDK编译,SwiftUI只作语法/工程检查,测试不打开系统麦克风。完整Xcode/iOS SDK缺失的限制保留,Keychain、iOS系统采音与完整App运行另验;同页分步组合见下段,统一回合见下方新增入口;实机按要求跳过。正式边界见原生录音合同。

在同页识别录音后,点击“带入新对话”,核对问题后“发送”;回答通过“带入语音合成”填入完整文本,再明确“生成音频”。两处带入只改当前内存草稿,不发请求;提问使用新对话上下文,超长回答不截断,未决或离线时不替换输入。合成成功后继续独立授权并在设备页播放。后台/离页清文,新进程查询各原键,不自动推进或重播。检查入口npm run test:voice-handoff:native,正式边界见原生分步组合。

“设置 → 音频 → 语音对话”另提供统一回合:选择已上传录音和声音,明确开始后依次调用ASR、文字与TTS;原任务共用v1摘要账本和5分钟期限。后台、离页或断网取消推进并清文,返回后查询原回合,明确继续才创建未创建阶段;停止需要确认,丢回执后只GET。生成音频须另行选择、授权和播放。SDK为VoiceTurnClient,检查入口npm run test:voice-turns:native,详见原生统一回合。完整App、系统采音和真实模型质量保持独立验收。

本地文字转语音库

SpeechClient(gateway:store:)复用NAS会话,提供capabilities、submit、records、resolve和discard。SpeechRequests.input校验文本、声音、保留时间与截止时间,并将时间规范为UTC毫秒。独立origin#speech-syntheses最多保存128条摘要记录,每条最多8个明确放弃意图;不保存文本。首次提交和新放弃意图均先保存并回读,同键仅GET,结果未知继续阻止换键生成。响应必须匹配原摘要,部署与任务身份不得漂移,终态不得回退。

根目录npm run test:speech:native:contract检查共享JS/Schema向量、Swift 10组与Kotlin 10项宿主行为。Swift检查也由swift run ClientChecks执行。保存调用取消或丢失确认后,同一客户端只接受上次观测或自己预期写入的完整字节,其他变化仍拒绝;恢复查询不会重新POST。

“设置 → 音频 → 文字转语音”已接入SpeechStore和SwiftUI:填写文本、声音和保留时间后生成;running自动查询,unknown继续占用,放弃输出须再次确认。成功刷新媒体并选中对应编号,授权保持未勾选。进入后台、离开页面、离线或会话失效时清除文本与确认,迟到响应不更新页面;前台恢复只查原任务。

npm run test:speech:native:state运行实际状态层、既有媒体回归及两端真实Rust/SQLite/MQTT旅程,覆盖丢回执、独立授权与软件音箱Range播放、新进程及网关重启、unknown占用和明确放弃。HTTP提供方、音箱与恢复文件为夹具;SwiftUI完成语法与工程引用检查,HomeStore类型检查独立执行,完整iOS构建、Keychain及系统界面运行仍待验收。

本地语音识别

“设置 → 音频 → 语音识别”接入 TranscriptionStore 与 SwiftUI。先上传音频,读取识别状态,选择音频及语言后开始。running自动查询,unknown阻止换键,放弃输出需要确认。后台、离开、断线、会话失效或期限经过后清除识别正文;返回前台只恢复任务元数据,已完成正文通过明确查询读取。

TranscriptionClient(gateway:store:) 使用现有会话和安全存储端口;TranscriptionRequests.input(mediaId:mediaDigest:language:expiresAt:) 固定源录音及摘要。origin#audio-transcriptions 只保存原请求、去正文 observation 和放弃意图,最多128条;不保存识别文本,也不伪造服务器清除标记。records 无正文,submit/resolve 当次返回可带文本,网络响应必须核对UTF-8摘要、期限及不可变任务身份。

根目录 npm run test:transcription:native:contract 检查共享向量及两端库,npm run test:transcription:native:state 编译实际状态层并验证真实网关恢复、源删除清文和零设备副作用。恢复文件和识别提供方为宿主夹具,SwiftUI仅检查语法及工程引用;完整iOS运行、Keychain与识别质量分别验收,实机按用户要求跳过。

本地图片观察

VisionClient(gateway:store:) 接入正式视觉合同,VisionRequests.input(bytes:contentType:prompt:retainSeconds:expiresAt:) 构造单张PNG/JPEG请求。图片最大2 MiB,问题最多512个Unicode标量;客户端检查大小、格式标记和问题,网关完成静态图片解码及1024像素边长校验。

本机 origin#vision-observations 只保存摘要、去正文观测与清除意图。原键重复只查询,unknown阻止换键;discard 可放弃未完成输出或清除成功正文,重复同一意图只GET。records 无正文,submit/resolve 当次返回可带文本,调用方须按期限及页面生命周期清除内存,不将结果用于自动控制。

“设置 → 图片观察”已接SwiftUI页面与VisionStore,通过系统文件导入选择PNG/JPEG,后台有界读取最多2 MiB并构造请求。提交后清图片与问题;后台、离线、离开、退出或会话切换清正文,迟到响应不回填。前台刷新只恢复元数据,成功正文需明确查询;放弃和清除均需确认,取消零POST。

npm run test:vision:native:contract 验证共享合同,npm run test:vision:native 验证宿主库,npm run test:vision:native:state 编译实际状态层并运行真实网关恢复和共享文件读取回归。SwiftUI作语法及工程装配检查,系统图片选择、Keychain与完整iOS运行另验;提供方为夹具,真实模型质量独立验收。

本地固件升级

家庭网关“设置 → 固件升级”使用 OtaClient、App/FirmwareStore.swift 和 App/FirmwareViews.swift。独立填写并核对固件公钥指纹,再建立10分钟计划;读取当前完整任务后明确批准,再次读取后开始安装。unknown只查询原设备结果,不重复安装。云服务入口不提供OTA。

必填安全存储以 origin#ota-operations 与会话、模型和云操作隔离,最多128项。先保存并回读完整原请求,再单次POST;跨实例互斥、损坏/移除拒绝、404保持未知、同设备未知请求阻止换键。退出和重新登录不删除原记录。历史applied是已保存的操作决定,当前任务的匹配设备证据才表示升级终态。签名与兼容策略由Rust统一执行。

仓库根目录 npm run test:ota:native 验证库,npm run test:ota:native:state 用真实Rust/SQLite/MQTT与内存存储编译并运行实际FirmwareStore,检查取消、批准不安装、逐次核对、丢响应、重新登录和重启恢复。需要两端工具链;它不编译SwiftUI或运行Keychain/iOS App。iOS整包仍受完整Xcode/iOS SDK缺失阻塞,实机按用户要求跳过。

本地文字对话

“设置 → 本地对话”使用 TextGenerationStore 与 TextGenerationClient(gateway:store:),遵循正式文字合同。TextGenerationRequests.input(messages:instructions:retainSeconds:expiresAt:) 构造有界上下文;当前页面成功后可继续提问,最早回答期限约束整个上下文。

本机 origin#text-generations 仅保存原输入摘要、去正文观测和明确清除意图。后台、离页、离线、退出或期限经过时清除本页消息;前台只读取元数据,完成回答需要明确查询。原键只 GET,404 与 unknown 均不视为可以重发;明确放弃不保证外部模型停止计算。原请求尚无观测时保留 unresolved,不能自动删除或换键。

运行 npm run test:text:native:state 检查实际状态层及 Android 构建;运行 npm run test:text:native 与真实 Rust 网关验证两端宿主恢复。SwiftUI 仅作语法和工程装配检查;缺少完整 Xcode/iOS SDK,完整 App、Keychain 和真实模型效果独立验收。实机按要求跳过。