# @calcom/atoms 中文文档

规范地址：https://npmcn.com/package/%40calcom/atoms/

版本：2\.6\.12
npm 元数据更新时间：2026-10-15T11:34:24.876Z
中文译文更新时间：2026-11-08T23:45:32.536Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40calcom/atoms
原文对照：https://npmcn.com/package/%40calcom/atoms/?lang=original
项目主页：https://github.com/calcom/cal#readme
源码仓库：https://github.com/calcom/cal

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

- 包体积（解压后）：13.8 MB，3155 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：14 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0
- 首次发布：2024-03-21T15:58:37.160Z
- 最新版本发布：2026-10-15T11:34:24.589Z
- 近 30 天下载量：152722（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：200（近 12 个月 48 个）

## 中文简介

自定义的 UI 组件可以整合到您的产品中 .

## 安装

```sh
npm install @calcom/atoms
```

也可以使用：`pnpm add @calcom/atoms`、`yarn add @calcom/atoms`、`bun add @calcom/atoms`

## README

自定义的 UI 组件可以整合到您的服务中 .

## 用户指南

### 支助

目前支持React 18,React 19,下14和下15.

### 更改日志

1.  可查看更改日志 [这里](https://github.com/calcom/cal.com/blob/main/packages/platform/atoms/CHANGELOG.md)。 。 。 .
2.  对于下一次发布时即将发生的更改,单击 [这里](https://github.com/calcom/cal.com/pulls?q=is%3Apr+is%3Aopen+%22chore%3A+version+packages%22+in%3Atitle) 查看一个名为 `chore: version packages` 包含下一次发布更改.

### 版本

1.  我们使用语义化的版本,意思是除了主要版本之外,所有更新都应该是安全的更新.
2.  如果在特定版本内有中断的更改,将标记为 `❗️Breaking change` 在更改日志中, 请在更新前查看 .
3.  有的版本被后缀为"等. `1.0.102-framer` 并打算用于孤立的病例,所以你很可能 想要使用没有后缀的版本, 例如 . `1.0.103`。 。 。 .

### 文档

关于如何启动平台解决方案的文件是 [这里](https://cal.com/docs/platform/quickstart) 和原子列表可查看 [这里](https://cal.com/docs/platform/atoms/cal-provider)

## 贡献者指南

### 版本

我们使用一个名为"更改"的工具,帮助记录与您的开发分支相关的更改,然后管理 原子版本和发布到 [无](https://www.npmjs.com/package/@calcom/atoms)。我们需要添加记录更改的日志,然后让更改et收集更改、更新 Changelog并更新版本 `package.json`。 。 。 .

1.  假设你在开发部门 刚刚完成了在原子上添加新功能的工作 在开发分支时, 您需要添加一个记录此特性的日志, 以便它最终会出现在原子中 [变动情况](https://github.com/calcom/cal.com/blob/main/packages/platform/atoms/CHANGELOG.md)。 。 。 .

-   运行 `yarn changesets-add` 从单列波根选择 `@calcom/atoms` 使用空间栏并按下输入进入下一步.
-   然后,在语义化版本之后,您必须选择这是主要,次要还是补丁更新. 因为它是一个通过按下输入跳过主功能的特性,然后通过按下空间栏和按下输入来选择小功能进入下一步.
-   然后,您必须写下变化的描述并按入. 这将生成日志文件 `.changeset` 例如,目录. `.changeset/hungry-donuts-cross.md`。 。 。 .
-   将此日志文件提交您的开发分支并按下 . 值得注意的是,你不必改变 `"version"` 在原子中 `package.json` 文档,因为更改器将在下一步完成.

2.  开发分支合并后, 更改将打开一个名为“ 调用” 的拉动请求 `chore: version packages` 包含下一次发布更改。 此拖动请求将包含新日志文件, 将添加到原子中 `CHANGELOG.md` 文件与更改ets 将更新原子 `package.json` 文件基于主要、次要或补丁更新与否。 当我们想要释放原子时,我们只需要合并这个拉出请求,而更改器会将新的原子版本发布到npm. 值得注意的是, 更改ets 仅在 npm 中发布原子 `"version"` 在原子中 `package.json` 变化et的 PR 高于 npm .

以下两篇文章教人们如何为每个公关写好变化摘要

-   [https://keepachangelog.com/en/1.0.0/ (中文(简体) )](https://keepachangelog.com/en/1.0.0/)
-   [https://docs.gitlab.com/development/changelog/ 页面存档备份,存于互联网档案馆](https://docs.gitlab.com/development/changelog/)

### 测试

原子在CI中通过实例平台应用内的e2e测试进行测试. 在当地管理:

1.  转到"包装/平面/原子"并运行 `yarn dev-on` 接下来 `yarn build` - 这会在当地建立原子.
2.  在"packages/platform/examples/base/.env"文件中设置环境变量. 您需要自己的 oAuth 客户端来填充 NEXT PUBLICQCAL ID( oAuth id), QQCAL SECRET KEY( oAuth secret), VITE BOOKER EMBED OANDTH CLIENT ID( oAuth id) 和 Organization ID( oAuth 客户端所属的组织 id) - 所有这些在创建 oAuth 客户端后, 都可以在平台设置仪表板中找到 .

```
NEXT_PUBLIC_X_CAL_ID=""
X_CAL_SECRET_KEY=""
NEXT_PUBLIC_CALCOM_API_URL="https://api.cal.com/v2"
VITE_BOOKER_EMBED_OAUTH_CLIENT_ID=""
VITE_BOOKER_EMBED_API_URL="https://api.cal.com/v2"
ORGANIZATION_ID=""
```

3.  转到"包装/平台/实例/基准"并运行 `yarn dev:e2e` - 这将启动实例平台应用,并通过使用本地所建原子运行e2e测试. 因为它不是在CI内部运行 它会打开浏览器并运行测试.

## 常见问题

### @calcom/atoms 是什么？

自定义的 UI 组件可以整合到您的产品中 \.

### 如何安装 @calcom/atoms？

在项目目录运行 npm install @calcom/atoms，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @calcom/atoms 支持 TypeScript 吗？

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

### @calcom/atoms 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @calcom/atoms 可以商用吗？

@calcom/atoms 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @calcom/atoms 的下载量有多少？

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

### @calcom/atoms 还在维护吗？

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