发布日期: 2026年1月27日
开源地址:gitee.com/teanary/tea…
📢 版本亮点
V1.3.1 是 Teanary 电商平台系统的稳定版发布。在 V1.3.0 重大架构升级的基础上，我们专注于稳定性提升和用户体验优化，修复了 40+ 个问题，让系统运行更稳定，操作更流畅，使用更便捷。这是系统走向成熟的重要里程碑。
🎯 为什么需要 V1.3.1？
您是否遇到过这些问题？
❌ 编辑商品时，提示"商品名称已存在"，明明没有修改
问题场景：
- 您想修改一个商品的描述，但商品名称保持不变
- 点击保存时，系统提示"商品名称已存在"
- 您只能取消操作，或者修改商品名称，非常麻烦
影响：
- 影响工作效率，每次编辑都要重新输入名称
- 容易误操作，可能修改了不想改的内容
- 用户体验差，影响使用信心
V1.3.1 的改进：
- ✅ 智能验证：编辑时自动忽略当前记录，不会误报重复
- ✅ 支持所有表单：商品、文章、语言、货币、管理员等所有表单都已优化
- ✅ 密码可选：编辑用户和管理员时，密码变为可选，不修改密码时无需填写
实际感受：
- 编辑商品时，只修改描述，商品名称保持不变，保存成功
- 编辑用户信息时，只修改邮箱，密码留空，保存成功
- 操作更顺畅，不再被误报困扰
❌ 筛选商品时，选择状态后页面报错
问题场景：
- 您想筛选"已上架"的商品
- 选择状态后，页面显示错误，无法正常使用
- 只能刷新页面，重新操作
影响：
- 影响工作效率，筛选功能无法正常使用
- 数据查看困难，无法快速找到需要的商品
- 用户体验差，影响系统可用性
V1.3.1 的改进：
- ✅ 修复类型错误：所有筛选器类型匹配问题已修复
- ✅ 统一筛选体验：所有列表页面的筛选功能都已优化
- ✅ 支持单选多选：根据业务需求，合理使用单选或多选
实际感受：
- 筛选商品状态，立即显示结果，无错误
- 筛选订单状态，操作流畅，响应快速
- 所有筛选功能都能正常使用
❌ 操作成功后，看不到提示，不知道是否成功
问题场景：
- 您保存了一个商品，但看不到成功提示
- 不确定是否保存成功，只能刷新页面查看
- 或者提示显示在页面中间，容易被忽略
影响：
- 影响用户体验，操作后没有明确反馈
- 容易重复操作，可能造成数据重复
- 影响使用信心，不确定操作是否成功
V1.3.1 的改进：
- ✅ 统一通知系统：所有操作都通过右上角统一显示通知
- ✅ 多种通知类型：成功、错误、警告、信息，不同类型有不同颜色
- ✅ 自动消失：通知 5 秒后自动消失，不遮挡内容
- ✅ 可手动关闭：可以手动关闭通知
实际感受：
- 保存商品后，右上角显示绿色成功提示
- 操作失败时，右上角显示红色错误提示
- 所有通知统一位置，不会遗漏
❌ 图片上传后，删除按钮位置不方便
问题场景：
- 您上传了商品图片，想删除某张图片
- 删除按钮在图片下方，需要滚动才能看到
- 或者删除按钮不明显，找不到
影响：
- 影响操作效率，删除图片不方便
- 容易误操作，可能删除了不想删的图片
- 用户体验差，操作不直观
V1.3.1 的改进：
- ✅ 删除按钮优化：单图删除按钮移到图片右上角
- ✅ 统一组件：所有图片上传使用统一组件，体验一致
- ✅ 视觉反馈：删除按钮有悬停效果，操作更直观
实际感受：
- 上传头像后，删除按钮在图片右上角，一目了然
- 删除商品图片，点击右上角按钮即可
- 所有图片上传体验统一，操作更顺畅
❌ API Token 需要手动复制，容易出错
问题场景：
- 您生成了 API Token，需要复制到其他系统
- Token 很长，手动复制容易出错
- 或者 Token 显示不完整，看不到全部内容
影响：
- 影响工作效率，复制 Token 不方便
- 容易出错，可能复制错误导致 API 调用失败
- 影响使用体验，操作不便捷
V1.3.1 的改进：
- ✅ 一键复制功能：点击按钮即可复制完整 Token
- ✅ 复制成功提示：复制成功后显示绿色对勾，明确反馈
- ✅ 统一组件：列表和表单都使用统一的复制组件
实际感受：
- 生成 Token 后，点击复制按钮，立即复制到剪贴板
- 复制成功后，按钮显示绿色对勾，操作明确
- 在列表和表单中都能快速复制 Token
🚀 核心改进
🛡️ 稳定性大幅提升 - 系统运行更可靠
修复的问题：
- ✅ 40+ 个类型错误修复：所有筛选器和表单的类型匹配问题已修复
- ✅ 表单验证优化：编辑时自动忽略当前记录，不会误报重复
- ✅ 空值处理优化：所有可能为空的数据都有完善的空值检查
- ✅ 数据同步优化：修复了促销商品变体保存时的文件不存在错误
实际好处：
- 系统运行更稳定，不会因为类型错误而崩溃
- 表单验证更智能，不会误报错误
- 数据操作更安全，不会因为空值而报错
🎨 用户体验优化 - 操作更流畅
改进的功能：
- ✅ 统一通知系统：所有操作都通过右上角统一显示通知
- ✅ 图片上传优化：删除按钮移到图片右上角，操作更直观
- ✅ 复制功能：API Token 一键复制，操作更便捷
- ✅ 筛选功能优化：所有筛选器都支持"全部"选项，操作更灵活
实际感受：
- 操作后立即看到反馈，不再担心是否成功
- 图片管理更方便，删除操作更直观
- Token 复制更便捷，不会出错
- 筛选功能更灵活，可以快速查看所有数据
🔧 代码质量提升 - 更易维护
技术改进：
- ✅ 统一通知机制：所有通知都使用 Livewire 事件系统
- ✅ 组件复用：图片上传、复制功能都封装为统一组件
- ✅ 代码优化：移除了所有过时的 session flash 代码
- ✅ 类型安全：修复了所有类型不匹配问题
实际好处：
- 代码更易维护，修改通知系统只需要改一处
- 组件更易复用，新增功能时可以快速使用
- 代码更清晰，没有冗余代码
✨ 详细改进列表
🐛 Bug 修复
类型错误修复（40+ 个）
- ✅ 修复了所有筛选器的类型不匹配问题
- 订单状态筛选（Orders）
- 商品状态筛选（Products）
- 翻译状态筛选（Articles, Products, Categories, Attributes, AttributeValues, Specifications, SpecificationValues, Countries, Zones, Promotions）
- 促销类型筛选（Promotions）
- ✅ 修复了空值访问错误
- 订单货币为空时的显示问题
- 图片缩略图未生成时的显示问题
表单验证优化（10+ 个）
- ✅ 修复了编辑时的唯一性验证问题
- 用户邮箱编辑（UserForm）
- 管理员邮箱编辑（ManagerForm）
- 语言代码编辑（LanguageForm）
- 货币代码编辑（CurrencyForm）
- 文章 slug 编辑（ArticleForm）
- ✅ 修复了密码验证问题
- 编辑用户时密码变为可选
- 编辑管理员时密码变为可选
数据操作优化
- ✅ 修复了促销商品变体保存时的文件不存在错误
- ✅ 修复了 SKU 变体删除后的显示问题
- ✅ 修复了图片预览时缩略图未生成的显示问题
🎨 用户体验优化
通知系统统一
- ✅ 移除了所有页面内的 session 消息显示代码
- ✅ 统一使用右上角 flash-messages 组件
- ✅ 支持成功、错误、警告、信息四种类型
- ✅ 自动消失，可手动关闭
图片上传优化
- ✅ 删除按钮移到图片右上角
- ✅ 统一使用 image-upload 组件
- ✅ 支持单图和多图上传
- ✅ 支持临时预览和已有图片显示
复制功能
- ✅ 新增 copy-to-clipboard 组件
- ✅ API Token 一键复制
- ✅ 复制成功提示
- ✅ 支持完整显示和截断显示
筛选功能优化
- ✅ 所有筛选器都支持"全部"选项
- ✅ 统一筛选体验
- ✅ 支持单选和多选
🔧 代码优化
组件复用
- ✅ 统一图片上传组件（image-upload）
- ✅ 统一复制组件（copy-to-clipboard）
- ✅ 统一语言选项卡组件（language-tabs）
- ✅ 统一富文本编辑器组件（quill-editor）
代码清理
- ✅ 移除了所有过时的 session flash 代码
- ✅ 统一使用 Livewire dispatch 事件
- ✅ 优化了代码结构，提高可维护性
💼 商业价值
对您的好处
⏱️ 提升工作效率
- 之前：编辑商品时经常遇到验证错误，需要反复操作
- 现在：编辑商品时操作流畅，一次成功，节省时间
- 价值：每天节省 30 分钟，一年节省 180 小时
🎯 降低操作错误
- 之前：筛选功能报错，无法正常使用
- 现在：所有功能稳定运行，操作顺畅
- 价值：减少操作错误，提高数据准确性
😊 提升使用体验
- 之前：操作后看不到反馈，不确定是否成功
- 现在：操作后立即看到反馈，操作明确
- 价值：提升使用信心，提高工作效率
🔒 提高系统稳定性
- 之前：偶尔会遇到类型错误，系统不稳定
- 现在：系统运行稳定，不会因为小问题而崩溃
- 价值：减少系统故障，提高业务连续性
运营建议
📊 数据管理更高效
- 筛选功能稳定，可以快速查看需要的数据
- 批量操作更顺畅，可以快速处理大量数据
- 数据准确性提高，减少人工核对时间
🎨 界面操作更直观
- 图片管理更方便，可以快速删除不需要的图片
- Token 复制更便捷，可以快速配置 API 集成
- 通知系统统一，不会遗漏重要信息
🚀 系统运行更稳定
- 系统稳定性提高，减少故障时间
- 数据操作更安全，减少数据丢失风险
- 用户体验提升，提高用户满意度
🔄 升级说明
数据兼容性
完全不用担心！
- ✅ V1.3.1 与 V1.3.0 的数据结构完全一致
- ✅ 可以无缝升级，无需迁移数据
- ✅ 所有功能保持不变，只是更稳定、更流畅
升级步骤
-
备份数据（重要！）
- 备份数据库
- 备份上传的文件（storage/app/public）
-
更新代码
git pull origin main composer install npm install npm run build -
清除缓存
php artisan config:clear php artisan cache:clear php artisan view:clear -
测试功能
- 登录后台，测试各项功能
- 检查商品、订单等数据是否正常
- 测试筛选、编辑、删除等操作
系统要求
- PHP 8.2 或更高版本
- MySQL 8.0 或更高版本
- Redis（推荐）
- Composer
- Node.js 和 NPM
📦 如何获取
下载方式
- GitHub: github.com/TeanaryServ…
- Gitee: gitee.com/teanary/tea…
新安装
详细的安装和部署指南，请查看 部署文档
🎮 在线体验
想要先体验一下？我们提供了在线演示：
测试账号:
- 邮箱:
demo@demo.com - 密码:
demo123456
⚠️ 演示数据每 8 小时自动重置
体验重点：
- 登录后台，体验操作后的通知提示
- 尝试编辑商品，感受验证的智能性
- 测试筛选功能，体验操作的流畅性
- 上传图片，体验删除按钮的便捷性
📚 相关文档
🐛 问题反馈
如果您在使用过程中遇到问题：
- 普通问题：请在 GitHub 或 Gitee 提交 Issue
- 安全问题：请发送邮件至 hello@teanary.com
🙏 致谢
感谢所有使用 Teanary 的用户和贡献者！您的反馈和建议帮助我们不断改进系统。
特别感谢：
- 所有测试用户的反馈
- 社区开发者的贡献
- 所有提出改进建议的用户
Teanary - 让全球电商运营更简单 🌍
版本: V1.3.1 稳定版
发布日期: 2026年1月27日
许可证: AGPL-3.0
