准备环境

在开始之前，你需要安装 Node.js（一个让 JavaScript 在电脑上运行的环境）和 npm（用来安装代码库的工具）。去 nodejs.org 下载最新版，安装时勾选“Add to PATH”。完成后打开终端（Mac 叫终端，Windows 叫命令提示符），输入 node -v 和 npm -v，看到版本号就说明成功了。

安装 Ore 库

Ore 是一个 TypeScript 库，专门用来处理服务器推送的流式数据（比如 AI 聊天时一个字一个字往外蹦的那种效果）。它帮你处理断线重连、解析数据格式等麻烦事。

1. 新建一个文件夹，比如 sse-demo，在终端里进入该文件夹。
2. 运行 npm init -y 生成 package.json 文件。
3. 运行 npm install ore-sse 安装 Ore 库。

注意：如果安装速度慢，可以设置国内镜像源：npm config set registry https://registry.npmmirror.com。

编写第一个流式客户端

创建一个 index.ts 文件，写入以下代码：

import { createSSEStream } from 'ore-sse';

async function main() {
  const stream = createSSEStream('https://example.com/events');
  for await (const event of stream) {
    console.log(event.data);
  }
}
main();

这段代码会连接到一个 SSE 数据源，并持续打印收到的消息。SSE（Server-Sent Events）是一种让服务器主动向浏览器发送数据的技术，简单说就是“服务器有话直接说，不用你一遍遍问”。

运行：npx ts-node index.ts。如果看到数据不断输出，就说明成功了。

常见坑与下一步

• 坑：网络断开后程序不会自动重连。Ore 默认支持重连，但需要你在服务器端正确发送 id 字段，客户端才能从断点续传。
• 下一步：尝试在 React 中使用 Ore，把流式数据更新到组件状态。比如用 useState 保存消息列表，在 useEffect 里调用流式函数。

现在你已经掌握了基础，可以开始构建自己的 AI 聊天或实时通知功能了！