# @gem-sdk/analytics 中文文档

规范地址：https://npmcn.com/package/%40gem-sdk/analytics/

版本：9\.1\.0
npm 元数据更新时间：2026-11-04T03:29:09.732Z
中文译文更新时间：2026-11-16T02:57:43.020Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gem-sdk/analytics
原文对照：https://npmcn.com/package/%40gem-sdk/analytics/?lang=original

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

- 包体积（解压后）：3 MB，1467 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：dayjs \>=1\.11，react \>=17，i18next \>=23，zustand \>=4，react-dom \>=17，react-i18next \>=14，@remix-run/react \>=2，@shopify/polaris \>=12，@react-spring/web \>=9\.4\.5，@shopify/polaris-viz \>=16，@tanstack/react-query \>=4，@shopify/polaris-icons \>=9，@shopify/polaris-viz-core \>=16
- 首次发布：2026-06-08T03:37:55.899Z
- 最新版本发布：2026-11-04T03:29:09.552Z
- 近 30 天下载量：2244（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 40 个）

## 中文简介

GemX 特定分析组件、钩和类型——取自 `gemx-shopify-app` 因此,它们可以由repos(dev / cating apps,以及未来的消费者)共享.

## 安装

```sh
npm install @gem-sdk/analytics
```

也可以使用：`pnpm add @gem-sdk/analytics`、`yarn add @gem-sdk/analytics`、`bun add @gem-sdk/analytics`

## README

# @gem-sdk/分析

GemX 特定分析组件、钩和类型——取自 `gemx-shopify-app` 因此,它们可以由repos(dev / cating apps,以及未来的消费者)共享.

> 移徙 **递增、自下而上**: 纯类型和帮助者先是叶子 演示图,然后是管弦乐部分。 没错 **没有** 移动整个 特性同时 —— 每一个切片只有在它的依赖性已经住在这里之后才会被移动 .

## 状态

| 切开 | App中的来源 | 状态 |
| --- | --- | --- |
| `types/chart` | `app/modules/page-analytic/modules/analytic/types/chart.ts` | 迁移 |

## 采掘令(计划)

1.  **纯类型/ 助手** 零应用程序组合(`types/chart`,图表转换帮助器).
2.  **叶图** - 只依靠 `@shopify/polaris-viz` + 上述类型 (单位:千美元)`PAFunnelChart`, (中文(简体) ), `PALineChartTooltip`, (中文(简体) ), `PAPercent`) (中文(简体) ).
3.  **共有基金会** - 决定是否提取、注射或保留: `~/types/metric`, (中文(简体) ), `~/core/gemxql` 类型,设计系统原始.
4.  **综合图表** —— 说 `PALineChart`, (中文(简体) ), `PACardLineChart`, (中文(简体) ), `PADonutChart`电网.
5.  **管弦** —— 说 `PageAnalyticDetail` 和提供者(最后;取决于一切).

## 从应用程序中获取

该应用程序消耗已出版的dev版本(例如. `"@gem-sdk/analytic": "0.0.1-dev.x"`, (中文(简体) ), 同样的消费方式 `@gem-sdk/heatmap-react`。在移出一块后:

```
yarn build && yarn changeset   # publish a dev version
# then bump the version in the app's package.json and rewire imports
```

`@shopify/polaris-viz`, (中文(简体) ), `@shopify/polaris-viz-core`, (中文(简体) ), `react` 财务报告和审定财务报表 `react-dom` 为: **依赖关系** ——由消费应用程序提供,从未捆绑.

## 常见问题

### @gem-sdk/analytics 是什么？

GemX 特定分析组件、钩和类型——取自 gemx-shopify-app 因此,它们可以由repos\(dev / cating apps,以及未来的消费者\)共享\.

### 如何安装 @gem-sdk/analytics？

在项目目录运行 npm install @gem-sdk/analytics，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=17）、i18next（\>=23）、react-dom（\>=17）、react-i18next（\>=14）、@remix-run/react（\>=2）、@shopify/polaris（\>=12）、@react-spring/web（\>=9\.4\.5）、@shopify/polaris-viz（\>=16）、@shopify/polaris-icons（\>=9）、@shopify/polaris-viz-core（\>=16）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gem-sdk/analytics 支持 TypeScript 吗？

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

### @gem-sdk/analytics 支持 ESM 还是 CommonJS？

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

### @gem-sdk/analytics 可以商用吗？

@gem-sdk/analytics 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gem-sdk/analytics 的下载量有多少？

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

### @gem-sdk/analytics 还在维护吗？

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

