# @guardian/source-development-kitchen 中文文档

规范地址：https://npmcn.com/package/%40guardian/source-development-kitchen/

版本：30\.0\.0
npm 元数据更新时间：2026-10-08T07:10:54.645Z
中文译文更新时间：2026-11-17T02:47:38.982Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40guardian/source-development-kitchen
原文对照：https://npmcn.com/package/%40guardian/source-development-kitchen/?lang=original
项目主页：https://github.com/guardian/csnx#readme
源码仓库：https://github.com/guardian/csnx

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

- 包体积（解压后）：329 kB，136 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react ^18\.2\.0，tslib ^2\.8\.1，typescript ~6\.0\.3，@types/react ^18\.2\.79，@emotion/react ^11\.11\.4，@guardian/libs ^33\.0\.0，@guardian/source ^14\.0\.0
- 首次发布：2024-05-16T16:00:33.018Z
- 最新版本发布：2026-10-08T07:10:53.724Z
- 近 30 天下载量：23001（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：234（近 12 个月 53 个）

## 中文简介

[![npm](https://img.shields.io/npm/v/@guardian/source-development-kitchen)](https://www.npmjs.com/package/@guardian/source-development-kitchen)

## 安装

```sh
npm install @guardian/source-development-kitchen
```

也可以使用：`pnpm add @guardian/source-development-kitchen`、`yarn add @guardian/source-development-kitchen`、`bun add @guardian/source-development-kitchen`

## README

# `@guardian/source-development-kitchen`

[![npm](https://img.shields.io/npm/v/@guardian/source-development-kitchen)](https://www.npmjs.com/package/@guardian/source-development-kitchen)

源头开发厨房是可以烹调,测试和分享新的组件和模式的地方. 最低接受标准。 重复和破坏东西是正常的。 如果厨房的部件证明有价值,可以晋升到 `@guardian/source`。 。 。 .

此软件包是 [源设计系统](https://npmcn.com/docs/source/README.md)。 。 。 .

## 安装

```sh
$ pnpm add @guardian/source-development-kitchen
```

或者说

```sh
$ yarn add @guardian/source-development-kitchen
```

或者说

```sh
$ npm install @guardian/source-development-kitchen
```

## 示例

```tsx
import { Lines } from '@guardian/source-development-kitchen/react-components';

const Section = () => (
    <>
        <Lines count={8} />
        <Lines effect="squiggly" />
    </>
);
```

## 文档

页:1 [源代码开发厨房故事书](https://guardian.github.io/storybooks)。 。 。 .

## 所有权

厨房组件不受CSTI的支持. 他们由消耗他们的团队拥有.

所有权人的定义载于 [消费者](https://github.com/guardian/csnx/tree/main/.github/CODEOWNERS)。 。 。 .

如果你想开始消耗厨房组件, 加入你的团队作为CODEOWINERS。 这将确保您被告知组件的更改.

## 演变

厨房组件预计将有变化。 厨房的部件应该被认为是实验性的,并且有可能以破坏事物的方式改变.

证明有价值的组成部分可以晋升到 `@guardian/source`为了实现这一目标,该部分必须符合资料来源的要求 [接受标准](https://theguardian.design/2a1e5182b/p/11c92e-acceptance-criteria). 满足这些要求的最佳方式是开发者在构建和演化一个组件时与设计和UX密切合作. 构件应表明由源头管理的某些图案、规则或设计方面.

## 动机

来源是一个库,团队可以期待在那里找到高质量的共享组件. 将新的组件添加到源(Source)需要深入的工作和跨学科的协作 — — 设计,UX和工程. 部件在源头登陆需要很长时间和大量努力.

潜在贡献者被推迟直接向原始来源捐款,因为他们认为难以在时间投资与团队优先事项之间取得平衡。 其代价是双重的:

-   来源提供的高质量组件数量低于其可能数量.
-   可能共享的组件直接被构建到应用中,导致分散,不一致和重复.

我们认为,迅速行动、试验新想法并分享这些想法以提供更广泛的投入是有价值的。 源头开发厨房帮助团队通过降低入门障碍来实现这一目标. 它允许团队从用户和其他开发者那里获得对新组件的快速反馈.

通过为延展和改进提供敏捷的机制,组件可以提升到来源预期的质量水平,每个人都可以从投入其中的工作中受益.

## 出版

源发展厨房是作为自己的软件包出版的,独立于其中的稳定组件 `@guardian/source`。这个:

-   允许厨房快速移动.
-   允许我们经常对源代码开发厨房进行突破性修改,同时保留源代码。 稳定的库以更慢的速度变化,以设定预期和保存开发者的信心.

## 常见问题

### 如何安装 @guardian/source-development-kitchen？

在项目目录运行 npm install @guardian/source-development-kitchen，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：tslib（^2\.8\.1）、@guardian/libs（^33\.0\.0）、@guardian/source（^14\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @guardian/source-development-kitchen 支持 TypeScript 吗？

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

### @guardian/source-development-kitchen 支持 ESM 还是 CommonJS？

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

### @guardian/source-development-kitchen 可以商用吗？

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

### @guardian/source-development-kitchen 的下载量有多少？

根据 npm 官方下载统计，@guardian/source-development-kitchen 在 2026/10/17 – 2026/11/15 这 30 天内被下载 23,001 次，日均约 767 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @guardian/source-development-kitchen 还在维护吗？

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

