面向 AI 时代的可靠 TypeScript,
用中文把它讲清楚。

先把官方文档读明白:每一页译文都可追溯到上游 commit,落后即标注;未翻译的页面直接给出 英文原文与认领入口。更进一步 —— 站内回答逐句带引用,没有依据就直说不知道, 还能直接接进你的编码 Agent。

正在连接后端…

内容结构(站点地图)

文档译站

跟随官方 v4 主线 + v3 切换;精译 + 机器辅助分层;翻译进度公开可查。

博客

官方 Blog 译站 + 社区原创;投稿走 GitHub PR,规范见译者指南。

社区

AI 问答已上线(可溯源);人之间的问答、活动日历与贡献者榜正在建设。

生态观测台

用 Effect 做 Agent 的项目到底有多少?我们扫了 4,861 个仓库: 856 个 TypeScript Agent 里只有 33 个真正在用,但其中 23 个把 Effect 当作 Runtime 地基。

教程与小抄

从 Promise 到 Effect 的学习路径、中英术语对照、可运行的 Playground 示例。

AI 原生:答案可溯源,且能被 Agent 调用

我是小效,本站的常驻助手(右下角那只猫就是我)。 猫有九条命,就像 Fiber 很轻——所以我一直在这儿,随时可以问我。

不是"给文档挂个聊天框":答案只从站内已审校的中文译文里检索,逐条给出 页面 + 小节锚点 + 上游基线;没有依据会直接拒答,并区分"文档里没有"与"中文还没翻译"。

问文档 ⌘I →

在任意译文页就地提问;答案带可点击的引用,点开直达对应小节。

报错诊断 →

粘贴 Effect 报错,提取其中的 API 与错误码,定位到相关中文小节。

接进你的 Agent →

MCP Server(pnpm mcp)、/api/knowledge/ask、 /llms-full.txt、/docs/<slug>.md 四种形态。

术语门禁 →

AI 输出与译文受同一套术语约束:违反社区术语就回退,不让模型自创译名。

为什么值得关注 Effect?

类型化的错误

函数签名里就能看到它会怎么失败;重试、回退、超时都变成普通 API。

显式的依赖

需要什么服务写进类型,测试时用 Layer 整块替换 —— 本站后端就是活例子。

结构化并发

Fiber 让并发可组合、可取消、可清理,不再有失控的 Promise.all。

Schema 单一来源

校验、序列化、API 契约、OpenAPI 从一份 Schema 生成,前后端零重复。