# @betorigami/game-ui-wheel 中文文档
规范地址：https://npmcn.com/package/%40betorigami/game-ui-wheel/
版本：1\.2\.0
npm 元数据更新时间：2026-11-04T20:15:41.714Z
中文译文更新时间：2026-11-07T23:50:41.892Z
软件包许可：UNLICENSED
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40betorigami/game-ui-wheel
原文对照：https://npmcn.com/package/%40betorigami/game-ui-wheel/?lang=original
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：1.2 MB，30 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：lit ^3\.3\.0，big\.js ^7\.0\.1，@lit/context ^1\.1\.5
- 首次发布：2026-09-21T00:24:08.036Z
- 最新版本发布：2026-11-04T20:15:41.506Z
- 近 30 天下载量：3385（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）
## 中文简介
轮子游戏的Lit组件及其为 Origami 游戏主机的 GameUiModule
## 安装
```sh
npm install @betorigami/game-ui-wheel
```
也可以使用：`pnpm add @betorigami/game-ui-wheel`、`yarn add @betorigami/game-ui-wheel`、`bun add @betorigami/game-ui-wheel`
## README
# @betorigami/游戏-i-轮
轮式游戏的 Lit 组件及其 `GameUiModule`。这是一个库:导入它定义了轮元和导出 `wheelUiModule` 财务报告和审定财务报表 `WheelGame`,而装入该模块的主机会注册该模块.
```ts
import { registerGameUiModule } from '@betorigami/game-ui-shared';
import { wheelUiModule } from '@betorigami/game-ui-wheel';
registerGameUiModule(wheelUiModule);
```
现在 `@betorigami/games` 是这个主机, 并捆绑这个软件包与所有其他游戏。 一个独立的 后轮捆是同一个三行,只有这个模块.
## 独立捆绑
`dist/standalone.mjs` 是一个可部署的软件包:工具包、主机元素、Lit和这个模块在一个文件中,进行自我登记。 页面装入它替换 `games` 捆绑为轮自己服务:
```html
```
页面装入此或该 `games` 捆绑,从来没有两者。 核查者的基础 URL 读取自 `VITE_PROVABLY_FAIR_VERIFIER_URL` 在构建时间, 如 `games` 已经.
## 依赖关系
`lit`, (中文(简体) ), `@lit/context` 财务报告和审定财务报表 `big.js` 是同伴的依赖性:每一页上都可能有一份副本,由主机提供. `@betorigami/game-ui-shared` 是一个普通的依赖,通过工作空间链接,并作为该套件的准确套件版本发布;每个套件的发布也发布此套件 `games` 在同一个版本,所以一个页面仍然持有一个工具包. `@betorigami/game-wheel` 财务报告和审定财务报表 `@betorigami/game-engine` 是普通的依赖, 被固定在服务器运行的相同版本上, 所以UI所披露的乘数和概率是引擎所付的; 主机必须固定相同的引擎版本.
## 他们
取自 CSS 自定义属性 `--wheel-color-*`,其默认值存在于主机主题样式表(`themes/default.css` 资产域),不在此包中。 合伙人在那边控制他们. `--wheel-color-zero`,并且每个奖金档次函各有一个财产是合同;见 `src/wheel.constants.ts` 完整名单.
## 常见问题
### @betorigami/game-ui-wheel 是什么？
轮子游戏的Lit组件及其为 Origami 游戏主机的 GameUiModule
### 如何安装 @betorigami/game-ui-wheel？
在项目目录运行 npm install @betorigami/game-ui-wheel，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：lit（^3\.3\.0）、big\.js（^7\.0\.1）、@lit/context（^1\.1\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @betorigami/game-ui-wheel 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @betorigami/game-ui-wheel 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @betorigami/game-ui-wheel 可以商用吗？
@betorigami/game-ui-wheel 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。
### @betorigami/game-ui-wheel 的下载量有多少？
根据 npm 官方下载统计，@betorigami/game-ui-wheel 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,385 次，日均约 113 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @betorigami/game-ui-wheel 还在维护吗？
最新版本 1\.2\.0 发布于 2026/11/05（3 天前）；至今共发布 27 个版本，其中过去 12 个月发布了 27 个；首次发布于 2026/09/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。