owl-admin-frontend-assets

name	owl-admin-frontend-assets
description	Use this skill for Owl Admin frontend assets, admin-views, public/admin-assets, resource publishing, custom React frontend work, amis-editor frontend, layout/theme frontend files, pnpm commands, or questions about “前端资源”, “admin-views”, “自定义前端”, “发布 assets”, “前端源码”, and “打包后台前端”.

Owl Admin Frontend Assets

用于 Owl Admin 前端资源、admin-views、发布后的前端源码和自定义前端开发。

参考索引

需要完整路径和命令时，读取 ../_references/owl-admin-dev-index.md。

需要按开发文档主题选择 skill 时，读取 ../_references/owl-admin-docs-map.md。

路径判断

• 安装后的静态资源：public/admin-assets
• 安装后可发布的前端源码：resources/admin-views
• Composer 包内前端源码：vendor/slowlyo/owl-admin/admin-views
• 框架源码仓库前端源码：admin-views

开发原则

• 普通后台页面优先用后端 amis schema，不要为了页面需求直接改前端。
• 动态加载资源优先使用框架提供的 js()、css()、styles()、script() 能力。
• 前端全局函数相关需求先查退出登录、登录回调、刷新 amis 页面、刷新前端路由和关闭 tab。
• 不要编译 vendor/slowlyo/owl-admin/admin-views。
• 只有用户明确要自定义框架前端时，才进入 resources/admin-views 或框架源码 admin-views。
• 执行前端命令前先确认当前目录和包管理器；该项目使用 pnpm-lock.yaml。
• 修改前端源码后，提示用户需要重新发布或同步前端资源。

常用命令

php artisan admin:publish --assets
php artisan admin:publish --views

在确认需要构建且用户允许后，才在正确前端目录执行：

pnpm install
pnpm run dev
pnpm run build

验证

• 资源缺失先执行 php artisan admin:doctor。
• 前端源码变更先检查 package.json 和 pnpm-lock.yaml。
• 构建产物需要发布到 public/admin-assets 后才会影响运行中的后台。