更新日志 · XiHan.BasicApp

本文件记录 XiHan.BasicApp 各版本的变更。每条标注 新增 / 修复 / 优化 / 调整 / 升级 / 移除 类别。项目遵循「不做向后兼容、部署即重建库」策略，跨大版本升级请以最新版为准并重建数据库。

来源

本页同步自仓库根目录的 CHANGELOG.md，以其为准。

v3.1.0 (2026-07-03)

• 新增 在线聊天系统：单聊 / 群聊 / 部门群，支持消息回复、编辑、限时撤回、已读回执、表情回应、@、Pin、转发、附件秒传与图片下载
• 新增 聊天群治理与安全：群信息编辑、转让群主、成员禁言、跨会话审计查询页、敏感词拦截（发送 / 编辑双侧 fail-closed）；独立聊天页 + 全局抽屉 + 顶栏未读角标
• 新增 通知四渠道扇出投递：一次发布可达站内信 / 邮箱 / 短信 / 机器人，走用户偏好门控与联系方式校验
• 新增 OAuth2 授权服务端：/connect/authorize·token·revoke 标准端点、授权码 + PKCE、令牌轮换；个人中心自助管理 OAuth 应用
• 新增 租户数据库级隔离：SysTenant 打通运行时连接、独立建库动作、连接串加密与「初始化数据库」
• 新增 消息网关配置 DB 化 + 管理面：邮件 / 短信 / 机器人配置迁入数据库并加密；短信实装阿里云 / 腾讯云真实发送
• 新增 用户职位管理、演示环境写操作拦截、数据库 / Redis 健康检查 /health、日志保留清理定时任务
• 优化 仪表盘与小组件合并、聊天输入区与右键菜单 QQ 化、顶部横幅公告升级（类型配色 / 关闭记忆 / 轮播）
• 修复 聊天实时链路雪花 ID 精度、i18n 裸 @ 白屏、通知横幅顶部空白条及多项聊天 UI 交互问题
• 调整 消息网关配置从 appsettings 迁入数据库（未配置默认网关 fail-closed 不再假成功）；密码历史防重用、2FA 手机分支修复
• 升级 SysConfig 真加密、存储密钥加密、短信验证码防刷等安全加固；升级依赖并发布 v3.1.0

v3.0.1 (2026-06-27)

• 新增 新增代码生成模块（架构骨架 → CRUD → 全栈模板 → 管理页 → 零代码运行时只读切片）与配套权限链
• 新增 消息中心地基重构：五类消息分级、角色 / 部门定向投递、顶部横幅 + 登录弹窗 + 强制阅读、运营闭环（统计 / 未读人员 / 催办 / 导出）
• 新增 全栈国际化铺量：后端异常 / 枚举资源化、前端业务页 ~2600 键 zh/en、枚举下拉切语言响应式、i18n 校验门禁
• 新增 表格能力增强：服务端多字段动态排序（FLS 门控）、搜索时间区间 + 枚举多选、新增工作台小组件看板
• 新增 新增 Cron 表达式可视化组件、超级管理员可进入所有租户与快捷登录、多租户测试种子
• 调整 分页查询统一改走 POST（查询对象作 body）、标准化表名列名、种子数据解耦（代码生成 / 演示 / 系统基线分离）
• 优化 枚举元数据整库取一次并全局语言监听（切语言 N→1 请求），修复 Cron 组件卡顿、浅色主题深色侧栏不变暗等问题
• 升级 升级依赖并修复随之而来的报错，清理编译警告与文件头

v3.0.0 (2026-06-20)

