提供的能力
@nocobase/app-plugin-database-explorer 用于查看应用已配置的数据库连接、Collection、字段及物理表结构，适合开发和排查数据模型问题。它不提供建表、改表或编辑业务记录的操作。
插件提供查询 API 与客户端，结构浏览页面由应用组合。
使用场景与示例
示例：检查订单表字段
- 在应用接入的数据库浏览页选择订单所在连接。
- 找到订单 Collection，检查字段、关联和定义中的警告。
- 查看物理结构，确认数据库列与索引是否符合预期。
- 若需要变更，回到应用的数据库迁移处理；不要把浏览页当作迁移编辑器。
列表使用 pageToken 翻页。自行实现搜索时，应明确搜索当前页还是完整列表；DatabaseExplorerClient.allCollections() 可遍历所有页，达到遍历上限时会返回 truncated 标记。
开发提示词（交给当前应用目录中的 Coding Agent）：
请使用数据库浏览插件，为管理员增加数据库结构查看页。
复用 DatabaseExplorerClient 和 DATABASE_EXPLORER_ACCESS，展示连接、Collection 和按需加载的物理结构。
支持分页并提示遍历截断，不增加建表、改表或记录编辑功能。
验证无权用户、不可达连接、缺失 Collection，以及页面和 API 的一致授权。完成标志：授权管理员能查看逻辑与物理结构，无权用户不能直接调用查询接口。
重要原理与实现
以下是实现本例时的接入位置与预期界面变化；它们是开发说明，具体文件名沿用当前应用结构。
| 接入位置 | 代码或配置变化 | 界面与行为变化 |
|---|---|---|
| client/routes.ts 与浏览页面 | 组合连接、Collection、物理结构查询 | 新增按需展开的结构浏览入口 |
| 页面授权声明 | 复用 DATABASE_EXPLORER_ACCESS | 菜单与 API 使用同一访问条件 |
| 分页和错误状态 | 处理 pageToken、truncated 和查询失败 | 不把部分列表或失败展示成完整结果 |
接入与入口
在身份认证和权限管理之后注册 Client、Server 插件。插件提供 DatabaseExplorerClient 和查询接口，不自带数据库浏览页面；应用负责用这些能力接入页面。无需额外的插件业务表迁移。
页面和 API 使用同一个 page:database-explorer/access 权限。客户端可复用公开的 DATABASE_EXPLORER_ACCESS，避免菜单可见却无法调用接口。
浏览数据库结构
| 查询 | 接口 |
|---|---|
| 已配置的连接 | GET /api/databaseExplorer/connections |
| 连接内的 Collection | GET /api/databaseExplorer/connections/:connection/collections |
| Collection 定义与字段 | GET /api/databaseExplorer/connections/:connection/collections/:collection |
| 物理列、索引及约束 | 上述 Collection 地址追加 /physicalSchema |
连接列表展示名称、方言、默认连接和管理模式等结构信息，不返回连接密码、主机或数据库文件路径。逻辑定义与物理结构分开查询，按需打开物理详情即可。
AI 开发的约束与验证
本插件的开发约束
- 保留结构只读的能力边界，表结构修改继续走迁移。
- 展示连接摘要时不额外读取并暴露主机、密码或数据库文件路径。
- 对跨页查找、遍历上限与访问拒绝增加验证，不把第一页当作全部 Collection。
使用边界
插件自身没有写接口，但首次读取 managed 连接的 Collection 时，数据库框架可能初始化内部元数据及缓存版本表；不会因此修改业务表或业务记录。external 连接使用目录中的元数据。
检查管理员和无权限账号的访问，以及不可达连接、无效 Collection 和分页行为。具体错误字段以运行应用的 API 文档为准。
上述检查是接入后的验收要求，不表示本文已完成运行验证。让 Agent 报告实际改动、执行过的检查和未验证项；项目指引、Skills 与通用检查流程见持续开发应用和测试。
源码依据：插件公开入口与实现。