@fayz-ai/plugin-agenda

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

Fayz SDK — 插件议程插件

中文使用文档
文档目录5 节
  1. 里面的东西
  2. 安装
  3. 使用量
  4. 费兹SDK的一部分
  5. 路线图贡献( I)

@fayz-ai/plugin-议程

将任何SaaS变为可订账业务的调度引擎.

npm license

状态 : β-前1.0 (中文(简体) ). 核心表面稳定;一些后端侧面(见 PLUGIN_PATTERNS.md)仍在着陆. API在1.0前可能会有变化.

每个服务业务都按日历进行。 萨隆斯书的造型师,诊所的书医,工作室的书房——同样的原始书房被严重地重建了一千次. plugin-agenda 是原始的一次完成: 一个资源意识日历 包含预约,块,工作时间,冲突检测,拖放, 都由配置而不是叉驱动.

它会变成任何 defineSaas 每个垂直的应用程序和重塑自己——预订类型,状态,专业/客户/服务查询,以及位置都是选项. 说对了 @fayz-ai/plugin-financial 和预订可以自动创建订单, 所以时间安排和收入保持同步 从第一次预约。 一个引擎,每个垂直,不重写.

里面的东西

  • 日历页 (单位:千美元)/agenda)——全卡伦达尔动力日/周/月/列表视图外加资源时间网,并有拖放和冲突探测功能.
  • 预订类型 ——任命,任务,和屏蔽外出,各自有自己的领域和规则;完全压倒一切.
  • 状态工作流程 ——已排定 ——已确认 ——正在进行中 ——已完成,加上取消 / 无显示,有时间可知.
  • 工作时间和时间表块 ——缓冲时间,最大同流,预订窗口,多位置选择.
  • AI 工具 —— 说 listAppointments, (中文(简体) ), createAppointment, (中文(简体) ), checkAvailability 自然语言排程.
  • 金融桥梁 ——可选交叉插件集成,自动创建订单并跟踪预订支付状态(createFinancialBridge, (中文(简体) ), computeCommissionAmount) (中文(简体) ).
  • Supabase-or-mock 数据提供者,设置标签,以及所建的i18n.

安装

npm install @fayz-ai/plugin-agenda

端点 : react, (中文(简体) ), react-dom中。运行时解码包括 @fayz-ai/core, (中文(简体) ), @fayz-ai/ui, (中文(简体) ), @fayz-ai/admin, (中文(简体) ), @fayz-ai/plugin-financial,还有FullCalendar.

使用量

import { defineSaas } from '@fayz-ai/admin'
import { createAgendaPlugin } from '@fayz-ai/plugin-agenda'

export const app = defineSaas({
  // ...
  plugins: [
    createAgendaPlugin({
      labels: { pageTitle: 'Bookings' },
      defaultCalendarView: 'resourceTimeGridWeek',
      businessHours: { startTime: '08:00', endTime: '20:00' },
      slotDuration: 30,
      autoCreateOrder: true,
      modules: { locationSelection: true },
    }),
  ],
})

费兹SDK的一部分

plugin-agenda 是任何由预订驱动的纵向(美容、健康、服务)的正门。 自然对接 @fayz-ai/plugin-financial 通过金融桥梁,和 @fayz-ai/plugin-reports 用于占用和收入分析.

路线图贡献( I)

建设并不断发展于开阔. 见 费兹SDK路线图 对于当前空白,缺失的特征,以及良好的第一问题.

版本与发布记录

@fayz-ai/plugin-agenda 共发布 101 个版本,首次发布于 2026/06/18;过去 12 个月发布了 101 个版本。

版本发布日期距今
0.27.34latest2026/11/112 天前
0.27.332026/11/113 天前
0.27.322026/11/113 天前
0.27.312026/11/067 天前
0.27.302026/11/068 天前
0.27.292026/11/068 天前

其他发布通道:next → 0.9.0-next.1,canary → 0.27.24-canary.20261028153856。

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

@fayz-ai/plugin-agenda 是什么?

Fayz SDK — 插件议程插件

如何安装 @fayz-ai/plugin-agenda?

在项目目录运行 npm install @fayz-ai/plugin-agenda,或使用 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/plugin-agenda 支持 TypeScript 吗?

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

@fayz-ai/plugin-agenda 支持 ESM 还是 CommonJS?

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

@fayz-ai/plugin-agenda 可以商用吗?

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

@fayz-ai/plugin-agenda 的下载量有多少?

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

@fayz-ai/plugin-agenda 还在维护吗?

最新版本 0.27.34 发布于 2026/11/11(2 天前);至今共发布 101 个版本,其中过去 12 个月发布了 101 个;首次发布于 2026/06/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。