SuperAPI AI 工具集

effect-v4

通用与其它

查看项目

更新于 10-16 01:48

技能介绍

用途:该技能用于编写 Effect v4(beta)新代码,以及把 Effect v3 代码迁移到 v4,覆盖 API 改名、行为变化和迁移前后对比示例。

主要能力:v4 核心模式指导(Context、layers、generators、schema codecs);v3→v4 分步迁移说明,附 before/after 示例;按主题拆分的参考文档,涵盖核心用法、数据类型、错误管理与工具、Exit/Cause、依赖与 Layer、资源与 Scope、运行时、并发与 Context.Reference、调度与重试、Streams/Queue/PubSub/STM、HTTP 客户端与服务端、请求批处理、缓存、配置、可观测性、Schema、Sink、测试、平台原语、Effect AI、Micro、从 async 迁移、故障排查等;迁移专题包括 runtime、error-handling、cause、services、fiberref、forking、fiber-keep-alive、scope、layer-memoization、generators、yieldable、equality。

已废弃写法(属过时示例):ServiceMap.*、Schema.makeUnsafe、SchemaParser.makeUnsafe、Effect.Yieldable。当前应优先使用 Context.Service / Context.Reference / Context<R>、Schema.make、SchemaParser.make、Schema.makeEffect、Effectable.Class / Effectable.Prototype,以及 Schema.asserts / SchemaParser.asserts。

使用方式:先确认涉及的 v3 API 或文件范围及需避免的回归,再只打开 references/migration/ 下相关迁移笔记;输出 v3→v4 API 映射与前后代码片段,标注行为变化、边界情况和测试更新,并提供简短的按序迁移清单。

限制:Effect v4 为 beta 软件,在 effect-smol 中活跃开发;核心编程模型稳定,但 effect/unstable/* 模块可能在小版本中发生破坏性变更。生产使用前请查阅官方 v4 beta 指南与稳定性说明。优先使用内置参考与官方文档,仅在文档或变更日志不明确、用户询问内部实现或行为未记录时才查看 effect-smol 源码;默认不克隆或阅读仓库源码。上游在 2026 年 2 月 22 日基线、2026 年 4 月 9 日技能更新及 2026 年 6 月 30 日前后均有较大变化,较早示例可能过时。平台、收费与价格信息暂未提供。