更新记录

1.0.0（2026-10-16）

首次发布，基于 uni-admin 二次开发。
采用 Naive UI 重构后台界面，优化菜单、表格及新增/编辑弹窗。
提供图片/视频素材管理、分类管理、上传队列和业务素材选择器。
支持多配色、明暗主题、简体中文、繁体中文与 English 切换。
适配 PC 和移动 H5 网页端，不支持 App、小程序、uni-app x。
发布包不包含开发服务空间关联、测试账号和开发业务数据；关闭固定邮箱及短信验证码测试模式。

平台兼容性

云端兼容性

支付宝云	腾讯云	阿里云
√	×	×

uni-app(5.26)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	iOS	鸿蒙
×	√	√	-	×	×	×	×	×

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	小红书小程序	快应用-华为	快应用-联盟
×	×	×	×	×	×	×	×	×	×	×	×

其他

多语言	暗黑模式	宽屏模式	蒸汽模式
√	√	√	×

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

NaiveAdmin后台管理模板

功能

Naive UI 菜单、按钮、表单、表格、分页、卡片及弹窗。
多页面标签、面包屑、菜单折叠、明暗主题与多配色。
简体中文、繁体中文和 English 即时切换，刷新后保留选择。
素材管理：图片/视频预览、名称搜索、分类筛选、分页、详情编辑、复制链接、下载及删除。
素材上传：文件选择、拖拽、粘贴图片、并发队列、进度与失败重试；图片最大 20 MB，视频最大 200 MB。
分类管理：表格显示、筛选、排序、分页、新增、修改、删除及批量设置素材分类；单个素材分类单选。
业务表单可从素材库选择图片或视频。
沿用 uni-admin 的用户、角色、权限、应用、菜单及统计管理能力。统计数据由部署者自己的业务端产生和上报。

环境与兼容性

开发、构建及验证环境：HBuilderX 5.26，Vue 3；更早 HBuilderX 版本未经本改造版验证。
已验证现代 Chromium 浏览器的 PC 与窄屏 H5 页面。Safari 尚未进行本版本实机验证。
当前发布包包含支付宝云目录，原业务流程已在支付宝云验证；插件市场加密后的上传及部署仍需实际验证，不能据此承诺已经通过平台校验。其他云平台未经本版本部署验证。
不支持 Vue 2、uni-app x、蒸汽模式、原生 App、小程序和快应用。
视频格式和编码能否播放，取决于浏览器本身的解码支持。

部署

解压项目并用 HBuilderX 5.26 或更新版本打开。在项目根目录执行 npm ci（需要 Node.js/npm）。
在 HBuilderX 为项目申请自己的 DCloud AppID。发布模板的 manifest.json 中 AppID 已留空。
自行创建并关联支付宝 uniCloud 服务空间。发布包不包含作者开发空间的关联信息。在 uniCloud 控制台配置实际开发及生产环境的 Web 安全域名，再进行浏览器联调。
按下方“首次部署配置”填写自己的认证密钥；仅在实际启用对应服务时配置短信等服务凭据。
通过 HBuilderX 部署项目及 uni_modules 内的公共模块、云函数/云对象和数据库 schema、索引、初始化数据。必须包含 uni-id-co、admin-media 及 uni-config-center、uni-id-common、uni-captcha 等依赖，并关联同一个支付宝云空间；只上传根目录 cloudfunctions 不够。请勿把空配置直接用于生产。
媒体库包含 admin-media、admin-media-tags、admin-media-upload-parts 三张表，部署其 schema 和同名 index 文件；表禁止客户端直接读写，操作经云对象验证登录与权限。
运行到浏览器，点击“创建管理员账号”，创建自己的超级管理员；也可访问 /admin/#/uni_modules/uni-id-pages/pages/register/register-admin。包内不预置测试账号，也不提供默认账号密码。
登录后到“系统管理 → 菜单管理”点击“更新内置菜单”，同步素材管理、分类管理等内置菜单。其他角色按需分配 MEDIA_READ、MEDIA_UPLOAD、MEDIA_EDIT、MEDIA_DELETE、MEDIA_TAG 权限，修改角色后重新登录。
HBuilderX 发行 Web，部署生成的 unpackage/dist/build/web。当前 Web 路径前缀为 /admin/，路由模式为 hash；若更改前缀，请同时修改 manifest.json 的 h5.router.base 并调整服务器静态文件路径。
按云存储服务要求配置上传、下载与访问域名，核对生产站点使用的实际 Web 安全域名。

