# @galaxy-io/dls 中文文档

规范地址：https://npmcn.com/package/%40galaxy-io/dls/

版本：2\.13\.5
npm 元数据更新时间：2026-11-05T06:50:19.265Z
中文译文更新时间：2026-11-15T21:41:54.003Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40galaxy-io/dls
原文对照：https://npmcn.com/package/%40galaxy-io/dls/?lang=original
项目主页：https://github.com/galaxy-io/dls#readme
源码仓库：https://github.com/galaxy-io/dls

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

- 包体积（解压后）：8.4 MB，464 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：7 个
- peer 依赖：react ^18 \|\| ^19，three ^0\.183\.1 \|\| ^0\.184\.0，d3-scale ^4\.0\.2，d3-shape ^3\.2\.0，cronstrue ^3\.27\.0，react-dom ^18 \|\| ^19，rehype-raw ^7\.0\.0，remark-gfm ^4\.0\.1，lottie-react ^2\.4\.1，@biomejs/biome ^2\.5\.15，react-markdown ^10\.1\.0，@wyw-in-js/vite ^1\.1\.0，@codemirror/view ^6\.43\.1，@lezer/highlight ^1\.2\.3，@uiw/react-color ^2\.10\.3，@codemirror/state ^6\.6\.0，@babel/preset-react ^7\.24\.0，@tanstack/react-table ^8\.21\.3，@uiw/react-codemirror ^4\.25\.10，@uiw/codemirror-themes ^4\.25\.10，@tanstack/react-virtual ^3\.14\.2，@babel/preset-typescript ^7\.24\.0，@codemirror/autocomplete ^6\.20\.3，react-syntax-highlighter ^16\.1\.1，@uiw/codemirror-extensions-langs ^4\.25\.10
- 首次发布：2026-07-13T21:31:56.242Z
- 最新版本发布：2026-11-05T06:50:19.058Z
- 近 30 天下载量：2505（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 102 个）

## 中文简介

银河设计语言系统

## 安装

```sh
npm install @galaxy-io/dls
```

也可以使用：`pnpm add @galaxy-io/dls`、`yarn add @galaxy-io/dls`、`bun add @galaxy-io/dls`

## README

# @galaxy-io/dls (英语)

Galaxy Design Language System:一个用于Filament的React组件库,GX应用程序和每个Galaxy React表面. 单色,稠密,发线-静音;预编Linaria CSS通过CSS自定义属性来读取,因此一个主题开关从此不再重发应用程序.

