5.4 KiB
5.4 KiB
Glossary
| Term | Meaning | Notes |
|---|---|---|
ProjectType |
创建项目时选择且之后不可变的产品类型 | 当前值为 mini_game、mini_program、custom；缺少字段的旧配置按 custom 处理 |
BuildPreset |
平台内部用于构建和验收项目包的受控实现 | 不等于 ProjectType；第一期小游戏和小程序都使用 Vite preset |
| 受控发布模板 | Main 在新建可发布项目时生成的固定依赖、锁文件和可运行示例 | 保障一键提交的结构基线，但本地模板和 projectType 本身都不是授权边界 |
| Main-owned Release Build | Electron Main 对安全源码快照执行固定 npm 与项目 lockfile Vite 的本地构建 | Vite config/plugins 以桌面用户权限执行，不是 sandbox；Renderer 不获得路径、归档或 origin |
| Artifact Contract | 与 source/built 双归档一并上传的严格版本化清单 | 服务端把三者视为不可信输入并独立逐字节重算、校验 |
| Built Artifact Preflight | 上传前对最终 built snapshot 的同一内存字节执行桌面/移动 Electron WebContents/CDP 检查 | 可绕过 UX fail-fast；无可信 receipt，不复刻生产 opaque-origin |
| Trusted Runtime Verifier | 未来可将 runtime 检查绑定到精确构建产物/摘要的可信执行方 | 当前未实现；不可用客户端本地预检冒充 |
| Submission Binding | 客户端在云端接受上传后保存的精确 app/version/review/hash 绑定 | schema v2 只记录成功提交；落盘文件名暂保留 works-cloud-deploy.json 以兼容已安装数据 |
legacy_retired |
旧自动部署中间态迁移后的终止状态 | 不恢复 watcher、登录等待或自动上传；提示用户从项目配置重新提交 |
play_url |
服务端为已发布作品提供的公共播放地址 | 客户端优先使用并执行同源 HTTPS、精确 App 路径和版本状态校验 |
runtime_url |
play_url 上线期间的旧公共播放字段 |
仅保留一个客户端版本的兼容回退，稳定迁移后删除 |
| AI Design Workspace | 一个 AI 绘画设计项目 | 持有 Conversation 列表、生成任务和资产；不是单条对话 |
| AI Design Conversation | Workspace 内一条独立设计对话 | 持有消息、Brief、Quote、turnRevision 和服务端持久 Agent Session 绑定 |
| Persistent Conversation Session | 服务端为 Conversation 持久保存的 Agent Gateway Session | 客户端只重连事件流，不在注销或退出时 DELETE |
| Design Generation Quote | 服务端对当前最终 Prompt 与 generation parameters 返回的可确认报价 | 客户端可编辑后请求重报价，但不自行计算尺寸、供应商价格或设计点 |
| Prompt Museum | Canvas 的服务端驱动、只读策展灵感模块 | 展示经审核的预览、Prompt、分类和署名；不是社区，客户端不打包内容数据集 |
| Pending Museum Prompt | 用户点击“使用此 Prompt”后在 Renderer 进程内保存的一次性回填状态 | Canvas 消费后清除；只填充输入框，不自动发送或生成 |
| Learning Course Aggregate | Works 权益、进度和本地安装的产品级课程身份 | 由 courseId + contentHash 标识；大课的模块仍属于同一 aggregate |
| Frozen Learning Package | 下载后按字节数和 SHA-256 校验并原子安装的不可变课程 ZIP | 播放前重验；模块、场景、媒体与路径必须通过本地边界校验 |
| Learning Player Artifact | Makelore 打包的 OpenMAIC production Stage 静态产物 | CI 固定 URL/SHA-256，打包与运行时验证 artifact 清单；不依赖相邻源码仓库 |
| Learning Runtime Capability | 本地课堂可请求的固定 Works 联网能力 | 仅 Agent、ASR、quiz/PBL/评分等白名单路径；课程内容不能指定任意 URL、方法或身份 |
| Learning Account Partition | Electron Main 从当前认证身份派生的不透明本地分区键 | 隔离生成恢复、已安装课程、player registration 和异步生命周期；不把 Token 或原始账号标识用作授权 |
| Learning Player Session | 当前账号专属的 verified loopback production Stage 会话 | HTTP URL/cookie 使用短效 nonce；iframe bridge 使用精确 origin/source 和单文档生命周期；账号切换或注销后旧 URL、cookie 和注册资源失效 |
| Robot Provisioning | 让 Robot 获得目标 Wi-Fi 凭据并尝试联网的阶段 | 与云端 Activation、账号 Binding、协议在线是不同阶段；V1 由现有固件 Hotspot portal 完成 |
| Robot Activation | Robot 联网后向既有服务获取六位激活码的阶段 | 激活码由设备展示/播报给用户；Makelore 不生成该码 |
| Robot Binding | 用户把六位激活码和 Agent 提交到 Works Square，建立账号侧设备关系 | bound 不等于设备当前 online 或 protocol-ready |
| Guided Hotspot Binding | Makelore 已实现的 default-on 引导流程 | 串联页面内未认证热点扫描/显式连接、固定 Portal、恢复互联网和现有 Binding；不包含可信设备发现、家庭 Wi-Fi 代填、自动 claim 或固件修改 |
guidedHotspotBinding |
Electron Main 所有的本地 capability | Renderer 只读；默认 true，精确环境值 0 回滚为 false，读取失败时 Renderer 回退直接六位码 |
| Robot Hotspot Candidate | Main 最近一次扫描中符合开放 Xiaozhi-* 规则的短效连接候选 |
Renderer 只见不透明 ID、SSID、信号和 connected；不是设备身份，重扫/clear/过期/重启后失效 |