29 lines
4.9 KiB
Markdown
29 lines
4.9 KiB
Markdown
# Glossary
|
||
|
||
| Term | Meaning | Notes |
|
||
|---|---|---|
|
||
| `ProjectType` | 项目配置中持有且之后不可变的内部产品类型 | 普通新建不展示选择并默认 `interactive_ai_app`；既有 `custom` 继续兼容，历史 `mini_game` / `mini_program` 读取时归一为前者，缺少字段按 `custom` 处理 |
|
||
| `BuildPreset` | 平台内部用于构建和验收项目包的受控实现 | 不等于 `ProjectType` 或 Scaffold 状态；交互式 AI 应用使用固定 Vite preset |
|
||
| Official Project Plugin | 由 MakeLore 代码所有、以项目启用作为生效范围的官方 Plugin | 当前闭合集合为 `makelore.data-service`、`makelore.game-resource`、`makelore.project-scaffold`；满足既有交付/获取条件并启用项目后自动进入每个 parent Agent，不使用伙伴分配，child 为空 |
|
||
| Project Scaffold Skill | 官方 bundled Marketplace Plugin `makelore.project-scaffold` 中由用户明确调用、独立版本化的起步文件生成与发布准备度指导 | `.mjs` 只来自固定客户端资源；不覆盖路径、不安装/构建/上传/提审；项目创建服务和 Main/Works 发布权威不属于该 Skill |
|
||
| 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 绘画设计项目 | 持有一个 current Direction、Current Specification、持久 Agent Session、conversation timeline、生成任务和资产 |
|
||
| AI Design Conversation Timeline | Workspace 内的交互历史 | 不是可独立创建/选择的语义权威；Current Specification 才是生成真值 |
|
||
| Persistent Design Session | 服务端为 Workspace current Direction 持久保存的 Agent Gateway Session | 客户端只重连事件流，不在注销或退出时 DELETE |
|
||
| Design Generation Quote | 服务端针对精确 Current Specification revision 编译的 immutable 可确认报价 | 客户端编辑后必须请求新 Quote，只确认 Quote ID，不自行计算 Provider 参数或 Token Points |
|
||
| Prompt Museum | 已退出当前产品面的历史策展模块 | Canvas 无入口，App 不挂载/打包其页面，历史 URL 重定向到 Canvas；Main API/auth/media 与 DTO 仅 dormant 保留 |
|
||
| Reference Alias | Active Canvas Prompt 中连续的 `@图片N` 公共引用标记 | 对应稳定 reference ID 与真实 Workspace Asset binding；Prompt 表达用途，binding row 只管理文件身份与状态 |
|
||
| 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/过期/重启后失效 |
|