# @escalated-dev/escalated 中文文档

规范地址：https://npmcn.com/package/%40escalated-dev/escalated/

版本：0\.12\.10
npm 元数据更新时间：2026-11-07T17:58:34.048Z
中文译文更新时间：2026-11-13T22:05:20.561Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40escalated-dev/escalated
原文对照：https://npmcn.com/package/%40escalated-dev/escalated/?lang=original
项目主页：https://github.com/escalated-dev/escalated
源码仓库：https://github.com/escalated-dev/escalated

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

- 包体积（解压后）：2.4 MB，278 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：vue ^3\.3\.0，@inertiajs/vue3 ^1\.0\.0 \|\| ^2\.0\.0 \|\| ^3\.0\.0
- 首次发布：2026-02-08T16:50:11.678Z
- 最新版本发布：2026-11-07T17:58:33.685Z
- 近 30 天下载量：5570（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

Vue 3 + Inertia.js UI 用于 Escaled 的组件 “可嵌入式辅助票系统

## 安装

```sh
npm install @escalated-dev/escalated
```

也可以使用：`pnpm add @escalated-dev/escalated`、`yarn add @escalated-dev/escalated`、`bun add @escalated-dev/escalated`

## README

[العربية](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.ar.md) 二. 支助 [德国](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.de.md) 二. 支助 **联合国** 二. 支助 [西班牙语Name](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.es.md) 二. 支助 [法国语Name](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.fr.md) 二. 支助 [意大利语](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.it.md) 二. 支助 [日本語](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.ja.md) 二. 支助 [한국어](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.ko.md) 二. 支助 [荷兰](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.nl.md) 二. 支助 [波尔斯基](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.pl.md) 二. 支助 [葡萄牙语( BR)](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.pt-BR.md) 二. 支助 [Русский](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.ru.md) 二. 支助 [蒂尔克切](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.tr.md) 二. 支助 [简体中文](https://npmcn.com/package/%40escalated-dev/escalated/docs/translations/README.zh-CN.md)

# ![](https://escalated.dev/apple-touch-icon.png) 升级

[![Tests](https://github.com/escalated-dev/escalated/actions/workflows/run-tests.yml/badge.svg)](https://github.com/escalated-dev/escalated/actions/workflows/run-tests.yml)[![npm](https://img.shields.io/npm/v/@escalated-dev/escalated)](https://www.npmjs.com/package/@escalated-dev/escalated) [![npm downloads](https://img.shields.io/npm/dm/@escalated-dev/escalated)](https://www.npmjs.com/package/@escalated-dev/escalated) [![Vue 3](https://img.shields.io/badge/vue-3.x-4FC08D?logo=vue.js&logoColor=white)](https://vuejs.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Views](https://hits.sh/github.com/escalated-dev/escalated.svg?style=flat&label=views&color=007ec6)](https://hits.sh/github.com/escalated-dev/escalated/)

[![Escalated — support tickets, built into your app](https://npmcn.com/package/%40escalated-dev/escalated/.github/og.png)](https://escalated.dev/)

升级(英語:Escaled)是一个可嵌入式的支持票系统,有SLA跟踪,升级规则,代理工作流程,以及客户门户. 此repo包含每个被支持后端框架中使用的所有共享前端资产(Vue 3 + Inertia.js).

👉 **学习更多,查看演示,比较 Cloud 和 Self-Hosted 选项** **[https://escalated.dev (英语)](https://escalated.dev/)**

**你不直接安装这个软件包.** 从您框架的后端软件包开始——它处理一切,包括拉出这些前端资产.

![Escalated demo: on Pinecone, a made-up notes app, a customer files a ticket from the support widget themed in the app's green, then, in the dark agent panel, an agent opens it from the inbox, assigns it, replies and sets the status](https://npmcn.com/package/%40escalated-dev/escalated/.github/profile/demo.gif)

## 特征

-   **罚单拆分** ——在保留上下文的同时,将回复分为新的独立票
-   **车票打呼噜** - Snooze的票,预设(1h,4h,明天,下周)和自动醒来
-   **已保存视图/ 自定义队列** —— 保存、 名称和共享过滤器预设为可重复使用的票面视图
-   **可嵌入支持部件** ——入场 `<script>` 带有 KB 搜索、 票单和状态检查的部件
-   **实时更新** ——网球支持(Pusher/Reverb/Soketi)自动倒计时
-   **知识库切换** ——启用或禁用管理环境的公共知识库
-   **CI: ESLint + Pretier 软件** ——每个拉出请求的自动代码样式执行

## 开始

选择框架 :

| 框架 | 还原 | 安装 |
| --- | --- | --- |
| **拉威尔** | [升级-去除/升级-拉拉](https://github.com/escalated-dev/escalated-laravel) | `composer require escalated-dev/escalated-laravel` |
| **铁路** | [升级-脱/升级-铁路](https://github.com/escalated-dev/escalated-rails) | `gem "escalated"` |
| **强哥** | [升级的- dev/升级的-django](https://github.com/escalated-dev/escalated-django) | `pip install escalated-django` |
| **阿多尼斯·贾克** | [升级-分解/分解-分解](https://github.com/escalated-dev/escalated-adonis) | `npm install @escalated-dev/escalated-adonis` |
| **文字压力** | [升级-去/去升级-字压](https://github.com/escalated-dev/escalated-wordpress) | [下载升级.zip](https://github.com/escalated-dev/escalated-wordpress/releases/latest) |
| **档案** | [升级-分解/分解-分解](https://github.com/escalated-dev/escalated-filament) | `composer require escalated-dev/escalated-filament` |
| **原生反应** | [升级-去除/升级-反应-内在](https://github.com/escalated-dev/escalated-react-native) | `npm install @escalated-dev/escalated-react-native` |
| **小蝶头** | [升级-分解/分解-分解](https://github.com/escalated-dev/escalated-flutter) | 见 [阴极. yaml 设置](https://github.com/escalated-dev/escalated-flutter#quick-start) |

每个后端repo都有完整的设置指令——安装命令,迁移,配置,以及前端集成.

## 将管理员嵌入您自己的管理员面板( 可选)

Escaled带有自己的独立管理员面板,这可以保持默认值. 如果您的应用程序已有管理面板, 您可以选择显示 Escaled 的管理 取而代之的是屏幕:在您的侧边栏和页眉下,您的 URL 前缀和 您的中间软件, 带有 Escaled 的菜单 可以在您的侧边栏中制作 . 除非你打开它,否则一切不变.

三种方法,取决于你的管理人员:

-   **Vue + Inertia 管理员**: Escaled的管理页面使你的体内没有铬 版式 (`app.use(EscalatedPlugin, { layout, layoutScope: ['admin'] })`),以及 `<EscalatedNavigation />` 在边栏列出管理员菜单.
-   **服务器管理员** (布莱德,ERB,Django模板,.):您的管理模板 成为嵌入式页面的 Inertia 根视图.
-   **还有什么**: 包含一个小 `postMessage` 协议 高度、主题和导航`@escalated-dev/escalated/embed`) (中文(简体) ).

指南: [前端](https://npmcn.com/package/%40escalated-dev/escalated/docs/embedding-admin.md) • 妇女 [拉威尔](https://github.com/escalated-dev/escalated-laravel/blob/main/docs/embedding-admin.md) • 妇女 [铁路](https://github.com/escalated-dev/escalated-rails/blob/main/docs/embedding-admin.md) • 妇女 [强哥](https://github.com/escalated-dev/escalated-django/blob/main/docs/embedding-admin.md) • 妇女 [阿多尼斯·贾克](https://github.com/escalated-dev/escalated-adonis/blob/main/docs/embedding-admin.md) • 妇女 [网点JS](https://github.com/escalated-dev/escalated-nestjs/blob/main/docs/embedding-admin.md) • 妇女 [共鸣](https://github.com/escalated-dev/escalated-symfony/blob/master/docs/embedding-admin.md) • 妇女 [凤凰](https://github.com/escalated-dev/escalated-phoenix/blob/master/docs/embedding-admin.md) • 妇女 [走开](https://github.com/escalated-dev/escalated-go/blob/main/docs/embedding-admin.md) • 妇女 [. NET 网络](https://github.com/escalated-dev/escalated-dotnet/blob/main/docs/embedding-admin.md) • 妇女 [春节](https://github.com/escalated-dev/escalated-spring/blob/main/docs/embedding-admin.md) • 妇女 [文字压力](https://github.com/escalated-dev/escalated-wordpress/blob/main/docs/embedding-admin.md)。 。 。 . Laravel是参考执行;其他后端正在添加.

## 尾风 CSS

梯级组件使用Tailwind CSS的公用类(由140+Vue文件组成的~上百个). **一些与 Tailwind相容的类处理器必须在主机应用程序中可用,以便 UI 正确渲染** ——如果没有一个,每个组件都会使DOM成为无名的DOM,其类名不能解决任何CSS.

### 建议: 现有建筑中的尾风

如果您的主机应用程序已经通过 Vite / PostCSS / Tailwind CLI 使用 Tailwind , 请将此软件包添加到您的 `content` 装腔作势,不让班级被清洗:

```js
// tailwind.config.js
export default {
    content: [
        // ... your existing paths
        './node_modules/@escalated-dev/escalated/src/**/*.vue',
    ],
}
```

> **尾风 4+ 用户 :** `content` glubs是从导入模块中自动发现的——你通常不需要添加任何东西. 跳过这个步骤 如果你在v4.

### 使用无 Tailwind 构建步骤的 Escaled

如果你不想在建造的管道中装上"泰尔风"工具链,你有一些选择. 每个项目都有取舍——选择最接近项目限制的:

| 选项 | 何时使用 | 怎么样 |
| --- | --- | --- |
| **尾风播放 CDN** | 原型,内部工具,演示. 不推荐生产( 不清除, ~ 3 MB 脚本标签) . | 添加 `<script src="https://cdn.tailwindcss.com"></script>` 以至使升级的一页。 CDN剧本JIT编译班在运行时间. |
| **尾风独立的CLI** | 您想要一个没有 npm/ Vite 的静态样式表 . | 下载 [独立的 CLI 二进制](https://tailwindcss.com/blog/standalone-cli) 运行 `tailwindcss -i input.css -o public/escalated.css --content './node_modules/@escalated-dev/escalated/src/**/*.vue' --minify`。将输出样式表与页面链接. |
| **UnoCSS / 双向编解模式** | 已经使用了其中一台原子-CSS引擎. | 配置有 Tailwind 预设(`@unocss/preset-wind` 或者说 `@twind/preset-tailwind`)并添加Escalated包路径到引擎的扫描配置中. 阶级语义相通. |
| **使用手卷 CSS 伪造** | 你绝对不能运送任何与尾风相容的工具 并且愿意维持一个叉子. | 用每个组件的CSS范围替换通用类别。 大力而为;未得到官方支持. |

如果这些都不合适,请 [开始讨论](https://github.com/escalated-dev/escalated/discussions) 这样我们就可以理解这个制约,考虑一个预先编译的CSS分布.

无论你选择哪条路,也要确保 [主题符号](https://npmcn.com/package/%40escalated-dev/escalated/#readme-theming) (CSS自定义属性)被应用——这些控制颜色,间隔和半径并独立于Tailwind.

## 他们

Escaled 默认会让内部的布局独立化. 为了融入你的应用软件设计系统 `EscalatedPlugin`数字 :

```js
import { createApp } from 'vue'
import { EscalatedPlugin } from '@escalated-dev/escalated'
import AppLayout from '@/Layouts/AppLayout.vue'

const app = createApp(...)

app.use(EscalatedPlugin, {
    layout: AppLayout,
    theme: {
        primary: '#3b82f6',
        radius: '0.75rem',
    }
})
```

### 布局集成

通过您的应用程序的布局组件和 Escaled 的 **客户页** (罚单) 门户和知识库)在其中产生. 管理员和代理人小组 他们自己的导航默认。 布局组件必须接受 `#header` 位置和默认位置 :

```vue
<!-- Your layout must support these slots -->
<template>
    <div>
        <nav>...</nav>
        <header><slot name="header" /></header>
        <main><slot /></main>
    </div>
</template>
```

在不提供布局时,Escaled使用自己的内置导航栏.

使您的布局中的管理员( 以及可选的代理工作空间) 为 好吧,列出这些章节 `layoutScope`管理页面,然后不 Escaled 的侧边栏和上边栏, 页面标题在您的 `#header` 位置 :

```js
app.use(EscalatedPlugin, {
    layout: AdminLayout,
    layoutScope: ['customer', 'admin'], // default: ['customer']
})
```

这是可选的,只有在设置时才会改变任何东西。 见 [将管理员嵌入您的管理员面板](https://npmcn.com/package/%40escalated-dev/escalated/#readme-embedding-the-admin-in-your-own-admin-panel-optional)。 。 。 .

### CSS 自定义属性

这个 `theme` 选项设置 CSS 自定义属性, 您可以在自己的样式中引用 :

| 财产 | 默认 | 说明 |
| --- | --- | --- |
| `--esc-primary` | `#4f46e5` | 主动作颜色 |
| `--esc-primary-hover` | 自定义 | 主悬浮颜色 |
| `--esc-radius` | `0.5rem` | 输入和按钮的边框半径 |
| `--esc-radius-lg` | 自动缩放 | 纸牌和面板的边界半径 |
| `--esc-font-family` | 继承 | 字体家族覆盖 |

### 行政和代理小组

`theme.panel` 显示管理员和代理面板:导航、页眉、标志 平板,连接和表面,以暗或光模式. 两个面板都塌了 在 1024px 下方的菜单按钮后导航。 见 [医生/医生](https://npmcn.com/package/%40escalated-dev/escalated/docs/theming.md) 每一个标志.

### 框架实例

**拉威尔** (Inertia + Vue 3): (英语)

```js
import { EscalatedPlugin } from '@escalated-dev/escalated'
import AuthenticatedLayout from '@/Layouts/AuthenticatedLayout.vue'

app.use(EscalatedPlugin, { layout: AuthenticatedLayout })
```

**铁路** (Inertia + Vue 3): (英语)

```js
import { EscalatedPlugin } from '@escalated-dev/escalated'
import AppLayout from '@/layouts/AppLayout.vue'

app.use(EscalatedPlugin, { layout: AppLayout })
```

**强哥** (Inertia + Vue 3): (英语)

```js
import { EscalatedPlugin } from '@escalated-dev/escalated'
import BaseLayout from '@/layouts/BaseLayout.vue'

app.use(EscalatedPlugin, { layout: BaseLayout })
```

**阿多尼斯·贾克** (Inertia + Vue 3): (英语)

```js
import { EscalatedPlugin } from '@escalated-dev/escalated'
import AppLayout from '@/layouts/AppLayout.vue'

app.use(EscalatedPlugin, { layout: AppLayout })
```

## 这回波里有什么

所有Vue 3 + Inertia.js 组件为 Escaled UI 提供动力. Laravel、Rails、Django和AdonisJS等地都是相同的——后端框架使它们通过Inertia.

## QQ 屏幕截图

> 屏幕截图由Storybook通过 [组件截图](https://npmcn.com/package/%40escalated-dev/escalated/.github/workflows/screenshots.yml) 工作流程.

**行政小组(黑暗)**  
![Escalated Admin Panel — dark mode with sidebar navigation, KPI cards, stats, and ticket list](https://npmcn.com/package/%40escalated-dev/escalated/docs/assets/escalated_admin_1.png)

**行政小组(灯光)**  
![Escalated Admin Panel — light mode with sidebar navigation, KPI cards, stats, and ticket list](https://npmcn.com/package/%40escalated-dev/escalated/docs/assets/escalated_admin_3.png)

**代理收件箱**  
![Escalated agent inbox in dark mode: queue rail with saved views and counts, stat strip, and the ticket list beside an empty detail pane](https://npmcn.com/package/%40escalated-dev/escalated/docs/assets/escalated_ticket_list.png)

**代理面板( 灯光)**  
![Escalated agent panel in light mode: a ticket open beside the inbox list](https://npmcn.com/package/%40escalated-dev/escalated/docs/assets/escalated_admin_2.png)

**车票视图**  
![Escalated ticket view in dark mode: inbox list beside the ticket with status, priority, tags, conversation, and the reply composer](https://npmcn.com/package/%40escalated-dev/escalated/docs/assets/escalated_ticket_view.png)

### 页 次

**客户端门户** ——自助票管理

-   `pages/Customer/Index.vue` ——带有状态过滤和搜索的出票列表
-   `pages/Customer/Create.vue` — 带有文件附件的新票单
-   `pages/Customer/Show.vue` ——带回音线的出票细节

**代理设计板** ——出票队列和工作流程

-   `pages/Agent/Dashboard.vue` ——Stats概况和近期票房
-   `pages/Agent/TicketIndex.vue` — 可过滤的票队列
-   `pages/Agent/TicketShow.vue` ——有侧边栏,内部笔记,罐装回音的全票取景

**行政小组** ——系统配置

-   `pages/Admin/Reports.vue` - 分析仪表板
-   `pages/Admin/Departments/` - 部门CRUD
-   `pages/Admin/SlaPolicies/` - 苏丹解放军政策管理
-   `pages/Admin/EscalationRules/` - 梯级规则构建器
-   `pages/Admin/Tags/` - 标签管理
-   `pages/Admin/CannedResponses/` - 罐装反应模板

### 共享组件

上面各页使用的可重复使用的构件.

| 构成部分 | 说明 |
| --- | --- |
| `StatusBadge` | 彩色票证状态 |
| `PriorityBadge` | 票价优先的彩色徽章 |
| `TicketList` | 彩票表 |
| `ReplyThread` | 时间顺序回复显示 |
| `ReplyComposer` | 带有文件上传和罐装反应插入的回覆/注解编辑器 |
| `ActivityTimeline` | 票证活动的审计记录 |
| `SlaTimer` | 苏丹解放军倒计时和违反/警告状态 |
| `TicketFilters` | 状态、优先权、代理、部门过滤栏 |
| `TicketSidebar` | 票面细节侧边栏( 状态, SLA, 标记, 活动) |
| `AssigneeSelect` | 代理任务下降 |
| `TagSelect` | 多选择的标签拾取器 |
| `FileDropzone` | 拖放文件上传 |
| `AttachmentList` | 带有下载链接的文件附件显示 |
| `StatsCard` | 有标签、价值和趋势的计量卡 |
| `EscalatedLayout` | 带有导航的顶级布局( 支持主机布局注入) |
| `BulkActionBar` | 选定票单上的批量操作工具栏 |
| `QuickFilters` | 一击滤波器芯片( 我的票, 未指定, 紧急, SLA Bunch) |
| `MacroDropdown` | 下拉以应用多步宏到门票 |
| `FollowButton` | 切换要跟随/不跟随出票的按钮 |
| `SatisfactionRating` | 1-5星 CSAT 评分输入可选注释 |
| `KeyboardShortcutHelp` | Modal 覆盖显示所有可用的键盘快捷键 |
| `PinnedNotes` | 在线程上方显示被绑住的内部注释 |
| `PresenceIndicator` | 显示谁在看票的实时指标 |

### 可编曲

| 可编曲 | 说明 |
| --- | --- |
| `useKeyboardShortcuts` | 注册和管理售票动作的键盘快捷键 |

### 插件

| 导出 | 说明 |
| --- | --- |
| `EscalatedPlugin` | 用于布局注入和 CSS 主题的 Vue 插件 |

## 插件开发

升级支持框架不可知插件 [插件 SDK](https://github.com/escalated-dev/escalated-plugin-sdk)。插件在 TypeScript 中写过一次,并在所有升级后端工作.

### 前端插件系统如何工作

前端使用 `defineEscalatedPlugin()` 以注册 Vue 组件——自定义管理员页面、票面栏部件或仪表板面板——当插件活动时自动挂载.

```typescript
import { defineEscalatedPlugin } from '@escalated-dev/escalated'
import MySettingsPage from './MySettingsPage.vue'

export default defineEscalatedPlugin({
  name: 'my-plugin',
  pages: {
    'admin/my-plugin/settings': MySettingsPage,
  },
})
```

### 它如何连接到后端

后端使用 `definePlugin()` 从 [插件 SDK](https://github.com/escalated-dev/escalated-plugin-sdk) 用于处理 TypeScript 业务逻辑 – 订阅出票生命周期钩,曝光 API 端点,以及持续的数据. 前端和后端的条目作为单一npm包一起工作.

```typescript
// backend entry (index.ts)
import { definePlugin } from '@escalated-dev/plugin-sdk'

export default definePlugin({
  name: 'my-plugin',
  version: '1.0.0',
  actions: {
    'ticket.created': async (event, ctx) => {
      ctx.log.info('New ticket!', event)
    },
  },
})
```

### 快速示例: 两个条目点

已公布的插件包一般导出两种:

```
my-plugin/
  index.ts          ← backend: definePlugin() for TypeScript logic
  frontend.ts       ← frontend: defineEscalatedPlugin() for Vue components
```

后端框架(Laravel, Rails, Django, AdonisJS) 负载 `index.ts` 通过 [插件运行时间](https://github.com/escalated-dev/escalated-plugin-runtime)。 Vue 应用程序导入 `frontend.ts` 并登记在 `app.use()`。 。 。 .

### 安装插件

```bash
npm install @escalated-dev/plugin-slack
npm install @escalated-dev/plugin-jira
```

### 资源

-   [插件 SDK](https://github.com/escalated-dev/escalated-plugin-sdk) — 用于构建插件的 SDK 类型
-   [插件运行时间](https://github.com/escalated-dev/escalated-plugin-runtime) ——插件运行时主机
-   [插件开发指南](https://github.com/escalated-dev/escalated-docs) ——完整文献整理

## 对于软件包维护者

已验证的来宾访问由后端能力启用. `Escalated/Guest/Create` 接受可选 `verification_url` 财务报告和审定财务报表 `lookup_url` 道具来. 有了这些 URL 表格在发票前请求电子邮件代码; 单独的表格验证 电子邮件,通过跟踪/计票查询和私人续签找到现有车票 链接. `Guest/Show` 显示 `ticket.guest_access_expires_at` 当供应.

内置部件只有在 `/config` 返回时 `guest_verification_required: true`。后端必须提供 POST `/verification` 包括电子邮件和目的`ticket`, (中文(简体) ), `chat`, (中文(简体) ), `lookup`),返回时 `verification_id`· ; 创建接受 `verification_id` 和八位数 `verification_code`。 。 。 . 邮政 `/lookup` 返回时 `{ data: [{ reference, subject, guest_access_token, expires_at }] }`; 后续部件状态已读取, 将符号作为接头符发送 头曰. 聊天创建返回不透明 `id` 和投票用途 `/chat/{id}/messages`在目的地清除证据和私人结果,或 身份改变。 托肯斯留在组件记忆中. 仅发送 CSRF 信头 到页面本身的来源.

忽略这些能力的后端保留其现有的形式合同。 主机 必须在这些表格的后端需要核查之前予以装运。 这个可以 不在其他后端软件包中执行校验,也不释放单独的 网络widget插件.

部件也可以嵌入其他站点,作为发射器或页面 支持格式,包含主机参数(部门、预填、元数据)和a JavaScript API (英语). 后端选择使用源列表、 CORS 和 CSRF 豁免这些来源。 见 [嵌入部件](https://npmcn.com/package/%40escalated-dev/escalated/docs/embedding-the-widget.md)。 。 。 .

账户隔离的后端可以共享 `escalated.broadcasting.channel_prefix` 例如,通过Inertia `escalated.tenants.<opaque-account-namespace>`。 。 。 . 车票、代理、聊天和在场订阅使用此前缀 变化。 保留了现有的 `escalated` 频道。 独立 `PresenceIndicator` 消费者可以通过 `channelPrefix` 道具; `useRealtime` 财务报告和审定财务报表 `useChat` 接受 `channelPrefix` 作为一串, 参考或获取。 原始内容 `useRealtime().listen(channel, event, callback)` 仍按字面处理频道.

后端必须批准活期账户,每个私人/存在加入. 频道名称本身不是授权. 车票只应曝光 代理身份/播放名称,请求者只能使用私人票 更新。 在启用前部署包含此支持的前端版本 后端的账户范围频道.

如果您正在构建一个新的后端集成, 这个软件包可以在 npm 上提供 :

```bash
npm install @escalated-dev/escalated
```

```js
// Import the plugin
import { EscalatedPlugin } from '@escalated-dev/escalated'

// Import individual components
import { StatusBadge, SlaTimer } from '@escalated-dev/escalated'

// Or reference pages directly for Inertia resolution
import CustomerIndex from '@escalated-dev/escalated/pages/Customer/Index.vue'
```

同伴依赖性 : `vue` ^3.3.0, (英语), `@inertiajs/vue3` ^ 1.0.0 || 2.0.0 ^ 3.0.0

API 令牌和两要素页面接受来自 `page.props.flash` (遗产共享道具)和 `page.flash` (Inertia 3) (英语). 顶级值 优先,包括明确 `null` 价值可以清除遗留数据。 第3条 后端应该发送一次性的令牌,设置URI,并通过恢复代码 顶级闪存,所以它们被排除在适配器的浏览器历史状态之外. 主机在更改前必须部署包含此支持的前端释放 他们的后端的闪存协议.

## 捐款

开发工具需要节点 **22.22.2+ 22.x线上**, (中文(简体) ), **24.1.5.0+ (单位:千美元) 在24号线上**,或 **26岁以上**启用 `nvm use` 在 `.nvmrc`。 。 。 . 这些要求适用于此寄存器的工作; 已出版的 Vue 和Inertia同伴的依赖关系列于上文.

```bash
npm ci
npm test
npm run lint
npm run format:check
npm run pages:check
npm run build-storybook
npm audit
```

提交 `package-lock.json` 包含依赖性更新。 CI 安装精确的图表 与 `npm ci`,检查依赖性引擎和对等要求,并运行测试 位于22.22.2号、24.15.0号和26号的套房。 故事书的制作和完整 依赖性审计也在合并之前进行.

浏览器合同将当前源头打包, 安装在孤立的 tarball 具有真实的Inertia 1、2、3个适配器的消费者,对每个消费者进行审计和测试 桌面和移动 Chromium 上的指针和双因子流。 它使用本地的 HTTP 服务器和合成证书。 剪贴板边界被模拟到 测试不会更改剪贴板.

```bash
npx --no-install playwright install chromium
npm run test:inertia
# Or select a single adapter major:
npm run test:inertia -- 3
```

将报告和截图写给 `test-results/inertia-flash/`. CI 运行 每个适配器分别上传成功或失败的证据.

## 后端设置能力

这个 `Escalated/Admin/Settings` 页面接受可选 `supported_settings` 财务报告和审定财务报表 `update_url` 道具来. 通过可编辑的设置名称数组仅显示并提交 这些字段, 和一个URL 接受一个平面 POST 有效载荷。 空数组显示否 可编辑设置 。 表示这些道具保留了完整的设置形式及其 拉拉维尔命名路线. 后端必须验证自己的设置许可列表; 隐藏 控制不是授权.

例如,后端只执行知识基础和品牌偏好 能够曝光 `knowledge_base_enabled`, (中文(简体) ), `knowledge_base_public`, (中文(简体) ), `knowledge_base_feedback_enabled`,以及 `show_powered_by`。在 页:1 `settings` 道具 (英语). 更改设置/ 账号道具清除 stale 格式值 和待处理的请求,包括先前输入的全权证书.

## 生态系统

这是升级后支持票系统的共享前端. 整个生态系统可用的主机框架软件包和客户端SDK:

-   **[升级到Laravel](https://github.com/escalated-dev/escalated-laravel)** ——拉拉维尔作曲机包
-   **[升级用于铁路](https://github.com/escalated-dev/escalated-rails)** 铁路发动机上的Ruby
-   **[为强哥升职](https://github.com/escalated-dev/escalated-django)** - Django可重新使用的应用程序
-   **[阿多尼斯JS升级](https://github.com/escalated-dev/escalated-adonis)** - AdonisJS v6 软件包
-   **[升级为文字新闻](https://github.com/escalated-dev/escalated-wordpress)** — WordPress 插件
-   **[升级以备升级](https://github.com/escalated-dev/escalated-filament)** — Filament v3 管理面板插件
-   **[升级为反应原生](https://github.com/escalated-dev/escalated-react-native)** 反应原生 SDK
-   **[为小蝶升起](https://github.com/escalated-dev/escalated-flutter)** - 小蝶SDK(小蝶)
-   **[共享前端](https://github.com/escalated-dev/escalated)** - Vue 3 + Inertia.js UI 组件(您在这里)

## 许可证

MIT - 版权 (c) Escaled.dev. 见 [自由主义](https://npmcn.com/package/%40escalated-dev/escalated/LICENSE)。 。 。 .

## 常见问题

### @escalated-dev/escalated 是什么？

Vue 3 \+ Inertia\.js UI 用于 Escaled 的组件 “可嵌入式辅助票系统

### 如何安装 @escalated-dev/escalated？

在项目目录运行 npm install @escalated-dev/escalated，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.3\.0）、@inertiajs/vue3（^1\.0\.0 \|\| ^2\.0\.0 \|\| ^3\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @escalated-dev/escalated 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/escalated-dev\_\_escalated 是否存在。

### @escalated-dev/escalated 支持 ESM 还是 CommonJS？

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

### @escalated-dev/escalated 可以商用吗？

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

### @escalated-dev/escalated 的下载量有多少？

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

### @escalated-dev/escalated 还在维护吗？

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