首次部署配置

认证配置位于：

uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json

发布包中的 passwordSecret、tokenSecret 已留空。请分别生成两个不同的随机字符串，并填写到这两个字段；不要共用作者密钥，不要将配置文件上传到公开仓库。可在本机运行两次：

node -e "console.log(require('node:crypto').randomBytes(32).toString('hex'))"

填好后重新上传对应公共模块及 uni-id 云对象。空密钥会导致认证失败。正式运行后请妥善保管这些密钥，不要随意更换 passwordSecret，以免既有账号无法验证密码。

当前默认启用用户名密码登录。手机号绑定和短信找回等能力需要部署者开通并配置自己的短信服务及模板，可能产生云服务和短信费用。未配置短信模板时只返回配置错误，不生成固定测试验证码。第三方登录凭据和短信凭据在发布包内已清空，不代表对应服务已经开通。

上游邮箱验证码接口原为固定验证码测试示例；本发布包已关闭该测试实现。邮箱验证码、邮箱注册及邮箱找回密码需要自行接入真实邮件发送服务后才能启用，本版本不承诺这些邮箱能力开箱可用。

素材管理说明

上传在独立弹窗中完成，文件类型自动识别，分类单选。关闭完成的批次会清空弹窗表单和队列，已上传素材保留。
删除素材会删除云文件，并使其他业务已引用的链接失效；删除分类不会删除素材。操作前请确认引用关系。
推荐保存素材的 file_id；私有云存储的临时访问链接可能过期。
当前默认使用部署者自己的 uniCloud 内置云存储。扩展存储需要自行配置，不包含额外存储服务授权。

开发工具

开发环境可执行 npm run page-generator 启动本机页面生成服务。该服务只监听 127.0.0.1:9538，正式生产构建不提供源码生成或删除入口。HBuilderX CLI 默认路径为 D:/HBuilderX/cli.exe，其他安装目录可通过 HBUILDERX_CLI 环境变量指定。生成的是业务页面骨架，需自行实现业务数据源和保存逻辑。

服务范围

提供模板安装、配置和已有功能的使用说明，以及产品缺陷修复反馈渠道。代部署、业务开发、第三方服务开通与个性化定制不包含在模板价格内；请通过插件市场咨询入口沟通。云服务、域名、短信等费用由部署者自行承担。

数据和权限

本项目仅支持 PC/H5 网页端，不申请 App 原生系统权限。网页运行使用网络访问和浏览器本地存储；用户主动选择头像或素材时读取所选文件，主动粘贴图片时读取该次粘贴内容，点击复制链接时写入剪贴板，点击全屏时调用浏览器全屏接口。相关能力遵循浏览器授权与安全策略。不主动读取定位、通讯录、麦克风或后台剪贴板。

账号功能处理用户主动提供的账号、密码、昵称、性别、简介、头像，以及使用手机号绑定或密码找回功能时提供的手机号和验证码。身份认证及安全审计会记录用户标识、客户端 IP、浏览器 User-Agent、设备标识（如客户端提供）、登录时间和登录结果。

素材管理处理用户主动上传的图片、视频，以及文件名称、大小、尺寸、时长、分类和上传者信息。

上述数据发送至部署者自行绑定的 uniCloud 云函数、云数据库和云存储，用于身份认证、权限管理、安全审计和业务素材管理。云端请求和文件服务地址由部署者绑定的 uniCloud 服务空间生成。短信功能按需调用部署者开通的 uniCloud 短信服务。登录态、语言、主题和表格偏好存储在浏览器本地。

当前模板默认关闭 uniStatistics 访问统计上报；统计页面查询部署者自有服务空间中的统计数据。模板未内置向插件作者另设服务器回传业务数据的逻辑。

无。本模板未接入广告展示或广告变现 SDK，不包含广告位。

来源与许可

本项目为第三方二次开发版本，由 yclyy 发布，非 DCloud 官方版本。插件市场的交易和售后规则不替代上游开源代码已有的许可。