@c15t/astro

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

C15t的Astro cookie同意横幅,有服务器给定的标记,偏好中心岛屿和地心意识中间软件.

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

c15t: the open standard for cookie banners

@c15t/astro: 需要帮助吗? Astro cookie 横幅和 cookie 同意管理

Latest NPM Version Stars License Discord Skills Made by Inth

Cookie横幅,偏好对话框,以及Astro 5,6和7的同意加盟脚本. Middleware解决了每个请求的同意政策,如欧盟的GDPR选择入选. 旗帜很平淡 .astro 无框架 JavaScript 标记。 首选对话框只在访客打开时才作为斯维尔特(Svelte),React(React),或Vue (Vue)岛来加载.

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

关键特性

  • 访客下载了旗下没有UI框架. 对话框的框架仅在访客打开时加载
  • 将对话框岛写入Svelte, React, 或 Vue 中, 因此它使用框架 您的站点已经出发
  • 静态输出工作于任何静态主机 hosted()。服务器输出可以解决每个访问者的政策,所以横幅在第一个 HTML 中
  • Geo-aware 中间软件从主机读取位置和语言头
  • 分析、广告和像素通过@c15t/整合跟踪每个访客的选择:Google Tag管理器、Google的同意模式v2、GA4、Meta像素、PostHog等
  • IAB TCF 2.4 横幅和对话框组件

先决条件

  • Astro 5、6或7号卫星
  • 一个 @astrojs/svelte, (中文(简体) ), @astrojs/react,或 @astrojs/vue 选择对话框
  • 用于服务器输出的服务器适配器,或用于静态输出的服务器适配器
  • 一个 内部项目 (免费报名). 对于开发和测试,本地模式不需要后端

安装

pnpm add c15t @astrojs/svelte svelte @astrojs/node

这个 c15t 软件包再导出此软件包 c15t/astro,而文件使用该路径。 对于反应或Vue 对话框,安装 @astrojs/react react react-dom 或者说 @astrojs/vue vue 而不是斯维尔特. @astrojs/node 是下面示例中的服务器适配器。 使用主机的适配器取而代之,或留作静态输出.

使用量

  1. 设定 PUBLIC_C15T_BACKEND_URL 到您的 Inth 后端 URL .env
  2. 注册您的 UI 框架 c15t()输入 astro.config.mjs
// astro.config.mjs
import node from '@astrojs/node'
import svelte from '@astrojs/svelte'
import { defineConfig } from 'astro/config'
import c15t from 'c15t/astro'

export default defineConfig({
  adapter: node({ mode: 'standalone' }),
  integrations: [svelte(), c15t()],
  output: 'server',
})
  1. 添加 ConsentScript 改为 <head>,以及 ConsentBanner, (中文(简体) ), ConsentDialog,以及 ConsentDialogLink 到您的布局,从 c15t/astro/components
  2. 关于静态输出、全版布局和岛屿选项,见 Astro 快速启动

在 Inth 上运行 c15t

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

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

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

文档

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

AI 代理文件

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

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

支助

捐款

警卫

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

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

许可证

Apache 许可证 2.0


由 输入

版本与发布记录

@c15t/astro 共发布 21 个版本,首次发布于 2026/09/15;过去 12 个月发布了 21 个版本。最新版本附带 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.12,canary → 3.2.0-canary.0。

关于 @c15t/astro 的常见问题

@c15t/astro 是什么?

C15t的Astro cookie同意横幅,有服务器给定的标记,偏好中心岛屿和地心意识中间软件.

如何安装 @c15t/astro?

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

@c15t/astro 支持 TypeScript 吗?

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

@c15t/astro 支持 ESM 还是 CommonJS?

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

@c15t/astro 可以商用吗?

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

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

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

@c15t/astro 还在维护吗?

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