CLI / TUI

scopwis 二进制同时提供命令行工作流和终端 UI。它与 Flutter 客户端使用同一套 Bootstrap、认证、Agent、数据源和报表协议。

Endpoint 与登录

scopwis config get api
scopwis config set api https://api.example.com
scopwis auth login
scopwis auth status
scopwis doctor

交互式登录会打开系统浏览器，本地凭据存储中只保存最终的 Scopwis session。

Endpoint 优先级：

--api → SCOPWIS_API_BASE → persisted config → http://127.0.0.1:3000

公开 endpoint 要求 HTTPS；loopback 开发允许 HTTP。

产品命令

scopwis tui
scopwis chat "What data is available?"
scopwis sources
scopwis objects <source_id>
scopwis reports validate examples/specs/sales-dashboard.json

CLI 会在受保护请求前协商 capability。Agent 优先使用 task protocol，并在有界重试期间保持同一个 task ID；临时 polling 错误不会重新创建模型任务。

诊断

scopwis doctor

Doctor 会检查 endpoint 解析、网络可达性、Bootstrap 兼容、认证、凭据存储、Server/CLI 版本、capability 和 terminal 支持。

退出登录

scopwis auth logout

logout 会先请求 Server 撤销 session，再删除本地 credential。无法确认远端撤销时，不会假装“安全退出成功”。