@design-parity/adapter-stitch

中文文档
1.18.0发布于 2026/11/07Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 3824

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

中文使用文档
文档目录4 节
  1. 它会做什么
  2. 认证
  3. 使用量
  4. 可注射接缝

@ 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。 。 。 .

使用量

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 共发布 102 个版本,首次发布于 2026/06/14;过去 12 个月发布了 102 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.18.0latest2026/11/074 天前
1.17.02026/10/2617 天前
1.16.12026/10/1824 天前
1.16.02026/10/1726 天前
1.15.02026/10/1528 天前
1.14.12026/10/1230 天前

关于 @design-parity/adapter-stitch 的常见问题

@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 和提交记录判断。