引导 + 配置协议

目的:在 CLI、macOS 应用和 Web UI 之间共享引导和配置界面。

组件

  • Wizard 引擎(共享 Session + Prompt + 引导状态)。
  • CLI 引导使用与 UI 客户端相同的 Wizard 流程。
  • Gateway RPC 暴露 Wizard + 配置架构端点。
  • macOS 引导使用 Wizard 步骤模型。
  • Web UI 根据 JSON Schema + UI 提示渲染配置表单。

Gateway RPC

  • wizard.start 参数:{ mode?: "local"|"remote", workspace?: string }
  • wizard.next 参数:{ sessionId, answer?: { stepId, value? } }
  • wizard.cancel 参数:{ sessionId }
  • wizard.status 参数:{ sessionId }
  • config.schema 参数:{}

响应格式

  • Wizard:{ sessionId, done, step?, status?, error? }
  • Config schema:{ schema, uiHints, version, generatedAt }

UI 提示

  • uiHints 按路径索引;可选的元数据(label/help/group/order/advanced/sensitive/placeholder)。
  • 敏感字段渲染为密码输入框;没有脱敏层。
  • 不支持的架构节点会回退到原始 JSON 编辑器。

说明

  • 本文档是跟踪引导/配置协议重构的唯一地方。