# @design-parity/adapter-stitch 中文文档

规范地址：https://npmcn.com/package/%40design-parity/adapter-stitch/

版本：1\.18\.0
npm 元数据更新时间：2026-11-07T13:54:32.550Z
中文译文更新时间：2026-11-12T02:02:25.869Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40design-parity/adapter-stitch
原文对照：https://npmcn.com/package/%40design-parity/adapter-stitch/?lang=original
项目主页：https://github.com/yschimke/design-parity/tree/main/packages/adapters/stitch#readme
源码仓库：https://github.com/yschimke/design-parity

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

- 包体积（解压后）：57.4 kB，38 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-06-14T05:42:53.508Z
- 最新版本发布：2026-11-07T13:54:32.196Z
- 近 30 天下载量：3824（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 102 个）

## 中文简介

Google Stitch ReferenceAdapter:通过设计-map.json将一个组件解决为斯地奇设计,获取 HTML+ 通过斯地克SDK的牵引风能将一个参考图像光滑化,使一个设计参考规范化.

## 安装

```sh
npm install @design-parity/adapter-stitch
```

也可以使用：`pnpm add @design-parity/adapter-stitch`、`yarn add @design-parity/adapter-stitch`、`bun add @design-parity/adapter-stitch`

## README

# @ design- parity/ 适应器- stitch

谷歌时尚 `ReferenceAdapter`斯地奇船队 `@google/stitch-sdk` + 一个 MCP 服务器但已 **无代码连接等效**和菲格玛的机器链接不同 信件通过 repo 解决 `design-map.json`。参考文献是 总是用 `linkMethod: "manifest"`。 。 。 .

## 它会做什么

`resolve(componentId, ref, ctx)`数字 :

1.  **解开手柄.** 一个直接 `stitch:<projectId>/<screenId>` 参考解析 现为. 否则适配器负载 `design-map.json` (单位:千美元)`designMapPath`,或 `DESIGN_MAP_FILE`,则 `<repoRoot>/design-map.json`和 `findByCode` 地图 其Stitch ref的组件——清单是唯一的通信层.
2.  **获取 HTML+ 尾风** 通过Sitch SDK(一个或多个屏幕变体).
3.  **稀释** 每个屏幕无头地显示一个参考PNG;尺寸读取 直接从PNG IHDR中跳出,所以不能从diff引擎的字节漂移 比较起来.
4.  **提取从 Tailwind 衍生出的迹象** - 距离/辐射/背景 颜色 + 从标题和正文中打入 `DesignTokens`。 。 。 .
5.  **规范化** 改为 `DesignReference` 与 `linkMethod: "manifest"`。 。 。 .

## 认证

默认 SDK 客户端从 `AdapterContext.env`,顺序为: `STITCH_API_KEY`, (中文(简体) ), `STITCH_TOKEN`, (中文(简体) ), `STITCH_ACCESS_TOKEN`, (中文(简体) ), `GOOGLE_STITCH_TOKEN`。 。 。 .

遗失的证书 `StitchAuthError`;一个被否决的,是从 SDK(英语:SDK). 无匹配的组件 `design-map.json` 增加条目数 `StitchManifestError`; 无法解析的 ref 提出 `StitchBadRefError`。 。 。 .

## 使用量

```ts
import { createStitchAdapter } from "@design-parity/adapter-stitch";

const adapter = createStitchAdapter();

const reference = await adapter.resolve(
  "ui/Card.kt#OfferCard",
  "stitch:design/abc123", // or the code handle, resolved via design-map.json
  { repoRoot: process.cwd(), env: process.env },
);
```

## 可注射接缝

SDK和发光器都是接口,所以单位测试与 **没有生命 来源和无浏览器** (见 `test/`:

-   `StitchClient.fetchDesign(ref)` → `StitchDesign` (单位:千美元)`{ screens }`) (中文(简体) ). 默认 `createSdkStitchClient` 懒散驱动器 `@google/stitch-sdk`,远离 软件包的硬依赖性, 所以安装要保持干净; 缺失是明确的 `StitchSdkError`。 。 。 .
-   `Rasterizer.rasterize({ html, css })` ^ PNG 字节. 默认 `browserRasterizer` 驱动在其中发现的无头铬/铬 `PATH` (或 `CHROME_PATH`)——从来不是捆绑的浏览器自定义依赖,反射 候选制作人.

## 常见问题

### @design-parity/adapter-stitch 是什么？

Google Stitch ReferenceAdapter:通过设计-map\.json将一个组件解决为斯地奇设计,获取 HTML\+ 通过斯地克SDK的牵引风能将一个参考图像光滑化,使一个设计参考规范化\.

### 如何安装 @design-parity/adapter-stitch？

在项目目录运行 npm install @design-parity/adapter-stitch，或使用 pnpm add / yarn add / bun add。

### @design-parity/adapter-stitch 支持 TypeScript 吗？

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

### @design-parity/adapter-stitch 支持 ESM 还是 CommonJS？

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

### @design-parity/adapter-stitch 可以商用吗？

@design-parity/adapter-stitch 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @design-parity/adapter-stitch 的下载量有多少？

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

### @design-parity/adapter-stitch 还在维护吗？

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