将 effect 从 3.x 升级到 4.x

根据 TypeScript 类型自动比较 effect 3.22.2 与 4.0.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	39
已删除的导出	81
已修改的签名	0
已删除的类或接口成员	0
已修改的类或接口成员	0
新增弃用	0
要求变化（engines、peer 依赖）	0
新增导出	44

已删除的导入路径

已删除的导入路径
`effect/Cron`
`effect/Data`
`effect/Exit`
`effect/Array`
`effect/Brand`
`effect/Cache`
`effect/Cause`
`effect/Chunk`
`effect/Clock`
`effect/Equal`
`effect/Fiber`
`effect/BigInt`
`effect/Config`
`effect/Differ`
`effect/Effect`
`effect/Either`
`effect/Boolean`
`effect/Channel`
`effect/Console`
`effect/Context`
`effect/FiberId`
`effect/DateTime`
`effect/Deferred`
`effect/Duration`
`effect/Encoding`
`effect/FiberMap`
`effect/Arbitrary`
`effect/FastCheck`
`effect/BigDecimal`
`effect/Effectable`
`effect/ConfigError`
`effect/Equivalence`
`effect/FiberHandle`
`effect/ExecutionPlan`
`effect/ConfigProvider`
`effect/DefaultServices`
`effect/ExecutionStrategy`
`effect/ChildExecutorDecision`
`effect/ConfigProviderPathPatch`

已删除的导出

import	export	kind	之前
`effect`	`STM`	namespace	`namespace`
`effect`	`List`	namespace	`namespace`
`effect`	`TMap`	namespace	`namespace`
`effect`	`TRef`	namespace	`namespace`
`effect`	`TSet`	namespace	`namespace`
`effect`	`Micro`	namespace	`namespace`
`effect`	`Either`	namespace	`namespace`
`effect`	`Pretty`	namespace	`namespace`
`effect`	`Secret`	namespace	`namespace`
`effect`	`TArray`	namespace	`namespace`
`effect`	`TQueue`	namespace	`namespace`
`effect`	`FiberId`	namespace	`namespace`
`effect`	`GroupBy`	namespace	`namespace`
`effect`	`LogSpan`	namespace	`namespace`
`effect`	`Mailbox`	namespace	`namespace`
`effect`	`TPubSub`	namespace	`namespace`
`effect`	`TRandom`	namespace	`namespace`
`effect`	`Encoding`	namespace	`namespace`
`effect`	`FiberRef`	namespace	`namespace`
`effect`	`Readable`	namespace	`namespace`
`effect`	`TestLive`	namespace	`namespace`
`effect`	`FastCheck`	namespace	`namespace`
`effect`	`FiberRefs`	namespace	`namespace`
`effect`	`KeyedPool`	namespace	`namespace`
`effect`	`MetricKey`	namespace	`namespace`
`effect`	`SortedMap`	namespace	`namespace`
`effect`	`SortedSet`	namespace	`namespace`
`effect`	`TDeferred`	namespace	`namespace`
`effect`	`TestClock`	namespace	`namespace`
`effect`	`TestSized`	namespace	`namespace`
`effect`	`JSONSchema`	namespace	`namespace`
`effect`	`MergeState`	namespace	`namespace`
`effect`	`MetricHook`	namespace	`namespace`
`effect`	`MetricPair`	namespace	`namespace`
`effect`	`Reloadable`	namespace	`namespace`
`effect`	`StreamEmit`	namespace	`namespace`
`effect`	`Streamable`	namespace	`namespace`
`effect`	`Supervisor`	namespace	`namespace`
`effect`	`TSemaphore`	namespace	`namespace`
`effect`	`TestConfig`	namespace	`namespace`
`effect`	`ConfigError`	namespace	`namespace`
`effect`	`FiberStatus`	namespace	`namespace`
`effect`	`GlobalValue`	namespace	`namespace`
`effect`	`MetricLabel`	namespace	`namespace`
`effect`	`MetricState`	namespace	`namespace`
`effect`	`ParseResult`	namespace	`namespace`
`effect`	`RateLimiter`	namespace	`namespace`
`effect`	`TestContext`	namespace	`namespace`
`effect`	`MutableQueue`	namespace	`namespace`
`effect`	`RedBlackTree`	namespace	`namespace`
`effect`	`RequestBlock`	namespace	`namespace`
`effect`	`RuntimeFlags`	namespace	`namespace`
`effect`	`Subscribable`	namespace	`namespace`
`effect`	`TestServices`	namespace	`namespace`
`effect`	`unsafeCoerce`	variable	`<A, B>(a: A): B`
`effect`	`MergeDecision`	namespace	`namespace`
`effect`	`MergeStrategy`	namespace	`namespace`
`effect`	`MetricKeyType`	namespace	`namespace`
`effect`	`MetricPolling`	namespace	`namespace`
`effect`	`ModuleVersion`	namespace	`namespace`
`effect`	`FiberRefsPatch`	namespace	`namespace`
`effect`	`MetricRegistry`	namespace	`namespace`
`effect`	`TPriorityQueue`	namespace	`namespace`
`effect`	`TReentrantLock`	namespace	`namespace`
`effect`	`TestAnnotation`	namespace	`namespace`
`effect`	`DefaultServices`	namespace	`namespace`
`effect`	`TestAnnotations`	namespace	`namespace`
`effect`	`MetricBoundaries`	namespace	`namespace`
`effect`	`ScheduleDecision`	namespace	`namespace`
`effect`	`ScheduleInterval`	namespace	`namespace`
`effect`	`TSubscriptionRef`	namespace	`namespace`
`effect`	`ExecutionStrategy`	namespace	`namespace`
`effect`	`RuntimeFlagsPatch`	namespace	`namespace`
`effect`	`ScheduleIntervals`	namespace	`namespace`
`effect`	`TestAnnotationMap`	namespace	`namespace`
`effect`	`StreamHaltStrategy`	namespace	`namespace`
`effect`	`UpstreamPullRequest`	namespace	`namespace`
`effect`	`UpstreamPullStrategy`	namespace	`namespace`
`effect`	`ChildExecutorDecision`	namespace	`namespace`
`effect`	`ConfigProviderPathPatch`	namespace	`namespace`
`effect`	`SingleProducerAsyncInput`	namespace	`namespace`

