STAC Browser 5.0.0 不只是一次前端依赖更新。它把目录浏览器从 Vue 2 迁到 Vue 3，并同时改变了检索、插件、配置和几何显示能力。对维护遥感目录门户的团队，最大的风险不在“页面能否打开”，而在升级后检索参数、配置继承、跨日期线几何和认证重试是否仍保持原有语义。
可核查事实
- Radiant Earth 于 2026 年 7 月 31 日发布 STAC Browser v5.0.0。
- 发布说明将 v5 标为 breaking release，要求升级前更新配置文件，并检查当前版本到目标版本之间的全部 changelog。
- v5 从 Vue 2 迁移至 Vue 3，并采用 Vite、Bootstrap 5 及更新的国际化和状态库。
- 版本加入 dark mode 和用于自定义 widgets 的 plugin system。
- 新增手工 bounding-box 搜索输入。
- CQL2/Queryables 扩展为支持否定、高级比较和数组操作符。
- 新增 free-text 与 extent-aware collection search，并可配置默认排序与 preferred assets。
- 发布说明列出 antimeridian-safe geometries 和认证重试改进。
config.js与相关配置需要复查；cardViewSort、getBrowserPath、DYNAMIC_CONFIG等选项或内部 API 在预发布期间已更名或移除。- v5 增加 Featured widget、条件显示 widget，以及可配置哪些 relation type 用于 STAC 导航或应被隐藏的
relationTypes.config.js。
核心机制：目录浏览器把发现、过滤和资产呈现连成一条链
STAC Browser 是数据目录的交互层。用户通过集合搜索、空间范围、时间和属性过滤找到项，再查看资产、缩略图和地图结果。v5 的变化触及这条链的多个位置：extent-aware 搜索与 bbox 输入改变空间检索入口；CQL2 扩展改变过滤表达能力；preferred assets 和排序影响用户最先看到的内容；反日期线安全几何影响全球数据的地图正确性。
因此升级不能只用一套本地小范围数据验证。至少要覆盖跨日期线 AOI、没有空间范围的集合、含数组属性的 Queryables、需要登录的目录、带 alternate/thumbnail 资产的项，以及自定义 widget。任何一个环节的配置迁移失败，都可能让浏览器看起来正常却漏掉数据、显示错误区域或暴露错误资产。
GIS 场景
公开影像门户。 为科研或公众提供 Sentinel、气候或专题数据时，free-text 与范围感知集合搜索能降低发现门槛，但搜索结果必须保留集合、时间、许可和空间覆盖。
机构私有目录。 有认证重试和自定义导航关系的 STAC 部署，应把配置文件与身份流程一起回归，不能把 URL 修正成功视为获得了正确数据权限。
全球专题数据。 反日期线附近的海洋、岛屿与航线数据是几何渲染的边界案例；应以真实 AOI 验证地图、bbox、过滤结果和分享链接一致。
技术路径：六项升级验收
- 从当前部署版本逐段阅读 changelog，列出被移除、改名或行为改变的配置和 API。
- 将现有
config.js、样式变量、widget 定义和 relation type 规则做版本化备份，再按 v5 配置重建。 - 对集合搜索、bbox、时间、CQL2 比较/否定/数组过滤分别保存升级前后的请求与结果集。
- 用跨日期线、极区、全局范围、空结果和同名集合测试几何显示与 URL 分享。
- 对认证过期、重试、错误 self link/尾随斜杠和 alternate/thumbnail 资产进行端到端测试。
- 先在镜像目录灰度启用插件和新 widget，记录前端错误、查询耗时与无结果率，再替换生产入口。
检查清单
- 是否完成从当前版本到 v5 的全部 changelog 与配置差异审查？
- 是否验证 bbox、时间、CQL2 条件和集合搜索返回同样可解释的目录结果？
- 是否用跨反日期线 AOI 验证几何、地图和分享链接？
- 自定义 widget、排序、preferred assets 与 relation types 是否逐项回归？
- 登录过期和认证重试是否不泄露会话或错误跳转？
- 是否保留可回滚的旧配置与升级前结果样本？
风险边界
v5 的功能说明来自项目发布页，不能替代每个 STAC API、代理、身份提供商或浏览器策略下的测试。更丰富的 CQL2 与集合搜索并不保证后端目录完整支持相同语义。对于私有或受限数据，前端展示、分享 URL 和插件能力仍须遵守数据授权与组织安全规则。
结论
STAC Browser 5 的升级价值在于更完整的目录发现与呈现能力，但它也是一次配置和语义迁移。把检索请求、几何边界、认证重试与自定义配置一起验收，团队才能升级浏览器而不改变用户对数据目录的信任。