@chat-adapter/notion

中文文档
4.44.0发布于 2026/11/02MITTypeScriptES Module构建来源已验证近 30 天下载 21.4万

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

中文使用文档
文档目录7 节
  1. 安装
  2. 带CLI的脚手架
  3. 快开始
  4. 配置
  5. Vercel 连接
  6. AI 编码代理
  7. 许可证

Notion adapter for Chat SDK

@chat-adapter/ 注释

npm 软件包 : @chat-adapter/notion

Agent Stack MIT License

名称适配器 聊天SDK。通过Notion webhooks和评论API参与页面并屏蔽评论讨论.

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

安装

pnpm add @chat-adapter/notion

带CLI的脚手架

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

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

访问 适配器目录 见其他官方和供应商官方适配器.

快开始

管理下的全权证书见 Vercel 连接。 。 。 .

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

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。 。 。 .

两者都需要。 见 完整配置参考 以提及检测和其他选项.

Vercel 连接

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

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, 适配器模式, 以及项目常规 .

npx skills add vercel/chat

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

您也可以安装 Vercel 插件 包括Chat SDK技术与专家代理、代理斜线指令

npx plugins add vercel/vercel-plugin

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

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

许可证

麻省理工学院

版本与发布记录

@chat-adapter/notion 共发布 10 个版本,首次发布于 2026/08/05;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.44.0latest2026/11/026 天前
4.43.02026/10/1921 天前
4.42.02026/10/1425 天前
4.41.12026/09/291 个月前
4.41.02026/09/181 个月前
4.40.02026/09/052 个月前

关于 @chat-adapter/notion 的常见问题

@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 和提交记录判断。