# @fayz-ai/pos 中文文档

规范地址：https://npmcn.com/package/%40fayz-ai/pos/

版本：0\.27\.18
npm 元数据更新时间：2026-11-11T14:53:49.706Z
中文译文更新时间：2026-11-14T12:10:03.301Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fayz-ai/pos
原文对照：https://npmcn.com/package/%40fayz-ai/pos/?lang=original

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

- 包体积（解压后）：2.7 MB，224 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，zustand ^4\.5\.0 \|\| ^5\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0，lucide-react \>=0\.400\.0 \<1\.0\.0
- 首次发布：2026-09-18T15:17:41.193Z
- 最新版本发布：2026-11-11T14:53:49.491Z
- 近 30 天下载量：8987（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：69（近 12 个月 69 个）

## 中文简介

Fayz SDK POS 层——操作员表面:一页,触取和键盘,每个垂直参数化

## 安装

```sh
npm install @fayz-ai/pos
```

也可以使用：`pnpm add @fayz-ai/pos`、`yarn add @fayz-ai/pos`、`bun add @fayz-ai/pos`

## README

# @fayz-ai/pos (英语)

> 接线员表面:一页,触和键盘同时.

[![npm](https://img.shields.io/npm/v/@fayz-ai/pos.svg)](https://www.npmjs.com/package/@fayz-ai/pos) [![license](https://img.shields.io/npm/l/@fayz-ai/pos.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)

**状态 :** alpha – 在积极开发中,APIs会改变.

`@fayz-ai/admin` 是后台的外壳. `@fayz-ai/pos` 是班机的外壳:一个服务员在周六的出勤时使用的屏幕和一个出纳员在Bematech终端上使用10年的肌肉记忆. 同样的契约,相反的原则——没有铁路,没有面包屑,没有深通航,没有桌子密度. 操作员需要的一切都在一个页面上,因为离开该页面服务中段就是这个软件包存在的防止的失败.

这不是餐厅的套餐 一家餐厅有桌子和分页,营业时间为3小时;一家书店有柜台和销售,在注册处诞生并死亡. 两者都是不同的屏幕 `PosAppConfig` ——屏幕从不读出"mesa",它读出"配置"所说的"事".

## 里面的东西

-   **应用配置** —— 说 `PosAppConfig`: 位置表层(`floor` 编号 : `list` 编号 : `none`),销售周期(`open_tab` 编号 : `immediate`),词汇,动作栏,支付方法
-   **一页** —— 说 `PosScreen`:位置图,活口票,目录,固定动作栏,开板船坞
-   **车票引擎** —— 说 `ticketReducer`, (中文(简体) ), `totalsOf`: 增加一个项是附加,所以两个服务员按同一个表和,而不是互相覆盖
-   **钱** —— 说 `formatCents`, (中文(简体) ), `splitEvenly`, (中文(简体) ), `serviceChargeCents`:只有一分钱,分出一分钱,从不损失,也不发明一分钱
-   **键盘运行时间** —— 说 `createKeymap`: 一次声明的装订, 由运行时间和 _在按钮上绘制_ 被UI
-   **主题** —— 说 `@fayz-ai/pos/theme`: 触摸大小作为符号 (≥19mm 地板), 贴面作为类别身份, 其口音+icon+字轴上的位置状态

## 安装

```bash
npm install @fayz-ai/pos
```

端点 : `react` (^18/^19), (中文(简体) ), `lucide-react`, (中文(简体) ), `zustand`。拉进 `@fayz-ai/core`。 。 。 .

## 使用量

```tsx
import { PosScreen } from '@fayz-ai/pos'

<PosScreen
  config={restaurantConfig}
  categories={categories}
  items={items}
  positions={positions}
  terminalName="Caixa 1"
  onAction={handleAction}
/>
```

运行的狗食应用是 [FayaLabs/厨师](https://github.com/FayaLabs/chef-pos) ——餐厅简介,真正的PWA和E2E套房. 它是垂直配置的归属;这个包保留了引擎.

## 费兹SDK的一部分

## 常见问题

### @fayz-ai/pos 是什么？

Fayz SDK POS 层——操作员表面:一页,触取和键盘,每个垂直参数化

### 如何安装 @fayz-ai/pos？

在项目目录运行 npm install @fayz-ai/pos，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、zustand（^4\.5\.0 \|\| ^5\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）、lucide-react（\>=0\.400\.0 \<1\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fayz-ai/pos 支持 TypeScript 吗？

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

### @fayz-ai/pos 支持 ESM 还是 CommonJS？

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

### @fayz-ai/pos 可以商用吗？

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

### @fayz-ai/pos 的下载量有多少？

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

### @fayz-ai/pos 还在维护吗？

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