数据源
Scopwis 把数据访问和分析执行分开。OpenDAL 与 provider adapter 暴露经过授权的对象或表；DataFusion 与已注册分析方法只在这些已授权输入上执行有界计算。
数据源类型
一个 source 可以声明一个或多个访问模式：
- batch —— 按需读取文件、对象、快照或表格数据；
- realtime —— provider 表或新鲜快照；
- stream —— Server 管理的有界事件窗口。
目录只是权限感知后的视图，不代表每个条目都天然可查。读取 metadata 或数据时，Server 会再次校验访问权。
管理数据源
通过 设置 → 数据源 创建和查看受治理 source。凭据始终留在 Server。
新建数据源时，在同一页面选择本地文件、在线存储、数据库、事件流或内置公共数据。在线源与数据库的位置和凭据一起填写、一次保存，服务端自动加密连接配置；也可复用已有连接。在「已保存连接」中管理删除和 Agent 接入权限，无需手工创建 Profile ID。
数据库适配器发现实际授权的 Schema 和表，将完整只读快照接入相同分析链路。每个源上限为 32 张表、每表 256 列、总计 100000 行和 32 MiB；超限刷新会失败并保留上一份已验证快照，大数据源请选择更少的表。SQLite / DuckDB 文件必须已存在于服务端数据根目录下。
可用数据库引擎包括 PostgreSQL、MySQL、SQLite、DuckDB、SQL Server、ClickHouse、BigQuery、Snowflake、Trino、Presto 和 Databricks SQL。兼容 PostgreSQL 或 MySQL 协议的引擎复用相同连接字段；其他已授权数据库与湖仓也可经 Trino connector 进入相同只读链路。表与视图目录均来自实际账户权限。
可分析文件包括 CSV、TSV、JSON 数组、NDJSON / JSONL、Parquet、Avro、ORC、Arrow IPC file / stream / Feather V2、Excel XLSX / XLSM / XLS / XLSB 与 ODS。多个工作表时，Agent 先列出真实工作表名称供选择，每张表都是独立分析目标。工作簿需唯一文字列标题，只读取保存的值，不执行宏或公式。编码文件上限为 64 MiB，工作簿、ORC 的展开大小及标准化输出也有明确预算。界面仅展示服务端确实具有接入适配器的引擎。
保存、安装和重连进行中会禁用重复操作。切换设置分类后，旧请求的结果不会清空当前草稿或覆盖新分类的加载状态；已经发送的服务端操作仍可能完成，回到对应分类刷新后可查看实际结果。
分析指定对象
从“分析”工作区或桌面导航打开数据对象浏览器，选择数据源并搜索对象清单。选择对象后，桌面显示检查面板，窄屏进入详情页。检查对象后通过明确的分析动作启动；仅选择对象不会开始运行。Scopwis 会把明确的 source ID 和 object path 交给 Agent。
有些 object store 无法列目录，但允许按已知路径直接读取。此时，只要路径是你明确给出的且 source 已授权，即使 discovery 返回空对象清单，也仍然可以检查 metadata。provider-backed relation 更严格：relation 必须在 discovery 中明确出现后才能检查。
外部能力与 MCP
MCP / 外部能力在设置中连接，并采用 probe-first、commit-last 流程。只有宿主批准的 research-read tool 才会进入 Agent。远端 description 或 readOnlyHint 不能替代本地授权。
外部返回的表格结果可以被物化为有界 DatasetSnapshot，之后进入和原生数据相同的 query / mining / evidence 链路。
MCP 认证
按 MCP 服务端提供的认证方式选择：
| 方式 | 配置内容 |
|---|---|
| 无认证 | 仅用于服务端明确无需凭据的连接。 |
| Bearer token | 填写访问令牌。 |
| HTTP Basic | 填写用户名与密码。 |
| 双向 TLS | 粘贴 PEM 格式的客户端证书链与私钥。可选填写私有服务端 CA。Endpoint 必须使用 HTTPS，始终保留证书与 hostname 验证。 |
| API key 请求头 | 填写供应商指定的请求头名称（例如 X-API-Key）与 API key。 |
| OAuth 浏览器登录（S256 PKCE） | 填写颁发者、授权和令牌端点、Client ID、scopes，以及公开客户端或密钥认证。注册 Scopwis 的公开回调 /api/v1/capabilities/oauth/callback；在浏览器完成授权后审核工具。 |
| OAuth 2.0 client credentials | 填写 Token endpoint、Client ID、Client Secret、可选的空格分隔 scope，以及服务端要求的 client_secret_basic 或 client_secret_post 方式。 |
先点击 测试连接，再检查、保存工具目录。测试会实际执行带认证的初始化和工具发现。更新凭据也会先验证工具发现，验证成功后才保存；移除凭据会明确进入需要重连的状态。
凭据在 Server 加密保存，不会出现在 manifest 或 Agent 上下文中。OAuth client credentials 每次 MCP 操作都会获取绑定目标资源的新 Bearer token。客户端凭据用于机器身份。浏览器登录使用独立的 Authorization Code + S256 PKCE 模式，令牌留在服务端；连接到期后重新登录。提供方省略 expires_in 时本地复用期限为一小时，声明更长有效期时最多复用 24 小时。暂未实现刷新令牌、自动授权服务发现和 JWT assertion。
GitHub 登录在 设置 → 账户 配置，详见配置。
关键边界
- 凭据不会进入 Agent observation。
- 知道 source ID 或 object path 本身不等于有权限。
- 查询只读且类型化。
- 有界 stream window 不能被当成完整历史。
- reconnect / credential 状态是显式的；持久化读取失败不能伪装成空列表。
- source 后续刷新或删除，也不会篡改旧 artifact。