# @crafter/charts 中文文档

规范地址：https://npmcn.com/package/%40crafter/charts/

版本：0\.2\.5
npm 元数据更新时间：2026-10-28T05:26:07.441Z
中文译文更新时间：2026-11-10T22:56:23.126Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40crafter/charts
原文对照：https://npmcn.com/package/%40crafter/charts/?lang=original
项目主页：https://charts.crafter.run/
源码仓库：https://github.com/crafter-station/charts

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

- 包体积（解压后）：116 kB，70 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：typescript ^5
- 首次发布：2026-04-11T05:42:20.833Z
- 最新版本发布：2026-08-04T03:54:43.785Z
- 近 30 天下载量：3425（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

您的终端图 。 线条,条条,散开相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相.

## 安装

```sh
npm install @crafter/charts
```

也可以使用：`pnpm add @crafter/charts`、`yarn add @crafter/charts`、`bun add @crafter/charts`

## README

# @ cracker/ 图表

您的终端图 。 15个图表类型,零分解,TypeScript.

```
  cpu ▄▅▆▇███▇▆▅▃▂▁▂▃▄
  mem  ▁▃▅▇█████▇▅▃▁
  err    ▁ ▁  ▃█▂▁

       │     ⢀⠔⠊⠉⠉⠑⢄
     80┤   ⢀⠎       ⠱⡀
       │  ⡰⠁         ⠘⢄
     60┤ ⡰⠁            ⢣
       │                 ⠱⡀
     40┤                  ⠘⢄
       │                   ⠑⠢⢄⣀⣀⠔⠉
```

## 安装

```bash
bun add @crafter/charts
```

## 快速启动

```ts
import { plot, sparkline, chart, renderToAnsi } from "@crafter/charts";

// One-liner
console.log(plot([1, 5, 3, 7, 2, 8]));

// Sparkline
console.log(sparkline([10, 15, 12, 18, 14, 20], { color: "green" }));

// Full chart
const c = chart({ width: 60, height: 14 })
  .data(rows, { xKey: "x" })
  .yAxis({ format: (v) => "$" + v.toFixed(0) })
  .line({ key: "price", color: "green", label: "Price" });

console.log(renderToAnsi(c));
```

## 图表类型

| 类型 | 函数 | 内线? |
| --- | --- | --- |
| 线条( Braille) | `chart().line()` | 没有 |
| 线条( 框) | `chart({ charset: "box" }).line()` | 没有 |
| 栏 | `chart().bar()` | 没有 |
| 散点 | `chart().scatter()` | 没有 |
| 烛台 | `chart().candlestick()` | 没有 |
| 绘图 | `plot(data)` | 没有 |
| 闪光线 | `sparkline()` | 对 |
| 栏 | `sparkColumn()` | 对 |
| 栏 | `sparkBar()` | 对 |
| 赢/ 输 | `sparkWinLoss()` | 对 |
| 区域 | `sparkArea()` | 多线 |
| 热图 | `sparkHeatmap()` | 多线 |
| 直方图 | `sparkHistogram()` | 多线 |
| 高盖 | `sparkGauge()` | 对 |
| 甜甜圈 | `sparkDonut()` | 对 |

## 特征

-   **零依赖关系**
-   **类型脚本严格** 有导出类型
-   **盲文渲染** (每个字符有4x2分像素)
-   **4个字符集**: 盲文,框 (╭╮╰╯─│),块 (c), ascii
-   **3个指标**数字 : `renderToAnsi()`, (中文(简体) ), `renderToString()`, (中文(简体) ), `renderToHtml()`
-   **决定快照** 用于CI(`toMatchSnapshot()`(中文(简体) )
-   **自动大小** 到终端宽度
-   **固定域** 通过 `.yDomain([min, max])`
-   **多系列** 有彩色传说

## 链接

-   [着陆](https://charts.crafter.run/)
-   [无](https://www.npmjs.com/package/@crafter/charts)
-   [GitHub 图像](https://github.com/crafter-station/charts)

## 许可证

麻省理工学院

## 常见问题

### @crafter/charts 是什么？

您的终端图 。 线条,条条,散开相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相\.

### 如何安装 @crafter/charts？

在项目目录运行 npm install @crafter/charts，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typescript（^5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @crafter/charts 支持 TypeScript 吗？

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

### @crafter/charts 支持 ESM 还是 CommonJS？

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

### @crafter/charts 可以商用吗？

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

### @crafter/charts 的下载量有多少？

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

### @crafter/charts 还在维护吗？

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