slowlyo 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后才会影响运行中的后台。