更新日志 · XiHan.BasicApp

本文件记录 XiHan.BasicApp 各版本的变更。每条标注 新增 / 修复 / 优化 / 调整 / 升级 / 移除 类别。升级前请留意「调整」类中的破坏性变更。

来源

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

v3.10.1 (2026-08-06)

破坏性变更

版本管理改为只读：SysVersion 自此由升级引擎独占写入，VersionAppService 的五个写端点与 saas:version 的 create / update / upgrade / delete 四个权限码一并移除。另移除无调用方的 TaskAppService.SyncAllActiveJobsAsync 与 code_gen:export 权限码。调用过这些端点的自建客户端需要下线相应逻辑。

• 新增 接入框架升级引擎，SysVersion 与 SysMigrationHistory 成为其版本状态与迁移台账存储
• 新增 实现维护模式，升级期间返回 503 并带 Retry-After，放行健康检查与发现文档
• 新增 审计中心新增升级记录页，可查看每次脚本的执行结果与失败错误信息
• 新增 权限授予改为批量提交，新增用户直授与版本权限两个批量端点
• 新增 新增权限目录、启用岗位、启用部门与文件存储等不分页端点，下拉与子列表一次取全
• 新增 新增统一权限授予面板 XPermissionGrantPanel，角色、用户直授与版本权限三处收敛
• 新增 新增长文本编辑组件 XContentEditorField，公告、消息模板与代码生成模板正文改在弹窗内编辑
• 调整 破坏性变更：版本管理改为只读，移除其五个写端点与四个 saas:version 权限码
• 调整 破坏性变更：移除两个无调用方的写端点与 code_gen:export 权限码
• 调整 退役自研迁移执行器，脚本统一由框架升级引擎执行
• 调整 框架模块依赖与服务注册收归 XiHan.BasicApp.Core 与 XiHan.BasicApp.Web.Core
• 调整 版本管理详情抽屉移除迁移台账，该数据改由升级记录页承载
• 调整 各模块权限种子的资源标识改引用常量，不再重复书写字符串
• 优化 权限目录、启用岗位与启用部门三个列表端点接入分布式缓存，并补齐岗位写路径的失效调用
• 优化 租户成员列表接上分页，成员超过 200 的租户不再看不到剩余成员
• 优化 内容编辑弹窗按视口撑满，编辑区不再受编辑器固定高度限制
• 修复 修复 3.10.1 升级脚本使用大写标识符导致 PostgreSQL 报 42P01 并中断启动
• 修复 小屏一律按垂直布局渲染，头部与侧栏不再绕过强制降级
• 修复 修复组织机构、用户、角色与权限四处详情端点查询参数名与后端形参不符
• 修复 修复批量删除接口路径参数未改走 query 导致的 404
• 修复 修复用户权限直授切换授权动作报错，改为按用户与权限 upsert
• 修复 补齐 AI、代码生成与工作流权限的模块编码，权限列表模块列不再为空
• 修复 权限分组标题解析不出显示名时回退资源名，不再显示原始权限码
• 修复 恢复误删的缓存按模式删除端点
• 升级 升级依赖，发布 v3.10.1

v3.10.0 (2026-08-05)

破坏性变更

本版动态 API 的路径参数全面改走 query，接口 URL 随之改变（如 GET /api/User/User/{id} 变为 GET /api/User/User?id=1）。前端已随本版一并改完，自建客户端与外部调用方需同步调整。