• 新增 上线第三方登录（多提供商）与邮箱全局唯一登录、智能落点，配套控制中心页面与租户切换入口
• 新增 新增导出中心（后端引擎 + 任务闭环 + 页面），全部列表页零配置获得同步导出，5 个日志大表支持异步导出
• 新增 SchemaPage 全量铺开细粒度权限门控：导入导出、多选批量删除、批量启停按资源逐一门控（覆盖 12–14 页）
• 新增 新增在线用户实时视图、个人 API 凭证、用户统计聚合、导入历史留痕、消息模板管理等 Saas 能力
• 新增 文件管理升级：多文件并发上传接入灵动岛、回收站三段式（归档 / 恢复 / 彻底删除）、下载访问计数与元数据编辑
• 优化 灵动岛全面重构为 iOS 任务中心模型（进度环 / 三态形变 / 服务端任务 / 常驻恢复 / 顶部弹出动效）
• 优化 偏好 / 搜索 / 表格 / 收藏夹同步由手动推送升级为实时推拉，并优化仪表盘、字典、菜单、登录页等多处样式
• 调整 线上发布与本地测试分离、异常统一化输出，种子数据正式化并移除演示数据

v2.3.1 (2026-06-11)

• 新增 新增分屏 / 双栏对照功能，支持左右屏内容互换、丰富的分屏操作按钮，标签菜单可「分屏打开」
• 新增 页面设置升级为「用户设置」，覆盖全场景个性化；偏好支持后端同步开关与草稿式预览 / 保存 / 还原
• 新增 新增灵动岛开关、全屏水印、数学曲线页面加载动画，收藏夹 / 搜索 / 表格分类支持同步开关与本地状态标记
• 优化 分屏空间与交互打磨：互换时分割线固定不动、工具组默认隐藏悬停显示、左右切换不再刷新
• 修复 修复分屏左右屏空隙背景不一致的问题
• 调整 顶部刷新按钮改为整页刷新，用户设置前端对齐并消歧通知偏好实体

v2.3.0 (2026-06-10)

• 新增 引入 Schema 驱动页面框架，将用户/角色/权限/租户/日志等数十个列表页迁移其上，内置高级搜索、列设置、视图管理、树形模式、批量删除与 CSV 导出。
• 新增 落地字段级权限（FLS）：新增管理页、服务端读脱敏引擎与写校验，前端复用脱敏渲染管线。
• 新增 授权申请接入审批流并审批通过自动授权，新增权限委托运行时生效与授权申请/委托管理页。
• 新增 完善多租户体系：平台运维闸门、租户切换、套餐运行时门控、租户开通编排与登录后选租户控制中心。
• 新增 Material You 动态取色（含可关闭开关）、⌘K 命令面板、灵动岛、菜单收藏夹、账号自主注册与找回密码。
• 新增 个人中心全面重设计，头像上传落地、通知偏好全栈保存与我的活跃度统计。
• 优化 权限/角色快照、菜单路由、部门树、租户版本等接入分布式缓存并补齐失效链路，枚举元数据改用进程内缓存。
• 调整 拆分用户/权限/个人中心等上帝服务为子聚合服务，前端契约类型下沉 packages，查询改用类型安全条件。

v2.2.0 (2026-03-14)

• 新增 权限模型从 RBAC 升级为 RBAC + 轻量 ABAC，引入拒绝优先权限引擎、直授生效时间与组织层级闭包表。
• 新增 接入统一授权变更事件与权限缓存版本失效机制，权限/数据范围变更后即时生效。
• 新增 前端全面重建：偏好设置、多种布局模式、菜单与标签栏、主题色系、页面切换动画、列设置与图标选择器。
• 新增 新增 OpenAPI 加密、离线图标、可复用 Table 组件、系统/服务监控页与应用自动升级中间件。
• 新增 补齐认证链路 2FA 与多端会话策略，实现自定义日志写入器。
• 调整 项目整体升级为 Saas 形态并重构 XiHan.BasicApp 应用结构，将 RBAC 收敛为聚合/关系仓储语义。
• 修复 修复菜单图标/名称显示、刷新跳转 404、标签栏错位与偏好设置深色侧栏开关等问题。

