# FacetAwareMatching 协作记忆

## 开发原则

默认遵循以下错误处理原则：

- 对于代码缺陷、逻辑疏漏、配置或资源缺失、违反统一约定等由自身原因导致的错误，应尽早暴露、快速失败，不做回退或容错处理，以保持代码精简、清晰、统一。
- 对于线上超时、第三方接口异常等不可预见的外部错误，应提供必要的兜底、回退、重试或其他容错措施，以保证系统稳定性和业务连续性。
- 进行功能迭代或重构时，默认直接面向最终方案和最优设计实现，不主动为历史实现、旧数据、过渡状态或遗留调用方式做兼容；优先推动代码回到统一约定和一致模型，避免长期并存的双轨逻辑、分支特判和临时过渡层。

## 落地要求

- 不要用静默吞错、默认值掩盖、隐式降级等方式隐藏内部问题。
- 发现内部前置条件不满足时，应优先抛错、失败并暴露上下文。
- 设计容错逻辑时，应明确区分“内部错误”和“外部错误”，避免把内部问题包装成可忽略事件。
- 新设计一旦确定，应优先整体替换旧约定，而不是通过兼容旧行为来维持表面稳定。
- 除非有明确、必要的外部兼容性约束，否则不要为内部历史包袱保留额外分支。