• 新增 接入 OIDC，SSO 补齐发现文档、JWKS、id_token 与用户信息
• 新增 新增容器化编排，一条命令拉起前端、后端与 PostgreSQL / Redis / Qdrant
• 新增 接入 GitHub Actions 流水线，后端构建测试与前端类型检查、lint 四条门禁
• 新增 新增动态 API 授权判定完整性断言，端点漏标权限码在测试阶段即被抓出
• 调整 破坏性变更：动态 API 路径参数全面改走 query
• 调整 升级状态改为数据库台账驱动，废除 version.txt 状态机，并接入脚本失败记录能力
• 调整 升级基础设施纳入租户独立库，各库自持版本与迁移台账（当前执行入口状态见升级与迁移）
• 调整 各模块自持 PageRegistry，菜单种子按编码幂等落库，页面缓存默认开启
• 调整 一级菜单按功能域重排，新增 AI 应用与功能配置目录，日志独立为审计中心
• 调整 菜单名统一：身份与权限改身份权限、租户改租户管理、AI 改 AI 应用
• 调整 MCP Server 改用框架 Web.Mcp 模块，应用层不再直接引用协议包
• 修复 补齐 10 个端点漏标的授权特性，服务监控不再对任意登录用户开放
• 修复 模块权限链种子改在平台租户上下文内播种，补回缺失的 7 个菜单
• 修复 修复升级通道读取租户时启动崩溃
• 修复 修复连接测试、同步表结构、重置应用密钥三处路由不一致导致的 404
• 修复 表格局部全屏在暗色模式下底色为白
• 升级 升级依赖，发布 v3.10.0

v3.9.0 (2026-07-30)

• 新增 聊天页接入 AI 助手，支持可配置多助手、流式回复推送与助手管理页
• 新增 新增业务编号功能，支持按规则发号与周期重置
• 新增 向量集合名与嵌入维度纳入 RAG 配置，连接测试同时探测会话与嵌入两个端点
• 新增 新增向量库健康检查
• 调整 发号统一独立提交，语义对齐数据库序列，编号发出即永久消耗
• 调整 通道配置页迁入系统设置，开放平台目录合并
• 调整 代码生成术语「机器 / 人类文件」改为「自动 / 手动文件」
• 优化 代码生成模块编辑器换用 monaco-editor，代码预览弹窗放大
• 修复 重设计业务编号发号并发方案，修复调用方事务内取号永不收敛
• 修复 修复 AI 助手选择与会话打开的主键字段名与前端契约不一致
• 修复 标签栏标题跟随语言切换
• 升级 升级依赖，发布 v3.9.0

v3.8.0 (2026-07-23)

• 新增 代码生成产物按所有权分离为机器文件与手写文件，重新生成不再冲掉自定义实现
• 新增 代码生成落地树表与主子表模板，主表行展开区按需加载子表明细
• 新增 代码生成接通多数据源，可从外部库导入表结构
• 新增 代码生成新增表配置推断引擎，导入即近乎零配置
• 新增 代码生成支持同步表结构与批量导入，人工改过的字段冻结、未改的跟随重新推断
• 新增 代码生成新增菜单与权限种子代码生成器，落地压缩为复制文件加重建库
• 新增 代码生成新增生成范围与操作开关，按需裁剪前后端产物
• 调整 移除 .Local 双份工程，框架引用改为按解决方案自动切换
• 调整 LICENSE 与 NuGet、npm 包元数据署名统一为 XiHanFun and contributors
• 修复 登录日志补齐切换租户与会话撤销结果标签
• 修复 自助踢下线不再给操作者本人发送会话撤销通知
• 修复 修复会话撤销通知在 PostgreSQL 上抛空引用异常
• 修复 修复锁屏遮罩卡死、背景透明与口令提示不实
• 修复 修复错误页按钮贴合与返回首页仍停留在 404
• 修复 主题切换扩散动画改从点击处开始
• 优化 统一文件头
• 升级 升级依赖，发布 v3.8.0

v3.7.0 (2026-07-18)

