入门 + 配置协议
入门 + 配置协议
目的:跨 CLI、macOS 应用和 Web UI 的共享入门 + 配置表面。
组件
- 向导引擎(共享会话 + 提示 + 入门状态)。
- CLI 入门使用与 UI 客户端相同的向导流程。
- 网关 RPC 公开向导 + 配置架构端点。
- macOS 入门使用向导步骤模型。
- Web UI 从 JSON Schema + UI 提示呈现配置表单。
网关 RPC
wizard.start参数:{ mode?: "local"|"remote", workspace?: string }wizard.next参数:{ sessionId, answer?: { stepId, value? } }wizard.cancel参数:{ sessionId }wizard.status参数:{ sessionId }config.schema参数:{}
响应(形状)
- 向导:
{ sessionId, done, step?, status?, error? } - 配置架构:
{ schema, uiHints, version, generatedAt }
UI 提示
uiHints按路径键入;可选元数据(label/help/group/order/advanced/sensitive/placeholder)。- 敏感字段呈现为密码输入;无编辑层。
- 不支持的架构节点回退到原始 JSON 编辑器。
注意事项
- 本文档是跟踪入门/配置协议重构的唯一位置。