# @dskripchenko/laravel-admin 中文文档

规范地址：https://npmcn.com/package/%40dskripchenko/laravel-admin/

版本：1\.69\.1
npm 元数据更新时间：2026-10-31T22:12:58.648Z
中文译文更新时间：2026-11-01T00:45:27.074Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：14.6 MB，449 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：9 个
- peer 依赖：vue ^3\.4，axios ^1\.6，pinia ^2\.1 \|\| ^3\.0，quill ^2，marked ^12\.0，tinymce ^7，vue-router ^4\.3 \|\| ^5\.0，@tiptap/vue-3 ^2\.4，@dskripchenko/ui ^1\.21\.0，@vueup/vue-quill ^1\.2，@tiptap/starter-kit ^2\.4，@tinymce/tinymce-vue ^5，@dskripchenko/wysiwyg ^0\.6\.0
- 首次发布：2026-05-01T18:21:20.710Z
- 最新版本发布：2026-10-31T22:12:58.517Z
- 已发布版本数：166（近 12 个月 166 个）

## 中文简介

Vue 3管理面板构造器：SPA bundle для Laravel-приложений на @dskripchenko/ Laravel- admin （PHP后端）- json驱动的字段/布局/Infolist/小部件渲染器' patrik поверх @dskripchenko/ui设计系统。

## 安装

```sh
npm install @dskripchenko/laravel-admin
```

也可以使用：`pnpm add @dskripchenko/laravel-admin`、`yarn add @dskripchenko/laravel-admin`、`bun add @dskripchenko/laravel-admin`

## README

# dskripchenko / laravel-admin

> 🌐 **英语** · [Русский](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/ru/README.md) · [多伊奇](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/de/README.md) · [中文](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/zh/README.md)

一个受Orchid启发的Laravel管理面板构造器，带有Vue 3 SPA前端。