• 新增 新增工作流模块，含后端四表与领域服务、前端可视化设计器、通用图封装包
• 新增 工作流设计器支持运行态可视化、工具栏与流程校验
• 新增 接入 OpenAPI 签名网关，凭证密钥可逆加密并落数据库客户端存储
• 新增 开放接口日志填充凭证归属用户名与 API 名称，配套端到端自测端点与脚本
• 新增 新增统一编辑弹窗组件 XEditModal 与共享表单网格规范，全部新增编辑弹窗接入
• 新增 列表骨架屏对应真实表格的列宽与行高
• 调整 锁屏改为服务端强制，会话吊销在全部端点生效，移除全部客户端绕过口
• 调整 会话锁定与锁屏解耦，锁屏只是锁定原因之一
• 调整 OpenApi 收敛为垂直切片，端点改为自动注册的动态 API，安全存储回归基础设施层
• 调整 packages 层去业务化，业务代码下沉 src，包管理 Catalogs 化
• 修复 根治一页空白后全部空白，渲染核心禁用 out-in 过渡模式
• 修复 修复 keep-alive 失效，路由名统一为唯一缓存标识
• 修复 切换租户复用当前会话，杜绝重复登录设备与并发登录误报
• 修复 修复锁屏可被新开标签页绕过
• 修复 SignalR 协商 401 借道会话刷新重试一次，失败即登出
• 修复 用户主体自有行写入接入租户写入守卫显式豁免
• 修复 修正开放接口保护路径被配置追加语义污染导致误伤前端
• 修复 分表日志清理改用带表筛选的重载
• 修复 修复 MySQL 索引长度问题与语言包 JSON 示例花括号转义
• 升级 升级依赖，发布 v3.7.0

v3.6.0 (2026-07-15)

升级须知

本版跟随框架移除 QueryBehavior，前端不再传 behavior 与 ignoreTenant。数据变更日志依赖 XiHan:Data:SqlSugarCore:EnableDiffLog，而 appsettings.Production.json 被 gitignore，生产环境需在服务器上手工补该键。

• 新增 新增租户到期自动停用后台服务，到期后自动置为过期并失效版本门控与授权缓存
• 新增 导出支持 Xlsx 格式，导出文件扩展名与 ContentType 跟随实际写出器格式
• 新增 接入自动版本更新脚本，SQL 升级脚本随发布执行
• 新增 租户 Logo 支持上传，新增文档菜单、外链菜单图标与文件管理图标
• 调整 破坏性变更：跟随框架移除 QueryBehavior，前端不再传 behavior 与 ignoreTenant
• 调整 小屏禁用分屏并统一小屏断点判定
• 优化 优化多语言并清理无用键，数据变更日志页链路追踪 ID 列移至用户名后
• 优化 新增数据变更日志与审计脱敏的冒烟验证脚本
• 修复 开启 EnableDiffLog，修复数据变更日志恒空
• 修复 安全状态变更（密码 / 2FA 密钥 / 账号锁定）纳入数据变更日志
• 修复 租户详情成员列表串租户与成员显示名恒空
• 修复 修复雪花 ID 配置非法值
• 升级 升级依赖，发布 v3.6.0

v3.5.0 (2026-07-10)

• 新增 激活 OpenTelemetry 可观测性装配，链路可导出至 OTLP 后端
• 新增 新增链路追踪查询页，含时间线聚合查询与卡片化时间线视图
• 新增 新增权限变更日志独立页，授权写路径全链路接线并快照名称与操作 IP
• 调整 登录日志 TraceId 口径统一收口到 ITraceIdProvider
• 修复 根治布局滚动模型，内容区定高内部滚动
• 修复 角色权限抽屉仅按有效授权判定勾选
• 升级 升级依赖，发布 v3.5.0

v3.4.0 (2026-07-08)

• 新增 接入 Gitee 第三方登录，含后端配置、种子与前端 Provider
• 移除 移除演示模式与演示环境写操作拦截
• 升级 升级依赖，发布 v3.4.0

v3.3.0 (2026-07-08)

• 调整 审计写入器与上下文引用迁移至框架新包 XiHan.Framework.Auditing
• 优化 清理未使用的历史遗留前端组件
• 优化 新增项目本地 AI Agent 贡献指南
• 修复 控制中心修复超管进入平台管理，当前态收敛为单一事实源，命名统一
• 修复 导出全部只导出首页，请求页大小对齐框架最大页大小
• 升级 升级依赖，发布 v3.3.0

