用途：应用六边形架构，将业务逻辑与外部依赖隔离，让核心领域保持稳定。
主要能力：区分入口的驱动端口与出口的被驱动端口；在边缘为每种外部技术实现适配器；围绕业务能力组织用例服务；通过契约测试验证适配器是否符合端口契约；用架构测试强制依赖规则。
使用时机：预计数据库、框架或界面会频繁更换；测试核心应用需要 mock 复杂或缓慢的基础设施；团队需要为第三方集成提供清晰的入口与出口接口。不适用：无外部依赖的小脚本或工具；添加端口/适配器抽象会带来额外开销的原型。
实施步骤：定义领域端口，包括驱动端口与被驱动端口，并以正式接口表达；在边缘实现适配器，使核心领域不感知具体框架；围绕业务能力聚合用例；编写契约测试；强制只有适配器可依赖外部框架，用自动化架构测试或静态分析执行。
关键交付物：正式命名端口、适配器与依赖策略的架构决策记录（ADR）；随核心领域模块保存的端口接口定义；每个适配器的契约测试套件及领域与应用服务的单元测试；供运维与架构评审使用的入站和出站数据流架构图。
相关组件：boundary-validator 检查每个适配器是否符合端口契约；adapter-generator 依据端口规范搭建主适配器与次适配器；contract-tester 通过共享契约测试验证适配器。
风险与缓解：端口/接口膨胀，需将相关操作合并为高内聚的高层端口；泄漏抽象，若端口接口暴露传输层细节（如 HTTP 头），应改用领域中心的数据传输对象；适配器漂移，需定期自动校验适配器与外部技术保持一致，例如验证 SQL 迁移仍符合持久化端口预期。
退出标准：端口接口作为正式契约定义并保存在核心领域模块中，而非适配器目录；ADR 列出每个入站驱动端口和出站被驱动端口及其适配器与依赖策略；自动化架构测试（如 ArchUnit、dep-cruise）保证适配器不直接引用其他适配器或核心内部实现；每个适配器在合并前至少有一个契约测试证明其正确履行端口预期。
适用场景与限制：适用于需要可测试性和端口/适配器分离的中大型系统设计；对小型脚本、无外部依赖的工具或快速原型可能带来额外抽象开销。具体工具安装命令与收费信息暂未提供。