# @chat-adapter/notion 中文文档

规范地址：https://npmcn.com/package/%40chat-adapter/notion/

版本：4\.44\.0
npm 元数据更新时间：2026-11-02T14:56:27.026Z
中文译文更新时间：2026-11-09T11:22:22.270Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chat-adapter/notion
原文对照：https://npmcn.com/package/%40chat-adapter/notion/?lang=original
项目主页：https://chat-sdk.dev/adapters/official/notion
源码仓库：https://github.com/vercel/chat

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：89.6 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-08-05T14:57:12.626Z
- 最新版本发布：2026-11-02T14:56:26.635Z
- 近 30 天下载量：214436（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

Chat SDK 的逗号适配器——参与页面和块评论讨论

## 安装

```sh
npm install @chat-adapter/notion
```

也可以使用：`pnpm add @chat-adapter/notion`、`yarn add @chat-adapter/notion`、`bun add @chat-adapter/notion`

## README

[![Notion adapter for Chat SDK](https://chat-sdk.dev/en/adapters/official/notion/og)](https://chat-sdk.dev/adapters/official/notion)

# @chat-adapter/ 注释

> npm 软件包 : [`@chat-adapter/notion`](https://www.npmjs.com/package/@chat-adapter/notion)

[![Agent Stack](https://img.shields.io/badge/Agent%20Stack-000?style=flat-square&logo=vercel&logoColor=FFF&labelColor=000&color=000)](https://vercel.com/kb/agent-stack) [![MIT License](https://img.shields.io/badge/License-MIT-000?style=flat-square&logo=opensourceinitiative&logoColor=white&labelColor=000&color=000)](https://npmcn.com/package/LICENSE)

名称适配器 [聊天SDK](https://chat-sdk.dev/)。通过Notion webhooks和评论API参与页面并屏蔽评论讨论.

联合国 [聊天-sdk.dev/适应者/正式/通知](https://chat-sdk.dev/adapters/official/notion) 指南: [vercel.com/kb/chat-sdk (英语)](https://vercel.com/kb/chat-sdk)

## 安装

```bash
pnpm add @chat-adapter/notion
```

## 带CLI的脚手架

用这个适配器预选的新名词机器人:

```bash
npx create-chat-sdk@latest my-bot --adapter notion memory
```

访问 [适配器目录](https://chat-sdk.dev/adapters) 见其他官方和供应商官方适配器.

## 快开始

管理下的全权证书见 [**Vercel 连接**](https://npmcn.com/package/%40chat-adapter/notion/#readme-vercel-connect)。 。 。 .

适配器自动检测证书来自 `NOTION_TOKEN`, (中文(简体) ), `NOTION_VERIFICATION_TOKEN`选择 `NOTION_BOT_USERNAME` 编号 : `NOTION_VERSION` 编号 : `NOTION_MENTION_MODE` 编号 : `NOTION_KEYWORDS`数字 :

```typescript
import { Chat } from "chat";
import { createNotionAdapter } from "@chat-adapter/notion";

const bot = new Chat({
  userName: "my-bot",
  adapters: {
    notion: createNotionAdapter(),
  },
});

bot.onNewMention(async (thread, message) => {
  await thread.post("Hello from Notion!");
});
```

## 配置

| 选项 | 说明 |
| --- | --- |
| `token` | 逗号访问符或自动解析器. 自动从 `NOTION_TOKEN`。 。 。 . |
| `verificationToken` | 本地的 Webhook 验证符 。 自动从 `NOTION_VERIFICATION_TOKEN`。 。 。 . |

两者都需要。 见 [完整配置参考](https://chat-sdk.dev/adapters/official/notion#configuration) 以提及检测和其他选项.

## Vercel 连接

使用 `connectNotionAdapter` 以解析来自 Vercel 连接 :

```typescript
import { createNotionAdapter } from "@chat-adapter/notion";
import { connectNotionAdapter } from "@vercel/connect/chat";

const notion = createNotionAdapter({
  ...connectNotionAdapter("notion/acme-notion"),
  verificationToken: process.env.NOTION_VERIFICATION_TOKEN,
});
```

连接不转发Notion webhoks. 配置 Webhook 订阅 直接在逗号中保留 `NOTION_VERIFICATION_TOKEN` 用于本地 HMAC 的 核查. `NOTION_TOKEN` 在使用连接帮助时不需要.

## AI 编码代理

如果您使用OpenAI Codex, Claude Code, 或 Cursor 等AI编码代理, 在写入代码前安装 Chat SDK 技能, 使其了解 SDK API, 适配器模式, 以及项目常规 .

```bash
npx skills add vercel/chat
```

技术参考文献 `node_modules/chat/docs`,加上已发布的软件包中的适配器指南和启动模板.

您也可以安装 [Vercel 插件](https://vercel.com/docs/agent-resources/vercel-plugin) 包括Chat SDK技术与专家代理、代理斜线指令

```bash
npx plugins add vercel/vercel-plugin
```

插件是可选的;单是技能就足以用Chat SDK来构建.

关于可代理阅读的文件,见 [聊天- sdk.dev/llms.txt](https://chat-sdk.dev/llms.txt) (页数索引)或 [聊天- sdk.dev/llms- full.txt](https://chat-sdk.dev/llms-full.txt) (全文).

## 许可证

麻省理工学院

## 常见问题

### @chat-adapter/notion 是什么？

Chat SDK 的逗号适配器——参与页面和块评论讨论

### 如何安装 @chat-adapter/notion？

在项目目录运行 npm install @chat-adapter/notion，或使用 pnpm add / yarn add / bun add。

### @chat-adapter/notion 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @chat-adapter/notion 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @chat-adapter/notion 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @chat-adapter/notion 可以商用吗？

@chat-adapter/notion 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chat-adapter/notion 的下载量有多少？

根据 npm 官方下载统计，@chat-adapter/notion 在 2026/10/10 – 2026/11/08 这 30 天内被下载 214,436 次，日均约 7,148 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @chat-adapter/notion 还在维护吗？

最新版本 4\.44\.0 发布于 2026/11/02（6 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/08/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。