v3.2.0 (2026-07-06)

• 新增 新增 XiHan.BasicApp.AI 模块，支持 AI Provider 库化管理与配置页
• 新增 新增知识库（RAG），含文档管理、检索试玩与 Provider 嵌入模型
• 新增 新增知识检索技能与 MCP Server，支持应用管理密钥
• 新增 新增提示词库与 AI 提示词管理页
• 新增 代码生成器支持代码高亮与表级结构字段暴露
• 新增 代码生成支持字典三分（字典 / 枚举 / 常量），外键关联不入生成代码
• 新增 代码生成即产出菜单与按钮权限代码片段，支持树表与主子表上下文
• 新增 聊天支持粘贴图片与文件直接发送，一条消息支持多附件
• 优化 秒传改为探测语义，未命中返回空不再报错
• 优化 默认不打印 SQL，appsettings 补主从配置示例与逐节注释
• 修复 登录 500，锁定时间标量投影类型硬转崩溃
• 修复 代码生成改用原生 Scriban 渲染，修复模板变量不替换与未找到可用模板
• 修复 响应信封判定改用 isSuccess 主判据，修复空数据被整包透传
• 升级 升级依赖，统一文件头，发布 v3.2.0

v3.1.0 (2026-07-03)

• 新增 新增在线聊天系统，支持单聊、群聊与部门群
• 新增 聊天支持回复、编辑、限时撤回、已读回执、表情回应、转发与附件秒传
• 新增 聊天群治理与安全，支持群信息编辑、转让群主、成员禁言与敏感词拦截
• 新增 通知支持四渠道扇出投递，可达站内信、邮箱、短信与机器人
• 新增 新增 OAuth2 授权服务端，支持授权码、PKCE 与令牌轮换
• 新增 新增租户数据库级隔离，支持独立建库、连接串加密与初始化数据库
• 新增 消息网关配置迁入数据库并加密，短信实装阿里云与腾讯云真实发送
• 新增 新增用户职位管理、健康检查与日志保留清理定时任务
• 调整 消息网关未配置时 fail-closed，不再假成功
• 优化 仪表盘与小组件合并，聊天输入区与右键菜单优化
• 优化 顶部横幅公告升级，支持类型配色、关闭记忆与轮播
• 修复 聊天实时链路雪花 ID 精度丢失
• 修复 多语言文案裸 @ 导致白屏
• 修复 通知横幅顶部空白条及多项聊天交互问题
• 升级 配置真加密、存储密钥加密与短信验证码防刷等安全加固
• 升级 升级依赖，发布 v3.1.0

v3.0.1 (2026-06-27)

• 新增 新增代码生成模块与配套权限链
• 新增 消息中心重构，支持五类消息分级、角色与部门定向投递、强制阅读与运营闭环
• 新增 全栈国际化铺量，后端异常与枚举资源化，前端业务页中英双语
• 新增 表格支持服务端多字段动态排序、搜索时间区间与枚举多选
• 新增 新增工作台小组件看板与 Cron 表达式可视化组件
• 新增 超级管理员可进入所有租户并快捷登录
• 调整 分页查询统一改走 POST，查询对象作为请求体
• 调整 标准化表名与列名，种子数据按代码生成、演示与系统基线解耦
• 优化 枚举元数据整库取一次并全局语言监听，切换语言由多次请求降为一次
• 优化 修复 Cron 组件卡顿与浅色主题深色侧栏不变暗
• 升级 升级依赖，清理编译警告与文件头

v3.0.0 (2026-06-20)

