@graphysdk/data-import-utils

中文文档
1.9.0-beta.1794847602792发布于 2026/11/17SEE LICENSE IN LICENSE.mdTypeScriptESM + CJS近 30 天下载 1.7万

Parse CSV/TSV/JSON/spreadsheets into Graphy { columns, rows } data

原始使用文档
文档目录8 节
  1. Install
  2. Docs
  3. Usage
  4. With the Agents SDK
  5. Formats
  6. Agent skills
  7. Licence
  8. Support

@graphysdk/data-import-utils

Parse CSV, TSV, JSON, and spreadsheet files into the { columns, rows } shape used by Graphy charts and agents.

Learn more at graphy.dev.

Install

npm install @graphysdk/data-import-utils

Docs

Usage

import { fromFile } from '@graphysdk/data-import-utils/file';

const data = await fromFile('sales.csv');
const spreadsheet = await fromFile('report.xlsx', { sheet: 'Revenue' });
import { fromURL } from '@graphysdk/data-import-utils/url';

const data = await fromURL('https://example.com/sales.csv');

Each format also has its own entry, so you only bundle what you need:

import { fromCSV } from '@graphysdk/data-import-utils/csv';
import { fromTSV } from '@graphysdk/data-import-utils/tsv';
import { fromXLSX } from '@graphysdk/data-import-utils/xlsx';
import { fromXLS } from '@graphysdk/data-import-utils/xls';
import { fromODS } from '@graphysdk/data-import-utils/ods';

With the Agents SDK

import { fromFile } from '@graphysdk/data-import-utils/file';
import { GraphyAiSdk } from '@graphysdk/agents-sdk';

const data = await fromFile('revenue.csv');

const ai = new GraphyAiSdk({ apiKey: process.env.GRAPHY_API_KEY });
const result = await ai.generateGraph({
  config: { data },
  userPrompt: 'bar chart of revenue by company',
});

Formats

FormatFunctionInput
CSVfromCSV()string
TSVfromTSV()string
XLSXfromXLSX()ArrayBuffer
XLSfromXLS()ArrayBuffer
ODSfromODS()ArrayBuffer

Agent skills

Install the Graphy agent skills from github.com/graphysdk/skills to set up the SDK and author charts from Cursor, Claude Code, and other coding agents.

Licence

This package is available under PolyForm Noncommercial, Small Business, or a 32-day Free Trial. Free Trial is local or internal evaluation only — it does not cover a public page. See what you can do under the trial.

For a commercial licence, talk to us.

Support

Questions and community help: Discord.

版本与发布记录

@graphysdk/data-import-utils 共发布 429 个版本,首次发布于 2026/03/26;过去 12 个月发布了 429 个版本。

版本发布日期距今
1.9.0-beta.1794847602792latest2026/11/17今天
1.9.0-beta.17948408135452026/11/16今天
1.9.0-beta.17948401073962026/11/16今天
1.9.0-beta.17948274193392026/11/16今天
1.9.0-beta.17945866913282026/11/143 天前
1.9.0-beta.17945823311012026/11/133 天前

关于 @graphysdk/data-import-utils 的常见问题

@graphysdk/data-import-utils 是什么?

Parse CSV/TSV/JSON/spreadsheets into Graphy { columns, rows } data

如何安装 @graphysdk/data-import-utils?

在项目目录运行 npm install @graphysdk/data-import-utils,或使用 pnpm add / yarn add / bun add。

@graphysdk/data-import-utils 支持 TypeScript 吗?

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

@graphysdk/data-import-utils 支持 ESM 还是 CommonJS?

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

@graphysdk/data-import-utils 可以商用吗?

@graphysdk/data-import-utils 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@graphysdk/data-import-utils 的下载量有多少?

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

@graphysdk/data-import-utils 还在维护吗?

最新版本 1.9.0-beta.1794847602792 发布于 2026/11/17(今天);至今共发布 429 个版本,其中过去 12 个月发布了 429 个;首次发布于 2026/03/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。