📝 项目更新日志

本页记录 SunAdmin 项目的重要版本变更，用于了解框架能力、模块体系、运行环境和兼容性要求的演进。

[1.0.2] - 2026-06-09

优化

• 软删除唯一字段复用处理。
• AI助手解析非 SSE JSON 响应。
• 装修页缓存，避免不同访问域名之间串缓存。
• uniapp端公共图片组件。
• uniapp端装修数据接口返回结构。

[1.0.1] - 2026-06-08

新增

• 地图选择器组件。

优化

• AI Skill 约束。
• 后台链接选择器组件。

修复

• 安装模块后菜单权限没有重新加载的问题。

[1.0.0] - 2026-05-28

新增

• 首版公开发布。
• Laravel 13 + Vue 3 + uni-app Vue 3 三端一体方案。
• 模块化体系：module.json 模块清单、publish-manifest.json 资源发布、system_modules 安装状态、module:install/uninstall/enable/disable/build-runtime 系列 Artisan 命令。
• 权限与组织：管理员、角色、菜单、按钮权限、动态路由、部门、岗位。
• 内容运营：文章分类与文章、协议、公告、媒体库、页面装修与移动端装修渲染、搜索配置。
• 用户能力：用户资料、用户地址。
• 系统配置：分组配置、数据字典、缓存管理、站点开关、存储驱动、微信公众号 / 小程序、AI 模型。
• 多语言：后台语言管理、菜单 / 字典 / 配置等多语言数据维护、Admin 端界面切换
• 上传与存储：本地、七牛云、阿里云 OSS、腾讯云 COS；媒体 URL 与富文本资源 URL 自动转换。
• 支付能力：统一支付单、退款单、回调日志、业务处理器分发；微信支付通道按模块接入。
• AI 与 MCP：后台动态配置模型供应商、文本生成、向量、知识库 RAG、AI 助手、多轮上下文、MCP 工具调用、官方 MCP Server。
• AI Skills：预留了一套面向 AI 工具的协作规则，用于让 Codex、Claude、Cursor、Trae、通义灵码、Copilot Chat、OpenCode 等工具更快理解项目结构、编码风格和常见约定。
• 接口契约：统一 code/message/data 响应、统一异常码、openapi:export 一键导出 OpenAPI 3.0 JSON。
• 应用中心：后台模块管理 UI（安装 / 启用 / 停用 / 卸载）。
• 安装向导 /install：环境检查、数据库初始化、超级管理员创建、Apache-2.0 许可摘要。
• App\Support\Version 框架版本号单一入口，遵循 SemVer。
• module.json.min_sunadmin_version 字段：模块声明所需最低框架版本，安装前校验。
• 模块依赖支持字符串或对象（带 version 约束）两种声明形式。

兼容性

• PHP：>= 8.3
• Composer：>= 2.2
• Laravel：^13.0
• Node.js（前端构建）：>= 22
• npm：>= 11
• MySQL：>= 5.7（推荐 MySQL 8.x）