• 新增 上线第三方登录与邮箱全局唯一登录，配套控制中心与租户切换入口
• 新增 新增导出中心，全部列表页零配置获得同步导出，日志大表支持异步导出
• 新增 列表页全量铺开细粒度权限门控，导入导出与批量操作按资源逐一门控
• 新增 新增在线用户实时视图、个人 API 凭证、用户统计聚合与消息模板管理
• 新增 文件管理支持多文件并发上传、回收站三段式与下载访问计数
• 调整 线上发布与本地测试分离，异常统一化输出
• 调整 种子数据正式化并移除演示数据
• 优化 灵动岛重构为任务中心模型，支持进度环、三态形变与服务端任务
• 优化 偏好、搜索、表格与收藏夹同步由手动推送升级为实时推拉
• 优化 优化仪表盘、字典、菜单与登录页样式

v2.3.1 (2026-06-11)

• 新增 新增分屏与双栏对照功能，支持左右屏内容互换与分屏打开
• 新增 页面设置升级为用户设置，偏好支持后端同步与草稿式预览、保存、还原
• 新增 新增灵动岛开关、全屏水印与页面加载动画
• 调整 顶部刷新按钮改为整页刷新
• 优化 分屏交互打磨，互换时分割线固定，左右切换不再刷新
• 修复 修复分屏左右屏空隙背景不一致

v2.3.0 (2026-06-10)

• 新增 引入 Schema 驱动页面框架，数十个列表页迁移其上
• 新增 Schema 页内置高级搜索、列设置、视图管理、树形模式与导出
• 新增 落地字段级权限，新增管理页、服务端读脱敏引擎与写校验
• 新增 授权申请接入审批流并审批通过自动授权，新增权限委托
• 新增 完善多租户体系，含平台运维闸门、租户切换与套餐运行时门控
• 新增 新增动态取色、命令面板、灵动岛、菜单收藏夹、自主注册与找回密码
• 新增 个人中心重设计，头像上传落地，通知偏好全栈保存
• 调整 拆分用户、权限与个人中心等上帝服务为子聚合服务
• 调整 前端契约类型下沉 packages，查询改用类型安全条件
• 优化 权限、菜单、部门树与租户版本接入分布式缓存并补齐失效链路

v2.2.0 (2026-03-14)

• 新增 权限模型从 RBAC 升级为 RBAC 加轻量 ABAC，引入拒绝优先权限引擎
• 新增 接入统一授权变更事件与权限缓存版本失效机制，变更后即时生效
• 新增 前端全面重建，含偏好设置、多种布局模式、主题色系与图标选择器
• 新增 新增 OpenAPI 加密、离线图标、可复用表格组件与系统监控页
• 新增 补齐认证链路 2FA 与多端会话策略
• 调整 项目整体升级为 SaaS 形态并重构应用结构
• 调整 RBAC 收敛为聚合与关系仓储语义
• 修复 修复菜单图标与名称显示、刷新跳转 404、标签栏错位

v2.0.0 (2026-01-26)

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

v1.4.5 (2025-11-12)

• 调整 合并多批补丁与优化改动
• 优化 统一优化各系统实体的基础数据类型定义
• 升级 升级底层依赖，发布 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.5

v1.3.0 (2025-09-20)

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

v1.2.1 (2025-09-08)

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

v0.11.1 (2025-06-25)

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

v0.9.3 (2025-06-03)

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

v0.8.28 (2025-05-06)

• 优化 优化代码生成脚本模板与整体细节
• 升级 连续发布 v0.8.26 至 v0.8.28

v0.8.20 (2025-04-02)

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

v0.8.18 (2025-03-19)

• 升级 调整构建属性文件并同步依赖，发布 v0.8.18

v0.8.17 (2025-03-18)

• 调整 启用新的 slnx 解决方案格式替代旧版 sln
• 调整 重组 props 构建属性文件，整理各项目引用
• 优化 更换项目 Logo 并优化启动配置

v0.8.10 (2025-01-27)

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

v0.8.9 (2025-01-21)

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

v0.8.7 (2025-01-05)

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