@distilled.cloud/notion

中文文档
1.0.0-rc.19发布于 2026/11/12Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 7.7万
中文使用文档
文档目录3 节
  1. 安装
  2. 快开始
  3. 认证

@ distilled. cloud/ notion (已删除)

SDK, 由 逗号的 OpenAPI 描述。 。 。 .

安装

npm install @distilled.cloud/notion effect

快开始

import { Effect, Layer } from "effect";
import * as FetchHttpClient from "effect/http/FetchHttpClient";
import * as Notion from "@distilled.cloud/notion";

const program = Effect.gen(function* () {
  const { results } = yield* Notion.search.searchByTitle({ query: "Roadmap", page_size: 1 });
  const first = results[0];
  if (first === undefined || first.object !== "page") return undefined;
  return yield* Notion.pages.getPage({ page_id: first.id });
});

const Live = Layer.mergeAll(
  FetchHttpClient.layer,
  Notion.CredentialsFromEnv,
  Notion.NotionProtocol,
);

program.pipe(Effect.provide(Live), Effect.runPromise);

分层作业(listUsers, (中文(简体) ), listBlockChildren, (中文(简体) ), queryDataSource, (中文(简体) ), searchByTitle,) 也暴露了(......) .pages(input) 财务报告和审定财务报表 .items(input) 接下来的流 next_cursor。 。 。 .

认证

NOTION_TOKEN (集成秘密、个人访问标志或OAuth访问标志) Authorization: Bearer。每个请求都会发出 Notion-Version (默认) 2026-03-11; 覆盖到 NOTION_VERSION) (中文(简体) ). 可选 NOTION_API_BASE_URL (默认) https://api.notion.com) (中文(简体) ).

OAuth 符号端点(/v1/oauth/token, (中文(简体) ), /v1/oauth/revoke, (中文(简体) ), /v1/oauth/introspect)不是SDK的一部分:它们用HTTP Basic客户端证书进行认证,而不是无记名符号.

版本与发布记录

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

版本发布日期距今
1.0.0-rc.19latest2026/11/12今天
1.0.0-rc.182026/11/039 天前
1.0.0-rc.172026/10/2419 天前
1.0.0-rc.162026/10/2320 天前
1.0.0-rc.152026/10/1330 天前
1.0.0-rc.142026/10/1330 天前

关于 @distilled.cloud/notion 的常见问题

如何安装 @distilled.cloud/notion?

在项目目录运行 npm install @distilled.cloud/notion,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:effect(^4.1.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@distilled.cloud/notion 支持 TypeScript 吗?

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

@distilled.cloud/notion 支持 ESM 还是 CommonJS?

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

@distilled.cloud/notion 可以商用吗?

@distilled.cloud/notion 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@distilled.cloud/notion 的下载量有多少?

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

@distilled.cloud/notion 还在维护吗?

最新版本 1.0.0-rc.19 发布于 2026/11/12(今天);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/10/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。