Setup 向导
侧边栏的 Setup 向导 把「装 CLI → 装 skill → 登录」这几步串成引导式流程,全部状态实时回显。
打开向导
在侧边栏顶部工具栏点击 「本地 CLI 设置」 即可进入;再次点击返回编辑视图。
四个步骤
1. 检测(Detect)
向导会调用 Gateway 的 /setup/detect,逐个 provider 报告:
- CLI 是否已安装(以及版本)
- 是否已登录
对应命令行验证:
bash
curl -XPOST http://127.0.0.1:19836/setup/detect -d '{"providers":["dingtalk"]}'2. 安装缺失 CLI(Install)
对未安装的 provider,点击「安装」触发 /setup/install,安装过程输出经 SSE 流式回显。
3. 安装 skill
部分 provider(如飞书)需要额外安装 skill 才能启用能力,向导会在同一流程内引导完成。
4. OAuth 登录(Login)
点击「登录」触发 /setup/login:
- Gateway 调起官方 CLI 的登录(如
dws auth login); - 授权 URL 会流式回传到侧边栏,点击在浏览器完成授权;
- 登录成功后状态标签变为「已登录」。
状态标签
每个 provider 一行,用标签展示:已安装 / 未安装、已登录 / 未登录。绿色代表就绪,灰/黄代表需要处理。
异常处理
| 情况 | 表现与处理 |
|---|---|
| CLI 未安装 | 提示并提供「安装」按钮 |
| 未登录 | 提示并提供「登录」按钮 |
| 授权超时 | 向导报告超时,可重新发起登录 |