UI Runtime
多框架插件 UI 接入
同一套插件机制支持 web-component / iframe，两种模式均可落地 Vue3 与 React。
- Vue3/React 官方模板可直接复用
- renderer 按模块声明，路由语义统一
- 存量系统可 iframe 渐进迁移
Runtime Online Hot Swap Enabled Version Guard Active Cloud Ready WebIDE Connected Runtime Online Hot Swap Enabled Version Guard Active Cloud Ready WebIDE Connected
插件化后台框架 / ENGINEERED FOR EXTENSION
炫酷是体验入口，真正核心是插件运行时能力
TT Admin 以插件系统为中心，支持 Vue3/React 多栈接入、Vite 源码热部署、接口热插拔、 在线编辑器、版本变更感知与升级数据保护，让业务能持续迭代而不是反复推倒重来。
12能力卡片（持续扩展）
4官方模板（Vue3/React）
0升级触发卸载 SQL 风险
能力卡片
覆盖运行时、开发体验、数据安全、可观测与云端发布，卡片将随插件生态持续增加。
DX
Vite 源码级热部署
开发态优先加载 /plugin-dev 源码，外部 dev server 与静态资源作为自动回退。
- 宿主模式无需重复发包调试
- 失败自动回退 frontDevAddress
- 可观测 HMR 模式 host/external/static
Backend
插件接口热插拔
插件启停时动态注册/反注册 Controller、Mapper、WebSocket，支持云端增量迭代。
- PluginHandler 统一注册链路
- 启动/停用无须重启全系统
- 接口变更可仅发布插件包
Upgrade
版本变更感知与升级安全
前端按版本构建缓存键，后端严格版本门禁，升级不触发卸载 SQL。
- 同版本与降版本自动拦截
- 升级执行 update-*.sql + onUpdate
- 历史业务数据默认保留
WebIDE
在线插件编辑器
在线 IDE 插件支持插件 UI 文件浏览、编辑、保存，适合远程快速修复。
- 提供文件 CRUD 接口
- 限制目录与后缀防止越权
- 与 plugin-dev 联动实现快速验证
UX
移动端体验对齐规范
插件表单、按钮、编辑弹层按“用户管理”标准统一，实现桌面与移动端一致交互。
- 操作列渲染工具复用
- 移动端下拉动作 + 桌面端确认按钮
- 编辑弹层宽度按 isMobile 自适应
Observe
生命周期可观测事件流
安装、启停、升级、卸载全流程事件可追踪，可用于实时看板与告警。
- /ws/plugin/status 实时广播
- 阶段进度 + 成功失败状态
- 问题回溯链路完整
Auth
动态菜单与权限同步
插件前端定义可直接驱动菜单落库与权限映射，避免双份配置漂移。
- frontend.yaml 驱动 routes/menus
- 插件启停联动菜单可见性
- 移除插件自动清理孤儿权限
Runtime
启动自愈与插件恢复
系统启动时自动同步插件记录并恢复可用插件，减少人工干预。
- PluginStartupLoader 启动扫描
- 缺失目录自动降级禁用
- 支持开发源目录自动同步
SDK
统一插件 API 契约
插件可直接复用宿主请求、表格与组件能力，减少重复基础设施代码。
- request 统一鉴权与错误处理
- useTable/useTableOperate 复用
- 组件风格与宿主保持一致
Data
SQL 迁移与数据保护
安装、升级、卸载脚本分离，升级默认不清库，支持长期业务数据沉淀。
- install/update/uninstall 分层执行
- 升级不触发 uninstall.sql
- 幂等迁移策略可持续演进
DevOps
云端增量发布能力
大多数插件迭代无需重发宿主前后端整包，上传插件即可完成功能变更。
- 接口与 UI 在插件边界内演进
- 版本递增后即可在线升级
- 适配静态托管 + Jar 部署架构
平台落地场景
官网更关注“能解决什么问题”，下面给出常见场景与对应能力，便于快速判断适配度。
Scene 01
多技术栈接入
同一插件协议同时兼容 Vue3 / React，支持 iframe 与 web-component 渐进接入。
- 模板即开即用，减少工程起步成本
- 存量系统可 iframe 先迁入，再逐步融合
- 路由与菜单语义保持统一
Scene 02
源码级热部署
开发态优先加载 /plugin-dev 源码，外部 dev server 与静态资源自动回退。
- 开发联调无需反复打包上传
- 支持 host/external/static 三种运行模式
- 调试链路更短，迭代速度更快
Scene 03
接口热插拔与生命周期
插件启停动态注册/反注册 Controller、Mapper、WebSocket，生命周期状态可观测。
- 启停插件无需重启宿主服务
- /ws/plugin/status 实时广播进度
- 安装/升级/卸载阶段全程可追踪
Scene 04
升级安全与数据保护
严格版本门禁 + 分层 SQL 迁移，升级默认不触发卸载脚本，保护历史数据。
- 同版本/降版本自动拦截
- 升级执行 update-*.sql 与 onUpdate
- 卸载才执行 uninstall.sql
Scene 05
在线编辑与云端增量发布
通过 WebIDE 在线编辑插件 UI，并在云端仅上传插件包完成功能更新。
- 在线文件编辑带安全边界控制
- 插件边界内改动无需重发宿主整包
- 适配静态站点 + Jar 的部署形态
标准交付流程
给团队统一一条可执行的插件交付链路，减少“口口相传”造成的环境与数据问题。
定义插件
编写 plugin.yaml 与 frontend.yaml，明确版本、渲染模式、路由菜单与权限。
源码联调
通过 /plugin-dev 直连插件源码，必要时回退外部 dev server。
打包升级
递增版本并执行升级安装，依赖 update-*.sql 与版本门禁保障安全。
云端观测
监听 /ws/plugin/status 事件，验证接口、菜单、缓存与数据迁移状态。
下一步：从文档到可落地实现
先按快速开始完成环境与启动，再按完整手册规划插件开发、运维发布与版本治理。