内容结构(站点地图)
文档译站
跟随官方 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 生成,前后端零重复。