Python 工程（Harness Service Engineering）

只补实现 Shadow Harness 所需的 Python contract、类型、错误、测试、配置与依赖边界。

推荐阅读顺序

1. Python 项目怎样可复现又可维护：Package、uv 与 Typing

回答：一个 Python Harness 项目怎样组织 package、锁定依赖并用 typing 把核心 domain boundary 固定下来？

2. 核心接口怎么建模：Protocol、ABC、dataclass 与 Pydantic

回答：什么时候用 Protocol / ABC 定义行为，dataclass / Pydantic 又分别适合内部数据和边界校验？

3. 失败和资源生命周期怎么管：Exception、Context Manager 与 Logging

回答：异常如何分类、资源如何确保释放、Logging 怎样保留故障证据而不是吞掉错误？

4. 如何隔离外部依赖做测试：pytest、Fixtures 与 Test Doubles

回答：怎样用 pytest fixtures 和 Fake / Stub / Mock 隔离真实模型、网络和数据库，让测试可重复？

5. 配置和依赖应该在哪一层注入：Configuration 与 Dependency Boundary

回答：Harness 的启动配置、per-run policy、secret 和外部依赖应该在哪里进入系统，怎样避免 domain/runtime 直接创建 Provider / DB / HTTP client？

本模块学习边界

• 暂不展开：Python 语言内部实现、复杂元编程、JVM 式框架深度