@c15t/core

中文文档
3.2.2发布于 2026/11/02Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 22.1万

C15t后无头同意引擎. 商店同意,决定谁在每位访客同意政策上看到横幅和大门配置了脚本.

中文使用文档
文档目录12 节
  1. 关键特性
  2. 先决条件
  3. 安装
  4. 使用量
  5. 在 Inth 上运行 c15t
  6. 文档
  7. 相关软件包
  8. AI 代理文件
  9. 支助
  10. 捐款
  11. 警卫
  12. 许可证

c15t: the open standard for cookie banners

@c15t/ core: 无头 JavaScript cookie 同意引擎

Latest NPM Version Stars License Discord Skills Made by Inth

每个c15t适配器背后的无头JavaScript cookie同意引擎. 它解决了GDPR和其他隐私法的同意政策,存储选择,并搁置所配置的脚本,iframe,以及网络要求访问者的政策和选择不允许. 使用它来构建自己的同意UI或者连接一个没有c15t适配器的框架.

c15t用于 2 100个以上地点包括expo.dev, sed.dev, unkey.dev, mintlify.com, 和 sazabi.com.

关键特性

  • 带来自己的UI:从同意快照中渲染出,c15t保持状态,存储和政策分辨率
  • 控制配置的脚本、 iframe 和网络请求, 并附带已解决策略的分类权限
  • 政策决定谁看到一面旗帜:欧盟的访客选择加入,美国一些国家选择退出,或者你写的规则
  • Google 同意模式 v2, IAB TCF 2.4, 全球隐私控制支持
  • 创建运行时间没有副作用, 因此模块可以在服务器上导入
  • Google 标签管理器、 Meta 像素、 PostHog 的供应商加载器, 更多通过 @c15t/ 整合

先决条件

  • 节点.js 20.19或以后
  • 一个 内部项目 (免费报名). 对于开发和测试,本地模式不需要后端

安装

pnpm add @c15t/core

这个 c15t 同一个发动机 c15t 财务报告和审定财务报表 c15t/runtime,加上每个框架适配器.

使用量

  1. 为页面创建一次运行时间 createConsentRuntime 和一个模式,例如 hosted()
  2. 打电话 runtime.start() 在浏览器中
  3. 把你的旗帜从 runtime.kernel.getSnapshot() 并且从 runtime.kernel.subscribe()
  4. 记录选择 runtime.kernel.commands.save('all'), (中文(简体) ), save('none'),或诸如 { measurement: true }
  5. 整个路过,看 无头运行时间指南
// src/consent-runtime.ts
import { hosted } from '@c15t/core'
import { createConsentRuntime } from '@c15t/core/runtime'

export const runtime = createConsentRuntime({
  mode: hosted({ backendURL: 'https://your-project.inth.app' }),
})

在 Inth 上运行 c15t

c15t需要一个后端来服务政策和保存同意记录. 输入 为您运行它。 它把每个选择都储存在它的区域和政策版本中,审计你的现场,并拉动隐私风险请求,在Pro和以上上,每个地区的同意规则都有管理的政策包。 你不运行同意数据库, 地理检索, 上升时间,或升级.

注册是免费的。 运行 npx @inth/cli c15t 创建项目并设置 c15t,或用手创建并复制其后端 URL.

对于开发和测试,本地模式在浏览器中保留选择,不保存同意记录. 别把它运去生产 它的工厂 local()旧名, offline(),仍然工作,在v4离开.

文档

见 文档 用于指南、API参考和示例.

  • c15吨(吨): 此引擎加 React, Next.js, Vue, Nuxt, Astro, 和 TanStack 启动适配器在一个安装中
  • @c15t/浏览器: plain JavaScript 和脚本标签网站的股票旗和首选项对话框
  • @c15t/整合: 同意意识分析器、标签管理器、像素和部件加载器

AI 代理文件

这个软件包以Markdown为载体,与已安装的版本相匹配。 安装后,请指定编码代理 node_modules/@c15t/core/AGENTS.md它将每个向导在 node_modules/@c15t/core/docs/。 。 。 .

在网络上,每页 c15吨文件 拥有Markdown版本,并且 页:1 全部列出 安装 c15t 代理技能 npx skills add c15t/skills。 。 。 .

支助

捐款

警卫

不为安全弱点打开一个公共问题。 私下通过报告 GitHub 的脆弱性报告我们审查所有的报告.

  • 不在公共论坛、议题或请求中分担脆弱性
  • 给它复制的步骤 和它影响的版本
  • 在你透露之前给我们点时间

许可证

Apache 许可证 2.0


由 输入

版本与发布记录

@c15t/core 共发布 20 个版本,首次发布于 2026/09/15;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.2.2latest2026/11/027 天前
3.2.12026/10/319 天前
3.2.02026/10/3010 天前
3.2.0-canary.0canary2026/10/2316 天前
3.1.02026/10/1723 天前
3.1.0-canary.02026/10/1525 天前

其他发布通道:alpha → 3.0.0-alpha.11,canary → 3.2.0-canary.0。

关于 @c15t/core 的常见问题

@c15t/core 是什么?

C15t后无头同意引擎. 商店同意,决定谁在每位访客同意政策上看到横幅和大门配置了脚本.

如何安装 @c15t/core?

在项目目录运行 npm install @c15t/core,或使用 pnpm add / yarn add / bun add。

@c15t/core 支持 TypeScript 吗?

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

@c15t/core 支持 ESM 还是 CommonJS?

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

@c15t/core 可以商用吗?

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

@c15t/core 的下载量有多少?

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

@c15t/core 还在维护吗?

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