[![npm](https://img.shields.io/npm/v/@dskripchenko/laravel-admin?label=%40dskripchenko%2Flaravel-admin)](https://www.npmjs.com/package/@dskripchenko/laravel-admin) [![Packagist](https://img.shields.io/packagist/v/dskripchenko/laravel-admin)](https://packagist.org/packages/dskripchenko/laravel-admin) [![License](https://img.shields.io/packagist/l/dskripchenko/laravel-admin)](https://npmcn.com/package/%40dskripchenko/laravel-admin/LICENSE)

**现场演示: [laravel-admin.dskripchenko.space](https://laravel-admin.dskripchenko.space/)** -一个几千美元的商店和一个博客 记录，一个展示每个字段，布局和操作显示其自己的来源， 这是面板内的文档。无需注册：选择管理员，编辑 或登录页面上的查看器；数据每小时重置一次。

```php
Admin::resources([UserResource::class, ArticleResource::class]);
Admin::screen([ContactScreen::class, SystemStatusScreen::class]);
Admin::menu()->add(
    MenuNode::make('content', 'Content')->icon('book')->children([
        MenuNode::resource('articles'),
        MenuNode::dashboard('analytics'),
    ]),
);
```

## 里面有什么

-   **CRUD管道** -将Eloquent模型声明为 `Resource`,获得 免费列出/创建/编辑/查看屏幕。
-   **自定义屏幕** -非crud页面（表单，仪表板，报告） `Admin::screen()`． 处理状态、布局、命令栏、验证、 权限。
-   **分层菜单** -流利的 `Admin::menu()->add(MenuNode::...)`， 任意深度，自动解析 `resource()`/`screen()`/`dashboard()`.
-   **30+字段类型** -输入/数量/选择/组合框/ DatePicker / 器/ FileUpload Wysiwyg /减价/ TranslatableInput /转发器 RelationSelect /级联/ TreeSelect /料/ KeyValue / TagsInput /…
-   **15 +的布局** -行/列/标签/向导+一步/块/模态/抽屉/ 包装/ Infolist /仪表板/手风琴/视图/…
-   **表** -可排序的列，预设，过滤器(输入/日期/切换器/ 选项/从模型选择)，内联编辑，摘要，保存视图， 分组、轮询、导出（CSV/XLSX/PDF）。
-   **指示板** - 8个小部件类型(统计/图表/最近列表/Markdown/ Iframe/Table/Heatmap/Gauge)，每个用户的布局覆盖，拖动/调整大小， 轮询。
-   **Auth & RBAC** ——multi-guard;一个单独的 `admin_users` 桌子还是你的 现有用户([共享策略](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/integration.md#2-who-signs-in-dedicated-or-shared))， 角色，2FA TOTP，个人资料，模拟，密码重置，电子邮件 验证。
-   **审计** -只追加管理操作日志(`AuditLog` + `Loggable` 特征)。
-   **设置** -单例式配置界面。
-   **通知** -钟徽章+抽屉（数据库通知）。
-   **API的令牌** - Profile中的Sanctum集成（条件）。
-   **主题** -亮/暗+用户偏好； `@dskripchenko/ui` 设计令牌。
-   **i18n** -区域解析器（6步优先级）， `TranslatableField` 桥梁 `dskripchenko/laravel-translatable`.
-   **租赁** - - - - - - `TenantResolver` / `TenantContext` / `TenantScoped` 特征。策略是主机端；我们提供合同。
-   **插件** - - - - - - `AdminPlugin` 接口;姐妹包使用相同的钩子。
-   **测试** - - - - - - `AdminTestCase`， `ActsAsAdmin` 和 `InteractsWithAdminResources` 特征。
-   **OpenAPI 3.0** -从docblock生成 `@input`/`@output` 标签。

## 安装

```bash
composer require dskripchenko/laravel-admin
php artisan admin:install
```

就是这样——管理SPA是预先构建的，不需要Node。访问 `/admin/login`. [开始](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/getting-started.md) 走过 第一个资源和您自己的Vue组件的定制构建模式。

将其添加到已经拥有用户、自己的API或代理的应用程序中？ 读 [向现有应用程序添加管理员](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/integration.md) - - - - - - 包括 `admin:install --shared`，允许现有用户登录。

## 文档

-   [开始](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/getting-started.md)
-   [向现有应用程序添加管理员](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/integration.md)
-   [体系结构](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/architecture.md)
-   概念: [资源](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/concepts/resources.md) · [屏幕](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/concepts/screens.md) · [小部件和仪表板](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/concepts/widgets-and-dashboards.md) · [菜单](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/concepts/menu.md) · [行动](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/concepts/actions.md) · [权限](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/concepts/permissions.md) · [i18n](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/concepts/i18n.md) · [租赁](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/concepts/tenancy.md)
-   [字段引用](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/fields-reference.md)
-   [布局参考](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/layouts-reference.md)
-   [API参考](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/api-reference.md)
-   [前端延伸](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/frontend-extension.md)
-   [测试](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/testing.md)
-   [迁移指南](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/migration-guide.md)
-   [术语表](https://npmcn.com/package/%40dskripchenko/laravel-admin/docs/en/glossary.md)

## 堆栈

-   **PHP** ^ 8.2
-   **Laravel** 11 / 12 / 13
-   **Vue** ^3.4 + TypeScript + Pinia + Vue Router
-   **前端** -预建SPA ~ 350kb gz JS + ~ 35kb gz CSS；npm的 自定义构建库入口~260 KB gz （Vue， Pinia和外部UI工具包）
-   **所见即所得** - - - - - - `@dskripchenko/wysiwyg` 默认情况下;羽毛笔和小李子 NPM包中附带的适配器(`/quill`， `/tinymce`）

## Sister-packs

可选扩展，只安装你需要的：

| 包 | 目的 |
| --- | --- |
| `dskripchenko/laravel-admin-starter` | 用户、角色和审计日志资源 |
| `dskripchenko/laravel-admin-media` | 媒体库（不依赖于空间/媒体库） |
| `dskripchenko/laravel-admin-health` | 运行状况检查（无空间/运行状况依赖关系） |
| `dskripchenko/laravel-admin-pulse` | 遥测采样器（不依赖于laravel/pulse） |
| `dskripchenko/laravel-admin-jobs` | 失败的作业/批次查看器 |

## 贡献

看到 [CONTRIBUTING.md](https://npmcn.com/package/%40dskripchenko/laravel-admin/.github/CONTRIBUTING.md)． PRs的欢迎。

## 许可证

[麻省理工学院](https://npmcn.com/package/%40dskripchenko/laravel-admin/LICENSE) ©Denis Skripchenko

## 常见问题

### @dskripchenko/laravel-admin 是什么？

Vue 3管理面板构造器：SPA bundle для Laravel-приложений на @dskripchenko/ Laravel- admin （PHP后端）- json驱动的字段/布局/Infolist/小部件渲染器' patrik поверх @dskripchenko/ui设计系统。

### 如何安装 @dskripchenko/laravel-admin？

在项目目录运行 npm install @dskripchenko/laravel-admin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.4）、axios（^1\.6）、pinia（^2\.1 \|\| ^3\.0）、vue-router（^4\.3 \|\| ^5\.0）、@dskripchenko/ui（^1\.21\.0）、@dskripchenko/wysiwyg（^0\.6\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @dskripchenko/laravel-admin 支持 TypeScript 吗？

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

### @dskripchenko/laravel-admin 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @dskripchenko/laravel-admin 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dskripchenko/laravel-admin 可以商用吗？

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

### @dskripchenko/laravel-admin 还在维护吗？

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