![NPM Version](https://img.shields.io/npm/v/%40galaxy-io%2Fdls)

## 安装

```bash
pnpm add @galaxy-io/dls
```

22,反应18或19,无害环境管理。 重型单一组件库(图表、表格、代码编辑器、代码突出显示器、Markdown、克龙和颜色输入、3D和动画品牌标记)是可选的同位素; [正在启动](https://npmcn.com/package/%40galaxy-io/dls/docs/getting-started.md#install) 列出需要哪个子路径.

## 快开始

一个命令中的新应用程序:Vite与 DLS Linaria 预设,Biome与 DLS 规则, 三样式表, `GalaxyProvider`,和一个薄的 Filament 形状的应用程序:文件路由, ConnectRPC 在模拟运输上的查询,帧和两页.

```bash
pnpm create @galaxy-io/galaxy-app my-app
```

`--template blank` 仅写提供者和一页. [正在启动](https://npmcn.com/package/%40galaxy-io/dls/docs/getting-started.md#scaffold-an-app) 列出选项; 任何 Galaxy 应用程序的根都是这样:

```tsx
// Once, at the app root: component styles, tokens, fonts.
import "@galaxy-io/dls/styles.css";
import "@galaxy-io/dls/tokens.css";
import "@galaxy-io/dls/fonts.css";

import { PlusIcon } from "@phosphor-icons/react";
import Button, { ButtonVariant } from "@galaxy-io/dls/buttons/Button";
import Flex, { FlexDirection } from "@galaxy-io/dls/layout/Flex";
import Text, { TextSize, TextWeight } from "@galaxy-io/dls/text/Text";
import GalaxyProvider from "@galaxy-io/dls/theme/GalaxyProvider";

export function App() {
  return (
    <GalaxyProvider>
      <Flex direction={FlexDirection.COLUMN} gap={16} padding={24}>
        <Text as="h1" size={TextSize.HEADING_MD} weight={TextWeight.MEDIUM}>
          Sources
        </Text>
        <Flex gap={8}>
          <Button label="New source" icon={PlusIcon} />
          <Button label="Import" variant={ButtonVariant.SECONDARY} />
        </Flex>
      </Flex>
    </GalaxyProvider>
  );
}
```

-   从自己的子路径导入每个组件;其元件来自同一个模块. 没有枪管.
-   `GalaxyProvider` 是一根:主题(System / Dark / Light),上叠和土司.
-   用 Linaria 和符号存取器样式自己的代码 `t` (单位:千美元)`@galaxy-io/dls/theme/tokens/t`),设置为 `galaxyDls()` 从 `@galaxy-io/dls/vite`与 `"extends": ["@galaxy-io/dls/biome"]`。 。 。 .

## 文档

|  |  |
| --- | --- |
| [开始](https://npmcn.com/package/%40galaxy-io/dls/docs/getting-started.md) | 安装、 Vite、 样式表、 提供者、 SSR |
| [他们](https://npmcn.com/package/%40galaxy-io/dls/docs/theming.md) | 主题和每个标志 |
| [构成部分](https://npmcn.com/package/%40galaxy-io/dls/docs/components.md) | 每个组件,何时使用,例 |
| [模式](https://npmcn.com/package/%40galaxy-io/dls/docs/patterns.md) | 银河屏幕的构建方式 |
| [无障碍](https://npmcn.com/package/%40galaxy-io/dls/docs/accessibility.md) | 地板和键盘地图 |
| [从 1.x 移动](https://npmcn.com/package/%40galaxy-io/dls/docs/MIGRATION.md) | 代码和自1.6.1以来的每一个变化 |
| [捐款](https://npmcn.com/package/%40galaxy-io/dls/docs/contributing.md) | 致力于建立这一存储库( :[一般事务人员(其他职等)](https://npmcn.com/package/%40galaxy-io/dls/AGENTS.md) (有规则) |
| [故事书](https://storybook.getgalaxy.io/) | 两个主题的每个组成部分,道具和状态 |

## 从 1.x 移动

```bash
npx @galaxy-io/dls-codemod src --report dls-migrate.json
```

代码重写所有机械设备 并标出其余的 `@dls-migrate <id>` 评论意见; [文献/地图](https://npmcn.com/package/%40galaxy-io/dls/docs/MIGRATION.md) 解释每一个身份.

## 克劳德的技巧

[`skills/galaxy-ui`](https://npmcn.com/package/%40galaxy-io/dls/skills/galaxy-ui/SKILL.md) 教克洛德用这个软件包设计、构建和构建 Galaxy 应用程序:应用程序架构 `create-galaxy-app` 脚手架(堆放,文件和命名,路由和URL状态,ConnectRPC数据层和模拟,屏幕贝壳,形式,可挂载模块),品牌规则,组件决定表,符号,图案和完整的屏幕食谱. 它的 DLS 示例会根据此寄存器进行类型检查( Name`pnpm skill:check`) (中文(简体) ).

-   **克劳德代码 :** 将文件夹复制到您的技能目录 : `cp -R skills/galaxy-ui ~/.claude/skills/` (或项目) `.claude/skills/`) (中文(简体) ).
-   **Claude 应用程序 :** 运行 `pnpm skill:pack` 上传 `dist-skill/galaxy-ui.zip` 作为技能(安置) 能力(技能).

细节 : [技能/银河水/README.md](https://npmcn.com/package/%40galaxy-io/dls/skills/galaxy-ui/README.md)。 。 。 .

## 常见问题

### @galaxy-io/dls 是什么？

银河设计语言系统

### 如何安装 @galaxy-io/dls？

在项目目录运行 npm install @galaxy-io/dls，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18 \|\| ^19）、react-dom（^18 \|\| ^19）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @galaxy-io/dls 支持 TypeScript 吗？

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

### @galaxy-io/dls 支持 ESM 还是 CommonJS？

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

### @galaxy-io/dls 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @galaxy-io/dls 可以商用吗？

@galaxy-io/dls 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @galaxy-io/dls 的下载量有多少？

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

### @galaxy-io/dls 还在维护吗？

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