@TechUI/Admin 简介
TechUI Admin (现代化工作台) 是 TechUI 生态系统中专为 B 端业务开发 打造的高效解决方案。
不同于 Prime 追求极致的视觉特效，Admin 专注于开发效率与交互逻辑。它不是零散组件的拼凑，而是一个完整的管理系统骨架。从登录页到动态菜单，从路由管理到状态分发，Admin 已经为您铺设好了开发 dashboard 和管理面板所需的一切基础设施。
一句话总结：安装即用，专注于写业务，而非搭架子。
免费组件库
为了降低开发者的准入门槛并回馈社区，当您独立使用 @techui/admin 时，它完全支持免费商用。
- ✅ 个人/商业项目免费使用：无论您是接私活还是开发企业内部 ERP。
- ✅ 无强制密钥：无需购买 License Key 即可启动开发。
- ✅ 闭源但开放：虽然核心代码经过封装，但提供了丰富的 API 与文档支持。
💡 唯一的约束
在使用免费版 Admin 时，请保留控制台（Console）和Html末的版权输出信息。
革命性适配
在 Admin 组件库中，我们内置了引以为傲的 TuiAdaptive 组件——这是目前市面上最强大的自适应/适配解决方案。
它采用等比缩放方案，彻底解决了大屏与管理后台在不同分辨率下的适配难题。
- 多种适配模式：完美适应全屏、宽屏、带缩放浏览器等多种场景。
- GIS/地图专属优化：
- 解决了传统 transform 缩放导致 Cesium/Leaflet 等地图组件点击坐标偏移的行业痛点。
- 独创 “同步穿透容器” 技术，确保在缩放状态下，地图交互依然精准无误。
- 拖拽模式：支持通过浏览器缩放功能激活拖拽调试，还原设计稿不再痛苦。
自动化特性
Admin 旨在消除样板代码，让系统“动”起来：
🚀 动态路由与菜单 (Dynamic System)
无需手动维护冗长的路由表与菜单树。
- 配置即路由：系统根据配置文件自动生成 Vue Router 路由表。
- 智能菜单：侧边栏菜单与路由状态自动同步，支持多级嵌套与权限过滤。
🏷️ 智能标签页 (Route Tabs)
- 自动管理：根据访问历史自动生成顶部的多标签页 (Tab View)。
- 状态缓存：完美支持 Keep-alive，切换标签页不丢失表单数据。
🔐 开箱即用的鉴权 (Ready Auth)
- 内置登录页：提供了一套精美的、功能完整的登录界面，您只需对接 API 即可。
- 权限守卫：内置路由守卫，自动处理 token 校验与重定向。
完备的基础设施
Admin 并非孤立存在，它聚合了 TechUI 生态底层的通用能力，为您屏蔽了底层的复杂性：
- @techui/fonts：统一的字体库，确保字体的一致性，引入了开源免费中文字体，内置了字体库的选取和预览功能。
- @techui/icons：由TechUI设计、收集整理的图标库，内置了图标预览选取功能。
- @techui/colors：统一的色彩系统，确保视觉一致性，内置了颜色表预览和选取功能。
- @techui/themes：灵活的主题系统，支持深色/浅色模式切换。
- @techui/locales：内置国际化支持，处理多语言环境。
- @techui/utils：集成了大量高频使用的工具函数。
- @techui/libs：集成了大量第三方库封装（防止破坏性更新导致的TechUI组件库异常）。
- @techui/lessmixins：提供了一套强大的 LESS 混入库，提升样式开发效率。
适用场景
@techui/admin 剥离了 Scifi 的科幻属性，回归了清爽、专业的 UI 风格，非常适合以下场景：
- 企业 ERP / CRM 系统
- SaaS 管理后台
- 物联网 (IoT) 设备管理平台
- 需要嵌入 GIS 地图的复杂调度台 (得益于 TuiAdaptive 的强力支持)
关联关系
虽然 Admin 可以独立使用，但它也是 TechUI Prime 不可或缺的一部分。
- 独立使用：
npm i @techui/admin-> 获得纯粹的后台管理能力 + TuiAdaptive -> 免费商用。 - 融合使用：
npm i @techui/prime-> 获得 Admin + Scifi + 3D 引擎的全能合体 -> 需付费授权。
许可证
TechUI许可证类别分为：
- 重许可轻许可：双向联合解密，客户端密钥+Npm钥匙串。
- 轻许可：单一密钥串，客户端密钥。
Admin 组件库采用轻许可，单向验证机制。其核心 Wasm 模块直接对传入的许可证字符串进行解密与校验，确保系统的轻量化部署。
- 便捷性：无需引入额外的密钥包，配置简单。
- 兼容性：支持免费模式，未检测到有效许可时自动切换至免费版状态。
🚀 开始构建
如果您正在寻找一个能快速搭建、稳定可靠且对地图组件友好的 Vue3 管理框架，@techui/admin 是您的不二之选。