Developer Preview 0.3.0.dev2:本页介绍未改变的 SDK 0.2.0 基础契约。统一适配器、可选模拟运动及当前安装命令请参阅快速开始和软件包内文档。未启用真实硬件或生产集成。
安全、同意、保留与接收方
中文技术人工审核待完成。kit 仅提供有界公共数据协议及经审核的合成示例,不认证真实厂商、不发凭据、不注册生产设备,不提供私有应用/Core。外部的已认证主机负责所有者/会话身份、具体操作授权、同意、撤销、连接新鲜度、策略、接收方选择与结果发布。不得把这些对象、记忆、历史、grant 或 token 传给适配器。
两端严格校验;派发前与发布结果前重新核验能力、路由、接收方、会话及同意。有效 manifest、synthetic_only 标志或本地 PASS 都不是执行权限。设备和厂商的响应都必须视为不可信;拒绝额外字段、路由变化、错误 invocation/version、原始异常、媒体长度异常。主机可拒绝任何语法有效的请求。
麦克风、相机、传感器、录制在真实集成中需明确能力级同意及原生系统权限,采集前说明目的、数据、接收方、时长及撤销方式。扬声器需目标设备权限和单响应者仲裁。控制/状态/连接同样需具体能力和接收方权限。应用许可不能继承为云许可;标签必须由主机映射到已审核接收方。本版 manufacturer_cloud 只是合成标签,不联系任何云。未来云路径须单独披露运营者、目的地、地区、数据、目的、保留、法律条款、传输认证并取得授权,不得隐式云回退。
媒体仅内存生成、全部合成、不保留;Recording 的 retained_bytes=0。报告只有测试标识、状态、公共指纹与合成观察,不含真实采集。主机录制状态标志不能证明真实媒体已删除。未来存储需已批准时限、访问控制、接收方、删除/过期/撤销证据。外部主机必须在取得明确同意之前保持采集和录制同意关闭;证据中不要加入真实人声、面孔、个人资料、凭据或私人历史。
这些工具在本地执行 Python 代码,不提供 OS 安全沙箱,不能约束恶意代码或限制其文件系统及网络访问。Python -I 不是安全边界。仅使用经过审核的合成代码。禁止用此工具运行恶意、未经审核或专有的厂商二进制文件;实际代码必须经过独立沙箱设计与安全审核。本阶段不建设 OS 沙箱。
负面测试应覆盖重复 JSON 键、输入输出超限、未知字段/操作、原始错误、接收方/路由变更、过时 invocation/version、撤销/过期权限、缺失同意、云拒绝、驱动故障、资源占用、断线、超时、迟到回调、重复提交、关闭重开、固件/manifest 变化。不确定执行保持 unknown/no replay;不能因响应丢失自动重试物理动作。物理和安全验收必须有真实观察证据,mock 不可替代。