# @bitspark-ai/design 中文文档
规范地址：https://npmcn.com/package/%40bitspark-ai/design/
版本：0\.39\.1
npm 元数据更新时间：2026-11-05T14:26:08.925Z
中文译文更新时间：2026-11-08T04:48:05.669Z
软件包许可：UNLICENSED
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40bitspark-ai/design
原文对照：https://npmcn.com/package/%40bitspark-ai/design/?lang=original
项目主页：https://github.com/Bitspark/bitagent-design#readme
源码仓库：https://github.com/Bitspark/bitagent-design
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：1.9 MB，720 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：svelte ^5\.55\.1
- 首次发布：2026-06-13T22:55:39.448Z
- 最新版本发布：2026-11-05T14:26:08.605Z
- 近 30 天下载量：24219（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：47（近 12 个月 47 个）
## 中文简介
Bitspark设计系统——指代,Svelte 5组件,以及活性显示时钟.
## 安装
```sh
npm install @bitspark-ai/design
```
也可以使用：`pnpm add @bitspark-ai/design`、`yarn add @bitspark-ai/design`、`bun add @bitspark-ai/design`
## README
# @ bitspark-ai/ 设计
Bitspark 设计系统 — 设计符号, Svelte 5 组件, 框架纯 UI 食谱和反应性显示时钟 在一个分解器下作为一个包裹运出.
从私人来源发表, **可安装, 无注册认证**。 。 。 .
```sh
npm i @bitspark-ai/design
# Svelte 5 is a peer dependency — the consumer supplies it:
npm i svelte
```
## 快开始
装入符号 + 基准样式表一次( 需要- 组件通过 ,然后从桶中导入组件和公用事业:
```js
// once, at your app root:
import '@bitspark-ai/design/css';
```
```svelte
```
## 里面的东西
- **98个构成部分** ——原始人(按钮,徽章,图标,卡.),数据与公制表面 (数据表、StatCard、Meter、DecayMeter、Sparkline、BarChart...),导航和外壳 (Appshell, SideNav, MarketingNav, Breadcrumbs...),活生生的(LiveStatus Bar,活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活, Liveness status, Lane / Lane Group / Connector Node...),以及更衣家族 (释放Feed,释放Banner...). 每个组件的元数据都可以通过机器读取 [`./catalog`](https://npmcn.com/package/%40bitspark-ai/design/#readme-subpath-exports)。 。 。 .
- **设计符号** ——颜色,表面,间隔,类型,以及CSS自定义的运动符号 属性( e)`./css`, (中文(简体) ), `./*.css`并且作为联署材料的数值(`./tokens`) (中文(简体) ).
- **UI 食谱动作( A)** 小型、框架纯净、可树动的公用事业出口 从枪管:
- _格式化_ —— 说 `clockDuration`, (中文(简体) ), `formatBytes`, (中文(简体) ), `formatRelativeTime`
- _状态颜色( c)_ —— 说 `classifyFreshness`, (中文(简体) ), `thresholdColor`, (中文(简体) ), `utilizationColor`, (中文(简体) ), `rowStateClasses`, (中文(简体) ), `deltaText`
- _规模收藏_ —— 说 `pressure` (占用+热), `staleness` (时间~温暖~寒冷), `adaptive` (按人数计)
- _动议_ —— 说 `use:travel` (按键FLIP移动)和 `use:flight` (来源-目标输入),加 `prefersReducedMotion`, (中文(简体) ), `valueChange`, (中文(简体) ), `motionMs`
- _导航( misc)_ —— 说 `paginationMode`, (中文(简体) ), `collapseBreadcrumbs`, (中文(简体) ), `tabIndicator`, (中文(简体) ), `toastStore`
- **`./time`** 反应式显示时钟和时间格式(期限、相对时间、, 安全地在同一个铸币局下分享.
所有公用事业都装有完整的JSDoc;从 `@bitspark-ai/design` 和您的编辑器 显示签名.
## 子路径导出
| 导入 | 什麽 |
| --- | --- |
| `@bitspark-ai/design` | 组件+配方+动作(桶) |
| `@bitspark-ai/design/css` | 组合符号 + 基样式表( 导入一次) |
| `@bitspark-ai/design/tokens` | 作为JS 输入值的设计符号 |
| `@bitspark-ai/design/base.css` • 妇女 `/motion.css` • 妇女 `/portal.css` | 单个样式层 |
| `@bitspark-ai/design/time` | 被动显示时钟+时间格式 |
| `@bitspark-ai/design/catalog` | 可读元数据 |
| `@bitspark-ai/design/roles` | 构成部分角色/实物分类 |
## 框架
与 `svelte-package` - 5艘源船 `dist/` (不是预先编译的),所以 您的捆绑者在您的应用程序的 Svelte 上下文中编译它 。 丝绒 `^5.55.1` 是一个 **依赖性**。组件为 **框架纯度**: 无 SvelteKit `$app/*` 进口 - 导航通过一个 `resolveHref` 任何Svelte 5的应用程序都可以使用 套装 CSS带副作用(`sideEffects: ["**/*.css"]`),所以你的捆绑者保留 在未使用 JS 时导入样式 .
## 许可证
`UNLICENSED` ——世界可安装,所有权利保留. 非开源; 可从 一个没有认证的私人来源。 术语见寄存器.
## 常见问题
### @bitspark-ai/design 是什么？
Bitspark设计系统——指代,Svelte 5组件,以及活性显示时钟\.
### 如何安装 @bitspark-ai/design？
在项目目录运行 npm install @bitspark-ai/design，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：svelte（^5\.55\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @bitspark-ai/design 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @bitspark-ai/design 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @bitspark-ai/design 可以商用吗？
@bitspark-ai/design 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。
### @bitspark-ai/design 的下载量有多少？
根据 npm 官方下载统计，@bitspark-ai/design 在 2026/10/08 – 2026/11/06 这 30 天内被下载 24,219 次，日均约 807 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @bitspark-ai/design 还在维护吗？
最新版本 0\.39\.1 发布于 2026/11/05（2 天前）；至今共发布 47 个版本，其中过去 12 个月发布了 47 个；首次发布于 2026/06/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。