已修改的签名

未发现。

已删除的类或接口成员

未发现。

已修改的类或接口成员

未发现。

新增弃用

未发现。

要求变化（engines、peer 依赖）

未发现。

新增导出 (44)

import	export	kind
`effect`	`Path`	namespace
`effect`	`Pull`	namespace
`effect`	`cast`	variable
`effect`	`Latch`	namespace
`effect`	`Optic`	namespace
`effect`	`Stdio`	namespace
`effect`	`TxRef`	namespace
`effect`	`Crypto`	namespace
`effect`	`Filter`	namespace
`effect`	`Result`	namespace
`effect`	`Newtype`	namespace
`effect`	`Reducer`	namespace
`effect`	`TxChunk`	namespace
`effect`	`TxQueue`	namespace
`effect`	`ByteSize`	namespace
`effect`	`Combiner`	namespace
`effect`	`LayerRef`	namespace
`effect`	`Terminal`	namespace
`effect`	`TxPubSub`	namespace
`effect`	`Formatter`	namespace
`effect`	`JsonPatch`	namespace
`effect`	`Semaphore`	namespace
`effect`	`TxHashMap`	namespace
`effect`	`TxHashSet`	namespace
`effect`	`FileSystem`	namespace
`effect`	`JsonSchema`	namespace
`effect`	`Redactable`	namespace
`effect`	`References`	namespace
`effect`	`TxDeferred`	namespace
`effect`	`JsonPointer`	namespace
`effect`	`SchemaIssue`	namespace
`effect`	`TxSemaphore`	namespace
`effect`	`UndefinedOr`	namespace
`effect`	`SchemaGetter`	namespace
`effect`	`SchemaParser`	namespace
`effect`	`ChannelSchema`	namespace
`effect`	`ErrorReporter`	namespace
`effect`	`PlatformError`	namespace
`effect`	`StandardSchema`	namespace
`effect`	`TxPriorityQueue`	namespace
`effect`	`TxReentrantLock`	namespace
`effect`	`TxSubscriptionRef`	namespace
`effect`	`SchemaRepresentation`	namespace
`effect`	`SchemaTransformation`	namespace

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 effect 从 3 升级到 4 有哪些不兼容变更？

在 effect 3.22.2 与 4.0.0 之间，Vigia 发现 81 个已删除的导出、0 个已修改的签名，以及 0 个已删除或修改的类或接口成员。

effect 4 中弃用了哪些内容？

effect 4.0.0 中有 0 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/effect/upgrade?from=3.22.2&to=4.0.0