v2.0.0 (2026-01-26)

• 新增 落地全新 RBAC 权限模型：完成认证授权链路、角色权限继承与权限数据范围能力。
• 新增 补齐核心业务服务：日志、通知、用户会话、账号安全、风控与三方授权服务。
• 调整 对仓储与服务层做整体重构，统一命名空间、主键与实体表名规范。
• 新增 接入代码生成能力并生成基础业务实体。
• 优化 优化种子数据初始化、分表表名与实体序列化，完善数据库配置。
• 升级 持续升级底层框架依赖并发布 v2.0.0。

v1.4.5 (2025-11-12)

• 优化 统一优化 RBAC 各系统实体的基础数据类型定义，规范字段类型一致性
• 调整 合并多批补丁与优化改动，整合到统一版本线
• 升级 多次升级底层依赖，累计发布 v1.4.4、v1.4.5 版本

v1.4.3 (2025-10-31)

• 升级 升级底层依赖并发布 v1.4.3 版本

v1.4.1 (2025-10-19)

• 新增 补充主包依赖注入的安全性测试，验证服务注册与解析的正确性
• 升级 升级底层依赖并发布 v1.4.1 版本

v1.3.6 (2025-10-18)

• 优化 优化代码样式与格式
• 升级 升级框架依赖并发布 v1.3.6

v1.3.5 (2025-10-16)

• 优化 优化实体数据结构，改善数据建模合理性
• 优化 优化整体实现细节
• 升级 多轮升级框架依赖，发布 v1.3.4 至 v1.3.5

v1.3.0 (2025-09-20)

• 优化 优化整体实现细节
• 升级 升级框架依赖并发布 v1.3.0

v1.2.1 (2025-09-08)

• 新增 定义系统核心实体，搭建基础数据模型
• 新增 实体主键支持泛型 Id，适配不同主键类型
• 优化 优化代码规范与整体实现细节
• 升级 多轮升级框架依赖，发布 v1.2.0 至 v1.2.1
• 调整 补充开发计划与项目文档

v0.11.1 (2025-06-25)

• 升级 升级底层框架依赖并发布 v0.11.1

v0.9.3 (2025-06-03)

• 新增 新增一键升级脚本，简化框架依赖的批量更新流程
• 升级 多轮升级底层框架依赖至最新版本
• 移除 移除核心包中尚未实现的空壳子包，精简依赖体积
• 优化 优化整体代码结构与 README/Logo 展示
• 调整 补充 DeepWiki 文档

v0.8.28 (2025-05-06)

• 升级 连续发布 v0.8.26 至 v0.8.28 多个补丁版本
• 优化 优化代码生成脚本模板（Class/Controller/Interface）与整体细节

v0.8.20 (2025-04-02)

• 升级 发布 v0.8.20，收敛版本号至 version.props 统一管理

v0.8.18 (2025-03-19)

• 升级 发布 v0.8.18，调整构建属性文件（common/netcore/nuget props）并同步依赖

v0.8.17 (2025-03-18)

• 调整 启用新的 .slnx 解决方案格式替代旧版 .sln
• 调整 重组 props 构建属性文件（拆分 net/nuget 等），整理各项目 csproj 引用
• 优化 更换项目 Logo 并优化 WebHost 启动配置

v0.8.10 (2025-01-27)

• 优化 常规细节优化与打磨

v0.8.9 (2025-01-21)

• 升级 升级依赖包版本
• 优化 优化解决方案组织与构建脚本

v0.8.7 (2025-01-05)

• 新增 初始搭建 XiHan.BasicApp 基础应用框架与分层解决方案骨架
• 新增 新增 Rbac 权限模块与 CodeGeneration 代码生成模块
• 新增 提供完整示例项目与 API 测试入口
• 优化 整理项目目录结构、重命名项目以兼容 macOS 系统
• 调整 补充 README 多语言切换与许可证等项目基础文件