@fayz-ai/pos

中文文档
0.27.18发布于 2026/11/11MITTypeScriptES Module近 30 天下载 8987

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

中文使用文档
文档目录4 节
  1. 里面的东西
  2. 安装
  3. 使用量
  4. 费兹SDK的一部分

@fayz-ai/pos (英语)

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

npm 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+字轴上的位置状态

安装

npm install @fayz-ai/pos

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

使用量

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

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

运行的狗食应用是 FayaLabs/厨师 ——餐厅简介,真正的PWA和E2E套房. 它是垂直配置的归属;这个包保留了引擎.

费兹SDK的一部分

版本与发布记录

@fayz-ai/pos 共发布 69 个版本,首次发布于 2026/09/18;过去 12 个月发布了 69 个版本。

版本发布日期距今
0.27.18latest2026/11/112 天前
0.27.172026/11/113 天前
0.27.162026/11/068 天前
0.27.152026/11/059 天前
0.27.142026/11/0410 天前
0.27.132026/10/3015 天前

其他发布通道:canary → 0.27.13-canary.20261028153856。

关于 @fayz-ai/pos 的常见问题

@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 和提交记录判断。