SuperAPI AI 工具集

forze-wiring

办公与效率

查看项目

更新于 10-16 01:20

技能介绍

用途:在搭建 Forze 运行时、依赖注册表、生命周期、操作组合与接口层时使用。逻辑规格(DocumentSpec、SearchSpec、CacheSpec 等)只声明模型类型与名称,不写 DSN、表名、集合路径或索引 DDL;依赖模块(PostgresDepsModule、MongoDepsModule、RedisDepsModule 等)把同名映射到物理配置,DepsRegistry.from_modules(...) 合并模块,使 ExecutionContext 按路由 spec.name 解析工厂。

主要能力:依赖注册表通过 DepsRegistry.from_modules 传入 DepsModule 实例,各模块 call 返回 Deps 容器并合并,键冲突抛 CoreException;生命周期计划用 LifecyclePlan.from_modules(...) 或 from_steps(...),freeze() 依据 requires/provides/depends_on 构建拓扑波次,with_concurrent() 允许同波次并行;ExecutionRuntime 接收冻结后的 deps 与 lifecycle,在 runtime.scope() 内取上下文;build_runtime(...) 可一次装配并冻结,支持 drain_timeout 与 deployment=DeploymentProfile.FLEET。文档组合用 build_document_registry 注册标准 CRUD,写操作需 bind_tx().set_route(...).finish(...).freeze();支持自定义处理器、BeforeStep 等阶段钩子、patch 选择器与跨注册表合并的 fail-closed 规则。搜索组合用 build_search_registry 与 SearchFacade。FastAPI 侧通过 context_dependency 注入上下文,路由由 forze_fastapi.routes 从冻结的操作注册表生成,旧 endpoints.* 助手已移除;可用 SecurityContextMiddleware 与 register_exception_handlers。测试可用 forze_mock 的 MockDepsModule 内存适配器。

限制与注意:真实适配器需启动/停止连接池,不可跳过生命周期;get_context() 必须在 runtime.scope() 内调用,否则抛 RuntimeError;FastAPI 路由需 ctx_dep;HTTP 路由附加前必须 freeze();避免重复字面路由字符串,使用共享 StrEnum。具体收费、价格与平台信息暂未提供。